acmer-coach 2.1.0 → 2.2.1

package/README.md

@@ -20,7 +20,7 @@
 
 ## 它到底做了什么
 
-26 个工具，三条轴：知识图、比赛能力、训练证据。
+29 个工具，三条轴：知识图、比赛能力、训练证据。
 
 | 轴 | 含义 |
 |---|---|
@@ -100,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

@@ -14,8 +14,10 @@
   和能力优先级。
 * `coach_focus` 给的是比赛能力重点，不是知识点清单。每次训练必须说明它服务哪个能力、
   为什么现在排、暂缓什么，以及用什么表现退出。知识图只负责把能力重点展开成可学节点。
-* 有 VP 时先导入 `coach_vp_import`，赛后调 `coach_postmortem`。VP 的读题、耗时、提交、
-  换题和团队问题优先于 rating；没有 VP 证据时要明确说“尚无记录”，不能装作知道短板。
+* 有 VP 时先用 `coach_vp_connect status` 检查账号，未连接就走 `start → 登录授权页 → finish`，
+  再用 `coach_vp_sync` 拉取真实记录；赛后调 `coach_vp_replay` 看秒级时间轴，最后调
+  `coach_postmortem`。VP 的读题、耗时、提交、换题和团队问题优先于 rating；没有 VP 证据时要
+  明确说“尚无记录”，不能装作知道短板。手工导入仍可用 `coach_vp_import`，但不能和当前账号记录混用。
 * 讲知识点之前调 `coach_scope`。必须说明适用范围、延伸、反例、常见错误、迁移题和退出
   条件；工具返回“没有范围卡片”时不许凭记忆补一段看似完整的范围。
 * 训练重点是比赛能力，不是沿着地图无限往下走。阶段达到目标后可以停在当前节点，转做

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/index.js

@@ -23,7 +23,7 @@
 //   · `file:` 依赖装出来的是**硬链接**，不是拷贝。原地写两边同变，但改名式
 //     写入（Edit 工具、VS Code 原子保存）会**断开链接**，断了两边分家，
 //     而 `dsh plugin add` 认不出分家、不重链也不报错 —— 所以改完一律跑 dev.sh。
-import { copyFileSync, readFileSync, unlinkSync, writeFileSync, renameSync, statSync } from 'node:fs'
+import { copyFileSync, mkdirSync, readFileSync, unlinkSync, writeFileSync, renameSync, statSync } from 'node:fs'
 import { join } from 'node:path'
 import { homedir } from 'node:os'
 import { parse, stringify } from 'yaml'
@@ -31,11 +31,12 @@ import { defineTool } from '@deepseek-ai/dsh-tools'
 import { initDataDir, syncCodeforces, contactEvidence, importPool, importRecords } from './lib/setup.js'
 import { createCurriculumStore, curriculumTool } from './lib/curriculum.js'
 import { createStrategyStore } from './lib/strategy.js'
+import { createVpClient } from './lib/vp-client.js'
 
 const name = 'acmer-coach'
 const inject = ['tools']
 
-const VERSION = '2.1.0'
+const VERSION = '2.2.0'
 
 // 块结构（方针 §4.1.1）：40 自己做 + 10 解决遗留 + 10 重写 = 60 分钟。
 // 这是**一个题目循环**的固定形状。时间不够该换更小的题，不是把块压扁。
@@ -71,14 +72,30 @@ const TEACH_FLOOR_MIN = 10
 const DATA_DIR_EXPLICIT = Boolean(process.env.COACH_DATA_DIR)
 const DATA_DIR = process.env.COACH_DATA_DIR || join(homedir(), '.dsh', 'knowledge')
 const MAP_PATH = () => join(DATA_DIR, 'MAP.yaml')
-const strategy = createStrategyStore({
-  dataDir: DATA_DIR,
-  competenciesPath: join(import.meta.dirname, 'assets', 'knowledge', 'COMPETENCIES.yaml'),
-})
-const curriculum = createCurriculumStore({
-  dataDir: DATA_DIR, loadMap, loadProgress, loadSchedule,
-  loadStrategyEvidence: () => strategy.evidence().evidence,
-})
+let ACTIVE_DATA_DIR = DATA_DIR
+let strategy
+let curriculum
+function createStores(dataDir) {
+  strategy = createStrategyStore({
+    dataDir, competenciesPath: join(import.meta.dirname, 'assets', 'knowledge', 'COMPETENCIES.yaml'),
+  })
+  curriculum = createCurriculumStore({
+    dataDir, loadMap, loadProgress, loadSchedule,
+    loadStrategyEvidence: () => strategy.evidence().evidence,
+  })
+}
+createStores(ACTIVE_DATA_DIR)
+
+function switchCoachWorkspace(accountId = '') {
+  ACTIVE_DATA_DIR = accountId ? join(DATA_DIR, 'vp-accounts', String(accountId)) : DATA_DIR
+  mkdirSync(ACTIVE_DATA_DIR, { recursive: true })
+  createStores(ACTIVE_DATA_DIR)
+  return ACTIVE_DATA_DIR
+}
+
+const vpClient = createVpClient({ dataDir: DATA_DIR })
+const savedVp = vpClient.localStatus()
+if (savedVp.connected) switchCoachWorkspace(savedVp.activeAccountId)
 
 // 探针要的文件，各自代表一条后面的依赖：
 //   MAP.yaml      地图（coach_next 读它算候选）
@@ -170,7 +187,7 @@ function loadMap() {
 //
 // 游标显式存，不靠"已验证的最大深度"推 —— 推出来的东西没法手改，
 // 而且他想复习某节时游标要能停在那儿。
-const PROGRESS_PATH = () => join(DATA_DIR, 'PROGRESS.yaml')
+const PROGRESS_PATH = () => join(ACTIVE_DATA_DIR, 'PROGRESS.yaml')
 
 function emptyProgress() {
   return { version: 1, cursor: '', updated: '', nodes: {}, pending: null }
@@ -309,7 +326,7 @@ function saveProgress(p) {
 //
 // `actual` 是**校准真实做题速度**的唯一来源 —— 计划 60 分钟实际 95 分钟，
 // 攒几周才知道他的速度到底是多少。这条现在一条数据都没有，所以排程只能保守。
-const SCHEDULE_PATH = () => join(DATA_DIR, 'SCHEDULE.yaml')
+const SCHEDULE_PATH = () => join(ACTIVE_DATA_DIR, 'SCHEDULE.yaml')
 
 function emptySchedule() {
   return { version: 1, updated: '', days: {} }
@@ -1410,6 +1427,7 @@ const reachableOf = (entry, rating) =>
   !entry || !rating || Number(entry) <= rating + REACH_BUFFER
 
 const SKILLTREE_HTML = () => join(DATA_DIR, 'skilltree.html')
+const VP_HTML = () => join(import.meta.dirname, 'assets', 'knowledge', 'vp.html')
 
 // ── /coach 路由：把技能树挂在 dsh 自己的 web 服务上 ──────────────────
 //
@@ -1492,6 +1510,38 @@ function registerPages(ctx) {
       return
     }
 
+    if (pathname === '/coach/vp.html') {
+      try { return send(res, 200, 'text/html; charset=utf-8', readFileSync(VP_HTML())) }
+      catch (err) { return send(res, 404, 'text/plain; charset=utf-8', `VP 页面缺失（${err?.code ?? err?.message}）`) }
+    }
+
+    if (pathname === '/coach/api/vp/status' && req.method === 'GET') {
+      return sendJson(res, 200, { ok: true, ...vpClient.localStatus() })
+    }
+
+    if (pathname === '/coach/api/vp/replay' && req.method === 'GET') {
+      const id = new URL(req.url ?? '/', 'http://dsh.internal').searchParams.get('contestId')
+      if (!id) return sendJson(res, 400, { ok: false, reject: '缺少 contestId' })
+      try { return sendJson(res, 200, { ok: true, ...(await vpClient.replay({ contestId: id })) }) }
+      catch (err) { return sendJson(res, 400, { ok: false, reject: String(err?.message || err) }) }
+    }
+
+    if (pathname === '/coach/api/vp/connect' && req.method === 'POST') {
+      let body = ''
+      for await (const chunk of req) { body += chunk; if (body.length > 100_000) { req.destroy(); return } }
+      let payload
+      try { payload = JSON.parse(body || '{}') } catch { return sendJson(res, 400, { ok: false, reject: '请求体不是 JSON' }) }
+      try {
+        let result
+        if (payload.op === 'start') result = await vpClient.start({ baseUrl: payload.baseUrl })
+        else if (payload.op === 'finish') { result = await vpClient.finish({ code: payload.code, baseUrl: payload.baseUrl }); switchCoachWorkspace(result.activeAccountId) }
+        else if (payload.op === 'disconnect') { result = vpClient.disconnect(); switchCoachWorkspace('') }
+        else if (payload.op === 'sync') result = await vpClient.sync({})
+        else return sendJson(res, 400, { ok: false, reject: 'op 只能是 start/finish/disconnect/sync' })
+        return sendJson(res, 200, { ok: true, ...result })
+      } catch (err) { return sendJson(res, 400, { ok: false, reject: String(err?.message || err) }) }
+    }
+
     if (pathname === '/coach/skilltree.html') {
       let html
       try {
@@ -1808,6 +1858,44 @@ function wikiPage(src) {
   return { ok: true, text: text.slice(0, 12000), truncated: text.length > 12000, chars: text.length }
 }
 
+const emptyVpAccount = () => ({ id: 0, handle: '', display_name: '' })
+const vpAccount = (value) => value && Number(value.id) > 0
+  ? { id: Number(value.id), handle: String(value.handle || ''), display_name: String(value.display_name || value.handle || '') }
+  : emptyVpAccount()
+
+function vpEventsFromSync(payload, account) {
+  const submissions = Array.isArray(payload?.submissions) ? payload.submissions : []
+  const contests = Array.isArray(payload?.contests) ? payload.contests : []
+  const byContest = new Map()
+  for (const contest of contests) byContest.set(Number(contest.id), contest)
+  const groups = new Map()
+  for (const submission of submissions) {
+    const contestId = Number(submission.contest_id)
+    const problemId = String(submission.problem_id ?? '').trim()
+    if (!contestId || !problemId) continue
+    if (!groups.has(contestId)) groups.set(contestId, new Map())
+    const problems = groups.get(contestId)
+    if (!problems.has(problemId)) problems.set(problemId, [])
+    problems.get(problemId).push(submission)
+  }
+  return [...groups.entries()].map(([contestId, problems]) => {
+    const contest = byContest.get(contestId) || {}
+    const start = String(contest.start_time || [...problems.values()][0]?.[0]?.submitted_at || '')
+    const normalized = [...problems.entries()].map(([problemId, attempts]) => {
+      const solved = attempts.find((item) => ['AC', 'OK', 'ACCEPTED', 'SOLVED'].includes(String(item.verdict || '').toUpperCase()))
+      const at = solved?.submitted_at || attempts.at(-1)?.submitted_at
+      const minutes = start && at ? Math.max(0, Math.round((Date.parse(at) - Date.parse(start)) / 60000)) : 0
+      return { problemId, status: solved ? 'AC' : String(attempts.at(-1)?.verdict || 'UNKNOWN').toUpperCase(), attempts: attempts.length, solveMinutes: minutes, competencies: [] }
+    })
+    return {
+      eventId: `vp:${account.id}:${contestId}`,
+      contest: String(contest.title || contestId), contestId: String(contestId), date: start.slice(0, 10),
+      durationMinutes: Number(contest.duration_min || 0), virtual: true, teamMode: 'team', problems: normalized,
+      note: '由 VP 只读同步生成；具体能力标签在复盘时补充。',
+    }
+  }).filter((event) => /^\d{4}-\d{2}-\d{2}$/.test(event.date) && event.problems.length)
+}
+
 function apply(ctx) {
   // ── 规则层：进 system prompt ──────────────────────────────────────
   //
@@ -1838,6 +1926,93 @@ function apply(ctx) {
   // 课程图回答“有哪些知识点”，策略层回答“为什么现在学这个”。两者分开，
   // 避免把 rating 或游标误当成区域赛目标。
   const strategyText = (v) => [{ type: 'text', text: v.ok ? v.text : `❌ ${v.reject}` }]
+  ctx.tools.register(defineTool({
+    name: 'coach_vp_connect',
+    description: '连接 VP 账号。start 返回登录授权页，finish 交换一次性授权码；账号数据按 VP user id 分目录，disconnect 只删本地 token，不删缓存。',
+    parameters: {
+      action: { type: 'string', required: true, enum: ['start', 'finish', 'status', 'disconnect'] },
+      baseUrl: { type: 'string', description: 'VP 地址，默认 https://xiaojing.run' },
+      code: { type: 'string', description: 'VP 授权页显示的一次性 code，action=finish 时填写' },
+    },
+    output: { schema: { type: 'object', additionalProperties: false, properties: {
+      ok: { type: 'boolean', required: true }, reject: { type: 'string', required: true }, action: { type: 'string', required: true },
+      connected: { type: 'boolean', required: true }, activeAccountId: { type: 'integer', required: true },
+      account: { type: 'object', required: true, additionalProperties: false, properties: { id: { type: 'integer', required: true }, handle: { type: 'string', required: true }, display_name: { type: 'string', required: true } } }, requestId: { type: 'string', required: true },
+      authorizeUrl: { type: 'string', required: true }, expiresAt: { type: 'string', required: true }, text: { type: 'string', required: true },
+    } }, render: (_a, v) => strategyText(v) },
+    execute: async (args) => {
+      const action = String(args?.action || 'status')
+      const base = args?.baseUrl || 'https://xiaojing.run'
+      try {
+        let result
+        if (action === 'start') result = await vpClient.start({ baseUrl: base })
+        else if (action === 'finish') {
+          result = await vpClient.finish({ code: args?.code, baseUrl: base })
+          switchCoachWorkspace(result.activeAccountId)
+        } else if (action === 'disconnect') {
+          result = vpClient.disconnect()
+          switchCoachWorkspace('')
+        } else result = await vpClient.status()
+        const account = vpAccount(result.account)
+        return { ok: true, reject: '', action, connected: Boolean(result.connected ?? action === 'finish'), activeAccountId: Number(result.activeAccountId || account.id || 0), account,
+          requestId: String(result.requestId || ''), authorizeUrl: String(result.authorizeUrl || ''), expiresAt: String(result.expiresAt || ''),
+          text: action === 'start' ? `打开授权页登录 VP：${result.authorizeUrl}\n授权后把页面显示的 code 交给 coach_vp_connect finish。` :
+            action === 'finish' ? `VP 已连接：${account.handle}（账号 ${account.id}）；本地工作区已切换。` :
+              action === 'disconnect' ? 'VP 已断开；缓存保留，token 已删除。' : (result.connected ? `当前 VP：${account.handle}（账号 ${account.id}）` : '当前没有已连接的 VP 账号。') }
+      } catch (err) {
+        return { ok: false, reject: String(err?.message || err), action, connected: false, activeAccountId: 0, account: emptyVpAccount(), requestId: '', authorizeUrl: '', expiresAt: '', text: '' }
+      }
+    },
+  }))
+
+  ctx.tools.register(defineTool({
+    name: 'coach_vp_sync',
+    description: '从当前 VP 账号增量同步比赛、提交、事件和个人时间线。只读；游标和缓存都放在当前账号目录，切换账号不会读到另一人的数据。同步后自动生成带账号前缀的 VP 训练证据。',
+    parameters: {
+      limit: { type: 'integer', description: '单次最多同步多少条提交，默认 200' },
+      includeProfile: { type: 'boolean', description: '是否同步个人 rating/比赛历史，默认 true' },
+    },
+    output: { schema: { type: 'object', additionalProperties: false, properties: {
+      ok: { type: 'boolean', required: true }, reject: { type: 'string', required: true }, account: { type: 'object', required: true, additionalProperties: false, properties: { id: { type: 'integer', required: true }, handle: { type: 'string', required: true }, display_name: { type: 'string', required: true } } },
+      imported: { type: 'integer', required: true }, contests: { type: 'array', required: true }, submissions: { type: 'array', required: true }, events: { type: 'array', required: true },
+      nextCursor: { type: 'object', required: true, additionalProperties: true }, cachedPath: { type: 'string', required: true }, text: { type: 'string', required: true },
+    } }, render: (_a, v) => strategyText(v) },
+    execute: async (args) => {
+      try {
+        const payload = await vpClient.sync({ limit: args?.limit, includeProfile: args?.includeProfile !== false })
+        const account = vpAccount(payload.account)
+        switchCoachWorkspace(account.id)
+        const importedEvents = vpEventsFromSync(payload, account)
+        const imported = importedEvents.length ? strategy.vpImport(importedEvents) : { imported: 0 }
+        return { ok: true, reject: '', account, imported: Number(imported.imported || 0), contests: payload.contests || [], submissions: payload.submissions || [], events: payload.events || [],
+          nextCursor: payload.next_cursor || {}, cachedPath: String(payload.cachedPath || ''), text: `VP 同步完成：${account.handle}；比赛 ${payload.contests?.length || 0} 场，提交 ${payload.submissions?.length || 0} 条，新增训练证据 ${imported.imported || 0} 场。` }
+      } catch (err) {
+        return { ok: false, reject: String(err?.message || err), account: emptyVpAccount(), imported: 0, contests: [], submissions: [], events: [], nextCursor: {}, cachedPath: '', text: '' }
+      }
+    },
+  }))
+
+  ctx.tools.register(defineTool({
+    name: 'coach_vp_replay',
+    description: '读取当前 VP 账号指定比赛的细粒度回放。返回题目、队伍提交和秒级时间轴；代码不回传，页面可视化从这个数据绘制。',
+    parameters: { contestId: { type: 'integer', required: true }, limit: { type: 'integer', description: '官方 runs 上限，默认 50000' } },
+    output: { schema: { type: 'object', additionalProperties: false, properties: {
+      ok: { type: 'boolean', required: true }, reject: { type: 'string', required: true }, account: { type: 'object', required: true, additionalProperties: false, properties: { id: { type: 'integer', required: true }, handle: { type: 'string', required: true }, display_name: { type: 'string', required: true } } },
+      contest: { type: 'object', required: true, additionalProperties: true }, problems: { type: 'array', required: true }, result: { type: 'object', required: true, additionalProperties: true },
+      visualization: { type: 'object', required: true, additionalProperties: true }, cachedPath: { type: 'string', required: true }, text: { type: 'string', required: true },
+    } }, render: (_a, v) => strategyText(v) },
+    execute: async (args) => {
+      try {
+        const payload = await vpClient.replay({ contestId: args?.contestId, limit: args?.limit })
+        const account = vpAccount(payload.account)
+        return { ok: true, reject: '', account, contest: payload.contest || {}, problems: payload.problems || [], result: payload.result || {}, visualization: payload.visualization || {}, cachedPath: String(payload.cachedPath || ''),
+          text: `回放已加载：${payload.contest?.title || args?.contestId}；队伍事件 ${payload.visualization?.team_events?.length || 0} 个，官方 runs ${payload.visualization?.official_run_count || 0} 条。` }
+      } catch (err) {
+        return { ok: false, reject: String(err?.message || err), account: emptyVpAccount(), contest: {}, problems: [], result: {}, visualization: {}, cachedPath: '', text: '' }
+      }
+    },
+  }))
+
   ctx.tools.register(defineTool({
     name: 'coach_target',
     description: '设置或读取比赛目标。目标先于知识点：contest/date/result/teamMode/weeklyHours/priorities 都确定后，教练才有依据选训练重点。',

package/lib/client.js

@@ -87,6 +87,7 @@ window.__ModuleLoader__.load({
     }
 
     const PAGE_URL = "/coach/skilltree.html";
+    const VP_PAGE_URL = "/coach/vp.html";
 
     // VP（CompetitionWhale）的品牌标：**拱**是露出水面的鲸背，**波浪**是水面，两笔。
     //
@@ -191,6 +192,37 @@ window.__ModuleLoader__.load({
       });
     }
 
+    function VpOverlay({ onClose }) {
+      React.useEffect(() => {
+        const onKey = (e) => { if (e.key === "Escape") onClose(); };
+        document.addEventListener("keydown", onKey);
+        return () => document.removeEventListener("keydown", onKey);
+      }, [onClose]);
+      return jsx("div", {
+        className: "dshcoach-mask",
+        onClick: (e) => { if (e.target === e.currentTarget) onClose(); },
+        children: jsxs("div", {
+          className: "dshcoach-panel",
+          children: [
+            jsxs("div", { className: "dshcoach-bar", children: [
+              jsxs("div", { className: "dshcoach-title", children: [jsx(WhaleMark, { size: 17 }), jsx("span", { children: "VP 回放" })] }),
+              jsx("button", { type: "button", className: "dshcoach-action", onClick: () => window.open(VP_PAGE_URL, "_blank", "noopener"), children: "新标签页打开" }),
+              jsx("button", { type: "button", className: "dshcoach-action", onClick: onClose, children: "✕ 关闭" }),
+            ] }),
+            jsx("iframe", { className: "dshcoach-frame", src: VP_PAGE_URL, title: "VP 回放" }),
+          ],
+        }),
+      });
+    }
+
+    function VpHeaderButton() {
+      const [open, setOpen] = React.useState(false);
+      return jsxs(React.Fragment, { children: [
+        jsxs("button", { type: "button", className: "dshcoach-btn", title: "连接 VP、同步比赛并查看秒级回放", onClick: () => setOpen(true), children: [jsx(WhaleMark, { size: 15 }), jsx("span", { children: "VP 回放" })] }),
+        open ? createPortal(jsx(VpOverlay, { onClose: () => setOpen(false) }), document.body) : null,
+      ] });
+    }
+
     // 服务名注入（不是模块名）：等 slots 服务到位再注册。
     const inject = ["slots"];
 
@@ -202,6 +234,12 @@ window.__ModuleLoader__.load({
         order: 20,
         registrant: "acmer-coach",
       }, SkillTreeHeaderButton));
+      ctx.slots.inject("conversation.session.header.utilities", () => ctx.slots.register({
+        name: "conversation.session.header.utilities",
+        id: "acmer-coach:vp",
+        order: 21,
+        registrant: "acmer-coach",
+      }, VpHeaderButton));
     }
 
     return { apply, inject };

package/lib/vp-client.js

@@ -0,0 +1,148 @@
+import { chmodSync, copyFileSync, mkdirSync, readFileSync, renameSync, rmSync, unlinkSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+
+const DEFAULT_BASE_URL = 'https://xiaojing.run'
+
+const cleanBaseUrl = (value) => {
+  const url = new URL(String(value || DEFAULT_BASE_URL))
+  if (!['http:', 'https:'].includes(url.protocol) || url.username || url.password || url.search || url.hash) {
+    throw new Error('VP baseUrl 必须是干净的 http/https 地址')
+  }
+  return url.toString().replace(/\/$/, '')
+}
+
+function safeAccount(value) {
+  if (!value || typeof value !== 'object' || !Number.isInteger(Number(value.id))) throw new Error('VP 返回了无效账号')
+  return { id: Number(value.id), handle: String(value.handle || ''), display_name: String(value.display_name || value.handle || '') }
+}
+
+function atomicJson(path, value, mode = 0o600) {
+  const tmp = `${path}.${process.pid}.${Date.now()}.tmp`
+  writeFileSync(tmp, `${JSON.stringify(value, null, 2)}\n`, 'utf8')
+  try { chmodSync(tmp, mode) } catch { /* Windows 没有 Unix mode，不影响原子写 */ }
+  try { renameSync(tmp, path) } catch (err) {
+    if (err.code !== 'EPERM' && err.code !== 'EEXIST') throw err
+    try { unlinkSync(path) } catch (removeErr) { if (removeErr.code !== 'ENOENT') throw err }
+    copyFileSync(tmp, path)
+    unlinkSync(tmp)
+  }
+}
+
+export function createVpClient({ dataDir, fetchImpl = globalThis.fetch, now = () => new Date() } = {}) {
+  if (typeof fetchImpl !== 'function') throw new Error('VP 客户端需要 fetch')
+  const root = join(dataDir, 'vp-accounts')
+  const registryPath = join(dataDir, 'VP_ACCOUNTS.json')
+
+  const loadRegistry = () => {
+    try {
+      const doc = JSON.parse(readFileSync(registryPath, 'utf8'))
+      return doc && typeof doc === 'object' ? doc : { activeAccountId: '', accounts: {} }
+    } catch (err) {
+      if (err.code === 'ENOENT') return { version: 1, activeAccountId: '', accounts: {} }
+      throw err
+    }
+  }
+  const saveRegistry = (value) => atomicJson(registryPath, { version: 1, ...value })
+  const accountDir = (id) => join(root, String(id))
+  const tokenPath = (id) => join(accountDir(id), 'TOKEN.json')
+  const loadToken = (id) => JSON.parse(readFileSync(tokenPath(id), 'utf8')).access_token
+  const active = () => {
+    const registry = loadRegistry()
+    const id = Number(registry.activeAccountId || 0)
+    if (!id) return null
+    const meta = registry.accounts?.[String(id)]
+    if (!meta) return null
+    return { id, account: safeAccount(meta.account), baseUrl: cleanBaseUrl(meta.baseUrl || DEFAULT_BASE_URL) }
+  }
+  const request = async (baseUrl, path, { token, method = 'GET', body } = {}) => {
+    const response = await fetchImpl(`${cleanBaseUrl(baseUrl)}${path}`, {
+      method, headers: { accept: 'application/json', ...(body ? { 'content-type': 'application/json' } : {}), ...(token ? { authorization: `Bearer ${token}` } : {}) },
+      body: body ? JSON.stringify(body) : undefined,
+    })
+    let payload
+    try { payload = await response.json() } catch { payload = { detail: await response.text() } }
+    if (!response.ok) throw new Error(`VP ${response.status}: ${payload?.detail || payload?.message || '请求失败'}`)
+    return payload
+  }
+  const requireActive = () => {
+    const current = active()
+    if (!current) throw new Error('还没有连接 VP；先调用 coach_vp_connect start/finish')
+    return { ...current, token: loadToken(current.id) }
+  }
+  const verifyAccount = (current, value) => {
+    const returned = safeAccount(value)
+    if (returned.id !== current.id) throw new Error(`VP account mismatch: 当前是 ${current.id}，接口返回 ${returned.id}`)
+    return returned
+  }
+
+  return {
+    async start({ baseUrl = DEFAULT_BASE_URL } = {}) {
+      const clean = cleanBaseUrl(baseUrl)
+      const result = await request(clean, '/api/coach/auth/start', { method: 'POST', body: {
+        redirect_uri: 'http://127.0.0.1:8765/coach/callback',
+        scopes: ['profile', 'contests', 'submissions', 'replay'],
+      } })
+      return { ok: true, requestId: result.request_id, authorizeUrl: result.authorize_url, expiresAt: result.expires_at, baseUrl: clean }
+    },
+    async finish({ code, baseUrl = DEFAULT_BASE_URL } = {}) {
+      const clean = cleanBaseUrl(baseUrl)
+      const result = await request(clean, '/api/coach/auth/exchange', { method: 'POST', body: { code: String(code || '') } })
+      const account = safeAccount(result.user)
+      const dir = accountDir(account.id)
+      mkdirSync(dir, { recursive: true })
+      atomicJson(tokenPath(account.id), { access_token: String(result.access_token), saved_at: now().toISOString() })
+      const registry = loadRegistry()
+      registry.accounts = registry.accounts || {}
+      registry.accounts[String(account.id)] = { account, baseUrl: clean, lastSyncAt: registry.accounts[String(account.id)]?.lastSyncAt || '' }
+      registry.activeAccountId = account.id
+      saveRegistry(registry)
+      return { ok: true, account, activeAccountId: account.id }
+    },
+    async status() {
+      const current = active()
+      if (!current) return { connected: false, account: null, activeAccountId: null }
+      try {
+        const remote = await request(current.baseUrl, '/api/coach/me', { token: loadToken(current.id) })
+        const account = verifyAccount(current, remote.user)
+        return { connected: true, account, activeAccountId: current.id, baseUrl: current.baseUrl, readOnly: remote.read_only !== false }
+      } catch (err) {
+        return { connected: false, account: current.account, activeAccountId: current.id, error: err.message }
+      }
+    },
+    async sync({ limit = 200, includeProfile = true } = {}) {
+      const current = requireActive()
+      const registry = loadRegistry()
+      const accountMeta = registry.accounts[String(current.id)] || {}
+      const cursor = accountMeta.cursor || { submission_id: 0, event_id: 0 }
+      const query = new URLSearchParams({ submission_cursor: String(cursor.submission_id || 0), event_cursor: String(cursor.event_id || 0), limit: String(Math.max(1, Math.min(500, Number(limit) || 200))), include_profile: includeProfile ? '1' : '0' })
+      const payload = await request(current.baseUrl, `/api/coach/sync?${query}`, { token: current.token })
+      const account = verifyAccount(current, payload.account)
+      const next = payload.next_cursor || cursor
+      atomicJson(join(accountDir(current.id), 'SYNC.json'), { ...payload, account, synced_at: now().toISOString() })
+      registry.accounts[String(current.id)] = { ...accountMeta, account, baseUrl: current.baseUrl, cursor: next, lastSyncAt: now().toISOString() }
+      saveRegistry(registry)
+      return { ...payload, account, cursor: next, cachedPath: join(accountDir(current.id), 'SYNC.json') }
+    },
+    async replay({ contestId, limit = 50000 } = {}) {
+      const current = requireActive()
+      const payload = await request(current.baseUrl, `/api/coach/replay/${encodeURIComponent(String(contestId))}?limit=${Math.max(1, Math.min(50000, Number(limit) || 50000))}`, { token: current.token })
+      const account = verifyAccount(current, payload.account)
+      const result = { ...payload, account, cachedPath: join(accountDir(current.id), `REPLAY-${String(contestId)}.json`) }
+      atomicJson(result.cachedPath, { ...payload, account, cached_at: now().toISOString() })
+      return result
+    },
+    disconnect() {
+      const current = active()
+      if (!current) return { ok: true, disconnected: false }
+      try { rmSync(tokenPath(current.id), { force: true }) } catch { /* best effort */ }
+      const registry = loadRegistry()
+      registry.activeAccountId = ''
+      saveRegistry(registry)
+      return { ok: true, disconnected: true, account: current.account, cached: true }
+    },
+    localStatus() {
+      const current = active()
+      return current ? { connected: true, account: current.account, activeAccountId: current.id, baseUrl: current.baseUrl } : { connected: false, account: null, activeAccountId: null }
+    },
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "acmer-coach",
   "description": "小鲸教练插件：把「位置 + 判断」从小鲸的转述里拿回来。读 MAP/DEPENDS/PROGRESS，给唯一动作、判因、检测。热插拔，删掉即还原。",
-  "version": "2.1.0",
+  "version": "2.2.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Miantiao1231/acmer-coach.git"

package/verify-shape.mjs

@@ -175,6 +175,9 @@ const cases = [
   ['coach_assign#target-gate', { node: 'B', deliverable: '把代码贴给我', why: '测试目标硬闸', minutes: 60, teachMinutes: 25 }],
   ['coach_target', { action: 'set', expectedRevision: 2, contest: '测试区域赛', date: '2026-10-18', result: '金牌', teamMode: 'team', weeklyHours: 20, priorities: [{ id: 'contest-reading', weight: 80, reason: '测试目标' }] }],
   ['coach_vp_import', { events: [{ eventId: 'shape-vp', contest: '测试 VP', date: today, durationMinutes: 300, problems: [{ problemId: 'A', status: 'AC', competencies: ['contest-reading'] }] }] }],
+  ['coach_vp_connect', { action: 'status' }],
+  ['coach_vp_sync', {}],
+  ['coach_vp_replay', { contestId: 1 }],
   ['coach_postmortem', { eventId: 'shape-vp', competencies: ['contest-reading'], rootCauses: ['测试复盘'], nextActions: ['测试动作'] }],
   ['coach_focus', {}],
   ['coach_scope', { id: 'contest-reading' }],