dsh-commit-journal：在 DSH 裏同步 Codeup 提交、查歷史與生成報告

前言¶

用 DeepSeek Harness（DSH）寫日報或復盤時，提交記錄往往還在雲效 Codeup 的 Web 裏，和對話上下文是割裂的。手工複製 commit message 既慢，也經不起按倉庫、按時間範圍反覆查詢。dsh-commit-journal 是 yu-bobo 維護的 DSH 聯網類插件：在本機增量同步關注倉庫的提交，提供側欄面板查看時間線與活躍熱力圖，並把本地緩存交給 Agent 工具做查詢與日報、週報、月報材料生成。v0.1 僅對接 Codeup；GitLab、GitHub 在路線圖中。功能與桌面端 codeup-journal 同源，數據目錄獨立。

這是什麼¶

插件全稱 dsh-commit-journal，歸類爲聯網工具。它在 DSH 側欄註冊「提交日誌」，負責賬號與 PAT 管理、倉庫關注、提交同步與展示；報告與檢索類能力主要通過對話中的 Agent tools 完成，面板沒有單獨的「報告」頁籤。

維護者：yu-bobo。源碼與說明：GitHub；社區目錄：SkillHub 插件頁。許可證 MIT；當前 package 版本 0.1.7；要求 Node.js >= 20，DSH >=0.2.0-0 <0.3.0-0。

核心能力¶

下面按 README 已寫明的能力歸納，不展開路線圖裏尚未實現的 Provider。

能力	說明
多賬號	PAT 加密存放在本機 `~/.dsh-commit-journal/secrets`
增量同步	按關注倉庫 / 作者過濾拉取提交
面板	賬號 · 倉庫 · 提交 · 活躍 · 日誌 · 設置
Provider	v0.1：Codeup；GitLab / GitHub 企業版見路線圖

Agent 側可調用工具包括：list_accounts、upsert_account / remove_account、sync_commits、list_repos、query_commits、get_period_report、get_activity_heatmap、update_journal_settings。適合先同步再按日期、倉庫、關鍵詞查提交，或生成日 / 周 / 月及自定義區間的 Markdown 材料，並查看活躍熱力與單日明細。

安裝與啓用¶

插件面向 DSH Web 側欄（--profile web）。官方安裝命令如下；本地開發可把倉庫路徑替換成 link:<本倉庫路徑>。

dsh plugin --profile web add github:yu-bobo/dsh-commit-journal

安裝後需重啓 DSH 生效。插件以當前 DSH 進程權限運行，安裝前建議自行查看倉庫源碼與 MIT 許可證，並僅在信任的環境中配置 PAT。

面板用法（Codeup）¶

打開側欄「提交日誌」→ 賬號：新建 Codeup 賬號（中心版填 organizationId + PAT；Region 版填 API Base）。
在賬號列表點使用切換當前賬號。
倉庫：刷新、勾選關注、保存後執行「同步關注」。
在 提交 / 活躍 / 日誌 查看記錄；設置中可調整同步間隔與回溯天數。

雲效個人訪問令牌至少需：代碼倉庫、提交 → 只讀。建議同時授予代碼組、分支 → 只讀。修改權限後應新建令牌。

典型 Agent 流程與提示詞¶

建議順序：list_accounts →（本地缺數據時）sync_commits → query_commits / get_period_report / get_activity_heatmap。數據以本機緩存爲準。

示例（摘自 README，可直接改參數使用）：

先 list_accounts，用當前賬號 sync_commits，再給我昨天的工作日報（get_period_report kind=day）。

查本週我在各倉庫的提交，按倉庫分組總結做了什麼（query_commits + 必要時 get_period_report kind=week）。

生成這個月的月報材料，標註法定工作日，Markdown 落盤（get_period_report kind=month, exportFile=true）。

看近一年活躍熱力：總提交、活躍天數、最長連續；並列出提交最多的那天明細（get_activity_heatmap，再帶 date）。

搜索關鍵詞「修復」近 30 天的提交，列出倉庫、時間和說明（query_commits）。

同步賬號 xxx 的提交後，列出有提交記錄的倉庫（sync_commits → list_repos）。

數據目錄與配置¶

默認根目錄爲 ~/.dsh-commit-journal/，可用環境變量 DSH_COMMIT_JOURNAL_HOME 覆蓋。典型結構：

~/.dsh-commit-journal/
  accounts.json
  settings.json
  secrets/*.bin
  data.json
  holiday-cache/
  exports/

update_journal_settings 可調整同步間隔、回溯天數、導出目錄等。

適用場景與注意¶

適合已將主要代碼託管在阿里云云效 Codeup、希望在 DSH 對話裏基於真實提交寫報、做檢索或看熱力圖的開發者。若倉庫在 GitLab 或 GitHub，需等待路線圖中的 Provider，當前版本無法直接同步。

PAT 與本機 data.json 含敏感信息，勿將數據目錄提交到版本庫或共享到不可信環境。社區目錄 SkillHub 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；安裝來源以 GitHub 與目錄頁說明爲準。

結尾¶

經過上面的步驟，你可以在 DSH 內完成 Codeup 提交同步、面板瀏覽與 Agent 驅動的報告材料生成，減少在託管平臺與對話之間來回搬運記錄的成本。進一步瞭解能力細節與變更，見 GitHub README 與 SkillHub 目錄頁。