前言¶
在 DeepSeek Harness（DSH）裏做多工作區、多智能體協作時，工程決策往往散落在各工作區 .agents/notes 下的 Markdown 裏：已實現、提案中、被否決、歸檔各有一套目錄。瀏覽器裏單獨打開某個目錄可以用獨立看板瀏覽，但在 Harness 左側欄裏切換工作區、統一檢索和對比決策，仍缺少一塊「跟宿主同權限、只讀筆記原文」的面板。
下面介紹社區插件 dsh-notes-board（維護者 scccy，分類：記憶）。它把各工作區 .agents/notes 裏的工程決策筆記渲染成 DSH 左側欄裏的原生面板，界面沿用 write-notes-like-deepseek 的原版看板邏輯（倉庫內 vendor/board.html 爲其逐字快照），數據來源從「瀏覽器選目錄」改爲宿主注入。
這是什麼¶
dsh-notes-board 是一個只讀 DSH 插件 bundle：Host 側只註冊兩條 GET 路由，讀取 workspace registry 裏已登記工作區的筆記 Markdown 原文，不寫文件、也不接受任意路徑。Client 側用 React 薄殼提供工作區下拉與刷新，在 shadow root 裏跑原版看板，切換工作區只換數據、不重建 DOM。
數據路徑約定爲：
.agents/notes/{implemented,proposed,rejected,archived}/{class}/yyyy-mm-dd-topic.md
解析、分類、引用入度與四個視圖均由原版 parseNote / ingestDataset 完成；Host 不解析筆記內容。
核心功能¶
安裝並刷新後，左側欄會出現「筆記看板」入口。面板內主要包括：
- 工作區切換：頂部工作區下拉框與刷新按鈕。
- 架構基線：KPI 四宮格、系統承重牆（按筆記間交叉引用入度排序）、領域架構分類陣列。
- 演進時間線：按月份或分類切片瀏覽。
- 避坑智庫：單獨聚焦被否決的提案，便於避免重複踩坑。
- 決策清單：按狀態、分類、排序篩選，並支持全文搜索。
- 詳情抽屜：點擊任意條目，右側按五節展開——背景與痛點、落地裁定事實、放棄的備選、收益與工程代價、因果與血緣鏈路。
原版看板中的引用入度、時間線切片、避坑智庫、深鏈、快捷鍵等能力在構建期機械適配後保留；Client 不重寫 UI，由 scripts/build-client.mjs 對 vendor/board.html 打補丁後生成 client.js（生成物不宜手改）。
Host 返回內容包含 zh 優先去重，並對超過 64KB 的內容做 gzip 處理（見 README 架構說明）。
安裝與啓用¶
需要已安裝 DeepSeek Harness。插件當前版本爲 0.1.1（見倉庫 package.json），運行構建腳本要求 Node >= 20。
取得插件 bundle 的本地目錄後，在 DSH 插件管理裏使用 install_bundle，目標填寫該目錄的絕對路徑；或將目錄掛進 profile 依賴，例如：
"dsh-notes-board": "link:/path/to/dsh-notes-board"
裝完後刷新頁面，左側欄應出現筆記看板圖標。
DeepSeek Harness 生態採用「一切皆插件」思路；社區目錄頁 skillhub.cn 上的 dsh-notes-board 爲獨立站點收錄，與 DeepSeek / 幻方無官方從屬關係。
典型用法¶
- 在各工作區按約定目錄寫入或維護決策筆記 Markdown。
- 在 DSH 中安裝本 bundle 並刷新，打開左側「筆記看板」。
- 用頂部下拉切換工作區，在四個板塊間瀏覽；需要正文時用抽屜查看五節結構。
- 數據變更後點刷新，Host 重新掃描並返回原文，Client 再走原版 ingest 流程。
插件不提供寫回筆記的接口；編輯仍應在工作區文件或既有筆記工作流中完成。
適用場景與注意¶
適合：已在多個 DSH 工作區使用 .agents/notes 記錄工程決策、希望在 Harness 內只讀瀏覽承重牆、時間線、否決提案與決策清單的開發者。
注意：
- 插件以當前 dsh 進程權限 運行，只能讀取 registry 中登記過的工作區；安裝前請閱讀 GitHub 倉庫 源碼與 MIT LICENSE；看板模板來源見 NOTICE.md（
vendor/board.html來自 write-notes-like-deepseek，頁面內自述遵循 MIT）。 - 若需改宿主殼，編輯
src/panel.js；若需改補丁邏輯，編輯scripts/build-client.mjs；上游模板更新時替換vendor/board.html後執行npm run build，斷言失敗處需同步修補丁。本地驗證可運行npm test（樁 DOM 跑四視圖與抽屜五節渲染）。
結尾¶
dsh-notes-board 把分散在各工作區 .agents/notes 的決策筆記，收斂爲 DSH 左側欄裏的一塊只讀原生面板，解析與 UI 與 write-notes-like-deepseek 原版對齊，Host 只負責列舉工作區與回傳 Markdown 原文。
- 目錄頁：https://www.skillhub.cn/plugins/scccy/dsh-notes-board
- 源碼與說明：https://github.com/scccy/dsh-notes-board
