@mingmaple/dsh-handover 0.9.22 → 1.0.0

package/src/tools/ho_handover.mjs

@@ -1,21 +1,19 @@
-/** ho_handover —— 读/写/追加/归档**本会话自己的**交接（路径按角色解析；写前备份、写后按角色体检）。 */
+/** ho_handover —— 读/新建/追加/归档**本会话自己的**交接（路径按角色解析；整篇重写先归档旧交接，写后按角色体检）。 */
 import { textOutput } from '../lib/output.mjs';
 import { nameOf } from '../lib/names.mjs';
 import { NL } from '../lib/text.mjs';
-import fs from 'node:fs';
 import path from 'node:path';
-import crypto from 'node:crypto';
-import { readHandover, writeHandover, archiveStamp, archiveFileName } from '../lib/handover-io.mjs';
-import { archiveDirFor } from '../lib/role.mjs';
+import { readHandover, writeHandover, rewriteHandover, archiveHandover } from '../lib/handover-io.mjs';
+import { assertTaskName } from '../lib/role.mjs';
 
 function noPath(input) {
   const reason = input && input.reason ? input.reason : '未知原因';
   return [
     '没有可用的交接路径：' + reason,
-    '两条处置：',
-    '  ① 在设置页的 dsh-handover 中「会话角色」给本会话指定角色（项目角色要填项目名）；',
+    '处置：',
+    '  ① 在设置页的 dsh-handover 中「会话角色」给本会话指定角色（项目角色须填项目名）；',
     '  ② 临时显式传 path="<交接文件绝对路径>"。',
-    '（插件不再默认读全局交接——那是以前会串角色的老行为。）',
+    '（插件不再默认读全局交接：旧版行为会导致角色串用。）',
   ].join(NL);
 }
 
@@ -23,58 +21,86 @@ export function pmHandoverTool(env) {
   return {
     name: nameOf('handover'),
     description:
-      '读写、追加、归档本会话自己的交接；写前备份、写后按角色体检。',
+      '读写、新建、追加、归档交接；整篇重写用 new（先归档旧交接，再新建空白文件写入）；项目与杂项会话读写自己的交接，全局会话可用 task 指向某个全局任务。写后按角色体检。',
     parameters: {
       type: 'object',
       additionalProperties: false,
       required: ['action'],
       properties: {
-        action: { type: 'string', enum: ['read', 'write', 'append', 'archive'], description: 'read | write | append | archive' },
-        text: { type: 'string', description: 'write/append 时的正文（read/archive 忽略）' },
+        action: { type: 'string', enum: ['read', 'new', 'write', 'append', 'archive'], description: 'read | new（整篇重写：归档旧交接后新建空白写入）| write（仅首次创建）| append | archive' },
+        text: { type: 'string', description: 'new/write/append 时的正文（read/archive 忽略）' },
         path: { type: 'string', description: '覆盖默认路径（演练或强制指定时用）' },
+        task: { type: 'string', description: '全局会话读写某个全局任务的交接：_Control_Center/tasks/<任务>/Handover.md' },
       },
     },
     output: textOutput(),
     async execute(args, exec) {
       const ws = env.resolveWs(exec);
       const info = env.roleOf(exec);
-      const target = args.path
-        ? { path: args.path, kind: info.role === 'project' ? 'project' : info.role === 'misc' ? 'misc' : 'global', role: info.role, project: info.project, task: info.task }
-        : env.handoverFor(exec);
+      const taskName = String(args.task || '').trim();
+      let target = null;
+      if (taskName) {
+        if (info.role !== 'global') throw new Error('task 参数只对全局会话开放');
+        assertTaskName(taskName);
+        target = {
+          path: path.join(ws, '_Control_Center', 'tasks', taskName, 'Handover.md'),
+          kind: 'project', role: 'global-task', task: taskName,
+        };
+      } else {
+        target = args.path
+          ? { path: args.path, kind: info.role === 'project' ? 'project' : info.role === 'misc' ? 'misc' : 'global', role: info.role, project: info.project, task: info.task }
+          : env.handoverFor(exec);
+      }
       if (!target || !target.path) return { text: noPath(target) };
+      const archiveOpts = taskName
+        ? {
+            info: { role: 'misc', task: taskName },
+            archiveDir: path.join(ws, '_Archives', '_Global', 'tasks', taskName, 'Handover'),
+          }
+        : { kind: target.kind, info };
+      const snapOpts = taskName
+        ? { kind: target.kind, info: { role: 'misc', task: taskName }, snapshotDir: path.join(ws, '_Temp', '_Global', 'tasks', taskName, 'Snapshots') }
+        : { kind: target.kind, info };
 
       if (args.action === "read") {
         const r = readHandover(target.path);
-        if (r.text === null) return { text: "交接文档不存在：" + target.path + NL + "（第一次写用 action=write 或 action=append）" };
+        if (r.text === null) return { text: "交接文档不存在：" + target.path + NL + "（首次创建用 action=write；整篇重写用 action=new）" };
         return { text: r.text };
       }
       if (args.action === "archive") {
-        const src = readHandover(target.path);
-        if (src.text === null) throw new Error("要归档的交接不存在：" + target.path);
-        const stampText = archiveStamp(new Date());
-        const dir = archiveDirFor(ws, info);
-        fs.mkdirSync(dir, { recursive: true });
-        // 命名按 Handover_Rules §4.2：<原文件名>_<YYYYMMDD_HHMMSS>.md；同一秒重复归档加 -2、-3。
-        let dest = path.join(dir, archiveFileName(target.path, stampText));
-        for (let n = 2; fs.existsSync(dest) && n < 100; n++) {
-          dest = path.join(dir, archiveFileName(target.path, stampText + "-" + n));
-        }
-        if (fs.existsSync(dest)) throw new Error("归档目标已存在，不覆盖：" + dest);
-        fs.copyFileSync(target.path, dest);
-        const a = crypto.createHash("sha256").update(fs.readFileSync(target.path)).digest("hex");
-        const b = crypto.createHash("sha256").update(fs.readFileSync(dest)).digest("hex");
+        if (!readHandover(target.path).text) throw new Error("要归档的交接不存在：" + target.path);
+        const a = archiveHandover(ws, target.path, archiveOpts);
+        return { text: "已归档 " + a.dest + "（" + a.bytes + " B）" + NL + "sha256 一致 " + a.sha256.slice(0, 16) + "…" };
+      }
+      if (args.action === "new") {
+        if (typeof args.text !== "string" || args.text.trim() === "") throw new Error("new 需要 text");
+        const res = rewriteHandover(ws, target.path, args.text, Object.assign({}, snapOpts, archiveOpts));
         const out = [];
-        out.push("已归档 " + dest + "（" + fs.statSync(dest).size + " B）");
-        out.push("sha256 " + (a === b ? "一致 " + a.slice(0, 16) + "…" : "**不一致，归档失败**"));
+        out.push(res.archived
+          ? (res.archived.reused
+            ? "已归档（复用内容相同的副本）" + res.archived.dest + "（" + res.archived.bytes + " B）"
+            : "已归档 " + res.archived.dest + "（" + res.archived.bytes + " B，sha256 一致）")
+          : "原交接不存在，直接新建（无需归档）");
+        out.push("已新建 " + res.path + "（" + res.bytes + " B）· 角色 " + (taskName ? 'global-task' : info.role) + (taskName ? " · 任务「" + taskName + "」" : ""));
+        out.push("体检 " + res.verdict + (res.reasons.length ? "" : " · 结构齐备"));
+        for (const r of res.reasons) out.push("  - " + r);
+        if (res.verdict !== "通过") out.push("提示：修正后重跑 action=new（将再次归档当前文件）。");
         return { text: out.join(NL) };
       }
       if (args.action !== "write" && args.action !== "append") {
-        throw new Error("未知 action：" + String(args.action) + "（只能是 read | write | append | archive）");
+        throw new Error("未知 action：" + String(args.action) + "（只能是 read | new | write | append | archive）");
+      }
+      if (typeof args.text !== "string" || args.text.trim() === "") throw new Error(args.action + " 需要 text");
+      if (args.action === "write" && readHandover(target.path).text) {
+        throw new Error(
+          "交接已存在，不能用 write 改写：" + target.path + NL
+          + "整篇重写按固定流程：① ho_handover(action=\"read\") 读旧交接；② ho_handover(action=\"archive\") 归档；③ 读模板 _Control_Center/templates/Handover.md；④ ho_handover(action=\"new\", text=…) 新建空白写入。",
+        );
       }
-      if (typeof args.text !== "string" || args.text.trim() === "") throw new Error("write/append 需要 text");
-      const res = writeHandover(ws, target.path, args.text, args.action === "append" ? "append" : "write", { kind: target.kind, info });
+      const res = writeHandover(ws, target.path, args.text, args.action, snapOpts);
       const out = [];
-      out.push("已写入 " + res.path + "（" + res.bytes + " B）· 角色 " + info.role + (target.kind !== 'global' ? "（" + (info.project || info.task) + "）" : ""));
+      const scope = taskName ? '全局任务「' + taskName + '」' : (target.kind !== 'global' ? '（' + (info.project || info.task) + '）' : '');
+      out.push("已写入 " + res.path + "（" + res.bytes + " B）· 角色 " + (taskName ? 'global-task' : info.role) + scope);
       out.push("备份 " + (res.backup || "（原文件不存在，无需备份）"));
       out.push("体检 " + res.verdict + (res.reasons.length ? "" : " · 结构齐备"));
       for (const r of res.reasons) out.push("  - " + r);

package/src/tools/ho_office.mjs

@@ -1,18 +1,28 @@
-/** ho_office —— 在任登记表：查某条类别现在由哪个会话在任（只读）。 */
+/** ho_office —— 在任登记表：查在任；也用于会话首次注册自己的名字。 */
 import { textOutput } from '../lib/output.mjs';
 import { nameOf } from '../lib/names.mjs';
 import { NL } from '../lib/text.mjs';
-import { loadOffice, resolveOffice, rowsOf, formatRow, officePath } from '../lib/office.mjs';
+import { loadOffice, resolveOffice, rowsOf, formatRow, officePath, registerHolder, lineageKeyOf } from '../lib/office.mjs';
+
+function validDisplayName(name) {
+  const s = String(name || '').trim();
+  if (!s) return '名字不能为空';
+  if (s.length > 40) return '名字不超过 40 个字符';
+  if (/[\\/:*?"<>|\r\n]/.test(s)) return '名字不能含路径分隔符或换行';
+  return '';
+}
 
 export function pmOfficeTool(env) {
   return {
     name: nameOf('office'),
     description:
-      '查在任：输入「全局」「全局3」「项目名」等，返回现任会话的名字与 id；多个用空格分隔，留空列全部。只读。',
+      '在任登记：query 查在任（缺省）；action=register 由本会话首次注册自身名称，注册后不得自行修改。',
     parameters: {
       type: 'object',
       additionalProperties: false,
       properties: {
+        action: { type: 'string', enum: ['read', 'register'], description: '缺省 read；register 首次注册名字' },
+        name: { type: 'string', description: 'action=register 时的注册名（≤40 字，不含路径分隔符）' },
         query: { type: 'string', description: '要查的名字，如「全局」「全局3」「Demo1」「示例任务」；多个用空格或逗号分隔；留空＝列出全部在任' },
         json: { type: 'boolean', description: 'true 时输出机器可读 JSON（供脚本解析）' },
       },
@@ -21,10 +31,41 @@ export function pmOfficeTool(env) {
     async execute(args, exec) {
       const ws = env.resolveWs(exec);
       if (!ws) return { text: '无法确定工作区根，读不到在任登记表。' };
+      const action = typeof args.action === 'string' && args.action ? args.action : 'read';
+      if (action === 'register') {
+        const meId = String(env.selfId(exec) || '');
+        if (!meId) throw new Error('无法取得本会话 id，不能注册');
+        let info = null;
+        try { info = env.roleOf(exec); } catch { info = null; }
+        const role = info && info.role ? info.role : 'plain';
+        if (role !== 'project' && role !== 'misc' && role !== 'global') {
+          throw new Error('普通会话没有注册名；先在设置页设定项目或杂项角色');
+        }
+        const name = String(args.name || '').trim();
+        const bad = validDisplayName(name);
+        if (bad) throw new Error(bad);
+        const kind = role;
+        const project = role === 'project' ? String(info.project || '') : '';
+        const task = role === 'misc' ? String(info.task || '') : '';
+        const key = lineageKeyOf(kind, project, task);
+        const store = loadOffice(ws);
+        const lin = store.lineages[key];
+        const cur = lin && lin.current;
+        if (cur && cur.sessionId && String(cur.sessionId) !== meId) {
+          throw new Error('类别「' + key + '」已有在任会话：' + (cur.name || '') + '（' + cur.sessionId + '）。不得抢注；先由全局处理在任会话。');
+        }
+        if (cur && String(cur.sessionId) === meId) {
+          if (String(cur.name || '') === name) return { text: '已注册：' + name + '（' + key + '）。注册后不得自行修改。' };
+          throw new Error('本会话已注册为「' + cur.name + '」，注册后不得自行修改；改名须找全局。');
+        }
+        const reg = registerHolder(ws, { kind, project, task, name, sessionId: meId });
+        try { if (typeof env.refreshPromptFor === 'function') env.refreshPromptFor(meId); } catch { /* 重装失败不影响注册 */ }
+        return { text: '已注册：' + name + '（' + reg.key + '，会话 ' + meId + '）。注册后不得自行修改；改名须找全局。' };
+      }
       const store = loadOffice(ws);
       const rows = rowsOf(store);
       if (!rows.length) {
-        return { text: '在任登记表还是空的（' + officePath(ws) + '）：先登记一次在任会话，再查。' };
+        return { text: '在任登记表为空（' + officePath(ws) + '）：先登记一次在任会话，再查询。' };
       }
       const raw = String(args.query || '').trim();
       const tokens = raw ? raw.split(/[\s,，、;；]+/).filter(Boolean) : [];

package/src/tools/ho_profile.mjs

@@ -13,7 +13,7 @@ function targetOf(env, info, args, exec) {
     // 项目会话只处理自己的骨架；传了别的名字就明确报错，而不是静默忽略入参（实测踩过）。
     if (given && given !== own) {
       throw new Error('本会话是' + (info.role === 'project' ? '项目「' + own + '」' : '杂项「' + own + '」')
-        + '，只能读写自己的骨架；要看「' + given + '」请由全局会话执行 ho_profile。');
+        + '，只能读写自己的骨架；如需查看「' + given + '」，由全局会话执行 ho_profile。');
     }
     return { role: info.role, project: info.project || '', task: info.task || '', self: true };
   }
@@ -32,7 +32,7 @@ function scopeOf(t) {
 export function pmProfileTool(env) {
   return {
     name: nameOf('profile'),
-    description: '项目或杂项骨架：读取、注册、校验、取预设。只写本角色的 _Project_Meta 或 _Misc 目录。',
+    description: '项目或杂项骨架：读取、注册、校验、取预设。仅写本角色的 _Project_Meta 或 _Misc 目录。',
     parameters: {
       type: 'object',
       additionalProperties: false,
@@ -81,7 +81,7 @@ export function pmProfileTool(env) {
         return { text: out.join(NL) };
       }
       if (action === 'register') {
-        if (!t.self) throw new Error('注册须由该项目或杂项会话本人执行');
+        if (!t.self) throw new Error('注册须由该项目或杂项会话自身执行');
         if (!r.exists) throw new Error('未找到骨架文件：' + p + '。先通读本库并写入该文件，再执行注册。');
         if (r.errors.length) throw new Error('骨架结构不合法：' + r.errors.join('；'));
         const saved = writeProfile(ws, scope, r.profile);

package/src/tools/ho_sessions.mjs

@@ -6,11 +6,12 @@ import { scanSessions } from '../lib/sessions.mjs';
 import { syncCheck } from '../lib/gates.mjs';
 import { stamp } from '../lib/brief.mjs';
 import { sessionNew, sessionPrompt, sessionArchive, sessionUnarchive, sessionOrder, sessionPlace } from '../lib/session-ops.mjs';
+import { createGlobalTask } from '../lib/global-task.mjs';
 import { readRoles, resolveRole, ROLE_LABEL, sessionMeta } from '../lib/role.mjs';
 import { watermark } from '../lib/facts.mjs';
 
 function list(env, args, exec) {
-  const warn = typeof args.warn === "number" ? args.warn : watermark(env.cfg).warnValue;
+  const warn = typeof args.warn === "number" ? args.warn : watermark(env.cfg).remindValue;
   const limit = typeof args.limit === "number" ? args.limit : 40;
   const scan = scanSessions({
     dir: env.cacheDir(),
@@ -26,7 +27,7 @@ function list(env, args, exec) {
     return resolveRole({ cfg: env.cfg, roles: store, sessionId: r.sid, cwd: meta.cwd, firstPrompt: meta.firstPrompt, subagent: meta.subagent, title: r.project });
   };
   const out = [];
-  out.push("活跃 / 沉默线：最后活动 " + stamp(scan.cutoffMs) + " 之后算活跃（" + scan.silentHours + " 小时；Charter 7.2.3）");
+  out.push("活跃与沉默线：最后活动晚于 " + stamp(scan.cutoffMs) + " 记为活跃（" + scan.silentHours + " 小时；Charter 7.2.3）");
   for (const r of scan.rows.slice(0, limit)) {
     const pct = r.pct === null ? "水位 ?" : "水位 " + r.pct.toFixed(1) + "%";
     const lab = r.mtime >= scan.cutoffMs ? "活跃" : "沉默";
@@ -40,15 +41,15 @@ function list(env, args, exec) {
   for (const r of scan.notify) out.push("  要通知【在任】" + r.project + "(" + r.sid + ")  最后活动 " + stamp(r.mtime));
   if (scan.skip.length) out.push("  跳过（沉默项目，含其已交出的旧会话）：" + scan.skip.map((x) => x.project + "(" + x.sid.slice(-8) + ")").join("、"));
   const gate = syncCheck(env.resolveWs(exec));
-  if (gate.error) out.push("通用约束条闸门（Charter §7.2.3）：读不到 §8.1.1.4 正文 —— 请人工核 " + gate.path);
+  if (gate.error) out.push("通用约束条闸门（Charter §7.2.3）：读不到 §8.1.1.4 正文，请人工核对 " + gate.path);
   else if (!gate.ok) {
     const bad = gate.libraries.filter((l) => !l.ok).map((l) => l.name + "(缺 " + l.missing.length + " 行)");
-    out.push("通用约束条闸门（Charter §7.2.3「闸门」）：**未过** —— " + bad.join("、"));
+    out.push("通用约束条闸门（Charter §7.2.3「闸门」）：未通过 —— " + bad.join("、"));
     out.push("判定：通用约束条有库缺，交接前必须补齐（Charter §7.2.3 闸门）");
     return out.join(NL);
   } else out.push("通用约束条闸门（Charter §7.2.3「闸门」）：" + gate.total + "/" + gate.total + " 已落位");
   const verdict = scan.hot.length
-    ? "判定：" + scan.hot.length + " 个会话已进预警区（>=" + warn + "%），按 Charter 7.2.3 先收齐交接再换会话"
+    ? "判定：" + scan.hot.length + " 个会话已进入预警区（>=" + warn + "%），按 Charter 7.2.3 先收齐交接，再换会话"
     : scan.unknown.length
       ? "判定：" + scan.unknown.length + " 个会话水位无法读取，需人工判断"
       : "判定：没有会话进入预警区（>=" + warn + "%），可以继续";
@@ -59,30 +60,32 @@ function list(env, args, exec) {
 export function pmSessionsTool(env) {
   return {
     name: nameOf('sessions'),
-    description: '会话清点与调度；action=role 设置角色、new 建会话、order 下指令（交接、压缩）、place 移入工作区、prompt 出提示词、archive/unarchive 归档。',
+    description: '会话清点与调度：action=list 清点、role 设定角色、new 新建会话（from_task 可把全局任务独立为项目或杂项）、task-init 建全局任务库、order 下达指令、place 移入工作区、prompt 生成启动提示词、archive 与 unarchive 归档。',
     parameters: {
       type: 'object',
       additionalProperties: false,
       properties: {
-        action: { type: 'string', enum: ['list', 'role', 'new', 'order', 'place', 'prompt', 'archive', 'unarchive'], description: '缺省 list' },
-        order: { type: 'string', enum: ['handover', 'compact'], description: 'order 的动作：handover 让它写交接再换任；compact 给它排压缩（先要有合格交接）' },
-        resume: { type: 'string', enum: ['continue', 'wait'], description: 'order=compact 时的去向：缺省 wait（交接后收尾，压缩后不唤醒）；continue 表示压缩后按交接继续' },
-        include_subagents: { type: 'boolean', description: 'list 时含子会话' },
-        limit: { type: 'number', description: 'list 行数（默认 40）' },
-        warn: { type: 'number', description: 'list 预警阈值（默认 ' + watermark(env.cfg).warn + '）' },
-        session_id: { type: 'string', description: 'role/order/place/archive/unarchive 的目标会话' },
-        role: { type: 'string', enum: ['global', 'project', 'misc', 'plain'], description: 'role 要设成的角色；new 时也据此登记接任者角色' },
-        project: { type: 'string', description: '项目名（role=project 必填；new 时为换任项目）' },
-        task: { type: 'string', description: '任务名（role=misc 必填）' },
-        notify: { type: 'boolean', description: 'role 时投整理指令（默认 true，会唤醒它一轮）' },
+        action: { type: 'string', enum: ['list', 'role', 'new', 'task-init', 'order', 'place', 'prompt', 'archive', 'unarchive'], description: '缺省 list' },
+        order: { type: 'string', enum: ['handover', 'compact'], description: 'order 的动作：handover 令目标会话写交接后换任；compact 为其排压缩（须先有合格交接）' },
+        resume: { type: 'string', enum: ['continue', 'wait'], description: 'order=compact 时的去向：缺省 wait（任务已收尾，压缩后不唤醒）；continue 为压缩后按交接继续' },
+        include_subagents: { type: 'boolean', description: 'list：是否列出子会话' },
+        limit: { type: 'number', description: 'list 的行数（默认 40）' },
+        warn: { type: 'number', description: 'list 的预警阈值（默认 ' + watermark(env.cfg).remind + '）' },
+        session_id: { type: 'string', description: 'role、order、place、archive、unarchive 的目标会话' },
+        role: { type: 'string', enum: ['global', 'project', 'misc', 'plain'], description: 'role 要设成的角色；new 时据此登记接任者角色' },
+        project: { type: 'string', description: '项目名（role=project 时必填；new 时为接任会话所属项目）' },
+        migrate: { type: 'string', enum: ['auto', 'direct'], description: 'role 时项目与杂项互转的方式：auto（缺省）先快照再移动；direct 直接建新体系' },
+        from_task: { type: 'string', description: 'new 时把某个全局任务整体独立为项目或杂项会话（沿用现有体系，不重建、不重新注册）' },
+        task: { type: 'string', description: '任务名（task-init 必填；role=misc 必填；new 时为接任会话所属任务）' },
+        notify: { type: 'boolean', description: 'role 时投递首轮指令（默认 true，将唤醒该会话一轮）' },
         title: { type: 'string', description: 'new 的标题；prompt 用于推断代际' },
         workspace: { type: 'string', description: 'new 必填：目标工作区的 id、标题或路径；new 时不给也能按 project 自动匹配同名工作区' },
         cwd: { type: 'string', description: 'new 的工作目录，必须是某个已注册工作区的根（与 workspace 二选一）' },
         message: { type: 'string', description: 'new 的启动提示词；不给则自动生成' },
-        force: { type: 'boolean', description: 'new 越过 <' + watermark(env.cfg).warn + ' 复用判据；order=compact 越过 120 秒去抖；archive 允许停掉在跑的' },
+        force: { type: 'boolean', description: 'new 越过 <' + watermark(env.cfg).remind + ' 复用判据；order=compact 越过 120 秒去抖；archive 允许停掉在跑的' },
         kind: { type: 'string', enum: ['global', 'project', 'misc', 'migration'], description: 'prompt 的类型；new 时用作角色候选' },
         sessionId: { type: 'string', description: 'prompt：新会话自己的 id' },
-        globalSessionId: { type: 'string', description: 'prompt：现任全局 id' },
+        globalSessionId: { type: 'string', description: 'prompt：在任全局 id' },
         extra: { type: 'string', description: 'prompt 附加一句；order 时作为「全局附加」拼进指令' },
         confirm: { type: 'boolean', description: 'new、order 需要当前用户明确同意后传 true；否则只报错、不做任何事' },
       },
@@ -91,6 +94,19 @@ export function pmSessionsTool(env) {
     async execute(args, exec) {
       const action = typeof args.action === 'string' && args.action ? args.action : 'list';
       if (action === 'list') return { text: list(env, args, exec) };
+      if (action === 'task-init') {
+        const info = env.roleOf(exec);
+        if (!info || info.role !== 'global') throw new Error('task-init 只对全局会话开放');
+        const ws = env.resolveWs(exec);
+        const r = createGlobalTask(ws, args.task);
+        const out = [];
+        out.push('已建立全局任务库：' + r.dir);
+        out.push('  新建 ' + r.created.length + ' 个文件' + (r.created.length ? '：' + r.created.join('、') : ''));
+        out.push('交接：_Control_Center/tasks/' + String(args.task) + '/Handover.md；用 ho_handover(action=…, task="' + String(args.task) + '") 读写。');
+        out.push('体系注册已登记进 _Control_Center/records/systems.md；行动计划用 ho_docmap(action="plan", task="' + String(args.task) + '", mode="write")。');
+        out.push('独立为项目或杂项会话：ho_sessions(action="new", role="project"|"misc", from_task="' + String(args.task) + '", …)（须当前用户确认）。');
+        return { text: out.join(NL) };
+      }
       if (action === 'new') return { text: await sessionNew(env, args, exec) };
       if (action === 'order') return { text: await sessionOrder(env, args) };
       if (action === 'place') return { text: await sessionPlace(env, args) };
@@ -99,12 +115,17 @@ export function pmSessionsTool(env) {
       if (action === 'unarchive') return { text: await sessionUnarchive(env, args) };
       if (action === 'role') {
         if (typeof env.applyRole !== 'function') throw new Error('宿主侧没有装配 applyRole');
-        const r = await env.applyRole({ sessionId: args.session_id, role: args.role, project: args.project, task: args.task, wake: args.notify !== false });
+        const r = await env.applyRole({
+          sessionId: args.session_id, role: args.role, project: args.project, task: args.task,
+          wake: args.notify !== false, migrate: args.migrate,
+        });
         const out = [];
         out.push(r.ok ? '已设定角色：' + (ROLE_LABEL[r.role] || r.role) : '设定失败：' + r.error);
         if (r.ok) {
-          out.push('  存活会话当场生效：' + (r.live ? '是（工具集与提示段已换）' : '否（下次开轮时生效）'));
-          out.push('  整理指令：' + (r.delivered ? '已投递（会唤醒它一轮）' : (r.error ? '投递失败：' + r.error : '未投递')));
+          out.push('  存活会话当场生效：' + (r.live ? '是（工具集与提示段已更换）' : '否（下次开轮时生效）'));
+          if (r.migrated) out.push('  身份互转：' + r.migrated + ' —— ' + r.migrationSummary);
+          out.push('  首轮指令：' + (r.delivered ? '已投递（将唤醒该会话一轮）' : (r.error ? '投递失败：' + r.error : '未投递')));
+          out.push('  注册名：' + (r.registeredName || '尚未注册（由该会话首轮与当前用户确认后，用 ho_office action="register" 注册）'));
         }
         return { text: out.join(NL) };
       }

package/src/tools/ho_status.mjs

@@ -21,6 +21,7 @@ import { watermark } from '../lib/facts.mjs';
 import { eventsOf, countCompactions } from '../lib/events.mjs';
 import { findLog, decodeLog, turnStarts } from '../lib/zstd-log.mjs';
 import { activeConsentsFor, formatConsentLine } from '../lib/consent.mjs';
+import { readReminderState } from '../lib/reminder.mjs';
 
 export const VIEWS = ['phase', 'brief', 'diag', 'drift', 'tokens'];
 
@@ -74,7 +75,7 @@ function phaseText(env, args, exec) {
 function briefText(env, args, exec) {
   const ws = env.resolveWs(exec);
   const w = watermark(env.cfg);
-  const warn = typeof args.threshold === 'number' ? args.threshold : w.warnValue;
+  const warn = typeof args.threshold === 'number' ? args.threshold : w.remindValue;
   const gate = syncCheck(ws);
   const meId = env.selfId(exec);
   const self = readSelfPressure(env.cacheDir(), meId);
@@ -138,6 +139,10 @@ function diagText(env, state, exec) {
   out.push('压缩      ' + st.used + '/' + env.cfg.maxCompactions + ' 次；锁 ' + st.lock + '；来源 ' + st.source);
   const pct = env.selfPct(meId);
   out.push('水位      ' + (pct === null ? '读不到' : pct.toFixed(1) + '%') + (typeof env.staleNote === 'function' ? env.staleNote(exec) : ''));
+  try {
+    const rec = readReminderState().sessions[String(meId || '')] || {};
+    out.push('提醒      35%=' + (rec.r35 ? '已提醒' : '未提醒') + '  50%=' + (rec.r50 ? '已提醒' : '未提醒'));
+  } catch { /* 提醒状态读不到不影响自检 */ }
   const ws = env.resolveWs(exec);
   let wsOk = false;
   try { wsOk = fs.existsSync(path.join(ws, '_Control_Center')); } catch { wsOk = false; }
@@ -157,16 +162,16 @@ function diagText(env, state, exec) {
   }
   out.push('工作区    ' + ws + (wsOk
     ? '  已接入'
-    : '  — 未接入（未找到 _Control_Center）：让当前用户走设置页「首次安装」，或本会话直接 ho_workspace(action="init", parent="<目录>", register=true)'));
+    : '  未接入（未找到 _Control_Center）：请当前用户在设置页执行「首次安装」，或由本会话直接 ho_workspace(action="init", parent="<目录>", register=true)'));
   try {
     const mv = typeof env.moveInfo === 'function' ? env.moveInfo() : null;
     if (mv) out.push('迁移      ' + mv.phase + ' · ' + mv.src + (mv.dst ? '  →  ' + mv.dst : ''));
   } catch { /* ignore */ }
-  out.push('配置      warn=' + env.cfg.warnRatio + ' handover=' + env.cfg.handoverRatio + ' hard=' + env.cfg.hardRatio + ' max=' + env.cfg.maxCompactions);
+  out.push('配置      remind=' + env.cfg.remindRatio + '·' + env.cfg.remind2Ratio + ' handover=' + env.cfg.handoverRatio + ' pureWindow=' + env.cfg.pureWindowRatio + ' hard=' + env.cfg.hardRatio + ' max=' + env.cfg.maxCompactions);
   if (typeof env.handoverFor === 'function') {
     try {
       const hp = env.handoverFor(exec);
-      out.push('交接路径  ' + (hp && hp.path ? hp.path + '（' + hp.kind + '）' : '无 —— ' + ((hp && hp.reason) || '角色未定')));
+      out.push('交接路径  ' + (hp && hp.path ? hp.path + '（' + hp.kind + '）' : '无，' + ((hp && hp.reason) || '角色未定')));
     } catch (e) {
       out.push('交接路径  解析失败：' + (e && e.message ? e.message : e));
     }
@@ -185,7 +190,7 @@ function driftText(env, args, exec) {
     all: args.all === true,
   });
   const out = [];
-  out.push('交接匹配检查（跟着交接走；冗余 ' + res.slack + ' 轮）  工作区根 ' + ws);
+  out.push('交接匹配检查（以交接为准；容忍 ' + res.slack + ' 轮）  工作区根 ' + ws);
   out.push('  项目  会话类型 会话  当前轮  交接轮  Δ  判定');
   for (const r of res.rows) {
     const cells = [r.project, r.kind, r.sid.slice(-8), String(r.turns), r.handoverTurn === null ? '?' : String(r.handoverTurn), r.delta === null ? '?' : String(r.delta), r.verdict];
@@ -204,9 +209,9 @@ function tokensText(args) {
   for (const sid of list) {
     const full = sid.indexOf('session-') === 0 ? sid : 'session-' + sid;
     const log = findLog(full);
-    if (!log) { out.push(sid + '  ERR 日志找不到'); continue; }
+    if (!log) { out.push(sid + '  ERR 日志不存在'); continue; }
     const recs = decodeLog(log);
-    if (!recs) { out.push(sid + '  ERR 日志解不出'); continue; }
+    if (!recs) { out.push(sid + '  ERR 日志无法解码'); continue; }
     const m = analyzeLog(recs);
     const verdict = m.perStep > 2000 ? '偏贵（每步 >2k）' : m.heavyTurns > 0 ? '有超 20 步的轮' : '正常';
     out.push([sid.slice(-8), m.turns, m.steps, m.outTok, m.perStep, Math.round(m.maxResult / 1024) + 'KB', m.heavyTurns, verdict].join('  '));
@@ -219,13 +224,13 @@ export function pmStatusTool(env, state) {
   return {
     name: nameOf('status'),
     description:
-      '会话状态（只读）：view=phase 水位与建议（默认）、brief 起始简报、diag 插件自检、drift 交接漂移、tokens token 体检。',
+      '会话状态（只读）：view=phase 水位与建议（缺省）、brief 起始简报、diag 插件自检、drift 交接漂移、tokens token 体检。',
     parameters: {
       type: 'object',
       additionalProperties: false,
       properties: {
         view: { type: 'string', enum: VIEWS, description: '缺省 phase' },
-        threshold: { type: 'number', description: 'view=brief：预警阈值百分比（默认 ' + w.warnValue + '）' },
+        threshold: { type: 'number', description: 'view=brief：预警阈值百分比（默认 ' + w.remindValue + '）' },
         simulateRatio: { type: 'number', description: 'view=phase：演练用比例替代真实水位（0-1），不写任何状态' },
         sessions: { type: 'array', items: { type: 'string' }, description: 'view=tokens：会话 id 列表' },
         slack: { type: 'number', description: 'view=drift：容忍轮数（默认 3）' },

package/src/tools/ho_succeed.mjs

@@ -7,13 +7,13 @@ export function pmSucceedTool(env) {
   return {
     name: nameOf('succeed'),
     description:
-      '换任：校验本会话交接，建接任会话并登记在任；须当前用户先授权（/allow-succeed）。',
+      '换任：校验本会话交接，建立接任会话并登记在任；须由当前用户先行授权（/allow-succeed）。',
     parameters: {
       type: 'object',
       additionalProperties: false,
       properties: {
-        note: { type: 'string', description: '写进在任登记的备注（可选）' },
-        force: { type: 'boolean', description: '本会话水位未到线时仍换任（默认不传）' },
+        note: { type: 'string', description: '写入在任登记的备注（可选）' },
+        force: { type: 'boolean', description: '本会话水位未到线时仍执行换任（缺省不传）' },
       },
     },
     output: textOutput(),