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 目录页。