7.1 KiB
7.1 KiB
工作汇报
lite recipe（
view-report-inbox、check-report-read-status）见 report-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；CSV 附件、群聊导出日志、系统日志或聊天记录核验不属于 OA 日志，应转到文件/群聊/表格相关 skill；其余歧义先按 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 json；不要先生成 report list / report sent 等 deprecated alias，也不要用 inbox 代替 outbox2. 时间 flag 只允许 --start / --end；裸日期必须展开完整 ISO + +08:00；禁止 --start-date / --end-date / --date、UTC Z、date -u；用户只说「最近 / 近期 / 最近收到 / 最近一周」默认最近 7 天；--size 最大 20，更多结果按 cursor 分页，禁止传 50/1003. 按发件人查收件箱时，先 aisearch person --query "<姓名>" --dimension name --format json 取 userId/staffId，再给 inbox list 加 --sender-user-ids <id>；如果列表中找不到目标发件人或目标标记日志，必须说明不可见 / 未找到，不得改选其他发件人或其他日志4. 从列表返回中取 reportId 留给内部后续调用；如果用户已直接提供 reportId，跳过列表；面向用户展示列表时基于 result[] 拼 Markdown 表：`日期 |
| generate-daily-report | 1. 按「多源并行采集」执行（时间=今日） 2. 交叉汇总并把日报内容写入临时文件 <tmp>.md（UTF-8，真实换行）3. 创建文档： doc create --name "<日报名>" --content-file <tmp>.md（> 200KB 按 write-doc 兜底（见 dingtalk-doc/references/04-document.md） 走 create 空 → 循环 update） |
| generate-weekly-report | 1. 按「多源并行采集」执行（时间=本周） 2. 交叉对比并把周报内容写入临时文件 <tmp>.md3. 创建文档： doc create --name "<周报名>" --content-file <tmp>.md（兜底同上） |
| submit-report | 0. 前置判定：query 含「钉钉日志 / OA 周报模板 / 我的钉钉日志」等强信号？是 → 继续；否 → 切换到 generate-weekly-report 或 generate-daily-report（走 dws doc）1. 按「多源并行采集」执行（时间=当日） 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 --to-user-ids <userId1>,<userId2> --format json → --to-user-ids 必填：无接收人的提交服务端仍返回成功但日志对任何人都不可见；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. 按「多源并行采集」执行（时间=当月） 2. report outbox list --start "<月初ISO>" --end "<月末ISO>" → 取当月已提交日志3. 按周分段归纳并把月报内容写入临时文件 <tmp>.md4. 创建文档： doc create --name "<月报名>" --content-file <tmp>.md（兜底同上） |
| generate-topic-report | 1. 提取主题关键词；推断时间范围（"最近"默认近 30 天） 2. 按「多源并行采集」执行 3. 按时间线排列，交叉归纳核心结论/决策/行动项/未解决问题/演进脉络，并把内容写入临时文件 <tmp>.md4. 创建文档： doc create --name "<报告名>" --content-file <tmp>.md（兜底同上） |