@mingmaple/dsh-handover 0.9.12 → 0.9.13

package/src/lib/succession.mjs

@@ -0,0 +1,244 @@
+/**
+ * 换任自服务：在任会话在用户授权后，自己校验交接、建接任会话、登记在任并投递启动提示词。
+ *
+ * 越权防线：建什么角色的会话只认会话自身已登记的角色（env.roleOf），不采信调用参数；
+ * 名字只认登记表的历史最大号（nextName），不采信会话自述。
+ * 全部校验（角色、授权、交接结构、在任身份、工作区、提示词）都在第一次写盘之前完成：
+ * 任何一项不通过，整体不落任何写操作，只返回中文原因。
+ */
+import fs from 'node:fs';
+import { NL, readUtf8 } from './text.mjs';
+import { lineageKeyOf, loadOffice, nextName, registerHolder, stampNow } from './office.mjs';
+import { checkConsent, consumedConsent } from './consent.mjs';
+import { newSessionIn } from './session-create.mjs';
+import { sendPrompt } from './prompt.mjs';
+import { resolveWorkspaceFor, promptFor } from './session-ops.mjs';
+import { watermark } from './facts.mjs';
+
+/** 交接里不得残留的占位符。 */
+export const HANDOVER_PLACEHOLDERS = ['待填', 'TODO', '（建完后填）', '<填'];
+
+function msgOf(e) {
+  return String(e && e.message ? e.message : e);
+}
+
+/**
+ * 找接任指令节：含「## 下一步」或「## 2.」这类标题；没有标题时接受 §2 的写法。
+ * 判据与 ho_gate 的交接体检一致：这一节至少要有一个条目（列表、表格或编号行）。
+ */
+function nextSectionOf(text) {
+  const lines = text.split(NL);
+  let start = -1;
+  for (let i = 0; i < lines.length; i++) {
+    const l = lines[i];
+    if (!l.startsWith('## ')) continue;
+    if (l.indexOf('下一步') !== -1 || /^##\s*2(?:[.、\s]|$)/.test(l)) { start = i; break; }
+  }
+  if (start === -1) {
+    if (/§\s*2/.test(text)) return { ok: true };
+    return { ok: false, reason: '缺少接任指令节：应有「## 下一步」或「## 2.」一节' };
+  }
+  const rows = [];
+  for (let i = start + 1; i < lines.length; i++) {
+    if (lines[i].startsWith('## ')) break;
+    const t = lines[i].trim();
+    if (/^[-*]\s+/.test(t)) rows.push(t);
+    else if (/^\|/.test(t) && t.indexOf('---') === -1) rows.push(t);
+    else if (/^\d+[.、]\s+/.test(t)) rows.push(t);
+  }
+  if (!rows.length) return { ok: false, reason: '「下一步」一节没有列出任何条目' };
+  return { ok: true };
+}
+
+/** 交接结构检查（只判结构）：返回缺项列表，空数组表示通过。 */
+export function auditHandover(file) {
+  const problems = [];
+  try {
+    const st = fs.statSync(file);
+    if (!st.isFile()) return ['交接路径不是文件：' + file];
+  } catch {
+    return ['交接文件不存在：' + file];
+  }
+  let text = '';
+  try { text = readUtf8(file).replace(/^\uFEFF/, ''); } catch (e) { return ['交接文件读取失败：' + msgOf(e)]; }
+  if (!text.trim()) return ['交接文件为空：' + file];
+  const next = nextSectionOf(text);
+  if (!next.ok) problems.push(next.reason);
+  for (const p of HANDOVER_PLACEHOLDERS) {
+    if (text.indexOf(p) !== -1) problems.push('仍有占位符：' + p);
+  }
+  return problems;
+}
+
+/** 在旧会话的交接末尾追加「换任登记」：先备份到同目录 .bak，再追加。 */
+function appendSuccessionBlock(file, lines) {
+  const cur = readUtf8(file);
+  const bom = cur.charCodeAt(0) === 0xFEFF ? '\uFEFF' : '';
+  const body = bom ? cur.slice(1) : cur;
+  fs.copyFileSync(file, file + '.bak');
+  const gap = body.endsWith(NL) ? NL : NL + NL;
+  const block = ['## 换任登记', ''].concat(lines).join(NL);
+  fs.writeFileSync(file, bom + body + gap + block + NL, 'utf8');
+  return file + '.bak';
+}
+
+/**
+ * 执行一次换任自服务。
+ * @param {object} env 插件环境
+ * @param {object} exec 工具执行上下文
+ * @param {object} [opts] { note, force }：force 为 true 时越过「水位未到线」判据
+ * @returns {Promise<string>} 中文结果或失败原因
+ */
+export async function runSuccession(env, exec, opts) {
+  const o = opts || {};
+  const note = typeof o.note === 'string' ? o.note.trim() : '';
+  const reject = (reason) => '换任未执行，未做任何写入。' + NL + reason;
+
+  // 1. 自身角色与类别：只认已登记的角色。
+  const info = env.roleOf(exec) || {};
+  const kind = String(info.role || 'plain');
+  if (kind === 'plain') return reject('普通会话不参与换任。');
+  if (kind !== 'global' && kind !== 'project' && kind !== 'misc') return reject('本会话角色无法用于换任：' + kind);
+  const project = String(info.project || '');
+  const task = String(info.task || '');
+  const key = lineageKeyOf(kind, project, task);
+  if (!key) return reject(kind === 'project' ? '项目名缺失，无法确定类别。' : '任务名缺失，无法确定类别。');
+
+  // 2. 用户授权：AI 不能自行批准。
+  const selfId = env.selfId(exec);
+  if (!selfId) return reject('拿不到当前会话 id，无法校验授权。');
+  const cs = checkConsent(selfId, 'succeed');
+  if (!cs.ok) {
+    return reject([
+      cs.reason + '。',
+      '授权方式（任选其一）：',
+      '  ① 在聊天框发送 /allow-succeed（最快，仅授权本会话）；',
+      '  ② 在设置页的 dsh-handover 中点击「换任授权」的「允许换任」。',
+      '授权有效期 5 分钟，用后失效。',
+    ].join(NL));
+  }
+
+  // 3. 交接结构检查（只判结构，不判质量）。
+  const hp = env.handoverFor(exec) || {};
+  const handoverFile = hp.path ? String(hp.path) : '';
+  if (!handoverFile) return reject('没有交接路径：' + (hp.reason || '本会话角色未确定'));
+  const problems = auditHandover(handoverFile);
+  if (problems.length) {
+    return reject(['交接结构未通过：' + handoverFile]
+      .concat(problems.map((p) => '  - ' + p))
+      .concat(['补齐后重新调用 ho_succeed。'])
+      .join(NL));
+  }
+
+  // 4. 在任身份与重复换任：登记表是唯一记录。
+  const ws = String(env.resolveWs(exec) || '');
+  if (!ws) return reject('无法确定工作区根，读不到在任登记表。');
+  const store = loadOffice(ws);
+  const lin = store.lineages[key];
+  // 只有本类别的在任者本人可换任：既防旧会话复活，也防同项目的旁支会话抢先。
+  if (!lin || !lin.current || !lin.current.sessionId) {
+    return reject('本类别（' + key + '）在在任登记表里还没有现任记录：先由全局建会话并登记，再换任。');
+  }
+  if (String(lin.current.sessionId) !== String(selfId)) {
+    return reject('本会话不是在任者：本类别现任为 ' + String(lin.current.name || '（未命名）')
+      + '（' + String(lin.current.sessionId) + '），不得换任。');
+  }
+  {
+    const history = Array.isArray(lin.history) ? lin.history : [];
+    const closed = history.find((h) => h && String(h.sessionId || '') === String(selfId) && h.to);
+    if (closed) {
+      const curName = lin.current && lin.current.name ? lin.current.name : '（空缺）';
+      return reject('本类别已为本会话记过一次换任（' + String(closed.to || '') + '，现任 ' + curName + '），旧会话不得再次换任。');
+    }
+  }
+
+  // 4.1 水位未到线：本会话就是在任者且水位低于提醒线时，换任通常是多余的。
+  // 放在授权与交接校验之后、任何写入之前；取不到水位就跳过。
+  if (o.force !== true) {
+    let pct = null;
+    try { pct = typeof env.selfPct === 'function' ? env.selfPct(selfId) : null; } catch { pct = null; }
+    if (pct !== null && pct !== undefined && Number(pct) < watermark(env.cfg).warnValue) {
+      return reject('本会话水位 ' + Number(pct).toFixed(1) + '%，尚未到线，通常无需换任；确需换任请传 force=true。');
+    }
+  }
+
+  // 5. 分配编号：登记表历史最大号加一，不采用会话自述。
+  const name = nextName(store, key);
+
+  // 6. 确定工作区：与 ho_sessions(action="new") 同一套解析；杂项落到本会话所在工作区。
+  let workspaceId = '';
+  try {
+    workspaceId = resolveWorkspaceFor(env, exec, kind, project, task, kind === 'misc' ? { workspace: ws } : {});
+  } catch (e) {
+    return reject(msgOf(e));
+  }
+
+  // 7. 拼启动提示词：末尾追加交接路径与「先读交接、读毕报到」。
+  let prompt = '';
+  try {
+    const base = promptFor(env, { ws, kind, project, task, title: name, sessionId: '', globalSessionId: selfId, extra: '' });
+    prompt = base + NL + NL + [
+      '接任交接：' + handoverFile,
+      '先读这份交接再动手；读毕向用户报告当前停在哪一步、交接列有哪些待办，然后等待用户指派任务。',
+    ].join(NL);
+  } catch (e) {
+    return reject('启动提示词生成失败：' + msgOf(e));
+  }
+
+  // 8. 建会话：失败即停止，不登记。
+  const made = await newSessionIn(env, { workspaceId, title: name, role: kind, project, task });
+  const sessionId = made && made.sessionId ? String(made.sessionId) : '';
+  if (!sessionId) return reject('建会话失败，未做任何登记：' + ((made && made.error) || '原因未知'));
+  // 提示词里预留的是「建完后填」，拿到会话 id 后在这里替换成真实 id。
+  const text = prompt.split('（建完后填）').join(sessionId);
+
+  // 9. 登记在任：原在任者自动进历史，Registry.md 在役列同步。
+  let reg = null;
+  try {
+    reg = registerHolder(ws, { kind, project, task, name, sessionId, workspace: ws, note });
+  } catch (e) {
+    return [
+      '会话已建 ' + sessionId + '（' + name + '），但登记在任失败：' + msgOf(e),
+      '启动提示词尚未投递；先修好登记表，再用 peer_send 通知它。',
+    ].join(NL);
+  }
+
+  // 10. 投递启动提示词：失败要如实报出，会话已经存在。
+  let delivered = false;
+  let deliveryError = '';
+  try {
+    const r = await sendPrompt(env.controller(), sessionId, text, 'queue');
+    delivered = !!(r && r.accepted);
+    if (!delivered) deliveryError = '会话控制器未接受（accepted=false）';
+  } catch (e) {
+    deliveryError = msgOf(e);
+  }
+
+  // 11. 旧会话的交接末尾追加换任登记；写前备份。
+  let appendNote = '';
+  try {
+    const bak = appendSuccessionBlock(handoverFile, [
+      '- 接任者：' + name,
+      '- 会话 id：' + sessionId,
+      '- 时刻：' + stampNow(),
+      ...(note ? ['- 备注：' + note] : []),
+      '- 旧会话停止作业。',
+    ]);
+    appendNote = '已写入交接末尾（备份 ' + bak + '）';
+  } catch (e) {
+    appendNote = '换任登记写入失败：' + msgOf(e);
+  }
+
+  // 12. 消费授权：一次授权只够换任一次。
+  try { consumedConsent(selfId, 'succeed'); } catch { /* 授权文件损坏不影响本次结果 */ }
+
+  // 13. 结果。
+  const out = [];
+  out.push('换任完成：' + name + '（' + sessionId + '）');
+  out.push('在任登记：' + key + (reg && reg.registry && reg.registry.changed && reg.registry.changed.length
+    ? '，Registry.md 已同步在役列' : ''));
+  out.push('启动提示词：' + (delivered ? '已投递' : '未送达：' + deliveryError + '。会话已建，可用 peer_send 补投'));
+  out.push('交接登记：' + appendNote);
+  out.push('本会话到此停止，等待用户在新会话中派任务。');
+  return out.join(NL);
+}

package/src/lib/workspace.mjs

@@ -9,7 +9,7 @@ export function hasCenter(p) {
 }
 
 /**
- * 没有 exec 时的兜底：配置 workspaceRoot → 标题含「全局」且带 _Control_Center 的工作区
+ * 没有 exec 时的备用做法：配置 workspaceRoot → 标题含「全局」且带 _Control_Center 的工作区
  * → 任一带 _Control_Center 的工作区 → 进程 cwd。
  */
 export function routeWorkspace(env) {

package/src/selftest.mjs

@@ -10,6 +10,8 @@ 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';
 import path from 'node:path';
 
 const argv = process.argv.slice(2);
@@ -54,6 +56,13 @@ const env = {
   lockState: () => 'unknown',
 };
 
+/** 换任只读用例：只验授权判据，不带用户授权时应当返回「没有授权」，而不是抛异常。 */
+const envSucceed = Object.assign({}, env, {
+  selfId: () => 'session-selftest-succeed',
+  roleOf: () => ({ role: 'project', project: 'Demo', task: '', source: 'selftest' }),
+  handoverFor: () => ({ path: path.join(ws, '_Project_Meta', 'Demo', 'Handover.md'), reason: '' }),
+});
+
 const exec = null;
 const cases = [
   { t: pmBriefTool(env), a: {}, flag: "brief" },
@@ -61,6 +70,8 @@ const cases = [
   { 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: /没有授权/ },
 ];
 
 let failed = 0;
@@ -71,6 +82,10 @@ for (const c of cases) {
   try {
     const out = await c.t.execute(c.a, exec);
     console.log(out.text);
+    if (c.want && !c.want.test(String(out && out.text))) {
+      failed++;
+      console.log("FAILED: 输出不符合预期 " + c.want);
+    }
   } catch (e) {
     failed++;
     console.log("FAILED: " + (e && e.message ? e.message : String(e)));

package/src/templates/Charter.skeleton.md

@@ -1,6 +1,6 @@
 # Workspace Charter（骨架）
 
-> 本文件由 dsh-handover 首次安装向导生成，只含跑起来所需的最小内容；按需继续写。
+> 本文件由 dsh-handover 首次安装向导生成，只含可运行所需的最小内容；按需继续写。
 > 铁律：§8.1.1.4 那 24 行是唯一正文来源，任何项目库的 RULES.md 都要逐字复制它（外加一行「上下文水位自查」）。改这里就必须同步改所有库。
 
 ## 8. 工程约束

package/src/templates/Prompt_Templates.md

@@ -7,7 +7,7 @@
 ```text
 你是<角色>，由全局管理对话创建并交接。
 第一条要读的：<绝对路径>（读毕再开始作业）。| 项目→ _Project_Meta/<项目名>/Handover.md；全局→ records/Global_Handover.md；杂项首任→ rules/Misc_Task_Standard.md
-你是平级会话：跑完一轮不会有任何自动通知。会话之间可直接 `peer_send`，不必经全局转述；**默认沉默**：只在三种时机各发一条给现任全局——≥32% 且已写交接、需用户决定、发现全局口径有误；**任务完成不向全局报告**（任务属本会话内部事务）；**不得每轮回执，亦不得发送「收到」「已完成」一类确认**（全局不看回执，只看文件末态）。
+不得每轮回执，也不发送「收到」「已完成」一类确认；全局只看文件末态。
 你的 session id：<本会话 id>。确需向全局发消息时，以 `peer_send` 发至 <全局 id>。| 不得据 peer_list 推测 id
 水位：≥32% 应先写毕交接、再通知全局，并提醒用户换会话；>35% 不得新开任务。
 边界：只读写 <范围>。删除或覆盖前须先留快照，**删除须经用户确认**。对用户可见一律中文（含工具 description 字段）。
@@ -37,7 +37,7 @@
 库根：Projects/<项目名>/<项目名>库/ ；元数据：_Project_Meta/<项目名>/ ；快照：_Temp/<项目名>/Snapshots/ ；版本冻结：_Archives/<项目名>/Backups/
 开始作业前应先读：_Project_Meta/<项目名>/Handover.md → 库根 SKILL.md →（修改文档时）_Control_Center/rules/ 下对应规范。
 两件必查：库内 RULES.md 里必须有「运行期省 token」与「上下文水位自查」两条；缺者应照 Workspace_Charter.md 原文补上（唯一来源，不得自行改动数字）。
-换任由全局执行，不由你执行：进入预警区后只写交接、通知全局并提醒用户，**不得自行调用 peer_new**。
+换任自办，规则见插件注入的提示段；**不得自行调用 peer_new**，也不向全局请求换任。
 ```
 
 ### 2.3 杂项（只在首任时由全局发，此后自理）
@@ -47,25 +47,17 @@
 你是杂项任务会话，标题「<任务短名>」，不编号。
 任务目录：_Misc/tasks/<任务短名>/（产物、脚本、日志都放这里）
 三件文件：Project_Overview.md（是什么/边界/验收判据）· Changelog.md（环境事实/变更/回滚，只追加）· Handover.md（在途）
-换任自己办：peer_new({ workspace: 'Misc', title: '<自拟名称>' }) → 查重 → 新 id 写进交接 §0 → 不通知全局。
+换任自办（规则见插件注入的提示段）：接任者名字与会话 id 由插件写进登记表并在旧交接末尾追加登记，不通知全局。
 本任务：<任务正文>| 用户原话照抄，不改写、不缩范围、不替用户补验收判据
 ```
 
-## 3 消息二 · 项目 → 全局：交接请求
+## 3 消息二 · 换任（已停用）
 
-```text
-【交接请求】<项目名>｜<本会话 id>｜水位 <xx>%
-已写完 _Project_Meta/<项目名>/Handover.md（<行数> 行，已归档旧版到 _Archives/<项目名>/Handover/）。
-在途：<有/无>；一句话：<现在卡在哪>。
-请建接任会话。
-```
+> 换任由在任会话调用 `ho_succeed` 完成：用户授权、插件体检交接、分配编号、建立接任会话并投递启动提示。不再有「项目 → 全局：交接请求」的消息，也不再需要全局代办。本节保留编号，避免后续节号变动。
 
-## 4 消息三 · 全局 → 项目：已交接
+## 4 消息三 · 全局代建（仅备选）
 
-```text
-【已交接】<项目名>｜接任已建：<项目名><N>｜session id <新 id>
-你的交接已归档，可以停止操作：不得新开任务，不得修改文件。
-```
+> 仅在自动换任失败、且用户要求时使用：全局用 `ho_sessions(action="new")` 建接任会话，标题按 `<项目名><N>`（N＝本机下一个序号），启动提示必须带新会话自己的 session id、现任全局 session id 与旧会话 `Handover.md` 的绝对路径。建完请用户在旧会话里确认停止。
 
 ## 5 消息四 · 全局 → 项目：新任务派发
 
@@ -76,7 +68,7 @@
 约束：<本次不许碰的东西；无则删本行>
 ```
 
-> 派活前先 `peer_list`：已有会话且 <32% **必须复用它**，不许新建；≥32% 先让其写完交接再新建。
+> 派活前先查在任（`ho_office` 空参数，零成本）；复用准则固定写在插件注入的提示段，本节不重复。
 
 ## 6 消息五 · 迁移通知（打包前刷交接）
 
@@ -91,6 +83,6 @@
 
 ## 7 发送纪律
 
-> 时机与纪律（不寒暄、一次一件事、并发 ≤3、默认沉默、未被要求勿唤醒、不转述）见 `rules/Workspace_Charter.md` §7.2.4 第 9 条，本节不重复。
+> 汇报时机见插件注入的提示段；格式与频率纪律（不寒暄、一次一件事、并发 ≤3、未被要求勿唤醒、不转述）见 `rules/Workspace_Charter.md` §7.2.4 第 9 条，本节不重复。
 >
 > 本节只留一条**模板自身**的要求：发送前删掉所有 `|` 之后的提示与 `<>` 占位，只留实值。

package/src/templates/Runtime_Manual.md

@@ -2,22 +2,22 @@
 
 > 这是**按需取回**的全文：系统提示里只留短段与指针，需要细节时用 `ho_charter(doc="runtime")` 取本文。
 >
-> **内置即默认**：本文、Charter 骨架、交接、台账骨架、提示词模板、四份规则文档都随插件发布（`dist/templates/`）。工作区里的同名文件只是「本地化覆盖」；删掉就自动回到内置，功能不降级。`ho_init` 是把默认口径落盘方便修改，**不是使用前提**。
+> **内置即默认**：本文、Charter 骨架、交接、台账骨架、提示词模板、四份规则文档都随插件发布（`dist/templates/`）。工作区里的同名文件只是「本地化覆盖」；删掉就自动回到内置，功能不降级。`ho_init` 是把默认口径写入磁盘，便于修改，**不是使用前提**。
 > 口径冲突时以工作区的 `_Control_Center/rules/` 为准；本文只讲「插件怎么用、角色怎么分」。
 
 ## 1. 角色四档
 
 | 角色 | 判定顺序 | 交接文件 | 可见工具 |
 |---|---|---|---|
-| 全局 | 角色表 → 标题含「全局」 → 全局工作区 | `_Control_Center/records/Global_Handover.md` | 22 个（全部） |
-| 项目 | 角色表（带项目名）→ cwd 在 `Projects/<名>/` → 首条提示含 `Projects/<名>/` | `_Project_Meta/<项目>/Handover.md` | 9 个 |
-| 杂项 | 角色表（带任务名）→ cwd 在 `_Misc/tasks/<任务>/` | `_Misc/tasks/<任务>/Handover.md` | 9 个 |
+| 全局 | 角色表 → 标题含「全局」 → 全局工作区 | `_Control_Center/records/Global_Handover.md` | 24 个（全部） |
+| 项目 | 角色表（带项目名）→ cwd 在 `Projects/<名>/` → 首条提示含 `Projects/<名>/` | `_Project_Meta/<项目>/Handover.md` | 11 个 |
+| 杂项 | 角色表（带任务名）→ cwd 在 `_Misc/tasks/<任务>/` | `_Misc/tasks/<任务>/Handover.md` | 11 个 |
 | 普通 | 子会话，或都不中 | 无（不参与交接） | 0 个（不注入提示段） |
 
 角色表在 `~/.dsh/storages/dsh-handover.roles.json`，是**本机状态**，不进仓库、不进迁移包。子会话默认普通；需要时由全局在角色表里指定。
 设定入口：设置 → dsh-handover →「会话角色」；或对全局说「把 Demo1 设成项目角色」，它用 `ho_sessions(action="role")` 办。
 
-## 2. 工具清单（22 个）
+## 2. 工具清单（24 个）
 
 ### 只读
 - `ho_brief` —— 起始与收束的单条命令：水位、闸门、会话清点、阶段建议。
@@ -28,6 +28,7 @@
 - `ho_drift` —— 交接漂移：Δ＝当前轮−交接轮，>3 需刷新。
 - `ho_diag` —— 插件自检：服务、调度器、压缩计数、工作区、角色判定。
 - `ho_tokens` —— 会话 token 体检：轮数、步数、每步 token、最贵单条返回。
+- `ho_office` —— 查在任：输入「全局」「全局3」「项目名」等，返回现任会话的名字与会话 id；多个名字空格分隔，留空列出全部。
 - `peer_list` / `peer_status` / `peer_peek` —— 平级会话清点与近期对话（peek 会花本会话 token）。
 
 ### 写
@@ -39,6 +40,7 @@
 - `ho_workspace` —— 工作区 list、create、delete（删除只删注册）与换盘动作。
 - `ho_init` —— 首次安装：在指定目录下建整套全局文件体系，可顺带注册工作区。
 - `ho_profile` —— 项目或杂项的骨架注册：由所属会话通读自己的库后写入并校验。
+- `ho_succeed` —— 换任：用户授权后校验交接、按记录分配编号、建立接任会话、登记在任并投递启动提示词。
 - `peer_send` / `peer_new` / `peer_rename` —— 投递消息、建平级会话、只改标题。
 
 ### ho_sessions 的 action
@@ -57,9 +59,10 @@
 
 - 32% 提醒、35% 交接线、85% 硬顶；同一会话最多压缩 3 次（共 4 段使用）。数值来自 `config.mjs`，提示段与设置页由 `lib/facts.mjs` 统一渲染。
 - 到线流程：`ho_handover` 写交接（体检不通过就拒绝压缩）→ `ho_checkpoint` 登记（`resume=continue|wait`）→ 轮末自动压缩 → 继续时投续跑消息；收尾时不唤醒，等用户派新任务。
-- 第 4 段到线：写交接 ＋ 全局用 `ho_sessions(action="new")` 建下一任；项目会话自己**不要**建会话（换任由全局做）。
+- 第 4 段到线或压缩额度用尽：由在任会话自己换任——写交接 → 请用户在聊天框敲 `/allow-succeed` 授权 → 调 `ho_succeed`（校验交接、分配编号、建立接任会话、登记在任、投递提示词）。全局仍可用 `ho_sessions(action="new")` 手动建立会话，作为自动流程失败时的备选方式。
 - 关键步骤不要压：`ho_checkpoint` 传 `at_risk=true`，它只提醒不压；硬顶 85% 除外。
 - 压缩不可逆：历史会被摘要替换，所以「先把交接写合格」是硬前提。
+- 在任登记表由插件维护：`_Control_Center/records/Office.json` 记每一类会话的现任与会话 id；查现任用 `ho_office`，不起会话时用 `node scripts/office.mjs 全局 全局3`。
 
 ## 4. 交接文件的结构要求
 
@@ -124,14 +127,14 @@
 
 ### 12.1 分层（谁在每轮付费）
 
-| 层 | 内容 | 何时进入上下文 | 体积上限（加权 token） |
+| 层 | 内容 | 何时进入上下文 | 实测参考（加权 token） |
 |---|---|---|---|
-| L0 常驻 | 角色段（全局五节；项目、杂项九行） | **每一轮** | 全局 320；项目 300；长路径与迁移提示档 360、340 |
+| L0 常驻 | 角色段（全局五节；项目、杂项各节） | **每一轮** | 全局约 385；项目与杂项约 370；长路径与迁移提示档约 435、419（参考值，不设上限） |
 | L0 用户内容 | 全局前置提示词（用户开关，默认关闭） | 开启且非空时每轮 | 由用户自管，不计入本插件预算 |
 | L1 手册 | 本文件 | 按需取回，可**按节**取 | 不设上限（不进每轮） |
 | L2 规则文档 | 工作区 `_Control_Center/rules/` | 按需 | 由工作区自管 |
 
-> 加权 token 的算法：CJK 与全角标点每字符 1 token，其余每 4 字符 1 token。上限集中在 `lib/facts.mjs` 的 `TOKEN_BUDGET`，冒烟断言直接引用该表。工具描述单条上限 70 token。
+> 加权 token 的算法：CJK 与全角标点每字符 1 token，其余每 4 字符 1 token。实测常量在 `lib/facts.mjs` 的 `TOKEN_BUDGET`，冒烟只打印实测值，**不设上限**，也不用于拒绝或截断。
 >
 > L0 是成本主体：它按轮次乘算，所以只放「每轮都要用到的判定」。任何「一个会话生命周期里只用几次」的流程，一律以指针落到 L1。
 

package/src/templates/rules/Handover_Rules.md

@@ -15,10 +15,10 @@
 
 ## 2. 什么时候写
 
-- 水位 **32%**：开始收口，别开新活。
+- 水位 **32%**：开始收尾，不要开新任务。
 - 水位 **35%**：必须写完交接 → `ho_checkpoint` 登记 → 轮末自动压缩 → 续跑。
 - 水位 **85%**：硬顶，不压也得压。
-- 同一会话最多压 3 次；第 4 段写交接并通知全局换任（**项目会话不要自己建会话**）。
+- 同一会话最多压 3 次；第 4 段写交接，用户授权后由在任会话调用 `ho_succeed` 换任（**不得自行新建会话**）。
 
 ## 3. 必须写清（缺一项就会在换任时丢信息）
 

package/src/templates/rules/Misc_Task_Standard.md

@@ -2,7 +2,7 @@
 
 ## 1. 什么算杂项
 
-一次性或短期的活：不建项目库、不进 `_Project_Meta/Registry.md`。落点 `_Misc/tasks/<任务短名>/`。
+一次性或短期任务：不建项目库、不进 `_Project_Meta/Registry.md`。落点 `_Misc/tasks/<任务短名>/`。
 
 ## 2. 目录约定
 
@@ -14,8 +14,8 @@
 
 ## 3. 边界
 
-- 只写上面三处；`_Control_Center`、`Projects`、其他任务目录都不碰。
-- 接任：杂项可以自建 Misc 换任（`ho_sessions(action="new")` 指向 Misc 工作区），项目会话不许。
+- 只写上面三处；`_Control_Center`、`Projects`、其他任务目录都不得写入。
+- 接任：杂项须用户授权（`/allow-succeed` 或设置页），再由本会话调用 `ho_succeed`，由插件按登记表建立接任会话；项目会话不得自行新建会话。
 - 交接与水位协议同项目（32% 提醒 / 35% 交接线 / 85% 硬顶）。
 
 ## 4. 升级为项目

package/src/tools/ho_office.mjs

@@ -0,0 +1,59 @@
+/** 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';
+
+export function pmOfficeTool(env) {
+  return {
+    name: nameOf('office'),
+    description:
+      '查在任：输入「全局」「全局3」「项目名」等，返回现任会话的名字与 id；多个用空格分隔，留空列全部。只读。',
+    parameters: {
+      type: 'object',
+      additionalProperties: false,
+      properties: {
+        query: { type: 'string', description: '要查的名字，如「全局」「全局3」「Mingent」「抢名额脚本」；多个用空格或逗号分隔；留空＝列出全部在任' },
+        json: { type: 'boolean', description: 'true 时输出机器可读 JSON（供脚本解析）' },
+      },
+    },
+    output: textOutput(),
+    async execute(args, exec) {
+      const ws = env.resolveWs(exec);
+      if (!ws) return { text: '无法确定工作区根，读不到在任登记表。' };
+      const store = loadOffice(ws);
+      const rows = rowsOf(store);
+      if (!rows.length) {
+        return { text: '在任登记表还是空的（' + officePath(ws) + '）：先登记一次在任会话，再查。' };
+      }
+      const raw = String(args.query || '').trim();
+      const tokens = raw ? raw.split(/[\s,，、;；]+/).filter(Boolean) : [];
+      if (!tokens.length) {
+        if (args.json) return { text: JSON.stringify({ updatedAt: store.updatedAt || '', rows }, null, 2) };
+        const out = [];
+        let lastKind = '';
+        for (const r of rows) {
+          if (r.kind !== lastKind) {
+            if (out.length) out.push('');
+            out.push('【' + (r.kind === 'global' ? '全局' : r.kind === 'project' ? '项目' : r.kind === 'misc' ? '杂项' : r.kind) + '】');
+            lastKind = r.kind;
+          }
+          out.push(formatRow(r));
+        }
+        return { text: out.join(NL) };
+      }
+      const out = [];
+      const hits = [];
+      for (const t of tokens) {
+        const r = resolveOffice(store, t);
+        if (!r.ok) { out.push(t + '  — ' + r.reason); continue; }
+        if (r.vacant) { out.push(t + '  — 类别「' + r.key + '」当前空缺（无人在任）'); continue; }
+        const row = { key: r.key, kind: r.lineage.kind, project: r.lineage.project, task: r.lineage.task, current: r.lineage.current };
+        out.push(formatRow(row, t));
+        hits.push({ askedAs: t, via: r.via, key: r.key, kind: r.lineage.kind, name: r.lineage.current.name, sessionId: r.lineage.current.sessionId });
+      }
+      if (args.json) return { text: JSON.stringify({ updatedAt: store.updatedAt || '', hits, lines: out }, null, 2) };
+      return { text: out.join(NL) };
+    },
+  };
+}

package/src/tools/ho_succeed.mjs

@@ -0,0 +1,24 @@
+/** ho_succeed —— 换任自服务：在任会话在用户授权后，自行校验交接、建接任会话并登记在任。 */
+import { textOutput } from '../lib/output.mjs';
+import { nameOf } from '../lib/names.mjs';
+import { runSuccession } from '../lib/succession.mjs';
+
+export function pmSucceedTool(env) {
+  return {
+    name: nameOf('succeed'),
+    description:
+      '换任：校验本会话交接，建接任会话并登记在任；须用户先授权（/allow-succeed）。',
+    parameters: {
+      type: 'object',
+      additionalProperties: false,
+      properties: {
+        note: { type: 'string', description: '写进在任登记的备注（可选）' },
+        force: { type: 'boolean', description: '本会话水位未到线时仍换任（默认不传）' },
+      },
+    },
+    output: textOutput(),
+    async execute(args, exec) {
+      return { text: await runSuccession(env, exec, { note: args && args.note, force: args && args.force === true }) };
+    },
+  };
+}