前言¶
用 DSH 做开发时，一天里会开很多会话，仓库里也有零散提交。到要写日报、周报或月报时，常见做法是翻聊天记录、跑 git log，再对着公司模板手工拼 Markdown。过程费时，且容易漏掉 subagent 会话或 merge 提交这类噪声。
下面介绍社区插件 dsh-weekly-report（维护者 l956615272-hub）：在选定时间窗内挑选 DSH 会话与可选的 git 提交，把你以前写过的报告当作格式样例，生成 Markdown 报告并写入本地报告库。分类属于 DSH 社区目录中的「工作流」。
这是什么¶
dsh-weekly-report 是 DeepSeek Harness（DSH）的 npm 插件（当前 package 版本 0.1.7，MIT 许可证）。它解决的是：在固定时间段内收集可核对证据（会话回合 + 可选 git），再按你提供的样例文风产出日报 / 周报 / 月报，默认输出 Markdown，保存路径为 $DSH_HOME/dsh-weekly-report/reports/。
核心功能¶
会话证据¶
- 按会话最后一次对话时间筛选（不是创建时间），且只纳入该时间窗内产生的对话。
- 按工作区分组、支持搜索；默认排除 subagent 会话；fork / resume 副本会自动合并。
Git 证据（可选）¶
- 单工作区内多仓库自动发现。
- 可按 git 用户名（姓名或邮箱）过滤；可选当前分支或全部分支；默认排除 merge 提交。
报告样式与生成流程¶
- 报告结构由你粘贴的历史报告样例驱动，样例可保存复用。
- 生成前可预览并直接修改提示词；确认后由插件宿主新建会话、自动发送提示词并跳转；新会话会执行证据命令、读取证据、写报告，并通过
save-report.mjs写入报告库；设置面板底部可查看已保存报告。
安装与启用¶
DSH 生态采用「一切皆插件」思路；插件列表在独立社区站点 SkillHub 展示，与 DeepSeek / 幻方无官方从属关系。安装前建议浏览 GitHub 仓库 源码与 LICENSE；插件在 DSH 进程权限下运行。
从 npm 安装（推荐）¶
在 DSH Desktop 侧边栏「插件」页的安装框中填写包名：
dsh-weekly-report
安装后重启 DSH Desktop（宿主代码变更需重启；仅客户端改动时刷新页面即可）。之后在 设置 → 周报生成 中使用。
从源码安装（开发用）¶
README 说明：克隆仓库后在同一页面选择「安装本地路径」，填入克隆目录（例如 ~/code/dsh-weekly-report）。同样需重启 Desktop。运行环境要求 Node >= 22.19.0（见 package.json engines）。
典型用法¶
图形界面流程¶
- 选报告类型（日报 / 周报 / 月报）和时间范围（今天 / 近 7 天 / 本周 / 上周 / 本月 / 上月 / 自定义）。
- 勾选要纳入的会话（按工作区分组，可搜索、可全选）。
- 需要时勾选「结合 git 记录」，选择工作区、仓库并填写 git 用户名。
- 粘贴一份以前的报告作为格式样例（可保存为常用样例）。
- 点「生成提示词预览」→ 可直接改提示词 → 选择报告生成会话落地的工作区 → 「新建会话并发送」。成功后设置面板会自动关闭并进入新会话；侧边栏也会出现该会话。
- 新会话完成证据收集与写作后，报告经
save-report.mjs存入报告库，可在面板底部查看。
命令行收集证据（可手动执行）¶
仓库内 scripts/collect.mjs 与会话 / git 只读收集、以及 save-report.mjs 存库，用法如下。
会话证据（只读，只取时间窗内的回合）：
node scripts/collect.mjs sessions --from 2026-10-08T00:00:00+08:00 --to 2026-10-16T00:00:00+08:00 \
--ids session-a,session-b --out .dsh-weekly-report/sessions.md
Git 证据（多仓库、按作者、默认排除 merge）：
node scripts/collect.mjs git --workspace /path/to/workspace --from 2026-10-08 --to 2026-10-16 \
--author "你的名字" --author "you@example.com" --out .dsh-weekly-report/git.md
将报告写入报告库（需要 DSH 正在运行）：
node scripts/save-report.mjs --name 2026-W41.md --file report.md --url http://127.0.0.1:19387
更细的设计与数据来源见仓库内 docs/PRD.md。
适用场景与注意¶
适合需要定期用 Markdown 汇报 DSH 内工作与代码变更、且希望文风与既有报告一致的开发者。样例驱动意味着第一次使用需要准备一份真实历史报告；git 作者名需与本地配置一致，否则过滤结果可能为空。
插件不替代人工审阅：生成内容依赖所选会话与 git 证据，以及你在预览阶段确认的提示词。安装与启用前请自行评估源码与权限范围。
