acmer-coach 2.0.0 → 2.2.0

package/README.md

@@ -20,7 +20,7 @@
 
 ## 它到底做了什么
 
-26 个工具，三条轴：知识图、比赛能力、训练证据。
+29 个工具，三条轴：知识图、比赛能力、训练证据。
 
 | 轴 | 含义 |
 |---|---|
@@ -75,7 +75,7 @@ VP 记录格式是 JSON 数组，每场至少包含 `eventId`、`contest`、`dat
 ### 长期学习路线
 
 `coach_curriculum assess` 从已有检测、代码判因、做题记录和日程实际完成中列出
-可引用的证据；不会把 rating、学习状态或取消的卷子当成短板。每条记录带内容引用
+可引用的证据；VP 题目与复盘里的 `competencies` 也会生成稳定证据 id，不会把 rating、学习状态或取消的卷子当成短板。每条记录带内容引用
 `id` 和事件身份 `eventId`。训练阶段的每个节点必须有真实记录：`finding=gap`
 引用失败/超时/依赖提示等短板，`finding=extension` 引用已独立做出或过卷的能力起点。
 
@@ -86,8 +86,7 @@ VP 记录格式是 JSON 数组，每场至少包含 `eventId`、`contest`、`dat
 learned/verified 记录，或路线中在此前安排的必验训练，不能从游标位置推定已经学会。
 
 `CURRICULUM.yaml` 保存路线与修订历史：`read` 查看，`create` 建立，`revise` 调整，
-`advance` 推进。进入阶段时保存证据事件快照；诊断阶段每个节点需有新的真实观察，
-训练阶段所有节点必须 verified，且各有新的独立做出或过卷记录。改旧备注、成绩或
+`advance` 推进。阶段可以只绑定比赛能力（读题、决策、团队沟通），这类阶段用 VP/复盘证据验收，不必伪装成地图节点。进入阶段时保存证据事件快照；诊断阶段每个节点需有新的真实观察，训练阶段所有节点必须 verified，能力目标必须有阶段后的新 baseline 证据。改旧备注、成绩或
 把同次做题从课表迁入进度，不算新训练。当前诊断也不能通过改种类或删节点逃过验收。
 写操作带 `expectedRevision` 和理由，避免旧上下文覆盖新计划。
 路线按剩余 `estimatedHours`、每周预算和目标日期提示容量不足或估算缺失；这只是
@@ -101,7 +100,17 @@ learned/verified 记录，或路线中在此前安排的必验训练，不能从
 `coach_plan` 继续管理近期时间块。旧 v1 路线可读，会标记 `needsReview`；需明确
 修订当前及后续阶段后迁移 v2，插件不会自动重写。优先级与教学方案仍由模型判断，
 程序现在会要求目标和 VP 证据先进入策略层；能力卡片仍由仓库维护，未知卡片不会自动臆造。
-这版仍不包含后台定时同步和自动读取第三方 VP 网站，导出后用 `coach_vp_import` 导入。
+现在可以直接连接 VP：`coach_vp_connect start` 打开授权页，登录并允许只读访问后，
+把一次性 code 交给 `coach_vp_connect finish`。然后用 `coach_vp_sync` 增量同步比赛、
+提交、事件和个人历史；同步会自动生成带账号前缀的 VP 训练证据，仍由复盘和检测决定
+能力结论。`coach_vp_replay` 读取指定比赛的细粒度回放，`VP 回放`按钮会打开可视化页面，
+把 AC、WA/TLE/RE 和比赛分钟画在同一条时间轴上。
+
+每个 VP 账号都放在 `~/.dsh/knowledge/vp-accounts/<user_id>/`，token 单独保存，
+同步游标、原始安全投影和回放缓存都按账号分开。切换账号会切换教练工作区；服务端
+返回的账号 id 与当前账号不一致时，客户端拒绝写入。同步和回放都不返回提交代码或 judge 输出。
+`disconnect` 只删除本地 token，保留缓存，方便重新连接同一个账号。
+
 详见 [长期课程机制](docs/长期课程机制.md)。
 
 **「学过」和「已验证」是两级，绝不合并。** 自评 ≠ 掌握 ——

package/assets/knowledge/vp.html

@@ -0,0 +1,47 @@
+<!doctype html>
+<html lang="zh-CN">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width,initial-scale=1">
+  <title>VP 回放 · 小鲸教练</title>
+  <style>
+    :root { color-scheme: dark; --bg:#0d1117; --panel:#161b22; --line:#30363d; --text:#e6edf3; --muted:#8b949e; --blue:#58a6ff; --green:#3fb950; --red:#f85149; --yellow:#d29922; }
+    * { box-sizing:border-box } body { margin:0; padding:24px; color:var(--text); background:radial-gradient(circle at 85% 0,#1b3150 0,#0d1117 45%); font:14px/1.55 system-ui,-apple-system,"Segoe UI",sans-serif; }
+    .wrap { max-width:1180px; margin:auto } h1 { margin:0 0 4px; font-size:25px } h2 { font-size:16px; margin:0 0 12px } .muted { color:var(--muted) }
+    .grid { display:grid; grid-template-columns:320px 1fr; gap:16px; margin-top:18px } .card { background:color-mix(in srgb,var(--panel) 92%,transparent); border:1px solid var(--line); border-radius:12px; padding:16px; box-shadow:0 10px 35px #0003; }
+    button,input { border:1px solid var(--line); border-radius:7px; padding:8px 10px; color:var(--text); background:#21262d; font:inherit } button { cursor:pointer; background:#1f6feb; border-color:#388bfd } button.secondary { background:#21262d } button:hover { filter:brightness(1.15) } input { width:100%; margin:5px 0 9px; background:#0d1117 }
+    .row { display:flex; gap:8px; align-items:center; flex-wrap:wrap } .row button { flex:1 } .status { padding:10px 12px; border-radius:8px; background:#0d1117; margin:10px 0 14px; color:var(--muted) } .status.ok { color:#aff5b4; border:1px solid #238636 }
+    .stats { display:grid; grid-template-columns:repeat(3,1fr); gap:8px; margin:12px 0 } .stat { padding:10px; border:1px solid var(--line); border-radius:8px; background:#0d1117 } .stat b { display:block; font-size:20px; color:var(--blue) }
+    #timeline { width:100%; min-height:220px; overflow:auto; border:1px solid var(--line); border-radius:8px; background:#0d1117; padding:12px } svg { width:100%; min-width:620px; height:190px } .legend { display:flex; gap:12px; color:var(--muted); font-size:12px; margin-top:6px } .dot { display:inline-block; width:9px; height:9px; border-radius:50%; margin-right:4px }
+    .problem { display:flex; justify-content:space-between; padding:8px 0; border-bottom:1px solid #21262d } .pill { border-radius:999px; padding:2px 8px; font-size:12px; background:#30363d } .pill.AC { color:#aff5b4; background:#173b25 } .pill.WA,.pill.TLE,.pill.RE { color:#ffb4ab; background:#4b1d20 }
+    #message { min-height:24px; margin-top:12px; color:var(--muted) } a { color:var(--blue) }
+    @media (max-width:760px) { body{padding:14px} .grid{grid-template-columns:1fr} }
+  </style>
+</head>
+<body><main class="wrap">
+  <h1>VP 回放</h1><div class="muted">账号数据按 VP user id 隔离；这里的时间轴是比赛墙上秒数。</div>
+  <div class="grid">
+    <section class="card"><h2>连接 VP</h2><div id="account" class="status">正在读取连接状态…</div>
+      <button id="start">打开 VP 登录授权</button>
+      <label class="muted">授权页显示的 code</label><input id="code" autocomplete="off" placeholder="粘贴一次性 code">
+      <button id="finish" class="secondary">完成连接</button><div class="row" style="margin-top:8px"><button id="sync" class="secondary">立即同步</button><button id="disconnect" class="secondary">断开账号</button></div>
+      <div id="authLink" class="muted"></div><div id="message"></div>
+    </section>
+    <section class="card"><h2>比赛回放</h2><div class="row"><input id="contest" type="number" min="1" placeholder="Contest ID"><button id="load">加载回放</button></div>
+      <div id="summary" class="muted" style="margin:12px 0">先连接 VP，再输入 Contest ID。</div><div id="timeline"></div><div id="problems"></div>
+    </section>
+  </div>
+</main>
+<script>
+const $ = (id) => document.getElementById(id)
+const say = (text, bad=false) => { $('message').textContent = text; $('message').style.color = bad ? '#f85149' : '' }
+async function api(path, options) { const r=await fetch(path, {headers:{'content-type':'application/json'}, ...options}); const d=await r.json(); if(!r.ok||d.ok===false) throw new Error(d.reject||`HTTP ${r.status}`); return d }
+async function status(){ try { const d=await api('./api/vp/status'); const a=d.account; $('account').textContent=d.connected?`${a.display_name||a.handle} · ${a.handle} · 账号 ${a.id}`:'未连接 VP'; $('account').className='status'+(d.connected?' ok':''); } catch(e){say(e.message,true)} }
+$('start').onclick=async()=>{try{const d=await api('./api/vp/connect',{method:'POST',body:JSON.stringify({op:'start'})}); $('authLink').innerHTML=`<a href="${d.authorizeUrl}" target="_blank" rel="noreferrer">打开授权页</a>（登录并允许读取）`; say('授权页已打开，完成后把 code 粘贴到上面。'); window.open(d.authorizeUrl,'_blank','noopener');}catch(e){say(e.message,true)}}
+$('finish').onclick=async()=>{try{await api('./api/vp/connect',{method:'POST',body:JSON.stringify({op:'finish',code:$('code').value})}); say('连接成功，工作区已切换。'); await status()}catch(e){say(e.message,true)}}
+$('sync').onclick=async()=>{try{const d=await api('./api/vp/connect',{method:'POST',body:JSON.stringify({op:'sync'})}); say(`同步完成：${d.submissions?.length||0} 条提交。`); await status()}catch(e){say(e.message,true)}}
+$('disconnect').onclick=async()=>{try{await api('./api/vp/connect',{method:'POST',body:JSON.stringify({op:'disconnect'})}); say('已断开，缓存保留。'); await status()}catch(e){say(e.message,true)}}
+$('load').onclick=async()=>{try{const d=await api(`./api/vp/replay?contestId=${encodeURIComponent($('contest').value)}`); render(d); say('回放加载完成。')}catch(e){say(e.message,true)}}
+function render(d){ const v=d.visualization||{}, ev=v.team_events||[], duration=Math.max(60,v.duration_seconds||1), w=900, pad=42; $('summary').innerHTML=`<b>${d.contest?.title||'Contest '+d.contest?.id}</b><div class="stats"><div class="stat"><b>${d.result?.own?.solved??d.result?.solved??0}</b> solved</div><div class="stat"><b>${ev.length}</b> team events</div><div class="stat"><b>${v.official_run_count||0}</b> official runs</div></div>`; let ticks=Array.from({length:6},(_,i)=>{const x=pad+(w-pad*2)*i/5;return `<line x1="${x}" y1="28" x2="${x}" y2="160" stroke="#21262d"/><text x="${x}" y="178" fill="#8b949e" text-anchor="middle">${Math.round(duration*i/5/60)}m</text>`}).join(''); let marks=ev.map(e=>{const x=pad+(w-pad*2)*Math.min(1,Math.max(0,(e.second||0)/duration));const good=String(e.verdict||'').toUpperCase()==='AC';const color=good?'#3fb950':'#f85149';return `<circle cx="${x}" cy="${good?70:112}" r="7" fill="${color}"/><title>${e.problem||''} · ${e.verdict||''} · ${Math.round((e.second||0)/60)}m</title>`}).join(''); $('timeline').innerHTML=`<svg viewBox="0 0 ${w} 190" role="img" aria-label="比赛提交时间轴"><text x="8" y="74" fill="#8b949e">AC</text><text x="8" y="116" fill="#8b949e">非 AC</text>${ticks}<line x1="${pad}" y1="70" x2="${w-pad}" y2="70" stroke="#3fb950"/><line x1="${pad}" y1="112" x2="${w-pad}" y2="112" stroke="#f85149"/>${marks}</svg><div class="legend"><span><i class="dot" style="background:#3fb950"></i>AC</span><span><i class="dot" style="background:#f85149"></i>WA/TLE/RE</span><span>横轴为比赛分钟</span></div>`; $('problems').innerHTML=(d.problems||[]).map(p=>`<div class="problem"><span>${p.label||p.id} ${p.title||''}</span><span class="pill">${p.id}</span></div>`).join('') }
+status()
+</script></body></html>

package/assets/rules/coach-rules.md

@@ -30,7 +30,7 @@
   必须填写 `basis`、`goalContribution`、`priorityReason`、`estimatedHours`、
   `evidenceRefs`、`finding`、`kind`、`uncertainty`、`diagnosticMethod`。
   说清观察到了什么、它怎样服务目标、为何排在这里、预计投入多少，不套统一算法清单。
-* `kind=training` 的每个节点都要对应真实证据：补短板用 `finding=gap`，引用 gap；
+* `kind=training` 的每个节点都要对应真实证据：补短板用 `finding=gap`，引用 gap；读题、决策、团队沟通这类没有单一地图节点的阶段改用 `competencies`，引用 VP/复盘产生的能力证据；
   在已证实能力上进阶用 `finding=extension`，引用 baseline。记录指向什么由你解读，
   但**不能写一段理由替代不存在的记录**，也不能把别的节点的失败贴来凑依据。
 * 缺依据先安排 `kind=diagnostic/finding=unknown`，写尚待确认的问题和具体取证方法。

package/dev/curriculum-check.mjs

@@ -336,6 +336,26 @@ test('broken course is surfaced and never treated as an empty plan', () => {
   assert.equal(readFileSync(f.store.path, 'utf8'), 'revision: broken\n')
 })
 
+test('competency-only phases can use fresh VP evidence as their exit gate', () => {
+  const f = fixture()
+  const evidence = [{ id: 'vp:old:contest-reading', eventId: 'old', source: 'vp', node: '', competency: 'contest-reading', date: '2026-10-08', signal: 'gap', summary: 'VP 读题漏读', fingerprint: 'vp:old:contest-reading' }]
+  f.options.loadStrategyEvidence = () => evidence
+  const store = createCurriculumStore(f.options)
+  const phase = {
+    id: 'reading', title: '比赛读题与筛选', outcome: '在前30分钟完成扫描并记录取舍', competencies: ['contest-reading'], nodes: [],
+    exitCriteria: '两场新 VP 都有扫描顺序、取舍理由和漏读检查', requiredVerified: [], kind: 'training', finding: 'gap',
+    basis: 'VP 已记录读题缺口，需要在真实比赛节奏中修复', goalContribution: '提高区域赛前半小时的可做题识别和取舍质量',
+    priorityReason: '它直接决定队伍是否把时间用在能拿分的题上', estimatedHours: 6, uncertainty: '', diagnosticMethod: '',
+    evidenceRefs: ['vp:old:contest-reading'],
+  }
+  assert.equal(store.execute({ action: 'create', expectedRevision: 0, goal: '区域赛稳定表现', baseline: '已有一场 VP 的读题缺口记录', weeklyHours: 30, phases: [phase], reason: '根据 VP 的读题记录建立能力课程' }).ok, true)
+  assert.deepEqual(store.snapshot().phaseCompetencies, ['contest-reading'])
+  assert.deepEqual(store.snapshot().missingFreshEvidence, ['contest-reading'])
+  evidence.push({ id: 'vp:new:contest-reading', eventId: 'new', source: 'vp', node: '', competency: 'contest-reading', date: '2026-10-09', signal: 'baseline', summary: '新 VP 读题记录', fingerprint: 'vp:new:contest-reading' })
+  assert.deepEqual(store.snapshot().missingFreshEvidence, [])
+  assert.equal(store.execute({ action: 'advance', expectedRevision: 1, reason: '新 VP 已记录扫描顺序和取舍理由，满足本阶段能力验收' }).status, 'complete')
+})
+
 test('course tool output matches its declared schema on success, rejection and absence', () => {
   const f = fixture(); const tool = curriculumTool(f.store)
   for (const result of [f.store.execute({ action: 'read' }), f.create(), f.store.execute({ action: 'advance', expectedRevision: 1, reason: '检查未验收阶段是否能够被强行推进' })]) validateShape(tool.output.schema, result)

package/dev/strategy-check.mjs

@@ -1,11 +1,12 @@
 import test from 'node:test'
 import assert from 'node:assert/strict'
-import { mkdtempSync, rmSync, existsSync } from 'node:fs'
+import { mkdtempSync, rmSync, existsSync, writeFileSync } from 'node:fs'
 import { join } from 'node:path'
+import { tmpdir } from 'node:os'
 import { createStrategyStore } from '../lib/strategy.js'
 
 function fixture() {
-  const dir = mkdtempSync(join(process.cwd(), '.strategy-test-'))
+  const dir = mkdtempSync(join(tmpdir(), 'acmer-coach-strategy-'))
   const store = createStrategyStore({
     dataDir: dir,
     competenciesPath: join(process.cwd(), 'assets', 'knowledge', 'COMPETENCIES.yaml'),
@@ -73,3 +74,85 @@ test('first-use focus has a complete refusal shape and targets reject unknown ca
     assert.equal(rejected.ok, false)
   } finally { rmSync(dir, { recursive: true, force: true }) }
 })
+
+test('target route rejects an unrelated progress node but allows a course-bound route', () => {
+  const { dir, store } = fixture()
+  try {
+    store.target('set', {
+      expectedRevision: 0, contest: '西安区域赛', date: '2026-10-18', result: '区域赛金牌',
+      weeklyHours: 35, priorities: [{ id: 'dp-modeling', weight: 100 }],
+    })
+    const unrelated = store.route('树状数组', { purpose: 'progress', courseBound: false })
+    assert.equal(unrelated.ok, false)
+    assert.match(unrelated.reject, /dp-modeling|当前重点/)
+    const courseBound = store.route('树状数组', { purpose: 'progress', courseBound: true })
+    assert.equal(courseBound.ok, true)
+    assert.equal(courseBound.courseBound, true)
+  } finally { rmSync(dir, { recursive: true, force: true }) }
+})
+
+test('VP problem competencies count as evidence before a postmortem exists', () => {
+  const { dir, store } = fixture()
+  try {
+    store.target('set', {
+      expectedRevision: 0, contest: '西安区域赛', date: '2026-10-18', result: '区域赛金牌',
+      weeklyHours: 35, priorities: [
+        { id: 'dp-modeling', weight: 80 },
+        { id: 'contest-reading', weight: 70 },
+      ],
+    })
+    store.vpImport([{ eventId: 'vp-2', contest: '训练 VP', date: '2026-10-10', durationMinutes: 300,
+      problems: [{ problemId: 'B', status: 'WA', competencies: ['dp-modeling'] }] }])
+    const focus = store.focus()
+    assert.equal(focus.focus[0].id, 'dp-modeling')
+    assert.equal(focus.focus[0].evidenceCount, 1)
+  } finally { rmSync(dir, { recursive: true, force: true }) }
+})
+
+test('strategy exposes stable competency evidence for curriculum gates', () => {
+  const { dir, store } = fixture()
+  try {
+    store.vpImport([{ eventId: 'vp-evidence', contest: '训练 VP', date: '2026-10-10', durationMinutes: 300,
+      problems: [{ problemId: 'C', status: 'WA', competencies: ['contest-decision'] }] }])
+    const result = store.evidence()
+    assert.equal(result.ok, true)
+    assert.equal(result.evidence[0].id, 'vp:vp-evidence:C:contest-decision')
+    assert.equal(result.evidence[0].signal, 'gap')
+    assert.equal(result.evidence[0].competency, 'contest-decision')
+  } finally { rmSync(dir, { recursive: true, force: true }) }
+})
+
+test('invalid VP input is rejected without bumping revision', () => {
+  const { dir, store } = fixture()
+  try {
+    const result = store.vpImport([{ eventId: '', contest: '坏记录', date: '2026-10-10', problems: [] }])
+    assert.equal(result.ok, false)
+    assert.equal(result.revision, 0)
+    assert.equal(result.imported, 0)
+    assert.equal(result.invalid.length, 1)
+    assert.equal(existsSync(join(dir, 'VP_EVENTS.yaml')), false)
+  } finally { rmSync(dir, { recursive: true, force: true }) }
+})
+
+test('invalid target priorities are rejected instead of silently dropped', () => {
+  const { dir, store } = fixture()
+  try {
+    const result = store.target('set', {
+      expectedRevision: 0, contest: '西安区域赛', date: '2026-10-18', result: '区域赛金牌',
+      weeklyHours: 35, priorities: [{ id: 'dp-modeling', weight: 'bad' }],
+    })
+    assert.equal(result.ok, false)
+    assert.match(result.reject, /priorit|weight|能力/)
+    assert.equal(result.revision, 0)
+  } finally { rmSync(dir, { recursive: true, force: true }) }
+})
+
+test('corrupt stored strategy data returns a structured refusal', () => {
+  const { dir, store } = fixture()
+  try {
+    writeFileSync(join(dir, 'TARGET.yaml'), 'version: 1\nrevision: 4\npriorities: bad\n', 'utf8')
+    const result = store.target('read')
+    assert.equal(result.ok, false)
+    assert.match(result.reject, /TARGET.yaml/)
+  } finally { rmSync(dir, { recursive: true, force: true }) }
+})

package/dev/vp-client-check.mjs

@@ -0,0 +1,46 @@
+import assert from 'node:assert/strict'
+import { mkdtempSync, readFileSync, rmSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+import { createVpClient } from '../lib/vp-client.js'
+
+const root = mkdtempSync(join(tmpdir(), 'acmer-coach-vp-'))
+let account = { id: 1, handle: 'A', display_name: 'Coach A' }
+let mismatch = false
+const fetchImpl = async (url, options = {}) => {
+  const path = new URL(url).pathname
+  const body = options.body ? JSON.parse(options.body) : {}
+  if (path.endsWith('/api/coach/auth/start')) return json({ request_id: 'r1', authorize_url: 'https://vp/authorize/r1' })
+  if (path.endsWith('/api/coach/auth/exchange')) {
+    account = body.code === 'B' ? { id: 2, handle: 'B', display_name: 'Coach B' } : { id: 1, handle: 'A', display_name: 'Coach A' }
+    return json({ access_token: `token-${account.id}`, user: account })
+  }
+  if (path.endsWith('/api/coach/me')) return json({ user: account, read_only: true })
+  if (path.endsWith('/api/coach/sync')) return json({
+    account: mismatch ? { id: 1, handle: 'A' } : account,
+    submissions: [{ id: 9, contest_id: 7, verdict: 'AC' }], events: [], contests: [],
+    next_cursor: { submission_id: 9, event_id: 0 }, has_more: false,
+  })
+  if (path.endsWith('/api/coach/replay/7')) return json({ account, visualization: { team_events: [] } })
+  throw new Error(`unexpected ${url}`)
+}
+function json(value) { return { ok: true, json: async () => value, text: async () => JSON.stringify(value) } }
+
+try {
+  const client = createVpClient({ dataDir: root, fetchImpl })
+  const start = await client.start({ baseUrl: 'https://vp/' })
+  assert.equal(start.requestId, 'r1')
+  await client.finish({ code: 'A' })
+  const synced = await client.sync()
+  assert.equal(synced.account.id, 1)
+  assert.equal(JSON.parse(readFileSync(join(root, 'vp-accounts', '1', 'SYNC.json'))).account.id, 1)
+  await client.finish({ code: 'B' })
+  assert.equal((await client.status()).account.id, 2)
+  assert.equal((await client.sync()).account.id, 2)
+  mismatch = true
+  await assert.rejects(() => client.sync(), /account mismatch/)
+  assert.equal(JSON.parse(readFileSync(join(root, 'vp-accounts', '2', 'SYNC.json'))).account.id, 2)
+  console.log('VP CLIENT ALL PASSED')
+} finally {
+  rmSync(root, { recursive: true, force: true })
+}

package/dev.sh

@@ -35,7 +35,7 @@ done
 # 从副本目录跑 `bash dev.sh` 走的是另一条路（`dsh plugin remove/add`，而那条
 # 路不可靠），和这份的行为不一样。换句话说，**同一个命令，从哪个目录按回车
 # 决定跑哪份脚本** —— 两份 dev.sh 就是两份真相，正是这份文件在防的那种坑。
-SYNC_FILES='index.js package.json verify.mjs verify-shape.mjs progress-cli.mjs build-node-meta.mjs cordis.patch.yml README.md lib/client.js lib/setup.js lib/curriculum.js lib/curriculum-evidence.js lib/curriculum-planning.js lib/strategy.js assets/knowledge/COMPETENCIES.yaml assets/rules/coach-rules.md dev/curriculum-check.mjs dev/curriculum-evidence-check.mjs dev/strategy-check.mjs docs/长期课程机制.md dev.sh'
+SYNC_FILES='index.js package.json verify.mjs verify-shape.mjs progress-cli.mjs build-node-meta.mjs cordis.patch.yml README.md lib/client.js lib/vp-client.js lib/setup.js lib/curriculum.js lib/curriculum-evidence.js lib/curriculum-planning.js lib/strategy.js assets/knowledge/COMPETENCIES.yaml assets/knowledge/vp.html assets/rules/coach-rules.md dev/curriculum-check.mjs dev/curriculum-evidence-check.mjs dev/strategy-check.mjs dev/vp-client-check.mjs docs/长期课程机制.md dev.sh'
 STALE=''
 for f in $SYNC_FILES; do
   for d in "${DSTS[@]}"; do

package/docs//351/225/277/346/234/237/350/257/276/347/250/213/346/234/272/345/210/266.md

@@ -59,8 +59,11 @@ assess 最多返回最后 200 条，并给出 `evidenceCount/evidenceTruncated`
 
 ## 阶段如何编排
 
-基础字段 `id/title/outcome/nodes/exitCriteria` 分别标识阶段、能力成果、地图节点和
-验收方法；一个阶段 1–50 个不重复的真实节点，整条路线 1–30 个阶段。还必须提供：
+基础字段 `id/title/outcome/nodes/competencies/exitCriteria` 分别标识阶段、能力成果、地图节点、比赛能力和验收方法；一个阶段至少绑定一个真实地图节点或比赛能力，地图节点最多 50 个，整条路线 1–30 个阶段。读题、决策、团队沟通这类没有单一算法节点的阶段直接填 `competencies`。
+
+VP 题目里的 `competencies` 和复盘里的 `competencies` 会生成稳定证据 id（如 `vp:event:problem:competency`），进入课程时被快照；能力阶段只能用进入阶段后的新 baseline 记录通过 `advance`。
+
+还必须提供：
 
 | 字段 | 要回答的问题 |
 |---|---|
@@ -76,7 +79,7 @@ assess 最多返回最后 200 条，并给出 `evidenceCount/evidenceTruncated`
 
 三种可编排阶段：
 
-* **training**：每个节点都必须有对应证据。`finding=gap` 必须引用该节点的 gap；
+* **training**：每个节点或比赛能力都必须有对应证据。`finding=gap` 必须引用该节点/能力的 gap；
   `finding=extension` 必须引用该节点的 baseline。无关节点的失败不能用来凑依据。
   所有节点都必须列入 `requiredVerified`，不能用空数组逃过检测。
 * **diagnostic**：`finding=unknown`，明确待确认问题、取证方法与能力目标的关系。
@@ -111,7 +114,7 @@ assess 最多返回最后 200 条，并给出 `evidenceCount/evidenceTruncated`
 进入阶段时保存 `enteredAt/entryEvidenceRefs/entryEvidenceEvents`。advance 必须同时满足：
 
 * diagnostic：每个节点都有进入时未出现、日期不早于进入日的新有效观察。
-* training：全部节点 verified，且每个节点有本阶段新的独立做出或检测 passed 事件。
+* training：地图节点全部 verified，且每个节点有本阶段新的独立做出或检测 passed 事件；能力目标全部有本阶段新的 baseline 证据。
 * 当前阶段没有待完成动作，也没有检测卷等待判定。
 
 旧记录改内容或换来源不能替代新事件。诊断阶段不能通过 revise 改成训练或删除待诊断