前言¶
用 DeepSeek Harness（DSH）做多項目開發時，一天往往對應多個會話、多個工作目錄。到寫日報或週報時，憑記憶很難還原「今天實際推進了什麼、改動了哪些文件」。手工翻會話或複製粘貼既費時，也容易漏掉已經忘記的會話。
dsh-worklog 是社區插件，維護者爲 ayf-master，分類爲工作流。它不依賴你事後回憶，而是讀取 DSH 的會話日誌，按工作目錄分組，生成日報、週報、月報的 Markdown 臺賬，並落盤到本地目錄，便於查閱或貼進週報。
這是什麼¶
插件一句話定位：從 DeepSeek Harness 的會話日誌裏還原你真正做了什麼，按工作目錄分組寫成 Markdown 臺賬，日報、週報、月報共用同一套邏輯。
源碼與說明見 GitHub：ayf-master/dsh-worklog；社區目錄頁爲 SkillHub 插件頁。許可證爲 MIT，當前 package 版本爲 0.1.0。
核心功能¶
下面介紹插件從日誌裏提取並整理的內容（均以 README 描述爲準）。
- 按工作目錄分組：跨項目的會話會彙總到各自目錄下的同一份臺賬結構中。
- 單會話摘要：時間段、輪數、中斷次數、你的需求、改動文件及次數、用到的工具、最後一條進展。
- 週報 / 月報：按項目彙總；同一會話跨天時可合併爲一行並標註「跨 N 天」（可通過設置關閉）。
- 產物清單（可開關）：臺賬末尾列出改動最多的文件、新生成的文檔、跑過的關鍵命令。
- 輸出路徑：默認
~/.dsh/worklog/，可在設置中改outputDir；亦可用環境變量DSH_WORKLOG_DIR兜底（優先級低於設置頁裏的outputDir）。
臺賬從會話日誌重建，插件通過宿主 sessionQuery 服務讀取日誌，不直接解壓盤上的 zstd 多幀文件；設計上強調不編造未發生的事。
安裝與啓用¶
要求 DeepSeek Harness ≥ 0.2.1-rc.5，Node ≥ 20。
命令行安裝（非桌面 profile 場景）：
dsh plugin --profile desktop add dsh-worklog
桌面版應在應用內 設置 → 插件 安裝：桌面應用的 profile 由應用內插件管理器管理，命令行無法替代該路徑。安裝後刷新頁面，設置裏會多出「工作臺賬」一頁。
插件以當前 DSH 進程權限運行；安裝前建議自行查看倉庫源碼與 MIT 許可證，確認符合你的環境與合規要求。
典型用法¶
在輸入框使用 /worklog 命令：
/worklog # 今天
/worklog 昨天
/worklog 2026-11-05
/worklog 本週 # 週報，按項目彙總
/worklog 上週
/worklog 本月 # 月報
/worklog 上月
也可以在對話裏直接說「生成本週週報」，agent 會調用 worklog_generate 工具，period 參數與上述口徑一致。
落盤文件名示例（目錄可配置）：
| 路徑 | 內容 |
|---|---|
~/.dsh/worklog/2026-11-06.md |
日報 |
~/.dsh/worklog/week-2026-11-02.md |
週報（以週一命名） |
~/.dsh/worklog/month-2026-11.md |
月報 |
設置與命令行改配置¶
打開 設置 → 工作臺賬（左側導航獨立項，在「通知提醒」下面），修改後立即生效，無需重啓。
| 字段 | 說明 |
|---|---|
outputDir |
臺賬存放目錄；留空用 ~/.dsh/worklog，支持 ~ 開頭 |
mergeCrossDay |
週報 / 月報裏同一會話跨天時合併成一行並標註「跨 N 天」 |
products |
臺賬末尾的「產物」清單 |
autoWeekly.enabled |
到點自動生成周報（僅本應用運行時生效） |
autoWeekly.weekday |
周幾生成，1 = 週一 …… 7 = 週日 |
autoWeekly.time |
生成時刻，24 小時制 HH:mm |
選項保存在 profile 的 Loader 行配置裏（settings 服務），不再使用插件目錄下的 config.json；舊版 ~/.dsh/worklog/config.json 會在首次啓動時自動遷移並刪除。
不想開設置頁時，可用：
/worklog 設置 # 查看當前設置
/worklog 設置 目錄 D:\我的臺賬 # 臺賬存放位置（留空或「默認」恢復）
/worklog 設置 合流 開|關 # 跨天合流（默認開）
/worklog 設置 產物 開|關 # 「產物」清單（默認開）
/worklog 設置 自動 開|關 # 每週自動生成周報（默認關）
/worklog 設置 時間 週日 22:00 # 自動週報的時間，可換周幾
自動週報在觸發時生成當週（週一至觸發日）的週報；若把時間設在週一，生成的是上一週。錯過的時刻不會補跑。
實現要點（閱讀源碼時）¶
host 側 index.js 負責 /worklog 命令、worklog_generate、設置頁 schema 與定時器；client 側 client.js 負責設置 → 工作臺賬頁面（settings.section 槽位）。改設置後刷新頁面即可，host 管數據與定時，client 只管設置 UI。
設置項由 Config（schemastery，字段帶 .volatile()）聲明；@deepseek-ai/schemastery 須與宿主同版本（~3.18.5），版本不一致時 volatile 字段可能被靜默丟棄。
適用場景與注意¶
適合：同一天多個 DSH 會話、多個倉庫或目錄並行，需要可復盤的 Markdown 臺賬或週報素材的開發者。
注意：
- 臺賬質量取決於會話日誌是否完整；插件不能記錄日誌裏不存在的行爲。
- 自動週報僅在應用運行到設定時刻時生效。
- 社區目錄 SkillHub 與 DeepSeek / 幻方無官方從屬關係，插件來自社區維護者 ayf-master。
結尾¶
經過上面的步驟，你可以在不停交互式問「今天做了什麼」的情況下，從已有會話日誌生成按目錄分組的日報、週報、月報。進一步安裝與字段說明以倉庫 README 爲準：https://github.com/ayf-master/dsh-worklog；目錄索引：https://www.skillhub.cn/plugins/ayf-master/dsh-worklog。
