@mingmaple/dsh-handover 0.9.22 → 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);

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（action="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,8 +15,19 @@ 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,      // 等会话空闲的上限（超过就放弃并回告）
@@ -20,10 +35,10 @@ export const DEFAULTS = {
   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/docmap.mjs

@@ -1,9 +1,6 @@
 /**
- * 文档定位 map（docmap）：每个会话（全局、每个项目、每个杂项任务）一份文件，写「本类别有哪些文档、各自一句话介绍、什么时候该读」。
- *
- * 定位：只指路，不规定读多少。是否读正文由被注入的会话自己判断；
- * 空 map 不注入，提示段其余文字一字不动。文件放在 _Control_Center/records/docmap/，
- * 随工作区迁移；写入者必须是在任会话（由 tools/ho_docmap.mjs 用在任登记表判定）。
+ * 旧版文档定位（docmap）解析：1.0 起只由迁移兼容模块 `legacy.mjs` 使用，用于把旧表并入体系注册。
+ * 新写入一律走 `system.mjs`；本模块不再参与提示段注入。
  */
 import fs from 'node:fs';
 import path from 'node:path';
@@ -81,7 +78,7 @@ export function renderDocmap(info, entries) {
   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('只指路：是否读正文由你判断，不要无目的通读。');
+  lines.push('只指路：是否读正文由会话判断，不得无目的通读。');
   return lines.join(NL) + NL;
 }
 
@@ -92,7 +89,7 @@ export function renderDocmap(info, entries) {
 export function docmapBlock(ws, info) {
   const map = readDocmap(ws, info);
   if (!map.entries.length) return '';
-  const lines = ['文档定位（' + lineageLabel(info) + '；只指路，是否读正文由你判断，不要无目的通读）'];
+  const lines = ['文档定位（' + lineageLabel(info) + '；只指路，是否读正文由会话判断，不得无目的通读）'];
   for (const e of map.entries) {
     lines.push('- ' + e.path + (e.about ? ' —— ' + e.about : '') + (e.when ? '（' + e.when + '）' : ''));
   }
@@ -103,7 +100,7 @@ export function docmapBlock(ws, info) {
 export function pathProblem(ws, p) {
   const raw = String(p || '').trim();
   if (!raw) return '路径为空';
-  if (/^[a-zA-Z]:/.test(raw) || raw.startsWith('/') || raw.startsWith('\\')) 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);

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,7 +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 { checkDocmaps } from './docmap.mjs';
+import { checkRegistries } from './system.mjs';
 
 /**
  * 读 Registry.md 的「形态」列 → { 项目名: 形态 }。
@@ -87,7 +87,7 @@ export function syncCheck(ws) {
     builtin = true;
   } else {
     return {
-      error: '这个实例还没接入工作区：读不到 ' + charter,
+      error: '本实例尚未接入工作区：读不到 ' + charter,
       path: charter,
       ok: false,
       noWorkspace: true,
@@ -95,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;
@@ -119,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) {
@@ -148,25 +148,25 @@ export function renderSyncCheck(res) {
   return out;
 }
 
-/** 文档定位 map：只检查表内路径是否仍然存在（不判字数、不判内容）。 */
+/** 体系注册：只检查表内路径是否仍然存在（不判字数、不判内容）。 */
 export function docmapReport(ws) {
-  return checkDocmaps(ws);
+  return checkRegistries(ws);
 }
 
 export function renderDocmapCheck(res) {
   const out = [];
-  out.push('文档定位 map  目录 ' + res.dir);
+  out.push('体系注册  任务 ' + res.rows.length + ' 个');
   if (!res.rows.length) {
-    out.push('  还没有任何 map（空 map 不注入提示段，属正常）');
+    out.push('  尚无任何任务注册（空注册不注入正文，属正常）');
     out.push('判定：无需检查');
     return out;
   }
   for (const r of res.rows) {
-    out.push('  ' + r.name + '  ' + r.label + '  ' + r.entries + ' 条  ' + (r.bad.length ? '失效 ' + r.bad.length + ' 条' : '路径全部存在'));
+    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") 更新。'));
+    : res.missing + ' 条路径失效，由该类别在任会话用 ho_docmap(action="write") 更新。'));
   return out;
 }

package/src/lib/global-task.mjs

@@ -0,0 +1,69 @@
+/**
+ * 全局任务库：`_Control_Center/tasks/<任务>/`。
+ * 全局可同时承担多个任务，每个任务有独立交接、体系注册与计划；任务可整体独立为项目或杂项会话。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { NL, readUtf8, isFile, isDir } from './text.mjs';
+import { assertTaskName } from './role.mjs';
+import { renderRegistry, syncGlobalRefs } from './system.mjs';
+
+const HANDOVER = [
+  '# 交接（全局任务）',
+  '',
+  '## 1. 正在做的事',
+  '',
+  '未开始；由全局会话在任务启动时补写。',
+  '',
+  '## 2. 下一步',
+  '',
+  '- 待定。',
+  '',
+].join(NL);
+
+function copyIf(src, dst) {
+  if (!isFile(src) || fs.existsSync(dst)) return false;
+  fs.mkdirSync(path.dirname(dst), { recursive: true });
+  fs.copyFileSync(src, dst);
+  return true;
+}
+
+/**
+ * 建立全局任务库：目录、交接、体系注册、规则与模板副本；随后重建全局总注册。
+ * @returns {{ dir: string, created: string[] }}
+ */
+export function createGlobalTask(ws, task) {
+  const name = String(task || '').trim();
+  assertTaskName(name);
+  const dir = path.join(String(ws || ''), '_Control_Center', 'tasks', name);
+  if (isDir(dir) && fs.readdirSync(dir).length) throw new Error('全局任务已存在且非空：' + dir);
+  fs.mkdirSync(path.join(dir, '_archive'), { recursive: true });
+  const created = [];
+  const files = [
+    ['Handover.md', HANDOVER],
+    ['System.md', renderRegistry({ role: 'global-task', task: name }, { structure: [], files: [], plan: '' })],
+  ];
+  for (const [rel, body] of files) {
+    const dst = path.join(dir, rel);
+    if (fs.existsSync(dst)) continue;
+    fs.writeFileSync(dst, body, 'utf8');
+    created.push(rel);
+  }
+  // 暂任规范与交接规范随任务库独立，避免暂任方跨库读取全局规则。
+  const rules = path.join(String(ws || ''), '_Control_Center', 'rules');
+  for (const rel of ['Delegation_Rules.md', 'Handover_Rules.md']) {
+    if (copyIf(path.join(rules, rel), path.join(dir, rel))) created.push(rel);
+  }
+  const tpl = path.join(String(ws || ''), '_Control_Center', 'templates');
+  for (const rel of ['Plan.skeleton.md', 'System.skeleton.md']) {
+    if (copyIf(path.join(tpl, rel), path.join(dir, rel))) created.push(rel);
+  }
+  syncGlobalRefs(ws);
+  return { dir, created };
+}
+
+/** 读全局任务交接正文（不存在返回空串）。 */
+export function readTaskHandover(ws, task) {
+  const file = path.join(String(ws || ''), '_Control_Center', 'tasks', String(task || ''), 'Handover.md');
+  try { return readUtf8(file); } catch { return ''; }
+}