dsh-notes-board 0.1.1 → 0.3.0

package/NOTICE.md

@@ -9,6 +9,13 @@
 - **授权**：上游仓库当前尚未提供 LICENSE 文件；其生成的看板页面页脚自述「Agent Notes · 工程决策看板 · 遵循 MIT 协议开源」。本仓库据此按 MIT 处理并保留出处标注。若上游后续发布正式授权条款，以彼为准，本文件会同步更新。
 - **改动**：本仓库**不修改**该文件本身。所有适配（`:root` → `:host`、作用域改写、事件接管、路由收拢、数据源注入、视图懒渲染）都发生在构建期，由 `scripts/build-client.mjs` 施加到生成物 `client.js` 上，且每处补丁都带数量断言。
 
+## vendor/write-notes-like-deepseek
+
+- **来源**：同一上游仓库 [czm15053/write-notes-like-deepseek](https://github.com/czm15053/write-notes-like-deepseek) 的快照。
+- **内容**：`skills/write-notes-like-deepseek/`（SKILL.md、references、templates、`assets/agent-notes-board.html` 与 7 个校验/构建脚本）、`scripts/`、README、package.json。`note_verify` 直接 shell out 跑其中的 `verify-agent-note-tree.ts` / `verify-agent-note-format.ts` / `verify-archived-agent-notes.ts`，规则只有这一个源头。
+- **授权**：同上（上游未提供 LICENSE 文件，按其页面自述按 MIT 处理并保留出处标注）。
+- **改动**：裁掉上游的 `assets/`（22 张约 5 MB 配图）与 `.github/`，不影响校验；其余原样。
+
 ## 字体
 
 原版看板引用 Google Fonts（Space Grotesk / Plus Jakarta Sans / JetBrains Mono），由原版 `<link>` 在运行时加载，本仓库不打包字体文件。字体授权见 Google Fonts 各自条目（均为 SIL Open Font License）。

package/README.md

@@ -2,6 +2,8 @@
 
 把各个工作区 `.agents/notes` 里的工程决策笔记，变成 DeepSeek Harness 左侧栏里的一个原生面板：切换工作区、四个板块浏览、抽屉看正文。
 
+同一个插件还带**笔记工具与钩子**：`note_search` / `note_read` / `note_write` / `note_verify` / `note_skip` 五个原生工具，加一个 `turn/end` 钩子——改过代码的轮次结束时，必须落一篇笔记或显式 skip。再带**随包的技能**：`write-notes-like-deepseek` 由插件自己挂给 agent，不用往 `~/.dsh/skills` 手工装。
+
 界面直接跑 [write-notes-like-deepseek](https://github.com/czm15053/write-notes-like-deepseek) 的原版看板（`vendor/board.html` 是它的逐字快照），只是把数据来源从「浏览器选目录」换成了宿主注入——所以原版的引用入度、时间线切片、避坑智库、深链、快捷键一个都不少。
 
 <!-- 截图占位：欢迎 PR 补一张面板截图 -->
@@ -20,43 +22,143 @@
 
 数据全部来自各工作区 `.agents/notes/{implemented,proposed,rejected,archived}/{class}/yyyy-mm-dd-topic.md`。
 
-## 安装
+## 另外两件：工具、钩子与技能
+
+为什么要有钩子：`write-notes-like-deepseek` 是 skill，属于「模型可能选、也可能不选」——触发不稳定，这不是写得好不好的问题，是形态问题。所以拆两层：
+
+| 层 | 负责 | 形态 | 确定性 |
+|---|---|---|---|
+| **什么时候必须做决定** | 每轮结束检查：改了代码却没有记录决定 → 当场要求二选一 | DSH `turn/end` 钩子 | 模型选不了，钩子一定跑 |
+| **做什么** | 搜索 / 读 / 写 / 校验 / 记账 | 5 个工具 | 靠 description 引导 |
 
-需要 DeepSeek Harness（DSH）。克隆到本地后，在 DSH 里以目录方式安装这个 bundle：
+钩子只保证「必须做决定」，不保证「必须写」——所以出口有两个：`note_write` 和 `note_skip`。只有一个出口的话，改错别字也要立一篇笔记，立刻变噪声。
 
+| 工具 | 读/写 | 什么时候用 |
+|---|---|---|
+| `note_search` | 读 | 提方案前、想推翻旧决定前、改跨文件契约前。空结果返回 `NO_MATCHING_NOTE`——**是"没记录"，不是"没这个决定"**，要换词再搜 |
+| `note_read` | 读 | 拿到路径后看全文；理由通常在 `Alternatives considered` 和 `Consequences` |
+| `note_write` | 写 | 非机械改动落定后写一篇；写前按上游规则校验，不合法**不落盘**并回具体错误 |
+| `note_verify` | 读 | 手改过笔记后、或声称一致之前，跑上游三个校验器 |
+| `note_skip` | 写 | 已判定不需要笔记时，一句话理由记进 `.agents/notes/.skips.log` |
+
+`note_write` 的 `body` **不带**标题行和 `Status:` 行——那两行由 `title` / `lifecycle` 生成。
+
+文件名固定是 ASCII slug。标题是中文时（本仓库里很常见）必须另传 `slug`，否则直接拒写并提示：
+
+```
+NEEDS_SLUG: title has no Latin characters to build a filename from; pass slug with 2-5 ASCII words
 ```
-git clone https://github.com/scccy/dsh-notes-board.git
+
+### 钩子怎么判
+
+- `turn/start` 重置本轮状态
+- `tool/call`：
+  - 工具名在 `note_write` / `note_skip` 里，或参数/结果里出现 `.agents/notes` → 本轮**已交代**，不再提醒
+  - 工具名在 `codeTools` 里（默认 `bash`、`write`、`edit`、`apply_patch` …）且不是只读命令 → 记为**动了代码**
+- `turn/end`：动了代码 **且** 没交代 **且** 本轮没提醒过 **且** 没到 `maxPerSession` → 注入提醒
+
+只读命令靠 `readonlyCommandPattern` 排除（`ls`、`cat`、`grep`、`git status/diff/log` …），否则只读排查也会被催。
+
+`wake` 默认 **false**：`agent.inject()` 不唤醒代理，提醒会在**下一个** admitted step 生效，不额外烧 token。想让它当场行动就设 `wake: true`（会调 `agent.followup()`）。
+
+`note_verify` 直接 shell out 跑上游三个脚本（tree / format / archived），**不重新实现规则**——规则只有一个源头，避免两套实现漂移。Node 24 能直跑 `.ts`，不需要 tsx。
+
+### 技能从哪来
+
+`write-notes-like-deepseek` 不需要再装到 `~/.dsh/skills`：`src/host/skills.js` 用宿主自带的 `@deepseek-ai/dsh-skill-filesystem` 起一个独立 provider（`providerName: 'agent-notes'`），`bundledSkillDir` 指向 `vendor/write-notes-like-deepseek/skills`。
+
+- 技能随包走：装插件即装技能，卸载即消失；升级时和 `note_verify` 用的三个校验器一起换，因为它们本来就是同一份目录，不会分叉。
+- `includeDefaultRoots: false`，这个 provider 只提供随包那一份，不重复索引 `~/.dsh/skills`。
+- 宿主没有这个包、或 `ctx.plugin` 不可用时静默跳过（只写一行 info 日志），面板与工具照常工作。
+
+## 安装
+
+需要 DeepSeek Harness（DSH）。用 `dsh plugin` 装，`--profile` 换成本机 profile 名（常见的是 `web`）：
+
+```sh
+dsh plugin --profile web add dsh-notes-board
 ```
 
-然后在 DSH 的插件管理里 `install_bundle`，目标填这个目录的绝对路径；或者直接把目录放进 profile 的依赖里（`"dsh-notes-board": "link:/path/to/dsh-notes-board"`）。装完刷新页面，左侧栏出现图标。
+它把参数原样转给 profile 目录里的 pnpm，装完自动把这个包登记进 `dsh.profile.bundles`。之后重启该 profile（`dsh web`），左侧栏出现「笔记看板」图标。
+
+> 桌面 App 用的 `desktop` profile 由 Electron 独占管理，`dsh plugin` 会直接拒绝：
+> `profile "desktop" is managed exclusively by the Electron application`。
+
+> 面板是只读的：Host 侧只注册两条 GET 路由，不写任何文件，也不接受任意路径——只读 workspace registry 里登记过的工作区。写文件只发生在你（或代理）主动调用 `note_write` / `note_skip` 时。
+
+本包**零运行时依赖**：`@deepseek-ai/dsh-tools`、`@deepseek-ai/dsh-llm`、`@deepseek-ai/schemastery`、`@deepseek-ai/dsh-skill-filesystem` 全部是可选 `peerDependencies`，由宿主提供。
 
-> 只读插件：Host 侧只注册两条 GET 路由，不写任何文件，也不接受任意路径——只读 workspace registry 里登记过的工作区。
+## 配置
+
+`cordis.patch.yml` 里可改的键（profile 级 patch 覆盖，升级不丢）：
+
+| 键 | 默认 | 含义 |
+|---|---|---|
+| `root` | `''` | 笔记根所在工作区；空 = 代理工作目录，再退到 `process.cwd()` |
+| `reminder.enabled` | `true` | 是否提醒 |
+| `reminder.wake` | `false` | 是否立刻唤醒代理 |
+| `reminder.maxPerSession` | `6` | 单会话提醒上限（是提醒，不是循环） |
+| `codeTools` | 见源码 | 视为"改工作区"的工具名 |
+| `readonlyCommandPattern` | 见源码 | 命中即视为只读 bash |
 
 ## 工作原理
 
+一个包、一条 loader row、一个 `apply`，入口只做组合：
+
 ```
-Host (index.js)                       Client (client.js)
-  GET /api/dsh-notes-board/workspaces   ┌─ React 薄壳：工作区下拉 / 刷新 / 状态
-  GET /api/dsh-notes-board/scan         │
-        │                               └─ shadow root 里跑原版看板
-        └── 只回 .agents/notes 的 Markdown 原文
-            （zh 优先去重、>64KB gzip）
+index.js  ← 组合层：ctx.inject(['webServer']) → applyBoard ；applyNotes ；mountNotesSkills
+  │
+  ├── src/host/board.js      看板半边（只读）
+  │     GET /api/dsh-notes-board/workspaces
+  │     GET /api/dsh-notes-board/scan
+  │           └── 只回 .agents/notes 的 Markdown 原文（zh 优先去重、>64KB gzip）
+  │
+  ├── src/host/notes.js      笔记半边
+  │     ctx.tools.register × 5  +  ctx.on('session/event') 的 turn/end 钩子
+  │        │
+  │        ├── src/core/tools.js   5 个工具的唯一定义
+  │        └── src/core/notes.js   结构解析、校验、搜索、skip 账本、跑上游校验器
+  │
+  └── src/host/skills.js     技能半边
+        ctx.plugin(dsh-skill-filesystem, {providerName:'agent-notes', bundledSkillDir: vendor/…/skills})
 ```
 
+- **三个半边各自 gate 自己的服务**。入口不导出 `inject`，所以缺 `webServer` 的 profile 里看板静默不激活、缺 `tools` 的 profile 里钩子静默不激活、缺 `dsh-skill-filesystem` 的宿主里技能静默跳过，谁都不会把整条插件行拖成加载失败。
 - **Host 不解析笔记**。它只列出工作区、读原文、按相对路径返回。分类、引用入度、四个视图全部交给原版 `parseNote` / `ingestDataset`，解析逻辑只有一份。
 - **Client 不重写 UI**。`scripts/build-client.mjs` 把 `vendor/board.html` 做机械改造后拼进 `client.js`：`:root` → `:host`（挂 shadow root 做样式隔离）、`document.getElementById` → 作用域内 `byId()`、`location.hash` → 面板内自持路由、摘掉「浏览器目录授权」启动块改由 `ingestFiles()` 喂数据、四个视图改成按 tab 懒渲染。每个补丁都带数量断言，上游模板一变，构建直接失败而不是静默错改。
+- **只有一条出口**。`src/core/tools.js` 是 5 个工具的唯一定义，`src/host/notes.js` 是唯一适配层；`note_verify` 与技能 provider 指的都是 `vendor/write-notes-like-deepseek` 那一份，规则不存在第二处副本。
 
 ### 开发
 
 ```sh
 npm run build   # src/panel.js + vendor/board.html -> client.js（生成物，别手改）
-npm test        # 桩 DOM 跑一遍四视图 + 抽屉五节渲染
+npm test        # 两件套：桩 DOM 跑四视图 + 抽屉五节；入口/钩子/技能 25 条用例
+npm run test:board / test:hooks   # 单独跑
 ```
 
+没有运行时依赖，**不需要 `npm install`**；宿主包全部靠测试里的 `node --import ./test/stubs/register.mjs` 短路成 stub。
+
 改界面：改 `src/panel.js`（宿主壳）或 `scripts/build-client.mjs`（补丁表）。
-上游更新：替换 `vendor/board.html`，重跑 `npm run build`，按断言失败处修补丁。
+上游更新：替换 `vendor/board.html`，重跑 `npm run build`，按断言失败处修补丁。仓库里另有一份同源的技能资产副本 `vendor/write-notes-like-deepseek/skills/write-notes-like-deepseek/assets/agent-notes-board.html`，`npm test` 会断言两份 sha256 一致，防止只换一份导致分叉。
+
+### 目录
+
+```
+index.js            插件入口（组合层）
+client.js           客户端生成物（别手改）
+src/panel.js        客户端源：React 薄壳 + shadow root 装原版看板
+src/host/board.js   看板半边：两条只读路由
+src/host/notes.js   笔记半边：5 个原生工具 + turn/end 钩子
+src/host/skills.js  技能半边：把随包技能挂成 agent 技能
+src/core/notes.js   结构解析、校验、搜索、skip 账本、跑上游校验器
+src/core/tools.js   5 个工具的唯一定义
+test/               入口 / 钩子 / 技能挂载测试、宿主 stub
+vendor/             看板模板快照 + 上游 skill 源码（含三个校验脚本）
+```
 
 ## 授权与来源
 
 - 本仓库代码：MIT，见 [LICENSE](LICENSE)。
 - `vendor/board.html`（看板模板本体）来自 [czm15053/write-notes-like-deepseek](https://github.com/czm15053/write-notes-like-deepseek)，其生成的页面内自述「遵循 MIT 协议开源」。原样收录、未改动语义，只在构建期做上述机械改造。详见 [NOTICE.md](NOTICE.md)。
+- `vendor/write-notes-like-deepseek`（技能源码与校验脚本）clone 自同一上游，保留 `skills/`（SKILL.md、references、templates、7 个脚本）与 README、package.json；原仓库的 `assets/`（22 张 5 MB 配图）、`.github/` 已裁掉，不影响校验。
+- 工具 / 钩子 / 技能半边原为独立包 `dsh-agent-notes`（同一作者），2026-11-12 并入本仓库，决策记录见 `.agents/notes/implemented/architecture/2026-11-12-merge-notes-hook-into-notes-board.md`；同日移除 MCP 出口并把技能改为随包挂载，见 `.agents/notes/implemented/simplification/2026-11-12-drop-mcp-surface-mount-bundled-skill.md`。

package/index.js

@@ -1,185 +1,28 @@
 /**
- * dsh-notes-board · Host 半边
+ * dsh-notes-board · 插件入口
  *
- * 只做两件事，都是只读：
- *   1. 把 workspace registry 里登记的工作区列成 JSON（面板顶部的下拉框用它）；
- *   2. 读某个工作区 <dir>/.agents/notes 下的 Markdown 原文，按相对路径回给客户端。
+ * 一个包、一条插件行，拼起三件事：
+ *   - 看板半边 src/host/board.js：面板 + /api/dsh-notes-board/* 只读路由，依赖 webServer；
+ *   - 笔记半边 src/host/notes.js：5 个原生笔记工具 + turn/end 钩子，依赖 tools；
+ *   - 技能半边 src/host/skills.js：把随包的 write-notes-like-deepseek 挂成 agent 技能，
+ *     依赖宿主自带的 @deepseek-ai/dsh-skill-filesystem（缺了就静默跳过）。
  *
- * 解析、分类、引用入度、四个视图，全部交给原版看板的前端逻辑
- * （vendor/board.html 里的 parseNote / ingestDataset），Host 不重复实现一遍。
+ * 两半依赖的服务不同，所以入口不整体 inject 任一服务：没有 webServer 的 profile 里
+ * 看板静默缺席，没有 tools 的 profile 里钩子静默缺席，都不会让整条插件行抛错。
+ *
+ * 注意 applyNotes 拿到的是**插件自己的 ctx**（不是 ctx.inject 的子 scope）：它的
+ * session/event 监听必须挂在插件这一层，事件才冒泡得到它。tools 的就绪判断由
+ * applyNotes 内部负责。
  */
+import { applyBoard } from './src/host/board.js'
+import { applyNotes, NotesConfig } from './src/host/notes.js'
+import { mountNotesSkills } from './src/host/skills.js'
 
-import { existsSync } from 'node:fs'
-import { readdir, readFile, stat } from 'node:fs/promises'
-import { basename, join, sep } from 'node:path'
-import { gzipSync } from 'node:zlib'
-
-export const inject = ['webServer']
-
-const BASE = '/api/dsh-notes-board'
-/* 安全阀，不是业务上限：只防挂错目录（比如挂到家目录）时把进程拖死。
-   真触发时响应里带 truncated:true，面板会明确提示，绝不静默截断。 */
-const SAFETY_MAX_FILES = 50000
-const MAX_BODY = 400 * 1024
-
-function sendJson(req, res, code, payload) {
-  const raw = Buffer.from(JSON.stringify(payload), 'utf8')
-  const accepts = String((req && req.headers && req.headers['accept-encoding']) || '')
-  if (raw.length > 64 * 1024 && /\bgzip\b/.test(accepts)) {
-    const body = gzipSync(raw)
-    res.writeHead(code, {
-      'content-type': 'application/json; charset=utf-8',
-      'content-encoding': 'gzip',
-      'content-length': body.length,
-      'cache-control': 'no-store',
-    })
-    res.end(body)
-    return
-  }
-  res.writeHead(code, {
-    'content-type': 'application/json; charset=utf-8',
-    'content-length': raw.length,
-    'cache-control': 'no-store',
-  })
-  res.end(raw)
-}
-
-function fail(req, res, code, message) {
-  sendJson(req, res, code, { ok: false, message })
-}
-
-function listWorkspaces(ctx) {
-  const registry = ctx.get('workspaceRegistry')
-  if (!registry || typeof registry.list !== 'function') return []
-  const seen = new Set()
-  const out = []
-  for (const workspace of registry.list()) {
-    const path = typeof workspace?.path === 'string' ? workspace.path : ''
-    if (!path || seen.has(path)) continue
-    seen.add(path)
-    out.push({
-      id: String(workspace.id ?? path),
-      title: String(workspace.title || basename(path) || path),
-      path,
-      hasNotes: existsSync(join(path, '.agents', 'notes')),
-    })
-  }
-  return out
-}
-
-function resolveWorkspace(ctx, idOrPath) {
-  const wanted = String(idOrPath || '')
-  if (!wanted) return undefined
-  const all = listWorkspaces(ctx)
-  return (
-    all.find((w) => w.id === wanted) ||
-    all.find((w) => w.path === wanted) ||
-    all.find((w) => w.title === wanted)
-  )
-}
-
-/** 广度优先收集 .agents/notes 下的 Markdown，跳过点开头目录 */
-async function walkNotes(root) {
-  const found = []
-  const queue = [{ dir: root, depth: 0 }]
-  let truncated = false
-  while (queue.length) {
-    const current = queue.shift()
-    let entries
-    try {
-      entries = await readdir(current.dir, { withFileTypes: true })
-    } catch {
-      continue
-    }
-    for (const entry of entries) {
-      if (entry.name.startsWith('.')) continue
-      const abs = join(current.dir, entry.name)
-      if (entry.isDirectory()) {
-        if (current.depth < 5) queue.push({ dir: abs, depth: current.depth + 1 })
-        continue
-      }
-      if (!entry.isFile() || !/\.md$/i.test(entry.name)) continue
-      if (found.length >= SAFETY_MAX_FILES) {
-        truncated = true
-        break
-      }
-      found.push(abs)
-    }
-    if (truncated) break
-  }
-  return { paths: found, truncated }
-}
-
-async function readNotes(workspace) {
-  const root = join(workspace.path, '.agents', 'notes')
-  if (!existsSync(root)) return { root, exists: false, files: [], truncated: false }
-  const { paths: absPaths, truncated } = await walkNotes(root)
-  // 中英对照的 x.md / x.zh.md 只回一份，按原版看板的规则「zh 优先」
-  const byCleanPath = new Map()
-  for (const abs of absPaths) {
-    const rel = abs.slice(root.length + 1).split(sep).join('/')
-    const isZh = /\.zh\.md$/i.test(rel)
-    const clean = isZh ? rel.replace(/\.zh\.md$/i, '.md') : rel
-    const current = byCleanPath.get(clean)
-    if (!current || isZh) byCleanPath.set(clean, { abs, rel, isZh })
-  }
-  const files = []
-  for (const [cleanRel, entry] of byCleanPath) {
-    try {
-      const info = await stat(entry.abs)
-      const text = await readFile(entry.abs, 'utf8')
-      files.push({
-        path: cleanRel,
-        raw: text.length > MAX_BODY ? text.slice(0, MAX_BODY) : text,
-        mtime: Math.round(info.mtimeMs / 1000),
-      })
-    } catch {
-      /* 单个文件读失败不影响整体 */
-    }
-  }
-  files.sort((a, b) => a.path.localeCompare(b.path))
-  return { root, exists: true, files, truncated }
-}
-
-export function apply(ctx) {
-  ctx.effect(() =>
-    ctx.webServer.register({
-      kind: 'exact',
-      path: `${BASE}/workspaces`,
-      handler(req, res) {
-        try {
-          sendJson(req, res, 200, { ok: true, workspaces: listWorkspaces(ctx) })
-        } catch (error) {
-          fail(req, res, 500, error instanceof Error ? error.message : String(error))
-        }
-      },
-    }),
-  )
+export const name = 'dsh-notes-board'
+export const Config = NotesConfig
 
-  ctx.effect(() =>
-    ctx.webServer.register({
-      kind: 'exact',
-      path: `${BASE}/scan`,
-      async handler(req, res) {
-        const url = new URL(req.url || '/', 'http://localhost')
-        const workspace = resolveWorkspace(ctx, url.searchParams.get('workspace') || '')
-        if (!workspace) return fail(req, res, 404, '未登记的工作区')
-        try {
-          const { root, exists, files, truncated } = await readNotes(workspace)
-          sendJson(req, res, 200, {
-            ok: true,
-            workspace,
-            root,
-            exists,
-            files,
-            truncated: !!truncated,
-            safetyLimit: SAFETY_MAX_FILES,
-            scannedAt: Date.now(),
-          })
-        } catch (error) {
-          fail(req, res, 500, error instanceof Error ? error.message : String(error))
-        }
-      },
-    }),
-  )
+export function apply(ctx, config = {}) {
+  ctx.inject(['webServer'], (sub) => applyBoard(sub))
+  applyNotes(ctx, config)
+  mountNotesSkills(ctx)
 }

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "Notes Board",
-    "description": "Adds a Notes Board panel to the sidebar: pick a workspace and read its .agents/notes decision records through the original agent-notes-board UI — architecture baseline (in-degree pillars), evolution timeline, pitfalls, and decision list, plus the five-section detail drawer. The Host only supplies read-only note text."
+    "description": "Three things in one plugin: a Notes Board sidebar panel that renders each workspace's .agents/notes decision records (architecture baseline, evolution timeline, pitfalls, decision list, plus the five-section detail drawer); five native tools (note_search / note_read / note_write / note_verify / note_skip) with an end-of-turn hook that forces every turn touching code to either write a note or explicitly skip; and the bundled write-notes-like-deepseek skill, mounted for the agent."
   }
 }

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "笔记看板",
-    "description": "在左侧栏加一个「笔记看板」面板：切换工作区后，直接渲染该工作区 .agents/notes 的工程决策笔记——架构基线（引用入度承重墙）、演进时间线、避坑智库、决策清单四个板块，附带抽屉五节详情。界面即原版 agent-notes-board，数据改由宿主只读注入。"
+    "description": "一个插件三件事：左侧栏「笔记看板」面板渲染各工作区 .agents/notes 的工程决策笔记（架构基线、演进时间线、避坑智库、决策清单四板块 + 抽屉五节）；note_search / note_read / note_write / note_verify / note_skip 五个原生工具与 turn/end 钩子，保证改了代码的轮次结束时必须落一篇笔记或显式 skip；并把随包的 write-notes-like-deepseek 技能挂给 agent。"
   }
 }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "dsh-notes-board",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "type": "module",
-  "description": "笔记看板：把各个工作区 .agents/notes 的工程决策笔记渲染成 DeepSeek Harness 原生面板，四板块 + 抽屉五节，支持切换工作区。",
+  "description": "笔记看板：面板渲染各工作区 .agents/notes 的工程决策笔记（四板块 + 抽屉五节），同一插件还提供 note_search/note_read/note_write/note_verify/note_skip 五个原生工具、turn/end 钩子，以及随包的 write-notes-like-deepseek 技能。",
   "license": "MIT",
   "author": "scccy",
   "keywords": [
@@ -22,11 +22,12 @@
     "url": "https://github.com/scccy/dsh-notes-board/issues"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=22.18"
   },
   "exports": {
     ".": "./index.js",
     "./client": "./client.js",
+    "./core": "./src/core/notes.js",
     "./locale/*.json": "./locale/*.json",
     "./icon": "./icon.svg"
   },
@@ -43,6 +44,32 @@
     "LICENSE",
     "NOTICE.md"
   ],
+  "scripts": {
+    "build": "node scripts/build-client.mjs",
+    "test": "node scripts/test-board.mjs && node --import ./test/stubs/register.mjs test/dsh-plugin.mjs",
+    "test:board": "node scripts/test-board.mjs",
+    "test:hooks": "node --import ./test/stubs/register.mjs test/dsh-plugin.mjs"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-llm": "*",
+    "@deepseek-ai/dsh-skill-filesystem": "*",
+    "@deepseek-ai/dsh-tools": "*",
+    "@deepseek-ai/schemastery": "*"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-llm": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-skill-filesystem": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tools": {
+      "optional": true
+    },
+    "@deepseek-ai/schemastery": {
+      "optional": true
+    }
+  },
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
@@ -50,9 +77,5 @@
     "client": {
       "platform": "web"
     }
-  },
-  "scripts": {
-    "build": "node scripts/build-client.mjs",
-    "test": "node scripts/test-board.mjs"
   }
-}
+}

package/scripts/test-board.mjs

@@ -1,9 +1,23 @@
 import { readFileSync } from 'node:fs'
+import { createHash } from 'node:crypto'
 import vm from 'node:vm'
 
 import { dirname, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
-const SRC = resolve(dirname(fileURLToPath(import.meta.url)), '..', 'client.js')
+const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+const SRC = resolve(ROOT, 'client.js')
+
+// 合并后仓库里有两份同源看板模板：构建源 vendor/board.html，和技能资产副本
+// vendor/write-notes-like-deepseek/skills/write-notes-like-deepseek/assets/agent-notes-board.html
+// （后者被上游 test-skill-install.mjs 的存在性断言依赖）。它们必须逐字一致，
+// 否则上游更新只换了一份，面板和技能产物就悄悄分叉了。
+const BUILD_SOURCE = resolve(ROOT, 'vendor', 'board.html')
+const SKILL_ASSET = resolve(ROOT, 'vendor', 'write-notes-like-deepseek', 'skills', 'write-notes-like-deepseek', 'assets', 'agent-notes-board.html')
+const sha = (p) => createHash('sha256').update(readFileSync(p)).digest('hex')
+if (sha(BUILD_SOURCE) !== sha(SKILL_ASSET)) {
+  throw new Error(`vendor 里两份 agent-notes-board.html 不一致：${BUILD_SOURCE} vs ${SKILL_ASSET}`)
+}
+console.log('  ok   两份看板模板逐字一致（sha256 ' + sha(BUILD_SOURCE).slice(0, 12) + '…）')
 
 const cache = new Map()
 function makeEl(id) {