前言¶
用 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 證據，以及你在預覽階段確認的提示詞。安裝與啓用前請自行評估源碼與權限範圍。
