前言¶
在 Harness 裏做開發，事務往往散落在對話、終端和臨時筆記裏；到了週五寫週報，只能靠回憶拼湊，容易漏項、措辭也費時間。常見做法是單獨開一個 Markdown 或 Notion 頁面記流水賬，再在別處套模板——數據與 IDE 脫節，和 Agent 對話也無法直接「記一條」「生成本週報告」。下面介紹維護者 doombeaker 的客戶端插件 dsh-weekly-log（npm 包名 dsh-weekly-log）：在 DSH 側欄維護按 ISO 周組織的工作條目，一鍵導出週報 Markdown，並可選用 Harness 已配置的模型潤色措辭；提供 weekly_log、weekly_report 兩個 Agent 工具，插件本身不需要 API Key。
這是什麼¶
dsh-weekly-log 是 DeepSeek Harness 的 profile 級插件（分類：客戶端）。它在側欄提供「週報 / 周志」面板，用一行一條的方式記錄「已完成」或「計劃」；支持按周瀏覽、計劃順延（carry-forward）並保留痕跡、中止項不入報告；可將「上週已完成 + 本週計劃」渲染爲固定模板的週報，並可選一鍵 AI 潤色。條目持久化在 ~/.dsh/weekly-report/data.json（即 $DSH_HOME/weekly-report/data.json），跨工作區共享；導出的報告爲純 Markdown，默認寫到當前工作區下的 reports/weekly-<ISO week>.md（目錄可在設置中改）。
倉庫：https://github.com/doombeaker/dsh-weekly-log
社區目錄：https://www.skillhub.cn/plugins/doombeaker/dsh-weekly-log
當前資料中的版本爲 0.1.0，許可證 MIT，要求 dsh >= 0.2.0。
核心功能¶
側欄面板¶
- 側邊欄入口，一行一條事項；可切換任意 ISO 周，當前周有標記，「回到當前周」可快速歸位。
- 錄入時選擇 完成（done，默認）或 計劃（plan），回車保存；可先切到未來周再錄入，把計劃歸到該周。
- 對計劃可執行 完成 / 順延 / 中止：順延會改條目所屬周並在歷史中留痕（例如上週仍顯示「順延到第 46 周」，本週計劃側保留同一事項）；中止項仍可見但不會進入導出報告。
導出與潤色¶
- 生成報告：以所選周爲「本週」，其前一週爲「上週」；模板含
Name:、Last week:、This week:，每項一行-列表。 - 規則：上週工作 = 該周
state爲done的條目；本週工作 = 該周當前爲plan的條目（含順延進來的）。 - AI 潤色：調用 Harness 裏已配置的默認模型整理用語、長度和錯別字；結果與草稿對照，可自行採納或丟棄。無默認模型時面板會提示，仍可手工編輯與複製保存。
Agent 工具（2 個）¶
在對話中可使用 weekly_log、weekly_report，對應「記一條」「這週記了什麼」「生成報告」等意圖。面板與工具共用同一套 lib/impl.js 實現（含 POST /weekly/api）。
條目數據模型（摘要）¶
| 字段 | 含義 |
|---|---|
text |
一行描述 |
state |
plan / done / aborted |
week |
所屬 ISO 周，如 2026-W45 |
day |
最近一次狀態變更日期 |
tag |
可選標籤，不參與報告分組 |
link |
可選鏈接，導出時附在行末 |
history |
創建 / 完成 / 中止 / 順延 / 移動等痕跡 |
安裝與啓用¶
插件以當前 DSH 進程權限運行；安裝前建議在 GitHub 查看源碼與 MIT 許可證。安裝命令以 README 爲準：
plugin_manager install_bundle target=dsh-weekly-log
成本與前置：插件不單獨要 API Key。「AI 潤色」走 Harness 已配置的模型，費用按該模型計費。設置頁會顯示運行版本，並提供「檢查更新」；從 npm 安裝的 bundle 可通過 pluginManager.updateBundle 原地升級（失敗會回滾）。本地 link: 安裝無法自助升級，面板會說明而非靜默失敗。
典型用法¶
- 記流水：在面板輸入一行，選「完成」或「計劃」，回車。工作中隨手記，避免週末回憶。
- 翻周與處理計劃：用周切換條查看歷史或未來周；對未完成計劃做完成、順延或中止。
- 出週報：點「生成報告」，需要時再點「AI 潤色」，然後複製或保存 Markdown。
- 在對話裏操作：讓 Agent 調用
weekly_log寫入、weekly_report生成，與面板數據一致。
導出路徑默認：
<當前工作區>/reports/weekly-<ISO week>.md
若希望報告進 git，可在設置裏把導出目錄指到倉庫內路徑；條目 JSON 本身不跟工作區走，也不進 git。
適用場景與注意¶
適合：需要按 ISO 周整理個人工作清單、定期輸出結構化週報 Markdown 的 Harness 用戶；希望在側欄與對話兩端都能記與導出的場景。
注意：
- 面板界面目前僅中文（商店 locale 含中英文元數據）。
- AI 潤色依賴 Harness 已配置默認模型；未配置時只能手工編輯。
- 數據存在 profile 級 JSON，不按工作區隔離；多機需自行同步
~/.dsh/weekly-report/data.json。 - 存儲爲插件自有 JSON 文件，而非框架 KV 域（profile 安裝的插件無法解析
@deepseek-ai/dsh-storage-domain）。
已知侷限（來自 README）：同上語言與模型依賴；數據不隨工作區、不進版本庫，需自行規劃導出目錄與備份。
結尾¶
dsh-weekly-log 把「邊做邊記」和「按周導出 + 可選潤色」收進 Harness 客戶端：一條安裝命令、側欄面板、兩個 Agent 工具，不額外綁定 API Key。進一步瞭解用法與發佈說明見倉庫 README 與 docs/PUBLISHING.md。
- 社區目錄：https://www.skillhub.cn/plugins/doombeaker/dsh-weekly-log
- GitHub：https://github.com/doombeaker/dsh-weekly-log
