@mingmaple/dsh-handover 0.9.12 → 0.9.13

package/src/client.js

@@ -488,31 +488,31 @@ window.__ModuleLoader__.load({
       // 压缩授权：只有用户在这里点一下，压缩才排得进去（AI 不能自己批）
       const [csSid, setCsSid] = React.useState("");
       const [csMsg, setCsMsg] = React.useState("");
-      const doGrant = React.useCallback(() => {
+      const doGrant = React.useCallback((kind) => {
         setWorking(true); setCsMsg("");
-        post("consent.grant", { session_id: csSid }, 15000)
+        post("consent.grant", { session_id: csSid, kind: kind === "succeed" ? "succeed" : "compact" }, 15000)
           .then((r) => {
-            if (r && r.ok) { setCsMsg("已授权会话 " + r.sessionId + "，5 分钟内可压缩一次，用后失效。"); load(); }
+            if (r && r.ok) { setCsMsg("已授权会话 " + r.sessionId + "，5 分钟内可" + (r.kind === "succeed" ? "换任" : "压缩") + "一次，用后失效。"); load(); }
             else setCsMsg("授权未完成：" + ((r && r.error) || "原因未知"));
           })
           .catch((e) => setCsMsg("请求未完成：" + (e && e.message ? e.message : String(e))))
           .then(() => setWorking(false));
       }, [csSid, load]);
-      const doGrantSid = React.useCallback((sid) => {
+      const doGrantSid = React.useCallback((sid, kind) => {
         setWorking(true); setCsMsg("");
-        post("consent.grant", { session_id: sid }, 15000)
+        post("consent.grant", { session_id: sid, kind: kind === "succeed" ? "succeed" : "compact" }, 15000)
           .then((r) => {
-            if (r && r.ok) { setCsMsg("已授权会话 " + r.sessionId + "，5 分钟内可压缩一次，用后失效。"); load(); }
+            if (r && r.ok) { setCsMsg("已授权会话 " + r.sessionId + "，5 分钟内可" + (r.kind === "succeed" ? "换任" : "压缩") + "一次，用后失效。"); load(); }
             else setCsMsg("授权未完成：" + ((r && r.error) || "原因未知"));
           })
           .catch((e) => setCsMsg("请求未完成：" + (e && e.message ? e.message : String(e))))
           .then(() => setWorking(false));
       }, [load]);
 
-      const doRevoke = React.useCallback((sid) => {
+      const doRevoke = React.useCallback((sid, kind) => {
         setWorking(true); setCsMsg("");
-        post("consent.revoke", { session_id: sid }, 15000)
-          .then(() => { setCsMsg("已撤销 " + sid + " 的压缩授权。"); load(); })
+        post("consent.revoke", { session_id: sid, kind: kind === "succeed" ? "succeed" : "compact" }, 15000)
+          .then(() => { setCsMsg("已撤销 " + sid + " 的" + (kind === "succeed" ? "换任" : "压缩") + "授权。"); load(); })
           .catch(() => { /* 撤销失败不影响别的 */ })
           .then(() => setWorking(false));
       }, [load]);
@@ -617,7 +617,7 @@ window.__ModuleLoader__.load({
             globalMsg ? h("div", { className: globalBad ? "dshh-bad" : "dshh-ok" }, globalMsg) : null)));
       }
 
-      // 二、压缩授权：唯一合法的「用户同意」入口，置顶。
+      // 二、压缩与换任授权：唯一合法的「用户同意」入口，置顶。
       const consentRows = Array.isArray(data.consent) ? data.consent : [];
       sections.push(card("压缩授权",
         h("div", null,
@@ -629,8 +629,18 @@ window.__ModuleLoader__.load({
               key: i,
               disabled: working,
               title: r.title || r.sid,
-              onClick: () => doGrantSid(r.sid),
+              onClick: () => doGrantSid(r.sid, "compact"),
             }, "允许 " + shortSid(r.sid)))),
+          h("div", { className: "dshh-muted" }, "换任由在任会话自己执行，同样须由你授权：点「允许换任」后，该会话可在 5 分钟内换任一次。也可在对话中发送 /allow-succeed。"),
+          h("div", { className: "dshh-pick" },
+            byActivity.slice(0, 10).map((r, i) => h("button", {
+              className: "dshh-btn",
+              type: "button",
+              key: i,
+              disabled: working,
+              title: r.title || r.sid,
+              onClick: () => doGrantSid(r.sid, "succeed"),
+            }, "允许换任 " + shortSid(r.sid)))),
           h("div", { className: "dshh-row" },
             h("input", {
               className: "dshh-inputSm",
@@ -639,15 +649,16 @@ window.__ModuleLoader__.load({
               placeholder: "或输入会话 id 或 8 位短号",
               onChange: (e) => setCsSid(e.target.value),
             }),
-            h("button", { className: "dshh-btn", type: "button", disabled: working || !csSid, onClick: doGrant }, working ? "正在授权" : "授权")),
+            h("button", { className: "dshh-btn", type: "button", disabled: working || !csSid, onClick: () => doGrant("compact") }, working ? "正在授权" : "授权"),
+            h("button", { className: "dshh-btn", type: "button", disabled: working || !csSid, onClick: () => doGrant("succeed") }, "授权换任")),
           consentRows.length
             ? h("table", { className: "dshh-table" },
               h("colgroup", null, h("col", { style: { width: "62%" } }), h("col", { style: { width: "18%" } }), h("col", { style: { width: "20%" } })),
               h("thead", null, h("tr", null, h("th", null, "已授权会话"), h("th", null, "剩余"), h("th", null, "操作"))),
               h("tbody", null, consentRows.map((r, i) => h("tr", { key: i },
-                h("td", { className: "dshh-code", title: r.sessionId }, shortSid(r.sessionId)),
+                h("td", { className: "dshh-code", title: r.sessionId }, shortSid(r.sessionId) + (r.kind === "succeed" ? " · 换任" : " · 压缩")),
                 h("td", { className: "dshh-num" }, Math.round((r.leftMs || 0) / 1000) + " 秒"),
-                h("td", null, h("button", { className: "dshh-btn", type: "button", disabled: working, onClick: () => doRevoke(r.sessionId) }, "撤销"))))))
+                h("td", null, h("button", { className: "dshh-btn", type: "button", disabled: working, onClick: () => doRevoke(r.sessionId, r.kind) }, "撤销"))))))
             : h("div", { className: "dshh-muted" }, "当前无有效授权。"),
           csMsg ? h("div", { className: "dshh-ok" }, csMsg) : null)));
 

package/src/index.mjs

@@ -1,7 +1,7 @@
 /**
  * dsh-handover —— 全局运行期插件。
  * 判据进代码、流程进工具；规则正文留磁盘，需要时用 ho_charter 取节（完整流程 doc="runtime"）。
- * 按会话角色载入工具与提示段：全局 22 个工具、项目 9、杂项 9、普通 0。
+ * 按会话角色载入工具与提示段：全局 24 个工具、项目 11、杂项 11、普通 0。
  * 源码不热加载：改完要重启 DSH。
  */
 import fs from 'node:fs';
@@ -27,6 +27,8 @@ import { pmPackTool } from './tools/ho_pack.mjs';
 import { pmWorkspaceTool } from './tools/ho_workspace.mjs';
 import { pmInitTool } from './tools/ho_init.mjs';
 import { pmProfileTool } from './tools/ho_profile.mjs';
+import { pmOfficeTool } from './tools/ho_office.mjs';
+import { pmSucceedTool } from './tools/ho_succeed.mjs';
 import { pmPeerListTool } from './tools/peer_list.mjs';
 import { pmPeerStatusTool } from './tools/peer_status.mjs';
 import { pmPeerSendTool } from './tools/peer_send.mjs';
@@ -470,7 +472,7 @@ export function apply(ctx, config) {
   };
   try { applyExtraPrompt(readExtraPrompt()); } catch (e) { initErrors.push('全局前置提示词：' + msgOf(e)); }
 
-  // ---------------- 工具注册（16 个 ho_* + 6 个 peer_*）
+  // ---------------- 工具注册（18 个 ho_* + 6 个 peer_*）
   // 0.2.2 起工具按「步」解析：可用工具集合每一步重算。子会话排除与角色过滤都在这里一次做完，
   // 不再另用 agent 作用域 restrict —— 两套机制并行时，换角色要么等到重启、要么互相覆盖。
   const roleToolsets = new Map(ROLES.map((r) => [r, new Set(toolsetFor(r).allow)]));
@@ -512,8 +514,10 @@ export function apply(ctx, config) {
     pmWorkspaceTool(env),
     pmInitTool(env),
     pmProfileTool(env),
+    pmOfficeTool(env),
+    pmSucceedTool(env),
   ];
-  const keys = ['brief', 'gate', 'sessions', 'phase', 'charter', 'handover', 'checkpoint', 'snapshot', 'diag', 'drift', 'changelog', 'tokens', 'pack', 'workspace', 'init', 'profile'];
+  const keys = ['brief', 'gate', 'sessions', 'phase', 'charter', 'handover', 'checkpoint', 'snapshot', 'diag', 'drift', 'changelog', 'tokens', 'pack', 'workspace', 'init', 'profile', 'office', 'succeed'];
   for (let i = 0; i < tools.length; i++) {
     const key = keys[i];
     try {
@@ -558,7 +562,7 @@ export function apply(ctx, config) {
         const mk = (allow, why) => {
           guardLast = { sid, allow, source: why, title: titleOf(sid) };
           if (allow) return undefined;
-          if (nm === 'peer_new') return '会话创建仅属全局：非全局会话不得新建平级会话（杂项自建 Misc 换任除外）。';
+          if (nm === 'peer_new') return '会话创建仅属全局：非全局会话不得新建平级会话（杂项落到 Misc 除外）。';
           return '会话间通信受限（directPeer=off）：非全局会话只能向现任全局报告，不得唤醒其他会话。';
         };
         if (info.role === 'global') return mk(true, 'global/' + info.source);
@@ -571,7 +575,7 @@ export function apply(ctx, config) {
           if (cfg.directPeer !== 'off') return mk(true, 'direct/' + info.role + ' → ' + (t ? t.role : 'unknown'));
           return mk(false, info.source + '/' + info.role + ' → ' + (t ? t.role : 'unknown'));
         }
-        // peer_new：只有杂项可以自建 Misc 换任
+        // peer_new：只有杂项可以落到 Misc
         const target = String(args.workspace || args.cwd || '').toLowerCase();
         if (info.role === 'misc' && target.indexOf('misc') !== -1) return mk(true, 'misc/' + info.source);
         return mk(false, info.source + '/' + info.role);
@@ -689,36 +693,56 @@ export function apply(ctx, config) {
     initErrors.push('设置页路由：' + msgOf(e));
   }
 
-  // ---------------- 聊天页命令：用户在自己的输入框敲 /allow-compact 即可授权压缩
+  // ---------------- 聊天页命令：用户在自己的输入框敲 /allow-compact、/allow-succeed 即可授权
   // 为什么要有它：设置页要切页面、还要填会话 id，太绕。斜杠命令是「用户亲手敲的一行」，
   // 天然满足「只有用户能产生同意」这条判据，且不产生模型消息、不花 token。
   try {
-    const registerAllowCompact = (service) => {
-      if (!service || typeof service.register !== 'function') return;
-      const d = service.register({
+    const allowCommands = [
+      {
         name: 'allow-compact',
         description: '允许本会话压缩一次（用户授权，5 分钟有效；可带会话短号授权别的会话）',
-        input: { hint: '可留空＝本会话；填 8 位短号或 session-id 则授权那个会话' },
-        handler: ({ agent, rawInput }) => {
-          const arg = String(rawInput || '').trim();
-          const sid = arg ? resolveShortSid(env, arg) : (agent && agent.id ? String(agent.id) : '');
-          if (!sid) return { kind: 'error', text: '拿不到会话 id：请写成 /allow-compact session-xxxx' };
-          const g = grantConsent(sid, '聊天页命令 /allow-compact');
-          try { env.log('压缩授权（命令）：' + sid); } catch { /* ignore */ }
-          return { kind: 'success', text: '已允许 ' + sid + ' 在 ' + g.minutes + ' 分钟内压缩一次（用掉即失效）。' };
-        },
-      });
-      if (typeof d === 'function' && typeof ctx.effect === 'function') {
-        ctx.effect(() => d, 'dsh-handover: /allow-compact');
+        hint: '可留空＝本会话；填 8 位短号或 session-id 则授权那个会话',
+        kind: 'compact',
+        note: '聊天页命令 /allow-compact',
+        action: '压缩',
+      },
+      {
+        name: 'allow-succeed',
+        description: '允许本会话换任一次（用户授权，5 分钟有效；可带会话短号授权别的会话）',
+        hint: '可留空＝本会话；填 8 位短号或 session-id 则授权那个会话',
+        kind: 'succeed',
+        note: '聊天页命令 /allow-succeed',
+        action: '换任',
+      },
+    ];
+    const registerAllow = (service) => {
+      if (!service || typeof service.register !== 'function') return;
+      for (const cmd of allowCommands) {
+        const d = service.register({
+          name: cmd.name,
+          description: cmd.description,
+          input: { hint: cmd.hint },
+          handler: ({ agent, rawInput }) => {
+            const arg = String(rawInput || '').trim();
+            const sid = arg ? resolveShortSid(env, arg) : (agent && agent.id ? String(agent.id) : '');
+            if (!sid) return { kind: 'error', text: '拿不到会话 id：请写成 /' + cmd.name + ' session-xxxx' };
+            const g = grantConsent(sid, cmd.note, cmd.kind);
+            try { env.log(cmd.action + '授权（命令）：' + sid); } catch { /* ignore */ }
+            return { kind: 'success', text: '已允许 ' + sid + ' 在 ' + g.minutes + ' 分钟内' + cmd.action + '一次（用掉即失效）。' };
+          },
+        });
+        if (typeof d === 'function' && typeof ctx.effect === 'function') {
+          ctx.effect(() => d, 'dsh-handover: /' + cmd.name);
+        }
       }
     };
     // 可选服务：能用 ctx.inject 就走注入（老宿主没有 commands 时插件照常激活），否则退回直取。
     if (typeof ctx.inject === 'function') {
       ctx.inject(['commands'], (scope) => {
-        try { registerAllowCompact(scope && scope.commands); } catch (e) { initErrors.push('命令注册：' + msgOf(e)); }
+        try { registerAllow(scope && scope.commands); } catch (e) { initErrors.push('命令注册：' + msgOf(e)); }
       });
     } else {
-      registerAllowCompact(ctx.commands);
+      registerAllow(ctx.commands);
     }
   } catch (e) {
     initErrors.push('命令注册：' + msgOf(e));

package/src/lib/api.mjs

@@ -1,4 +1,4 @@
-/**
+/**
  * 设置页数据与动作的唯一实现：HTTP 路由（旧通道）和 /api 载体（新通道）都调它。
  * 返回统一信封：{ ok:true, value } | { ok:false, error:{code,message,details}, http }。
  * http 只是给旧 HTTP 通道用的状态码提示，载体通道不用它。
@@ -240,8 +240,9 @@ export function createApi(env, info) {
       if (method === 'consent.grant') {
         const sid = resolveShortSid(env, p.session_id);
         if (!sid) return bad('bad-request', '缺少 session_id');
-        const g = grantConsent(sid, '设置页点击');
-        env.log('压缩授权：' + sid + '（5 分钟）');
+        const kind = p.kind === 'succeed' ? 'succeed' : 'compact';
+        const g = grantConsent(sid, kind === 'succeed' ? '设置页点击换任' : '设置页点击', kind);
+        env.log((kind === 'succeed' ? '换任' : '压缩') + '授权：' + sid + '（5 分钟）');
         invalidateStatus(env);
         return ok(g);
       }
@@ -250,7 +251,7 @@ export function createApi(env, info) {
 
       if (method === 'consent.revoke') {
         const sid = String(p.session_id || '').trim();
-        if (sid) consumedConsent(sid);
+        if (sid) consumedConsent(sid, p.kind === 'succeed' ? 'succeed' : 'compact');
         invalidateStatus(env);
         return ok({ revoked: sid });
       }

package/src/lib/consent.mjs

@@ -1,14 +1,17 @@
 /**
- * 压缩授权：压缩会丢历史，所以「同意」必须由用户自己产生，AI 不能自己给自己批。
+ * 一次性授权：压缩会丢历史，换任会换掉在任会话，所以「同意」必须由用户自己产生，AI 不能自己给自己批。
  *
- * 做法：唯一的授权入口是设置页上的一次点击（用户在场、只能是用户按），
- * 授权一次有效 5 分钟、只对指定会话生效；`ho_checkpoint`、全局代排与调度器三处都校验它。
+ * 做法：授权入口只有用户亲手产生的那一次（设置页点击或聊天页斜杠命令），
+ * 授权一次有效 5 分钟、只对指定会话与指定种类生效；压缩与换任各有各的授权，互不顶替。
+ * 种类取 compact（压缩）或 succeed（换任），缺省为 compact；旧文件里没有 kind 的条目按 compact 处理。
  */
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 
 export const CONSENT_TTL_MS = 5 * 60 * 1000;
+export const CONSENT_KINDS = ['compact', 'succeed'];
+const DEFAULT_KIND = 'compact';
 
 function consentPath() {
   const home = process.env.USERPROFILE || process.env.HOME || os.homedir();
@@ -37,48 +40,84 @@ function stampNow() {
   return d.getUTCFullYear() + '-' + p(d.getUTCMonth() + 1) + '-' + p(d.getUTCDate()) + ' ' + p(d.getUTCHours()) + ':' + p(d.getUTCMinutes()) + ' +0800';
 }
 
-/** 用户点了一次「允许该会话压缩一次」。 */
-export function grantConsent(sessionId, note) {
+function kindOf(kind) {
+  const k = String(kind === undefined || kind === null ? '' : kind).trim();
+  if (!k) return DEFAULT_KIND;
+  if (CONSENT_KINDS.indexOf(k) === -1) throw new Error('未知授权种类：' + k + '（只能是 compact 或 succeed）');
+  return k;
+}
+
+/**
+ * 存储键：压缩沿用会话 id 本身（兼容旧文件），换任另加后缀，两种授权可以同时存在。
+ */
+function keyFor(sid, kind) {
+  return kind === DEFAULT_KIND ? sid : sid + '|' + kind;
+}
+
+function sidOfKey(key) {
+  return key.indexOf('|') === -1 ? key : key.slice(0, key.indexOf('|'));
+}
+
+/** 条目自身的种类优先；旧条目没有 kind，按 compact 处理。 */
+function kindOfEntry(key, entry) {
+  const k = entry && entry.kind ? String(entry.kind) : '';
+  if (CONSENT_KINDS.indexOf(k) !== -1) return k;
+  return key.indexOf('|succeed') === -1 ? DEFAULT_KIND : 'succeed';
+}
+
+/** 用户授权一次：kind 缺省为压缩。 */
+export function grantConsent(sessionId, note, kind) {
   const sid = String(sessionId || '');
   if (!sid) throw new Error('缺少会话 id');
+  const k = kindOf(kind);
   const all = readAll();
   const now = Date.now();
-  all[sid] = { at: now, until: now + CONSENT_TTL_MS, atText: stampNow(), note: String(note || '') };
+  const key = keyFor(sid, k);
+  all[key] = { at: now, until: now + CONSENT_TTL_MS, atText: stampNow(), note: String(note || ''), kind: k };
   writeAll(all);
-  return { sessionId: sid, until: new Date(all[sid].until).toISOString(), minutes: CONSENT_TTL_MS / 60000, atText: all[sid].atText };
+  return { sessionId: sid, kind: k, until: new Date(all[key].until).toISOString(), minutes: CONSENT_TTL_MS / 60000, atText: all[key].atText };
 }
 
 /** 授权是否有效（每次读取时一并清除已过期者）。 */
-export function checkConsent(sessionId) {
+export function checkConsent(sessionId, kind) {
   const sid = String(sessionId || '');
+  const k = kindOf(kind);
   if (!sid) return { ok: false, reason: '没有会话 id' };
   const all = readAll();
-  const hit = all[sid];
+  const key = keyFor(sid, k);
+  const hit = all[key];
   const now = Date.now();
   let dirty = false;
-  for (const k of Object.keys(all)) {
-    if (!all[k] || !all[k].until || all[k].until <= now) { delete all[k]; dirty = true; }
+  for (const keyName of Object.keys(all)) {
+    if (!all[keyName] || !all[keyName].until || all[keyName].until <= now) { delete all[keyName]; dirty = true; }
   }
   if (dirty) { try { writeAll(all); } catch { /* ignore */ } }
   if (!hit || !hit.until || hit.until <= now) {
-    return { ok: false, reason: '用户还没有在设置页点「允许压缩」' };
+    return {
+      ok: false,
+      kind: k,
+      reason: k === 'succeed' ? '用户还没有授权换任（聊天页命令 /allow-succeed）' : '用户还没有在设置页点「允许压缩」',
+    };
   }
-  return { ok: true, until: hit.until, leftMs: hit.until - now, atText: hit.atText || '' };
+  return { ok: true, kind: k, until: hit.until, leftMs: hit.until - now, atText: hit.atText || '' };
 }
 
-export function consumedConsent(sessionId) {
+export function consumedConsent(sessionId, kind) {
   const all = readAll();
   const sid = String(sessionId || '');
-  if (all[sid]) { delete all[sid]; try { writeAll(all); } catch { /* ignore */ } }
+  const key = keyFor(sid, kindOf(kind));
+  if (all[key]) { delete all[key]; try { writeAll(all); } catch { /* ignore */ } }
 }
 
 export function listConsent() {
   const all = readAll();
   const now = Date.now();
-  return Object.keys(all).map((sid) => ({
-    sessionId: sid,
-    leftMs: Math.max(0, (all[sid].until || 0) - now),
-    atText: all[sid].atText || '',
-    note: all[sid].note || '',
+  const rows = Object.keys(all).map((key) => ({
+    sessionId: sidOfKey(key),
+    kind: kindOfEntry(key, all[key]),
+    leftMs: Math.max(0, (all[key].until || 0) - now),
+    atText: all[key].atText || '',
+    note: all[key].note || '',
   })).filter((r) => r.leftMs > 0);
+  return rows.sort((a, b) => a.sessionId.localeCompare(b.sessionId, 'zh') || a.kind.localeCompare(b.kind));
 }

package/src/lib/facts.mjs

@@ -1,6 +1,6 @@
 /**
- * 口径单一来源：水位阈值、压缩次数与提示段 token 预算。
- * 运行期文本一律由本模块渲染；改数值只改 config.mjs 的默认值或本文件的预算表。
+ * 口径单一来源：水位阈值、压缩次数与提示段 token 参考值。
+ * 运行期文本一律由本模块渲染；改数值只改 config.mjs 的默认值或本文件的参考表。
  * 文档与测试引用同一组常量，避免同一事实多处各写一遍。
  */
 import { DEFAULTS } from './config.mjs';
@@ -57,9 +57,10 @@ function isWide(cp) {
 }
 
 /**
- * 上下文成本上限（加权 token）。
+ * 上下文成本参考值（加权 token）。
  * 全局段按短工作区路径计；worst 档按真实长路径加迁移提示行计。
- * 单条工具描述单独设限，避免每次请求的固定开销无界增长。
+ * 仅供参考：用于设置页展示与冒烟实测，不作为通过条件，也不参与任何拒绝或截断。
+ * 提示词效果优先于字数，实测值超出参考值时如实展示即可。
  */
 export const TOKEN_BUDGET = {
   globalTokens: 320,

package/src/lib/guide.mjs

@@ -32,7 +32,7 @@ export function buildGuide(cfg) {
     { when: '查阅规则', say: '把 Charter 第 7.2.3 节取出来', what: '按节返回规则正文，避免整篇读取（ho_charter；完整流程用 doc="runtime"）' },
     { when: '交接与压缩续跑', say: '先把交接文档写好，再压缩并继续', what: '写自己角色的交接、体检、登记压缩，并由助手选择压缩后去向：继续工作时用 resume=continue，任务已收尾时用 resume=wait（压缩后不唤醒）（ho_handover、ho_checkpoint）' },
     { when: '接近上下文上限', say: '查一下本会话的上下文水位', what: compact + '（ho_phase）' },
-    { when: '换任', say: '建立下一代全局会话', what: '建会话、唤醒并投递启动提示词；在任会话水位低于 ' + w.warn + ' 时拒绝新建（ho_sessions action=new）' },
+    { when: '换任', say: '让在任会话自己完成换任', what: '用户先发送 /allow-succeed 授权，在任会话随后校验交接、建接任会话并登记在任（ho_succeed）；全局仍可用 ho_sessions action=new 手动新建会话' },
     { when: '会话角色', say: '把 Demo1 设成项目角色，并让它整理自己的文件', what: '写角色表、当场收窄该会话的工具与提示、投递一次性整理指令（ho_sessions action=role / 本页会话角色）' },
     { when: '通知项目会话', say: '通知 Demo 更新交接文档', what: '投递一条消息；会话之间可直接对话，不必经全局转述；会消耗目标会话一整轮 token，应尽量少用（peer_send）' },
     { when: '全局前置提示词', say: '把这段设为全局前置提示词', what: '保存到本机；仅在你开启且内容非空时注入全部会话，关闭或留空时不注册提示段' },
@@ -44,6 +44,7 @@ export function buildGuide(cfg) {
     { when: '建立工作区', say: '把这个目录注册为工作区', what: '注册已存在的目录；删除只删注册，目录与会话日志均保留（ho_workspace）' },
     { when: '首次安装', say: '把某个目录建成全局根目录', what: '在该目录下建立整套全局文件体系，并注册为工作区（ho_init）' },
     { when: '自检', say: '检查插件当前状态', what: '服务可解析性、压缩调度器、压缩计数、本会话角色与工具集（ho_diag）' },
+    { when: '查在任', say: '现在 Mingent 是谁在任', what: '按全局、项目、杂项查现任会话的名字与会话 id（ho_office）；不起会话也可用命令行 node scripts/office.mjs 同名查询' },
   ],
   groups: [
     {
@@ -57,6 +58,7 @@ export function buildGuide(cfg) {
         ['ho_drift', '交接漂移体检：Δ 为当前轮与交接轮之差，大于 3 需刷新'],
         ['ho_diag', '插件自检：服务、调度器、压缩计数、角色判定与工具集'],
         ['ho_tokens', '会话 token 体检：轮数、步数、每步 token、最贵的单条返回'],
+        ['ho_office', '在任登记表：查全局、项目、杂项现在由哪个会话在任（名字与会话 id）'],
       ],
     },
     {
@@ -70,6 +72,7 @@ export function buildGuide(cfg) {
         ['ho_workspace', '工作区列表、创建、删除；删除只删注册'],
         ['ho_init', '首次安装：在指定目录下建立整套全局文件体系，可顺带注册工作区'],
         ['ho_profile', '项目或杂项骨架：读取、注册、校验、取预设'],
+        ['ho_succeed', '换任自服务：在任会话经用户授权后自行校验交接、建接任会话并登记在任'],
       ],
     },
     {

package/src/lib/manual.mjs

@@ -10,7 +10,16 @@ import { handoverRuleText, watermark } from './facts.mjs';
 const NL = String.fromCharCode(10);
 
 /** 完整流程的指针句（三档角色共用）。 */
-const RUNTIME_POINTER = '规则细节按节取：ho_charter(doc="runtime", section=…)。';
+const RUNTIME_POINTER = '细节按节取：ho_charter(doc="runtime", section=…)。';
+
+/**
+ * 复用准则：全局、项目、杂项三处必须同一句。
+ * 派活与新建会话前先查在任，低水位在任直接复用；确需另建才新建。
+ */
+function reuseRule(cfg) {
+  return '指派任务或新建会话前，先用 ho_office（空参数）查一次在任；同一类别已有在任且其水位低于 '
+    + watermark(cfg).warn + ' 时，直接用 peer_send 复用，不新建；确需另建（原会话不可用、需并行、用户明确要求）时才新建。';
+}
 
 /** 全局会话的常驻段：五节骨架（身份、权限、节奏、交接、按需取用）。 */
 export function globalManual(opts) {
@@ -19,18 +28,19 @@ export function globalManual(opts) {
     'dsh-handover 运行期（全局）',
     '',
     '一、身份',
-    '本会话为「全局」管理会话：协调会话、维护规则与交接。',
+    '本会话为全局管理会话，协调会话、维护规则与交接。',
     '',
     '二、权限',
-    '可写 _Control_Center、_Project_Meta 与项目结构本身；Projects 与各项目库内文件只读，不得代改写；项目内作业不代办。',
-    '新建会话与设定角色仅属全局；会话之间可直接 peer_send，不必经全局转述；换任须经用户同意。',
+    '可写 _Control_Center、_Project_Meta 与项目结构；Projects 及各项目库内文件只读，不得代写；项目内作业不代办。',
+    '新建会话与设定角色仅属全局；会话间可直接 peer_send；换任须用户授权（/allow-succeed 或设置页）后由在任会话调用 ho_succeed，不再请求全局。',
+    reuseRule(o.cfg),
     '',
     '三、节奏',
     handoverRuleText(o.cfg),
-    '压缩须用户点「压缩授权」，随后写交接并 ho_checkpoint(confirm=true)；任务未完成时压缩后续跑，已收尾时传 resume=wait 不再唤醒；confirm 仅表意图，插件只认那次点击。关键步骤传 at_risk=true 暂缓。',
+    '压缩须用户点「压缩授权」，再写交接并 ho_checkpoint(confirm=true)；任务未完成传 resume=continue，已收尾传 resume=wait，不再唤醒。confirm 仅表意图，授权以点击为准。关键步骤传 at_risk=true 暂缓。',
     '',
     '四、交接',
-    '全局交接：_Control_Center/records/Global_Handover.md（ho_handover 默认）。',
+    '交接：_Control_Center/records/Global_Handover.md。',
     '',
     '五、按需取用',
     RUNTIME_POINTER,
@@ -62,8 +72,9 @@ export function scopedManual(info, opts) {
     hp.path
       ? '交接：' + hp.path + '（ho_handover 默认）。'
       : '交接路径未解析（缺角色或项目名），请先在设置页设定角色。',
-    handoverRuleText(o.cfg) + '压缩须用户点「压缩授权」，再自行 ho_checkpoint(confirm=true)；收尾时传 resume=wait 不再唤醒。',
-    '会话间可直接 peer_send，不必经全局转述；默认沉默：只在水位 ' + watermark(o.cfg).warn + ' 已写交接、需用户决定、口径有误时向全局报告；任务完成不报全局。',
+    handoverRuleText(o.cfg) + '压缩须用户点「压缩授权」，再由本会话执行 ho_checkpoint(confirm=true)；收尾时传 resume=wait，不再唤醒。',
+    '会话间可直接 peer_send；默认沉默：仅在水位 ' + watermark(o.cfg).warn + ' 且已写交接、需用户决定、全局口径有误时向全局报告；任务完成不报全局。',
+    reuseRule(o.cfg),
     RUNTIME_POINTER,
   ];
   const mv = moveLine(o);
@@ -90,12 +101,12 @@ export function organizeMessageFor(info, opts) {
   const o = opts || {};
   const role = info && info.role ? info.role : 'plain';
   if (role === 'plain') return '';
-  const head = '【dsh-handover 角色设定】本会话已被设定为「' + scopeLabel(info) + '」。请按下列结构核对自身文件：缺失的目录予以建立，位置不当的文件予以归位；既有文件就地保留，不得删除或修改内容。';
+  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_snapshot。可用工具：ho_snapshot、ho_handover、ho_phase、ho_checkpoint、ho_profile、peer_send。',
@@ -106,10 +117,10 @@ export function organizeMessageFor(info, opts) {
     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_snapshot、ho_handover、ho_phase、ho_checkpoint、ho_profile、peer_send。',
+      '约束：仅可改动 _Misc/tasks/' + t + '/、_Temp/_Misc/' + t + '/、_Archives/_Misc/' + t + '/；_Control_Center、Projects 与其他任务不得写入。工具：ho_snapshot、ho_handover、ho_phase、ho_checkpoint、ho_profile、peer_send。',
       '完成后以一句话说明改动即可。',
     ].join(NL);
   }

package/src/lib/names.mjs

@@ -7,7 +7,7 @@ const PREFIX = 'ho';
 export const nameOf = (key) => PREFIX + '_' + key;
 
 /**
- * ho_* 16 个。合并过的家族（刻意保持旧名，参数里用 action 分流）：
+ * ho_* 18 个。合并过的家族（刻意保持旧名，参数里用 action 分流）：
  *   ho_pack     —— 打包 / 校验 / 预演 / 恢复（原 ho_pack_verify、ho_pack_restore、ho_pack_precheck）
  *   ho_sessions —— 清点 / 设定角色 / 建会话 / 出提示词 / 归档 / 解归档（原 ho_session_new、ho_prompt、ho_session_archive、ho_session_unarchive）
  *   ho_profile  —— 骨架读取 / 注册 / 校验 / 预设
@@ -16,7 +16,7 @@ const KEYS = [
   'brief', 'gate', 'sessions', 'phase', 'charter',
   'handover', 'checkpoint', 'snapshot', 'diag',
   'drift', 'changelog', 'tokens',
-  'pack', 'workspace', 'init', 'profile',
+  'pack', 'workspace', 'init', 'profile', 'office', 'succeed',
 ];
 
 export const NAMES = KEYS.reduce((acc, k) => { acc[k] = nameOf(k); return acc; }, {});