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。

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

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

小夜