wecom-cli高级参数速查--dry-run、--json、--set与自动分页--page-count用法清单【免费下载链接】wecom-cli企业微信开放平台命令行工具 — 让人类和 AI Agent 都能在终端中操作企业微信项目地址: https://gitcode.com/gh_mirrors/we/wecom-cliwecom-cli是企业微信开放平台命令行工具让人类和 AI Agent 都能在终端中操作企业微信的消息、邮件、文档、待办、日程等业务。这篇速查清单聚焦 4 个最实用的高级参数--dry-run干跑预览、--json完整请求体、--set深层参数覆盖与--page-count自动分页帮你少踩坑、写得快。 30 秒速览4 个高级参数一览表参数一句话作用典型场景--dry-run只校验并打印将发送的请求不实际调用发重要操作前先预览--json JSON直接给定完整请求体 JSON 字符串批量参数、复杂嵌套结构--set pathvalue深层路径覆盖可重复优先级最高只改--json里的个别字段--page-count n游标式自动分页最多拉取 n 页列表类接口全量拉取 三个给请求体的方式命名参数 /--json/--set可以自由组合优先级从高到低是--set 命名参数 --json。 --dry-run 干跑先发预演再真执行--dry-run会在本地完成参数校验并打印即将发送的完整请求但不会发起任何 API 调用stdout 会输出 Dry Run 预演信息。适用场景发送消息、创建文档、修改日程等写操作前确认请求体拼装无误调试--json/--set组合出的最终 payload验证--output-dir等路径参数是否合法dry-run 与实际执行走同一道门禁校验错误时机一致详见 006-dry-run-output-dir-gate/desc.md# 预览不会真正调用接口 wecom-cli message send --json {chat_id:xxx,text:周报} --dry-run小技巧也可以在--json里传{dry_run: true}触发同样的干跑模式效果与 flag 一致见 018-json-extras-dry-run/desc.md。 --json一行给完整请求体--json直接接收完整请求体 JSON 字符串适合参数多、嵌套深的接口比一串命名参数更紧凑# 无参方法 wecom-cli message aibot sessions list # --json 给定请求体 wecom-cli doc search --json {keywords:[周报],limit:10}它的两个容错设计非常省心JSON 自动修复尾部多逗号、未加引号的 key 等格式错误会由内置修复器自动修正后正常解析行为见 003-json-repair/desc.md不用为引号问题来回排查控制字段抽取JSON 体里的dry_run、page_count等控制字段会被自动提取为对应 flag 生效不会误发给服务端如{page_count: 2}直接触发分页见 016-json-extras-pagination/desc.md --set深层路径覆盖优先级最高--set pathvalue可以像精准手术刀一样覆盖请求体中任意深度的字段可重复使用# 覆盖深层字段可重复 wecom-cli doc search --json {keywords:[周报],limit:10} \ --set limit20 --set extra.flagtrue要点优先级最高--set的赋值会覆盖--json与命名参数中的同路径字段值支持 JSON 片段非法片段同样会走自动修复路径不存在时可以按需创建对象若目标节点是标量无法展开会报出清晰的--set a.b.c 参数标识 原因错误提示实现见 assemble.rs典型用法把一份标准--json模板固化下来每次只--set改掉日期、ID 这类变化字段脚本更稳定。 --page-count游标式自动分页列表类接口默认只返回一页数据。加上--page-count n后CLI 会依据响应的has_morenext_cursor自动翻页最多拉取 n 页输出为NDJSON每行一页方便jq逐行处理# 最多拉 3 页分页间隔 1 毫秒 wecom-cli message aibot sessions list --page-count 3 --page-delay 1配套参数与行为--page-delay ms分页请求间隔毫秒数默认 100ms批量拉取时可适当调大避免触发限流提前终止即使--page-count 5服务端只有 2 页也会在has_more: false时停下只输出 2 行见 002-page-count-exceeds/desc.md全量拉取示例mock 3 页数据的完整交互见 001-page-all/desc.md想控制落盘目录可配合--output把 NDJSON 多行结果直接写入文件✅ 组合最佳实践新写脚本先--dry-run确认 payload 无误后再去掉 flag 执行模板 覆盖--json存标准模板--set只改变化字段分页结果直接进管道NDJSON 每行一页可用head -n 1/jq逐页消费看退出码0成功、1运行时错误、2用法错误错误以结构化 JSON 输出到 stdout日志走 stderr不污染数据管道 更多参数去哪查完整的命令模型、环境变量、配置文件与退出码说明请查阅官方参考文档 docs/cli-reference.md请求体装配与--set的优先级逻辑实现位于 crates/wecom/src/service/command/ 目录核心文件 assemble.rs。掌握--dry-run、--json、--set、--page-count这四个参数基本能覆盖 wecom-cli 日常使用中 90% 的高级场景。【免费下载链接】wecom-cli企业微信开放平台命令行工具 — 让人类和 AI Agent 都能在终端中操作企业微信项目地址: https://gitcode.com/gh_mirrors/we/wecom-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考