@mingmaple/dsh-handover 0.9.14 → 0.9.22

package/src/lib/guide.mjs

@@ -1,5 +1,5 @@
 /**
- * 设置页「使用说明」的内容：面向人，不面向模型。
+ * 设置页「使用说明」与「工具明细」的内容：面向人，不面向模型。
  * 数据放宿主侧，客户端只负责渲染——改文案不用动客户端 bundle。
  * 行文用标准书面语：不用口语化的示例句，示例一律写成可以直接提的要求。
  * 水位与工具数由 facts.mjs、names.mjs 推导，不在这里重复写死。
@@ -10,8 +10,8 @@ import { ALL_TOOL_NAMES } from './names.mjs';
 /** 首次安装、尚未接入工作区时的下一步（设置页与工具输出共用同一份）。 */
 export const SETUP_STEPS = [
   '准备一个长期存在的目录作为全局根的上级目录，不要选临时目录或下载目录。',
-  '在本页下方的输入框中粘贴该目录的绝对路径，点「一键部署」：插件会在其中建立 _Workspace 与整套结构，注册为「全局」工作区，并新建一个「全局」会话。',
-  '在左侧「全局」工作区中打开新会话即可开始。若只想先铺文件，可点「仅建立文件体系」，之后再注册工作区。',
+  '在本页下方的输入框中填写该目录的绝对路径，点击「一键部署」：插件会在其中建立 _Workspace 与整套结构，注册为「全局」工作区，并新建一个「全局」会话。',
+  '在左侧「全局」工作区中打开新会话即可开始。若只想先铺文件，可点击「仅建立文件体系」，之后再注册工作区。',
   '工作区已接入但还没有全局会话时，本页会单独出现「全局会话」卡片，可随时补建。',
   '新建项目或杂项会话时，应当指明目标工作区；找不到工作区时，插件会把已注册的工作区列出来，不会静默落到别处。',
 ];
@@ -22,76 +22,67 @@ export function buildGuide(cfg) {
   const toolCount = ALL_TOOL_NAMES.length;
   return {
   intro: [
-    '本插件的全部功能都在对话中调用：不必记命令，也不必操作菜单，用中文说明要做的事，全局会话会选择相应的工具执行。',
-    '工具与提示按会话角色载入：全局会话可见全部 ' + toolCount + ' 个工具，项目与杂项会话只载入自己需要的几个，普通会话不载入插件工具，也不注入提示段。角色在下方「会话角色」中指定。',
+    '插件功能主要在会话中调用：用中文说明要做的事，全局会话会选择相应工具执行，不必记命令；设置页另提供授权、迁移与会话角色等操作入口。',
+    '工具与提示按会话角色载入：全局会话可见全部 ' + toolCount + ' 个工具，项目与杂项会话只载入所需的几个，普通会话不载入插件工具，也不注入提示段。角色在下方「会话角色」中指定。',
     '本页除首次安装、全局前置提示词与会话角色外均为只读；需要最新读数时，点击右上角的「刷新」。',
   ],
   situations: [
-    { when: '首次安装', say: '部署全局文件体系', what: '本页「一键部署」可一次完成三件事：建文件体系、注册「全局」工作区、建「全局」会话' },
-    { when: '作业开始与结束', say: '先出一份起始简报', what: '汇总上下文水位、通用约束条闸门、会话清点与阶段建议（ho_brief）' },
-    { 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: '用户先发送 /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: '保存到本机；仅在你开启且内容非空时注入全部会话，关闭或留空时不注册提示段' },
-    { when: '项目骨架', say: '注册 Demo 的骨架', what: '读取、注册、校验项目或杂项的骨架档案；由该项目会话自己写文件并注册（ho_profile）' },
-    { when: '查看会话', say: '列出当前活跃的会话', what: '水位、运行状态、活跃或沉默、在任或前任（ho_sessions）' },
-    { when: '打包迁移', say: '把 Demo 打包成迁移包', what: '收集文件、逐文件 sha256、7z、自检、绝对路径体检（ho_pack action=pack）' },
-    { when: '在新机器恢复', say: '预演这次恢复', what: '校验、列出覆盖清单、备份、写入；默认仅预演（ho_pack action=restore）' },
-    { when: '删除会话', say: '把这个会话归档', what: '官方仅提供归档；需要再次唤醒时须先解归档（ho_sessions action=archive、unarchive）' },
-    { 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 同名查询' },
+    { when: '首次安装', say: '部署全局文件体系', what: '本页「一键部署」一次完成三步：建立文件体系、注册「全局」工作区、建立「全局」会话' },
+    { when: '作业开始与结束', say: '先出一份起始简报', what: '汇总上下文水位、通用约束条闸门、会话清点、交接漂移与阶段建议（ho_status view=brief）' },
+    { when: '查阅规则', say: '取出 Charter 第 7.2.3 节', what: '按节返回规则正文，避免整篇读取；完整流程用 doc="runtime"（ho_charter）' },
+    { when: '交接与压缩续跑', say: '写好交接文档后压缩并继续', what: '写本角色的交接、体检并登记压缩；压缩后的去向在登记时选定：未完成用 resume=continue 续跑，已收尾用 resume=wait（压缩后不唤醒）（ho_handover、ho_checkpoint）' },
+    { when: '接近上下文上限', say: '查询本会话的上下文水位', what: compact + '（ho_status view=phase；同一行还会列出当前授权及其剩余分钟）' },
+    { when: '换任', say: '让在任会话自己完成换任', what: '先由当前用户授权：聊天框发送 /allow-succeed，或在设置页「授权」卡点击「授权换任」；在任会话随后校验交接、建立接任会话并登记在任（ho_succeed）' },
+    { when: '会话角色', say: '把 Demo1 设为项目角色', what: '写角色表、当场收窄该会话的工具与提示；需要时再投递一次性整理指令（ho_sessions action=role，或本页「会话角色」）' },
+    { when: '通知会话', say: '通知 Demo 更新交接文档', what: '投递一条消息；会话之间可直接通信，不必经全局转述；会消耗目标会话一整轮 token，应尽量少用（peer action=send）' },
+    { when: '全局前置提示词', say: '将这段设为全局前置提示词', what: '在本页保存到本机；仅在开启且内容非空时注入全部会话，关闭或留空时不注册提示段' },
+    { when: '项目骨架', say: '注册 Demo 的骨架', what: '读取、注册、校验项目或杂项的骨架档案；档案文件由该项目会话自己写（ho_profile）' },
+    { when: '文档定位', say: '把本项目的文档定位写进提示段', what: '每个会话一份 map，列为路径、一句话介绍、什么时候该读；只指路，是否读正文由会话判断；空 map 不注入，只有该会话的在任者可写（ho_docmap）' },
+    { when: '查看会话', say: '列出当前会话', what: '水位、运行状态、活跃或沉默、角色与最后活动，并给出本轮通知名单（ho_sessions）' },
+    { when: '打包迁移', say: '把 Demo 打包成迁移包', what: '收集文件、逐文件 sha256、7z（无 7-Zip 时用内置 tar.gz）、自检与绝对路径体检（ho_backup action=pack）' },
+    { when: '在新机器恢复', say: '预演这次恢复', what: '校验、列出覆盖清单、备份后写入；默认仅预演（ho_backup action=restore）' },
+    { when: '归档会话', say: '把这个会话归档', what: 'DSH 只提供归档；再次唤醒须先解归档（ho_sessions action=archive、unarchive）' },
+    { when: '建立工作区', say: '把这个目录注册为工作区', what: 'init 在指定目录下建立整套全局文件体系；list、create、delete 管理注册，删除只删注册（ho_workspace）' },
+    { when: '自检', say: '检查插件当前状态', what: '服务可用性、压缩调度器与压缩计数、本会话角色与工具集、水位与迁移状态（ho_status view=diag）' },
+    { when: '查在任', say: '现在 Demo1 由谁在任', what: '按全局、项目、杂项查询现任会话的名字与会话 id（ho_office）；也可用命令行 node scripts/office.mjs 查询' },
   ],
   groups: [
     {
       title: '只读工具（不消耗任何会话的 token）',
       tools: [
-        ['ho_brief', '起始与收束的单条命令：水位、闸门、会话清点与阶段建议'],
-        ['ho_gate', '通用约束条闸门（按库型判定）与交接文档体检'],
-        ['ho_sessions', '会话清点；也用于设定角色、建会话、出提示词、归档'],
-        ['ho_phase', '本会话阶段：水位、已压缩次数、锁状态、建议动作'],
+        ['ho_status', '会话状态：view=phase 水位与建议（默认）、brief 起始简报、diag 插件自检、drift 交接漂移、tokens token 体检'],
+        ['ho_gate', '通用约束条闸门（按库型判定）＋交接文档体检＋文档定位 map 的路径检查'],
+        ['ho_sessions', '会话清点与通知名单；也用于设定角色、建会话、出提示词、归档'],
         ['ho_charter', '按节返回规则正文；doc="runtime" 取完整流程手册'],
-        ['ho_drift', '交接漂移体检：Δ 为当前轮与交接轮之差，大于 3 需刷新'],
-        ['ho_diag', '插件自检：服务、调度器、压缩计数、角色判定与工具集'],
-        ['ho_tokens', '会话 token 体检：轮数、步数、每步 token、最贵的单条返回'],
         ['ho_office', '在任登记表：查全局、项目、杂项现在由哪个会话在任（名字与会话 id）'],
+        ['ho_docmap', '本会话的文档定位：读、写、查；只指路，不规定读多少'],
       ],
     },
     {
       title: '写工具（会改动文件；均带备份或预演）',
       tools: [
         ['ho_handover', '读写、追加、归档本会话自己的交接（写前备份、写后按角色体检）'],
-        ['ho_checkpoint', '写交接、登记压缩，回合结束后自动压缩并自动续跑'],
-        ['ho_snapshot', '库快照：逐字节复制、sha256 清单、来源说明'],
+        ['ho_checkpoint', '写交接、登记压缩；回合结束后压缩，并按 resume 决定是否续跑'],
         ['ho_changelog', '按固定表格追加一行台账'],
-        ['ho_pack', 'action：check 前置闸门、pack 打包、verify 校验、restore 恢复（默认预演）'],
-        ['ho_workspace', '工作区列表、创建、删除；删除只删注册'],
-        ['ho_init', '首次安装：在指定目录下建立整套全局文件体系，可顺带注册工作区'],
+        ['ho_backup', 'action：snapshot 库快照、check 前置闸门、pack 打包、verify 校验、restore 恢复（默认预演）'],
+        ['ho_workspace', 'init 首次建体系；list、create、delete 工作区；move-* 迁移全局根目录'],
         ['ho_profile', '项目或杂项骨架：读取、注册、校验、取预设'],
-        ['ho_succeed', '换任自服务：在任会话经用户授权后自行校验交接、建接任会话并登记在任'],
+        ['ho_succeed', '换任自服务：在任会话经当前用户授权后自行校验交接、建接任会话并登记在任'],
       ],
     },
     {
       title: '平级会话工具',
       tools: [
-        ['peer_list', '会话清点，只读投影缓存，不激活任何会话'],
-        ['peer_status', '单会话详情：水位、运行状态、轮数、步数、工作目录'],
-        ['peer_send', '向指定会话投递一条消息，是唯一会消耗对方 token 的动作'],
-        ['peer_new', '新建平级会话，可指定工作区与标题'],
-        ['peer_rename', '只改显示标题，不唤醒目标会话'],
-        ['peer_peek', '查看指定会话近期的对话，会消耗本会话 token'],
+        ['peer', 'action：list 会话一览、status 单会话详情、send 投消息（耗对方 token）、peek 读近期会话历史、rename 改标题、new 新建'],
       ],
     },
   ],
   rules: [
     '交接线：上下文水位达到 ' + w.warn + ' 时提醒，达到 ' + w.handover + ' 时写交接并压缩，' + w.hard + ' 为硬上限；同一会话最多压缩 ' + w.max + ' 次，第四段改用新建会话。',
     '压缩不可逆：历史会被摘要替换，因此必须先写出合格的交接文档；体检未通过时，插件拒绝安排压缩。',
-    '会话之间可直接 peer_send 对话，不必经全局转述；默认沉默仍适用：只在到交接线且已写交接、需用户决定、发现全局口径有误时发一条，任务完成不向全局报告。',
-    '压缩后的去向由助手在登记时选择：任务未完成用 continue 续跑，任务已收尾用 wait 静默收尾，等用户派新任务。',
+    '会话之间可直接用 peer（action=send）通信，不必经全局转述；默认沉默仍适用：仅在到交接线且已写交接、需当前用户决定、发现全局口径有误时发送一条；任务完成不向全局报告。',
+    '当前用户授权（压缩或换任）写入后，目标会话的提示段会立刻多一行提示与到期时刻；授权过期或用掉后自动消失，不留占位。',
+    '压缩后的去向由助手在登记时选择：任务未完成用 continue 续跑，任务已收尾用 wait 静默收尾，等当前用户派新任务。',
     '交接文件按角色分离：全局写 _Control_Center/records/Global_Handover.md，项目写 _Project_Meta/<项目>/Handover.md，杂项写 _Misc/tasks/<任务>/Handover.md，互不串用。',
     '会话本身不迁移：跨机器、跨平台的连续性依托交接文档。',
     '全局前置提示词属于用户内容，不是插件约束；关闭或留空时不占用注入点位，可与其它提示词插件并存。',

package/src/lib/lint.mjs

@@ -57,8 +57,9 @@ function tableRows(lines) {
   return lines.filter((l) => l.trim().startsWith('|') && l.indexOf('---') === -1);
 }
 
+/** 列出条目：无序列表（`-`、`*`、`+`）与有序列表（`1.`、`1)`、`1、`）都算。 */
 function bulletRows(lines) {
-  return lines.filter((l) => l.trim().startsWith('-') || l.trim().startsWith('*'));
+  return lines.filter((l) => /^\s*(?:[-*+]|\d+[.)、])\s+/.test(l));
 }
 
 /** 全局交接体检：{ verdict, reasons }。 */
@@ -111,8 +112,8 @@ export function lintProject(file) {
   if (!body) gap.push("缺 ## 1. 正在做的事 一节（2026-10-12 起的强制项，本项目还没补）");
   else {
     const core = body.filter((l) => l.trim() !== '' && !l.trim().startsWith('>'));
+    // 只判「有没有实质内容」；不设字数下限（2026-11-11 口径：交接类文档不设体积上限）。
     if (core.length === 0) bad.push("正在做的事 是空节（或只有引用块说明），没写实质内容");
-    else if (core.join('').trim().length < 30) bad.push('正在做的事 内容过短，像是应付');
   }
   const nxt = sectionLines(text, '下一步') || sectionLines(text, '待办');
   if (!nxt) bad.push("缺「下一步待办」一节");

package/src/lib/manual.mjs

@@ -6,19 +6,35 @@
  */
 import { handoverPathFor, scopeLabel } from './role.mjs';
 import { handoverRuleText, watermark } from './facts.mjs';
+import { consentPromptLines } from './consent.mjs';
 
 const NL = String.fromCharCode(10);
 
 /** 完整流程的指针句（三档角色共用）。 */
 const RUNTIME_POINTER = '细节按节取：ho_charter(doc="runtime", section=…)。';
 
+/**
+ * 通用规范的位置与查找范围（三档角色共用，必须同一句）。
+ * 规范按名字被引用，本库（会话所在的工作区）与全局规范库都在范围内；细节写在规范库的 README 里。
+ */
+const STANDARDS_POINTER = '通用规范在 _Control_Center/standards/（每条一个子目录）；当前用户提到「按某某规范进行」时，本库（本会话所在的工作区）与该目录都算查找范围。';
+
+/**
+ * 写入范围（三档角色共用前一句）：未指明写本库；明确「写入通用规范库」一类要求才写规范库。
+ * 后一句按角色分叉：全局直接写，项目与杂项报全局。
+ */
+const STANDARDS_WRITE_PREFIX = '当前用户提到「把某某写成规范」时：未指明范围就写本库；';
+const STANDARDS_WRITE_TARGET = '说「写入通用规范库」「写成通用规范」「写成共用规范」的';
+const STANDARDS_WRITE_GLOBAL = STANDARDS_WRITE_PREFIX + STANDARDS_WRITE_TARGET + '，写 _Control_Center/standards/。';
+const STANDARDS_WRITE_SCOPED = STANDARDS_WRITE_PREFIX + STANDARDS_WRITE_TARGET + '，不得写 _Control_Center，报全局。';
+
 /**
  * 复用准则：全局、项目、杂项三处必须同一句。
  * 派活与新建会话前先查在任，低水位在任直接复用；确需另建才新建。
  */
 function reuseRule(cfg) {
   return '指派任务或新建会话前，先用 ho_office（空参数）查一次在任；同一类别已有在任且其水位低于 '
-    + watermark(cfg).warn + ' 时，直接用 peer_send 复用，不新建；确需另建（原会话不可用、需并行、用户明确要求）时才新建。';
+    + watermark(cfg).warn + ' 时，直接用 peer（action="send"）复用，不新建；确需另建（原会话不可用、需并行、当前用户明确要求）时才新建。';
 }
 
 /** 全局会话的常驻段：五节骨架（身份、权限、节奏、交接、按需取用）。 */
@@ -32,19 +48,25 @@ export function globalManual(opts) {
     '',
     '二、权限',
     '可写 _Control_Center、_Project_Meta 与项目结构；Projects 及各项目库内文件只读，不得代写；项目内作业不代办。',
-    '新建会话与设定角色仅属全局；会话间可直接 peer_send；换任须用户授权（/allow-succeed 或设置页）后由在任会话调用 ho_succeed，不再请求全局。',
+    '新建会话与设定角色仅属全局；会话间可直接 peer（action="send"）；换任须当前用户授权（/allow-succeed 或设置页）后由在任会话调用 ho_succeed，不再请求全局。',
     reuseRule(o.cfg),
     '',
     '三、节奏',
     handoverRuleText(o.cfg),
-    '压缩须用户点「压缩授权」，再写交接并 ho_checkpoint(confirm=true)；任务未完成传 resume=continue，已收尾传 resume=wait，不再唤醒。confirm 仅表意图，授权以点击为准。关键步骤传 at_risk=true 暂缓。',
+    '压缩须当前用户点击「授权压缩」，再写交接并 ho_checkpoint(confirm=true)；任务未完成传 resume=continue，已收尾传 resume=wait，不再唤醒。confirm 仅表意图，授权以点击为准。关键步骤传 at_risk=true 暂缓。',
     '',
     '四、交接',
     '交接：_Control_Center/records/Global_Handover.md。',
     '',
     '五、按需取用',
     RUNTIME_POINTER,
+    STANDARDS_POINTER,
+    STANDARDS_WRITE_GLOBAL,
   ];
+  const dm = docmapBlock(o);
+  if (dm.length) lines.push('', ...dm);
+  const cs = consentBlock(o);
+  if (cs.length) lines.push('', ...cs);
   const mv = moveLine(o);
   if (mv) lines.push(mv);
   return lines.join(NL);
@@ -72,11 +94,17 @@ 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（action="send"）；默认沉默：仅在水位 ' + watermark(o.cfg).warn + ' 且已写交接、需当前用户决定、全局口径有误时向全局报告；任务完成不报全局。',
     reuseRule(o.cfg),
     RUNTIME_POINTER,
+    STANDARDS_POINTER,
+    STANDARDS_WRITE_SCOPED,
   ];
+  const dm = docmapBlock(o);
+  if (dm.length) lines.push('', ...dm);
+  const cs = consentBlock(o);
+  if (cs.length) lines.push('', ...cs);
   const mv = moveLine(o);
   if (mv) lines.push(mv);
   return lines.join(NL);
@@ -89,6 +117,17 @@ function moveLine(opts) {
   return '已迁移至 ' + (mv.dst || '?') + '；' + (mv.src || '?') + ' 现为链接，勿再手工迁移。';
 }
 
+/** 文档定位（docmap）注入：空 map 不占位。 */
+function docmapBlock(opts) {
+  const m = opts && opts.docmap;
+  return m ? [m] : [];
+}
+
+/** 用户已授权的提示行：每种有效授权一行，无授权不占位。 */
+function consentBlock(opts) {
+  try { return consentPromptLines(opts && opts.consents); } catch { return []; }
+}
+
 export function manualFor(info, opts) {
   const role = info && info.role ? info.role : 'plain';
   if (role === 'global') return globalManual(opts);
@@ -109,8 +148,8 @@ export function organizeMessageFor(info, opts) {
       '先通读本库，确定本项目的骨架：代码与文档主体、必需文件、临时与归档位置。构建型、动画型等项目不必套用插件类项目的文档集。',
       '把结论写入 _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。',
-      '完成后以一句话向用户说明「注册了哪些骨架项、仍缺哪些」，无需每轮回执。',
+      '约束：仅可改动本库与 _Project_Meta/' + p + '/；不得改动 _Control_Center 及其他项目；移动较大文件前先执行 ho_backup(action="snapshot")。可用工具：ho_backup、ho_handover、ho_status、ho_checkpoint、ho_profile、peer（action="send"）。',
+      '完成后以一句话向当前用户说明「注册了哪些骨架项、仍缺哪些」，无需每轮回执。',
     ].join(NL);
   }
   if (role === 'misc') {
@@ -120,13 +159,13 @@ export function organizeMessageFor(info, opts) {
       '先通读本任务目录，确定本任务的骨架：工作文件、规则文件、交接、快照与归档位置。',
       '把结论写入 _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_backup、ho_handover、ho_status、ho_checkpoint、ho_profile、peer（action="send"）。',
       '完成后以一句话说明改动即可。',
     ].join(NL);
   }
   return [
     head,
-    '- _Control_Center/{records,rules,user,templates,tools} — 交接、规则、写作规范、模板、脚本。',
+    '- _Control_Center/{records,rules,standards,user,templates,tools} — 交接、规则、通用规范、写作规范、模板、脚本。',
     '- _Project_Meta/Registry.md 与各项目元数据目录。',
     '- Projects/、_Misc/tasks/、_Archives/、_Temp/ — 只维护结构，不代写项目库内文件。',
     '约束：项目库内文件由该项目会话自行整理；骨架由项目自己注册，缺则派发，不代写。',

package/src/lib/mover.mjs

@@ -1,5 +1,5 @@
 /**
- * 全局根目录搬迁（跨平台）：探针 → 复制 → 全量校验 → 派后台助手在 DSH 退出后切换 → 状态 → 清旧副本。
+ * 全局根目录迁移（跨平台）：探针 → 复制 → 全量校验 → 派后台助手在 DSH 退出后切换 → 状态 → 清旧备份。
  *
  * 平台无关的做法（Windows / Linux / macOS / 安卓 PRoot Ubuntu 同一套）：
  * - **链接**：Windows 用 junction，POSIX 用目录 symlink；都用 node:fs.symlinkSync，不需要管理员。
@@ -313,7 +313,7 @@ function stop(m) { log('[中止] ' + m); process.exit(1); }
   let target = '';
   try { target = fs.readlinkSync(src); } catch { target = ''; }
   if (!target || stamp(target) !== stamp(dst)) {
-    log('链接指向不对：' + target + '（旧副本在 ' + old + '）');
+    log('链接指向不对：' + target + '（旧备份在 ' + old + '）');
     stop('切换校验失败');
   }
   m.phase = 'switched';
@@ -327,10 +327,10 @@ function stop(m) { log('[中止] ' + m); process.exit(1); }
       spawn(process.execPath, [RETARGET_HELPER, '0'], { detached: true, stdio: 'ignore', windowsHide: true, env: Object.assign({}, process.env, { ELECTRON_RUN_AS_NODE: '1' }) }).unref();
       log('③ 已派登记修改登记助手（把 DSH 的登记改到新位置）');
     } catch (e) {
-      log('修改登记助手未派成功：' + e.message + '（可在设置页点「把登记迁到新位置」）');
+      log('修改登记助手未派成功：' + e.message + '（可在设置页点击「把登记迁到新位置」）');
     }
   }
-  log('切换完成。旧副本：' + old);
+  log('切换完成。旧备份：' + old);
   if (RELAUNCH && EXE) {
     try {
       spawn(EXE, [], { detached: true, stdio: 'ignore', env: Object.assign({}, process.env, { ELECTRON_RUN_AS_NODE: undefined }) }).unref();
@@ -352,7 +352,7 @@ function stop(m) { log('[中止] ' + m); process.exit(1); }
 /** 派后台助手：等本进程（DSH）退出后自动切换。 */
 export function stageSwitch({ relaunch, waitPid } = {}) {
   const m = readMarker();
-  if (!m || !m.src || !m.dst) throw new Error('没有可用搬迁标记，先跑一次 move');
+  if (!m || !m.src || !m.dst) throw new Error('没有可用迁移标记，先跑一次 move');
   const st = moveStatus({ src: m.src });
   if (st.phase === 'switched' || st.phase === 'switched+cleaned') return { ok: true, already: true, phase: st.phase, log: switchLogPath() };
   if (st.phase !== 'verified') throw new Error('当前不是「已复制并校验通过」（phase=' + st.phase + '），不能切换');
@@ -394,7 +394,7 @@ export function stageSwitch({ relaunch, waitPid } = {}) {
  */
 export function repairLink() {
   const m = readMarker();
-  if (!m || !m.src || !m.dst) throw new Error('没有搬迁记录，无法重建链接');
+  if (!m || !m.src || !m.dst) throw new Error('没有迁移记录，无法重建链接');
   if (!fs.existsSync(m.dst)) throw new Error('目标不存在（' + m.dst + '），先确认数据在哪里，本工具不动文件');
   const kind = linkKind();
   let st = null;
@@ -638,8 +638,8 @@ export async function rmTree(dir) {
 export async function cleanupOld({ src, confirm } = {}) {
   const st = moveStatus({ src });
   if (st.phase !== 'switched') throw new Error('当前不是已切换状态（phase=' + st.phase + '），拒绝删除任何目录');
-  if (confirm !== true) throw new Error('删除旧副本需要明确确认（confirm=true）');
-  if (!st.olds.length) return { ok: true, removed: [], bytes: 0, note: '没有找到旧副本目录' };
+  if (confirm !== true) throw new Error('删除旧备份需要明确确认（confirm=true）');
+  if (!st.olds.length) return { ok: true, removed: [], bytes: 0, note: '没有找到旧备份目录' };
   const removed = []; const failed = []; let bytes = 0;
   const base = path.basename(st.src) + '.old-';
   for (const o of st.olds) {
@@ -657,7 +657,7 @@ export async function cleanupOld({ src, confirm } = {}) {
   return {
     ok: failed.length === 0,
     removed, failed, bytes,
-    note: failed.length ? ('有 ' + failed.length + ' 个旧副本没删干净，可重试')
-      : (removed.length ? '已删除旧副本' : '没有可删的旧副本'),
+    note: failed.length ? ('有 ' + failed.length + ' 个旧备份未删净，可重试')
+      : (removed.length ? '已删除旧备份' : '没有可删的旧备份'),
   };
 }

package/src/lib/names.mjs

@@ -1,33 +1,28 @@
 /**
- * 工具名集中管理：ho_* 由 PREFIX 与 KEYS 生成，peer_* 由 PEER_KEYS 生成。
- * 工具文件一律用 nameOf、peerNameOf 取名，index.mjs 启动时校验位置表，改名只需改这里。
+ * 工具名集中管理：ho_* 由 PREFIX 与 KEYS 生成，平级会话工具固定为 peer。
+ * 工具文件一律用 nameOf、PEER_NAME 取名，index.mjs 启动时校验位置表，改名只需改这里。
+ *
+ * 0.9.15 起按「会话一次要做的一件事」合并（见 docs/releases/0.9.15.md）：
+ *   ho_status  —— 阶段、起始简报、自检、交接漂移、token 体检（原 ho_phase、ho_brief、ho_diag、ho_drift、ho_tokens）
+ *   ho_backup  —— 快照与迁移包（原 ho_snapshot、ho_pack）
+ *   ho_workspace —— 工作区动作，含首次建立的 init（原 ho_init）
+ *   peer       —— 平级会话的六个动作（原 peer_list、peer_status、peer_send、peer_new、peer_rename、peer_peek）
  */
 const PREFIX = 'ho';
 
 export const nameOf = (key) => PREFIX + '_' + key;
 
-/**
- * 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  —— 骨架读取 / 注册 / 校验 / 预设
- */
 const KEYS = [
-  'brief', 'gate', 'sessions', 'phase', 'charter',
-  'handover', 'checkpoint', 'snapshot', 'diag',
-  'drift', 'changelog', 'tokens',
-  'pack', 'workspace', 'init', 'profile', 'office', 'succeed',
+  'status', 'gate', 'sessions', 'charter',
+  'handover', 'checkpoint', 'changelog',
+  'backup', 'workspace', 'profile', 'office', 'succeed', 'docmap',
 ];
 
 export const NAMES = KEYS.reduce((acc, k) => { acc[k] = nameOf(k); return acc; }, {});
 
 export const TOOL_NAMES = KEYS.map((k) => NAMES[k]);
 
-/** 平级会话工具：名字固定为 peer_*，不走 PREFIX。 */
-export const peerNameOf = (key) => 'peer_' + key;
-
-const PEER_KEYS = ['list', 'status', 'send', 'new', 'rename', 'peek'];
-
-export const PEER_NAMES = PEER_KEYS.map((k) => peerNameOf(k));
+/** 平级会话工具：一个入口，动作用 action 分流。 */
+export const PEER_NAME = 'peer';
 
-export const ALL_TOOL_NAMES = TOOL_NAMES.concat(PEER_NAMES);
+export const ALL_TOOL_NAMES = TOOL_NAMES.concat([PEER_NAME]);

package/src/lib/office.mjs

@@ -85,7 +85,7 @@ export function nextName(store, key) {
 }
 
 /**
- * 名字 → 类别。用户给的多半是不确定的名字（全局3、全局、Mingent、赢了两次的旧叫法），
+ * 名字 → 类别。用户给的多半是不确定的名字（全局3、全局、Demo1、换了说法的旧叫法），
  * 按「类别名精确 → 去尾部编号 → 现任名 → 唯一子串」四步收敛；收敛不了就报候选，不瞎猜。
  */
 export function resolveOffice(store, query) {
@@ -185,20 +185,28 @@ export function registerHolder(ws, opts) {
   return { key, previous, current: lin.current, registry };
 }
 
-/** 类别当前空缺（会话退役、项目暂停）。 */
-export function retireHolder(ws, key, note) {
-  const store = loadOffice(ws);
-  const lin = store.lineages[String(key || '')];
-  if (!lin) throw new Error('没有这条类别：' + key);
-  const previous = lin.current && lin.current.name ? { ...lin.current } : null;
-  if (previous) {
-    lin.history.push({ name: previous.name, sessionId: previous.sessionId, from: previous.since || '', to: stampNow(), note: note || previous.note || '' });
+/**
+ * 读 Registry.md「项目清单」里的项目名（按表内顺序）。
+ * 只认那一张表：表头、分隔行与空行一律跳过；读不到文件时返回空数组。
+ * 设置页的交接体检以它为准，避免把未登记的旧目录当成项目。
+ */
+export function readRegistryProjects(ws) {
+  const file = path.join(String(ws || ''), '_Project_Meta', 'Registry.md');
+  let text = '';
+  try { text = readUtf8(file); } catch { return []; }
+  text = String(text).replace(/^\uFEFF/, '');
+  const names = [];
+  let inTable = false;
+  for (const line of text.split(NL)) {
+    if (line.startsWith('## ')) { inTable = line.indexOf('项目清单') !== -1; continue; }
+    if (!inTable || !line.startsWith('|')) continue;
+    const cells = splitCells(line);
+    if (cells.length < 4) continue;
+    const name = String(cells[1] || '').trim();
+    if (!name || name === '项目名' || /^[-:\s]+$/.test(name)) continue;
+    names.push(name);
   }
-  lin.current = null;
-  saveOffice(ws, store);
-  let registry = { changed: [], error: '' };
-  try { registry = syncRegistry(ws, store); } catch (e) { registry = { changed: [], error: String(e && e.message ? e.message : e) }; }
-  return { key, previous, registry };
+  return names;
 }
 
 // ---------------------------------------------------------------- Registry.md 定点同步

package/src/lib/pack-ops.mjs

@@ -1,6 +1,6 @@
 /**
  * 打包、校验、预演、恢复的实现（原 ho_pack / ho_pack_verify / ho_pack_restore / ho_pack_precheck 的代码搬到这里）。
- * 对外只经 ho_pack(action=…) 暴露，少 3 份 schema 的固定开销。
+ * 对外只经 ho_backup(action=…) 暴露：四份旧入口合为一份 schema，省下三份的固定开销。
  * 共同口径：只报告绝对路径、不改写文件内容；恢复默认预演、覆盖前备份、从不删除目标文件。
  */
 import fs from 'node:fs';
@@ -205,7 +205,7 @@ export function packNow(env, args, exec) {
   fs.writeFileSync(path.join(stagingRoot, 'manifest.json'), JSON.stringify(manifest, null, 2), 'utf8');
   fs.writeFileSync(path.join(stagingRoot, 'CHECKSUMS.sha256'), files.map((f) => f.sha256 + '  ' + f.path).join(NL) + NL, 'utf8');
   const absLines = renderAbsoluteRefs(abs, { title: '绝对路径体检（包内）', max: 200 });
-  const md = ['# 迁移包（最简版）', '', '- 目标: ' + kind + (name ? ':' + name : ''), '- 生成: ' + manifest.createdAt, '- 文件: ' + files.length + ' 个 / ' + total + ' B', '- 说明: ' + (args.note || '（无）'), '', ...absLines, '', '## 跨平台注意', '', '- **库内引用一律相对路径**：本包里有 ' + abs.totalHits + ' 处写死的绝对路径，插件**只报告、不改写**文件内容——迁移后需由人或项目会话自己改。', '- 源平台 ' + manifest.sourcePlatform + '；换行 CRLF ' + abs.crlf + ' 个 / LF ' + abs.lf + ' 个' + (abs.nonUtf8.length ? '；非 UTF-8 ' + abs.nonUtf8.length + ' 个' : '') + '。', '- 目标机若是别的系统（Windows ↔ macOS/Linux）：盘符、路径分隔符、大小写敏感性、换行、编码都要项目会话自己核一遍。', '', '## 目标环境前置（先做这两件，再做恢复）', '', '1. 安装 dsh-handover 插件（否则本工具不存在）；', '2. 打开本包随附的交接文件（_Project_Meta/<项目名>/Handover.md 或全局 _Control_Center/records/Global_Handover.md），按它恢复状态。', '', '## 恢复', '', 'ho_pack(action="restore", pack="<本包绝对路径>", dry_run=true)   # 先预演，再加 apply=true', '', '> 会话本身**不迁移**：连续性只靠交接文档。'].join(NL);
+  const md = ['# 迁移包（最简版）', '', '- 目标: ' + kind + (name ? ':' + name : ''), '- 生成: ' + manifest.createdAt, '- 文件: ' + files.length + ' 个 / ' + total + ' B', '- 说明: ' + (args.note || '（无）'), '', ...absLines, '', '## 跨平台注意', '', '- **库内引用一律相对路径**：本包里有 ' + abs.totalHits + ' 处写死的绝对路径，插件**只报告、不改写**文件内容——迁移后需由人或项目会话自己改。', '- 源平台 ' + manifest.sourcePlatform + '；换行 CRLF ' + abs.crlf + ' 个 / LF ' + abs.lf + ' 个' + (abs.nonUtf8.length ? '；非 UTF-8 ' + abs.nonUtf8.length + ' 个' : '') + '。', '- 目标机若是别的系统（Windows ↔ macOS/Linux）：盘符、路径分隔符、大小写敏感性、换行、编码都要项目会话自己核一遍。', '', '## 目标环境前置（先做这两件，再做恢复）', '', '1. 安装 dsh-handover 插件（否则本工具不存在）；', '2. 打开本包随附的交接文件（_Project_Meta/<项目名>/Handover.md 或全局 _Control_Center/records/Global_Handover.md），按它恢复状态。', '', '## 恢复', '', 'ho_backup(action="restore", pack="<本包绝对路径>", dry_run=true)   # 先预演，再加 apply=true', '', '> 会话本身**不迁移**：连续性只靠交接文档。'].join(NL);
   fs.writeFileSync(path.join(stagingRoot, 'MIGRATION.md'), md, 'utf8');
   const outDir = args.out || path.join(ws, '_Archives', '_Global', 'Backups');
   fs.mkdirSync(outDir, { recursive: true });

package/src/lib/peer.mjs

@@ -3,7 +3,7 @@
  * 数据源与 peer-link 完全一致，不引入任何第三方依赖：
  *   ~/.dsh/storages/session_projcache/sessions/<session id>.json   水位 / 运行状态 / 项目名
  *   ~/.dsh/storages/workspace.json                                  工作区 id / 标题 / 路径
- *   ~/.dsh/sessions/<slug>/<session id>/session.v4.jsonl.zstd       会话日志（peer_peek 用）
+ *   ~/.dsh/sessions/<slug>/<session id>/session.v4.jsonl.zstd       会话日志（peer 的 peek 动作用）
  * 平级会话的判据：投影缓存里 **没有** record.rows.subagent.identity（子会话才有）。
  */
 import fs from 'node:fs';
@@ -159,7 +159,7 @@ export function stamp(ms) {
   return p(d.getMonth() + 1) + '-' + p(d.getDate()) + ' ' + p(d.getHours()) + ':' + p(d.getMinutes());
 }
 
-/** 一行式摘要（给 peer_list 用）。 */
+/** 一行式摘要（给 peer 的 list 动作用）。 */
 export function rowLine(sessionId, cache, fallback) {
   const pct = cache === null ? null : pressurePct(cache);
   const state = isBusy(cache) === true ? 'running' : fallback === undefined ? 'idle' : fallback;
@@ -171,14 +171,14 @@ export function rowLine(sessionId, cache, fallback) {
 
 /**
  * 会话清单：controller.list 的结果按 origin 过滤。
- * 冷会话在这一步就会被服务端从持久化里恢复成可寻址的行，所以 peer_list 本身不花 token。
+ * 冷会话在这一步就会被服务端从持久化里恢复成可寻址的行，所以 peer（action="list"）本身不花 token。
  */
 export async function sessionRows(controller, includeSubagents) {
   const value = await controller.list({}, new AbortController().signal);
   return value.items.filter((row) => includeSubagents === true || row.origin !== 'subagent');
 }
 
-// ---------------------------------------------------------------- 会话日志（peer_peek）
+// ---------------------------------------------------------------- 会话日志（peer 的 peek 动作）
 
 /** 解 zstd **多帧**日志并按行解析成事件数组；本 Node 构建没有 zstd 时返回 null。 */
 export function decodeSessionLog(file) {

package/src/lib/role.mjs

@@ -8,19 +8,22 @@ import path from 'node:path';
 import { readJsonDir, pick, isSafeName, assertSafeName } from './text.mjs';
 import { projCacheDir, isSubagent } from './sessions.mjs';
 import { globalWorkspaceSessionIds } from './registry.mjs';
-import { TOOL_NAMES, PEER_NAMES, nameOf, peerNameOf } from './names.mjs';
+import { TOOL_NAMES, PEER_NAME, nameOf } from './names.mjs';
 import { stampTz } from './brief.mjs';
 
 export const ROLES = ['global', 'project', 'misc', 'plain'];
 export const ROLE_LABEL = { global: '全局', project: '项目', misc: '杂项', plain: '普通' };
 
-export const ALL_TOOL_NAMES = TOOL_NAMES.concat(PEER_NAMES);
+export const ALL_TOOL_NAMES = TOOL_NAMES.concat([PEER_NAME]);
 
-/** 角色 → 可见工具（其余一律 deny）。改这张表就是改成本结构。 */
+/**
+ * 角色 → 可见工具（其余一律 deny）。改这张表就是改成本结构。
+ * 合并后一个工具内含多个动作，动作级权限在工具内部再判一次（见 tools/peer.mjs）。
+ */
 const ROLE_TOOLS = {
   global: ALL_TOOL_NAMES.slice(),
-  project: [nameOf('phase'), nameOf('handover'), nameOf('checkpoint'), nameOf('charter'), nameOf('gate'), nameOf('snapshot'), nameOf('profile'), nameOf('office'), nameOf('succeed'), peerNameOf('send'), peerNameOf('status')],
-  misc: [nameOf('phase'), nameOf('handover'), nameOf('checkpoint'), nameOf('charter'), nameOf('snapshot'), nameOf('profile'), nameOf('office'), nameOf('succeed'), peerNameOf('send'), peerNameOf('status'), peerNameOf('new')],
+  project: [nameOf('status'), nameOf('handover'), nameOf('checkpoint'), nameOf('charter'), nameOf('gate'), nameOf('backup'), nameOf('profile'), nameOf('office'), nameOf('succeed'), nameOf('docmap'), PEER_NAME],
+  misc: [nameOf('status'), nameOf('handover'), nameOf('checkpoint'), nameOf('charter'), nameOf('backup'), nameOf('profile'), nameOf('office'), nameOf('succeed'), nameOf('docmap'), PEER_NAME],
   plain: [],
 };