dsh-report-studio

让 agent 干完活,顺手把"干了什么"写成能直接交出去的东西。

DeepSeek Harness 生态中第一个「会话 → 工作交付物」插件:把一次会话一键变成 工作日报 / 周报 / 交接文档 / 公众号文章,并附上可验证的凭据块 (报告哈希 + 产物哈希),让汇报有据可查、无法注水。

状态:0.1.0,可用。跟随 Harness 开发者预览节奏,接口可能变化。

特性

• 4 套开箱即用模板:daily(日报)、weekly(周报)、handoff(交接文档)、article(公众号文章)
• 会话硬数据自动提取:用户诉求、任务清单、回合/步骤统计、Token 账本、工具调用、产出文件、执行命令、错误与阻塞——全部来自会话事件日志,不靠模型回忆
• 可验证凭据块:每份报告末尾自动追加会话 ID、工作区、生成时间、报告 SHA-256 与产物 SHA-256
• 落盘安全:目标路径强制限制在会话工作区内,拒绝绝对路径逃逸与 .. 穿越
• 模板可定制:内置模板可整体覆盖,占位符见下文
• 免构建:纯 ESM,直接 dsh plugin 安装或 --patch 加载,无编译步骤

安装

需要 Node.js ≥ 18,以及 DeepSeek Harness(npx @deepseek-ai/dsh web 或源码运行)。

方式一:plugin 安装(需要 pnpm)

dsh plugin --profile web add github:ciceroyang/dsh-report-studio

方式二:本地 / 源码覆盖层(无需 pnpm)

# 克隆仓库
git clone https://github.com/ciceroyang/dsh-report-studio.git

# 创建覆盖层文件 my-report.yml(注意:插件路径必须是绝对路径)
# - insert:
#     - id: report-studio
#       name: '/absolute/path/to/dsh-report-studio/index.js'

dsh web --patch ./my-report.yml

使用

对 agent 说(二选一):

• "写一份今天的工作日报"
• "把这次会话整理成交接文档,交接给接手人"

agent 会(work-report skill 已教会它):

1. 调用 report_generate 生成带硬数据与 [[待写:…]] 标记的草稿;
2. 用会话事实填满散文段落;
3. 调用 report_save 落盘并追加凭据块;
4. 回复你保存路径与报告哈希。

保存位置默认在工作区 reports/-.md,可在调用时指定 path。

也可以直接在输入框敲命令即时预览草稿(不消耗模型回合):

/report daily     # 或 weekly / handoff / article,中文别名 日报/周报/交接/公众号 也行

工具

report_generate