dsh-work-review:把一周日记与 Dream 收成 ISO 周报的 DSH 工作流插件

前言

在 DeepSeek Harness(DSH)里做智能体开发,对话和任务往往分散在会话里;若你同时用 Obsidian 风格 vault 记 journal、Dream 早报和任务,「这周到底做了什么」仍要靠人工翻七天文件或 git log。手写周报容易漏事实,反复粘贴又和 vault 里的原始记录脱节。

下面介绍社区插件 dsh-work-review(维护者 Wang-Chuming):它从 vault 读取一个 ISO 周(周一至周日)的 Dream、journal、ingest 摘要、任务目录与本周 git 记录,生成稳定的周报 Markdown,并在 Harness Web GUI 左侧只读面板「工作回顾 / Work Review」里按日、按周查看。同一包还包含 nightly Dream、可选的「常规」项审批执行,以及 automation/ 下的定时示例。插件归类为工作流;当前 GitHub 星标为 0,许可证 MIT,版本 0.5.0(以仓库 package.json 为准)。

这是什么

dsh-work-review 是面向 DSH Web GUI 的 bundle 插件:Host 半部(lib/index.js)注册只读 HTTP 路由与可选的 work_review_status 模型工具;Client 半部(lib/client.js)在侧栏「自动化任务」下方展示面板。真正写盘只有你在命令行运行的 CLI(lib/cli.js、lib/nightly.js、lib/review.js 等),面板与 API 不生成、不写入 vault。

产出路径固定为 <vault>/life/routines/<YYYY>-W<ww>.md;生成块夹在 <!-- sleep-routine:generated --> 与 <!-- sleep-routine:generated:end --> 之间,内含 facts 哈希,输入未变则跳过重写,结束标记之后的手写内容不会被覆盖。

核心功能

周报合成

CLI 汇总 life/dreams/<date>.md、life/journal/<date>.md、life/notes/ingest/<date>.md、life/tasks/ 以及该 ISO 周的 git log,写入 life/routines/ 下的周报文件。默认通过本机 dsh --profile headless 做 LLM 合成(使用 profile 已有模型,README 说明不需要 API key、不需要 patch);加 --no-llm 则输出确定性骨架并明确标注未经合成。

每晚 Dream 与审批(可选)

node lib/nightly.js 根据当日 journal、ingest、未关闭任务与 git 窗口(默认日界 05:00→05:00)写出 life/dreams/<date>.md,计划项带 T1… / G1… 编号,每条含 自动批准: 常规 | 升级。node lib/review.js 默认只打印计划;--run 启动只读 agent,--live 才允许改任务与本地 commit,且仅执行标记为 常规 的条目,结果写回 journal 的审批块。

只读侧栏与 API

左栏「工作回顾」含日报 tab(优先 Dream,否则 journal)与周报 tab。三个 GET 路由供面板使用:

路由 用途
/work-review/api/index 索引:哪些日期有 Dream / journal / ingest,已有哪些周报,当前 ISO 周
/work-review/api/report?date=YYYY-MM-DD 单日 Dream 与 journal 正文
/work-review/api/routine?week=YYYY-Www 某周周报全文与 frontmatter

配置 review 或 approve 后,日报视图可出现「去审批」「执行自动审批」按钮(均为可选,未配置则不显示)。

安装与启用

环境要求:带 Web GUI 与 plugin bundle 的 DeepSeek Harness、Node.js ≥ 22(CLI 与测试用;运行时插件仅使用 Node 内置模块)、符合插件文档「数据层约定」目录结构的 vault。README 注明主要在 macOS 上开发和验证。

1. 把插件加进 profile

在终端执行(<profile> 换成你的 profile 名,例如 desktop):

dsh plugin --profile <profile> add github:Wang-Chuming/dsh-work-review

因包内声明了 dsh.bundle,该命令还会把 bundle 行写入 dsh.profile.bundles;桌面端也可用插件管理器安装,效果相同。

2. 指向 vault

mkdir -p ~/.dsh
cat > ~/.dsh/work-review.json <<'JSON'
{
  "vaultRoot": "/path/to/your/vault"
}
JSON

vaultRoot 为必需字段;路径可用 ~。也可用环境变量 DSH_WORK_REVIEW_VAULT 或 CLI 的 --vault 覆盖(优先级:命令行 → 环境变量 → ~/.dsh/work-review.json)。

3. 完整重启 Harness

退出并重新打开应用;仅刷新页面不够。重启后应看到左栏「工作回顾」位于「自动化任务」下方,页脚显示解析到的 vault 路径。

社区目录页:https://www.skillhub.cn/plugins/Wang-Chuming/dsh-work-review(独立站点,与 DeepSeek / 幻方无官方从属关系)。源码:https://github.com/Wang-Chuming/dsh-work-review。

典型用法

只有 CLI 会写文件;需在插件仓库目录下执行(安装后路径以你本机 DSH 插件目录为准)。先试跑 facts、不调模型:

node lib/cli.js --week 2026-W43 --dry-run

生成上一完整 ISO 周周报(与定时任务默认一致):

node lib/cli.js --week last

离线骨架、不调用模型:

node lib/cli.js --week 2026-W43 --no-llm

facts 未变仍要重写时:

node lib/cli.js --week 2026-W43 --force

自动化链路示例(详见仓库 automation/README.md):

node lib/nightly.js --date yesterday
node lib/review.js --date <date>
node lib/review.js --date <date> --run
node lib/cli.js --week last

在 GUI 中打开左侧「工作回顾」,切换日报 / 周报 tab 只读浏览;需要 agent 回答「上周做了什么」时,可依赖同源的 work_review_status 工具(需 Harness 已注册 tools 服务)。

适用场景与注意

适合已经在 vault 里按 life/dreams、life/journal、life/tasks 等约定记日课、又希望用 ISO 周文件做复盘、并在 DSH 里只读查看的开发者。若你不需要 Obsidian 式目录或本地 headless 合成,安装收益有限。

插件 Host 与 CLI 以当前 DSH 进程与用户权限读 vault;--live 审批会改任务与做本地 commit(README 强调不 push)。安装前应阅读仓库源码与 MIT 许可证,确认 vault 路径与自动化脚本符合你的安全边界。社区目录上的简介与 GitHub README 一致:把一周 journal 与 Dream 收成 ISO 周 routine report,并在只读 Work Review 侧栏阅读。

结尾

dsh-work-review 把「七天分散笔记 + git」收成一份可幂等重跑的 <YYYY>-W<ww>.md,并把阅读入口放进 Harness 侧栏,写盘仍掌握在你运行的 CLI 与可选定时任务手里。更多参数、provider、review / approve 配置与 vault 目录约定见仓库 README.zh-CN.md。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye