@mingmaple/dsh-handover 0.9.22 → 1.0.0

package/src/lib/legacy.mjs

@@ -0,0 +1,89 @@
+/**
+ * 迁移兼容模块（1.0）：把旧版文档定位（docmap）并入体系注册。
+ *
+ * 本模块可整体删除：删除后不影响 1.0 的主实现；用户应先升级到 1.0.0 完成迁移，再升级后续版本。
+ * 迁移不删除旧文件：旧目录整体移入 _Archives/_Global/Backups/ 下并带时间标注。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { NL, readUtf8, isFile, isDir } from './text.mjs';
+import { planRelPath } from './system.mjs';
+import { parseDocmap } from './docmap.mjs';
+
+export const LEGACY_DIR = path.join('_Control_Center', 'records', 'docmap');
+
+function stamp() {
+  const d = new Date();
+  const p = (n) => String(n).padStart(2, '0');
+  return d.getFullYear() + p(d.getMonth() + 1) + p(d.getDate()) + '_' + p(d.getHours()) + p(d.getMinutes()) + p(d.getSeconds());
+}
+
+/** 旧目录是否存在且含 .md 文件。 */
+export function legacyInfo(ws) {
+  const dir = path.join(String(ws || ''), LEGACY_DIR);
+  let files = [];
+  try { files = fs.readdirSync(dir).filter((f) => f.endsWith('.md')); } catch { return { dir, exists: false, files: [] }; }
+  return { dir, exists: files.length > 0, files };
+}
+
+function taskInfoFromStem(stem) {
+  if (stem.indexOf('project-') === 0) return { role: 'project', project: stem.slice(8) };
+  if (stem.indexOf('misc-') === 0) return { role: 'misc', task: stem.slice(5) };
+  return null;
+}
+
+function renderSystem(info, rows, plan) {
+  const label = info.role === 'project' ? '项目「' + info.project + '」' : '杂项任务「' + info.task + '」';
+  const lines = ['# 体系注册（' + label + '）', '', '## 目录结构', '', '| 路径 | 用途 |', '|---|---|', '', '## 规范文件', '', '| 路径 | 用途 | 何时读 |', '|---|---|---|'];
+  for (const r of rows) lines.push('| `' + r.path + '` | ' + r.about + ' | ' + (r.when || '') + ' |');
+  lines.push('', '## 计划', '');
+  if (plan) lines.push('- `' + plan + '`：当前行动计划');
+  lines.push('', '本文件由 1.0 迁移从旧文档定位转换而来；后续由本任务在任会话用 ho_docmap 维护。');
+  return lines.join(NL) + NL;
+}
+
+function writeIfAbsent(file, body) {
+  if (isFile(file)) return false;
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  fs.writeFileSync(file, body, 'utf8');
+  return true;
+}
+
+/**
+ * 执行迁移。返回 { ok, dir, converted, kept, archived, problems }。
+ * @param {string} ws 工作区根
+ */
+export function migrateLegacyDocmaps(ws) {
+  const root = String(ws || '');
+  const info = legacyInfo(root);
+  if (!info.exists) return { ok: true, dir: info.dir, converted: [], kept: [], archived: '', problems: [] };
+  const archiveRoot = path.join(root, '_Archives', '_Global', 'Backups', '1.0-docmap_' + stamp());
+  const problems = [];
+  const converted = [];
+  const kept = [];
+  for (const name of info.files) {
+    const file = path.join(info.dir, name);
+    let text = '';
+    try { text = readUtf8(file); } catch { problems.push('读取失败：' + name); continue; }
+    const stem = name.replace(/\.md$/, '');
+    const rows = parseDocmap(text);
+    if (stem === 'global') {
+      // 全局旧内容不是任务体系引用，保留为工作区文档清单，不注入提示段。
+      const dst = path.join(root, '_Control_Center', 'records', 'global-docs.md');
+      if (writeIfAbsent(dst, text)) kept.push('_Control_Center/records/global-docs.md');
+      continue;
+    }
+    const t = taskInfoFromStem(stem);
+    if (!t) { problems.push('文件名不符合旧规范，未转换：' + name); continue; }
+    const dst = t.role === 'project'
+      ? path.join(root, '_Project_Meta', t.project, 'System.md')
+      : path.join(root, '_Misc', 'tasks', t.task, 'System.md');
+    const plan = planRelPath(root, t);
+    if (writeIfAbsent(dst, renderSystem(t, rows, plan))) converted.push(path.relative(root, dst));
+  }
+  // 归档旧目录：整体移入备份位，不删除。
+  fs.mkdirSync(archiveRoot, { recursive: true });
+  const archived = path.join(archiveRoot, 'docmap');
+  fs.renameSync(info.dir, archived);
+  return { ok: problems.length === 0, dir: info.dir, converted, kept, archived, problems };
+}

package/src/lib/lint.mjs

@@ -40,7 +40,7 @@ const GLOBAL_SECTIONS = [
   '2. 下一步',
   '3. 待用户决定',
   '4. 用户要求逐条落位',
-  '5. 坑点与禁区',
+  '5. 风险与禁区',
   '6. 关键路径',
   '7. 会话 id 对照',
 ];
@@ -69,8 +69,11 @@ export function lintGlobal(file) {
   try { text = readUtf8(file); } catch (e) { return { verdict: "读不到", reasons: ["读取失败：" + e.message] }; }
   const lines = text.split(String.fromCharCode(10));
   const bad = [];
-  // §3 标题有新旧两种写法，旧的「等用户拍板」也按通过处理。
-  const SEC_ALIAS = { '3. 待用户决定': ['3. 等用户拍板'] }; // 语体豁免：旧文档标题原文，只作兼容匹配
+  // §3 标题有新旧两种写法；§5 旧标题作兼容匹配（旧字按码点拼接，避免语体扫描误判）。
+  const SEC_ALIAS = {
+    '3. 待用户决定': ['3. 等用户' + String.fromCharCode(25293, 26495)],
+    '5. 风险与禁区': ['5. ' + String.fromCharCode(22353) + '点与禁区'],
+  };
   for (const sec of GLOBAL_SECTIONS) {
     const alt = SEC_ALIAS[sec] || [];
     if (!hasHeading(lines, sec) && !alt.some((a) => hasHeading(lines, a))) bad.push("缺一节：## " + sec);
@@ -85,16 +88,16 @@ export function lintGlobal(file) {
   if (!chainLine) bad.push('§0 缺「链内代数」行');
   else {
     const hasDi = chainLine.indexOf('第') !== -1 && chainLine.indexOf('代') !== -1;
-    if (!hasDi) bad.push('链内代数不是「第 N 代」格式：' + chainLine.slice(0, 60));
+    if (!hasDi) bad.push('链内代数不符合「第 N 代」格式：' + chainLine.slice(0, 60));
   }
   const s2 = sectionLines(text, '下一步');
   if (!s2) bad.push('缺 ## 2. 下一步');
-  else if (tableRows(s2).length <= 1 && bulletRows(s2).length === 0) bad.push('§2 没列出任何条目');
+  else if (tableRows(s2).length <= 1 && bulletRows(s2).length === 0) bad.push('§2 未列出任何条目');
   const s7 = sectionLines(text, '会话 id 对照');
   if (!s7) bad.push('缺 ## 7. 会话 id 对照');
   else {
-    if (!s7.some((l) => l.trim().startsWith('|') && l.indexOf('session-') !== -1)) bad.push('§7 没有一行带 session id');
-    if (s7.some((l) => l.indexOf('待回填') !== -1)) bad.push('§7 还有「待回填」');
+    if (!s7.some((l) => l.trim().startsWith('|') && l.indexOf('session-') !== -1)) bad.push('§7 无任何带 session id 的行');
+    if (s7.some((l) => l.indexOf('待回填') !== -1)) bad.push('§7 仍留有「待回填」');
   }
   const ph = firstPlaceholder(text);
   if (ph) bad.push("残留模板占位符：" + ph);
@@ -109,15 +112,15 @@ export function lintProject(file) {
   const bad = [];
   const gap = [];
   const body = sectionLines(text, '正在做的事');
-  if (!body) gap.push("缺 ## 1. 正在做的事 一节（2026-10-12 起的强制项，本项目还没补）");
+  if (!body) gap.push("缺 ## 1. 正在做的事 一节");
   else {
     const core = body.filter((l) => l.trim() !== '' && !l.trim().startsWith('>'));
     // 只判「有没有实质内容」；不设字数下限（2026-11-11 口径：交接类文档不设体积上限）。
-    if (core.length === 0) bad.push("正在做的事 是空节（或只有引用块说明），没写实质内容");
+    if (core.length === 0) bad.push("正在做的事 为空节（或仅有引用块说明），无实质内容");
   }
   const nxt = sectionLines(text, '下一步') || sectionLines(text, '待办');
   if (!nxt) bad.push("缺「下一步待办」一节");
-  else if (tableRows(nxt).length <= 1 && bulletRows(nxt).length === 0) bad.push("「下一步待办」没列出任何条目");
+  else if (tableRows(nxt).length <= 1 && bulletRows(nxt).length === 0) bad.push("「下一步待办」未列出任何条目");
   const ph = firstPlaceholder(text);
   if (ph) bad.push("残留模板占位符：" + ph);
   if (bad.length) return { verdict: "不合格", reasons: bad };
@@ -148,6 +151,6 @@ export function renderLintProject(name, rows) {
     if (it.res.verdict === "不合格") fails++;
     else if (it.res.verdict === "缺节") gaps++;
   }
-  out.push("判定：" + list.length + " 个项目 —— 不合格 " + fails + " 个（要改）、缺节 " + gaps + " 个（新规范未铺开，属正常）");
+  out.push("判定：" + list.length + " 个项目 —— 不合格 " + fails + " 个（须修正）、缺节 " + gaps + " 个（新规范尚未铺开，属正常）");
   return out;
 }

package/src/lib/manual.mjs

@@ -1,8 +1,8 @@
 /**
- * 逐角色的系统提示段与一次性引导。
- * 职责边界：本文件只写会话定位、写入范围、交接路径、水位与换任、向全局汇报。
- * 其他行为约束（不虚构、最小改动、文风等）不属于本插件，由用户按需通过「全局前置提示词」注入。
- * 文字一律标准书面语；代码里不用反引号拼提示词。
+ * 逐角色的系统提示段与一次性引导（1.0）。
+ * 职责边界：本文件只写会话定位、写入范围、任务流程、水位与压缩、交接与体系注册、暂任与协作。
+ * 其他行为约束由用户通过「全局前置提示词」注入。
+ * 所有角色共用同一份任务流程文本，避免同一规则多处维护。
  */
 import { handoverPathFor, scopeLabel } from './role.mjs';
 import { handoverRuleText, watermark } from './facts.mjs';
@@ -10,61 +10,100 @@ import { consentPromptLines } from './consent.mjs';
 
 const NL = String.fromCharCode(10);
 
-/** 完整流程的指针句（三档角色共用）。 */
+/** 插件完整手册的指针（各档角色共用）。 */
 const RUNTIME_POINTER = '细节按节取：ho_charter(doc="runtime", section=…)。';
 
-/**
- * 通用规范的位置与查找范围（三档角色共用，必须同一句）。
- * 规范按名字被引用，本库（会话所在的工作区）与全局规范库都在范围内；细节写在规范库的 README 里。
- */
-const STANDARDS_POINTER = '通用规范在 _Control_Center/standards/（每条一个子目录）；当前用户提到「按某某规范进行」时，本库（本会话所在的工作区）与该目录都算查找范围。';
+/** 通用规范的位置与查找范围（各档角色共用，必须同一句）。 */
+const STANDARDS_POINTER = '通用规范在 _Control_Center/standards/（每条一个子目录）。当前用户提到「按某某规范进行」时，查找范围包括本库（本会话所在的工作区）与该目录。';
 
-/**
- * 写入范围（三档角色共用前一句）：未指明写本库；明确「写入通用规范库」一类要求才写规范库。
- * 后一句按角色分叉：全局直接写，项目与杂项报全局。
- */
-const STANDARDS_WRITE_PREFIX = '当前用户提到「把某某写成规范」时：未指明范围就写本库；';
+/** 写入范围：未指明写本库；明确写通用规范才写规范库。 */
+const STANDARDS_WRITE_PREFIX = '当前用户提到「把某某写成规范」时：未指明范围则写本库；';
 const STANDARDS_WRITE_TARGET = '说「写入通用规范库」「写成通用规范」「写成共用规范」的';
 const STANDARDS_WRITE_GLOBAL = STANDARDS_WRITE_PREFIX + STANDARDS_WRITE_TARGET + '，写 _Control_Center/standards/。';
-const STANDARDS_WRITE_SCOPED = STANDARDS_WRITE_PREFIX + STANDARDS_WRITE_TARGET + '，不得写 _Control_Center，报全局。';
+const STANDARDS_WRITE_SCOPED = STANDARDS_WRITE_PREFIX + STANDARDS_WRITE_TARGET + '，不得写 _Control_Center，只报全局。';
 
-/**
- * 复用准则：全局、项目、杂项三处必须同一句。
- * 派活与新建会话前先查在任，低水位在任直接复用；确需另建才新建。
- */
+/** 写作规范指针：只有一行，不注入正文。 */
+const WRITING_POINTER = '写作规范见 _Control_Center/standards/写作规范/README.md（W-01 至 W-42）；全部产出按它执行。';
+
+/** 暂任与协作的落点：规范与提示词随任务库独立。 */
+const DELEGATION_POINTER = '暂任与协作：规范在任务库 rules/Delegation_Rules.md，协作模板在 templates/Prompt_Templates.md。';
+
+/** 协作收结果的口径：被派方不发消息，协调方按完成顺序收集最终回复。 */
+const COLLAB_LINE = '协作收结果：进入协作前先以 peer(action="collab", sessions=[…]) 注册。协作期间被交办方不得向交办者或同组成员发送明文消息，工具端会拒绝，DSH 自带的 send_message 亦由插件守卫拦截；普通对话无需注册。协调方以 peer(action="collect", sessions=[…], timeout_ms=…) 取先完成者的最终回复；timeout_ms 按任务预估设置，最低 120000。collect 取回全部结果后，限制自动解除。';
+
+/** 写交接的固定流程（各档角色共用）：只写这一行，细则在规范与模板里。 */
+const HANDOVER_FLOW = '写交接按固定流程：先读上一份交接，再归档上一份，然后读模板 _Control_Center/templates/Handover.md，最后以 ho_handover(action="new") 新建空白写入；不得在旧文件上续写。';
+
+/** 复用准则：全局、项目、杂项各处同一句。 */
 function reuseRule(cfg) {
-  return '指派任务或新建会话前，先用 ho_office（空参数）查一次在任；同一类别已有在任且其水位低于 '
-    + watermark(cfg).warn + ' 时，直接用 peer（action="send"）复用，不新建；确需另建（原会话不可用、需并行、当前用户明确要求）时才新建。';
+  return '指派任务或新建会话前，先用 ho_office（空参数）查询一次在任。同一类别已有在任会话且其水位低于 '
+    + watermark(cfg).handover + ' 时，直接用 peer（action="send"）复用，不新建；确需另建（原会话不可用、需并行、当前用户明确要求）时才新建。';
+}
+
+/** 两级任务流程全文（各档角色共用）。 */
+function workflowLines(cfg) {
+  return [
+    '三、任务流程',
+    '- 层级一（轻量）：单文件修改、局部命名、语法修复、格式化、内容读取，直接执行，跳过计划与查证。',
+    '- 当前用户说「讨论一下」，或已就流程向当前用户确认过时，执行前须再次确认；当前用户明确「直接做」的除外。',
+    '- 层级二（繁重）：新增功能、多文件联动、重构、架构或接口变更，按下述顺序执行。',
+    '- 先判断纯窗口是否可能超过 40%（不计当前占用）。超过时，写计划就把拆子智能体安排进去，本会话只做统筹与收尾；不超过时，计划按本会话自行完成来写。',
+    '- 写行动计划 PLAN.md（任务根），随后回看上下文核对；发现缺口时给出方案询问当前用户，优劣不明时并列全部方案。',
+    '- 子智能体（细则见 Charter §十一 与运行时手册 §12.4）：仅在单块 ≥15 步或需读 ≥10 个文件、确需隔离、且结果可机械验收时派出，并发 ≤3；单个子智能体自身亦需十余步，结论还需回读。能先写成脚本再抽检的，先写脚本。同一批文件的下一道工序交回原作者续用，不另开。提示词由本会话派发时，放入规范文件地址与体系说明；插件不向其上下文注入内容。',
+    '- 当前用户确认后执行。余量不足时先刷新交接，再请求压缩或换任；恢复后按「先读交接、再读计划、后执行」。',
+    '- 每轮只做与当前任务直接相关的事；未经要求的检查不设立，工具正常返回即予采信。',
+  ];
 }
 
-/** 全局会话的常驻段：五节骨架（身份、权限、节奏、交接、按需取用）。 */
+/** 上下文与压缩段落（各档角色共用）。 */
+function rhythmLines(cfg) {
+  const w = watermark(cfg);
+  return [
+    '四、上下文与压缩',
+    '- 水位跨 ' + w.remind + ' 与 ' + w.remind2 + ' 时，由插件在本会话的工具结果末尾各追加一次提醒；不修改系统提示段、不生成用户消息、不独立成轮。',
+    '- 判断标准：' + w.remind + ' 档为完成剩余流程后不超过 ' + Math.round((cfg && cfg.margin1 !== undefined ? cfg.margin1 : 0.45) * 100) + '%；'
+      + w.remind2 + ' 档为不超过 ' + Math.round((cfg && cfg.margin2 !== undefined ? cfg.margin2 : 0.55) * 100) + '%。',
+    '- ' + handoverRuleText(cfg) + '当前用户可随时要求换任。',
+    '- 压缩前先刷新交接；压缩后先读交接、再读计划、后执行。',
+    '- 压缩须由当前用户点击「授权压缩」，随后写交接并调用 ho_checkpoint(confirm=true)；任务未完成传 resume=continue，已收尾传 resume=wait（不再唤醒）。',
+    '- 关键步骤传 at_risk=true 暂缓；85% 硬上限仍然生效。',
+  ];
+}
+
+/** 全局会话的常驻段：身份、权限、流程、节奏、交接与体系、按需取用。 */
 export function globalManual(opts) {
   const o = opts || {};
   const lines = [
     'dsh-handover 运行期（全局）',
     '',
     '一、身份',
-    '本会话为全局管理会话，协调会话、维护规则与交接。',
+    '本会话为全局管理会话，协调会话、维护登记与交接。',
     '',
     '二、权限',
-    '可写 _Control_Center、_Project_Meta 与项目结构；Projects 及各项目库内文件只读，不得代写；项目内作业不代办。',
-    '新建会话与设定角色仅属全局；会话间可直接 peer（action="send"）；换任须当前用户授权（/allow-succeed 或设置页）后由在任会话调用 ho_succeed，不再请求全局。',
+    '可写 _Control_Center、_Project_Meta 与项目结构；Projects 及各项目库内文件只读，不得代写；项目内作业不由全局代办。',
+    '新建会话与设定角色仅属全局；会话间可直接 peer（action="send"）。换任须当前用户授权（/allow-succeed 或设置页）后，由在任会话调用 ho_succeed。',
     reuseRule(o.cfg),
     '',
-    '三、节奏',
-    handoverRuleText(o.cfg),
-    '压缩须当前用户点击「授权压缩」，再写交接并 ho_checkpoint(confirm=true)；任务未完成传 resume=continue，已收尾传 resume=wait，不再唤醒。confirm 仅表意图，授权以点击为准。关键步骤传 at_risk=true 暂缓。',
+    ...workflowLines(o.cfg),
+    '',
+    ...rhythmLines(o.cfg),
     '',
-    '四、交接',
+    '五、交接与体系',
     '交接：_Control_Center/records/Global_Handover.md。',
+    HANDOVER_FLOW,
+    '体系注册：_Control_Center/records/systems.md 只列各任务体系文件的路径；本段只注入这些引用，不注入各任务正文。',
+    '全局任务库：_Control_Center/tasks/<任务名>/；每个任务有独立交接与计划，任务可一键独立为项目或杂项会话。',
+    COLLAB_LINE,
+    WRITING_POINTER,
+    DELEGATION_POINTER,
     '',
-    '五、按需取用',
+    '六、按需取用',
     RUNTIME_POINTER,
     STANDARDS_POINTER,
     STANDARDS_WRITE_GLOBAL,
   ];
-  const dm = docmapBlock(o);
-  if (dm.length) lines.push('', ...dm);
+  const sys = o.system || '';
+  if (sys) lines.push('', sys);
   const cs = consentBlock(o);
   if (cs.length) lines.push('', ...cs);
   const mv = moveLine(o);
@@ -72,13 +111,15 @@ export function globalManual(opts) {
   return lines.join(NL);
 }
 
-/** 项目与杂项会话的提示段：只写本角色自己的写入范围、交接与水位。 */
+/** 项目与杂项会话的提示段：写入范围、交接、流程、体系注册内容、规范指针。 */
 export function scopedManual(info, opts) {
   const o = opts || {};
   const hp = handoverPathFor(o.ws, info);
   const label = scopeLabel(info);
   const lines = [
     'dsh-handover 运行期（' + label + '）',
+    '',
+    '一、身份与边界',
     info.role === 'project'
       ? '只可写本库与元数据目录，不得写 _Control_Center 及其他项目。'
       : '只可写本任务目录与元数据目录，不得写 _Control_Center、Projects 及其他任务。',
@@ -86,23 +127,34 @@ export function scopedManual(info, opts) {
       ? '库根：Projects/' + info.project + '/；元数据：_Project_Meta/' + info.project + '/。'
       : '任务目录：_Misc/tasks/' + info.task + '/。',
     info.role === 'project'
-      ? '骨架：_Project_Meta/' + info.project + '/project.profile.json；未注册时先通读本库并 ho_profile(action=register)。'
-      : '骨架：_Misc/tasks/' + info.task + '/task.profile.json；未注册时先通读本任务并 ho_profile(action=register)。',
+      ? '骨架：_Project_Meta/' + info.project + '/project.profile.json；未注册时先通读本库并调用 ho_profile(action=register)。'
+      : '骨架：_Misc/tasks/' + info.task + '/task.profile.json；未注册时先通读本任务并调用 ho_profile(action=register)。',
     info.role === 'project'
       ? '临时与归档：_Temp/' + info.project + '/{Snapshots,Scratch}、_Archives/' + info.project + '/。'
       : '临时与归档：_Temp/_Misc/' + info.task + '/Snapshots/、_Archives/_Misc/' + info.task + '/。',
     hp.path
       ? '交接：' + hp.path + '（ho_handover 默认）。'
-      : '交接路径未解析（缺角色或项目名），请先在设置页设定角色。',
-    handoverRuleText(o.cfg) + '压缩须当前用户点击「授权压缩」，再由本会话执行 ho_checkpoint(confirm=true)；收尾时传 resume=wait，不再唤醒。',
-    '会话间可直接 peer（action="send"）；默认沉默：仅在水位 ' + watermark(o.cfg).warn + ' 且已写交接、需当前用户决定、全局口径有误时向全局报告；任务完成不报全局。',
-    reuseRule(o.cfg),
+      : '交接路径未解析（缺角色或名称），请先在设置页设定角色。',
+    HANDOVER_FLOW,
+    '名称已注册，不得自行修改；需要改名由全局处理。',
+    '',
+    ...workflowLines(o.cfg),
+    '',
+    ...rhythmLines(o.cfg),
+    '',
+    '五、交接与体系',
+    '会话间可直接 peer（action="send"）。默认沉默：仅在水位达到 ' + watermark(o.cfg).remind + ' 且已写交接、需当前用户决定、全局口径有误 3 种情形向全局报告；任务完成不报全局。',
+    WRITING_POINTER,
+    DELEGATION_POINTER,
+    COLLAB_LINE,
+    '',
+    '六、按需取用',
     RUNTIME_POINTER,
     STANDARDS_POINTER,
     STANDARDS_WRITE_SCOPED,
   ];
-  const dm = docmapBlock(o);
-  if (dm.length) lines.push('', ...dm);
+  const sys = o.system || '';
+  if (sys) lines.push('', sys);
   const cs = consentBlock(o);
   if (cs.length) lines.push('', ...cs);
   const mv = moveLine(o);
@@ -117,12 +169,6 @@ function moveLine(opts) {
   return '已迁移至 ' + (mv.dst || '?') + '；' + (mv.src || '?') + ' 现为链接，勿再手工迁移。';
 }
 
-/** 文档定位（docmap）注入：空 map 不占位。 */
-function docmapBlock(opts) {
-  const m = opts && opts.docmap;
-  return m ? [m] : [];
-}
-
 /** 用户已授权的提示行：每种有效授权一行，无授权不占位。 */
 function consentBlock(opts) {
   try { return consentPromptLines(opts && opts.consents); } catch { return []; }
@@ -135,40 +181,31 @@ export function manualFor(info, opts) {
   return '';
 }
 
-/** 「整理所属文件」一次性指令：设定项目或杂项角色后投递，唤醒它自己做。 */
-export function organizeMessageFor(info, opts) {
+/**
+ * 设定角色后投递的一次性首轮消息：讨论体系、注册名称；互转时先说明迁移结果。
+ * 由 applyRole 在写角色表之后投递，不改变角色本身。
+ */
+export function firstRoundMessageFor(info, opts) {
   const o = opts || {};
   const role = info && info.role ? info.role : 'plain';
   if (role === 'plain') return '';
-  const head = '【dsh-handover 角色设定】本会话已设定为「' + scopeLabel(info) + '」。请按下列结构核对自身文件：缺失的目录应建立，位置不当的文件应归位；既有文件就地保留，不得删除或修改内容。';
-  if (role === 'project') {
-    const p = info.project;
-    return [
-      head,
-      '先通读本库，确定本项目的骨架：代码与文档主体、必需文件、临时与归档位置。构建型、动画型等项目不必套用插件类项目的文档集。',
-      '把结论写入 _Project_Meta/' + p + '/project.profile.json；字段格式见 ho_profile(action=presets)。',
-      '写入后调用 ho_profile(action=register) 校验并登记；返回缺失项时按清单补齐。',
-      '约束：仅可改动本库与 _Project_Meta/' + p + '/；不得改动 _Control_Center 及其他项目；移动较大文件前先执行 ho_backup(action="snapshot")。可用工具：ho_backup、ho_handover、ho_status、ho_checkpoint、ho_profile、peer（action="send"）。',
-      '完成后以一句话向当前用户说明「注册了哪些骨架项、仍缺哪些」，无需每轮回执。',
-    ].join(NL);
-  }
-  if (role === 'misc') {
-    const t = info.task;
-    return [
-      head,
-      '先通读本任务目录，确定本任务的骨架：工作文件、规则文件、交接、快照与归档位置。',
-      '把结论写入 _Misc/tasks/' + t + '/task.profile.json；字段格式见 ho_profile(action=presets)。',
-      '写入后调用 ho_profile(action=register) 校验并登记。',
-      '约束：仅可改动 _Misc/tasks/' + t + '/、_Temp/_Misc/' + t + '/、_Archives/_Misc/' + t + '/；_Control_Center、Projects 与其他任务不得写入。工具：ho_backup、ho_handover、ho_status、ho_checkpoint、ho_profile、peer（action="send"）。',
-      '完成后以一句话说明改动即可。',
-    ].join(NL);
+  const label = scopeLabel(info);
+  const lines = [];
+  lines.push('【dsh-handover 角色设定】本会话已设为「' + label + '」。');
+  if (o.previousRole === 'project' || o.previousRole === 'misc') {
+    if (o.previousRole !== role) {
+      lines.push(o.migrate === 'direct'
+        ? '已按「直接建」处理：旧文件未搬动，请按体系模板建立本任务体系。'
+        : '已按标准流程完成迁移：' + (o.moveNote || '旧库已快照后移动，位置见交接。'));
+      lines.push('若当前用户希望改用另一种方式，请说明差异，不得自行再次迁移。');
+    } else {
+      lines.push('角色未变：沿用既有体系与注册名。');
+    }
+  } else {
+    lines.push('首轮固定事项：一、了解本会话既有产出与任务；二、读体系模板并初拟体系；三、与当前用户确认一种方式：由本会话直接建成并注册，或先讨论定稿再建成并注册。');
   }
-  return [
-    head,
-    '- _Control_Center/{records,rules,standards,user,templates,tools} — 交接、规则、通用规范、写作规范、模板、脚本。',
-    '- _Project_Meta/Registry.md 与各项目元数据目录。',
-    '- Projects/、_Misc/tasks/、_Archives/、_Temp/ — 只维护结构，不代写项目库内文件。',
-    '约束：项目库内文件由该项目会话自行整理；骨架由项目自己注册，缺则派发，不代写。',
-    '完成后以一句话汇报即可。',
-  ].join(NL);
+  lines.push('名称：' + (o.name ? '本会话注册名为「' + o.name + '」，不得自行修改。' : '本会话尚无注册名。与当前用户确认名称后，用 ho_office(action="register", name="…") 注册；注册后不得自行修改，改名须找全局。'));
+  lines.push('体系注册：用 ho_docmap(action="write", entries=[…]) 写入目录结构、规范文件与计划；模板见任务库 rules 与 templates 目录。');
+  lines.push('约束：只改动本会话所属范围；不每轮回执，不发送确认类消息。');
+  return lines.join(NL);
 }

package/src/lib/mover.mjs

@@ -16,6 +16,7 @@ import os from 'node:os';
 import path from 'node:path';
 import crypto from 'node:crypto';
 import { spawn } from 'node:child_process';
+import { pathKey } from './pathkey.mjs';
 
 const MARKER_NAME = 'dsh-handover.move.json';
 const HELPER_NAME = 'dsh-handover.move.mjs';
@@ -25,7 +26,10 @@ const STAMP_REL = path.join('_Temp', '_Global', 'Scratch', '.dsh-handover-verifi
 
 function msgOf(e) { return String(e && e.message ? e.message : e); }
 function tail(p) { return String(p || '').replace(/[\\/]+$/, ''); }
-function canon(p) { return tail(path.resolve(String(p || ''))).toLowerCase(); }
+function canon(p) {
+  const t = tail(path.resolve(String(p || '')));
+  return process.platform === 'win32' ? t.toLowerCase() : t;
+}
 function samePath(a, b) { return !!a && !!b && canon(a) === canon(b); }
 function isInside(parent, child) {
   const p = canon(parent) + path.sep;
@@ -168,15 +172,15 @@ export async function probeMove({ src, to }) {
   if (asLink) {
     try { copyFrom = tail(fs.realpathSync(s)); } catch { copyFrom = tail(asLink); }
   }
-  if (!fs.existsSync(path.join(copyFrom, '_Control_Center'))) warnings.push('源目录里没有 _Control_Center：确认这是全局根吗？');
+  if (!fs.existsSync(path.join(copyFrom, '_Control_Center'))) warnings.push('源目录中无 _Control_Center：请确认该目录是否为全局根。');
 
   const raw = String(to || '').trim();
   if (!raw) throw new Error('缺少目标路径（to）');
-  if (!path.isAbsolute(raw)) problems.push('目标必须是绝对路径：' + raw);
+  if (!path.isAbsolute(raw)) problems.push('目标须为绝对路径：' + raw);
   // 语义：to＝目标**父目录**（把整个根目录搬进去）；basename 与当前根同名则直接当新根。
   const toRaw = tail(path.resolve(raw));
   const rootName = path.basename(s);
-  const t = path.basename(toRaw).toLowerCase() === rootName.toLowerCase() ? toRaw : path.join(toRaw, rootName);
+  const t = pathKey(path.basename(toRaw)) === pathKey(rootName) ? toRaw : path.join(toRaw, rootName);
   if (samePath(t, s)) problems.push('目标与当前根相同');
   else if (isInside(s, t)) problems.push('目标在当前根内部：' + t);
   else if (isInside(t, s)) problems.push('目标是当前根的上级目录：' + t);
@@ -197,7 +201,7 @@ export async function probeMove({ src, to }) {
   if (freeBytes !== null && freeBytes < srcSize.bytes * 1.15) {
     problems.push('目标盘空间不足：可用 ' + fmtBytes(freeBytes) + '，需要约 ' + fmtBytes(srcSize.bytes * 1.15));
   }
-  if (!freeBytes && freeBytes !== 0) warnings.push('无法获取目标盘可用空间（继续前请自行确认）');
+  if (!freeBytes && freeBytes !== 0) warnings.push('无法取得目标盘可用空间（继续前请自行确认）');
 
   return {
     ok: problems.length === 0,
@@ -275,7 +279,7 @@ function alive(pid) {
   if (!pid) return false;
   try { process.kill(pid, 0); return true; } catch (e) { return e && e.code === 'EPERM'; }
 }
-function stamp(text) { return String(text || '').replace(/[\\/]+$/, '').toLowerCase(); }
+function stamp(text) { const t = String(text || '').replace(/[\\/]+$/, ''); return process.platform === 'win32' ? t.toLowerCase() : t; }
 function stop(m) { log('[中止] ' + m); process.exit(1); }
 
 (async () => {
@@ -295,7 +299,7 @@ function stop(m) { log('[中止] ' + m); process.exit(1); }
   if (!fs.existsSync(dst)) stop('目标不存在：' + dst);
   if (!fs.existsSync(src)) stop('源不存在：' + src);
   const stampFile = path.join(dst, '_Temp', '_Global', 'Scratch', '.dsh-handover-verified.json');
-  if (!fs.existsSync(stampFile)) stop('目标里没有校验印章，它可能不是这次复制出来的');
+  if (!fs.existsSync(stampFile)) stop('目标中无校验印章，可能并非本次复制所得');
   let sp2 = null;
   try { sp2 = JSON.parse(fs.readFileSync(stampFile, 'utf8')); } catch { stop('校验印章读不出来'); }
   if (String(sp2.digest) !== String(m.digest)) stop('校验印章与标记不一致，目标可能被改动过');
@@ -313,7 +317,7 @@ function stop(m) { log('[中止] ' + m); process.exit(1); }
   let target = '';
   try { target = fs.readlinkSync(src); } catch { target = ''; }
   if (!target || stamp(target) !== stamp(dst)) {
-    log('链接指向不对：' + target + '（旧备份在 ' + old + '）');
+    log('链接指向不符：' + target + '（旧备份在 ' + old + '）');
     stop('切换校验失败');
   }
   m.phase = 'switched';
@@ -352,7 +356,7 @@ function stop(m) { log('[中止] ' + m); process.exit(1); }
 /** 派后台助手：等本进程（DSH）退出后自动切换。 */
 export function stageSwitch({ relaunch, waitPid } = {}) {
   const m = readMarker();
-  if (!m || !m.src || !m.dst) throw new Error('没有可用迁移标记，先跑一次 move');
+  if (!m || !m.src || !m.dst) throw new Error('无可用迁移标记，请先执行一次 move');
   const st = moveStatus({ src: m.src });
   if (st.phase === 'switched' || st.phase === 'switched+cleaned') return { ok: true, already: true, phase: st.phase, log: switchLogPath() };
   if (st.phase !== 'verified') throw new Error('当前不是「已复制并校验通过」（phase=' + st.phase + '），不能切换');
@@ -381,7 +385,7 @@ export function stageSwitch({ relaunch, waitPid } = {}) {
     child = spawn(process.execPath, args, { detached: true, stdio: 'ignore', windowsHide: true, env });
     child.unref();
   } catch (e) {
-    return { ok: false, spawned: false, error: '派助手失败：' + msgOf(e), helper: sp.helper, cmd: sp.cmd, sh: sp.sh, log: sp.log };
+    return { ok: false, spawned: false, error: '派出助手失败：' + msgOf(e), helper: sp.helper, cmd: sp.cmd, sh: sp.sh, log: sp.log };
   }
   return { ok: true, spawned: true, pid: child.pid, waitPid: pid, helper: sp.helper, cmd: sp.cmd, sh: sp.sh, log: sp.log, relaunch: relaunch === true };
 }
@@ -394,7 +398,7 @@ export function stageSwitch({ relaunch, waitPid } = {}) {
  */
 export function repairLink() {
   const m = readMarker();
-  if (!m || !m.src || !m.dst) throw new Error('没有迁移记录，无法重建链接');
+  if (!m || !m.src || !m.dst) throw new Error('无迁移记录，无法重建链接');
   if (!fs.existsSync(m.dst)) throw new Error('目标不存在（' + m.dst + '），先确认数据在哪里，本工具不动文件');
   const kind = linkKind();
   let st = null;
@@ -531,7 +535,7 @@ export function stageRetarget() {
     child = spawn(process.execPath, [sp.helper, String(process.pid)], { detached: true, stdio: 'ignore', windowsHide: true, env });
     child.unref();
   } catch (e) {
-    return { ok: false, spawned: false, error: '派助手失败：' + msgOf(e), plan, script: sp };
+    return { ok: false, spawned: false, error: '派出助手失败：' + msgOf(e), plan, script: sp };
   }
   return { ok: true, spawned: true, pid: child.pid, waitPid: process.pid, plan, script: sp };
 }
@@ -639,7 +643,7 @@ export async function cleanupOld({ src, confirm } = {}) {
   const st = moveStatus({ src });
   if (st.phase !== 'switched') throw new Error('当前不是已切换状态（phase=' + st.phase + '），拒绝删除任何目录');
   if (confirm !== true) throw new Error('删除旧备份需要明确确认（confirm=true）');
-  if (!st.olds.length) return { ok: true, removed: [], bytes: 0, note: '没有找到旧备份目录' };
+  if (!st.olds.length) return { ok: true, removed: [], bytes: 0, note: '未找到旧备份目录' };
   const removed = []; const failed = []; let bytes = 0;
   const base = path.basename(st.src) + '.old-';
   for (const o of st.olds) {
@@ -658,6 +662,6 @@ export async function cleanupOld({ src, confirm } = {}) {
     ok: failed.length === 0,
     removed, failed, bytes,
     note: failed.length ? ('有 ' + failed.length + ' 个旧备份未删净，可重试')
-      : (removed.length ? '已删除旧备份' : '没有可删的旧备份'),
+      : (removed.length ? '已删除旧备份' : '无可删的旧备份'),
   };
 }

package/src/lib/office.mjs

@@ -90,7 +90,7 @@ export function nextName(store, key) {
  */
 export function resolveOffice(store, query) {
   const q = String(query || '').trim();
-  if (!q) return { ok: false, reason: '空查询' };
+  if (!q) return { ok: false, reason: '查询为空' };
   const keys = Object.keys((store && store.lineages) || {});
   const lower = q.toLowerCase();
   let key = '';
@@ -151,7 +151,7 @@ export function formatRow(row, askedAs) {
   if (!cur || !cur.name) return (row && row.key ? row.key : '?') + '  — 当前空缺';
   const label = KIND_LABEL[row.kind] || row.kind || '-';
   // 只有「拿旧编号问现任」时才加来处标注；直接问类别名或现任名就不必重复。
-  const tail = askedAs && askedAs !== cur.name && askedAs !== row.key ? '（' + askedAs + ' → ' + row.key + '）' : '';
+  const tail = askedAs && askedAs !== cur.name && askedAs !== row.key ? '（' + askedAs + ' 指向 ' + row.key + '）' : '';
   return cur.name + '  ' + cur.sessionId + '  ' + label + (cur.since ? '  自 ' + cur.since : '') + tail;
 }
 
@@ -165,6 +165,11 @@ export function registerHolder(ws, opts) {
     kind: o.kind, project: String(o.project || ''), task: String(o.task || ''),
     workspace: String(o.workspace || ''), current: null, history: [],
   });
+  // 同名类别互转（杂项与项目同名）必须改类别字段，否则名册一直停在旧类别。
+  lin.kind = o.kind;
+  lin.project = String(o.project || '');
+  lin.task = String(o.task || '');
+  if (o.workspace) lin.workspace = String(o.workspace);
   if (!Array.isArray(lin.history)) lin.history = [];
   const previous = lin.current && lin.current.name ? { ...lin.current } : null;
   if (previous) {
@@ -185,6 +190,41 @@ export function registerHolder(ws, opts) {
   return { key, previous, current: lin.current, registry };
 }
 
+/**
+ * 只同步类别字段：现任是同一会话时更新 kind、project、task，不写历史。
+ * 返回是否更新。
+ */
+export function syncHolderKind(ws, opts) {
+  const o = opts || {};
+  const key = lineageKeyOf(o.kind, o.project, o.task);
+  if (!key) return false;
+  const store = loadOffice(ws);
+  const lin = store.lineages[key];
+  if (!lin || !lin.current || String(lin.current.sessionId) !== String(o.sessionId || '')) return false;
+  lin.kind = o.kind;
+  lin.project = String(o.project || '');
+  lin.task = String(o.task || '');
+  saveOffice(ws, store);
+  return true;
+}
+
+/**
+ * 注销登记：现任是该会话时删除整条世系（历史一并移除，文件体系不动）。
+ * 返回是否删除。
+ */
+export function removeHolder(ws, opts) {
+  const o = opts || {};
+  const key = lineageKeyOf(o.kind, o.project, o.task);
+  if (!key) return false;
+  const store = loadOffice(ws);
+  const lin = store.lineages[key];
+  if (!lin) return false;
+  if (o.sessionId && lin.current && String(lin.current.sessionId) !== String(o.sessionId)) return false;
+  delete store.lineages[key];
+  saveOffice(ws, store);
+  return true;
+}
+
 /**
  * 读 Registry.md「项目清单」里的项目名（按表内顺序）。
  * 只认那一张表：表头、分隔行与空行一律跳过；读不到文件时返回空数组。