前言¶
在 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
