@mingmaple/dsh-handover 0.9.14 → 1.0.0

package/src/lib/absrefs.mjs

@@ -99,7 +99,7 @@ export function renderAbsoluteRefs(res, opts) {
   if (!res.totalHits) {
     out.push('  未发现写死的本机绝对路径');
   } else {
-    out.push('  发现 ' + res.hits.length + ' 个文件里有 ' + res.totalHits + ' 处绝对路径（**插件不改写这些内容**）：');
+    out.push('  发现 ' + res.hits.length + ' 个文件中有 ' + res.totalHits + ' 处绝对路径（插件不改写这些内容）：');
     for (const h of res.hits.slice(0, o.max || 10)) {
       out.push('  ' + h.path);
       for (const it of h.items) out.push('      L' + it.line + ' [' + it.kind + '] ' + it.sample);

package/src/lib/api.mjs

@@ -5,6 +5,7 @@
  */
 import fs from 'node:fs';
 import path from 'node:path';
+import { pathKey } from './pathkey.mjs';
 import { isDir } from './text.mjs';
 import { buildStatus } from './status.mjs';
 import { createGlobalWorkspace } from './scaffold.mjs';
@@ -79,8 +80,12 @@ async function createGlobalSession(env, rootPath, title) {
   try {
     const reg = env.registry && env.registry();
     const list = reg && typeof reg.list === 'function' ? (reg.list() || []) : [];
-    const norm = (s) => String(s || '').replace(/\\/g, '/').replace(/\/+$/, '').toLowerCase();
-    const hit = list.find((w) => w && norm(w.path) === norm(rootPath));
+    const norm = (s) => pathKey(String(s || ''));
+    const same = (a, b) => {
+      if (norm(a) === norm(b)) return true;
+      try { return norm(fs.realpathSync(String(a))) === norm(fs.realpathSync(String(b))); } catch { return false; }
+    };
+    const hit = list.find((w) => w && same(w.path, rootPath));
     if (hit) workspaceId = String(hit.id || '');
   } catch { workspaceId = ''; }
   const made = await newSessionIn(env, {
@@ -157,7 +162,7 @@ export function createApi(env, info) {
         if (!st || !st.isDirectory()) return bad('bad-request', '目录不存在或不是目录：' + target);
         const reg = env.registry && env.registry();
         if (!reg || typeof reg.create !== 'function') {
-          return { ok: false, error: { code: 'no-registry', message: 'workspaceRegistry 不可用', details: { hint: '请手工把这个路径粘进 DSH 的新建工作区：' + target } }, http: 501 };
+          return { ok: false, error: { code: 'no-registry', message: 'workspaceRegistry 不可用', details: { hint: '请手工将该路径粘贴到 DSH 的新建工作区：' + target } }, http: 501 };
         }
         const title = String(p.title || '').trim() || target.split(/[\\/]/).filter(Boolean).pop() || target;
         try {
@@ -203,6 +208,7 @@ export function createApi(env, info) {
           project: p.project,
           task: p.task,
           wake: p.wake !== false,
+          migrate: p.migrate === 'direct' ? 'direct' : 'auto',
         });
         env.log('会话角色：' + (r.ok ? (r.role + ' · 存活=' + r.live + ' · 已投递=' + r.delivered) : ('失败 ' + r.error)));
         invalidateStatus(env);
@@ -218,21 +224,21 @@ export function createApi(env, info) {
       if (method === 'move.start') {
         const src = currentRoot(env);
         if (!src) return bad('no-workspace', '未找到全局根（工作区未接入）');
-        env.log('搬迁：开始复制 ' + src + ' → ' + String(p.to || ''));
+        env.log('迁移：开始复制 ' + src + ' → ' + String(p.to || ''));
         const startedAt = Date.now();
         const r = await startMove({ src, to: p.to });
-        env.log('搬迁：' + (r.ok ? '校验通过' : '校验有差异') + '，用时 ' + Math.round((Date.now() - startedAt) / 1000) + ' s');
+        env.log('迁移：' + (r.ok ? '校验通过' : '校验有差异') + '，用时 ' + Math.round((Date.now() - startedAt) / 1000) + ' s');
         return r.ok ? ok(r) : { ok: false, error: { code: 'verify-failed', message: '复制完成但校验有差异，未生成切换脚本', details: r.report }, http: 500 };
       }
 
       if (method === 'move.switch') {
         const r = stageSwitch({ relaunch: p.relaunch === true });
-        env.log('搬迁：后台切换助手 ' + (r.already ? '无需再派（已切换）' : '已派出 pid=' + r.pid));
+        env.log('迁移：后台切换助手 ' + (r.already ? '无需再派（已切换）' : '已派出 pid=' + r.pid));
         return ok(r);
       }
 
       if (method === 'move.status') {
-        // 一律以搬迁标记里的源路径为准：修改登记生效后当前工作区根已经变成新位置，
+        // 一律以迁移标记里的源路径为准：修改登记生效后当前工作区根已经变成新位置，
         // 再拿它去比对会把「已经是新位置」误报成「还指着旧路径」。
         return ok(moveStatus());
       }
@@ -242,6 +248,8 @@ export function createApi(env, info) {
         if (!sid) return bad('bad-request', '缺少 session_id');
         const kind = p.kind === 'succeed' ? 'succeed' : 'compact';
         const g = grantConsent(sid, kind === 'succeed' ? '设置页点击换任' : '设置页点击', kind);
+        // 授权一到就重装目标会话的提示段：空闲会话下一轮即可看见，不必等它自己去查。
+        if (typeof env.refreshPromptFor === 'function') { try { env.refreshPromptFor(sid); } catch { /* ignore */ } }
         env.log((kind === 'succeed' ? '换任' : '压缩') + '授权：' + sid + '（5 分钟）');
         invalidateStatus(env);
         return ok(g);
@@ -265,20 +273,20 @@ export function createApi(env, info) {
 
       if (method === 'move.retarget-stage') {
         const r = stageRetarget();
-        env.log('搬迁：登记修改登记助手 ' + (r.already ? '无需（已在新位置）' : '已派出 pid=' + r.pid));
+        env.log('迁移：登记修改登记助手 ' + (r.already ? '无需（已在新位置）' : '已派出 pid=' + r.pid));
         return ok(r);
       }
 
       if (method === 'move.repair') {
         const r = repairLink();
-        env.log('搬迁：重建链接 ' + (r.already ? '已存在' : r.src + ' → ' + r.dst));
+        env.log('迁移：重建链接 ' + (r.already ? '已存在' : r.src + ' → ' + r.dst));
         invalidateStatus(env);
         return ok(r);
       }
 
       if (method === 'move.cleanup') {
         const r = await cleanupOld({ confirm: p.confirm === true });
-        env.log('搬迁：清理旧副本 ' + (r.removed || []).length + ' 个');
+        env.log('迁移：清理旧备份 ' + (r.removed || []).length + ' 个');
         return ok(r);
       }
 

package/src/lib/archive.mjs

@@ -188,7 +188,7 @@ export function extractTarGz(file, destDir) {
       dirs++;
       return;
     }
-    if (e.type === '1' || e.type === '2') { skipped.push('链接条目不解：' + rel); return; }
+    if (e.type === '1' || e.type === '2') { skipped.push('链接条目不处理：' + rel); return; }
     if (e.type !== '0' && e.type !== '') { skipped.push('未知条目类型 ' + e.type + '：' + rel); return; }
     fs.mkdirSync(path.dirname(dest), { recursive: true });
     fs.writeFileSync(dest, e.body);

package/src/lib/brief.mjs

@@ -41,13 +41,15 @@ export function composeBrief(input) {
     out.push('水位   无法读取，需人工判断');
   } else {
     const pct = (input.selfUsed / input.selfWin) * 100;
-    const warn = cfg.warnRatio === undefined ? 0.32 : cfg.warnRatio;
-    out.push("水位   " + pct.toFixed(1) + "%（" + thousands(input.selfUsed) + " / " + thousands(input.selfWin) + "）→ " + (pct >= warn * 100 ? "已过阈值，该写交接" : "可继续"));
+    const r1 = (cfg.remindRatio === undefined ? 0.35 : cfg.remindRatio) * 100;
+    const r2 = (cfg.remind2Ratio === undefined ? 0.5 : cfg.remind2Ratio) * 100;
+    const tail = pct >= r2 ? '已过 50% 档，完成当前小步骤后停止' : pct >= r1 ? '已过 35% 档，应收束并刷新交接' : '可继续';
+    out.push("水位   " + pct.toFixed(1) + "%（" + thousands(input.selfUsed) + " / " + thousands(input.selfWin) + "）→ " + tail);
   }
   const gate = input.gate;
   if (!gate || gate.error) {
     out.push('闸门   ' + (gate && gate.error ? gate.error : '读不到') + ' · 退出码 ? · ?');
-    if (gate && gate.noWorkspace) out.push('       首次安装？把工作区接入即可：ho_workspace(action="create", path="<绝对目录>", title="全局")，再开一个标题含「全局」的会话。');
+    if (gate && gate.noWorkspace) out.push('       尚未接入工作区：用 ho_workspace(action="create", path="<绝对目录>", title="全局") 接入，再新建一个标题含「全局」的会话。');
   } else {
     out.push("闸门   " + gate.total + " 库 · 正文 " + gate.bodyLines + " 行 · 退出码 " + (gate.ok ? 0 : 10) + " · 判定：" + gate.verdict);
   }
@@ -58,8 +60,8 @@ export function composeBrief(input) {
     const notifProjects = new Set(scan.notify.map((r) => r.project));
     const skipProjects = new Set(scan.skip.map((r) => r.project));
     out.push("活跃   " + notifProjects.size + " 个项目，需要通知 " + scan.notify.length + " 个会话：" + (scan.notify.length ? scan.notify.map((r) => r.project + "(" + sidShort(r.sid) + ",在任)").join("、") : "无"));
-    out.push("沉默   " + skipProjects.size + " 个项目，跳过 " + scan.skip.length + " 个会话（不唤醒，省 token）");
-    if (scan.hot.length) out.push("预警   " + scan.hot.length + " 个会话已进预警区（≥" + Math.round(scan.warn) + "%）—— 全为退场、前任则可忽略");
+    out.push("沉默   " + skipProjects.size + " 个项目，跳过 " + scan.skip.length + " 个会话（不唤醒，以节省 token）");
+    if (scan.hot.length) out.push("预警   " + scan.hot.length + " 个会话已过 35% 线，全为已交出的旧会话时可忽略");
   }
   if (input.drift) {
     out.push('Δ交接  ' + driftVerdict(input.drift));
@@ -69,6 +71,6 @@ export function composeBrief(input) {
     out.push('Δ交接  读不到（会话日志不可用）');
   }
   if (input.advice && input.advice.text) out.push('阶段   ' + input.advice.text);
-  out.push('提示   ' + (input.ok ? '按「活跃」名单逐个 peer_send 广播本会话 id 并记回 §3；可正常开始作业' : '本会话已过阈值或闸门异常，应先收齐交接，再开展新任务'));
+  out.push('提示   ' + (input.ok ? '按「活跃」名单逐个用 peer（action="send"）广播本会话 id，并记回 §3；可正常开始作业' : '本会话已过 35% 线或闸门异常，应先收齐交接，再开展新任务'));
   return out;
 }

package/src/lib/config.mjs

@@ -1,8 +1,12 @@
 /** dsh-handover 配置：全部可被 profile patch 的 config 覆盖。 */
 export const DEFAULTS = {
   workspaceRoot: '',            // 留空则从会话 cwd 推导（向上找 _Control_Center 目录）
-  warnRatio: 0.32,
-  handoverRatio: 0.35,
+  remindRatio: 0.35,            // 35% 一次性后台提醒（不再设 32% 提醒线）
+  remind2Ratio: 0.50,           // 50% 一次性后台提醒
+  margin1: 0.45,                // 35% 档判断余量：完成剩余流程后不超过 45%
+  margin2: 0.55,                // 50% 档判断余量：完成剩余流程后不超过 55%
+  pureWindowRatio: 0.40,        // 纯窗口线：繁重任务预计超过 40% 时引入子智能体
+  handoverRatio: 0.35,          // 35% 后可压缩；更早仅助手建议或用户主动并授权
   hardRatio: 0.85,
   maxCompactions: 3,
   autoResume: true,
@@ -11,19 +15,30 @@ export const DEFAULTS = {
   rolesPath: '',           // 留空 = ~/.dsh/storages/dsh-handover.roles.json
   // 续跑提示：{n} {max} {handover} {role} 会被替换成真值；{handover} 是本会话自己的交接绝对路径。
   // 只在助手登记压缩时选 resume=continue（默认）才投递；resume=wait 表示已收尾，不唤醒。
-  resumePrompt: '【dsh-handover 自动续跑·第 {n}/{max} 次压缩】压缩已完成，历史已被摘要替换。第一步：ho_handover(action=read) 取回本会话的交接（{handover}）；然后按 §2「下一步」继续（若 §2 已无待办，向用户一句话收尾并停止）。不要复述交接内容，不要重做已完成的事。完整流程：ho_charter(doc="runtime")。',
-  resumePromptUnknown: '【dsh-handover 自动续跑·第 {n}/{max} 次压缩】压缩已完成，历史已被摘要替换。本会话是普通会话，不参与交接；如需继续，请由全局会话为其指定角色。',
+  resumePrompt: [
+    '【dsh-handover 自动续跑·第 {n}/{max} 次压缩】压缩已完成，历史已由摘要替换。',
+    '按以下顺序执行：',
+    '一、调用 ho_handover(action=read)，取回本会话交接（{handover}）。',
+    '二、调用 ho_docmap(action="plan", mode="read")，读取行动计划；未建立计划时跳过本步。',
+    '三、按交接 §2 与行动计划继续执行；§2 无待办时，向当前用户作一句总结后收尾并停止。',
+    '约束：不复述交接内容；不重做已完成事项。',
+    '完整流程：ho_charter(doc="runtime")。',
+  ].join(String.fromCharCode(10)),
+  resumePromptUnknown: [
+    '【dsh-handover 自动续跑·第 {n}/{max} 次压缩】压缩已完成，历史已由摘要替换。',
+    '本会话为普通会话，不参与交接；如需继续，由全局会话为其指定角色。',
+  ].join(String.fromCharCode(10)),
   compactTimeoutMs: 120000,
   compactAttempts: 3,
   waitIdleMs: 180000,      // 等会话空闲的上限（超过就放弃并回告）
   driftSlack: 3,           // Δ交接容忍轮数（超过即需刷交接）
-  wakeAuthority: 'on',     // 会话守卫硬拦：on / off（off＝连 peer_new 也不拦）
-  directPeer: 'on',        // 会话之间直接 peer_send：on 允许（不经全局转述）；off 退回「只能向全局报告」的旧口径
+  wakeAuthority: 'on',     // 会话守卫硬拦：on / off（off＝连 peer 的 new 动作也不拦）
+  directPeer: 'on',        // 会话之间直接 peer（action="send"）：on 允许（不经全局转述）；off 退回「只能向全局报告」的旧口径
   roleGating: 'on',        // 按角色裁剪工具与提示段：on / off（off＝所有会话都看得见全部工具）
-  reuseCheck: true,        // 建新会话前查在任会话水位（低于 warnRatio 拒绝）
+  reuseCheck: true,        // 建新会话前查在任会话水位（低于 handoverRatio 拒绝，建议复用）
   prepackMinAgeMin: 90,    // 打包前要求会话静止分钟数
   packFormat: 'auto',      // 归档格式：auto（有 7-Zip 用 7z，否则内置 tar.gz）、7z、tar
-  sevenZipPath: '',        // 留空则自动探测 C:\Program Files\7-Zip\7z.exe
+  sevenZipPath: '',        // 留空则自动探测：常见安装位置（Windows、macOS、Linux）与 PATH 上的 7z
 };
 
 export function resolveConfig(raw) {

package/src/lib/consent.mjs

@@ -96,7 +96,7 @@ export function checkConsent(sessionId, kind) {
     return {
       ok: false,
       kind: k,
-      reason: k === 'succeed' ? '用户还没有授权换任（聊天页命令 /allow-succeed）' : '用户还没有在设置页点「允许压缩」',
+      reason: k === 'succeed' ? '当前用户还没有授权换任（聊天页命令 /allow-succeed）' : '当前用户还没有在设置页点击「授权压缩」',
     };
   }
   return { ok: true, kind: k, until: hit.until, leftMs: hit.until - now, atText: hit.atText || '' };
@@ -121,3 +121,56 @@ export function listConsent() {
   })).filter((r) => r.leftMs > 0);
   return rows.sort((a, b) => a.sessionId.localeCompare(b.sessionId, 'zh') || a.kind.localeCompare(b.kind));
 }
+
+/**
+ * 某会话当前有效的授权（只读，不清过期条目）。
+ * 提示段与 ho_status 共用：授权一旦写入，下一轮重建提示段时就能看见；过期自然消失。
+ */
+export function activeConsentsFor(sessionId) {
+  const sid = String(sessionId || '');
+  if (!sid) return [];
+  const all = readAll();
+  const now = Date.now();
+  const rows = [];
+  for (const key of Object.keys(all)) {
+    const entry = all[key];
+    if (!entry || !entry.until || entry.until <= now) continue;
+    if (sidOfKey(key) !== sid) continue;
+    rows.push({
+      kind: kindOfEntry(key, entry),
+      until: entry.until,
+      leftMs: entry.until - now,
+      atText: entry.atText || '',
+      note: entry.note || '',
+    });
+  }
+  return rows.sort((a, b) => a.kind.localeCompare(b.kind));
+}
+
+const KIND_LABEL = { compact: '压缩', succeed: '换任' };
+
+function untilText(ms) {
+  const d = new Date(ms);
+  const off = -d.getTimezoneOffset();
+  const pad = (n) => String(n).padStart(2, '0');
+  const a = Math.abs(off);
+  return d.getFullYear() + '-' + pad(d.getMonth() + 1) + '-' + pad(d.getDate()) + ' '
+    + pad(d.getHours()) + ':' + pad(d.getMinutes()) + ' ' + (off >= 0 ? '+' : '-') + pad(Math.floor(a / 60)) + pad(a % 60);
+}
+
+/** 提示段用：每种有效授权一行，极短；无授权返回空数组（不占位）。 */
+export function consentPromptLines(rows) {
+  return (rows || []).map((r) => '当前用户已授权' + KIND_LABEL[r.kind] + '，至 ' + untilText(r.until) + '（一次性，用后失效）。');
+}
+
+/** ho_status 用：一行状态，压缩与换任各说一句，未授权的写「无授权」。 */
+export function formatConsentLine(rows) {
+  const hit = new Map((rows || []).map((r) => [r.kind, r]));
+  const parts = CONSENT_KINDS.map((k) => {
+    const r = hit.get(k);
+    if (!r) return KIND_LABEL[k] + ' 无授权';
+    const min = Math.max(1, Math.ceil(r.leftMs / 60000));
+    return KIND_LABEL[k] + ' 剩余 ' + min + ' 分钟（至 ' + untilText(r.until) + '，一次性）';
+  });
+  return parts.join('；');
+}

package/src/lib/docmap.mjs

@@ -0,0 +1,140 @@
+/**
+ * 旧版文档定位（docmap）解析：1.0 起只由迁移兼容模块 `legacy.mjs` 使用，用于把旧表并入体系注册。
+ * 新写入一律走 `system.mjs`；本模块不再参与提示段注入。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { NL, readUtf8, isFile, isDir } from './text.mjs';
+
+export const DOCMAP_DIR = path.join('_Control_Center', 'records', 'docmap');
+export const COLUMNS = ['路径', '一句话介绍', '何时读'];
+
+/** 由会话角色推导所属的登记（全局／项目／杂项）；普通会话没有 map。 */
+export function lineageOf(info) {
+  const role = info && info.role ? info.role : '';
+  if (role === 'global') return { kind: 'global', project: '', task: '', key: '全局' };
+  if (role === 'project' && info.project) return { kind: 'project', project: String(info.project), task: '', key: String(info.project) };
+  if (role === 'misc' && info.task) return { kind: 'misc', project: '', task: String(info.task), key: String(info.task) };
+  return null;
+}
+
+export function lineageLabel(info) {
+  const lin = lineageOf(info);
+  if (!lin) return '';
+  if (lin.kind === 'project') return '项目「' + lin.project + '」';
+  if (lin.kind === 'misc') return '杂项任务「' + lin.task + '」';
+  return '全局';
+}
+
+/** 文件名：global.md / project-<项目名>.md / misc-<任务名>.md（相对工作区根）。 */
+export function docmapRelPath(info) {
+  const lin = lineageOf(info);
+  if (!lin) return null;
+  const stem = lin.kind === 'global' ? 'global' : lin.kind === 'project' ? 'project-' + lin.project : 'misc-' + lin.task;
+  return path.join(DOCMAP_DIR, stem + '.md');
+}
+
+export function docmapAbsPath(ws, info) {
+  const rel = docmapRelPath(info);
+  return rel ? path.join(String(ws || ''), rel) : null;
+}
+
+function stripTicks(s) {
+  return String(s || '').replace(/`/g, '').trim();
+}
+
+/** 解析表格行：跳过表头与分隔行；三列之外的多余列合并进第三列。 */
+export function parseDocmap(text) {
+  const entries = [];
+  for (const raw of String(text || '').split(/\r?\n/)) {
+    const line = raw.trim();
+    if (!line.startsWith('|')) continue;
+    const cells = line.replace(/^\|/, '').replace(/\|$/, '').split('|').map((c) => stripTicks(c));
+    if (!cells.length) continue;
+    if (cells.length < 2) continue;
+    if (cells[0] === COLUMNS[0]) continue;                 // 表头
+    if (cells.every((c) => /^[-:\s]*$/.test(c))) continue;  // 分隔行
+    const p = cells[0];
+    if (!p) continue;
+    const about = cells[1] || '';
+    const when = cells.length > 3 ? cells.slice(2).join('，') : (cells[2] || '');
+    entries.push({ path: p, about, when });
+  }
+  return entries;
+}
+
+export function readDocmap(ws, info) {
+  const file = docmapAbsPath(ws, info);
+  if (!file) return { file: null, exists: false, entries: [] };
+  if (!isFile(file)) return { file, exists: false, entries: [] };
+  let text = '';
+  try { text = readUtf8(file); } catch { return { file, exists: true, entries: [], error: '读取失败' }; }
+  return { file, exists: true, entries: parseDocmap(text) };
+}
+
+/** 渲染文件正文（写盘用）：标题一行、表格、一句判定。 */
+export function renderDocmap(info, entries) {
+  const label = lineageLabel(info);
+  const lines = ['# 文档定位（' + label + '）', '', '| ' + COLUMNS.join(' | ') + ' |', '|' + COLUMNS.map(() => '---').join('|') + '|'];
+  for (const e of entries) lines.push('| `' + e.path + '` | ' + e.about + ' | ' + (e.when || '') + ' |');
+  lines.push('');
+  lines.push('只指路：是否读正文由会话判断，不得无目的通读。');
+  return lines.join(NL) + NL;
+}
+
+/**
+ * 注入提示段的文本：空 map 返回空串（不占位）。
+ * 形如「文档定位（项目「X」；只指路…）」＋ 每条一行，路径加反引号。
+ */
+export function docmapBlock(ws, info) {
+  const map = readDocmap(ws, info);
+  if (!map.entries.length) return '';
+  const lines = ['文档定位（' + lineageLabel(info) + '；只指路，是否读正文由会话判断，不得无目的通读）'];
+  for (const e of map.entries) {
+    lines.push('- ' + e.path + (e.about ? ' —— ' + e.about : '') + (e.when ? '（' + e.when + '）' : ''));
+  }
+  return lines.join(NL);
+}
+
+/** 路径是否合法且存在：只收工作区相对路径，不得越出工作区。 */
+export function pathProblem(ws, p) {
+  const raw = String(p || '').trim();
+  if (!raw) return '路径为空';
+  if (/^[a-zA-Z]:/.test(raw) || raw.startsWith('/') || raw.startsWith('\\')) return '须写工作区相对路径，不得写绝对路径';
+  const norm = path.normalize(raw).replace(/\\/g, '/');
+  if (norm === '..' || norm.startsWith('../')) return '不得指向工作区之外';
+  const abs = path.join(String(ws || ''), norm);
+  if (!isFile(abs) && !isDir(abs)) return '不存在：' + norm;
+  return '';
+}
+
+/** 逐条校验：返回 [{ path, problem }]。 */
+export function validateEntries(ws, entries) {
+  const bad = [];
+  for (const e of entries) {
+    const problem = pathProblem(ws, e.path);
+    if (problem) bad.push({ path: e.path, problem });
+  }
+  return bad;
+}
+
+/** 闸门用：检查所有 map 的路径存在性（只判存在，不判字数）。 */
+export function checkDocmaps(ws) {
+  const dir = path.join(String(ws || ''), DOCMAP_DIR);
+  const rows = [];
+  let files = [];
+  try { files = fs.readdirSync(dir).filter((f) => f.endsWith('.md')).sort(); } catch { return { dir, rows, missing: 0 }; }
+  for (const name of files) {
+    const file = path.join(dir, name);
+    const stem = name.slice(0, -3);
+    let info = null;
+    if (stem === 'global') info = { role: 'global' };
+    else if (stem.startsWith('project-')) info = { role: 'project', project: stem.slice(8) };
+    else if (stem.startsWith('misc-')) info = { role: 'misc', task: stem.slice(5) };
+    let entries = [];
+    try { entries = parseDocmap(readUtf8(file)); } catch { entries = []; }
+    const bad = validateEntries(ws, entries);
+    rows.push({ name, label: info ? lineageLabel(info) : '（文件名不符合规范）', entries: entries.length, bad });
+  }
+  return { dir, rows, missing: rows.reduce((a, r) => a + r.bad.length, 0) };
+}

package/src/lib/drift.mjs

@@ -61,5 +61,5 @@ export function computeDrift(opts) {
 export function driftVerdict(res) {
   return '判定：' + res.fresh + ' 个已最新、' + res.need + ' 个需刷交接' +
     (res.unknown ? '、' + res.unknown + ' 个需人工确认' : '') +
-    (res.need || res.unknown ? '；先让需刷的会话写交接，再搬' : '；可以直接搬');
+    (res.need || res.unknown ? '；先令需刷交接的会话写交接，再迁移' : '；可直接迁移');
 }

package/src/lib/events.mjs

@@ -85,5 +85,5 @@ export function stalePressureNote(sessionId) {
   if (!st.lastSummaryMs) return '';
   const m = projCacheMtimeOf(sessionId);
   if (m === null || m >= st.lastSummaryMs) return '';
-  return '（压缩刚完成，投影缓存尚未刷新，水位读数滞后一轮；下一次请求后自动正常）';
+  return '（压缩刚完成，投影缓存尚未刷新，水位读数滞后一轮；下一次请求后恢复正常）';
 }

package/src/lib/facts.mjs

@@ -5,7 +5,7 @@
  */
 import { DEFAULTS } from './config.mjs';
 
-/** 比例转百分比文本：0.32 → "32%"。 */
+/** 比例转百分比文本：0.35 → "35%"。 */
 function pctOf(ratio) {
   const n = Math.round(Number(ratio) * 1000) / 10;
   return (Number.isInteger(n) ? String(n) : n.toFixed(1)) + '%';
@@ -14,24 +14,31 @@ function pctOf(ratio) {
 /** 水位与压缩口径：全部由配置推导。 */
 export function watermark(cfg) {
   const c = cfg || DEFAULTS;
-  const warn = pctOf(c.warnRatio !== undefined ? c.warnRatio : DEFAULTS.warnRatio);
-  const handover = pctOf(c.handoverRatio !== undefined ? c.handoverRatio : DEFAULTS.handoverRatio);
-  const hard = pctOf(c.hardRatio !== undefined ? c.hardRatio : DEFAULTS.hardRatio);
-  const max = c.maxCompactions !== undefined ? c.maxCompactions : DEFAULTS.maxCompactions;
-  return { warn, handover, hard, max, warnValue: Math.round((c.warnRatio !== undefined ? c.warnRatio : DEFAULTS.warnRatio) * 100) };
+  const pick = (k) => (c[k] !== undefined ? c[k] : DEFAULTS[k]);
+  const remind = pctOf(pick('remindRatio'));
+  const remind2 = pctOf(pick('remind2Ratio'));
+  const handover = pctOf(pick('handoverRatio'));
+  const hard = pctOf(pick('hardRatio'));
+  const max = pick('maxCompactions');
+  return {
+    remind, remind2, handover, hard, max,
+    remindValue: Math.round(pick('remindRatio') * 100),
+    remind2Value: Math.round(pick('remind2Ratio') * 100),
+    reuseValue: Math.round(pick('handoverRatio') * 100),
+  };
 }
 
 /** 一句式交接规则（全局与项目提示段共用）。 */
 export function handoverRuleText(cfg) {
   const w = watermark(cfg);
-  return '水位 ' + w.warn + ' 提醒，' + w.handover + ' 交接线，' + w.hard + ' 硬上限；至多压缩 '
+  return w.handover + ' 后可压缩，' + w.hard + ' 为硬上限；至多压缩 '
     + w.max + ' 次，第 ' + (w.max + 1) + ' 次换任。';
 }
 
 /** 设置页使用说明里的紧写形式。 */
 export function compactSummaryText(cfg) {
   const w = watermark(cfg);
-  return w.warn + ' 提醒、' + w.handover + ' 交接线、' + w.hard + ' 硬上限；同一会话最多压缩 ' + w.max + ' 次';
+  return w.remind + ' 与 ' + w.remind2 + ' 各提醒一次，' + w.handover + ' 后可压缩，' + w.hard + ' 硬上限；同一会话最多压缩 ' + w.max + ' 次';
 }
 
 /** 提示段与工具描述的加权 token 估算：CJK 与全角标点每字符 1 token，其余每 4 字符 1 token。 */
@@ -63,9 +70,9 @@ function isWide(cp) {
  * 提示词效果优先于字数，实测值超出参考值时如实展示即可。
  */
 export const TOKEN_BUDGET = {
-  globalTokens: 320,
-  globalWorstTokens: 360,
-  projectTokens: 300,
-  projectWorstTokens: 340,
+  globalTokens: 900,
+  globalWorstTokens: 1000,
+  projectTokens: 800,
+  projectWorstTokens: 900,
   toolDescTokens: 70,
 };

package/src/lib/gates.mjs

@@ -4,6 +4,7 @@ import { readUtf8, isFile, isDir } from './text.mjs';
 import fs from 'node:fs';
 import { charterPath, canonicalBlock, TITLE_KEY, WATER_KEY } from './charter.mjs';
 import { readProfile, listProfiles } from './profile.mjs';
+import { checkRegistries } from './system.mjs';
 
 /**
  * 读 Registry.md 的「形态」列 → { 项目名: 形态 }。
@@ -61,7 +62,6 @@ function libraryRoots(ws) {
   return out;
 }
 
-/** 同步复核：返回 { libraries, total, missing, verdict, ok }。 */
 /** 插件内置的 Charter 骨架（dist/templates/Charter.skeleton.md）；工作区那份只是覆盖。 */
 function bundledCharter() {
   try {
@@ -72,6 +72,7 @@ function bundledCharter() {
   }
 }
 
+/** 同步复核：返回 { libraries, total, missing, verdict, ok }。 */
 export function syncCheck(ws) {
   const charter = charterPath(ws);
   // 口径：**插件自带的这套默认规则才是本体**，工作区里的同名文件是「本地化覆盖」。
@@ -86,7 +87,7 @@ export function syncCheck(ws) {
     builtin = true;
   } else {
     return {
-      error: '这个实例还没接入工作区：读不到 ' + charter,
+      error: '本实例尚未接入工作区：读不到 ' + charter,
       path: charter,
       ok: false,
       noWorkspace: true,
@@ -94,7 +95,7 @@ export function syncCheck(ws) {
   }
   const blk = canonicalBlock(text);
   if (!blk || !blk.body || blk.body.length === 0) {
-    return { error: '无法获取 §8.1.1.4 的正文（结构可能变了）', path: charter, ok: false };
+    return { error: '无法取得 §8.1.1.4 的正文（结构可能已变更）', path: charter, ok: false };
   }
   const rows = [];
   let bad = 0;
@@ -118,19 +119,19 @@ export function syncCheck(ws) {
     verdict: bad === 0
 
       ? "全部落位。"
-      : bad + ' 个库有缺 —— 向对应项目会话派发（由它自己写进本库 RULES.md，全局不得改项目库内文件）。',
+      : bad + ' 个库有缺，向对应项目会话派发（由该会话写进本库 RULES.md；全局不得修改项目库内文件）。',
   };
 }
 
 export function renderSyncCheck(res) {
   const out = [];
   if (res.error) { out.push(res.error + '：' + res.path); return out; }
-  out.push('通用约束条同步复核  库数 ' + res.total + '  正文 ' + res.bodyLines + ' 行  来源 §8.1.1.4' + (res.builtin ? '（工作区没有 Workspace_Charter.md，用插件内置口径）' : ''));
+  out.push('通用约束条同步复核  库数 ' + res.total + '  正文 ' + res.bodyLines + ' 行  来源 §8.1.1.4' + (res.builtin ? '（工作区无 Workspace_Charter.md，采用插件内置口径）' : ''));
   for (const r of res.libraries) {
     const flag = r.ok ? '通过' : '未通过';
     out.push('  ' + r.name + '  标题 ' + (r.titleOk ? '通过' : '缺') + '  正文 ' + (r.total - r.missing.length) + '/' + r.total +
       '  水位自查 ' + (r.waterOk ? '通过' : '缺') + '  ' + flag);
-    for (const m of r.missing.slice(0, 3)) out.push("        缺: " + m.slice(0, 70));
+    for (const m of r.missing.slice(0, 3)) out.push("        缺：" + m.slice(0, 70));
   }
   const ps = res.profiles || [];
   if (ps.length) {
@@ -145,4 +146,27 @@ export function renderSyncCheck(res) {
   out.push('');
   out.push('判定：' + res.verdict);
   return out;
+}
+
+/** 体系注册：只检查表内路径是否仍然存在（不判字数、不判内容）。 */
+export function docmapReport(ws) {
+  return checkRegistries(ws);
+}
+
+export function renderDocmapCheck(res) {
+  const out = [];
+  out.push('体系注册  任务 ' + res.rows.length + ' 个');
+  if (!res.rows.length) {
+    out.push('  尚无任何任务注册（空注册不注入正文，属正常）');
+    out.push('判定：无需检查');
+    return out;
+  }
+  for (const r of res.rows) {
+    out.push('  ' + r.label + '  ' + r.rel + '  ' + (r.exists ? r.entries + ' 条' : '未设置') + '  ' + (r.bad.length ? '失效 ' + r.bad.length + ' 条' : '路径全部存在'));
+    for (const b of r.bad.slice(0, 3)) out.push('        失效：' + b.path + ' —— ' + b.problem);
+  }
+  out.push('判定：' + (res.missing === 0
+    ? '全部落位。'
+    : res.missing + ' 条路径失效，由该类别在任会话用 ho_docmap(action="write") 更新。'));
+  return out;
 }