acmer-coach 1.0.0

package/dev/run-all.sh

@@ -0,0 +1,70 @@
+#!/usr/bin/env bash
+# 一条命令跑全套验收。
+#
+# 六套：
+#   verify / verify-shape   主验收（509 条断言 + 19 个工具的形状扫描）
+#   w1-check                解绑、夹具闸门、规则注入
+#   wiki-check              OI Wiki 检索
+#   setup-check             冷启动（离线）
+#   parity-check            和线上那份的保真度对比
+#
+# 主验收跑的是**已安装副本**（不是源码）—— 那才是运行时真正加载的东西。
+# 所以这里先搭一个隔离的"已安装"目录，不碰任何真实 profile。
+#
+# 跑法：bash dev/run-all.sh
+#   加 COACH_TEST_NET=1 连联网段一起跑
+set -uo pipefail
+cd "$(dirname "${BASH_SOURCE[0]}")/.." || exit 1
+SRC="$(pwd)"
+
+TMP="$(mktemp -d)"
+trap 'rm -rf "$TMP"' EXIT
+INST="$TMP/profiles/web/node_modules/acmer-coach"
+mkdir -p "$INST" "$TMP/knowledge"
+tar cf - --exclude=node_modules --exclude=dev --exclude=.git . | (cd "$INST" && tar xf -)
+
+# 隔离目录也得能解析依赖（yaml、@deepseek-ai/*）。
+# 真实安装时这两样由 pnpm 装好；这里用 junction 接到 dsh 自带的那份。
+# 用 node 建而不是 cmd：Windows 路径带空格，走 shell 的引号很容易被吃掉。
+APP_NM="${DSH_APP_NODE_MODULES:-C:/Aplication/dsh desktop/resources/app/node_modules}"
+if [ -d "$APP_NM" ]; then
+  node -e "
+    const fs=require('fs');
+    try { fs.symlinkSync(process.argv[1], process.argv[2], 'junction') } catch(e) { if(e.code!=='EEXIST') throw e }
+  " "$APP_NM" "$INST/node_modules" || echo "⚠ junction 建失败，主验收会缺依赖"
+fi
+
+RC=0
+run() {  # run <名字> <命令...>
+  local name="$1"; shift
+  printf '%-16s ' "$name"
+  if out=$("$@" 2>&1); then
+    echo "✓ $(echo "$out" | tail -1)"
+  else
+    echo "✗"
+    echo "$out" | tail -25 | sed 's/^/    /'
+    RC=1
+  fi
+}
+
+export DSH_HOME="$TMP"
+export COACH_VERIFY_PROFILE=web
+export COACH_DEFAULT_KNOWLEDGE="$TMP/knowledge"
+
+cd "$TMP/profiles/web/node_modules/acmer-coach"
+run "verify"        node verify.mjs
+run "verify-shape"  node verify-shape.mjs
+cd "$SRC"
+run "w1-check"      node dev/w1-check.mjs
+run "wiki-check"    node dev/wiki-check.mjs
+run "setup-check"   node dev/setup-check.mjs
+run "parity-check"  node dev/parity-check.mjs
+
+echo
+if [ "${COACH_TEST_NET:-0}" = "1" ]; then
+  echo "（联网段）"
+  COACH_TEST_NET=1 node dev/setup-check.mjs "${1:-tourist}" 2>&1 | tail -8 | sed 's/^/    /'
+fi
+
+[ $RC -eq 0 ] && echo "✓ 全套通过" || echo "✗ 有失败"
+exit $RC

package/dev/setup-check.mjs

@@ -0,0 +1,191 @@
+// W2 验收：冷启动（搭建 + 同步）。
+//
+// 分两段：
+//   · 离线段**每次都跑** —— status / init 的行为、幂等性、不覆盖已有文件
+//   · 联网段要显式开（COACH_TEST_NET=1）—— 真打 CF 公开接口，
+//     走完整条链：拉账号 → 拉提交 → 拉题库 → 算接触证据
+//
+// 跑法：node dev/setup-check.mjs            只用临时目录验离线
+//       COACH_TEST_NET=1 node dev/setup-check.mjs [handle]
+import { mkdtempSync, writeFileSync, existsSync, readFileSync, rmSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+
+let pass = 0, fail = 0
+const check = (name, ok, detail = '') => {
+  console.log(`${ok ? '  ✓' : '  ✗'} ${name}${detail ? `  — ${detail}` : ''}`)
+  ok ? pass++ : fail++
+}
+
+const home = mkdtempSync(join(tmpdir(), 'setup-'))
+process.env.COACH_DATA_DIR = join(home, 'knowledge')
+process.env.COACH_DB = join(home, 'data', 'training.db')
+
+const load = async (tag) => {
+  const mod = await import(`../index.js?setup=${tag}`)
+  const reg = []
+  mod.apply({ tools: { register: (t) => reg.push(t) }, inject: () => {}, on: () => {}, get: () => undefined })
+  return reg.find((t) => t.name === 'coach_setup')
+}
+const tool = await load('a')
+const call = (a) => tool.execute(a, undefined)
+
+console.log('── 1. 空环境体检：要如实说「缺」，不能假装没事 ──')
+{
+  const r = await call({ action: 'status' })
+  check('注册了 coach_setup', Boolean(tool))
+  check('ok=false（还没搭）', r.ok === false, `ok=${r.ok}`)
+  const st = Object.fromEntries(r.items.map((i) => [i.name, i.status]))
+  check('数据目录报「缺」', st['数据目录'] === '缺', st['数据目录'])
+  check('训练库报「缺」', st['训练库'] === '缺', st['训练库'])
+  check('给出了下一步', r.note.includes('init'), r.note.slice(0, 50))
+}
+
+console.log('\n── 2. init：建目录、铺地图、建库 ──')
+{
+  const r = await call({ action: 'init' })
+  check('ok', r.ok === true, r.note)
+  check('数据目录真的建了', existsSync(process.env.COACH_DATA_DIR))
+  check('地图铺过去了', existsSync(join(process.env.COACH_DATA_DIR, 'MAP.yaml')))
+  check('训练库真的建了', existsSync(process.env.COACH_DB))
+  check('**没把 LICENSE 当数据拷进去**',
+    !existsSync(join(process.env.COACH_DATA_DIR, 'LICENSE')))
+
+  const { DatabaseSync } = await import('node:sqlite')
+  const db = new DatabaseSync(process.env.COACH_DB, { readOnly: true })
+  const tables = db.prepare("SELECT name FROM sqlite_master WHERE type='table' ORDER BY name").all().map((r) => r.name)
+  for (const t of ['users', 'unified_submissions', 'unified_problems', 'rating_history', 'diff_rating_map']) {
+    check(`建了表 ${t}`, tables.includes(t))
+  }
+  check('难度映射灌进去了（13 行）',
+    db.prepare('SELECT COUNT(*) c FROM diff_rating_map').get().c === 13)
+  db.close()
+}
+
+console.log('\n── 3. init 幂等：不许覆盖用户已有的东西 ──')
+{
+  const prog = join(process.env.COACH_DATA_DIR, 'PROGRESS.yaml')
+  writeFileSync(prog, 'version: 1\ncursor: 我自己写的\n')
+  const mapBefore = readFileSync(join(process.env.COACH_DATA_DIR, 'MAP.yaml'), 'utf8')
+  await call({ action: 'init' })
+  check('用户的 PROGRESS.yaml 没被动', readFileSync(prog, 'utf8').includes('我自己写的'))
+  check('已有的 MAP.yaml 没被覆盖', readFileSync(join(process.env.COACH_DATA_DIR, 'MAP.yaml'), 'utf8') === mapBefore)
+}
+
+console.log('\n── 4. 体检：库空 / 有数据两种状态要分得开 ──')
+{
+  const r = await call({ action: 'status' })
+  check('地图那项是 ok', r.items.find((i) => i.name === '地图').status === 'ok')
+  check('训练库认得出来（空库）', r.items.find((i) => i.name === '训练库').detail.includes('0 条提交'),
+    r.items.find((i) => i.name === '训练库').detail)
+  check('提示下一步去 sync', r.note.includes('sync'), r.note.slice(0, 60))
+}
+
+console.log('\n── 5. sync 不给 handle → 要问，不要瞎猜一个 ──')
+{
+  const r = await call({ action: 'sync' })
+  check('ok=false', r.ok === false)
+  check('明确说「问他」', r.note.includes('handle'), r.note.slice(0, 60))
+}
+
+console.log('\n── 6. 题池随包发（没有它 coach_pool 挑不出「他没做过」的题）──')
+{
+  const { DatabaseSync } = await import('node:sqlite')
+  const db = new DatabaseSync(process.env.COACH_DB, { readOnly: true })
+  const lib = db.prepare('SELECT COUNT(*) c FROM unified_problems WHERE is_library=1').get().c
+  check('题库灌进去了', lib > 40000, `${lib} 道`)
+  const by = db.prepare(
+    "SELECT platform, COUNT(*) c FROM unified_problems WHERE is_library=1 GROUP BY platform").all()
+  for (const p of ['codeforces', 'luogu', 'nowcoder']) {
+    const n = by.find((r) => r.platform === p)?.c ?? 0
+    check(`  含 ${p}`, n > 5000, `${n} 道`)
+  }
+  check('题池带难度和标签（挑题要用）',
+    db.prepare("SELECT COUNT(*) c FROM unified_problems WHERE is_library=1 AND difficulty>0 AND tags!=''").get().c > 35000)
+  db.close()
+}
+
+console.log('\n── 7. 记录导入（洛谷/牛客走这条；CF 有公开接口不用）──')
+{
+  // 先拿 import 工具（setup 之外还要它）
+  const mod2 = await import('../index.js?imp=1')
+  const reg2 = []
+  mod2.apply({ tools: { register: (t) => reg2.push(t) }, inject: () => {}, on: () => {}, get: () => undefined })
+  const imp = reg2.find((t) => t.name === 'coach_import')
+  check('注册了 coach_import', Boolean(imp))
+  const ic = (a) => imp.execute(a, undefined)
+
+  // 洛谷：status 是数字码，只认 12 → AC，其余 → Other（细分码没映射，见 lib/setup.js）
+  const luogu = [
+    { platform: 'luogu', problem_id: 'P1001', verdict: '12', submitted_at: '2026-09-01T10:00:00+08:00' },
+    { platform: 'luogu', problem_id: 'P1001', verdict: '6', submitted_at: '2026-09-01T09:00:00+08:00' },
+    { platform: 'luogu', problem_id: 'P1002', verdict: '6', submitted_at: '2026-09-01T11:00:00+08:00' },
+  ]
+  const r1 = await ic({ records: luogu })
+  check('导入成功', r1.ok === true, r1.note || `${r1.inserted} 条`)
+  check('同一题多次提交 → 只留一条 AC（不是把提交数当题数）', r1.inserted === 2,
+    `inserted=${r1.inserted}（3 条输入：P1001 的 AC 覆盖了它的失败提交，P1002 只有失败）`)
+
+  const { DatabaseSync } = await import('node:sqlite')
+  const db = new DatabaseSync(process.env.COACH_DB, { readOnly: true })
+  const vs = db.prepare("SELECT problem_id, verdict FROM unified_submissions WHERE platform='luogu' ORDER BY problem_id").all()
+  check('洛谷 12 → AC', vs.some((r) => r.problem_id === 'P1001' && r.verdict === 'AC'),
+    JSON.stringify(vs))
+  check('非 12 → Other（细分码没映射，宁可少说不可猜）',
+    vs.every((r) => ['AC', 'Other'].includes(r.verdict)), vs.map((r) => r.verdict).join(','))
+  db.close()
+
+  // 牛客：NC 前缀要剥（插件里 normId 就是这么认的）
+  const r2 = await ic({ records: [{ platform: 'nowcoder', problem_id: 'NC204457', verdict: 'AC' }] })
+  check('牛客 NC 前缀被剥掉', r2.inserted === 1, `inserted=${r2.inserted}`)
+  const db2 = new DatabaseSync(process.env.COACH_DB, { readOnly: true })
+  check('存的是裸数字',
+    Boolean(db2.prepare("SELECT 1 FROM unified_submissions WHERE platform='nowcoder' AND problem_id='204457'").get()))
+  db2.close()
+
+  // 再导一次同一个文件：**不该把 AC 覆盖成失败**
+  const r3 = await ic({ records: [{ platform: 'luogu', problem_id: 'P1001', verdict: '6' }] })
+  const db3 = new DatabaseSync(process.env.COACH_DB, { readOnly: true })
+  check('已 AC 的题再导入失败记录 → 不覆盖',
+    Boolean(db3.prepare("SELECT 1 FROM unified_submissions WHERE platform='luogu' AND problem_id='P1001' AND verdict='AC'").get()),
+    `这次 inserted=${r3.inserted}`)
+  db3.close()
+
+  // 认不出的记录要计数，不是静默丢
+  const r4 = await ic({ records: [{ platform: 'atcoder', problem_id: 'abc300_f', verdict: 'AC' }] })
+  check('不认识的平台被跳过并计数', r4.skipped === 1, `skipped=${r4.skipped}`)
+
+  // 文件形式（扩展导出就是这个）
+  const f = join(home, 'records.jsonl')
+  writeFileSync(f, luogu.map((r) => JSON.stringify(r)).join('\n'))
+  const r5 = await ic({ path: f })
+  check('能吃 JSONL 文件', r5.ok === true, `inserted=${r5.inserted}`)
+  const r6 = await ic({ path: join(home, '不存在.json') })
+  check('文件不存在 → 如实报错', r6.ok === false && r6.note.includes('读不了'), r6.note.slice(0, 50))
+}
+
+if (process.env.COACH_TEST_NET === '1') {
+  const handle = process.argv[2] || 'tourist'
+  console.log(`\n── 6. 联网：真打 CF 接口拉「${handle}」 ──`)
+  const t0 = Date.now()
+  const r = await call({ action: 'sync', handle, problemset: false })
+  const secs = ((Date.now() - t0) / 1000).toFixed(1)
+  check('同步成功', r.ok === true, `${secs}s  ${r.note.slice(0, 80)}`)
+  if (r.ok) {
+    check('拿到了 rating', r.rating > 0, String(r.rating))
+    check('拿到了提交记录', r.submissions > 0, `${r.submissions} 条`)
+    check('拿到了接触证据', r.evidence.length > 0, `${r.evidence.length} 个标签`)
+    console.log('     证据前 5：', r.evidence.slice(0, 5)
+      .map((e) => `${e.tag}(AC ${e.ac})`).join('  '))
+    check('证据是**事实**不是结论（有 ac 和 tried 两个数）',
+      r.evidence.every((e) => typeof e.ac === 'number' && typeof e.tried === 'number'))
+  } else {
+    console.log('     ', r.note)
+  }
+} else {
+  console.log('\n（联网段跳过：设 COACH_TEST_NET=1 打开）')
+}
+
+rmSync(home, { recursive: true, force: true })
+console.log(`\n${fail === 0 ? '✓ 全绿' : '✗ 有失败'} — ${pass} 通过 / ${fail} 失败`)
+process.exit(fail === 0 ? 0 : 1)

package/dev/w1-check.mjs

@@ -0,0 +1,170 @@
+// W1 行为验收：四个硬编码常量解绑后，还认不认路。
+//
+// 为什么单独一个文件而不是塞进 verify.mjs：
+// verify.mjs 跑的是**已安装副本**（profiles/web/node_modules/acmer-coach），
+// 而这一关要在**开发目录**里验，且要反复换 COACH_DATA_DIR 重载模块
+// —— 两者用的解析根不同，混在一起每跑一次都得先装一遍。
+//
+// 跑法：node dev/w1-check.mjs
+import { mkdtempSync, writeFileSync, mkdirSync, rmSync, readFileSync } from 'node:fs'
+import { tmpdir, homedir } from 'node:os'
+import { join, basename } from 'node:path'
+
+const HERE = new URL('..', import.meta.url).pathname.replace(/^\//, '')
+let pass = 0, fail = 0
+const check = (name, ok, detail = '') => {
+  console.log(`${ok ? '  ✓' : '  ✗'} ${name}${detail ? `  — ${detail}` : ''}`)
+  ok ? pass++ : fail++
+}
+
+// ── 造一份最小数据目录 ────────────────────────────────────────────────
+function makeLedger() {
+  const dir = mkdtempSync(join(tmpdir(), 'w1-'))
+  writeFileSync(join(dir, 'MAP.yaml'), `meta:
+  version: 3
+  node_count: 2
+nodes:
+  - id: A
+    name: A
+    domain: 测试
+    depends: []
+    tier: normal
+  - id: B
+    name: B
+    domain: 测试
+    depends: [A]
+    tier: normal
+`)
+  writeFileSync(join(dir, 'DEPENDS.yaml'), `meta:
+  version: 1
+requires:
+  A: []
+  B: [A]
+`)
+  writeFileSync(join(dir, 'skilltree.html'), '<html><body>stub</body></html>')
+  return dir
+}
+
+const mockCtx = (registered, sections = []) => ({
+  tools: { register: (t) => registered.push(t) },
+  inject: () => {},
+  on: () => {},
+  // systemPrompt 服务：插件通过它把教练规则注进 system prompt
+  get: (name) => (name === 'systemPrompt'
+    ? { section: (s) => sections.push(s) }
+    : undefined),
+})
+
+/** 用指定的 env 重新加载一份模块实例（ESM 按 URL 缓存，靠 query 破缓存）。 */
+async function loadWith(env, tag) {
+  const saved = {}
+  for (const [k, v] of Object.entries(env)) {
+    saved[k] = process.env[k]
+    if (v === undefined) delete process.env[k]
+    else process.env[k] = v
+  }
+  const mod = await import(`../index.js?w1=${tag}`)
+  for (const [k, v] of Object.entries(saved)) {
+    if (v === undefined) delete process.env[k]
+    else process.env[k] = v
+  }
+  const registered = [], sections = []
+  mod.apply(mockCtx(registered, sections))
+  return { mod, byName: new Map(registered.map((t) => [t.name, t])), sections }
+}
+
+// ══════════════════════════════════════════════════════════════════
+console.log('── 1. 默认路径从家目录派生（不再写死） ──')
+{
+  const { byName } = await loadWith({ COACH_DATA_DIR: undefined, COACH_TRAINER: undefined }, 'default')
+  const ping = byName.get('coach_ping')
+  check('coach_ping 注册了', Boolean(ping))
+  const v = await ping.execute({}, undefined)
+  // 默认目录 = ~/.dsh/knowledge。本机能跑说明家目录派生没问题。
+  check('默认数据目录可达（~/.dsh/knowledge）', typeof v?.dataDir === 'string' && v.dataDir.includes('.dsh'),
+    `dataDir=${v?.dataDir}`)
+  // 断言的是**推导逻辑**，不是"不含某几个字面量" ——
+  // 后者会把名字写进测试文件本身，等于把要清的东西留在了仓库里。
+  const want = join(homedir(), '.dsh', 'knowledge')
+  check('默认路径 = 家目录派生（不是写死的）',
+    String(v?.dataDir).replace(/\\/g, '/') === want.replace(/\\/g, '/'), `dataDir=${v?.dataDir}`)
+}
+
+console.log('── 2. COACH_DATA_DIR 覆盖生效 ──')
+const ledger = makeLedger()
+{
+  const { byName } = await loadWith({ COACH_DATA_DIR: ledger, COACH_TRAINER: undefined }, 'tmp')
+  const v = await byName.get('coach_ping').execute({}, undefined)
+  check('指向了临时目录', String(v?.dataDir).replace(/\\/g, '/') === ledger.replace(/\\/g, '/'),
+    `dataDir=${v?.dataDir}`)
+  check('三个数据文件都探到', v?.ok === true, v?.files?.filter((f) => f.status !== 'ok').map((f) => f.file).join(','))
+  check('探针仍是 3 个', v?.files?.length === 3)
+}
+
+console.log('── 3. 夹具闸门：没有显式临时目录 → 拦住 ──')
+{
+  const { mod } = await loadWith({ COACH_DATA_DIR: undefined }, 'gate-off')
+  let err = null
+  try {
+    await mod.schedApi.planDay('2026-01-01', [{ from: '09:00', kind: 'review', node: 'A' }])
+  } catch (e) { err = e }
+  check('抛错', err instanceof Error, err?.message?.slice(0, 60))
+  check('理由含「夹具」', Boolean(err?.message?.includes('夹具')))
+  check('理由含「真账本」', Boolean(err?.message?.includes('真账本')))
+  check('理由点明怎么绕过（COACH_DATA_DIR）', Boolean(err?.message?.includes('COACH_DATA_DIR')))
+}
+
+console.log('── 4. 夹具闸门：显式指定了 → 放行 ──')
+{
+  const { mod } = await loadWith({ COACH_DATA_DIR: ledger }, 'gate-on')
+  let err = null
+  try {
+    await mod.schedApi.planDay('2026-01-01', [{ from: '09:00', kind: 'review', node: 'A' }])
+  } catch (e) { err = e }
+  check('闸门不再拦（其它错可以）', !err?.message?.includes('夹具写接口'), err?.message?.slice(0, 80) ?? '(无错)')
+}
+
+console.log('── 5. TRAINER 不再写死：没给 handle 就不该出现人名 ──')
+{
+  const { byName } = await loadWith({ COACH_DATA_DIR: ledger, COACH_TRAINER: undefined }, 'trainer')
+  // coach_next 会读地图；DB 打不开时的报错文案里不该出现硬编码 handle
+  // 看**源码形状**而不是返回值：没给 COACH_TRAINER 时 TRAINER 必须退成 null，
+  // 后续由 trainerId() 取库里第一条用户。写死一个 handle 就会在这里露馅。
+  const src = readFileSync(new URL('../index.js', import.meta.url), 'utf8')
+  check('TRAINER 没有写死的默认值',
+    /const TRAINER = process\.env\.COACH_TRAINER \|\| null/.test(src))
+  check('trainerId 有"取第一条用户"的兜底',
+    /SELECT id FROM users ORDER BY id LIMIT 1/.test(src))
+}
+
+rmSync(ledger, { recursive: true, force: true })
+
+console.log('── 6. 规则进 system prompt（不是消息流）──')
+{
+  const { sections } = await loadWith({ COACH_DATA_DIR: undefined }, 'rules')
+  const s = sections.find((x) => x.name === 'coach:rules')
+  check('注册了 coach:rules 段', Boolean(s))
+  check('order 是有限的数', Number.isFinite(s?.order), String(s?.order))
+  check('排在人设之后、通用策略之前（0 < order < 500）',
+    s?.order > 0 && s?.order < 500, String(s?.order))
+  check('规则正文非空且含九条硬规则', (s?.text?.length ?? 0) > 2000 && s.text.includes('coach_next'),
+    `${s?.text?.length ?? 0} 字符`)
+  // 同样断言**结构性性质**：规则里不该出现绝对路径，也不该出现本机用户名
+  // （用户名从 homedir() 现取 —— 源码里不写任何一个具体的名字）。
+  const uname = basename(homedir())
+  check('规则里没有绝对路径', !/[A-Za-z]:\\|\/Users\/|\/home\//.test(s?.text ?? ''))
+  check('规则里没有本机用户名', !(s?.text ?? '').includes(uname))
+}
+{
+  // 没有 systemPrompt 服务时要能静默跳过，别把插件加载拦死（headless）
+  const registered = []
+  const mod2 = await import('../index.js?w1=nosp')
+  let threw = null
+  try { mod2.apply({ tools: { register: (t) => registered.push(t) }, inject: () => {}, on: () => {} , get: () => undefined }) }
+  catch (e) { threw = e }
+  check('没有 systemPrompt 服务 → 不抛，工具照常注册', !threw && registered.length > 0,
+    threw ? threw.message : `${registered.length} 个工具`)
+}
+
+console.log(`\n${fail === 0 ? '✓ 全绿' : '✗ 有失败'} — ${pass} 通过 / ${fail} 失败`)
+process.exit(fail === 0 ? 0 : 1)

package/dev/wiki-check.mjs

@@ -0,0 +1,100 @@
+// W5 验收：OI Wiki 本地检索。
+//
+// 用**教练真实会发的查询**验，不是编几个能过的：
+//   · 节点名（地图上的）        → 应该走精确表，第一条就得对
+//   · 分类节点（网络流这种）    → 应该落到子树里的页面
+//   · 自由文本 / 口语化提问     → 应该靠正文匹配兜住
+//   · 压根不存在的              → 应该**如实说找不到**，不是硬凑一个
+//
+// 跑法：node dev/wiki-check.mjs
+import { mkdtempSync, writeFileSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+
+let pass = 0, fail = 0
+const check = (name, ok, detail = '') => {
+  console.log(`${ok ? '  ✓' : '  ✗'} ${name}${detail ? `  — ${detail}` : ''}`)
+  ok ? pass++ : fail++
+}
+
+// 这个工具不碰数据目录，但插件加载时要有个能读的地图（其它工具用）
+const tmp = mkdtempSync(join(tmpdir(), 'wiki-'))
+writeFileSync(join(tmp, 'MAP.yaml'), 'meta: {version: 3}\nnodes:\n  - id: A\n    name: A\n    domain: 测试\n    depends: []\n    tier: normal\n')
+writeFileSync(join(tmp, 'DEPENDS.yaml'), 'meta: {version: 1}\nrequires:\n  A: []\n')
+writeFileSync(join(tmp, 'skilltree.html'), '<html></html>')
+process.env.COACH_DATA_DIR = tmp
+
+const mod = await import('../index.js?wiki=1')
+const registered = []
+mod.apply({ tools: { register: (t) => registered.push(t) }, inject: () => {}, on: () => {} })
+const wiki = registered.find((t) => t.name === 'coach_wiki')
+check('注册了 coach_wiki', Boolean(wiki))
+
+const call = (a) => wiki.execute(a, undefined)
+
+// ── 1. 节点精确表 ─────────────────────────────────────────────────
+console.log('\n── 1. 节点 → 页面（精确表）──')
+for (const [node, want] of [
+  ['线段树', 'ds/seg.md'],
+  ['区间 DP', 'dp/interval.md'],
+  ['插头 DP', 'dp/plug.md'],
+  ['复杂度', 'basic/complexity.md'],
+]) {
+  const r = await call({ action: 'node', node })
+  const top = r.pages[0]?.src
+  check(`${node} → ${want}`, top === want, top ?? r.note)
+}
+
+console.log('\n── 2. 分类节点（自己没有页面，落在子树里）──')
+{
+  const r = await call({ action: 'node', node: '网络流' })
+  const srcs = r.pages.map((p) => p.src)
+  check('网络流 命中多个页面', srcs.length >= 3, `${srcs.length} 个`)
+  check('含最大流', srcs.some((s) => s.includes('max-flow')), srcs.slice(0, 3).join(' '))
+}
+{
+  const r = await call({ action: 'node', node: '莫队算法' })
+  check('莫队算法 落在子树页面（第四层也能收到）',
+    r.pages.some((p) => p.src.includes('mo-algo')), r.pages[0]?.src ?? r.note)
+}
+
+console.log('\n── 3. 自由文本 / 口语化 ──')
+for (const [q, wantSub] of [
+  ['Dijkstra', 'graph/'],
+  ['四边形不等式', 'dp/'],
+  ['字符串', 'string/'],
+]) {
+  const r = await call({ action: 'search', query: q, topK: 5 })
+  const ok = r.pages.some((p) => p.src.includes(wantSub))
+  check(`搜「${q}」命中 ${wantSub}`, ok, r.pages.map((p) => p.src).slice(0, 3).join(' ') || r.note)
+}
+
+console.log('\n── 4. 读整页 ──')
+{
+  const r = await call({ action: 'page', src: 'ds/seg.md' })
+  check('读到 ds/seg.md', r.ok && r.text.length > 500, `${r.text.length} 字符`)
+  check('正文是中文', /[一-龥]/.test(r.text))
+  const bad = await call({ action: 'page', src: '不存在/的页面.md' })
+  check('不存在的路径 → 如实报错，不是空字符串', !bad.ok && bad.note.length > 0, bad.note)
+}
+
+console.log('\n── 5. 查不到时必须说实话（不许硬凑）──')
+{
+  const r = await call({ action: 'search', query: 'zzz不存在的知识点qqq', topK: 5 })
+  check('无关查询 → 0 结果', r.pages.length === 0, `${r.pages.length} 个`)
+  check('并且给出「照实说」的提示', r.note.includes('不确定'), r.note)
+}
+
+console.log('\n── 6. 输出形状合规（dsh 严格校验）──')
+{
+  const r = await call({ action: 'search', query: '线段树', topK: 3 })
+  const shape = ['ok', 'note', 'pages', 'text', 'truncated', 'available']
+  check('顶层键齐全', shape.every((k) => k in r), Object.keys(r).join(','))
+  check('pages 每项四字段', r.pages.every((p) =>
+    typeof p.src === 'string' && typeof p.title === 'string' &&
+    typeof p.via === 'string' && typeof p.excerpt === 'string'))
+  check('render 不抛', Array.isArray(wiki.output.render({}, r)))
+}
+
+console.log(`\n${fail === 0 ? '✓ 全绿' : '✗ 有失败'} — ${pass} 通过 / ${fail} 失败`)
+process.exit(fail === 0 ? 0 : 1)