修雨
2dbbca1ec9
Every documented command / flag / example now matches `dws <svc> --help`: - drop phantom commands (attendance class/group/vacation/..., contact label, ding message list/receiver-status) that map to undeployed tools. - fix runtime-failure flags (mail --body→--content, doc/calendar/minutes pagination, chat send-by-bot @-flags, wiki member --users). - route role/duty "who is responsible" queries to `aisearch person --dimension duty` instead of the removed `contact label`. - realign the multi/dingtalk-report skill to entry submit / inbox list / outbox list.
6.1 KiB
6.1 KiB
工作汇报
lite recipe 见
dws-shared/references/best_practices/_common/lite-recipes.md。
路径分歧（先判定后选 recipe）
dws report 与 dws doc 是两个不同的产品，覆盖不同的"周报 / 日报"场景。在选 recipe 前先做一次判定：
| query 中是否含强信号 | 选哪个 recipe | 默认值 |
|---|---|---|
| 含「钉钉日志 / OA 周报 / 我的钉钉日志 / 日报模板 / 周报模板 / 提交日志 / 填模版」 | submit-report（走 dws report entry submit） |
— |
| 含「在线文档 / 写一篇文档 / 整理成文档 / 文档保存」 | generate-*-report（走 dws doc create） |
— |
| 无强信号（如"写日报"、"写周报"、"整理本周工作"） | generate-*-report（走 dws doc create） |
默认 |
注：
- "钉钉日志"在用户口语中多指 OA 周报应用，但偶有泛指日志/记录，必要时反问澄清。
- 仅当用户明确说"钉钉日志（OA 应用）"或类似强信号时才切到
submit-report；否则不要主动推荐 OA 日志路径——多数用户的"周报"实际期望是文档（可分享、可编辑、长文本）。
Recipe 速查
| Recipe | 行动指南（固定路线） |
|---|---|
| query-report | 0. 前置判定：query 含「查日志 / 看日志 / 我发过的日志 / 收到的日志 / 日志详情」且语义指向钉钉日志 OA 应用？是 → 直接走 dws report；否 → 先按 doc/report 分歧澄清1. 用户说「我发过 / 我创建」→ report outbox list --cursor 0 --size 20 --format json；用户说「收到 / 别人发给我」→ report inbox list --start "<YYYY-MM-DDT00:00:00+08:00>" --end "<YYYY-MM-DDT23:59:59+08:00>" --cursor 0 --size 20 --format json2. 时间 flag 只允许 --start / --end，禁止 --start-date / --end-date / --date；不要只传裸日期，必须展开完整 ISO；不要先查 help，不要预先登录；只有命令返回认证错误时才处理认证3. 从列表返回中取 reportId 留给内部后续调用；如果用户已直接提供 reportId，跳过列表4. 面向用户展示列表时必须基于 result[] 拼 Markdown 表：`日期 |
| generate-daily-report | 1. 按「多源并行采集」（见 dws-shared/references/best_practices/_common/conventions.md）执行（时间=今日）2. 交叉汇总并把日报内容写入临时文件 <tmp>.md（UTF-8，真实换行）3. 创建文档： doc create --name "<日报名>" --content-file <tmp>.md（> 200KB 按 dingtalk-doc/references/04-document.md 的 write-doc 兜底走 create 空 → 循环 update） |
| generate-weekly-report | 1. 按「多源并行采集」（见 dws-shared/references/best_practices/_common/conventions.md）执行（时间=本周）2. 交叉对比并把周报内容写入临时文件 <tmp>.md3. 创建文档： doc create --name "<周报名>" --content-file <tmp>.md（兜底同上） |
| submit-report | 0. 前置判定：query 含「钉钉日志 / OA 周报模板 / 我的钉钉日志」等强信号？是 → 继续；否 → 切换到 generate-weekly-report 或 generate-daily-report（走 dws doc）1. 按「多源并行采集」（见 dws-shared/references/best_practices/_common/conventions.md）执行（时间=当日）2. report template list --format json → 取 report_template_id3. report template get --name "<模版名>" --format json → 取 result.report_template_fields[]，每项含 field_name/field_sort/field_type4. 把 contents 写入临时文件（避免 shell 引号问题）：每项含 key/sort/content/contentType/type 五个字段，严格映射 field_name → key、field_sort → sort、field_type → type，再填 content 与 contentType5. report entry submit --template-id <id> --contents-file <tmp>.json --format json → CLI 会在提交成功后自动反查详情并追加 dingtalkOpenMarkdownLink / dingtalkOpenUrl / dingtalkOpenLink 字段；取返回的 reportId 与钉钉打开链接6. final reply 优先直接使用 dingtalkOpenMarkdownLink，让用户点击跳转钉钉客户端查看 / 修改；仅当 submit 返回中缺少 dingtalkOpenUrl 时，才手动执行 report entry get --report-id <reportId> --format json 补取 result.url，再包装成 [在钉钉中查看日志](result.url)不要走 doc 写文档；禁止跳过 2/3 步直接 submit；禁止把 raw dingtalk://... URL 直接粘到回复，必须包成 markdown link不要再生成 report template detail / report create（deprecated alias，仍能跑但会打 stderr 警告） |
| generate-monthly-report | 1. 按「多源并行采集」（见 dws-shared/references/best_practices/_common/conventions.md）执行（时间=当月）2. report outbox list --start "<月初ISO>" --end "<月末ISO>" → 取当月已提交日志3. 按周分段归纳并把月报内容写入临时文件 <tmp>.md4. 创建文档： doc create --name "<月报名>" --content-file <tmp>.md（兜底同上） |
| generate-topic-report | 1. 提取主题关键词；推断时间范围（"最近"默认近 30 天） 2. 按「多源并行采集」（见 dws-shared/references/best_practices/_common/conventions.md）执行3. 按时间线排列，交叉归纳核心结论/决策/行动项/未解决问题/演进脉络，并把内容写入临时文件 <tmp>.md4. 创建文档： doc create --name "<报告名>" --content-file <tmp>.md（兜底同上） |