@mingmaple/dsh-handover 0.9.14 → 1.0.0

package/src/lib/system.mjs

@@ -0,0 +1,364 @@
+/**
+ * 体系注册与文档定位（1.0）：每个任务一份注册文件，写目录结构、规范文件与计划；
+ * 全局总注册只列各任务体系文件的路径，不承载正文。
+ *
+ * 路径约定：
+ * - 全局总注册：_Control_Center/records/systems.md
+ * - 项目：_Project_Meta/<项目>/System.md
+ * - 杂项：_Misc/tasks/<任务>/System.md
+ * - 全局任务：_Control_Center/tasks/<任务>/System.md
+ *
+ * 定位：注册只给路径与用途，是否读正文由会话判断；空注册不注入正文，只注入一句提示。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { NL, readUtf8, isFile, isDir } from './text.mjs';
+import { projectNameOk, taskNameOk } from './role.mjs';
+import { readProfile } from './profile.mjs';
+
+export const GLOBAL_REGISTRY_REL = path.join('_Control_Center', 'records', 'systems.md');
+export const REGISTRY_NAME = 'System.md';
+
+const TICK = String.fromCharCode(96);
+
+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) };
+  if (role === 'global-task' && info.task) return { kind: 'global-task', 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 + '」';
+  if (lin.kind === 'global-task') return '全局任务「' + lin.task + '」';
+  return '全局';
+}
+
+/** 任务库根（相对工作区）。项目优先取骨架档案登记的根，其次 `<项目>库`，最后项目目录。 */
+export function taskRoot(ws, info) {
+  const lin = lineageOf(info);
+  if (!lin) return '';
+  if (lin.kind === 'project') {
+    const p = lin.project;
+    try {
+      const pf = readProfile(ws, { role: 'project', project: p });
+      if (pf && pf.exists && pf.profile && pf.profile.root) return String(pf.profile.root);
+    } catch { /* 骨架读不到时按目录规则推断 */ }
+    const lib = path.join('Projects', p, p + '库');
+    return isDir(path.join(String(ws || ''), lib)) ? lib : path.join('Projects', p);
+  }
+  if (lin.kind === 'misc') return path.join('_Misc', 'tasks', lin.task);
+  if (lin.kind === 'global-task') return path.join('_Control_Center', 'tasks', lin.task);
+  return '_Control_Center';
+}
+
+/** 注册文件相对路径。 */
+export function registryRelPath(info) {
+  const lin = lineageOf(info);
+  if (!lin) return null;
+  if (lin.kind === 'global') return GLOBAL_REGISTRY_REL;
+  if (lin.kind === 'project') return path.join('_Project_Meta', lin.project, REGISTRY_NAME);
+  if (lin.kind === 'misc') return path.join('_Misc', 'tasks', lin.task, REGISTRY_NAME);
+  if (lin.kind === 'global-task') return path.join('_Control_Center', 'tasks', lin.task, REGISTRY_NAME);
+  return null;
+}
+
+export function registryAbsPath(ws, info) {
+  const rel = registryRelPath(info);
+  return rel ? path.join(String(ws || ''), rel) : null;
+}
+
+export function planRelPath(ws, info) {
+  const root = taskRoot(ws, info);
+  return root ? path.join(root, 'PLAN.md') : '';
+}
+
+function normRel(p) {
+  return String(p || '').replace(/\\/g, '/').replace(/^\.\//, '');
+}
+
+function cellsOf(line) {
+  return line.replace(/^\|/, '').replace(/\|$/, '').split('|').map((c) => c.replace(new RegExp(TICK, 'g'), '').trim());
+}
+
+/** 解析任务级注册：返回 { title, structure: [{path, about}], files: [{path, about, when}], plan }。 */
+export function parseRegistry(text) {
+  const out = { title: '', structure: [], files: [], plan: '' };
+  let section = '';
+  for (const raw of String(text || '').split(/\r?\n/)) {
+    const line = raw.trim();
+    if (line.startsWith('# ')) { out.title = line.slice(2).trim(); continue; }
+    if (line.startsWith('## ')) { section = line.slice(3).trim(); continue; }
+    if (section.indexOf('计划') !== -1) {
+      const m = /^[-*]\s*`?([^`：:]+\.md)`?/.exec(line);
+      if (m) out.plan = m[1].trim();
+      continue;
+    }
+    if (!line.startsWith('|')) continue;
+    const cells = cellsOf(line);
+    if (cells.length < 2) continue;
+    if (cells[0] === '路径') continue;
+    if (cells.every((c) => /^[-:\s]*$/.test(c))) continue;
+    if (section.indexOf('目录') !== -1) out.structure.push({ path: cells[0], about: cells[1] || '' });
+    else if (section.indexOf('规范') !== -1 || section.indexOf('文件') !== -1) {
+      out.files.push({ path: cells[0], about: cells[1] || '', when: cells[2] || '' });
+    }
+  }
+  return out;
+}
+
+/** 渲染任务级注册文件。 */
+export function renderRegistry(info, data) {
+  const label = lineageLabel(info);
+  const lines = ['# 体系注册（' + label + '）', '', '## 目录结构', '', '| 路径 | 用途 |', '|---|---|'];
+  for (const e of data.structure || []) lines.push('| ' + wrap(e.path) + ' | ' + e.about + ' |');
+  lines.push('', '## 规范文件', '', '| 路径 | 用途 | 何时读 |', '|---|---|---|');
+  for (const e of data.files || []) lines.push('| ' + wrap(e.path) + ' | ' + e.about + ' | ' + (e.when || '') + ' |');
+  lines.push('', '## 计划', '');
+  if (data.plan) lines.push('- ' + wrap(data.plan) + '：当前行动计划');
+  lines.push('');
+  lines.push('只给路径与用途：是否读正文由会话判断，不得无目的通读。');
+  return lines.join(NL) + NL;
+}
+
+function wrap(p) {
+  return TICK + normRel(p) + TICK;
+}
+
+/** 读取任务级注册；不存在返回 exists=false。 */
+export function readRegistry(ws, info) {
+  const file = registryAbsPath(ws, info);
+  if (!file) return { file: null, exists: false, data: { structure: [], files: [], plan: '' } };
+  if (!isFile(file)) return { file, exists: false, data: { structure: [], files: [], plan: '' } };
+  let text = '';
+  try { text = readUtf8(file); } catch { return { file, exists: true, error: '读取失败', data: { structure: [], files: [], plan: '' } }; }
+  return { file, exists: true, data: parseRegistry(text), text };
+}
+
+/** 路径合法且存在：只收工作区相对路径。 */
+export function pathProblem(ws, p) {
+  const raw = normRel(p);
+  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 '';
+}
+
+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;
+}
+
+/** 解析全局总注册：返回 [{ task, kind, path }]。 */
+export function parseGlobalRegistry(text) {
+  const rows = [];
+  for (const raw of String(text || '').split(/\r?\n/)) {
+    const line = raw.trim();
+    if (!line.startsWith('|')) continue;
+    const cells = cellsOf(line);
+    if (cells.length < 3) continue;
+    if (cells[0] === '任务') continue;
+    if (cells.every((c) => /^[-:\s]*$/.test(c))) continue;
+    rows.push({ task: cells[0], kind: cells[1] || '', path: cells[2] });
+  }
+  return rows;
+}
+
+const KIND_LABEL = { project: '项目', misc: '杂项', 'global-task': '全局任务' };
+
+/** 扫描磁盘上的任务注册，重建全局总注册。返回 { rows, file, changed }。 */
+export function syncGlobalRefs(ws) {
+  const root = String(ws || '');
+  const rows = [];
+  const pushFrom = (base, kind, nameOf) => {
+    let names = [];
+    try { names = fs.readdirSync(base); } catch { return; }
+    for (const name of names) {
+      const dir = path.join(base, name);
+      if (fs.existsSync(path.join(dir, '.deregistered.json'))) continue;
+      const file = path.join(dir, REGISTRY_NAME);
+      if (!isFile(file)) continue;
+      rows.push({ task: nameOf(name), kind: KIND_LABEL[kind] || kind, path: path.join(base, name, REGISTRY_NAME), mtime: 0 });
+    }
+  };
+  pushFrom(path.join(root, '_Project_Meta'), 'project', (n) => n);
+  pushFrom(path.join(root, '_Misc', 'tasks'), 'misc', (n) => n);
+  pushFrom(path.join(root, '_Control_Center', 'tasks'), 'global-task', (n) => n);
+  rows.sort((a, b) => (a.kind === b.kind ? a.task.localeCompare(b.task, 'zh') : a.kind.localeCompare(b.kind)));
+  const file = path.join(root, GLOBAL_REGISTRY_REL);
+  const lines = ['# 体系注册（全局）', '', '| 任务 | 类别 | 体系文件 |', '|---|---|---|'];
+  for (const r of rows) lines.push('| ' + r.task + ' | ' + r.kind + ' | ' + wrap(r.path) + ' |');
+  lines.push('');
+  lines.push('本文件只列各任务体系文件的路径；各任务体系正文不注入全局提示段。');
+  const body = lines.join(NL) + NL;
+  let changed = true;
+  try { changed = readUtf8(file) !== body; } catch { changed = true; }
+  if (changed) {
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    const tmp = file + '.tmp-' + process.pid;
+    fs.writeFileSync(tmp, body, 'utf8');
+    fs.renameSync(tmp, file);
+  }
+  return { rows, file, changed, body };
+}
+
+/** 全局总注册正文；不存在时按磁盘重建。 */
+export function readGlobalRegistry(ws) {
+  const synced = syncGlobalRefs(ws);
+  return { file: synced.file, exists: true, text: synced.body, rows: synced.rows };
+}
+
+/** 注册内容注入块：全局只注入引用清单；项目与杂项注入本任务注册全文（压缩为一行一条）。 */
+export function systemBlock(ws, info) {
+  const lin = lineageOf(info);
+  if (!lin) return '';
+  if (lin.kind === 'global') {
+    const g = readGlobalRegistry(ws);
+    if (!g.rows.length) return '体系注册（全局）：暂无任务体系；新建任务后由插件登记路径。';
+    const lines = ['体系注册（全局；只列路径，不注入各任务正文）'];
+    for (const r of g.rows) lines.push('- ' + normRel(r.path) + ' —— ' + r.kind + '「' + r.task + '」');
+    return lines.join(NL);
+  }
+  const reg = readRegistry(ws, info);
+  if (!reg.exists) return '体系注册：未设置（首轮讨论体系后用 ho_docmap(action="write") 注册）';
+  const d = reg.data;
+  const lines = ['体系注册（' + lineageLabel(info) + '）'];
+  for (const e of d.structure) lines.push('- 目录 ' + normRel(e.path) + '：' + (e.about || ''));
+  for (const e of d.files) lines.push('- 规范 ' + normRel(e.path) + '：' + (e.about || '') + (e.when ? '（' + e.when + '）' : ''));
+  if (d.plan) lines.push('- 计划 ' + normRel(d.plan));
+  return lines.join(NL);
+}
+
+/** 注册文件签名：文件不存在为 'none'；用于热更新判断。 */
+export function registrySignature(ws, info) {
+  const lin = lineageOf(info);
+  if (!lin) return '';
+  if (lin.kind === 'global') {
+    try {
+      const st = fs.statSync(path.join(String(ws || ''), GLOBAL_REGISTRY_REL));
+      return 'g:' + st.size + ':' + Math.round(st.mtimeMs);
+    } catch { return 'g:none'; }
+  }
+  const file = registryAbsPath(ws, info);
+  if (!file) return '';
+  try {
+    const st = fs.statSync(file);
+    return 'r:' + st.size + ':' + Math.round(st.mtimeMs);
+  } catch { return 'r:none'; }
+}
+
+/** 体检：校验某类别的注册路径；不传 info 时检查全部。返回 { rows, missing }。 */
+export function checkRegistries(ws, info) {
+  const targets = [];
+  if (info) targets.push(info);
+  else {
+    try {
+      for (const name of fs.readdirSync(path.join(String(ws || ''), '_Project_Meta'))) {
+        if (isFile(path.join(ws, '_Project_Meta', name, REGISTRY_NAME))) targets.push({ role: 'project', project: name });
+      }
+    } catch { /* 无项目元数据 */ }
+    try {
+      for (const name of fs.readdirSync(path.join(String(ws || ''), '_Misc', 'tasks'))) {
+        if (isFile(path.join(ws, '_Misc', 'tasks', name, REGISTRY_NAME))) targets.push({ role: 'misc', task: name });
+      }
+    } catch { /* 无杂项任务 */ }
+    try {
+      for (const name of fs.readdirSync(path.join(String(ws || ''), '_Control_Center', 'tasks'))) {
+        if (isFile(path.join(ws, '_Control_Center', 'tasks', name, REGISTRY_NAME))) targets.push({ role: 'global-task', task: name });
+      }
+    } catch { /* 无全局任务 */ }
+  }
+  const rows = [];
+  let missing = 0;
+  for (const t of targets) {
+    const reg = readRegistry(ws, t);
+    const entries = reg.data.structure.concat(reg.data.files);
+    const bad = validateEntries(ws, entries);
+    const planBad = reg.data.plan && pathProblem(ws, reg.data.plan) ? [{ path: reg.data.plan, problem: pathProblem(ws, reg.data.plan) }] : [];
+    missing += bad.length + planBad.length;
+    rows.push({ label: lineageLabel(t), rel: normRel(registryRelPath(t) || ''), exists: reg.exists, entries: entries.length, bad: bad.concat(planBad) });
+  }
+  return { rows, missing };
+}
+
+/** 写任务级注册：原子写，写前备份。 */
+export function writeRegistry(ws, info, data) {
+  const file = registryAbsPath(ws, info);
+  if (!file) throw new Error('没有可写的注册路径：角色未定');
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  let backup = '';
+  if (isFile(file)) {
+    backup = file + '.bak';
+    try { fs.copyFileSync(file, backup); } catch { backup = ''; }
+  }
+  const body = renderRegistry(info, data);
+  const tmp = file + '.tmp-' + process.pid;
+  fs.writeFileSync(tmp, body, 'utf8');
+  fs.renameSync(tmp, file);
+  return { file, backup, bytes: Buffer.byteLength(body, 'utf8') };
+}
+
+// ---------------------------------------------------------------- 计划
+
+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());
+}
+
+/** 归档旧计划到任务根 _archive/，返回归档路径；没有旧计划返回空串。 */
+export function archivePlan(ws, info) {
+  const rel = planRelPath(ws, info);
+  if (!rel) return '';
+  const abs = path.join(String(ws || ''), rel);
+  if (!isFile(abs)) return '';
+  const dir = path.join(path.dirname(abs), '_archive');
+  fs.mkdirSync(dir, { recursive: true });
+  const dst = path.join(dir, 'PLAN_' + stamp() + '.md');
+  fs.renameSync(abs, dst);
+  return dst;
+}
+
+export function readPlan(ws, info) {
+  const rel = planRelPath(ws, info);
+  const abs = rel ? path.join(String(ws || ''), rel) : '';
+  if (!abs || !isFile(abs)) return { rel, exists: false, text: '' };
+  try { return { rel, exists: true, text: readUtf8(abs) }; }
+  catch { return { rel, exists: true, text: '', error: '读取失败' }; }
+}
+
+/** 写计划：先归档旧计划，再原子写入。返回 { rel, archived, bytes }。 */
+export function writePlan(ws, info, text) {
+  const rel = planRelPath(ws, info);
+  if (!rel) throw new Error('没有可写的计划路径：角色未定');
+  const archived = archivePlan(ws, info);
+  const abs = path.join(String(ws || ''), rel);
+  fs.mkdirSync(path.dirname(abs), { recursive: true });
+  const body = String(text || '');
+  const tmp = abs + '.tmp-' + process.pid;
+  fs.writeFileSync(tmp, body, 'utf8');
+  fs.renameSync(tmp, abs);
+  return { rel, archived, bytes: Buffer.byteLength(body, 'utf8') };
+}
+
+/** 把计划写入本任务注册的「计划」一节；注册不存在时返回 false。 */
+export function pointRegistryToPlan(ws, info) {
+  const reg = readRegistry(ws, info);
+  if (!reg.exists) return false;
+  const rel = planRelPath(ws, info);
+  const data = { structure: reg.data.structure, files: reg.data.files, plan: rel };
+  writeRegistry(ws, info, data);
+  return true;
+}

package/src/lib/zstd-log.mjs

@@ -1,4 +1,4 @@
-/** DSH 会话日志：定位 + 多帧 zstd 解码（与 handover_check.mjs 同一做法）。 */
+/** DSH 会话日志：定位 + 多帧 zstd 解码（坏帧跳过）。 */
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';

package/src/selftest.mjs

@@ -1,14 +1,13 @@
 /**
  * 脱离 DSH 的自测台：用假 env 直接跑工具 execute，打印只读结果，供人工比对；不参与发布门禁。
- * 用法：node selftest.mjs [--ws <工作区根>] [--session <session id>] [--tool brief|gate|sessions|phase|charter|all]
+ * 用法：node selftest.mjs [--ws <工作区根>] [--session <session id>] [--tool status|gate|sessions|charter|office|succeed|all]
  */
 import { resolveConfig } from './lib/config.mjs';
 import { projCacheDir, pressurePct } from './lib/sessions.mjs';
 import { readJsonDir, isDir } from './lib/text.mjs';
-import { pmBriefTool } from './tools/ho_brief.mjs';
+import { pmStatusTool } from './tools/ho_status.mjs';
 import { pmGateTool } from './tools/ho_gate.mjs';
 import { pmSessionsTool } from './tools/ho_sessions.mjs';
-import { pmPhaseTool } from './tools/ho_phase.mjs';
 import { pmCharterTool } from './tools/ho_charter.mjs';
 import { pmOfficeTool } from './tools/ho_office.mjs';
 import { pmSucceedTool } from './tools/ho_succeed.mjs';
@@ -65,10 +64,11 @@ const envSucceed = Object.assign({}, env, {
 
 const exec = null;
 const cases = [
-  { t: pmBriefTool(env), a: {}, flag: "brief" },
+  { t: pmStatusTool(env, { schedulerReady: () => false, schedulerError: () => 'selftest' }), a: { view: "brief" }, flag: "status" },
+  { t: pmStatusTool(env, { schedulerReady: () => false, schedulerError: () => 'selftest' }), a: { view: "phase" }, flag: "status" },
+  { t: pmStatusTool(env, { schedulerReady: () => false, schedulerError: () => 'selftest' }), a: { view: "diag" }, flag: "status" },
   { t: pmGateTool(env), a: { scope: "all" }, flag: "gate" },
   { t: pmSessionsTool(env), a: {}, flag: "sessions" },
-  { t: pmPhaseTool(env), a: {}, flag: "phase" },
   { t: pmCharterTool(env), a: { doc: "charter", section: "8.1.1.4", maxLines: 30 }, flag: "charter" },
   { t: pmOfficeTool(env), a: { query: "全局" }, flag: "office" },
   { t: pmSucceedTool(envSucceed), a: {}, flag: "succeed", want: /没有授权/ },
@@ -77,7 +77,7 @@ const cases = [
 let failed = 0;
 for (const c of cases) {
   if (only !== "all" && only !== c.flag) continue;
-  const bar = "==== ho_" + c.flag + " ====";
+  const bar = "==== " + c.t.name + " " + JSON.stringify(c.a) + " ====";
   console.log(bar);
   try {
     const out = await c.t.execute(c.a, exec);

package/src/templates/Changelog.skeleton.md

@@ -1,7 +1,7 @@
-# Global Handover Changelog（全局交接变更日志）
+# 全局交接台账
 
-> 追加式历史日志。每次改动 _Control_Center 的全局规则、结构或 Global_Handover.md 本身时，追加一行。
-> 由插件 ho_changelog 按格式追加（新行插在最新一行之前）。
+> 追加式历史记录。每次修改 `_Control_Center` 的全局规则、结构或 `Global_Handover.md` 本身时，追加一行。
+> 由插件 `ho_changelog` 按格式追加（新行插在最新一行之前）。
 
 ## 变更记录
 

package/src/templates/Charter.skeleton.md

@@ -1,13 +1,13 @@
 # Workspace Charter（骨架）
 
-> 本文件由 dsh-handover 首次安装向导生成，只含可运行所需的最小内容；按需继续写。
-> 铁律：§8.1.1.4 那 24 行是唯一正文来源，任何项目库的 RULES.md 都要逐字复制它（外加一行「上下文水位自查」）。改这里就必须同步改所有库。
+> 本文件由 dsh-handover 首次安装向导生成，只含可运行所需的最小内容；其余内容按需补充。
+> 铁律：§8.1.1.4 的 24 行是唯一正文来源，任何项目库的 RULES.md 都须逐字复制该节（外加一行「上下文水位自查」）。修改本节须同步修改全部库。
 
 ## 8. 工程约束
 
-### 8.1.1.4 项目侧通用约束条（可直接粘贴；改这里就要重新同步所有项目）
+### 8.1.1.4 项目侧通用约束条（可直接粘贴；修改本节须重新同步全部项目）
 
-> 同步方式＝把下面代码块的内容逐行复制进 `Projects/<项目名>/<库名>/RULES.md`，再加一行「上下文水位自查」。
+> 同步方式：将下列代码块内容逐行复制进 `Projects/<项目名>/<库名>/RULES.md`，并追加一行「上下文水位自查」。
 
 ```markdown
 **运行期省 token（通用约束；项目无关，全部在役项目共用这一份正文；数值按 27 个退役会话跨项目实测定）**
@@ -41,13 +41,17 @@
 
 ## 9. 上下文水位自查
 
-每个项目库的 `RULES.md` 必须含一行「上下文水位自查」（说明该库会话在多少水位时写交接、多少时换任）。
-闸门（ho_gate）会逐库检查：标题行在、24 行正文一行不缺、水位自查在。缺任何一项，该库判红。
+每个项目库的 `RULES.md` 应含一行「上下文水位自查」。水位 35% 写毕交接，水位 50% 不再新开任务，水位 85% 为硬顶；压缩至多 3 次，第 4 次换任。
+`ho_gate` 会逐库检查：标题行存在、24 行正文一行不缺、水位自查存在。缺任何一项，该库判定为未通过。
 
 ## 10. 工作区约定
 
-- 全局交接：`_Control_Center/records/Global_Handover.md`（ho_handover 读写，写前自动备份）
-- 台账：`_Control_Center/records/Global_Changelog.md`（ho_changelog 按格式追加）
-- 会话提示词模板：`_Control_Center/templates/Prompt_Templates.md`（ho_sessions 的 action=prompt 渲染）
+- 全局交接：`_Control_Center/records/Global_Handover.md`（由 `ho_handover` 读写，整篇重写前先归档）
+- 台账：`_Control_Center/records/Global_Changelog.md`（由 `ho_changelog` 按格式追加）
+- 会话提示词模板：`_Control_Center/templates/Prompt_Templates.md`（由 `ho_sessions` 的 `action=prompt` 渲染）
+- 体系注册：全局总注册 `_Control_Center/records/systems.md`（只列各任务体系文件路径），各任务一份 `System.md`（全局任务 `_Control_Center/tasks/<任务名>/System.md`、项目 `_Project_Meta/<项目名>/System.md`、杂项 `_Misc/tasks/<任务名>/System.md`）
+- 行动计划：任务根 `PLAN.md`；新建计划前归档旧计划到任务根 `_archive/`
+- 暂任提示词：任务根 `Delegation_Prompt.md`；规则见 `_Control_Center/rules/Delegation_Rules.md`
+- 写作规范：`_Control_Center/standards/写作规范/README.md`（W-01 至 W-42）
 - 项目库：`Projects/<项目名>/<库名>/`，每库一份 `RULES.md`；项目交接在 `_Project_Meta/<项目名>/Handover.md`
 - 杂项：`_Misc/tasks/<任务短名>/`；归档 `_Archives/`；临时与快照 `_Temp/`

package/src/templates/Handover.global.skeleton.md

@@ -1,6 +1,6 @@
-# 全局 交接文档
+# 全局交接文档
 
-> 本文件由 **dsh-handover 首次安装向导**生成。§7 里那行 session id 是**占位**——第一个全局会话接手时把它换成本机真实的 id。
+> 本文件由 dsh-handover 首次安装向导生成。§7 中带 session id 的行是占位，第一个全局会话接手时将其换成本机真实的 id。
 
 ## 0. 身份与寻址
 
@@ -12,21 +12,23 @@
 | 接任 | 无（首任） |
 | 上级、报告对象 | 用户 |
 | 本文件 | _Control_Center/records/Global_Handover.md |
-| 冲突以谁为准 | rules/Workspace_Charter.md |
+| 冲突以谁为准 | _Control_Center/rules/Workspace_Charter.md |
 | 修订 | 首次安装向导生成 |
 
 ## 1. 正在做的事
 
 | 项 | 现状 |
 |---|---|
-| 初始化 | 工作区骨架已生成；等第一个标题含「全局」的会话接手 |
+| 初始化 | 工作区骨架已生成；等待第一个标题含「全局」的会话接手 |
+| 体系注册 | 全局总注册已建立路径清单，尚无任务入口；任务建立后由全局增行 |
 
 ## 2. 下一步
 
 | # | 动作 | 落点 | 完成判据 |
 |---|---|---|---|
-| 1 | 全局会话接手：核闸门、把 §0 身份信息填实 | 本文件 §0 | ho_gate 三项全绿 |
-| 2 | 按需新建项目库 | Projects/ | 各库 RULES.md 24/24 ＋ 上下文水位自查 |
+| 1 | 全局会话接手：核对闸门、补全 §0 身份信息 | 本文件 §0 | `ho_gate` 3 项全部通过 |
+| 2 | 按需新建项目库 | Projects/ | 各库 RULES.md 24/24 且含上下文水位自查 |
+| 3 | 建立任务体系注册并登记全局总注册 | `_Control_Center/records/systems.md` | `ho_docmap` 检查路径全部有效 |
 
 ## 3. 待用户决定
 
@@ -36,18 +38,23 @@
 
 | # | 用户原话要点 | 状态 | 落在哪 |
 |---|---|---|---|
-| 1 | 安装插件并在指定目录建好全局根 | 已落地 | 本文件 |
+| 1 | 安装插件并在指定目录建立全局根 | 已落地 | 本文件 |
 
-## 5. 坑点与禁区
+## 5. 风险与禁区
 
-- 禁区：改 §8.1.1.4 那 24 行正文会让所有项目库对不上——要改就同步改全部库。
+- 禁区：修改 §8.1.1.4 的 24 行正文后，各项目库的 `RULES.md` 会与本章程不一致；确需修改须同步全部库。
+- 风险：项目库内文件由该项目会话自行修改；全局代写会使交接与库内事实分离。
 
 ## 6. 关键路径
 
-- 交接：_Control_Center/records/Global_Handover.md
-- 规则：_Control_Center/rules/Workspace_Charter.md
-- 台账：_Control_Center/records/Global_Changelog.md
-- 提示词模板：_Control_Center/templates/Prompt_Templates.md
+- 交接：`_Control_Center/records/Global_Handover.md`
+- 规则：`_Control_Center/rules/Workspace_Charter.md`
+- 体系注册：`_Control_Center/records/systems.md`（全局总注册）、`_Control_Center/tasks/` 下各全局任务的 `System.md`
+- 计划：各全局任务根 `PLAN.md`
+- 暂任规则：`_Control_Center/rules/Delegation_Rules.md`
+- 写作规范：`_Control_Center/standards/写作规范/README.md`
+- 台账：`_Control_Center/records/Global_Changelog.md`
+- 提示词模板：`_Control_Center/templates/Prompt_Templates.md`
 
 ## 7. 会话 id 对照
 

package/src/templates/Handover.template.md

@@ -0,0 +1,89 @@
+# 交接文档模板
+
+> 本文件是 dsh-handover 随插件发布的交接模板。写交接前先读第 1 节的固定流程，再按第 2 节的总则逐节填写。
+> 本文件只规定写法；各节填写细则见第 3 至第 11 节，写完按第 12 节自检。
+
+## 1 固定流程（强约束）
+
+交接一律重写，不得在旧文件上续写、删改或增行。4 步按顺序执行，不得跳步。
+
+| 步 | 动作 | 命令与判据 |
+|---|---|---|
+| 1 | 读上一份交接 | `ho_handover(action="read")`；文件不存在则跳过第 2 步 |
+| 2 | 归档上一份交接 | `ho_handover(action="archive")`；输出「已归档」且 sha256 一致 |
+| 3 | 读本模板 | 读 `_Control_Center/templates/Handover.md`，读完再动笔 |
+| 4 | 新建空白文件并写入 | `ho_handover(action="new", text=…)`；输出「已归档」「已新建」「体检 通过」 |
+
+禁止事项：
+
+- 不用 `ho_handover(action="write")` 改写已有交接，该动作只用于首次创建。
+- 不用 `ho_handover(action="append")` 追加已完成经过；`append` 只用于会话中途补一行推进状态。
+- 不手工编辑交接文件；不把旧交接的章节搬进新文件。
+- 不跳过归档直接写；旧文件内容只进归档，新交接只写在途。
+
+体积不设上限：不规定字节、行数、页数。体积由结构控制，只写在途与指针；过期内容即删，经历一段时间后按归档重写。
+
+## 2 总则：只写在途
+
+| 应当写 | 不应写 |
+|---|---|
+| 正在做到哪一步、下一步、待用户决定、风险与禁区、关键路径 | 已完成经过、验证记录、需求全文、逐版构建明细、里程碑 |
+| 指向别处的路径（台账、归档、计划、体系注册、规则文件） | 别处已写的内容副本 |
+| 状态用表格或短句，动作写「动作、落点、判据」 | 叙述性过程与理由解释 |
+
+已完成经过写 `_Control_Center/records/Global_Changelog.md`；项目与杂项写本任务台账或提交说明。需求全文写任务根 `PLAN.md` 或任务库文档。旧交接归档到 `_Archives/<范围>/Handover/`；杂项归档在 `_Misc/tasks/<任务>/_archive/`。
+
+## 3 阅读顺序与填写顺序
+
+- 阅读顺序：§0 → §1 → §2 → §4 → §3 → §5 → §6 → §7。
+- 填写顺序：§1 → §2 → §4 → §3 → §5 → §6 → §7 → §0。
+- 交叉引用只指向已填写的小节；回填后复核编号。
+
+## 4 §0 身份与寻址
+
+写明交接双方与按 id 寻址的对象。全局交接必填 7 项：会话类型、本任、链内代数、接任、本文件、冲突以谁为准、修订。
+
+- 「本任」写标题、session id、交接时刻与上下文使用率。
+- 「链内代数」写「第 N 代」，每换一任递增 1。
+- 「修订」只记本次重写改了什么；其他小节不得回写。
+- 不写职责、权限与任务边界，相关内容见章程与规范文件。
+
+## 5 §1 正在做的事
+
+只写状态：已推进至哪一步、尚差哪一步。动作写在 §2，本节不写下一步。存在多个在途事项时，一项一行，标明各自状态。
+
+## 6 §2 下一步
+
+每行一个动作，3 项齐备：动作、落点（文件或命令）、完成判据。按执行顺序排列；判据应可当场验证，不写「继续完善」这类没有终点的条目。
+
+## 7 §3 待用户决定
+
+只列需由用户决定的事项，一项一行，给出选项与建议，并写明该事项阻塞的下一步条目。建议不构成授权，未决定前不得按建议行动。
+
+## 8 §4 用户要求逐条落位
+
+从最近一轮用户消息回溯，只列未闭环的 4 类：待验收、已反馈待处理、未落地、未定。每条带用户原话摘要与落点；已验收只认用户明确表态，沉默不算验收。与 §2 同源的条目写「见 §2-N」，不重复描述动作。
+
+## 9 §5 风险与禁区
+
+- 5.1 风险：一条一行「现象 → 正确做法」，只写本会话遇到或核对过的事项。
+- 5.2 禁区：一条一行「禁止动作 → 原因」，防止接任者出于好意而误操作。
+- 章程或规范文件已载明的内容，只给一行路径，不复制正文。
+
+## 10 §6 关键路径
+
+只写下一步要直接使用的绝对路径与命令，不列目录树与文件清单。每条须在写交接前当场核对；无法核对时注明「未核，待确认」。
+
+## 11 §7 会话 id 对照
+
+全局必填，项目与杂项可删本节。只列在任与仍需联络的会话，不列已交出的；每行必须带 session id。
+
+## 12 写完自检
+
+1. 4 步流程是否照做，旧交接是否已归档。
+2. §1 与 §2 是否一致，是否有已完成经过混入。
+3. 每个下一步是否都有落点与可验证的判据。
+4. §6 的路径与命令是否当场核过。
+5. §0 的代数、修订与本任 id 是否准确。
+6. 通读全文，确认接任者可一次读完。
+7. 体检是否通过：`ho_gate` 或写入回执中的「体检 通过」。

package/src/templates/Plan.skeleton.md

@@ -0,0 +1,34 @@
+# 行动计划（<任务名>）
+
+> 本文件是任务当前唯一的计划，位于任务根 `PLAN.md`。新建计划前将旧计划移入任务根 `_archive/PLAN_<YYYYMMDD_HHMMSS>.md`，归档后不读旧计划。
+
+## 1 目标
+
+<用一句话说明本计划要达成的结果，并写明判定完成的客观依据>
+
+## 2 步骤
+
+| # | 步骤 | 落点 | 完成判据 |
+|---|---|---|---|
+| 1 | <做什么> | `<路径>` | <执行什么、观察到什么可判定完成> |
+| 2 | <做什么> | `<路径>` | <完成判据> |
+
+## 3 验收
+
+- <可机械判定的验收条件一>
+- <可机械判定的验收条件二>
+- 未执行的验证不写入验收结论；区分「已完成待验收」与「要求了未落地」。
+
+## 4 风险
+
+- <风险：已识别的问题与应对>
+- <禁区：本次不得修改的文件或目录>
+
+## 5 状态
+
+| 项 | 值 |
+|---|---|
+| 状态 | <未开始、进行中、暂停、完成> |
+| 最近更新 | <YYYY-MM-DD HH:MM +0800> |
+| 关联交接 | <交接绝对路径> |
+| 关联体系注册 | <System.md 绝对路径> |