@mingmaple/dsh-handover 0.9.13 → 0.9.22

package/src/lib/succession.mjs

@@ -12,7 +12,7 @@ import { lineageKeyOf, loadOffice, nextName, registerHolder, stampNow } from './
 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 { resolveWorkspaceFor, promptFor, workspaceIdOfPath, workspacePathOf } from './session-ops.mjs';
 import { watermark } from './facts.mjs';
 
 /** 交接里不得残留的占位符。 */
@@ -22,6 +22,14 @@ function msgOf(e) {
   return String(e && e.message ? e.message : e);
 }
 
+/** 现任全局会话 id（登记表是唯一事实源）；没有记录或读不到时返回空串。 */
+function currentGlobalId(ws) {
+  try {
+    const lin = loadOffice(ws).lineages['全局'];
+    return lin && lin.current && lin.current.sessionId ? String(lin.current.sessionId) : '';
+  } catch { return ''; }
+}
+
 /**
  * 找接任指令节：含「## 下一步」或「## 2.」这类标题；没有标题时接受 §2 的写法。
  * 判据与 ho_gate 的交接体检一致：这一节至少要有一个条目（列表、表格或编号行）。
@@ -106,14 +114,14 @@ export async function runSuccession(env, exec, opts) {
 
   // 2. 用户授权：AI 不能自行批准。
   const selfId = env.selfId(exec);
-  if (!selfId) return reject('拿不到当前会话 id，无法校验授权。');
+  if (!selfId) return reject('无法获取当前会话 id，无法校验授权。');
   const cs = checkConsent(selfId, 'succeed');
   if (!cs.ok) {
     return reject([
       cs.reason + '。',
       '授权方式（任选其一）：',
       '  ① 在聊天框发送 /allow-succeed（最快，仅授权本会话）；',
-      '  ② 在设置页的 dsh-handover 中点击「换任授权」的「允许换任」。',
+      '  ② 在设置页的 dsh-handover 中，点击「授权」里的「授权换任」。',
       '授权有效期 5 分钟，用后失效。',
     ].join(NL));
   }
@@ -165,21 +173,29 @@ export async function runSuccession(env, exec, opts) {
   // 5. 分配编号：登记表历史最大号加一，不采用会话自述。
   const name = nextName(store, key);
 
-  // 6. 确定工作区：与 ho_sessions(action="new") 同一套解析；杂项落到本会话所在工作区。
+  // 6. 确定工作区：与 ho_sessions(action="new") 同一套解析。
+  // 杂项接任者落回**本会话所在的注册工作区**（按会话 cwd 反查）；反查不到才退回工作区根。
   let workspaceId = '';
   try {
-    workspaceId = resolveWorkspaceFor(env, exec, kind, project, task, kind === 'misc' ? { workspace: ws } : {});
+    let wsOpt = {};
+    if (kind === 'misc') {
+      const selfCwd = typeof env.selfCwd === 'function' ? String(env.selfCwd(exec) || '') : '';
+      wsOpt = selfCwd && workspaceIdOfPath(env, selfCwd) ? { cwd: selfCwd } : { workspace: ws };
+    }
+    workspaceId = resolveWorkspaceFor(env, exec, kind, project, task, wsOpt);
   } catch (e) {
     return reject(msgOf(e));
   }
 
   // 7. 拼启动提示词：末尾追加交接路径与「先读交接、读毕报到」。
+  // 「全局 id」填**现任全局**：项目与杂项换任时，已交出的旧会话不是全局，不能顶替这个位置。
   let prompt = '';
   try {
-    const base = promptFor(env, { ws, kind, project, task, title: name, sessionId: '', globalSessionId: selfId, extra: '' });
+    const globalId = kind === 'global' ? selfId : (currentGlobalId(ws) || selfId);
+    const base = promptFor(env, { ws, kind, project, task, title: name, sessionId: '', globalSessionId: globalId, extra: '' });
     prompt = base + NL + NL + [
       '接任交接：' + handoverFile,
-      '先读这份交接再动手；读毕向用户报告当前停在哪一步、交接列有哪些待办，然后等待用户指派任务。',
+      '先读这份交接再动手；读毕向当前用户报告当前停在哪一步、交接列有哪些待办，然后等待当前用户指派任务。',
     ].join(NL);
   } catch (e) {
     return reject('启动提示词生成失败：' + msgOf(e));
@@ -195,11 +211,11 @@ export async function runSuccession(env, exec, opts) {
   // 9. 登记在任：原在任者自动进历史，Registry.md 在役列同步。
   let reg = null;
   try {
-    reg = registerHolder(ws, { kind, project, task, name, sessionId, workspace: ws, note });
+    reg = registerHolder(ws, { kind, project, task, name, sessionId, workspace: workspacePathOf(env, workspaceId) || ws, note });
   } catch (e) {
     return [
       '会话已建 ' + sessionId + '（' + name + '），但登记在任失败：' + msgOf(e),
-      '启动提示词尚未投递；先修好登记表，再用 peer_send 通知它。',
+      '启动提示词尚未投递；先修好登记表，再用 peer（action="send"）通知它。',
     ].join(NL);
   }
 
@@ -237,8 +253,8 @@ export async function runSuccession(env, exec, opts) {
   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('启动提示词：' + (delivered ? '已投递' : '未送达：' + deliveryError + '。会话已建，可用 peer（action="send"）补投'));
   out.push('交接登记：' + appendNote);
-  out.push('本会话到此停止，等待用户在新会话中派任务。');
+  out.push('本会话到此停止，等待当前用户在新会话中派任务。');
   return out.join(NL);
 }

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/Prompt_Templates.md

@@ -5,24 +5,24 @@
 ## 1 共用骨架（所有消息都由它起头）
 
 ```text
-你是<角色>，由全局管理对话创建并交接。
+你是<角色>，由全局管理会话创建并交接。
 第一条要读的：<绝对路径>（读毕再开始作业）。| 项目→ _Project_Meta/<项目名>/Handover.md；全局→ records/Global_Handover.md；杂项首任→ rules/Misc_Task_Standard.md
 不得每轮回执，也不发送「收到」「已完成」一类确认；全局只看文件末态。
-你的 session id：<本会话 id>。确需向全局发消息时，以 `peer_send` 发至 <全局 id>。| 不得据 peer_list 推测 id
-水位：≥32% 应先写毕交接、再通知全局，并提醒用户换会话；>35% 不得新开任务。
-边界：只读写 <范围>。删除或覆盖前须先留快照，**删除须经用户确认**。对用户可见一律中文（含工具 description 字段）。
+你的 session id：<本会话 id>。确需向全局发消息时，以 `peer`（action="send"）发至 <全局 id>。| 不得据 `peer`（action="list"）推测 id
+水位：≥32% 应先写毕交接、再通知全局，并提醒当前用户换会话；>35% 不得新开任务。
+边界：只读写 <范围>。删除或覆盖前须先留快照，**删除须经当前用户确认**。对用户可见一律中文（含工具 description 字段）。
 时间一律**带时区偏移**书写（如 2026-10-21 07:58 +0800），不写「今天、几点」这种会漂移的说法；本机时区 Asia/Shanghai（+08:00），历史记录里的 +00:00 与新记录按**绝对时刻**比较。
 简单任务直接执行、直接答复；工具正常返回即予采信，不重复核验。子智能体按成本使用：单个子智能体自身亦需十余步，五个约等于另开一整个会话。仅当单块 ≥15 步且可机械验收、或确需隔离时方可派发，并发 ≤3；一文件一派、将机械批处理拆成 N 份均属反模式；可脚本批量并抽样验收者应先写脚本。判断不清者默认自行完成（Charter §十一）。
 ```
 
-> 7 行是**上限**，不是起点：宜少不宜多，只保留「不写就会做错」的条目。
+> 现行骨架 8 行，是**上限**而不是起点：宜少不宜多，只保留「不写就会做错」的条目。
 
 ## 2 消息一 · 新会话启动
 
 ### 2.1 全局（接任或首任）
 
 ```text
-<骨架 6 行>
+<骨架（见 §1）>
 你是第 <N> 任全局，标题「全局<N>」，链内代数第 <M> 代。
 作业顺序：读交接 → 核对 §6 的路径与命令是否仍然有效 → 不一致时先对齐再行动。
 阅读范围（按需取用，不要求预先通读）：先读交接；全局流程与自己这个角色的硬边界见 Workspace_Charter.md（§7.2 会话与交接、§8 边界与铁律）；**写文档时才读** user/Writing_Rules.md 与 templates/ 下对应文件。
@@ -32,23 +32,23 @@
 ### 2.2 项目（首任或接任）
 
 ```text
-<骨架 6 行>
-你是「<项目名>」项目的执行对话，标题「<项目名><N>」。
+<骨架（见 §1）>
+你是「<项目名>」项目的执行会话，标题「<项目名><N>」。
 库根：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`（action="new"）**，也不向全局请求换任。
 ```
 
 ### 2.3 杂项（只在首任时由全局发，此后自理）
 
 ```text
-<骨架 6 行>
+<骨架（见 §1）>
 你是杂项任务会话，标题「<任务短名>」，不编号。
 任务目录：_Misc/tasks/<任务短名>/（产物、脚本、日志都放这里）
 三件文件：Project_Overview.md（是什么/边界/验收判据）· Changelog.md（环境事实/变更/回滚，只追加）· Handover.md（在途）
 换任自办（规则见插件注入的提示段）：接任者名字与会话 id 由插件写进登记表并在旧交接末尾追加登记，不通知全局。
-本任务：<任务正文>| 用户原话照抄，不改写、不缩范围、不替用户补验收判据
+本任务：<任务正文>| 当前用户原话照抄，不改写、不缩范围、不替当前用户补验收判据
 ```
 
 ## 3 消息二 · 换任（已停用）
@@ -73,12 +73,12 @@
 ## 6 消息五 · 迁移通知（打包前刷交接）
 
 ```text
-【平台迁移通知】用户要把整个工作区搬到另一个平台，打包前需要你刷一次交接。
+【平台迁移通知】当前用户要把整个工作区搬到另一个平台，打包前需要你刷一次交接。
 只做三件事，1 分钟内完成；**不要开新任务、不要跑全量自检、不要改库内文件**：
 1) 把 _Project_Meta/<项目名>/Handover.md 的「在途、下一步、关键路径」刷成最新；
 2) 绝对路径改成 <工作区根>/... 的相对写法（新平台的根不同）；
 3) 回一行：迁移交接完成｜<项目名>｜在途：<有/无>｜<一句话>
-搬库不带对话记录，Handover.md 是唯一的连续性来源。
+搬库不带会话记录，Handover.md 是唯一的连续性来源。
 ```
 
 ## 7 发送纪律

package/src/templates/Runtime_Manual.md

@@ -2,46 +2,42 @@
 
 > 这是**按需取回**的全文：系统提示里只留短段与指针，需要细节时用 `ho_charter(doc="runtime")` 取本文。
 >
-> **内置即默认**：本文、Charter 骨架、交接、台账骨架、提示词模板、四份规则文档都随插件发布（`dist/templates/`）。工作区里的同名文件只是「本地化覆盖」；删掉就自动回到内置，功能不降级。`ho_init` 是把默认口径写入磁盘，便于修改，**不是使用前提**。
+> **内置即默认**：本文、Charter 骨架、交接、台账骨架、提示词模板、四份规则文档都随插件发布（`dist/templates/`）。工作区里的同名文件只是「本地化覆盖」；删掉就自动回到内置，功能不降级。`ho_workspace(action="init")` 是把默认口径写入磁盘，便于修改，**不是使用前提**。
 > 口径冲突时以工作区的 `_Control_Center/rules/` 为准；本文只讲「插件怎么用、角色怎么分」。
 
 ## 1. 角色四档
 
 | 角色 | 判定顺序 | 交接文件 | 可见工具 |
 |---|---|---|---|
-| 全局 | 角色表 → 标题含「全局」 → 全局工作区 | `_Control_Center/records/Global_Handover.md` | 24 个（全部） |
+| 全局 | 角色表 → 标题含「全局」 → 全局工作区 | `_Control_Center/records/Global_Handover.md` | 14 个（全部） |
 | 项目 | 角色表（带项目名）→ cwd 在 `Projects/<名>/` → 首条提示含 `Projects/<名>/` | `_Project_Meta/<项目>/Handover.md` | 11 个 |
-| 杂项 | 角色表（带任务名）→ cwd 在 `_Misc/tasks/<任务>/` | `_Misc/tasks/<任务>/Handover.md` | 11 个 |
+| 杂项 | 角色表（带任务名）→ cwd 在 `_Misc/tasks/<任务>/` | `_Misc/tasks/<任务>/Handover.md` | 10 个 |
 | 普通 | 子会话，或都不中 | 无（不参与交接） | 0 个（不注入提示段） |
 
 角色表在 `~/.dsh/storages/dsh-handover.roles.json`，是**本机状态**，不进仓库、不进迁移包。子会话默认普通；需要时由全局在角色表里指定。
 设定入口：设置 → dsh-handover →「会话角色」；或对全局说「把 Demo1 设成项目角色」，它用 `ho_sessions(action="role")` 办。
 
-## 2. 工具清单（24 个）
+## 2. 工具清单（14 个）
 
 ### 只读
-- `ho_brief` —— 起始与收束的单条命令：水位、闸门、会话清点、阶段建议。
-- `ho_gate` —— 通用约束条闸门（按骨架档案的库型判定）＋交接文档体检。
+- `ho_status` —— 会话状态，`view` 分流：`phase`（缺省；水位、压缩次数、锁、建议动作，并列出当前授权）、`brief`（起始简报：水位、闸门、会话清点、漂移、阶段建议）、`diag`（插件自检：服务、调度器、初始化错误、角色与工具集）、`drift`（交接漂移：Δ＝当前轮−交接轮，>3 需刷新）、`tokens`（token 体检，需 `sessions`）。
+- `ho_gate` —— 通用约束条闸门（按骨架档案的库型判定）＋交接文档体检＋文档定位 map 的路径检查。
 - `ho_sessions` —— 会话清点；也用来设定角色、建会话、出提示词、归档、解归档（`action` 分流）。
-- `ho_phase` —— 本会话水位、已压缩次数、锁状态、建议动作。
 - `ho_charter` —— 按节取规则正文：`doc`＝`charter`（缺省）、`handover_rules`、`migration_rules`、`misc_standard`、`writing_rules`、`runtime`（本文全文）；`section` 留空只列目录。**工作区没有对应规则文件时退回插件内置默认口径**（输出会注明），所以换到空白机器也不会变空壳。
-- `ho_drift` —— 交接漂移：Δ＝当前轮−交接轮，>3 需刷新。
-- `ho_diag` —— 插件自检：服务、调度器、压缩计数、工作区、角色判定。
-- `ho_tokens` —— 会话 token 体检：轮数、步数、每步 token、最贵单条返回。
 - `ho_office` —— 查在任：输入「全局」「全局3」「项目名」等，返回现任会话的名字与会话 id；多个名字空格分隔，留空列出全部。
-- `peer_list` / `peer_status` / `peer_peek` —— 平级会话清点与近期对话（peek 会花本会话 token）。
+- `ho_docmap` —— 本会话的文档定位：`action=read|write|check`。写入范围由本会话角色决定，不接受传入项目名；写入者必须是在任会话，已交出的旧会话只读。
 
 ### 写
 - `ho_handover` —— 读、写、追加、归档**本会话自己的**交接（写前自动备份、写后按角色体检）。
 - `ho_checkpoint` —— 写交接 → 体检 → 登记压缩 → 轮末自动压缩。`resume=continue`（缺省）压缩后续跑；`resume=wait` 表示任务已收尾，压缩后不唤醒。
-- `ho_snapshot` —— 库快照：逐字节复制、sha256 清单、来源说明。
 - `ho_changelog` —— 按固定表格追加一行台账。
-- `ho_pack` —— `action`：`check`（打包前置闸门）、`pack`（打包，缺省）、`verify`（校验包是否仍是现版）、`restore`（默认预演，覆盖前备份，从不删除目标文件）。`format=auto|7z|tar`：有 7-Zip 出 `.7z`，没有就出 `.tar.gz`（内置归档器，功能等价）；解包按魔数识别，包内路径必须是相对路径且不含 `..`，否则整体中止。
-- `ho_workspace` —— 工作区 list、create、delete（删除只删注册）与换盘动作。
-- `ho_init` —— 首次安装：在指定目录下建整套全局文件体系，可顺带注册工作区。
+- `ho_backup` —— `action`：`snapshot`（缺省；库快照，逐字节复制、sha256 清单、来源说明）、`check`（打包前置闸门）、`pack`（打包）、`verify`（校验包是否仍是现版）、`restore`（默认预演，覆盖前备份，从不删除目标文件）。`format=auto|7z|tar`：有 7-Zip 出 `.7z`，没有就出 `.tar.gz`（内置归档器，功能等价）。
+- `ho_workspace` —— `action`：`init`（首次安装：在指定目录下建整套全局文件体系，可顺带注册工作区）、`scaffold`（在已部署的全局根上补齐缺失的目录与说明文件，只新建、不覆盖）、`list`、`create`、`delete`（删除只删注册）、`move-*`（搬迁全局根目录）。
 - `ho_profile` —— 项目或杂项的骨架注册：由所属会话通读自己的库后写入并校验。
 - `ho_succeed` —— 换任：用户授权后校验交接、按记录分配编号、建立接任会话、登记在任并投递启动提示词。
-- `peer_send` / `peer_new` / `peer_rename` —— 投递消息、建平级会话、只改标题。
+
+### 平级会话
+- `peer` —— `action`：`send` 投消息（唯一消耗对方 token 的动作）、`status` 单会话详情、`list` 一览、`peek` 近期会话历史（耗本会话 token）、`rename` 只改标题、`new` 新建。`list`、`peek`、`rename` 仅全局可用；`send`、`status` 各角色可用；`new` 全局可用，杂项可建到 Misc 下。
 
 ### ho_sessions 的 action
 | action | 作用 | 关键参数 |
@@ -59,7 +55,7 @@
 
 - 32% 提醒、35% 交接线、85% 硬顶；同一会话最多压缩 3 次（共 4 段使用）。数值来自 `config.mjs`，提示段与设置页由 `lib/facts.mjs` 统一渲染。
 - 到线流程：`ho_handover` 写交接（体检不通过就拒绝压缩）→ `ho_checkpoint` 登记（`resume=continue|wait`）→ 轮末自动压缩 → 继续时投续跑消息；收尾时不唤醒，等用户派新任务。
-- 第 4 段到线或压缩额度用尽：由在任会话自己换任——写交接 → 请用户在聊天框敲 `/allow-succeed` 授权 → 调 `ho_succeed`（校验交接、分配编号、建立接任会话、登记在任、投递提示词）。全局仍可用 `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`。
@@ -67,8 +63,9 @@
 ## 4. 交接文件的结构要求
 
 - **全局**（`_Control_Center/records/Global_Handover.md`）：必须有 §0 身份与寻址（含 7 个字段）、§1 正在做的事、§2 下一步、§3 待用户决定（早期文档沿用旧标题，亦判通过）、§4 用户要求逐条落位、§5 坑点与禁区、§6 关键路径、§7 会话 id 对照（至少一行带 session id，且不能有「待回填」）；不得残留模板占位符。
-- **项目、杂项**：必须有「正在做的事」（实质内容 ≥30 字）、「下一步待办」（至少一条表格行或列表项）；不得残留占位符。
+- **项目、杂项**：必须有「正在做的事」（空节不算，只判有无实质内容，不设字数下限）、「下一步待办」（至少一条表格行或列表项）；不得残留占位符。
 - 体检命令即工具：`ho_gate`（全部）、`ho_handover` 写后自动体检。
+- **交接类文档不设体积上限**（不规定字节、行数、页数）：体积由结构（只写在途与指针）、书面语与归档整篇重写控制；删减依据是「过期即删」，不是「太长就砍」。
 
 ## 5. 派发与成本纪律（判据来源 Charter §十一）
 
@@ -96,10 +93,10 @@
 
 ## 8. 迁移与恢复
 
-1. `ho_pack({action:"check", items:[...]})` 先过前置闸门（会话静止、交接到位）。
-2. `ho_pack({action:"pack", kind:"project"|"task"|"global", name:"…"})` 出包，含 manifest、CHECKSUMS、MIGRATION.md 与绝对路径体检。
-3. 换机：解压包 → 装插件 → `ho_pack({action:"verify", pack:"<包>"})` 看是否仍是现版。
-4. `ho_pack({action:"restore", pack:"<包>", dry_run:true})` 预演，确认后 `apply=true`。
+1. `ho_backup({action:"check", items:[...]})` 先过前置闸门（会话静止、交接到位）。
+2. `ho_backup({action:"pack", kind:"project"|"task"|"global", name:"…"})` 出包，含 manifest、CHECKSUMS、MIGRATION.md 与绝对路径体检。
+3. 换机：解压包 → 装插件 → `ho_backup({action:"verify", pack:"<包>"})` 看是否仍是现版。
+4. `ho_backup({action:"restore", pack:"<包>", dry_run:true})` 预演，确认后 `apply=true`。
 5. **会话本身不迁移**：跨机连续性只靠交接文档。
 
 ## 9. 设置页与搬迁
@@ -117,9 +114,10 @@
 
 ## 11. 首次安装与工作区
 
-- 两个入口**等价**：设置页「首次安装」（粘贴已存在目录 → 建立全局文件体系 → 注册为工作区）；或在对话里执行 `ho_init(parent=…, register=true)`。
+- 两个入口**等价**：设置页「首次安装」（粘贴已存在目录 → 建立全局文件体系 → 注册为工作区）；或在会话里执行 `ho_workspace(action="init", parent=…, register=true)`。
 - 未接入工作区时，闸门、交接体检、会话水位三项无数据；插件本体仍可用。
 - 注册工作区亦可单独执行 `ho_workspace(action="create", path=…, title=…)`；删除只删注册，目录与日志不动。
+- 已部署的工作区在插件新增目录之后，用 `ho_workspace(action="scaffold")` 一次补齐：只建缺失项，已有文件不覆盖、内容一字不改。
 - 项目与杂项接入后先读自己的库，再写 `project.profile.json`、`task.profile.json` 并 `ho_profile(action=register)` 注册骨架。
 - 会话标题规范（全局、项目、杂项）见工作区 Charter §6.2；新建会话必须当场给标题。
 
@@ -129,7 +127,7 @@
 
 | 层 | 内容 | 何时进入上下文 | 实测参考（加权 token） |
 |---|---|---|---|
-| L0 常驻 | 角色段（全局五节；项目、杂项各节） | **每一轮** | 全局约 385；项目与杂项约 370；长路径与迁移提示档约 435、419（参考值，不设上限） |
+| L0 常驻 | 角色段（全局五节；项目、杂项各节） | **每一轮** | 全局约 526；项目与杂项约 514；长路径与迁移提示档约 576、563（参考值，不设上限） |
 | L0 用户内容 | 全局前置提示词（用户开关，默认关闭） | 开启且非空时每轮 | 由用户自管，不计入本插件预算 |
 | L1 手册 | 本文件 | 按需取回，可**按节**取 | 不设上限（不进每轮） |
 | L2 规则文档 | 工作区 `_Control_Center/rules/` | 按需 | 由工作区自管 |
@@ -141,7 +139,7 @@
 ### 12.2 布局（改动必须落在既有骨架内）
 
 - **全局段**：五节固定——身份、权限、节奏、交接、按需取用。
-- **项目、杂项段**：九行固定——写入范围、库根、骨架、临时与归档、交接、水位与压缩、对外通信、指针；有迁移时另加一行。
+- **项目、杂项段**：十一行固定（含标题行）——写入范围、库根、骨架、临时与归档、交接、水位与压缩、对外通信、流程指针、通用规范指针、通用规范写入范围；有迁移时另加一行。
 - **普通段**：不注册任何提示段。
 - 新增内容先在既有节内找位置；找不到位置，说明该内容属于 L1，而不是新增一节。
 
@@ -156,14 +154,42 @@
 
 - **增**：判定是否每轮需要 → 若否，写进 L1 并在「按需取用」加一行指针 → 若必须进 L0，指明节次 → 跑 `blank-smoke`（体积与结构断言）→ CHANGELOG 记「加了什么、为什么不能是指针、体积变化」。
 - **删**：先查引用（冒烟断言、手册同项、其他角色段）→ 同步删除 L1 与 L0 的重复表述，避免「常驻删了、文档没补」→ 再跑冒烟。
-- **改**：一次改一件事；改完对比体积，超上限即回退，不允许「先合并、下次再压」。
+- **改**：一次改一件事；改完对比体积并记录参考值，不设上限（提示词效果优先）。
 
 ### 12.5 检查清单（每次动提示词后照着过）
 
-1. 体积：全局段 ≤320、项目段 ≤300（含迁移提示与真实长路径时按 360、340 档）。
-2. 结构：全局五节、项目九行各出现一次，顺序不变。
+1. 体积：只记录实测参考值（全局与项目段各约 400 上下），不判上限。
+2. 结构：全局五节、项目十一行各出现一次，顺序不变。
 3. 一处一规则：会话间通信规则、压缩授权、交接线各只出现一次。
-4. 禁止回灌：工作流细节（`ho_pack`、`move-probe`、具体命令步骤）不得出现在 L0。
+4. 禁止回灌：工作流细节（`ho_backup`、`move-probe`、具体命令步骤）不得出现在 L0。
 5. 手册同步：凡 L0 指向的 section 必须在本文中存在且标题可匹配。
 
-> 增长护栏由测试执行，不靠自觉：断言失败即视为缺陷，不允许带病提交。
+> 结构护栏由测试执行（节次齐全、只出现一次），不靠自觉；体积只测量、不判失败。
+
+## 13. 文档定位与授权提示
+
+### 13.1 文档定位（docmap）
+
+- 每个会话（全局、每个项目、每个杂项任务）一份文件：`_Control_Center/records/docmap/global.md`、`project-<项目名>.md`、`misc-<任务名>.md`，随工作区迁移。
+- 三列：路径（工作区相对路径）、一句话介绍、什么时候该读。只指路，读不读由会话自己判断，不要求通读。
+- 写：`ho_docmap(action="write", entries=[…])` 整份替换，逐条校验路径存在，缺项整条拒绝；写入者必须是在任会话（以 `Office.json` 为准），已交出的旧会话只读；全局不代写项目与杂项的 map。
+- 生效：写盘后当场重装该会话提示段，下一轮即注入；空 map 不注入；不设字数上限。
+- 闸门：`ho_gate` 检查所有 map 的路径存在性，失效即报，由对应会话的在任者更新。
+- 外部承接：`_Control_Center/templates/External_Takeover_Prompt.md` 生成提示词时，把本项目 map 的表格原样嵌入「文件地图」之后并保留判定句；没有 map 则省略这一段，不得编造。
+
+### 13.2 授权提示（压缩、换任）
+
+- 授权由用户产生，写入 `~/.dsh/storages/dsh-handover.consent.json`，5 分钟、一次性、按会话。
+- 授权一到，目标会话的提示段立刻多一行：「用户已授权<压缩|换任>，至 <时刻>（一次性，用后失效）」；过期或用掉后消失，不占位。
+- `ho_status(view="phase")` 与 `view="brief"` 的输出里有一行「授权」，写明剩余分钟与到期时刻；向用户索要授权后先查它，再等回话。
+- 两种授权可以并存，各占一行。
+
+## 14. 通用规范库
+
+- 位置 `_Control_Center/standards/`：一条规范一个子目录，目录名即规范名；正文入口为子目录内的 `README.md`；规范自带的脚本与附件放在同一子目录，不混入 `_Control_Center/tools/`。
+- 作用域：任何角色的会话都可读；新增与改写由全局会话执行，项目与杂项只读。
+- 写入范围：用户提到「把某某写成规范」时，未指明范围的写本库（本会话所在的工作区）；说「写入通用规范库」「写成通用规范」「写成共用规范」的才写本目录，项目与杂项不得写本目录、报全局。
+- 引用：用户提到「按某某规范进行」一类要求时，先看本库有无同名规范，再看本目录；两处都有时按本库那份执行，本目录那份作为通用版本。三档角色的常驻段各有一行指针，细节在本节。
+- 与相邻位置的分工：`_Control_Center/rules/` 是工作区自身的运行规则，`_Control_Center/user/` 是用户内容与写作规范，本目录是可复用的做法，按名字被引用。
+- 补齐：插件新增目录后，已部署的工作区执行 `ho_workspace(action="scaffold")`；该动作只建缺失项，已有文件不覆盖。
+- 正文只写做法、判据与验收条件，不记某次作业的进度；进度归交接与台账。

package/src/templates/rules/Handover_Rules.md

@@ -27,7 +27,7 @@
 3. **环境与路径**：工具版本、安装位置、用的源。
 4. **已完成待验收** 与 **要求了没落地** 分开写，不要混。
 5. **坑点与禁区**：踩过的错、不能再动的文件。
-6. **会话 id 对照**：在任会话、已归档的前任。
+6. **会话 id 对照**：在任会话、已归档的旧会话。
 
 ## 4. 硬规矩
 
@@ -36,6 +36,7 @@
 - 不写「大概」「应该」这类没核过的话；没核就写「未核，待确认」。
 - 写交接用 `ho_handover(action="write")`、`action="append"`，不要手改文件（会绕过备份与体检）。
 - 归档命名：`_Archives/<范围>/Handover/<原文件名>_<YYYYMMDD_HHMMSS>.md`（例 `Handover_20261108_144307.md`）；杂项归档自包含在 `_Misc/tasks/<任务>/_archive/`。
+- **篇幅不设上限**：不规定字节、行数、页数。体积由结构控制——只写在途与指针、状态用表格承载；过期即删，过一段时间整篇按归档重写。不得给交接或同类文档设上限。
 
 ## 5. 体检判据（插件自动跑）
 

package/src/templates/rules/Migration_Rules.md

@@ -1,6 +1,6 @@
 # 迁移规范（插件自带默认口径）
 
-> 迁移靠 `ho_pack` 四件套：`check` → `pack` → `verify` → `restore`。
+> 迁移靠 `ho_backup` 四件套：`check` → `pack` → `verify` → `restore`。
 
 ## 1. 前置检查 `action="check"`
 

package/src/templates/standards/README.md

@@ -0,0 +1,25 @@
+# 通用规范
+
+本目录存放跨会话共用的文档规范。任何角色的会话都可读取；新增与改写只由全局会话执行。
+
+## 结构
+
+一条规范一个子目录，目录名即规范名，例如 `发布流程/`、`文档结构/`。
+
+- 正文放在子目录内，入口文件用 `README.md`；篇幅长时拆成多份，并在入口列出清单。
+- 规范自带的脚本与附件放在同一子目录内，不放进 `_Control_Center/tools/`：脚本与正文同生共死，一起搬走才不会失效。
+- 规范只写做法、判据与验收条件，不写某一次作业的进度与结果；进度属于交接与台账。
+
+## 查找
+
+用户提到「按某某规范进行」一类要求时，两处都属查找范围：先看本库有无同名规范，再看本目录。本库指会话自己所在的工作区；两处都有时按本库那份执行，本目录那份作为通用版本。
+
+正文取到后按其中的步骤与判据执行，不自行增删步骤；规范本身需要改动时，先改规范再作业。
+
+## 写入
+
+用户提到「把某某写成规范」时：未指明范围就写本库（该会话所在的工作区）；说「写入通用规范库」「写成通用规范」「写成共用规范」的才写入本目录。
+
+本目录的新增与改写由全局会话执行，项目与杂项会话只读；本库内的文档由本库会话自己写。规范里的路径与工具名要与插件当时的实际口径一致，改名或换入口时同步改本目录。
+
+目录内只有本说明是合法状态：尚无共用规范时，各库按自己的文档执行。

package/src/tools/ho_backup.mjs

@@ -0,0 +1,135 @@
+/**
+ * ho_backup —— 备份与迁移：一个入口，按 action 分流。
+ *   snapshot（默认）：库快照，逐字节复制 + sha256 清单 + PROVENANCE
+ *   check：迁移包前置闸门
+ *   pack：打包
+ *   verify：校包
+ *   restore：恢复（默认仅预演）
+ * 原 ho_snapshot、ho_pack 合并于此。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { textOutput } from '../lib/output.mjs';
+import { nameOf } from '../lib/names.mjs';
+import { NL, isDir } from '../lib/text.mjs';
+import { assertProjectName } from '../lib/role.mjs';
+import { packCheck, packNow, packVerify, packRestore } from '../lib/pack-ops.mjs';
+
+export const ACTIONS = ['snapshot', 'check', 'pack', 'verify', 'restore'];
+
+const SKIP_DIRS = ['__pycache__', '.git', 'node_modules', '.obsidian'];
+const SKIP_FILES = ['.DS_Store', 'Thumbs.db'];
+
+function stamp() {
+  const d = new Date();
+  const p = (n) => (n < 10 ? '0' + n : '' + n);
+  return d.getFullYear() + p(d.getMonth() + 1) + p(d.getDate()) + '-' + p(d.getHours()) + p(d.getMinutes());
+}
+
+function walk(root, rel, rows) {
+  for (const name of fs.readdirSync(path.join(root, rel))) {
+    const full = path.join(root, rel, name);
+    const st = fs.statSync(full);
+    const r = rel ? rel + '/' + name : name;
+    if (st.isDirectory()) {
+      if (SKIP_DIRS.indexOf(name) !== -1) continue;
+      walk(root, r, rows);
+    } else if (st.isFile()) {
+      if (SKIP_FILES.indexOf(name) !== -1) continue;
+      if (name.endsWith('.pyc')) continue;
+      rows.push({ rel: r, size: st.size });
+    }
+  }
+  return rows;
+}
+
+function snapshotText(env, args, exec) {
+  const ws = env.resolveWs(exec);
+  const project = assertProjectName(typeof args.project === 'string' ? args.project.trim() : '');
+  if (!project) throw new Error('action="snapshot" 需要 project（写项目名，如 Demo）');
+  const projDir = path.join(ws, 'Projects', project);
+  if (!isDir(projDir)) throw new Error('找不到项目：' + projDir);
+  let lib = null;
+  for (const name of fs.readdirSync(projDir)) {
+    const p = path.join(projDir, name);
+    if (isDir(p) && fs.existsSync(path.join(p, 'RULES.md'))) { lib = p; break; }
+  }
+  if (!lib) throw new Error('该项目下没有带 RULES.md 的库根：' + projDir);
+  const rows = walk(lib, '', []);
+  const total = rows.reduce((a, b) => a + b.size, 0);
+  const out = [];
+  out.push('源库 ' + lib);
+  out.push('文件 ' + rows.length + ' 个，共 ' + (total / 1048576).toFixed(2) + ' MB');
+  if (args.dry_run) { out.push('dry_run：不落盘。'); return out.join(NL); }
+  const tag = args.tag || '行为检查';
+  const dest = path.join(ws, '_Temp', 'Checks', project + '_' + tag + '_' + stamp());
+  if (fs.existsSync(dest)) throw new Error('目标已存在，不覆盖：' + dest);
+  const libDest = path.join(dest, 'lib');
+  fs.mkdirSync(libDest, { recursive: true });
+  const manifest = ['# 源库: ' + lib, '# 文件: ' + rows.length + '  字节: ' + total];
+  let drift = 0;
+  for (const r of rows) {
+    const src = path.join(lib, r.rel);
+    const dst = path.join(libDest, r.rel);
+    fs.mkdirSync(path.dirname(dst), { recursive: true });
+    fs.copyFileSync(src, dst);
+    const h1 = crypto.createHash('sha256').update(fs.readFileSync(src)).digest('hex');
+    const h2 = crypto.createHash('sha256').update(fs.readFileSync(dst)).digest('hex');
+    if (h1 !== h2) drift++;
+    manifest.push(r.rel + String.fromCharCode(9) + r.size + String.fromCharCode(9) + h1);
+  }
+  fs.writeFileSync(path.join(dest, 'MANIFEST.tsv'), manifest.join(NL), 'utf8');
+  const prov = [
+    '# PROVENANCE',
+    '- 源库: ' + lib,
+    '- 生成时间: ' + new Date().toISOString(),
+    '- 发起会话: ' + (env.selfId(exec) || '?'),
+    '- 文件数/字节: ' + rows.length + ' / ' + total,
+    '- 排除: __pycache__ .git node_modules .obsidian *.pyc .DS_Store Thumbs.db',
+    '- 校验: 逐文件 sha256 比对，drift=' + drift,
+    '- 含个人数据，不得外发、不得进 _Archives',
+  ].join(NL);
+  fs.writeFileSync(path.join(dest, 'PROVENANCE.md'), prov, 'utf8');
+  out.push('已落盘 ' + dest);
+  out.push('校验 drift=' + drift + (drift === 0 ? '（逐文件一致）' : '（**不一致，判失败**）'));
+  return out.join(NL);
+}
+
+export function pmBackupTool(env) {
+  return {
+    name: nameOf('backup'),
+    description:
+      '备份与迁移：action=snapshot 库快照（默认）、check 前置闸门、pack 打包、verify 校包、restore 恢复（默认预演）。',
+    parameters: {
+      type: 'object',
+      additionalProperties: false,
+      properties: {
+        action: { type: 'string', enum: ACTIONS, description: '缺省 snapshot' },
+        project: { type: 'string', description: 'snapshot：项目名（Projects/<项目>/ 下）' },
+        tag: { type: 'string', description: 'snapshot：标签，默认 行为检查' },
+        kind: { type: 'string', enum: ['project', 'task', 'global'], description: 'pack：目标类型' },
+        name: { type: 'string', description: 'pack：项目名或任务名' },
+        out: { type: 'string', description: 'pack：输出目录' },
+        note: { type: 'string', description: 'pack：写进 MIGRATION.md 的说明' },
+        items: { type: 'array', items: { type: 'string' }, description: 'check：检查的项目名（global 表示全局）' },
+        min_age_min: { type: 'number', description: 'check：要求静止分钟（默认 90）' },
+        pack: { type: 'string', description: 'verify、restore：包路径' },
+        target: { type: 'string', description: 'restore：目标根（默认当前）' },
+        apply: { type: 'boolean', description: 'restore：true 才写入' },
+        dry_run: { type: 'boolean', description: 'snapshot：只统计不落盘；pack、restore：只列清单' },
+        format: { type: 'string', enum: ['auto', '7z', 'tar'], description: 'pack：auto＝有 7-Zip 用 7z，否则内置 tar.gz（默认）' },
+      },
+    },
+    output: textOutput(),
+    async execute(args, exec) {
+      const action = typeof args.action === 'string' && args.action ? args.action : 'snapshot';
+      if (ACTIONS.indexOf(action) === -1) throw new Error('action 只能是 ' + ACTIONS.join(' | ') + '（收到 ' + String(action) + '）');
+      if (action === 'snapshot') return { text: snapshotText(env, args, exec) };
+      if (action === 'check') return { text: packCheck(env, args, exec) };
+      if (action === 'verify') return { text: packVerify(env, args, exec) };
+      if (action === 'restore') return { text: packRestore(env, args, exec) };
+      return { text: packNow(env, args, exec) };
+    },
+  };
+}