dsh-session-superagent 0.8.14 → 0.8.16

package/CHANGELOG.md

@@ -2,6 +2,72 @@
 
 格式参照 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [0.8.16] - 2026-11-02 —— 第一次在真浏览器里看面板，抓到一个对比度问题
+
+宿主的 web 界面有鉴权（`dsh web authentication required`），ego 浏览器过不去，所以搭了个
+**静态预览**：`scripts/render-preview.mjs` 用极简假 React 把真实 `client.js` 的组件渲染成 DOM，
+内联移植来的官方 CSS，六个场景（总览/判定/触发/设置/术语表/两种 Toast）一起看。
+
+### 修复（真浏览器里发现的）
+- **错误 Toast 白字看不清**：0.8.12 给错误态加了「浅红底」，而官方 toast 是深底白字——
+  白字压在浅粉上对比度极低。现在保留官方深底，改用**左侧红条**标记错误。
+
+### 验证（在 Chromium 里读 computed style，不是猜）
+```
+模态框   position:fixed; inset:0，宽度 380 居中        ← 「弹层掉到页面底部」的 bug 确认已修
+Toast    position:fixed; top:40px; z-index:1100; 299×46 深底白字
+错误态   背景 #24292f / 白字 / 左边框 #f85149
+标签     success 绿底绿字、warning 琥珀底琥珀字（tone 与 CSS 对得上）
+列表行   高 102–122px（三线结构：标题 / meta / 操作）
+```
+
+顺带搞清了 `dt-tag` 的颜色依赖 `--dsw-alias-state-{success,warn,error,info}-primary` 这几个 token
+（之前预览里缺，标签看着是裸文字——这和审核第二轮发现的「状态色全丢」是同一个根因）。
+
+### 工具
+- `pnpm run preview` 生成 `preview-panel.html`（已加进 .gitignore，不进仓库/不发包）。
+
+### 测试
+- 合计 **81 例**（本次是样式与渲染层修复，靠真浏览器核对）。
+
+## [0.8.15] - 2026-11-02 —— sync-profile 支持修复断链（事故 1 的第二种形态）
+
+### 修什么
+`sync-profile.mjs` 之前只会「补缺失文件」，遇到**已存在但 inode 不同**（断链）只打印一句“注意”。
+断链的来源很日常：任何用「写临时文件再 rename」保存的工具（含某些编辑器的原子写）都会让
+profile 里那份留在旧 inode 上 —— 于是**宿主跑旧代码，仓库里看着是新代码**。
+
+现在三种模式：
+
+```bash
+pnpm run sync:profile           # 补齐缺失（不动断链，只警告）
+pnpm run sync:profile:repair    # 断链重建硬链接 + 清理 profile 里的陈旧文件
+pnpm run sync:profile:check     # 只检查：有缺失/断链/陈旧就 exit 1（CI/发布前用）
+```
+
+实测：profile 里 `README.md` / `CHANGELOG.md` 当时确实是断链，`--repair` 重建后
+`--check` 从 exit 1 变 exit 0。另外故意把 README 换成新 inode，验证 `--check` 会红（exit 1）。
+
+### 守门
+- 新增用例：`sync-profile` 的 `TARGETS` 必须覆盖 `lib/` 下所有 js 文件 ——
+  防止「新增 lib 文件忘了登记」再次导致插件不挂载。
+
+### 发布
+- 已发 `dsh-session-superagent@0.8.15`（registry `latest = 0.8.15`）。
+- tarball 直装验证：`version 0.8.15`、**routes 6**、`client.js` 语法通过、包内 `scripts/` 三个脚本齐全。
+
+### 发布前快照（每次发版都跑这一套）
+```
+node --test                     81/81
+node --check client.js lib/*.js scripts/*.mjs   全过
+sync-profile --check            缺失 0 / 断链 0 / 陈旧 0，相对 import 全可解析
+smoke-observe                   两场景 12 项 OK
+npm pack --dry-run              13 文件 / 75.4 kB
+```
+
+### 测试
+- 合计 **81 例**。
+
 ## [0.8.14] - 2026-11-02 —— 第四轮审核：1 条文档 + 3 条代码建议
 
 审核范围 0.8.9→0.8.13（上一轮门禁只覆盖到 0.8.8）。结论：代码侧无阻塞，文档有 1 处必须修。
@@ -21,6 +87,12 @@
 - **`sync-profile --repair`**：断链（inode 不同）目前只警告。已在 HANDOFF 写明「新增文件后必须跑」，
   留作后续（改起来简单，但此刻没有证据表明它造成过事故）。
 
+### 发布
+- 已发 `dsh-session-superagent@0.8.14`（registry `latest = 0.8.14`）。
+- **从 tarball 真装验证**：`npm i https://registry.npmjs.org/dsh-session-superagent/-/dsh-session-superagent-0.8.14.tgz`
+  → `apply()` 成功、**路由 6 条**（`/client-hello` 确实没了）、`client.js` 语法通过、`lib/` 四个文件齐全。
+  注：刚发布时 `npm i pkg@x.y.z` 可能因客户端元数据缓存报 ETARGET，用 tarball URL 或 `--prefer-online` 可绕过。
+
 ### 其他
 - `scripts/smoke-observe.mjs` 加 `gh auth status` 预检：没登录时明确 SKIP 并退出 0，
   不再把「凭证/网络问题」混报成逻辑失败（第四轮审核的建议）。

package/README.md

@@ -1,7 +1,7 @@
 # dsh-session-superagent
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
-[![Version](https://img.shields.io/badge/version-0.8.14-green.svg)](https://github.com/MYCF711/dsh-session-superagent/releases)
+[![Version](https://img.shields.io/badge/version-0.8.16-green.svg)](https://github.com/MYCF711/dsh-session-superagent/releases)
 [![npm](https://img.shields.io/npm/v/dsh-session-superagent.svg)](https://www.npmjs.com/package/dsh-session-superagent)
 [![dsh](https://img.shields.io/badge/DeepSeek%20Harness-plugin-orange.svg)](https://github.com/topics/dsh-plugin)
 

package/client.js

@@ -14,7 +14,7 @@ window.__ModuleLoader__.load({
     const { useCallback, useEffect, useRef, useState } = React
 
     // 客户端版本探针：每次模块加载写一次，用来确认浏览器里跑的是哪一版
-    const CLIENT_VERSION = '0.8.14'
+    const CLIENT_VERSION = '0.8.16'
     const BASE = '/session-superagent'
     const ENDPOINT = BASE + '/state'
     const POLL_MS = 5000
@@ -614,8 +614,9 @@ window.__ModuleLoader__.load({
         className: cx('dt-toast', item.tone === 'error' && 'dt-danger'),
         role: 'status',
         'aria-live': 'polite',
+        // 官方 toast 是深底白字；错误态不要改成浅红底（白字会看不清），改用左侧红条标记
         style: item.tone === 'error'
-          ? { '--dt-toast-hold': '3600ms', background: 'color-mix(in srgb, #f85149 14%, var(--dsw-alias-bg-layer-1, #fff))' }
+          ? { '--dt-toast-hold': '3600ms', borderLeft: '3px solid #f85149' }
           : { '--dt-toast-hold': '3600ms' },
       }, item.text)
       return [view, notify]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-session-superagent",
-  "version": "0.8.14",
+  "version": "0.8.16",
   "description": "Session-level superagent for DeepSeek Harness: watch a GitHub repository and wake a session when something needs doing. Credentials never reach the model.",
   "type": "module",
   "main": "lib/index.js",
@@ -20,7 +20,8 @@
     "client.js",
     "scripts/preview-orbit.mjs",
     "scripts/port-official-ui.mjs",
-    "scripts/sync-profile.mjs"
+    "scripts/sync-profile.mjs",
+    "scripts/render-preview.mjs"
   ],
   "engines": {
     "node": ">=22.19.0",
@@ -31,7 +32,10 @@
     "check": "node --test",
     "preview:orbit": "node scripts/preview-orbit.mjs",
     "sync:profile": "node scripts/sync-profile.mjs",
-    "smoke:observe": "node scripts/smoke-observe.mjs"
+    "smoke:observe": "node scripts/smoke-observe.mjs",
+    "sync:profile:check": "node scripts/sync-profile.mjs --check",
+    "sync:profile:repair": "node scripts/sync-profile.mjs --repair",
+    "preview": "node scripts/render-preview.mjs"
   },
   "keywords": [
     "dsh",

package/scripts/render-preview.mjs

@@ -0,0 +1,213 @@
+// 把「主理鱼」面板渲染成静态 HTML，用于在真浏览器里看布局（不需要宿主、不需要 React）。
+//
+// 为什么：client.js 是给宿主用的模块（`window.__ModuleLoader__.load` + `require('react')`），
+// 组件树用 h() 构造。这里提供一个极简的假 React，把组件渲染成虚拟节点树，
+// 再序列化成 HTML，并内联移植来的官方 CSS —— 于是可以在浏览器里真实地看布局。
+//
+// 用法： node scripts/render-preview.mjs [输出文件]
+//   node scripts/render-preview.mjs preview-panel.html
+import { readFileSync, writeFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import vm from 'node:vm'
+
+const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
+const OUT = process.argv[2] || join(ROOT, 'preview-panel.html')
+
+// ── 假 React：只需要 createElement/useState/useEffect/useCallback/useRef/memo/Fragment ──
+let hookQueue = []
+let hookIndex = 0
+const React = {
+  Fragment: Symbol('Fragment'),
+  createElement(type, props, ...children) {
+    return { type, props: { ...(props || {}), children: children.flat(Infinity).filter((c) => c !== null && c !== undefined && c !== false) } }
+  },
+  memo: (fn) => fn,
+  useState(init) {
+    const value = hookIndex < hookQueue.length ? hookQueue[hookIndex] : (typeof init === 'function' ? init() : init)
+    hookIndex += 1
+    return [value, () => {}]
+  },
+  useEffect() {},
+  useCallback: (fn) => fn,
+  useRef: (value) => ({ current: value }),
+}
+
+// 假宿主：只收集注册，不真的挂任何东西
+const registrations = []
+const sandbox = {
+  window: {
+    __ModuleLoader__: { load: (mod) => registrations.push(mod) },
+    innerWidth: 1280, innerHeight: 900,
+    addEventListener() {}, removeEventListener() {},
+  },
+  document: {
+    getElementById: () => null,
+    createElement: () => ({ id: '', textContent: '' }),
+    head: { appendChild() {} },
+    addEventListener() {}, removeEventListener() {},
+  },
+  fetch: () => Promise.resolve({ ok: true, status: 200, text: () => Promise.resolve('{}') }),
+  setInterval: () => 0, clearInterval: () => {}, setTimeout: () => 0, clearTimeout: () => {},
+  console,
+}
+vm.createContext(sandbox)
+vm.runInContext(readFileSync(join(ROOT, 'client.js'), 'utf8'), sandbox)
+
+const mod = registrations[0]
+if (!mod) throw new Error('client.js 没有注册任何模块')
+const slots = new Map()
+const ctx = {
+  slots: {
+    inject: (_name, fn) => fn(),
+    register: (opts, Component) => { slots.set(opts.id, Component); return () => {} },
+  },
+  effect: (fn) => fn(),
+}
+mod.factory((name) => {
+  if (name === 'react') return React
+  throw new Error('unexpected require: ' + name)
+}).apply(ctx)
+
+const Desk = slots.get('session-superagent-desk')
+if (!Desk) throw new Error('没有注册 session-superagent-desk，已注册：' + [...slots.keys()].join(','))
+
+// ── 样本快照：覆盖各种状态（正常/暂停/异常/仅观察/隔离/退避/过滤记录/历史）──
+const now = Date.now()
+const iso = (ms) => new Date(now - ms).toISOString()
+const snapshot = {
+  loading: false, error: null,
+  body: {
+    sessionTitle: 'README 收尾与发布',
+    sessionGoal: null,
+    gh: { ok: true, version: 'gh version 2.101.0' },
+    credentials: { token: 'configured', sshKeyPath: 'none' },
+    watchers: [
+      {
+        id: 'MYCF711/dsh-session-superagent#s1', repo: 'MYCF711/dsh-session-superagent', sessionId: 's1',
+        intervalSec: 60, enabled: true, observe: false, title: 'README 收尾与发布', note: '把 0.8.x 的文档补齐',
+        lastPoll: iso(15000), lastWake: iso(300000), lastWakeCount: 3, lastAbsorbed: 1,
+        filters: { labels: ['ai-fix'], ignoreLabels: [], skipBots: true, skipDrafts: true, skipClosed: true, onlyAssigned: false, assignee: null },
+        activeHours: '09:00-23:00', isolated: true, workdir: 'E:/temp/iso', lastWorktree: 'E:/temp/iso/.dsh-zhuli/a-b',
+        history: [
+          { at: iso(300000), numbers: [12], ok: true, reason: null },
+          { at: iso(600000), numbers: [11], ok: false, reason: 'observe' },
+        ],
+        filteredLog: [{ number: 7, title: '机器人提的依赖升级', reason: '机器人', at: iso(120000) }],
+      },
+      {
+        id: 'MYCF711/dsh-GOkifu-compact#s2', repo: 'MYCF711/dsh-GOkifu-compact', sessionId: 's2',
+        intervalSec: 120, enabled: false, observe: true, title: '联调会话',
+        lastPoll: iso(900000), lastDeferred: '仅观察：本轮本会唤醒 2 条（#4 #3）',
+        filters: { labels: [], ignoreLabels: [], skipBots: true, skipDrafts: true, skipClosed: true, onlyAssigned: false, assignee: null },
+        history: [], filteredLog: [],
+      },
+      {
+        id: 'a/b#s3', repo: 'someone/broken-repo', sessionId: 's3', intervalSec: 30, enabled: true,
+        title: '出错示例', lastPoll: iso(5000), lastError: 'gh: Not Found (HTTP 404)（仓库不存在或没权限：检查 owner/name）',
+        consecutiveFailures: 2, nextAt: new Date(now + 180000).toISOString(),
+        filters: { labels: [], ignoreLabels: [], skipBots: true, skipDrafts: true, skipClosed: true, onlyAssigned: false, assignee: null },
+        history: [], filteredLog: [],
+      },
+    ],
+  },
+}
+
+// ── 渲染：把元素树序列化成 HTML ───────────────────────────────────────────────
+function escapeHtml(text) {
+  return String(text).replace(/[&<>]/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;' }[c]))
+}
+function styleToCss(style) {
+  if (!style) return ''
+  return Object.entries(style).map(([k, v]) => {
+    const prop = k.startsWith('--') ? k : k.replace(/[A-Z]/g, (m) => '-' + m.toLowerCase())
+    return prop + ':' + v
+  }).join(';')
+}
+function attr(name, value) {
+  if (value === undefined || value === null || value === false || value === true) {
+    return value === true ? ' ' + name : ''
+  }
+  return ' ' + name + '="' + escapeHtml(value) + '"'
+}
+function render(node) {
+  if (node === null || node === undefined || node === false) return ''
+  if (typeof node === 'string' || typeof node === 'number') return escapeHtml(node)
+  if (Array.isArray(node)) return node.map(render).join('')
+  if (typeof node !== 'object') return ''
+  const { type, props = {} } = node
+  if (typeof type === 'function') return render(type(props))
+  if (type === React.Fragment) return (props.children || []).map(render).join('')
+  const voidTags = new Set(['input', 'img', 'br', 'hr', 'meta', 'link'])
+  const tag = String(type)
+  const parts = []
+  if (props.className) parts.push(attr('class', props.className))
+  if (props.style) parts.push(attr('style', styleToCss(props.style)))
+  for (const key of ['data-tone', 'data-state', 'data-open', 'role', 'title', 'aria-label', 'aria-selected', 'aria-pressed', 'aria-modal', 'type', 'placeholder', 'value', 'disabled']) {
+    if (props[key] !== undefined && props[key] !== false) parts.push(attr(key, props[key]))
+  }
+  if (keyIsVoid(tag)) return '<' + tag + parts.join('') + '>'
+  return '<' + tag + parts.join('') + '>' + (props.children || []).map(render).join('') + '</' + tag + '>'
+}
+function keyIsVoid(tag) {
+  return ['input', 'img', 'br', 'hr', 'meta', 'link'].includes(tag)
+}
+
+// 取移植来的 CSS
+const clientSrc = readFileSync(join(ROOT, 'client.js'), 'utf8')
+const marker = 'const PORTED_CSS = "'
+const head = clientSrc.indexOf(marker) + marker.length
+let i = head
+while (i < clientSrc.length && clientSrc[i] !== '"') i += clientSrc[i] === '\\' ? 2 : 1
+const PORTED_CSS = JSON.parse('"' + clientSrc.slice(head, i) + '"')
+
+const scenarios = [
+  { name: '总览', hooks: [snapshot, 'overview', null, { repo: '', intervalSec: '60', goal: '', labels: '', onlyAssigned: false, activeHours: '', isolated: false, workdir: '' }, '', '', false, null, null, {}, '', false] },
+  { name: '判定', hooks: [snapshot, 'judge', null, { repo: '', intervalSec: '60', goal: '', labels: '', onlyAssigned: false, activeHours: '', isolated: false, workdir: '' }, '', '', false, null, null, {}, '', false] },
+  { name: '触发', hooks: [snapshot, 'trigger', null, { repo: '', intervalSec: '60', goal: '', labels: '', onlyAssigned: false, activeHours: '', isolated: false, workdir: '' }, '', '', false, null, null, {}, '', false] },
+  { name: '设置', hooks: [snapshot, 'settings', null, { repo: '', intervalSec: '60', goal: '', labels: '', onlyAssigned: false, activeHours: '', isolated: false, workdir: '' }, '', '', false, null, null, {}, '', false] },
+  { name: 'Toast（保存成功）', hooks: [snapshot, 'overview', null, { repo: '', intervalSec: '60', goal: '', labels: '', onlyAssigned: false, activeHours: '', isolated: false, workdir: '' }, '', '', false, { id: 't1', text: '已保存：MYCF711/dsh-session-superagent', tone: 'info' }, null, {}, '', false] },
+  { name: 'Toast（错误）', hooks: [snapshot, 'overview', null, { repo: '', intervalSec: '60', goal: '', labels: '', onlyAssigned: false, activeHours: '', isolated: false, workdir: '' }, '', '', false, { id: 't2', text: '保存失败：gh: Not Found (HTTP 404)', tone: 'error' }, null, {}, '', false] },
+  { name: '术语表', hooks: [snapshot, 'overview', null, { repo: '', intervalSec: '60', goal: '', labels: '', onlyAssigned: false, activeHours: '', isolated: false, workdir: '' }, '', '', false, null, null, {}, '', true] },
+]
+
+const sections = scenarios.map((scenario) => {
+  hookQueue = scenario.hooks
+  hookIndex = 0
+  const tree = Desk({ sessionId: 'preview-session' })
+  return '<h2 class="preview-title">' + scenario.name + '</h2>\n<div class="preview-frame">' + render(tree) + '</div>'
+}).join('\n')
+
+// 极简 token 兜底：宿主里这些由 --dsw-alias-* 提供，预览里给一组浅色近似值
+const tokens = `:root{
+  --dsw-alias-label-primary:#1f2328; --dsw-alias-label-secondary:#59636e; --dsw-alias-label-tertiary:#818b98;
+  --dsw-alias-bg-layer-1:#ffffff; --dsw-alias-bg-layer-2:#f6f8fa; --dsw-alias-bg-layer-3:#eef1f4;
+  --dsw-alias-border-default:#d8dee4; --dsw-alias-border-muted:#e6eaef;
+  --dsw-alias-accent-primary:#0969da; --dsw-alias-success-500:#1a7f37; --dsw-alias-warning-500:#9a6700;
+  --dsw-alias-error-500:#cf222e; --dsw-static-neutral-bluish-00:#ffffff;
+  --dsw-shadow-lv3:0 8px 24px rgba(31,35,40,.12);
+  /* tag / 状态点真正引用的 token（官方 CSS 用 --dsw-alias-state-*） */
+  --dsw-alias-state-success-primary:#1a7f37; --dsw-alias-state-warn-primary:#9a6700;
+  --dsw-alias-state-error-primary:#cf222e; --dsw-alias-state-info-primary:#0969da;
+  --dsw-alias-toast-bg:#24292f;
+}`
+
+const html = `<!doctype html>
+<meta charset="utf-8">
+<title>主理鱼面板预览</title>
+<style>
+${tokens}
+body{font:14px/1.45 -apple-system,"Segoe UI",system-ui,sans-serif;background:#eef1f4;margin:0;padding:24px;color:#1f2328}
+.preview-title{margin:28px 0 8px;font-size:15px;color:#57606a}
+.preview-frame{width:900px;background:#fff;border:1px solid #d8dee4;border-radius:12px;min-height:120px;max-height:820px;overflow:auto}
+.dt-page{height:auto!important;max-height:none!important}
+${PORTED_CSS}
+</style>
+<div style="font:13px/1.5 system-ui;color:#57606a">
+  主理鱼面板静态预览 —— 真实 client.js 渲染出的 DOM + 移植的官方 CSS（宽度 900px，token 为浅色近似值）
+</div>
+${sections}
+`
+writeFileSync(OUT, html)
+console.log('已写出：' + OUT)
+console.log('字节：' + html.length)

package/scripts/sync-profile.mjs

@@ -1,17 +1,28 @@
 // 把插件源码目录同步到 profile 的安装副本。
 //
 // 为什么需要：profile 里是 `file:` 安装 —— pnpm 为**已存在的文件**建了硬链接，
-// 所以改内容会自动生效；但**新增文件不会**自动出现。
-// 真实事故（2026-11-01 23:59 重启）：新增的 lib/body.js 没进 profile，
-// 宿主 import './body.js' 失败 → 整个插件不挂载 → 工具和 HTTP 路由全消失，
-// 而客户端 bundle 照常加载，表面看起来"插件还在"。
+// 改内容会自动生效；但**新增文件不会**自动出现，而**被原子写入替换的文件会断链**。
 //
-// 用法： node scripts/sync-profile.mjs [profile 安装目录]
-import { existsSync, linkSync, mkdirSync, readFileSync, readdirSync, statSync } from 'node:fs'
+// 真实事故 1（2026-11-01 23:59 重启）：新增的 lib/body.js 没进 profile，
+//   宿主 import './body.js' 失败 → 整个插件不挂载 → 工具和 HTTP 路由全消失，
+//   客户端 bundle 却照常加载，表面看起来"插件还在"。
+// 真实事故 2（潜伏）：某些工具用「写临时文件再 rename」保存，profile 里那份仍是旧 inode，
+//   于是宿主跑的是旧代码，而仓库里看着已经是新代码。
+//
+// 用法：
+//   node scripts/sync-profile.mjs            补齐缺失文件（不动断链，只警告）
+//   node scripts/sync-profile.mjs --repair   断链也重建硬链接，并清理 profile 里的陈旧文件
+//   node scripts/sync-profile.mjs --check    只检查：有缺失/断链/陈旧就 exit 1（给 CI 用）
+//   node scripts/sync-profile.mjs --dir <path>  指定 profile 安装目录
+import { existsSync, linkSync, mkdirSync, readFileSync, readdirSync, statSync, unlinkSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 
 const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
+const args = process.argv.slice(2)
+const REPAIR = args.includes('--repair')
+const CHECK = args.includes('--check')
+const dirFlag = args.indexOf('--dir')
 const DEFAULT_PROFILE = join(
   process.env.DSH_HOME || join(process.env.USERPROFILE || '', '.dsh'),
   'profiles',
@@ -19,7 +30,7 @@ const DEFAULT_PROFILE = join(
   'node_modules',
   'dsh-session-superagent',
 )
-const DEST = process.argv[2] || DEFAULT_PROFILE
+const DEST = dirFlag >= 0 ? args[dirFlag + 1] : DEFAULT_PROFILE
 
 /** 运行时要用的文件（不含 docs / test / scripts 这些开发件）。 */
 const TARGETS = [
@@ -32,45 +43,87 @@ if (!existsSync(DEST)) {
   process.exit(1)
 }
 
+const drift = { missing: [], broken: [], stale: [] }
 let linked = 0
-let skipped = 0
+
 for (const rel of TARGETS) {
   const src = join(ROOT, rel)
   const dst = join(DEST, rel)
   if (!existsSync(src)) continue
-  if (existsSync(dst)) {
-    const same = statSync(src).ino === statSync(dst).ino
-    console.log((same ? 'ok       ' : '注意     ') + rel + (same ? '' : '（inode 不同，内容改动不会同步）'))
-    skipped += 1
+  if (!existsSync(dst)) {
+    drift.missing.push(rel)
+    if (!CHECK) {
+      mkdirSync(dirname(dst), { recursive: true })
+      try { linkSync(src, dst); linked += 1; console.log('linked   ' + rel) } catch (error) {
+        console.log('link 失败：' + rel + ' — ' + (error && error.message))
+      }
+    }
     continue
   }
-  mkdirSync(dirname(dst), { recursive: true })
-  try {
-    linkSync(src, dst)
-    linked += 1
-    console.log('linked   ' + rel)
-  } catch (error) {
-    console.log('link 失败：' + rel + ' — ' + (error && error.message))
+  const same = statSync(src).ino === statSync(dst).ino
+  if (same) continue
+  drift.broken.push(rel)
+  if (REPAIR && !CHECK) {
+    try {
+      unlinkSync(dst)
+      linkSync(src, dst)
+      linked += 1
+      console.log('relinked ' + rel + '（原来断了）')
+    } catch (error) {
+      console.log('重建失败：' + rel + ' — ' + (error && error.message))
+    }
+  } else {
+    console.log('注意     ' + rel + '（inode 不同：内容改动不会同步到 profile，用 --repair 重建）')
+  }
+}
+
+// 陈旧文件：profile 里有、仓库里已经没有（例如删掉的模块）
+for (const name of readdirSync(join(DEST, 'lib')).filter((f) => f.endsWith('.js'))) {
+  if (!existsSync(join(ROOT, 'lib', name))) {
+    drift.stale.push('lib/' + name)
+    if (REPAIR && !CHECK) {
+      try { unlinkSync(join(DEST, 'lib', name)); console.log('pruned   lib/' + name) } catch {}
+    } else {
+      console.log('陈旧     lib/' + name + '（仓库已删除，profile 里还在）')
+    }
   }
 }
 
-// lib/ 里每个相对 import 都必须能解析到真实文件（这次事故的直接原因）
+// lib/ 里每个相对 import 都必须能解析（这正是事故 1 的直接原因）
 const libDir = join(ROOT, 'lib')
-const missing = []
+const missingImports = []
 for (const name of readdirSync(libDir)) {
   if (!name.endsWith('.js')) continue
-  const file = join(libDir, name)
-  const code = readFileSync(file, 'utf8')
-  for (const m of code.matchAll(/from '(\.[^']+)'/g)) {
-    if (!existsSync(join(dirname(file), m[1]))) missing.push(name + ' → ' + m[1])
+  const code = readFileSync(join(libDir, name), 'utf8')
+  for (const line of code.split(String.fromCharCode(10))) {
+    const trimmed = line.trim()
+    if (!trimmed.startsWith('import ')) continue
+    const at = trimmed.lastIndexOf("from '")
+    let spec = null
+    if (at >= 0) {
+      spec = trimmed.slice(at + 6).split("'")[0]
+    } else if (trimmed.slice('import '.length).startsWith("'")) {
+      spec = trimmed.slice('import '.length + 1).split("'")[0]
+    }
+    if (spec && spec.startsWith('.') && !existsSync(join(libDir, spec))) {
+      missingImports.push(name + ' -> ' + spec)
+    }
   }
 }
 
+const drifted = drift.missing.length + drift.broken.length + drift.stale.length
 console.log('---')
-console.log(`新增链接 ${linked} 个，跳过 ${skipped} 个`)
 console.log(`目标：${DEST}`)
-if (missing.length > 0) {
-  console.error('相对 import 解析失败：' + missing.join(', '))
+console.log(`缺失 ${drift.missing.length} / 断链 ${drift.broken.length} / 陈旧 ${drift.stale.length}` +
+  (linked ? `，本次处理 ${linked} 个` : ''))
+
+if (missingImports.length > 0) {
+  console.error('相对 import 解析失败：' + missingImports.join(', '))
   process.exit(2)
 }
 console.log('相对 import 全部可解析 ✓')
+
+if (CHECK && drifted > 0) {
+  console.error('profile 与仓库不一致（跑 --repair 修）')
+  process.exit(1)
+}