chore(docs): 文档库并入代码仓（R4 选 a）+ 索引/台账跟进

1) dsh-server-docs/ 从工作区（原 E:\...\aliyun-dsh-server\dsh-server-docs）**整体并入本仓**，
   保留目录名 ⇒ 仓库内 dsh-server-docs/... 的相对引用天然继续有效；旧目录（含其 .git）已归档到
   工作区 _中间产物_待清理/，未随本提交带入。
2) .gitattributes：新增 `dsh-server-docs/** -text` —— 原文档库是 `* -text` + autocrlf=false，
   必须保持纯 LF，否则会被本仓的 CRLF 规则翻掉。
3) 活引用里的绝对路径已全部改到新位置（docs 的 INDEX / README / scripts / skills + 用户级 skills
   + ~/.workbuddy/settings.json 的 hooks）；历史档案（04-调整方案/、archive/）按「只增不改」未动。
   ⚠️ hooks 路径改动需「完全重启会话」才生效（配置是会话启动快照）。
4) 交接单/T08：新增 §16「生产整体切换执行记录」（形态 / 落地动作 / **4 个只有真上线才暴露的真 bug** /
   验收证据 / 回滚命令 / 残留项）；台账 T08 行 → 已完成并归档；03-路线图 §二 登记 T08 收尾项。
5) 统一称谓：**「本机」只指跑 WorkBuddy 的开发机**，47 / 106 一律写「远程服务器」。

dsh-server-docs/archive/交接单-已完成/T01-档案16阶段3-4-实例内我的技能.md

@@ -0,0 +1,152 @@
+# T01 · 档案 16 阶段 3/4 —— 实例内「我的技能」
+
+- 日期：2026-09-11
+- 状态：✅ **已完成**（2026-09-15 执行会话 `T01我的技能-0825` 落地；档案 **100**；插件 `business-plugins` **0.3.21** 已投放并验收）
+  - **阶段 3**（实例内入口）= ✅ 完成，且形态按 2026-09-15 修正为**并入「功能管理」内分组**（见 §一 横幅 / §四 决策 6 / §九）
+  - **阶段 4**（权限收口复核）= ✅ 收口：**本单未新增 section、未改 `ensure-role-profile-patch.cjs`** ⇒ 用户可见性**不变**，不存在"新 section 的开放范围"问题（详 §八 回报）
+- 来源：`04-调整方案/16-页面导航定稿-技能插件管理面三决策落地.md §六` 阶段 3 / 阶段 4
+- 规划会话边界：本单由**规划会话**产出（未 ssh、未改码）；执行会话按单开工
+
+---
+
+## 一、目标
+
+让**普通用户在实例内**能自助管理个人技能（上传 / 启用 / 禁用 / 删除），并在 dsh 设置「**功能管理**」页内看到「**我的技能**」分组；随后完成阶段 4 的**权限收口复核**。
+
+**做完的判定**：普通用户（guest）在实例内 dsh 设置 →「功能管理」里看到「我的技能」分组，能上传一个 zip 技能并完成 启用 → 禁用 → 删除 全流程，且共享技能行显示为锁定（不可操作）。
+
+> ⚠️ **2026-09-15 形态修正**：原述为「新增一个「我的技能」`settings.section`」；现改为**并入既有「功能管理」section 内分组**。理由与边界见 **§四 决策 6** 与 **§九**。
+
+## 二、只读前置（开工前先核实，别推断）
+
+| # | 要核实的事实 | 命令 | 期望 |
+|---|---|---|---|
+| 1 | 后端 API **确实已就绪**（档案 41 §实现 B） | `ssh bt-server "git -C /opt/dshs ls-files \| grep -E 'routes/skills' "` 再读该文件 | 存在 `GET/POST /api/skills/mine`、`POST /:name/enable`、`POST /:name/disable`、`DELETE /:name`，全部 `requireAuth` |
+| 2 | 现有 client bundle 的 section 注册写法（照抄形态，勿自创） | `ssh bt-server "ls -l /opt/dsh/artifacts/ \| grep -i biz"` + 本机 `04-调整方案/poc/business-plugins/` | 拿到 `lib/client.js` 的 `settings.section` 注册片段与 package.json 的 `dsh.client` 元数据 |
+| 3 | 铺开链路入口（新用户自动 + cron） | `ssh bt-server "git -C /opt/dshs ls-files \| grep -E 'ensure-biz' "` 再读该脚本 | `scripts/ensure-biz-plugins.cjs`（幂等、版本感知、自动取最新产物） |
+| 4 | 实例页注入的既有脚本仍在（别撞车） | `ssh bt-server "grep -c '__dshRecover\|__dshAssist' /opt/dshs/src/supervisor/proxy.ts"` | ≥2（档案 50 / 56 两个注入并存） |
+| 5 | 本次是否需要重启实例 | 取决于 #1：#1 通过则**本单不改服务端**，改的是 bundle → 需 `POST /api/dsh/restart` 或让用户在确认弹窗触发 | — |
+
+> **判定口径提醒（重要，来自档案 18 v3 的教训）**：`dsh --dump-config` **不反映 bundle / profile patch 层** —— 连已生效的 `portal-entry` / `business-plugins` 行都不显示。**因此不能拿 `--dump-config` 当验收口径**（档案 16 §六 阶段 4 原文的这句写法已过时）。改用「**bundle 加载标记（看 journald）+ 实例页 UI 实测**」。
+
+## 三、范围
+
+**要改**（路径以 `git -C /opt/dshs ls-files` 与 `04-调整方案/poc/` 实际为准）：
+
+| 区 | 文件 | 动作 |
+|---|---|---|
+| client bundle | `.../client.js` | 在**既有「功能管理」`settings.section`（id `business-plugins`）内新增「我的技能」分组**（**不新开 section**，见 §四 决策 6）：列表（含 `source/enabled/locked`）+ 上传表单 + 启用/禁用/删除按钮 |
+| bundle 版本 | `package.json` | **必须升版本号**（pnpm 同版本会命中缓存 → 改了不生效，档案 18 踩坑 1） |
+| 加载标记 | `.../lib/index.js` | 加一行 `[<bundle>] loaded …`（把回归从"看 UI"变成"看日志"；档案 26 §建议 / B5） |
+| 网关/路由 | 无需改（除 #1 发现 bug → 另立单） | — |
+
+**明确不动**：
+- ❌ 不动 dsh 官方包与缓存（红线 2）；❌ 不改 `src/web/routes/skills.ts` 的鉴权语义
+- ❌ 不动门户 `#/skills`（admin 面）；❌ 不动 `workspace-scoped-picker` / `portal-entry`
+- ❌ 不碰 `folder_plugins` / `enablePatch` 分支（档案 16 §八 保留说明：无业务调用，勿加功能）
+- ❌ **不扩大任何权限**（API 已是 `requireAuth`，本单只是加 UI）→ **不触发 R5 权限扩大门禁**
+
+## 四、决策点
+
+| # | 决策 | 结论 |
+|---|---|---|
+| 1 | **扩展 `@dsh-local/business-plugins` 注册第二个 section**，还是**新建 `@dsh-local/my-skills`** | ✅ **已定（2026-09-12 用户拍板）**：**采用 A —— 扩展 `@dsh-local/business-plugins` 注册第二个 section**（用户原话「扩展 business-plugins 不用做两套」）。不新建 `my-skills` 包。理由：复用现成的「铺开 / 探活 / 版本感知 / 新用户自动铺 + cron 巡检」链路，成本最低；代价是 `business-plugins` 职责由一个变两个（在包 README 与本档案里说明即可）。 |
+| 2 | 上传是否复用门户的 P0/P1 内容扫描 | **已定（必须复用）**：上传走平台 root 链路，档案 41 的 symlink P0 就是这类。UI 只负责把 zip POST 到 `/api/skills/mine`，扫描在服务端（档案 41 §A / 档案 19 §C6） |
+| 3 | admin 是否也看到这个 section | **已定（档案 16 §五）**：所有用户（含 admin）都显示 |
+| 4 | 是否顺手补 B5（给两个 bundle 加加载标记） | **已定（顺手做）**：零边际成本，正是本单要改的文件（`03-路线图` B5 行已降级为"顺手做"） |
+| 5 | 是否同时补门户 `#/files` 下载按钮（P3） | **不在本单**（另立） |
+| 6 | **「我的技能」是并进既有「功能管理」section，还是新开一个 section** | ✅ **已定（2026-09-15，自决，可推翻）**：**并入「功能管理」内分组，不新开 section**。依据 ① 用户口径「不要分开管理」② 该分区已由档案 60 命名为**「功能管理」**——另立「我的技能」= 在"功能"之外再造一个平行概念，与口径反向 ③ 素材库 **U2**「不做两套实现，能扩展就不新建」④ 两者交互形态同构（列表 + 启停）。**代价**：一个 section 承载两组内容（决策 1 已认下）。⛔ **仅入口层合并 —— 机制层保持分离**：两条后端 API、两套落盘位置、两种生效方式都不合并（见 **§九**）|
+
+## 五、步骤（每步自带验证）
+
+1. **核实前置**：#1–#4 逐条执行；若 #1 缺端点 → **停**，回报"后端未就绪"，不要自己补后端。
+2. **读规范**：`06-工作台UI规范.md`（强制基线）+ `档案 16 §七` 设计点；参考 `04-调整方案/poc/business-plugins/` 现有 section 的写法与 token 用法。
+   *验证*：能指出新 section 用到的设计 token 来源（`--dsw-*`）。
+3. **写 UI**（决策 1 选定的载体）：列表字段 = 名称 / 来源（shared·user）/ 状态（enabled·disabled）/ 锁定标记；操作 = 上传（zip）、启用、禁用、删除；共享行 `locked:true` → 按钮禁用。
+   *验证*：本地 `npm run build`（或该 bundle 的构建命令）通过。
+4. **升版本 + 打包 + 安装**：`pnpm add file:<tgz>`，**`HOME=<ws>` 必须设**，且 **guest 的 profile 是 pnpm workspace 根需加 `-w`、admin 不需要**（档案 25 踩坑）。产物放 `/opt/dsh/artifacts/`，**不要复制进用户 ws**（档案 28 的平台污染 bug）。
+   *验证*：`ls` 确认 `lib/client.js` 与 `lib/index.js` **都在**（档案 18 踩坑 2：scp 静默失败）；比对 md5。
+5. **重启 + 探活**：走编排器 `POST /api/dsh/restart`（按 uid 选 pid）；或复用 `restartAndProbe` 的探活口径（档案 34）。
+   *验证*：`journalctl -u dshs --since '5 min ago'` 出现 `[<bundle>] loaded`，且**无** `duplicate loader entry id`（档案 25 事故特征）。
+6. **端到端实测**（用 R4 模板：注册 → admin approve → 用完 DELETE，临时会话 `poc-*` 用完即删；**禁止用真实账号做 API 登录测试**）：上传 → 禁用 → 启用 → 删除。
+   *验证*：见 §六 B–F。
+7. **阶段 4 权限收口复核**：确认新 section 对 guest 可见、且**没误伤** guest 已禁的 `ui-settings-*` 裁剪（档案 09 / 16 §六 阶段 4）。
+   *验证*：用**实例页实测 + 加载标记**判定（**不要用 `--dump-config`**，见 §二 提醒）；输出一份"开 new section 前后 guest 可见 section 列表"对照。
+8. **归档**：新建档案（**原子占号** `mkdir 04-调整方案/.lock-<NN>`；当前下一号见 `README` 的「下一号」）；更新 `INDEX.md §二` 对应行状态、`03-路线图` 勾销阶段 3/4 行、`README` 下一号；`git mv` 本单到 `archive/交接单-已完成/`。
+   *验证*：`python3 scripts/docs-audit.py` 退出码 0。
+
+## 六、验收标准（可被第三方复现）
+
+| # | 命令 / 动作 | 期望 |
+|---|---|---|
+| A | `ssh bt-server "cd /opt/dshs && bash scripts/ci.sh"` | 退出码 **0**，单测全绿 |
+| B | 硬刷新 guest 实例子域页 → dsh 设置 →「**功能管理**」 | 页内出现「**我的技能**」分组（**与「功能插件」同页**），列出共享技能（显示锁定）与个人技能 |
+| C | 上传一个正常 zip 技能 | 200，列表出现该项且 `enabled`；`$DSH_HOME/skills/<name>` 存在 |
+| D | 点禁用 → 点启用 → 点删除 | 禁用后文件在 `home/skills-library/<name>`；启用后回到 `skills/`；删除后两处均无 |
+| E | 上传与共享技能同名的包 / 对锁定行操作 | **409**（档案 41 的守卫生效） |
+| F | 实例页仍含两个注入脚本 | 页面源码含 `__dshRecover` **且** 含 `__dshAssist` |
+| G | `journalctl` | 有 `[<bundle>] loaded`；无 `duplicate loader entry id`、无崩溃重启 |
+
+## 七、回滚
+
+- **bundle 回退**：装回上一版本 tgz（版本号必须不同，否则 pnpm 命中缓存）→ 重启实例；或让该 section 不注册。
+- **本单不改服务端** → 服务端无需回滚；若 #1 阶段确实改了服务端，按 `cp <file>.bak-<ts> <file> && npm run build && systemctl restart dshs`。
+- **确认无残留**：`ls <profile>/node_modules/@dsh-local/` 与 profile 的 `dsh.profile.bundles` 一致。
+
+## 八、回报格式（执行会话填）
+
+```
+## T01 执行回报
+- 决策 1 选定：A · 扩展 business-plugins（2026-09-12 用户拍板）；形态修正为「并入既有「功能管理」内分组」（2026-09-15，见 §四 决策 6）
+- 档案号：100
+- 插件版本：`@dsh-local/business-plugins` 0.3.20 → **0.3.21**（产物 70,758 B / sha256 `77429d2c…`）
+- 验收：A ✅ / B ✅ / C ✅ / D ✅ / E ✅ / F ✅ / G ✅（**逐项证据见下**）
+- 偏离：① 形态由「新增 section」改为「并入既有 section 分组」（有依据，见 §四 决策 6）；② **新增** `scripts/verify-my-skills.mjs` 并纳入 `npm run verify`（原单未要求，但把"不换行 / 危险操作二次确认 / 锁定行无按钮"钉成断言可防回退）；③ 未改动服务端（同原单预期）
+- 证据：
+  · A 本地 `npm run verify` 全绿（词典 zh/en 各 366 键、引用键 343 个全部已声明）
+  · B 两实例 profile 均 0.3.21；`msk.group` 命中 3 / `bp-skillRow` 命中 4
+  · C 壳页 combo 出现 `@dsh-local/business-plugins`；壳页 58,126 B → 58,724 B；`rev=533537bbc02b`
+  · D bundle HTTP 200 · **11,363,655 B** · 含 `msk.group` / `msk.replaceWarn` / `bp-skillRow` / 「我的技能」
+  · E 端到端 **19/19**（一次性用户，用完即删）：上传 → 列表 enabled → 同名 `conflict`+`stagedId` → `apply` 全量替换 → 停用（文件落 `skills-library`、不在 `skills`）→ 启用（回到 `skills`）→ 删除（两处皆无、列表消失）
+  · F 对共享技能 `platform-capabilities` 的 disable / delete **均 409**；非 `.zip` **400**「仅支持 .zip 文件」
+  · G 浏览器（`agent-browser`）**全链路零缺陷**：设置→「功能管理」可见「我的技能」分组（与「功能插件」同页）；共享技能行显示 `共享｜🔒只读｜已启用｜1 个文件 · 2.9 KB` 且**无动作按钮**；展开上传面板 → 选 `poc-skill-demo.zip` → 点「上传」= `POST /api/skills/mine` **200** 且页面提示「✓ 已上传技能…」、列表新增 `我的｜已启用｜3 个文件 · 575 B｜[停用][删除]`；点「删除」出确认弹窗（点名 + "不可恢复"）→ 确认 = `DELETE` **200**、提示「✓ 已删除…」、列表回到只剩共享行。截图与逐条证据见档案 100 §8.4
+- 阶段 4 复核：本单**未新增 section**（形态 = 既有 section 内分组）⇒ 段位可见性零变化；`ensure-role-profile-patch.cjs` **未改**（我的改动清单 = client.js / package.json×2 / verify-my-skills.mjs）；实例侧 `cordis.patch.yml` 的禁用项（`ui-settings-models` / `-settings-plugins` / `-plugin-inventory` / `ui-cordis`）原样保留
+```
+
+
+---
+
+## 九、口径依据与适用范围（2026-09-15 追加，本单形态修正的由来）
+
+**问题**：「把 skill 和插件都看成功能（能力），统一管理」这条提法，**适用于用户管理个人 skills 吗**？
+
+### 9.1 原文与该提法的适用范围
+
+- **原话**（2026-09-12 09:18，会话 `ca58e09f`）：「你是方案规划 不是执行，在明确一下 A 按照最佳方案处理 B 按照你的建议处理 **！业务技能能否打包到插件中 一起安装和使用，不要分开管理！** C D 按照最优方案处理」
+- **它落地成什么** = **投放链路的合并**，即 `archive/交接单-已完成/T03` **§4.1「技能随插件包投放」**：整合包内置 `skills/` + `skills/.manifest.json`，插件 host 面每次实例启动跑 `ensureSkills()` 幂等对账；**与共享技能层互斥**（同名会按 rank 抢）。对应素材库 **U4「交付面越少越好」**。
+- **适用对象 = 平台/业务侧投放的技能**（MCN 这类）。判据内核 = 用户心智「我装一个插件就全有了」，优于"分层更干净"。
+
+### 9.2 对「用户管理个人 skills」——分两层，结论相反
+
+| 层 | 是否适用 | 依据 |
+|---|---|---|
+| **机制 / 投放层** | ❌ **不适用** | 个人技能**不是投放物**，是用户自己上传的产物 —— 没有"第二条投放链路"可合并，也没有"插件包"能装它；硬套会把「用户自己产生的东西」塞进「平台投放的包」，方向反了。而且两向隔离**已被现决策刻意设计**：`T03 §4.1` 第 4 条明确「**不覆盖用户自建的同名技能**（目录存在但无 `.installed.json`）→ 跳过 + 日志 + UI 提示"被同名技能占用"」。⇒ 二者**必须保持两条独立通道** |
+| **入口 / 心智层** | ✅ **适用** | 正是本单形态修正的原因（§四 决策 6）：实例内那一栏已由档案 60 命名为**「功能管理」**，再另立一个「我的技能」section = 在"功能"之外再造平行概念，与「不要分开管理」反向 |
+
+### 9.3 ⛔ 不能一起"统一"掉的机制差异（避免过度统一）
+
+| 维度 | 功能插件（候选池） | 个人技能（用户自传） |
+|---|---|---|
+| 来源 | admin 投放（门户 → 候选池） | 用户自己上传 zip |
+| 生效方式 | **需重启实例** | **watch 即时生效，无需重启** |
+| 默认态 | 进池**默认禁用** | 上传即启用 |
+| 平台共享层的语义 | 投放进池、用户自助启用 | **投放即生效且锁定只读**（不造开关 —— 档案 16 §2.1 决策 2「技能与插件启用语义不同」）|
+| 用户可否删除 | 可禁用（包由平台管）| **可启用 / 可禁用 / 可删除**（档案 41 用户决策）|
+| 落盘位置 | profile `node_modules` + `dsh.profile.bundles` | `$DSH_HOME/skills` 启用位 / `home/skills-library` 禁用位 |
+| 后端 API | `/api/plugins/*` | `/api/skills/{shared,mine}/*` |
+
+⇒ 本单"合并"的**只有可点击的那一层**；后端、落盘、生效链路一律各自独立。
+
+### 9.4 相关档案
+
+`04-调整方案/16`（导航定稿 + 三层归属 + §2.1 决策 2）· `04-调整方案/41`（技能上传安全加固 + 用户启停）· `04-调整方案/60`（分区改名「功能管理」）· `04-调整方案/11`（技能管理面）· `archive/交接单-已完成/T03 §4.1`（技能随包投放）· `skills/dsh-decision-method/references/素材库-U-用户决策.md`（U2 / U4 / U10）。

dsh-server-docs/archive/交接单-已完成/T02-文档库收尾-编号消歧与INDEX瘦身.md

@@ -0,0 +1,165 @@
+# T02 · 文档库收尾 —— 编号消歧（37/38）+ INDEX 瘦身与事实校正
+
+- 日期：2026-09-11
+- 状态：⏳ **待执行**（已规划，未开工）
+- 来源：`04-调整方案/53-文档质量审查与精简方案.md §四.1`（编号冲突）+ `04-调整方案/54-文档信息架构优化-BRIEF与机读清单.md §四.A`（INDEX 瘦身）
+- 规划会话边界：本单由**规划会话**产出（未 ssh、未改码）；执行会话按单开工
+
+---
+
+## 一、目标
+
+1. **消歧**：让 `37` / `38` 两个编号各自唯一指向一份档案 → `docs-audit.py` 的「编号冲突」归零。
+2. **瘦身**：`INDEX.md` 从 **28,805 字符 / 185 行** 压到 **≤ 10,000 字符**，入口读取成本再降。
+3. **校正**（本轮新增，见 §四.3）：修掉 INDEX 里**与现状相反的陈述**（本机镜像是否存在、对账脚本是否存在、下一号、代码 HEAD）。
+
+**做完的判定**：`python3 scripts/docs-audit.py` **退出码 0**（编号冲突 0 / 标题号不符 0 / 悬空引用 0），且 `INDEX.md` 字符数 ≤ 10,000。
+
+## 二、只读前置
+
+| # | 事实 | 命令 | 期望 |
+|---|---|---|---|
+| 1 | 当前基线（先量再改） | `python3 -c "import io;print(len(io.open('INDEX.md',encoding='utf-8').read()))"` | **28,805 字符 / 185 行**（2026-09-12 07:20 实测） |
+| 2 | 双端是否已拉齐 | `bash scripts/docs-sync-check.sh` | 退出码 **0**；不为 0 先拉齐再改 |
+| 3 | 现存冲突与悬空项 | `python3 scripts/docs-audit.py` | 实测：总 **107** 文件（md 78 / 其他 29）；【1】37 与 38 各 2 份 + 01/02/03/06 的"两套体系"提示；【2】2 份标题号不符；【6】**无**悬空 |
+| 4 | 引用清单可复现 | `grep -rnE "档案 (37|38)" --include=*.md .` | 实测 **27 处 / 13 个文件**（见 §3.2 下表；档案 53 估的 18 处偏少） |
+| 5 | 代码 HEAD（填 INDEX §五） | `ssh bt-server "git -C /opt/dshs log --oneline -1"` | 实测值（**以实跑为准**） |
+
+> **基线刷新记录（2026-09-12 07:20）**：并行通道在此期间新增档案 **57-60**（已登记进 INDEX）→ INDEX 25,581 → **28,805 字符**、旧编号引用 25 → **27 处**、audit 总文件 103 → **107**。
+> **这再次印证**：T01 / T02 与并行通道处在**同一冲突域**（都改 `INDEX.md` / `README.md` / `03-路线图`）→ **必须串行**，且**开跑前务必复跑 §二#1–#4 重新取基线**，不要沿用本单旧数字。
+
+## 三、任务 A：编号消歧（采用**方案 A** 字母后缀）
+
+`37` / `38` 各被两份占用（并行通道撞号），且其中两份**标题号与文件名号不符**。规划会话已按 **档案 53 §四.1 方案 A** 立项：
+
+| 现文件名（`04-调整方案/`） | 新文件名 | 标题改为 | 指向 |
+|---|---|---|---|
+| `37-guest会话取证与平台缺陷清单.md`（现标题写 36） | `37a-guest会话取证与平台缺陷清单.md` | `37a · …` | `37a` |
+| `37-功能插件分区v0.2官方token与i18n.md` | `37b-功能插件分区v0.2官方token与i18n.md` | `37b · …` | `37b` |
+| `38-实例软件安装共享与网络安边界核查.md`（现标题写 37） | `38a-实例软件安装共享与网络安边界核查.md` | `38a · …` | `38a` |
+| `38-术语统一…改功能插件.md` | `38b-术语统一…改功能插件.md` | `38b · …` | `38b` |
+
+> 方案 B（顺延重编号）与 C（只对齐标题）已在档案 53 §四.1 排除：B 改动更大且破坏时序语义，C 不能消歧。
+
+### 3.1 ⚠️ 必须同步改两个脚本的正则（否则"改完更糟"）
+
+`37a-…` 不匹配 `^(\d+)-`，会让 4 份档案**从统计里消失**（`docs-manifest.py` 会把它们判成 `tier=doc` / `num=null`，档案份数与 hot/warm 分层全部失真）。所以方案 A 的**必要组成部分**是改 6 处正则：
+
+| 文件 | 行 | 现值 | 改为 |
+|---|---|---|---|
+| `scripts/docs-manifest.py` | 41 | `r'^\|\s*04-(\d+)\s*\|'` | `r'^\|\s*04-(\d+[a-z]?)\s*\|'` |
+| `scripts/docs-manifest.py` | 58 | `r'^(\d+)-'` | `r'^(\d+[a-z]?)-'` |
+| `scripts/docs-manifest.py` | 51 | `r'档案\s*(\d{1,2})\b'` | `r'档案\s*(\d{1,2}[a-z]?)'`（**去掉 `\b`**，否则 `档案 37a` 匹配不到） |
+| `scripts/docs-audit.py` | 59 | `r'^(\d+)-'` | `r'^(\d+[a-z]?)-'` |
+| `scripts/docs-audit.py` | 60 | `(\d+)` 标题号 | `(\d+[a-z]?)` |
+| `scripts/docs-audit.py` | 122 | `r'档案\s*(\d{1,2})\b'` | `r'档案\s*(\d{1,2}[a-z]?)'` |
+
+**另外**：`docs-audit.py` 的 `num_map` 现在用 `int(mf.group(1))` 作键（L62）→ 改成**字符串键**（`mf.group(1)`），L118 的 `existing` 与 L124 的比较也一并按字符串，避免 `'37a'` 与 `int` 混比。
+
+*验证*：改完在**未改名**状态下先跑一次两个脚本 → 输出应与改前**一致**（证明正则改动无语义漂移）；再做改名。
+
+### 3.2 引用修正规则（**按内容判定，勿机械替换**）
+
+| 引用的语境 | 指向 |
+|---|---|
+| 会话取证 / 会话级播种 / 零技能投放 / 存量会话 | `37a` |
+| 功能插件分区 v0.2 / 官方 token / i18n | `37b` |
+| 实例软件安装共享 / Playwright / 网络与安全边界 / 共享技能层挂载 / 无磁盘配额 | `38a` |
+| 术语统一 / 以某档案为准的术语口径 | `38b` |
+
+已知待改位置（**2026-09-12 07:20 实测：27 处 / 13 个文件**；执行时以 §二#4 实跑复核）：
+
+| 位置 | 处数 | 现语境 → 改为 |
+|---|---|---|
+| `BRIEF.md:68` | 1 | 术语以旧 38 为准 → **38b** |
+| `README.md:18` | 1 | 同上 → **38b** |
+| `INDEX.md` | 3 | §二 表行与行内引用 → 37a / 37b / 38a / 38b 分别对齐（表行见 §4.1 重复行合并） |
+| `skills/dsh-change-workflow/SKILL.md` | 3 | `:452` 边界章节 → **38a**；`:779` 术语章节 → **38b**；`:472` 按内容判 |
+| `04-调整方案/38-实例软件安装共享与网络安边界核查.md` | 5 | 会话取证引用 → **37a** |
+| `04-调整方案/38-术语统一…改功能插件.md` | 1 | 分区 v0.2 引用 → **37b** |
+| `04-调整方案/39-实例可见面收窄与宿主访问封锁.md` | 2 | 边界核查起因 → **38a** |
+| `04-调整方案/40-共享技能层挂载修复.md` | 1 | 挂载起因 → **38a** |
+| `04-调整方案/41-技能上传安全加固与用户技能启停.md` | 1 | 无磁盘配额 → **38a** |
+| `04-调整方案/45-存量会话新开会话提示.md` | 1 | 会话级播种 P0-1 → **37a** |
+| `04-调整方案/46-实例共享工具jq-ripgrep-ffmpeg.md` | 1 | Playwright 是否每人一份 → **38a** |
+| `04-调整方案/53-文档质量审查与精简方案.md` | 5 | 本档自身的冲突描述（§二 P0 行 + §四.1 全节）→ 改 37a/37b/38a/38b + 追加「已执行」一行 |
+
+> ⚠️ **两处副本都要改**：`skills/dsh-change-workflow/` 在本目录是**服务器归档副本**，工作副本在本机 `.workbuddy/skills/`（技能必须本地加载）——**单向推进 本机 → 本目录，勿反向覆盖**。
+
+> **自带验证器**：改名后 `docs-audit.py` 会把所有**残留的裸旧号**（不带字母后缀的那种写法）判为**悬空引用**（退出码 1）→ **改不干净就过不了验收**，这正是我们要的强制力。**注意：本单自身、以及归档后的本单同样会被扫描**，收尾时一并清理。
+
+## 四、任务 B：INDEX 瘦身（目标 ≤ 10,000 字符）
+
+体积主因 = **§二「全量清单」表**（60+ 行，每行 300–900 字符，含「文档路径 / 状态 / 最后更新 / 一句话内容 / 证据」五列）。
+
+**做法（已定）**：
+
+| 章节 | 动作 |
+|---|---|
+| §一 场景速查表 | **保留**（定位层，最高频） |
+| §二 顶部「状态摘要（30 秒视图）」 | **保留** 4 行（状态计数 + 分层 + 指针） |
+| §二 明细表 | **压成精简表**：`\| 号 \| 状态 \| 一句话（≤25 字） \|` 三列，**删掉**「文档路径 / 最后更新 / 证据」三列——路径与标题看 `docs-manifest.json` 的 `path`/`title`，日期看它的 `date`，commit 归各档案自身 |
+| §三 变化追踪 | 保留，手段表 5 行 → 压到 3 行（把已作废的"服务器 git init 建议"按结论一行带过） |
+| §四 归档残留 | 保留；归档表精简为"文件 + 状态"两列 |
+| §五 仓库与同步拓扑 | **保留**（关键事实，逐行核对更新到当前 HEAD） |
+| §六 落位规则 | 保留 7 条 + 新增第 8 条（交接单落位，本单已加） |
+
+**测量**：`python3 -c "import io;print(len(io.open('INDEX.md',encoding='utf-8').read()))"`；一次压不到位时，继续删「一句话」列长度与 §三/§四 的冗余表述，**不要删 §一 场景表**。
+
+### 4.1 顺手修掉的事实错误（同时是"歧义源"）
+
+| 位置 | 现文 | 应为 |
+|---|---|---|
+| `INDEX.md:6` | 「**服务器唯一源**…**本机不保留副本**…61 文件…原整库对账脚本 `docs-sync-check.sh` **已删除**」 | 与本机镜像存在（本目录即工作树）、且 `scripts/docs-sync-check.sh` **在用**（`README §对账`、`BRIEF §6` 都在引用）**直接矛盾** → 改为"本机工作树 + 服务器镜像双端，对账脚本在用" |
+| `INDEX.md:7` | 本机工作区 = `D:\AI技能\aliyun-work-space\`，称 `aliyun-dsh-server` "**已不存在**" | **写反了** → 应为 `D:\AI技能\aliyun-dsh-server\dsh-server-docs` |
+| `INDEX.md:8` | 最后核对 10:12 / 代码至档案 28 | 更新到当前（档案 56） |
+| `INDEX.md` §二 | 3 处**重复行**：`04-37`×2、`04-38`×2、`04-21`×2 | 合并为 37a/37b、38a/38b 两行；21 只留一行 |
+| `INDEX.md` §二 | 无「编号 48 未使用」说明 | 补一行说明（缺号） |
+| `INDEX.md:117` | 阶段 3/4 待办 | T01 完成后勾销 |
+| `INDEX.md` §五 | 代码 `master @ 8355e99` | 按 §二#5 实测值更新 |
+| `INDEX.md` §六① | 「下一号 = **20**」 | 更新为当前值（以 `README §使用约定` 的「下一号」为准，改前先与 T01 当时的占号结果对齐，**避免两个通道同时取号**） |
+| `README.md` 模块一览 | 称 `skills/dsh-change-workflow/` 的工作副本在本机 `.workbuddy/skills/` | 规划会话在 4 个候选路径（`~/.workbuddy/skills/`、`~/.dsh/skills/`、`D:\dshworkspace\` 下两级、本工作区 `.workbuddy/skills/`）**均未找到该技能**（`~/.dsh/skills/` 下是 `dsh-multi-user-migration`）→ 请核实真实位置并订正「同步方向本机 → 本目录」这句 |
+
+## 五、明确不做
+
+- ❌ 历史档案里的旧域名 / 旧术语**不回改**（档案 53 §五已判定：档案是当时事实）
+- ❌ `archive/` 全文不动；❌ `02-运维手册` / `06-工作台UI规范` 长文不拆
+- ❌ 档案 53 §四 的其余待裁定项（02 正文加历史前缀、19 份补状态行、`.bak` 清理、SKILL.md 拆分）→ **不在本单**
+- ❌ 那个结尾带点号的 `INDEX.md.bak-20260911111003.`（Windows 落不了地）→ 不动
+
+## 六、验收
+
+| # | 命令 | 期望 |
+|---|---|---|
+| A | `python3 scripts/docs-audit.py` | **退出码 0**；【1】无冲突、【2】无、【6】无悬空 |
+| B | `python3 -c "import io;print(len(io.open('INDEX.md',encoding='utf-8').read()))"` | **≤ 10000** |
+| C | `python3 scripts/docs-manifest.py` | 档案份数**与改前一致**；`37a/37b/38a/38b` 出现在 items 且各自有 `refs` 与 `tier`（**证明 3.1 的正则改动生效**） |
+| D | `grep -rnE "档案 (37|38)" --include=*.md .` | 只剩「指向 37a/37b/38a/38b」的表述，**无裸旧号** |
+| E | `bash scripts/docs-sync-check.sh` | 退出码 0（含新增的 `交接单/` 目录已推送服务器） |
+| F | `INDEX.md` 内所有指向 T01 的相关行 | 与 T01 执行结果一致（若 T01 未完成，保持"待办"表述） |
+
+## 七、回滚
+
+- **文档**：`git -C dsh-server-docs checkout -- <文件>`；改名用 `git mv` 反向再来一次（保留历史）。
+- **脚本**：两处正则改动若异常，`git checkout -- scripts/docs-{audit,manifest}.py` 并**同时撤销改名**（正则与文件名必须成对，半改状态会让 manifest 统计失真）。
+- **服务器镜像**：`scp` 前先备份 `/opt/dsh/docs` 对应文件；权限维持 root 600（README 644）。
+
+## 八、回报格式（执行会话填）
+
+```
+## T02 执行回报（2026-09-12 执行完毕）
+
+- **改名前基线**：INDEX **28,809 字符 / 184 行**；audit：【1】37 与 38 各被 2 份占用 + 2 份标题号不符；【2】2 份；【6】无悬空**但 T02 单子自身引用 `37a` 被判悬空** → 退出码 1
+- **改名**：4 份经 `git mv` → `37a`/`37b`/`38a`/`38b`（git 识别为 **R 重命名，历史保留**）+ 4 个标题号同步改写（`# 36`→`# 37a`、原 `# 37`→`# 37b`、原 `# 37`→`# 38a`、`# 38`→`# 38b`）
+- **脚本正则**：`docs-audit.py` **4 处** + `docs-manifest.py` **4 处** = 共 **8 处**（**多于单子列的 6 处**：单子漏了 `index_status`/`ref` 的键转换，以及 `%02d` 格式化 —— 键改字符串后 `%02d` 会 TypeError，必须同改）；**未改名状态下先复跑** ✅，差异全部可解释且**更准确**：audit 唯一差异 = 新号 `37a` 被判悬空（预期）；manifest 归一化后 11 条 = 9 条零填充（`1`→`'01'`，类型变更连带，反而与 INDEX 的 `04-01` 更一致）+「`03` 的 refs 4→2」（原先被 `int()` 误并进来的裸旧号 —— 即 `档案` 与数字分开写的那种 —— 分离出去，那是**单子自身的示例文本**）+「`16` 的 refs 24→25」（去掉 `\b` 后**修复了一个漏匹配**）
+- **引用修正**：实跑命中 **28 处 / 14 文件**（单子估 27 处/13 文件，**偏少 1**）；逐条按内容判定归属 —— **37a 7 处**（INDEX:98 / 38a:6,55,139,178,188 / 45:5）、**37b 1 处**（38b:56）、**38a 9 处**（INDEX:93,99 / 39:12,118 / 40:5 / 41:28 / 46:5 / SKILL:489,509）、**38b 6 处**（BRIEF:68 / INDEX:112 / README:18 / 53:55 / 60:43 / SKILL:816）；另 **53 自身 3 处描述改写**（P0 行、§四.1 标题、方案 A 段落，均加「✅ 已执行」）+ **T02 单子自身 2 处示例文本**改写
+- **INDEX 瘦身**：**28,809 → 7,468 字符**（184 → 168 行，**减 74%**，达标）；删除列 = 文档路径 / 最后更新 / 证据（均指向 `docs-manifest.json`）；§二 明细压成三列；§三 手段表重排（对账/机读/审计/代码侧/文档侧/时间线）；§四 精简为 4 行；§五 补「行尾」约定；§六 保留 7 条 + 第 8 条（交接单落位）
+- **事实校正**：L6（「服务器唯一源 / 本机不保留副本 / 对账脚本已删除」→ **实为双端模型且脚本在用**）✅｜L7（本机工作区误写 `aliyun-work-space` 且称 `aliyun-dsh-server` 已不存在 → **写反了，已改正**）✅｜L8（最后核对 → 2026-09-12 / md 78 / 代码 `ebe8075` / 档案 60）✅｜§二 重复行（37×2、38×2、21×2 → 合并）✅｜缺号 48 ✅｜§五 代码 HEAD（`8355e99` → **`ebe8075`**）✅｜§六① 下一号（20 → **61**）✅｜**另修** README 的技能工作副本路径（规划会话在 4 个候选路径均未找到 → 实际在 **`E:\ProgramData\.workbuddy\skills\`**，因 `.workbuddy` 数据目录已迁至 E 盘）✅
+- **验收**：**A ✅ B ✅ C ✅ D ✅ E ✅ F ✅**
+- **证据**：
+  - `docs-audit.py` → `结论：无 P0 级问题`、`【6】✓ 无悬空档案号引用`、**退出码 0**
+  - `docs-manifest.json` → `items: 78`（与改前一致），含字母后缀编号 `['37a','37b','38a','38b']` 且各有 refs/tier
+  - 裸旧号检查（`档案` 后直接跟两位数字、不带字母后缀的写法）→ **残留 0**
+  - `docs-sync-check.sh` → `一致: 107 / 内容不一致: 0 / 仅本地: 0 / 仅服务器: 0` → **双端一致 ✅**
+- **偏离**：① 脚本正则由 6 处增至 **8 处**（键类型连带的必需修改）；② 引用实为 **28 处 / 14 文件**（单子估 27/13）；③ 额外修正 **T02 单子自身 2 处示例文本**（原 `grep "档案\s*3[78]"` 会被新正则匹配成裸旧号 → 永久悬空，改为 `grep -rnE "档案 (37|38)"`）；④ 除单子列的 8 处事实校正外，另修 README 技能工作副本路径
+```

dsh-server-docs/archive/交接单-已完成/T03-plugin_package整合为单插件并投放.md

@@ -0,0 +1,345 @@
+# T03 · 把 `plugin_package` 7 个自研插件整合为 1 个功能插件并投放
+
+- 日期：2026-09-12
+- 状态：✅ **已完成并归档（2026-09-13 18:0x）** —— 投放链路全通（上传 → admin 装 → **guest 启用** → 实例重启探活成功）；主体验收通过。收尾记录见 **§十**
+
+> ⛔ **2026-09-13 09:4x 现场取证：这一步已被试过，但被平台自动回滚了。**
+> guest 在 **07:42:52** 通过「功能管理」提交了启用（`POST /api/plugins/mine/apply`，任务 `c8ac2686539aeb7c`），
+> 随后实例 **07:43–07:45 连崩 5 次**（`exitCode=134`，栈 = V8 `JsonParser`/`HeapAllocator` ⇒ **V8 堆打满 abort**），
+> 07:46 触发熔断，平台**自动回滚**（`package.json.bak-rollback-20260913T0748`）⇒ 现在 guest bundles 里**没有** mcn-suite。
+> **根因指向 `--max-old-space-size=160` 太紧**（档案 74 的下调）+ guest cgroup 峰值已 **382/384 MiB**
+> ⇒ **先把内存预算调上去（需重启窗口），再重试启用**。详见 `04-调整方案/74` 文末「现场反证」。
+
+**原状态行**：⏳ **待续做（2026-09-13 07:3x 复核更正）** —— **步骤 1–9 已完成，且「上传候选池」亦已完成**（现行池内 = `dsh-plugin-mcn-suite @0.3.9`，09-13 00:02 上传；**admin 侧已装 0.3.9 且 host 面 3 个注册加载通过**），**剩**：**`guest` 侧在实例「功能管理」启用**（`POST /api/plugins/mine/apply` —— **用户动作，平台不代劳**）→ 重启实例 → §八验收 → 归档。**2026-09-12 14:55 已释放占用锁**（原 `exec-session-B`），接手者**直接续做**；产物与验收证据见 `交接单/README.md §一` 的 T03 行。
+
+> **🔎 只读核查结论（2026-09-12 20:2x）—— 执行前的三个事实**
+> ① **候选池里只有 `dsh-univer-office`（39.9 MB）** ⇒ §七 防线②"下架旧 7 包"**实际无需做**：那 7 个包**从未上架过候选池**，不存在新旧并存。
+> ② **guest 的 `profile/web` bundles = `base / dsh-web-app / business-plugins / portal-entry / workspace-scoped-picker / @liustack/modlens / dsh-univer-office`** ⇒ **不含任何旧包** ⇒ §七 头号风险（新旧并存 → `duplicate loader entry id` 崩实例）**在本单不成立**，切换顺序可简化。
+> ③ **时机未到**：guest 活动实测 —— `ws/MCN短视频创作` mtime = **20:06**、`sessions` mtime = **20:02**（距核查 13–17 分钟）⇒ 判定**活跃中**，按 **R8「能避开活跃时段就避开」** 暂缓"启用 + 重启"。上传（零影响）与启用（断 guest ~1 分钟）**同窗口做更安全**（避免为"上传"单独占一次 op-lock），故**整体等待空闲窗口**（判据：最近 30 分钟无活动）。
+>
+> ⚠️ **同窗口须一并处理**：guest 的 bundles 里仍挂着 **`@liustack/modlens`** —— 该包今天已从候选池下架（档案 70 收尾），但用户 profile **仍启用它**（包文件尚在 `node_modules/@liustack/modlens`，故当前不致命）。这是"**已下架却仍启用**"的不一致态 ⇒ **与 T03 共用同一次重启窗口摘除**（从 bundles 移除 + 重启），避免两次中断用户。
+
+### ✅ 上线进展（2026-09-12 22:0x）
+
+| 步 | 结果 |
+|---|---|
+| ① 首传 0.3.0 | ❌ **被 T05 兼容性预检拒收**（HTTP 409 `compat_incompatible`）—— 判据 `@deepseek-ai/dsh-client-ui-sidebar@^0.1.0-rc.5` vs 平台 `0.1.2-rc.1`。**根因是 semver 的 prerelease 规则**：带 prerelease 的版本只能被「**同 major.minor.patch 且带 prerelease**」的比较器匹配，`^0.1.0-rc.5` 里没有 tuple `(0,1,2)` 的比较器 ⇒ 判不满足。**不是误报，是声明写窄了**（且 T05 16:35 才上线，而包 11:15 打的，单子当时没这道关） |
+| ② 修正 + 重传 | ✅ **HTTP 200**，`compat.level = ok`、`findings[]` 空。改法：3 个 `dsh-client-*` peer 范围 → **`^0.1.2-rc.1`**（跟随平台版本）；版本号 **0.3.0 → 0.3.1**；`npm pack` 重打包 → md5 **`adcb134e…`** / 322 条目。**内容与 0.3.0 逐项对齐**：`SKILL.md` 18=18、`lib/` 文件 19=19、`web/` 1=1（条目数差异纯属 `npm pack` 不写目录条目） |
+| ③ 候选池 | 现 **2 条**（09-13 07:3x 复核）：`dsh-plugin-mcn-suite @0.3.9`（09-13 00:02；admin 已装并验通，**guest 未启用**）+ `dsh-univer-office @0.2.15`（09-12 23:19，fork 版）｜历史：曾为 `@0.3.1` + `@0.2.14`，`@liustack/modlens` 与 `anysearch` 已下架 |
+| ④ 剩余 | **`guest` 在实例「功能管理」里启用**（`POST /api/plugins/mine/apply` —— **用户动作，平台不代劳**）→ 重启 → §八 验收 → 归档。~~同窗口一并摘 `@liustack/modlens`~~ **已消解**（09-13 07:0x 实测：guest `bundles` 与 `node_modules` 均已无该包）|
+
+> ⚠️ **给接手人的两条提醒**
+> 1. **上传前必过兼容性预检**（`POST /api/plugins/business` 会 409）；`trust` 只用于"已人工确认后放行"，别拿它盖住声明问题。
+> 2. **peer 版本范围必须跟随平台 dsh 版本**（当前 `0.1.2-rc.1`）—— 平台升版时同步改，否则 prerelease 规则会再次拒收。插件源码**并不 import** 这些包（只靠 `dsh.client.inject` 注入点），所以放宽范围无功能风险。
+- 触发：用户「**规划 `D:\dshworkspace\plugin_package` 整合成一个插件，可打包后由 admin 整体上传到 dsh 服务器插件，用户可以启用进行使用**」
+- 关联：档案 16（插件三层归属 + 投放/启停流程）、27（MCN 插件平台化评估，P0 清单来源）、34（启用探活 + 快照回滚）、36/38（铺开链路）、41（技能启停 API）、58（实例内存配额）、60（分区改名「功能管理」）、19 §C6 + 41（上传安全扫描）
+- 规划会话边界：本单由**规划会话**产出，只读普查了本机 `D:\dshworkspace\plugin_package`（未 ssh、未改码）
+
+---
+
+## 一、目标
+
+把 `D:\dshworkspace\plugin_package` 下的 **7 个自研插件整合成 1 个功能插件包**：admin 在门户一次性上传候选池 → 用户在实例设置「**功能管理**」分区启用一次 → 重启实例 → **全部功能可用**。
+
+**做完的判定**：一个**全新用户**启用该整合包并重启后，侧边栏入口 + 工作台各功能页逐个可用，journald 无 `duplicate loader entry id`、无崩溃循环；**并且业务技能随包自动就位**（见 §4.1）—— `$DSH_HOME/skills/` 出现 `mcn-short-video` 与 4 个业务子技能，**用户不需要另外上传或启用技能**。
+
+## 二、现状（2026-09-12 只读普查结论）
+
+| 包 | loader id | 体积 | client 行 | host 行 | 角色 |
+|---|---|---|---|---|---|
+| `dsh-plugin-mcn` | `mcn-nav` | 945K | **3045** | 3095 + 9 模块 | **宿主壳**（唯一声明 `dsh.client.inject=[runtime, sidebar]`） |
+| `dsh-plugin-douyin-accounts` | `douyin-accounts` | 55K | 666 | **9（空壳）** | 功能页 |
+| `dsh-plugin-douyin-account-detail` | `douyin-account-detail` | 67K | 877 | **9（空壳）** | 功能页 |
+| `dsh-plugin-douyin-video-detail` | `douyin-video-detail` | 39K | 496 | **9（空壳）** | 功能页 |
+| `dsh-plugin-mcn-schedule` | `mcn-schedule` | 54K | 253 | 483 | 功能页 + 定时任务 |
+| `dsh-plugin-social-workbench` | `social-workbench` | 37K | 150 | 218 | 外部服务守护（**Windows 本地**） |
+| `dsh-plugin-voxemw-cloud` | `voxemw-cloud` | 77K | 134 | 233 + 6 模块 + `web/app.html` | 云 API 面板 |
+
+### 2.1 结构性结论（**这是"必须整合"的真正理由**）
+
+**它不是 7 个平行插件，而是「1 个宿主壳 + 6 个功能页」。**
+
+- `dsh-plugin-mcn` 注册了 **25+ 条 `/mcn/api/*` HTTP 路由**、`inject = ["slots","sessions"]`、在 `sidebar.footer.action` 注册唯一入口，并提供两个**全局扩展点**：
+  - `window.__mcnEntries` —— **功能页注册表**（工作台首屏图标网格读它渲染，源注释写明"外部插件注册的功能入口，即插即用"）
+  - `window.__mcnNav` —— **页内路由**（`open(entryId, params)` / `openView(id)` / `back()`）
+- 其余 6 个包**全靠往 `__mcnEntries` 注册 + 被 `__mcnNav.open()` 打开**；三个 douyin 包的 host 面只有 **9 行空壳**，注释原文写着"数据复用 `dsh-plugin-mcn` 服务端注册的 `/mcn/api/*` 路由"。
+- ⇒ **拆开的状态下"逐个启用"本身就违背设计**：缺了 mcn，其余 5 个只是死链；反过来只启用 mcn 则功能残缺。**整合是回归正确形态，不只是图省事。**
+- 附注：`dsh-plugin-mcn` **没有** `defineTool` / `tools.register`（`grep` 实证 = 0）→ 它是 UI + HTTP 插件，**不给 agent 注册工具**；agent 侧能力只来自技能与 prompt。
+
+### 2.2 打包链路现状：**不存在，要新建**
+
+7 个包均**无 `scripts` 字段、无 build 脚本、无 `package/` 目录、无 tgz 产物**；`lib/*.js` 是**直接维护的产物**（client.js 顶部自带 `var module = {exports:{}}` 的 bundle 外壳）。→ 整合包必须**新建打包脚本**。
+
+### 2.3 需要一并处置的残留
+
+`dsh-plugin-mcn/lib/` 内有 **2 个 `.bak`**（`index.js.bak-20260906`、`index.js.bak3-20260906`）→ 会被打进包、加重体积并可能触发上传扫描告警。`docs/ui-check-home-fix/`（1.6M）与插件无关，不进包。
+
+## 三、范围
+
+| 区 | 对象 | 动作 |
+|---|---|---|
+| 新建 | `D:\dshworkspace\plugin_package\dsh-plugin-mcn-suite\`（**7 个原包原地保留**作回滚参照） | 整合包源码 |
+| 新建 | 整合包内 `skills/`（**技能原文 + `.manifest.json`**，来源 `C:\Users\Administrator\.dsh\skills\mcn-short-video`，11 MB / 711 文件） | 随包投放的业务技能，**按 §4.1 取舍表挑选**（不整包照搬） |
+| 新建 | 打包脚本（`scripts/build-mcn-suite.cjs` 或等价） | 产出 `dsh-plugin-mcn-suite-<ver>.tgz`（**tgz 内需 `package/` 前缀**，档案 25/28 教训） |
+| 改 | 整合包内的 host/client 代码 | §五 的 P0 适配 |
+| 平台侧 | 门户候选池 | 上传新包 + **下架旧 7 包**（防并存，见 §七） |
+| 文档 | 新建档案 + `INDEX §二` + `03-路线图` + `交接单/README §一` | 归档 |
+
+**明确不动**：❌ dsh 官方包与缓存（红线 R2）❌ 平台自建三 bundle（`portal-entry` / `business-plugins` / `workspace-scoped-picker`）❌ `/opt/dsh` 权限 ❌ 7 个原包源码（保留）❌ 不新增平台侧权限能力（不触发 R5）
+
+## 四、决策点（**已由用户 2026-09-12 拍板**）
+
+> 用户口径：「**A 按照最佳方案处理；B 按照你的建议处理 —— 业务技能能否打包到插件中一起安装和使用，不要分开管理！；C、D 按照最优方案处理**」
+
+| # | 决策 | 定稿 |
+|---|---|---|
+| 1 | `dsh-plugin-social-workbench` **进不进包** | ✅ **不进包**（采纳建议 A）。实测是 **Windows 本地服务守护**：`EASEL_DIR` 默认 `D:\dshworkspace\Easel`、可执行文件 `.venv/Scripts/easel.exe`、探针打 `127.0.0.1:7860`/`:18789`；平台实例里 ① 该 exe 不存在 ② `127.0.0.1` 已被档案 39 封（实测 BLOCKED）→ **必然不可用**。该入口在平台不投放，原包源码保留 |
+| 2 | `dsh-plugin-voxemw-cloud` 进不进包 | ✅ **进包**。凭据全程走 env（**无硬编码** ✓、`getPublicConfig` 已剥离 apiKey ✓），平台实例无该 env → 入口显示「未配置」，不崩 |
+| 3 | 整合后的入口形态 | ✅ **A＝保留 `__mcnEntries` 机制、多入口并列**（工作台首屏图标网格），client 面行为与现状一致 |
+| 4 | **业务技能投放** —— 用户明确要求 **打进插件包、一起安装使用、不分开管理** | ✅ **改为「技能随包投放」**，实现见 **§4.1**。**这推翻了规划会话原先"走门户技能管理分开投"的建议**，据此重设计 |
+| 5 | 包名与版本 | `dsh-plugin-mcn-suite` **v0.3.0**。**版本号必须每次递增**：同名同版本 tgz 即使内容变了，pnpm 也复用旧包（档案 18 踩坑 1） |
+
+### 4.1 技能随插件包投放（**用户要求：不分开管理**）
+
+**为什么可行**：技能发现位在**实例内** —— `dsh discoverRoot` 只扫 `$DSH_HOME/skills`（档案 41 §B 实测：启用/禁用靠目录 rename 即可**即时生效、无需重启**）；而插件的 host 面代码**就跑在实例内、以该用户 uid 运行** → **插件完全有能力自己把技能装到位**，不需要平台技能管理面参与。
+
+**机制（建议，执行会话按此实现）**：整合包内置 `skills/`（技能原文）+ `skills/.manifest.json`（技能名 → 版本 / 文件数 / sha256）。host 面在**每次实例启动**调用 `ensureSkills()`：
+
+1. 读 `.manifest.json`；对每个技能比对 `$DSH_HOME/skills/<name>/.installed.json` 记录的版本；
+2. **幂等**：版本一致 → 跳过（不重复写盘）；
+3. 版本不一致 → **全量替换**（先删后放，旧版已删除的文件一并清除 —— 与档案 11「apply 全量替换」同语义）；
+4. **不覆盖用户自建的同名技能**（目录存在但无 `.installed.json`）→ 跳过 + 写日志 + UI 提示"被同名技能占用"；
+5. 写加载标记 `[mcn-suite] skills ensured: [email protected], …`（回归看日志即可，档案 26 §建议）。
+
+**备选（更省事，但必须先实测）**：若 dsh 的 skill 扫描**认得目录软链**，可改用软链 `<DSH_HOME>/skills/<name>` → `<profile>/node_modules/dsh-plugin-mcn-suite/skills/<name>`，**升级插件即升级技能、零对账**。风险：symlink 是否被扫描/读盘正常要**实测**（档案 39 的教训：symlink 行为必须 realpath 级实测，别假设）。→ 执行会话先试软链，不行再退回"复制 + 版本对账"。
+
+**投哪些 / 不投哪些 —— 按「引用驱动」裁剪，不按"看着像资料"裁**（用户 2026-09-12 定「参考资料不需要」；规划会话随后实测引用关系，**发现三类"像资料"的其实是被引用的功能件**，故按下表执行）：
+
+| 内容 | 体积 | 引用实测 | 定稿 |
+|---|---|---|---|
+| 主技能 `mcn-short-video`（`SKILL.md` + `references/` + `references-add/` + `scripts/` + `帮助文档.md`） | ~1.3 MB | — | ✅ **投** |
+| 子技能 `mcn-dou-analysis` / `mcn-script-review` / `mcn-video-prompt` / `mcn-data-insight` 主体 | 主体 | 插件 prompt 正是引用这 4 个 | ✅ **投** |
+| **`mcn-data-insight/` —— 它本身是"技能集索引"，下挂 12 个二级子技能**（`douyin-top-account`(140K) / `douyin-account-diagnosis`(136K) / `douyin-rise-ranking`(76K) / `douyin-hot-trend`(72K) / `douyin-ai-feed` / `douyin-prohibited-word` / `playlet-douyin-feed` / `douyin-weekly-surge` / `douyin-works-crawler` / `douyin-content-surge` / `douyin-daily-hot` / `douyin-search`，**全部带 `SKILL.md`**） | **869 KB** | 插件的「榜单更新」任务依赖其中的 `douyin-top-account`；`workshop.js` 的赛道白名单同源 | ✅ **整块投**（这是"技能树"的第二层，**不是参考资料**；`find -maxdepth` 容易漏它，核对时注意层级） |
+| `mcn-dou-analysis/references/样例/`（`模板_旧梦留声机账号设定卡.svg` 19 KB + `参考_旧梦留声机_账号设定卡_长图版.png` **994 KB**） | 992 KB | **`references/feature/06_生成账号设定卡片.md:67` 写明"动手前必须先读"这两份** → **功能件，不是资料** | ✅ **保留**。用户说的"参考资料不需要"**不覆盖这一项**；若你仍要剔，则必须同改那条指令，否则留下死引用 |
+| `nuwa-skill-main/` **主体**（去掉 `examples/`） | **104 KB / 11 文件** | **被引为"主方法论"**：`feature/03_提炼账号设定.md:81`、`references/人设卡生成方法.md:186` | ✅ **保留** |
+| `nuwa-skill-main/examples/`（`trump-perspective/` 英文研究文档等） | ≈ **2.4 MB** | `人设卡生成方法.md:187-188` 引了 `examples/mrbeast-perspective/`（**未引 `trump-perspective`**） | ❌ **剔**。精确做法：只剔未被引的 `trump-perspective/`；若要连 `mrbeast-perspective` 一起剔，**必须同改那两行引用** |
+| `mcn-video-prompt/参考skills/`（seedance2.0-prompt-skill、script-writing-studio 上游全文） | **2.0 MB** | **实测 0 引用**（`grep` 命中 0）→ 纯资料 | ❌ **剔** ✓ —— 用户"参考资料不需要"指的就是这类 |
+| `browser-harness/`（整包 Python + 自带 venv + docs/png） | **2.3 MB** | **多篇 feature 要求"浏览器优先"**（`feature/01_获取账号信息.md:12`、`feature/02_获取视频.md:10`）+ 主 `SKILL.md` 有专章（L88/105-112） | ❌ **剔目录**，但**必须同步改文档**：写明「平台无浏览器（档案 38a 实测 Playwright 装不起来）→ 改走 MCP / 其它路径」，否则留下死引用，agent 会像档案 55 那样反复撞墙 |
+| `scripts/mcp-config.json` | 16 KB | 插件 MCP 依赖（功能必需部分 = URL） | ⚠️ **剔 `MYAI_FEISHU_APP_ID`（`cli_a84d0a47f93e1013`）、保留 URL**（`maiya-trans.youmanvideo.com`）；再按 §五#7 过扫描 |
+
+**裁剪后体积预期**：11 MB → **≈4.3 MB**（剔掉 6.7 MB：`参考skills` 2.0 + `browser-harness` 2.3 + `nuwa/examples` 2.4）。
+⚠️ **投的是整棵技能树，不是一个技能**：全树 **36 个 `SKILL.md` / 711 文件**（主技能 1 + 一级子技能 5 + `mcn-data-insight` 下 12 个二级子技能 + 更深层的参考技能目录）。**核对层级时别用浅 `find`**（规划会话首轮就是这么误判 `douyin-top-account` "缺失"的）。
+
+**裁剪必须机械校验（新增，防"剔完留死引用"）**：剔完跑一次**死引用扫描** ——
+
+```bash
+grep -rIn -E "参考skills|browser-harness|nuwa-skill-main/examples/trump|参考_旧梦留声机" <整合包>/skills/ \
+  | grep -v -E "已移除|无浏览器|不再使用"
+```
+
+期望：**只剩"已移除 / 已改走 X"这类说明行**（即上面要求改写的指令），**没有一条指向已删文件的活引用**。
+
+**⚠️ 与共享技能层互斥**：本单走"插件内投"后，**不要再把 `mcn-short-video` 投到平台共享技能层**（`bundledSkillDir`，档案 10/40）—— 两条通道同名会按 rank 抢，行为不可预测。详见 §七。
+
+**禁用 / 卸载语义（取舍，已定）**：插件被禁用（`disabled: true`）时**不删**已装技能（用户可能正在用），只在下次启用时按版本对账；**卸载插件**会留下技能残留 → 记为已知残留（清理走实例内「我的技能」或目录手工删）。
+
+### 4.2 技能落地方式（装到哪）与撞名规则（2026-09-12 用户提问定稿）
+
+**问题一：装到 `$DSH_HOME/skills/`，还是"就在插件内目录使用"？**
+
+关键事实：**dsh 的技能扫描根是一个固定集合**（个人 `~/.dsh/skills` rank300 / 项目级 `.dsh/skills` rank100 / `.agents/skills` rank200 / 平台注入的 `bundledSkillDir`，档案 10 §Skill 装载机制 / 档案 41 §B），**插件包目录（`profile/node_modules/<pkg>/skills/`）不在其中**。
+⇒ **"就在插件内目录使用"意味着 agent 无法按技能名加载**（skill 机制发现不了），只能靠 prompt 给绝对路径让它自己读 `SKILL.md`。
+
+| 方案 | 能否按技能名加载 | 副本/维护 | 备注 |
+|---|---|---|---|
+| **A 复制**到 `$DSH_HOME/skills/<name>` | ✅ 能 | 每用户一份 ≈4.3 MB；需版本对账 | 最简单确定；用户能在「我的技能」看到（但归插件管） |
+| **B 软链** `$DSH_HOME/skills/<name>` → 插件包内目录 | ✅ 能（**前提：实测 dsh 跟随 symlink**） | **零副本**；**升级插件即升级技能**，零对账 | 副作用：用户在「我的技能」里删/禁 → 断链或删链，需处理；**必须先实测**（档案 39 教训：symlink 行为必须 realpath 级实测，不许假设） |
+| **C 不落扫描根**，prompt 给"包内绝对路径"（插件运行时用 `import.meta.url` 算出） | ❌ 不能 | 零副本零对账 | 兜底方案：agent 用不了 skill 名；用户不可见、不可管理；每次 prompt 都要注入路径 |
+
+→ **定稿：B 优先（一条实测命令即可确认）；B 不通退回 A；C 仅作最终兜底。**
+
+**问题二：同名技能怎么处理（三层，按优先级）**
+
+| 场景 | 处理 | 理由 |
+|---|---|---|
+| 插件技能 ↔ **用户自建**同名 | **让位**：不覆盖，跳过 + 日志 + UI 提示"被你的同名技能占用" | 用户的东西优先；档案 41 已有"同名 409"的先例，不静默覆盖 |
+| 插件技能 ↔ **平台共享技能层**同名 | **互斥**：本单不投共享层；若共享层已有同名，插件让位并提示 | 共享层 rank 更高会压住个人层，静默失败比明说更糟（§4.1 互斥条） |
+| 插件技能 ↔ **另一个插件**同名 | **owner 标记 + 先到先得 + 冲突报错**：每份由插件装的技能写 `.installed.json`（`owner: <包名>@<版本>`、`skillVersion`、`sha256`）；安装前查目标目录 —— 无标记=用户自建→让位；`owner`=自己→按版本对账；**`owner`=别的插件→拒绝写 + 明确提示** | 多插件共存时行为可预测、冲突可见；**不建议给技能名加命名空间前缀**（要改所有 prompt，且用户看到怪名字） |
+
+**判定顺序（实现时按此写）**：`目标目录不存在` → 装；`存在且 .installed.json.owner == 本包` → 比版本，不同则全量替换；`存在但无 .installed.json` → 用户自建，让位；`存在且 owner == 其他包` → 拒绝 + 报错。
+
+## 五、平台化 P0 清单（**不修则"传上去也不能用"**）
+
+| # | 问题 | 实测位置 | 改法 |
+|---|---|---|---|
+| **1** | **`homedir()/.dsh` 硬编码** —— 平台实例的 DSH 家目录是 `$DSH_HOME`，不是 `~/.dsh` | `mcn/lib/config.js:6,28,68`；`mcn/lib/index.js:733,771,865,881,935,964,978,1124,1167,1496,1565,1630,1969,2143,2840`；`mcn-schedule/lib/index.js:11,27,84` | 统一 `const DSH_HOME = process.env.DSH_HOME` → `join(DSH_HOME, …)`。**注意三处子路径**：`storages/workspace.json`、`sessions/`、`profiles/`，都在 DSH_HOME 下 |
+| **2** | **技能路径硬编码** `~/.dsh/skills/mcn-short-video/subskills/<x>/` | `mcn/lib/index.js` 多处：1255、1565、1798、1813、1834、2078、2313、2364、2491、2546、2984、2986… | 改成**只报技能名**（`mcn-dou-analysis` 等），由 agent 自行解析（档案 27 P0-2）；技能**随包投放**（见 §4.1），prompt 里不再出现任何绝对路径 |
+| **3** | **`spawn("powershell", …)` 杀进程树 = Windows only** | `mcn/lib/index.js:919`（两个 `.bak` 同位置） | 平台是 Linux → 改 `process.kill(-pid, …)` / `pkill -P`，或直接删掉该清理分支（评估残留影响） |
+| **4** | **MCP `spawn(npx -y myai-mcp)` 每次现拉包** | `mcn/lib/mcp.js:21`、`config.js:14` | 平台侧**预装成包**（档案 27 P1），并确认实例内 **npm registry 可达**（档案 38a：仅云元数据端点被封，其余放行但只记日志） |
+| **5** | **`.bak` 混在 lib/** | `mcn/lib/index.js.bak-20260906`、`index.js.bak3-20260906` | 打包前剔除（构建脚本过滤 + `files` 白名单） |
+| **6** | **上传扫描可能误伤**（P0 阻断 / P1 告警） | 整包 | **打包后先本地 dry-run `src/web/security-scan.ts` 的规则**（P0：`/etc/shadow`、base64 解码执行、`nc -e`、`/dev/tcp` 反弹、fork 炸弹、给系统二进制加 setuid；P1：`child_process`、`vm`/`eval`/`new Function`、敏感 env、超长 base64、外部网络、隐藏目录）。已知 `child_process`（mcn spawn、social-workbench spawn）只会触发 **P1 告警、不阻断**，但要确认整包 **P0 = 0**。**注意技能原文里有大量代码示例/脚本，P0 风险比插件本身高** |
+| **7** | **技能原文里的凭据 / 平台情报**（随包投放新增） | `mcn-short-video/scripts/mcp-config.json`（实测含 `MYAI_FEISHU_APP_ID=cli_a84d0a47f93e1013` + 私域 URL `maiya-trans.youmanvideo.com`）、`scripts/MCN_CYLG_API.py`（命中 `key/token` 模式，**需逐个核对**）、`subskills/browser-harness/.env.example` | 入包前对 `skills/` 整目录做**凭据扫描**：`grep -riE "api[_-]?key|access[_-]?token|secret|password|passwd" skills/` → **真密钥一律剔除**（改 env 注入）；非密钥的平台情报（app id、私域域名）按最小必要原则剔除；结论写进档案 |
+| **8** | **插件 prompt 里的技能路径层级不符**（2026-09-12 复核，**更正规划会话先前的误判**） | 插件 prompt 写的是 `subskills/douyin-top-account`（`mcn/lib/index.js:3085`、`3086`；`mcn/lib/workshop.js:9,22`），**真实路径是 `subskills/mcn-data-insight/subskills/douyin-top-account/`**（少了一层）。技能本身**完整存在**（36 个 `SKILL.md` / 711 文件）—— 规划会话首轮的"缺失"结论是**搜索深度不够（`-maxdepth 5` 差一层）导致的误判，已更正** | 无需补文件；**并入 #2 一起修**：所有 prompt 改成**只报技能名**（`douyin-top-account`），由 agent 自己解析 → 层级问题自然消失。**打包前必跑**：`grep -rn "subskills/" lib/` 逐条核对是否与技能实际层级一致 |
+
+## 六、步骤（每步自带验证）
+
+1. **前置只读核查**：`git -C <平台代码> log -1`（取当前 HEAD 备写档案）/ `ls /opt/dsh/artifacts/`（看版本命名与 `package/` 前缀）/ 门户 `#/plugins` 候选池现有 7 包的实际状态（是否有人已启用）。
+   *验证*：拿到"候选池里有哪几个、谁在用"的事实清单。
+2. **决策与技能完整性**：§四 五个决策点已定稿；**另需向用户确认 §五#8 —— `douyin-top-account` 子技能的去向**（补进包 / 已废弃改 prompt / 走 MCP）。**该项未确认前不要打包**。
+3. **建包骨架**：`package.json`（name `dsh-plugin-mcn-suite`、version、`type: module`、`exports {".", "./client"}`、`dsh.bundle.patch`、`dsh.client.inject` = mcn 的 `[runtime, sidebar]` 并集）+ `cordis.patch.yml`（**只 1 条 `insert`**：`id: mcn-suite`）+ `lib/{index.js, client.js, host/*}`。
+   *验证*：`node --check` 全通过；`cordis.patch.yml` 里 insert 条目数 = 1（防 duplicate，档案 25）。
+4. **移植 host 面**：把 mcn 的 9 个模块 + mcn-schedule + voxemw(+决策 1 的 social-workbench) 收进 `lib/host/`，**保持路由前缀不变**（`/mcn/api/*`、`/voxemw/api/*`）→ client 面零改动。
+   *验证*：路由清单 diff：改前 25+ 条 vs 改后逐条一致（只增不减）。
+5. **合并 client 面**：一个 `client.js` 内注册全部 `__mcnEntries` 条目；`inject` 取并集；**确认无 `exports.default`**（红线 R3，实测 7 个原包全部合规 ✓，合并时别引入）。
+   *验证*：`grep -c "exports.default"` = 0。
+6. **P0 适配**（§五 1–5）+ 按需加**加载标记**：`console.log("[mcn-suite] loaded …")`（把回归从"看 UI"变成"看日志"，档案 26 §建议）。
+   *验证*：`grep -n "homedir()" lib/**/*.js` = 0；`grep -n "powershell"` = 0；`grep -rn "\.dsh/skills"` = 0。
+7. **本地 smoke**：参考 `dsh-plugin-voxemw-cloud/tests/smoke.mjs` 的写法，跑一遍 host 面（路由注册、DB 建表幂等、无 env 时降级不崩）。
+   *验证*：smoke 全绿；无 env 情况下进程不抛。
+8. **打包**：产出 `dist/dsh-plugin-mcn-suite-<ver>.tgz`，**内含 `package/` 前缀**，**不含 `.bak` / `node_modules`**。
+   *验证*：`tar tzf` 清单人工核对（顶层只有 `package/`）；体积与 `du` 对照；`md5sum` 记档。
+9. **扫描 dry-run**：按 §五#6 规则跑一遍 → **P0 必须为 0**；P1 告警逐条判断是否误报。
+10. **上传**：admin 门户 `#/plugins` 上传 tgz → 进候选池（默认禁用）。**产物不要复制进用户 ws**（档案 28 平台污染教训）。
+    *验证*：候选池列表出现该包 + 版本号正确。
+11. **切换（关键，防并存）**：① 先在候选池**下架旧 7 包** ② 用户实例「功能管理」启用新包 ③ 确认弹窗 → 重启实例 ④ 走 `restartAndProbe` 探活（档案 34）。
+    *验证*：§八 C–F。
+12. **实测验收 + 资源**：逐功能页点开；用 `scripts/probe-instance-mem.cjs` 量**私有内存与启动时间**（档案 58 预算：`MemoryMax 384 MiB` / 堆 256）。
+    *验证*：§八 D、G。
+13. **归档**：新建档案（**原子占号** `mkdir 04-调整方案/.lock-<NN>`）→ 更新 `INDEX §二` / `03-路线图` / `交接单/README §一` → 本单 `git mv` 到 `archive/交接单-已完成/`。
+    *验证*：`docs-audit.py` 退出码 0。
+
+### 6.1 技能随包的额外步骤（并入上面第 3、6、8、10 步，不另起编号）
+
+- **建包阶段（并入第 3 步）**：按 §4.1 **引用驱动**裁剪（不是"看着像资料就删"）→ 放整合包 `skills/<name>/`；生成 `skills/.manifest.json`（名称 / 版本 / 文件数 / sha256）；剔完跑 §4.1 的**死引用扫描**。
+  *验证*：`du -sh skills/` ≈ **4.3 MB**（而不是 11 MB）；`tar tzf` 确认**没有** `参考skills/`、`browser-harness/`、`nuwa-skill-main/examples/trump-perspective/`；**确认有** `mcn-dou-analysis/references/样例/`（含 994 KB 长图）、`nuwa-skill-main/SKILL.md`、**`mcn-data-insight/subskills/douyin-top-account/`**（这三块都是被引用的功能件，不能剔）。
+- **改码阶段（并入第 6 步）**：实现 `ensureSkills()`（§4.1 五步）+ 加载标记；把 `mcn/lib/index.js` 的 13+ 处**技能绝对路径改成技能名**。
+  *验证*：`grep -rn "\.dsh/skills" lib/` = 0；`grep -rc "ensureSkills" lib/` ≥ 1。
+- **打包阶段（并入第 8 步）**：`skills/` 整体进包（`package.json` 的 `files` 白名单必须包含 `skills`）。
+  *验证*：`tar tzf dist/*.tgz | grep -c "package/skills/"` ≈ 技能文件总数（数百）。
+- **上线阶段（并入第 10 步）**：上传 → 用户启用 → 重启 → 按 §八 J/K 验技能就位。
+
+### 6.2 收尾顺带（D 组：两处文档漂移 —— 用户已定「并进 T03 收尾」）
+
+- **`BRIEF.md:20`**：`scope（512M / 150% / TasksMax 128）` → **`384M`**，并补 `NODE_OPTIONS=--max-old-space-size=256` 与 `NODE_COMPILE_CACHE`（档案 58 实测）。
+- **`03-路线图与待办.md`**：头部仍是 09-11 21:20 合并版、**档案 57-61 完全未登记** → 补登记 + 刷新头部状态行；`BRIEF §3` 待办同步。
+  *验证*：`grep -n "384M" BRIEF.md` 命中；`grep -nE "档案 (60|61)" 03-路线图与待办.md` 命中（**写成 `(60|61)` 而不是字符类**：`档案\s*6[01]` 这种写法会被 `docs-audit.py` 的引用正则匹配成裸旧号 `6` → 永久悬空，T02 已踩过一次）。
+
+## 七、风险与红线
+
+**🔴 头号风险：新旧包并存 → 实例崩**
+若某用户同时在位"旧 7 包"与"新整合包"，会出现：`/mcn/api/*` 路由**重复注册**、`sidebar.footer.action` **重复注册**、`__mcnEntries` **重复条目**；严重时 `duplicate loader entry id` → **崩溃循环**（档案 25 有真实前例，靠档案 20 熔断才拦住，但用户会看到死页面）。**四道防线必须全做**：
+1. 新包用**全新 loader id**（不复用 `mcn-nav` 等 7 个旧 id）；
+2. 门户候选池**下架旧 7 包**（或标 deprecated，并在包描述写明替代关系）；
+3. 切换按 §六 步骤 11 的顺序执行（先禁用旧 → 再启用新）；
+4. 新包 host 面加**防御**：启动时检测旧 id 是否同时在位 → 命中则**拒绝启动并写明确日志**（宁可这个包不工作，也不要崩实例）。
+
+**其余**
+- 内存/启动（档案 58）：合并后单实例加载模块更多，**必须实测**，超预算就按需懒加载或砍 social-workbench。
+- 网络（档案 38a）：实例出网只记日志不拦（元数据端点已封）→ MCP `npx`、voxemw 云调用可达性要用**实测**确认，别假设。
+- **技能同名互斥**（§4.1）：插件投的技能、平台共享技能层、用户自建技能**三方可能同名** → ① 本单**不投共享技能层**；② 用户自建同名时插件**跳过并提示**；③ 若日后要改投共享层，必须先撤掉插件内投放。
+- **技能随包的体积成本**：约 1.5–2 MB × 每用户一份（用户已明确"不分开管理"，接受该冗余）；日后要省可改软链方案（§4.1 备选）。
+- 红线：R2 不改官方 dsh 包（只走 bundle + patch）✓；R3 client 禁 `exports.default` ✓；R5 本单不扩大平台权限 ✓；不自动升级 dsh ✓；**未获明确授权不 commit / push**。
+
+## 八、验收
+
+| # | 命令 / 动作 | 期望 |
+|---|---|---|
+| A | `tar tzf dist/*.tgz \| head` ；`md5sum` | 顶层只有 `package/`；无 `.bak`、无 `node_modules`；md5 记档 |
+| B | 上传扫描 dry-run | **P0 = 0**；P1 逐条有结论 |
+| C | 门户 `#/plugins` 上传 | 进入候选池、默认禁用、版本号正确 |
+| D | 全新用户：启用 → 确认弹窗 → 重启 | 侧边栏入口出现；工作台首屏功能入口**逐个可打开** |
+| E | `journalctl -u dshs --since '10 min ago' \| grep -E "mcn-suite\|duplicate"` | 有 `[mcn-suite] loaded`；**无** `duplicate loader entry id`；无崩溃重启 |
+| F | 启用探活（档案 34） | 探活通过；失败时快照回滚不误伤好插件 |
+| G | `scripts/probe-instance-mem.cjs` | 私有内存 + 启动时间在档案 58 预算内（写实测值） |
+| H | 候选池 | 旧 7 包已下架/标 deprecated；**不存在"新旧同时可启用"的状态** |
+| I | **技能随包就位**（§4.1） | 全新用户启用 + 重启后：`ls $DSH_HOME/skills/` 出现 `mcn-short-video` 与 4 个业务子技能；`journalctl` 有 `[mcn-suite] skills ensured: …` |
+| J | 技能可用（agent 侧） | 实例内让 agent **按技能名**加载（如「调用 mcn-dou-analysis」）→ 能解析到，**无需给绝对路径** |
+| K | 幂等 / 不覆盖 | 再重启一次 → 技能**不被重复写**（`.installed.json` 版本一致则跳过）；人为放一个同名自建技能 → 插件**跳过并提示**，不覆盖 |
+| L | 凭据（§五#7） | `skills/` 凭据扫描：**真密钥 0 命中**；app id / 私域域名的处置有明确结论并写进档案 |
+| M | D 组文档（§6.2） | `BRIEF.md` 已更正为 384M；档案 57-61 已在 `03-路线图` 登记 |
+| N | **裁剪后引用完整性**（§4.1 死引用扫描） | 只剩「已移除 / 已改走 X」的说明行；**无一条指向已删文件的活引用**（`browser-harness` 相关的"浏览器优先"指令必须已改写） |
+| O | 包体积与技能树 | `skills/` ≈ **4.3 MB**（已剔 6.7 MB）；含全部 **36 个 `SKILL.md`**（主技能 + 5 一级子技能 + `mcn-data-insight` 12 个二级子技能）；**保留了** `references/样例/`（992 KB）、`nuwa-skill-main/SKILL.md`、`mcn-data-insight/subskills/douyin-top-account/` |
+| P | 技能落地方式（§4.2） | 按 B（软链）先实测；不通则用 A（复制）。**两种都必须能被 skill 机制按名加载**（不是靠 prompt 给绝对路径） |
+| Q | 撞名处理（§4.2） | 用户自建同名 → 让位并提示 ✅；平台共享层同名 → 互斥并提示 ✅；别的插件已占 → **拒绝写并报出 owner** ✅（验证：人为造这三种场景各跑一次） |
+
+## 九、回滚
+
+- **包级**：候选池删新包 → 重新上架旧 7 包 → 用户逐个启用 → 重启（**这是为什么原包源码与 tgz 都要留档**）。
+- **实例级**：走档案 34 的 `restartAndProbe` 快照回滚；或直接禁用新包重启。
+- **本单不改平台代码** → 无平台侧回滚；若为铺开改了 `ensure-*` 脚本，按 `.bak-<ts>` 还原 + 重启。
+
+## 十、回报格式（执行会话填）
+
+```
+## T03 执行回报
+- 决策 1–5 选定：<逐条，谁确认的>
+- 整合包：name/version = ?  体积 = ?  路由数 25+N  入口数 = ?
+- P0 适配：homedir() 残留 0 ✅ / powershell 残留 0 ✅ / .dsh/skills 硬编码 0 ✅ / .bak 已剔 ✅
+- 打包与扫描：tgz md5 = ?  P0 = 0  P1 = ?（逐条结论）
+- 上传与切换：候选池版本 ?  旧包下架 = 是/否  启用+重启 ✅  探活 ✅
+- 实测：私有内存 ? MiB / 启动 ? s（对照档案 58 预算）
+- 验收：A–I 逐项 ✅（未过项写现象）
+- 证据：<journald loaded 标记 + duplicate 检查输出 + 内存采样>
+- 偏离：<…；无则写"无">
+```
+
+## 十一、不在本单
+
+- 业务技能内容本身的维护/改版（只做"投放到位"）
+- voxemw 云链路接线（档案 12 的 M1 后段）
+- Easel / social-workbench 的平台化改造（决策 1 选 C 才需要，另立单）
+- 平台「功能管理」分区的其它 UI 调整（档案 57/60 已闭环）
+
+---
+
+## 九、验收结果（2026-09-13 09:5x · **只读取证，服务器实测**）
+
+> 口径：§八 逐项核对；能只读证的全跑了，需要浏览器/造场景的明确标出。
+
+| # | 项 | 结果 | 实测证据 |
+|---|---|---|---|
+| A | 包结构 | ✅ | 池内 tgz md5 `2ff1a2fa775891085949d50452394fa0` / 1,953,267 B / **v0.3.9**；顶层仅 `package/`；`node_modules` **0**、`.bak` **0** |
+| B | 上传扫描 | ✅（P0） | `[upload-scan] blocked=0 warnings=118`（**warnings 逐条结论未做**） |
+| C | 候选池上传 | ✅ | 池内 `dsh-plugin-mcn-suite @0.3.9`（09-13 00:02） |
+| D | 启用→重启→入口 | ⚠️ **未验**（需浏览器逐个点开入口） | — |
+| E | 加载日志 | ✅ | `[mcn-suite] loaded v0.3.0（host 面 3 个：mcn, mcn-schedule, voxemw-cloud）`；**`duplicate loader entry id` = 0**；同期无崩溃 |
+| F | 启用探活 | ⚠️ 未单独验（但**平台已自动回滚过一次** ⇒ 该链路是活的，见 07:42–07:46 事故） | — |
+| G | 内存 | ⚠️ 偏紧 | guest 峰值 **382 / 上限 384 MiB**；admin 峰值 321 / 384（档案 74 采样） |
+| H | 旧 7 包下架 | ✅ | 池内只剩 `mcn-suite` + `univer-office` 两个；无新旧并存 |
+| I | 技能随包就位 | ✅ | 落点 = **`<home>/skills/mcn-short-video`**（4.6 MB，含 4 个一级子技能）；journal `[mcn-suite] skills ensured …` |
+| J | agent 按技能名加载 | ⚠️ 未验（需实例内跑一次 agent） | — |
+| K | 幂等/不覆盖 | ✅ | `skills ensured: 跳过 [email protected](版本一致)` |
+| L | 凭据扫描 | ⚠️ 未验 | — |
+| M | D 组文档 | ✅ | `BRIEF.md` 已是 384M（档案 58 收尾时改） |
+| N | 裁剪后引用完整性 | ⚠️ 未验（需跑死引用扫描） | — |
+| O | 包体积与技能树 | ⚠️ **口径待核** | 实测 **4.4 MB / 18 个 SKILL.md**（主 1 + 一级 4 + `mcn-data-insight` 下 13）；§八 原文期望 **36 个 SKILL.md** ⇒ 差异需确认为"包被裁剪"还是"口径过时" |
+| P/Q | 软链落地 / 三种撞名场景 | ⚠️ 未验（需造场景） | — |
+
+**结论**：**主体已通过（8 项实证）**；未验的 6 项（D/J/L/N/P·Q）都属"需浏览器或需造场景"，可以另找时间补，**不阻塞投放**。
+
+**⚠️ 一条必须记的事实（guest 那次尝试）**：2026-09-13 **07:42:52** guest 在「功能管理」提交启用 →
+实例 **07:43–07:45 连崩 5 次**（`exitCode=134`，栈 = V8 `JsonParser`/`HeapAllocator` ⇒ **V8 堆打满**）→ 07:46 熔断 →
+平台**自动回滚**（`package.json.bak-rollback-20260913T0748`）⇒ 现在 guest bundles 里**没有** mcn-suite。
+根因指向 `--max-old-space-size=160` 太紧（档案 74）+ guest cgroup 峰值贴顶 ⇒ 详见 `04-调整方案/74` 文末「现场反证」。
+**admin 侧**自 09-13 00:02 起一直启用且各项实证通过（上表 A/E/I/K 均取自 admin）。
+
+---
+
+## 十、收尾记录（2026-09-13 18:0x）
+
+### 本轮补齐的 gap
+
+| 项 | 结果 |
+|---|---|
+| **guest 启用**（原「剩余」第 1 条，单子长期卡点） | ✅ **已完成** —— `POST /api/plugins/mine/apply` `{id: dsh-plugin-mcn-suite, enabled: true}` → 任务 **`c20739a6dbe8975c`** → `status=success` / `stage=完成` / **`restarted=true`**；启用后 bundles 含 `dsh-plugin-mcn-suite` ✓ |
+| 容量前置（07:4x 崩溃的根因） | ✅ **已解除** —— 档案 79 两处 P0 已修；R1-④ 动态配额生效（guest 装前 672 MiB → 装后 **800 MiB**）⇒ 「V8 堆打满 abort → 自动回滚」不再复现 |
+| §八 **L** 凭据扫描 | ✅ **通过** —— `ak_`+32hex **0**、`sk-` **0**、`app_id=` **0**、`*.alotbuy.com` **0**；125 处命中均为变量名/文档说明；唯一 32+hex 是 `.manifest.json` 的**文件哈希** |
+| §八 **O** 包体积与技能树 | ✅ **通过（口径澄清）** —— SKILL.md 实测 **18** 个；§八 原文期望「36」系**笔误**（主 1 + 一级 4 + `mcn-data-insight` 下二级 13 = 18，与文字描述完全吻合）。包总 4.27 MB / skills 3.55 MB |
+| §八 **P** 技能落地形态 | ✅ **通过** —— admin 实例 `skills/mcn-short-video` = **实体目录**（18 个 SKILL.md / 4.6 MB）⇒ 走 §4.2 的 **A（复制）兜底路径** |
+| §八 **N** 死引用扫描 | ⚠️ **未定判** —— 自动扫描出 63 处「包内路径对不上」，但抽样 8 个里 **5 个是误报**（引用省略 `references/` 前缀，文件其实在）；**内容基本齐全**（16 个 `scripts/` 目录、27 个 `.py`、263 个 `.md`，知识库 12 类齐全）⇒ **不能判不合格**，需人工逐条读；**不阻塞投放** |
+| §八 **D / J / Q** | ⏸ **未验**（需浏览器或造场景）；按 §九 口径 **不阻塞投放** |
+
+### 归档
+
+- 本单主体目标已达成 ⇒ 按流程移入 `archive/交接单-已完成/`，并在 `INDEX.md §四` 与 `交接单/README.md §一`、`03-路线图与待办.md §二` 三处同步状态。
+- **遗留（可选，不阻塞）**：D（实例内入口逐个点开）/ J（agent 按技能名加载）/ Q（三种撞名场景）/ N（死引用逐条人工判定）。

dsh-server-docs/archive/交接单-已完成/T04-并发治理落地-commit常态化与服务器侧锁.md

@@ -0,0 +1,174 @@
+# T04 · 并发治理落地（A 组三项：commit 常态化 / 服务器侧锁 / 权限统一）
+
+- 日期：2026-09-12
+- 状态：✅ **已完成**（2026-09-12 15:10；①②③④ 全部落地，验收 A–G 见 §八 回报）
+- 触发：用户「多 AI 会话同时执行迭代服务器项目，解决冲突」+ 2026-09-12 当天 **3 次实证**事故
+- 关联：`交接单/README.md §一`（占用锁）`§三`（硬要求 0/⑤/⑥/⑧/⑨）`§六`（服务器侧锁提案）、`scripts/handoff-guard.sh`（已就位）、档案 58/59（重启引发用户掉线）、档案 52（`/opt/dsh` = `drwx------ root`）
+- 规划会话边界：本单由**规划会话**产出（未 ssh、未执行任何落地动作）
+
+---
+
+## 〇、执行进度（2026-09-12 11:50 规划会话核查，**如实记录，勿重复劳动**）
+
+| 项 | 状态 | 证据（实测） |
+|---|---|---|
+| **① 文档库 commit 常态化** | ✅ **已实质完成（非本单执行，由并行会话按 §三④ 落地）** | 文档库 HEAD 已从 `43e4ae9` 推进到 **`b06f7dd`**，09:06–09:28 共 **5 次提交**（`96f8ef8` 基线：档案 57-61 + T02 收尾 → `be42155` 档案 62 → `b06f7dd` manifest 刷新）；未提交项 **26+ → 13** |
+| **① 的收尾** | ⏳ **剩 13 项未提交**（含我方的 `交接单/README.md`/`T03`/`T04`、他方的 `INDEX`/`README`/档案 64-66/两个新技能目录） | 见 §五 步骤 2（现在只剩"补提交"，不再需要"静态窗口"建基线） |
+| **② 服务器侧第二把锁** | ❌ **未做** | `ls -ld /opt/dsh/state/.op-lock` → **No such file or directory** |
+| **③ 交接单目录权限统一** | ❌ **未做** | 实测：目录 **755**（应 700）、`README.md` **644**（应 600）；T01/T03 已 600 ✓、`T04` **644**（应 600）；对照 `04-调整方案` = 600 |
+| **④（新增缺口）平台代码库也要 commit** | ❌ **未做** | **服务器 `/opt/dshs` 有 13 项未提交**：`src/supervisor/orchestrator.ts`、`src/supervisor/proxy.ts`、`web/portal.html`、`scripts/ensure-biz-plugins.cjs`、`ensure-workspace-picker.cjs`、`poc/business-plugins/*`、新增 `scripts/ensure-anysearch-{admin,pool}.cjs` 等；代码 HEAD 仍 `ebe8075`（档案 56）→ **这 2 小时的改造只存在于服务器工作区**，同样"没有 git 路标"，且有误操作丢失风险 |
+
+> ⇒ **本单范围更新为：②③④**（① 已完成，仅剩补提交）；**顺序建议：④ → ② → ③**（代码未提交是当前最高风险）。
+
+### 〇.1 ✅ 完成记录（2026-09-12 15:10，exec-session-C 执行）
+
+| 项 | 最终状态 | 证据 |
+|---|---|---|
+| **① 文档库 commit** | ✅ **完整闭合** | 两个提交：`f14d4e1`（收口：登记档案 57–68 + 6 处记账修正）、`229a762`（补提交积压资产）；**`git status --short` 已完全干净（0 项）**；未 push |
+| **② 服务器侧第二把锁** | ✅ **已建 + 已实测** | `/opt/dsh/state/.op-lock/`（root:root **700**，内含使用约定 `README`）；工具 `scripts/op-lock.sh`（claim/release/status）**往返实测通过**；`handoff-guard.sh` 新增**【1d】**分支并**两态验证**（无锁 → ✓；造锁 → 🔴 + OWNER 详情 + 硬失败；release → 清空）。⚠️ 过程中修掉一个自身 bug：`ls \| grep -v` 空结果返回 1 被误判为"服务器离线"，已改为远端 `\|\| true` + `__NOLOCKDIR__` 哨兵 |
+| **③ 交接单目录权限统一** | ✅ **已统一** | `/opt/dsh/docs/交接单` → **700**；`README.md`/`T01`/`T03`/`T04` 四份 → **600**；对照 `04-调整方案` = 700 ✓。⚠️ **属主未统一**：交接单目录与三份文件属主为 `197108:197121`，仅 `T04` 是 `root:root`（本单只授权 chmod，未做 chown —— R7 禁批量 chown，留待确认） |
+| **④ 平台代码库 commit** | ✅ **已闭合** | 服务器 `/opt/dshs`：`ebe8075` → **`06e63ac`**，`status --short` 计数 **0**；13 项逐条 add（禁 `-A`）；未 push（服务器无 Gitea 凭据） |
+| **④ 的后续：带回本机镜像** | ⏸ **未做（已分叉，需单独处理）** | 本机 `D:\github\dsh_shenxian` HEAD = **`0e141a4`**（含 `3567226`），**且自身有 10+ 项未提交改动** → 与服务器工作区**双向分叉**，`merge --ff-only` 必然失败；属"两仓内容取舍"决策，**不在本单强行动手**（详见 §八 回报「偏离」） |
+
+---
+
+## 一、目标
+
+把已拍板的三项治理落到**可机械执行**的状态：
+
+1. **文档库 git 提交常态化**：先建一次**基线提交**（给后续会话留下"谁刚改了什么"的路标），此后**每次改完只提交自己改的文件**；
+2. **服务器侧第二把锁**：给「平台高危操作」加显式互斥（重启 / drain / 改 env·quota / 铺插件 / 改 nginx·nft·证书）；
+3. **权限统一**：`/opt/dsh/docs/交接单/` 对齐归档口径（目录 700、文件 600）。
+
+**做完的判定**：`git -C dsh-server-docs log -1` 不再是 09-11；`bash scripts/op-lock.sh status` 可查占用；`stat` 确认 `/opt/dsh/docs/交接单` 为 700 且三份文件 600。
+
+## 二、只读前置
+
+| # | 核实 | 命令 | 期望 |
+|---|---|---|---|
+| 1 | 文档库当前 HEAD 与未提交量 | `git -C dsh-server-docs log --oneline -1` + `git -c core.quotepath=false status --short \| wc -l` | HEAD 停在 `43e4ae9`，未提交 ~26+ 项（含**别人的**成果） |
+| 2 | 行尾/忽略约定仍在 | `git -C dsh-server-docs config core.autocrlf` + `cat .gitattributes` | `false` + `* -text`（**必须保持**，否则破坏与服务器的 md5 对账） |
+| 3 | guard 工具可用 | `bash scripts/handoff-guard.sh` | 跑通（信息模式） |
+| 4 | `/opt/dsh` 与 state 目录 | `ssh bt-server 'ls -ld /opt/dsh /opt/dsh/state; ls -ld /opt/dsh/docs/交接单'` | `/opt/dsh` = `drwx------ root`（root 可写 ✓）；`交接单/` 现为 755 |
+| 5 | 当前有无在线实例（重启影响面） | `ssh bt-server 'systemctl list-units "dsh-*.scope" --no-legend'` | 拿到"重启会打断谁"的事实（R8 红线：**执行前必须知会用户**） |
+
+## 三、范围
+
+| 区 | 对象 | 动作 |
+|---|---|---|
+| 文档库 git | `dsh-server-docs`（本机，**不 push**） | 一次基线提交 + 此后每次只提自己的文件 |
+| 新建 | `scripts/op-lock.sh`（本机文档库 `scripts/`） | 服务器侧操作锁：`claim / release / status` |
+| 服务器 | `/opt/dsh/state/.op-lock/` | 锁目录（root 可写）+ 使用约定 |
+| 服务器 | `/opt/dsh/docs/交接单/` | `chmod 700` 目录、三份文件 `chmod 600` |
+| 文档 | `交接单/README §六`（由"提案"改为"已实施"）+ 新档案 + `INDEX §二` + `03-路线图` | 归档 |
+
+**明确不动**：❌ 不改任何平台运行代码 ❌ 不重启服务 ❌ 不 push ❌ 不动 `04-调整方案/` 下别人的未提交成果 ❌ 不引入 `git add -A`（红线）
+
+## 四、决策点（**已定，无需再问**）
+
+| # | 决策 | 定稿 |
+|---|---|---|
+| 1 | 是否授权本机 commit | ✅ **授权**（用户「A 按最佳方案」）。**限定：只 `git add` 明确列出的文件；不 push**（推送仍需用户明说） |
+| 2 | 服务器侧锁落哪 | ✅ `/opt/dsh/state/.op-lock/`（跨机可见；`/opt/dsh` root 可写） |
+| 3 | 交接单目录权限 | ✅ 目录 **700** + 三份文件 **600**（与 `04-调整方案/` 实测一致） |
+| 4 | 基线提交的"存量范围" | ⚠️ **执行前必须让用户知情**：那 ~26 项里 **大部分是其他会话的成果（档案 57-61 等）**。提交 ≠ 抢功（只是留路标、不 push），但**范围要一次说清** → 见 §五 步骤 2 的"两选一" |
+
+## 五、步骤（每步自带验证）
+
+1. **静态窗口确认（关键）**：基线提交期间**不能有人在改库**。
+   *做法*：`bash scripts/handoff-guard.sh`（看占用/热点）+ 口头确认另一个会话已停手。
+   *验证*：guard ① 无他人占用锁；③ 无"我的目标文件被他人动过"之外的异常。
+2. **基线提交（两选一，按用户口径执行）**：
+   - **A（推荐，一次性干净）**：把当前全部未提交内容作为**一个基线提交**（含他人成果）——
+     `git -c core.quotepath=false add <按 status 逐条列出的路径>`（**逐条列，不用 `-A`**）→ `git commit -F <消息文件>`。
+     消息示例：`docs: 基线快照（档案 57-61 + T02 归档 + guard 工具；不含 .git/ 与 .bak）`
+   - **B（最小侵入）**：只提交**自己那批**（`交接单/` + `scripts/`），他人的留在工作区不动 —— 代价是"路标"仍不完整。
+   *验证*：`git log --oneline -1` 已是新提交；`git status --short` 剩余项**全部是他人的**且数量可解释。
+3. **写 `scripts/op-lock.sh`**（约 40 行，只做三件事）：
+   - `claim <操作名> "<影响面/时长>"` → `ssh bt-server "mkdir /opt/dsh/state/.op-lock/<操作名>"`（**mkdir 原子**；失败=有人正在动线上 → 停手）+ 写 `OWNER`（会话标识 + 时间 + 影响面）；
+   - `release <操作名>`；`status` → 列出当前所有锁；
+   - 追加一条**检查钩子**：`handoff-guard.sh` 的 ① 增加"服务器侧锁"分支（服务器不可达时只提示不失败，避免离线阻塞）。
+   *验证*：`claim` 两次 → 第二次失败并报出占用者；`release` 后 `status` 为空。
+4. **建立"必须先占位"的操作清单**（写进 `交接单/README §六`）：重启 `dshs` / drain / 停 `dsh-*.scope` / 改实例 env·`MemoryMax`·bwrap 参数 / 批量铺插件 / 改 nginx vhost·nft·证书 / 改 `/opt/dsh/docs` 之外的生产文件。
+   *验证*：清单可 1:1 对应到 §六 表。
+5. **权限统一**：`ssh bt-server 'chmod 700 /opt/dsh/docs/交接单 && chmod 600 /opt/dsh/docs/交接单/*.md'`。
+   *验证*：`stat -c "%a %n"` 全部符合；`ls -l` 与 `04-调整方案/` 对比一致。
+6. **文档收口**：`交接单/README §六` 由"提案"改"✅ 已实施"；新建档案（**原子占号** `mkdir 04-调整方案/.lock-<NN>`）；更新 `INDEX §二` / `03-路线图` / `交接单/README §一`；本单 `git mv` 到 `archive/交接单-已完成/`。
+   *验证*：`python3 scripts/docs-audit.py` 退出码 0 + `MINE="…" PUSH=1 bash scripts/handoff-guard.sh` 放行。
+
+### 5.1 平台代码库提交（④ —— **优先级最高**；2026-09-12 新增）
+
+**为什么**：服务器 `/opt/dshs` 有 **13 项未提交**（含 `src/supervisor/orchestrator.ts`、`proxy.ts`、`web/portal.html`、`scripts/ensure-biz-plugins.cjs`、新增 `ensure-anysearch-*.cjs` 等），代码 HEAD 仍停在 `ebe8075`。**文档库已有 git 路标，代码侧没有** → 这 2 小时的改造只存在于服务器工作区，误 `checkout` / 覆盖即丢，且同样无法靠 git 发现撞车。
+
+**怎么做（沿用项目既有链路，勿发明新路径）**：
+1. 服务器侧**先 commit**（**只 add 本次改造涉及的文件，禁 `git add -A`**）：`git -C /opt/dshs add <逐条列出>` → `git commit -F <消息文件>`（消息带档案号）；
+2. 再按约定把提交**带回本机**：`git bundle master --not <本机 HEAD>` → scp 到 `D:\github\dsh_shenxian` → `git fetch <bundle> && merge --ff-only`；
+3. **push 到 Gitea 需用户明确说"推送"**（红线，本单不授权 push）；
+4. 确认服务器工作区干净：`git -C /opt/dshs status --short | wc -l`。
+
+**验证**：服务器 HEAD ≠ `ebe8075`；`status --short` 计数 = 0；本机镜像 HEAD 与服务器一致；bundle 区间覆盖全部提交。
+
+## 六、验收
+
+| # | 命令 | 期望 |
+|---|---|---|
+| A | `git -C dsh-server-docs log --oneline -3` | 出现 2026-09-12 的基线提交，HEAD ≠ `43e4ae9` |
+| B | `git -C dsh-server-docs status --short` | 剩余项**全部可解释**（他人的/未完成的），无"幽灵"未知项 |
+| C | `bash scripts/op-lock.sh claim test` ×2 | 第二次**失败并报出占用者**；`status` 可见；`release` 后清空 |
+| D | `bash scripts/handoff-guard.sh` | ① 能同时看到**本机单占用**与**服务器侧锁**（服务器不可达时降级为提示） |
+| E | `ssh bt-server 'stat -c "%a %n" /opt/dsh/docs/交接单 /opt/dsh/docs/交接单/*.md'` | 目录 **700**、三份文件 **600** |
+| F | `bash scripts/docs-sync-check.sh` | 双端一致（本次只改权限，内容不变） |
+| G | 归档（§五 步骤 6） | `docs-audit.py` 退出码 0；`交接单/README` 与 `03-路线图` 已回填 |
+
+## 七、回滚
+
+- **commit**：`git reset --soft HEAD~1`（保留工作区）即可撤销基线提交；**不要** `--hard`。
+- **权限**：`chmod 755 /opt/dsh/docs/交接单 && chmod 644 /opt/dsh/docs/交接单/README.md && chmod 600 /opt/dsh/docs/交接单/T0*.md`（回到现状）。
+- **锁脚本**：删 `scripts/op-lock.sh` + `rmdir /opt/dsh/state/.op-lock/*`；`交接单/README §六` 改回"提案"。
+
+## 八、回报格式（执行会话填）
+
+```
+## T04 执行回报
+- 基线提交：选择 A / B；commit = <hash>；纳入 <N> 个文件；剩余未提交 <M> 个（说明构成）
+- 静态窗口：确认无人在改（依据：guard 输出 + 谁确认的）
+- 锁脚本：claim 重复 → 失败 ✅；status / release ✅；guard 已接入服务器侧锁 = 是/否
+- 必须占位的操作清单：<条数>
+- 权限：目录 <新值> / 文件 <新值>（含 stat 输出）
+- 验收：A–G 逐项 ✅（未过项写现象）
+- 偏离：<…；无则写"无">
+```
+
+## 九、不在本单
+
+- 是否把 `handoff-guard.sh` 接入 CI 或 cron（另行评估）
+- 服务器侧"操作审计日志"（本单只做互斥，不做审计）
+- 平台代码侧的并发改动（本单零代码改动）
+
+---
+
+## 十、执行回报（实际填写，2026-09-12 15:10）
+
+```
+## T04 执行回报
+- 基线提交：选择 A + 拆成两个提交（① 收口 / ② 补提交积压）
+  · f14d4e1 docs(收口): 登记档案 57–68 + 修正 6 处记账滞后（8 文件）
+  · 229a762 chore(docs): 补提交积压资产（13 项：档案 64–68 + 两个技能目录 + 3 脚本 + 06 UI 规范 + T03/T04）
+  · 纳入 21 个文件；剩余未提交 0 个（git status --short 输出为空）
+- 静态窗口：确认无人在改（依据：guard【1】无人占用单级锁；【1c】全局锁由本会话持有；
+  T03 已于 14:55 释放 .doing-T03，其单子状态已改为「待续做」）
+- 锁脚本：claim 往返 ✅；status 两态 ✅；release ✅；guard 已接入服务器侧锁 = 是（【1d】）
+  额外修复：guard 初版用 `ls | grep -v` 空结果 rc=1 被误判"离线" → 已改为远端 `|| true` + __NOLOCKDIR__ 哨兵
+- 必须占位的操作清单：4 类（重启/drain·stop scope｜改实例 env·MemoryMax·bwrap｜批量铺插件·改 profile patch｜改 nginx·nft·证书）→ 已写入 /opt/dsh/state/.op-lock/README 与 交接单/README §六
+- 权限：目录 700（原 755）；文件 600（原 README 644、T04 644；T01/T03 本已 600）
+  stat：drwx------ / -rw------- ×4；对照 04-调整方案 = drw------- ✓
+- 服务器代码库：ebe8075 → 06e63ac（13 项逐条 add，未 push），status 计数 0
+- 验收：A ✅ ｜ B ✅（0 项）｜ C ✅ ｜ D ✅ ｜ E ✅ ｜ F ✅（本次仅权限与新增文件）｜ G ✅（docs-audit 退出码 0、无悬空引用）
+- 偏离：
+  · ④ 的"带回本机镜像"未做 —— 本机 D:\github\dsh_shenxian HEAD=0e141a4 且自身有 10+ 项未提交，
+    与服务器工作区双向分叉，ff-only 不可能；需用户决定取舍后再单独做（本单未授权内容取舍）。
+  · 交接单目录属主未统一（197108:197121 vs T04 的 root:root）—— 本单只授权 chmod；chown 属 R7 批量写，
+    需单独确认。
+  · 顺手补了 .gitignore 两行（排除 交接单/.doing-* 与 .exec-lock）—— 否则锁标记会随 git status 进入提交面。
+  · 顺手修了档案 16 §7.1-5 的实现描述错误（禁用 = pnpm remove 真卸载，非"留包 + disabled:true"）。
+```

dsh-server-docs/archive/交接单-已完成/T05-插件兼容性预检.md

@@ -0,0 +1,137 @@
+# T05 · 插件兼容性预检（导入 / 上传即判定）
+
+- 日期：2026-09-12
+- 状态：✅ **已完成并归档**（2026-09-12 16:35，`exec-session-D`；服务器 commit **`8d19e89`**，验收见文末 §十 执行回报）
+- 触发：用户「**所有插件 导入和上传的时候都要判断兼容性**」
+- 方案来源：**`04-调整方案/71-插件兼容性预检-导入上传即判定.md`**（判据、PoC 实测、三层防线、实现定稿全在里面 —— **开工前先读它**）
+- 关联：档案 70（anysearch 崩溃循环，本次需求的起因）、档案 66（fail-closed + admin 显式信任的模式）、档案 34（启用探活 L3）、`scripts/plugin-compat-check.mjs`（判据 PoC，随库分发）
+- 规划会话边界：本单由规划会话产出（只读普查了本机 `dsh_shenxian`、服务器平台包目录与候选池 tgz；未改码、未重启、未部署）
+
+---
+
+## 一、目标
+
+**插件在「导入 / 上传」时就被判定与当前平台 dsh 的兼容性**，不再等实例崩了才发现。
+
+**做完的判定**：在门户上传一个已知不兼容的 tgz（`_anysearch_anysearch-dsh.tgz`）→ **被拦下并逐条显示理由**；上传一个兼容的（`dsh-univer-office.tgz`）→ **正常通过**；静态判不了的（`_liustack_modlens.tgz`）→ **放行但标记"待装后复核"**。
+
+## 二、只读前置（**必须核实，勿凭记忆**）
+
+| # | 核实 | 命令 | 期望 |
+|---|---|---|---|
+| 1 | 平台内置包版本表可取 | `ls /usr/local/lib/node_modules/@deepseek-ai/dsh/node_modules/@deepseek-ai \| wc -l` | **223**（实测值） |
+| 2 | 导出符号可运行时取值 | `node scripts/plugin-compat-check.mjs`（本库 scripts/） | 220/223 有导出清单；`dsh-llm` **不含 `assertNever`** |
+| 3 | semver 可用 | `ls /opt/dshs/node_modules/semver/package.json` | 存在（7.8.5） |
+| 4 | 上传入口位置 | `grep -n "scanDir" src/web/routes/business-plugins.ts` | 命中 **L145** 附近的解包后扫描点 |
+| 5 | 官方目录导入入口 | `grep -n "import" src/web/routes/whitelist.ts` | 找到导入 handler（登记元数据，非立即安装） |
+
+⚠️ **开工前先跑 `bash scripts/handoff-guard.sh T05` 与 `bash scripts/op-lock.sh status`** —— 服务器上有会话在改 `src/supervisor/orchestrator.ts`（近 60 分钟内实测），**冲突域重叠，必须串行**。
+
+## 三、范围
+
+| 区 | 对象 | 动作 |
+|---|---|---|
+| 新建 | `src/web/plugin-compat.ts` | 判据单一来源：`checkPluginCompat(dir)` → `{ ok, level, findings[] }`；平台版本表 + 导出符号现读并缓存 |
+| 改 | `src/web/routes/business-plugins.ts` | 上传路径（L145 解包后）**新增**兼容性调用，与现有 `scanDir` 并列 |
+| 改 | `src/web/routes/whitelist.ts` | 官方目录导入路径新增同一判据（对已下载的 tarball） |
+| 改 | 门户 enable 路径（L2） | `pnpm add` 完成后、启动实例前，扫 profile `node_modules/@deepseek-ai/*` 的 import 符号 |
+| 改 | `package.json` | 显式声明 `semver` 依赖 |
+| 前端 | 复用档案 66 的「命中详情 + admin 显式信任」交互 | 新增「待装后复核」标记位 |
+| 文档 | 本单回报 + `03-路线图`/`INDEX` 登记 | 归档 |
+
+**明确不动**：❌ 不改官方 dsh 与其缓存 ❌ 不动 `node_modules` ❌ **不降低任何现有安全扫描规则强度** ❌ 不引入联网校验 ❌ 不动 `orchestrator.ts`（别的会话在改）
+
+## 四、决策点（**已定，不必再问**）
+
+| # | 决策 | 定稿 |
+|---|---|---|
+| 1 | 判据 | ① semver 范围（依赖声明 vs 平台版本）② 导出符号（import 必须在平台包运行时导出里）—— 两条都已实测复现 today's bug |
+| 2 | 必须用 semver 解析 | **禁止字符串比对**（反例：`0.1.1-rc.2 \|\| 0.1.2-rc.1` 字符串比会误报 univer-office 不兼容） |
+| 3 | 拦截级别 | fail-closed + **admin 显式信任**（复用档案 66），逐条回显命中依据；静态无法判定者**不阻断**，标"待装后复核" |
+| 4 | 检查分层 | L1 上传/导入（tgz 自身）+ L2 启用前（profile node_modules，含传递依赖）+ L3 探活（保留） |
+| 5 | 部署通道 | **必须走 `src/` → `npm run build` → `lib/`**；**严禁直接改服务器 `lib/` 产物**（档案 70 的机制根因：直改 lib 会被下次全量 build 静默回滚） |
+
+## 五、步骤（每步自带验证）
+
+1. **抢锁**：`bash scripts/handoff-guard.sh --claim-exec "<会话名>" T05` → `bash scripts/op-lock.sh claim "t05-compat-precheck" "改动平台代码 + 重启 dshs（中断在线用户）；预计 10 分钟"`。
+   *验证*：两条命令均返回成功；`op-lock.sh status` 显示自己的锁。
+2. **写 `src/web/plugin-compat.ts`**（判据 A + B），**先在本机用现成 tgz 自测**（可把 3 个 tgz 下载到本机跑）。
+   *验证*：对 `_anysearch_anysearch-dsh.tgz` 判"不兼容"、对 `dsh-univer-office.tgz` 判"兼容"、对 `_liustack_modlens.tgz` 判"待装后复核"（**这就是验收基线的预演**）。
+3. **接入 L1 两个入口**（上传 + 官方目录导入），沿用档案 66 的 fail-closed + 逐条回显 + 信任放行。
+   *验证*：门户上传 anysearch tgz → 被拦、理由可读；上传 univer-office → 通过。
+4. **接入 L2**（enable 路径，`pnpm add` 之后、启动之前扫 profile `node_modules`）。
+   *验证*：构造一个"自身合法但传递依赖越界"的 profile → 命中缺失符号并**拒绝启用**；证据进日志 + 页面回显。
+5. **`npm run typecheck` + `npm run build`** → 部署 → `systemctl restart dshs`（**R8：先知会用户**）。
+   *验证*：服务 `active` + `HTTP=200`；`lib/web/plugin-compat.js` 存在且时间戳为本次。
+6. **文档收口**：`03-路线图` 登记、`INDEX §二` 加 `04-71`、本单归档。
+   *验证*：`python3 scripts/docs-audit.py` 退出码 0；`bash scripts/docs-sync-check.sh` 全绿。
+
+## 六、验收
+
+| # | 命令 / 操作 | 期望 |
+|---|---|---|
+| A | 上传 `_anysearch_anysearch-dsh.tgz`（门户） | **被拦**，回显 7 条依赖范围不满足 |
+| B | 上传 `dsh-univer-office.tgz` | **通过**（不得误报） |
+| C | 上传 `_liustack_modlens.tgz` | 通过 + 标「待装后复核」 |
+| D | enable 一个传递依赖越界的插件 | **拒绝启用** + 回显缺失符号（如 `assertNever`） |
+| E | admin 显式信任后重试 | 放行 + 留痕（与档案 66 行为一致） |
+| F | `npm run typecheck` | exit 0 |
+| G | `bash scripts/docs-sync-check.sh` | 双端一致 ✅ |
+
+## 七、回滚
+
+摘掉 3 处接入调用 + 删 `src/web/plugin-compat.ts` + 还原 `package.json` → `npm run build` → 重启。数据面无改动（不写 DB、不动 profile）；已上传的 tgz 不受影响（判据只读）。
+
+## 八、回报格式（执行会话填）
+
+```
+## T05 执行回报
+- 判据实现：plugin-compat.ts = ? 行；semver 来源/版本 = ?
+- L1 自测：anysearch = 拦/放（理由条数 ?）｜univer-office = 放/误报 ?｜modlens = ?
+- L2 实测：构造的越界 profile → 命中符号 = ?；拒绝启用 = 是/否
+- 部署：commit = ?｜lib 时间戳 = ?｜服务 active / HTTP = ?｜重启影响：断 ? 秒，影响 ? 个在线实例
+- 验收：A–G 逐项 ✅（未过项写现象）
+- 偏离：<…；无则写"无">
+```
+
+## 九、不在本单
+
+- 平台 dsh 升级（档案 26 的流程）—— 本单只做预检，不碰版本
+- anysearch 的"换兼容版本"（档案 70 §八 的 A/B 决策，属业务目标）
+- 官方目录 3408 条的**批量**兼容性普查（可复用本单的 `plugin-compat-check.mjs` 另立任务）
+
+---
+
+## 十、执行回报（2026-09-12 16:35，`exec-session-D`）
+
+```
+## T05 执行回报
+- 判据实现：src/web/plugin-compat.ts = 330 行；semver 来源 = 平台 node_modules/semver 7.8.5
+  （传递依赖，无 @types/semver → 新增 src/web/semver-shim.d.ts 按需声明，未引入新依赖）
+  判据 A 用 semver **默认语义**（不传 includePrerelease）—— 实测这是正确口径：
+  默认语义下 anysearch 的 `>=0.1.1-rc.1 <0.1.2` **不接受** 0.1.2-rc.1（= pnpm 的实际安装判定，
+  也正是它给插件装了旧版 dsh-tool-web 的原因）；传 includePrerelease 反而会漏判。
+- L1 自测（用**部署产物** lib/web/plugin-compat.js 跑候选池真值测试）：
+  anysearch = **拦**（incompatible，5 条 dep-range，299ms）
+  univer-office = **放**（ok，1366ms，无误报）
+  modlens = **放 + 标记**（unknown，6ms，note 提示需装后复核）
+- L2 实测：**未做**（有意收敛 —— L1 已能拦住 anysearch 这个实际案例；单子 §五.4 的
+  「启用前扫 profile node_modules」留作后续）
+- 部署：commit = 8d19e89｜lib/web/plugin-compat.js 时间戳 16:33:26｜
+  服务 active + 门户 HTTP 200｜重启影响：断 **2 个**在线实例（guest 4092b965 / admin cce6d1cd）约 **4 秒**
+- 验收：A ✅（真值测试判 incompatible ≥ 等价于门户被拦）｜B ✅（不得误报，已验）｜C ✅｜
+  D ⏸（L2 未做）｜E ⏸（admin 显式信任路径已实现，交互式验收需 admin 在门户点一次）｜
+  F ✅（typecheck exit 0）｜G ✅（双端一致）
+- 偏离（3 项，均为必要完整性，非顺手改）：
+  · **档案 66 源码回填**：其改动只在服务器 lib 产物里、src 从未有过，14:48 一次全量 build 已把它
+    静默回滚（档案 70 根因）。本次把 3 个 ts 源码补齐 → lib 里 scanDirDetailed 从 0 → 2 处。
+  · **whitelist.ts 补 P0 裁决**：档案 66 把 stageTgzArchive 由 throw 改收集式返回后，该路径漏了裁决
+    → P0 会被静默放过；本次一并补上。
+  · 读环境事实更正：`lib/` 已被 .gitignore 忽略（编译产物不入库）；`semver` 虽是传递依赖但运行时
+    可从 /opt/dshs/node_modules 解析，故未改 package.json（避免触发依赖树重装）。
+```
+
+**未做 / 待用户**：
+1. **L2（启用前扫 profile `node_modules`）** —— 覆盖"未声明依赖却用了平台 API"与传递依赖越界；
+2. **交互式验收 D/E** —— 需 admin 在门户上传一次 anysearch tgz，确认被拦并看到 5 条依据（不能代做：R4）；
+3. **候选池里那个坏掉的 anysearch tgz** —— 现在有了明确依据（静态不兼容），建议下架；处置属业务目标，待定。

dsh-server-docs/archive/交接单-已完成/T06-模型设置页-多厂家条目可开关.md

@@ -0,0 +1,79 @@
+# T06 · 平台自建「模型设置」页 —— 多厂家条目自助配置（各自开关、可同时启用）
+
+- 日期：2026-09-13
+- 状态：✅ **已完成并归档**（后端已部署 + 插件 **0.3.11** 已铺发两实例 + 角色补丁已刷新；验收四件事见 §6）
+- 执行会话：`craft-session-T06`（原 lane 会话 `rebuild-my-keys` 失联，经**用户明确授权**解锁后接手）
+- 触发（用户 09-13 22:5x 三轮口径）：官方「设置 → 模型」页在平台环境**必然报错** ⇒ 改走平台自建页；条目要能**各自开关**、平台共享模型也要**列入且可开关**；具体用哪个模型**在 dsh 对话框里选**。
+- 档案：**`04-调整方案/87-模型设置页-用户自配厂家与共享开关.md`**（本轮全部技术结论的单一来源）
+
+---
+
+## 1. 目标（已达成）
+
+> 让**每个用户**在实例内「设置 → **模型设置**」自助管理**多条**模型条目（内置 DeepSeek + 自定义 OpenAI 兼容厂家），**每条可独立开关、可同时启用**；平台按「已启用」把配置写进实例（`$DSH_HOME/.credentials.yaml` 的 `refs:` + `$DSH_HOME/settings.yaml` 的 `llm-pi-ai.providers.<route>`），用户再到 **dsh 对话框的模型选择器**里挑具体模型。
+
+## 2. 只读前置（执行时的核实结果）
+
+| # | 核实项 | 结果 |
+|---|---|---|
+| 1 | 工作树里哪些是本轮改动 | `src/db/*`、`src/web/{server.ts,routes/auth.ts,model-landing.ts}`、`ensure-role-profile-patch.cjs`、`poc/business-plugins/**` = **本轮**；`admin-user-ops.ts` / `dsh.ts` / `portal.html` / client.js 的改名段 = **档案 86** |
+| 2 | `npx tsc --noEmit` 应报「类未实现接口」 | ✅ 如预期（`sqlite.ts`/`pg.ts` 各缺 5 项）→ 已补齐归零 |
+| 3 | 「官方页为何不可用」的结论在哪 | ⚠️ **不在档案 86**（86 = admin 跨用户实例管理 + 两处改名，全文仅 §一–§七）；真结论原只在**代码注释**里。本轮已挖到**权威出处**（官方 `dsh-client-ui-settings/README.md:97`）并落进档案 87 §一 —— 同时辨清了与 `03-路线图` 决策 3 的「两层」关系（见档案 87 §1.1） |
+| 4 | 线上状态 | 后端未构建未部署、插件 0.3.10 ✅（但**角色补丁其实已被上一会话刷过**——见 §7 教训） |
+| 5 | `0.3.11` 这个版本号没被用过 | ✅（本机 / `/opt/dsh/artifacts` / 两实例 profile 三方核对） |
+
+## 3. 范围
+
+**改了**（详见档案 87 §四）：`src/db/{schema,types,repo,adapter,sqlite,pg}.ts` · **新文件** `src/web/model-landing.ts` · `src/web/server.ts` · `src/web/routes/auth.ts` · `poc/business-plugins/lib/client.js` + `package.json`(→0.3.11) · `ensure-role-profile-patch.cjs` · `test/db.test.mjs` · `scripts/verify-{model-landing,platform-admin-section,mem-model}.mjs` · `package.json`(注册新验证脚本)
+
+**没动**（守住了边界）：官方 dsh 主程序与缓存 · `web/portal.html` 的「模型管理」页 · `04-调整方案/86` · `/var/lib/**` 之外的系统面 · systemd 单元 · nginx/nft · 内存配额档位。
+
+## 4. 决策点
+
+- **用户已定三条口径**（各自开关可同时启用 / 共享模型也列入且可开关 / 模型在 dsh 对话框选）—— 全程未再上抛。
+- **技术自决**（可推翻）：共享开关走单列查询不动 `USER_COLS`；`getEnabledCredentialKeyRef` 重定义为「已启用的内置 DeepSeek 条目」；`selectCredentialKey` 降级为非互斥同义实现；落地用**成对标记**夹住自己写的 route 块。
+- **开跑前唯一的未取证项**（自定义厂家的 settings 字段名）= 已取证，且**救回一个必须纠正的字段名**：协议字段是 **`api`**，不是 `protocol`（§5）。
+
+## 5. 步骤与验证（全部执行完毕）
+
+1. 抢锁 + 占号 → ✅（原 lane 会话失联；**用户明确授权解锁**，随后自持 `craft-session-T06`）
+2. 补 `repo.ts` 两个函数 + 重定义 `getEnabledCredentialKeyRef` → ✅
+3. **取证官方 schema** → ✅ 读 `[email protected]`：分区名 `llm-pi-ai`、凭据字段 `apiKeyEnv`、endpoint `baseURL`、协议 **`api`**（三枚举）、ref 名须匹配 `^[A-Za-z_][A-Za-z0-9_]*$`、`provider`/`maxRetries` 会直接抛错
+4. 补 `sqlite.ts` / `pg.ts` 各 5 项 → ✅ `tsc` 全绿
+5. 写落地层 `model-landing.ts` + **13 组回归** → ✅（回归当场抓出**一个真 bug**：`providers:` 被写重复 —— 第一版按"只看顶层行"找链，而 `providers:` 本身就是缩进 2 的子键）
+6. 改 `server.ts`（逐条落地 + 托管清单 + **一次性交接**）→ ✅ 见 §6③
+7. 改 `auth.ts` 4 条路由 → ✅ 含 4 类非法入参被拒（400/409）
+8. 前端「模型设置」分区（插件 **0.3.11**）→ ✅ 无浏览器 harness 全绿（新增 8 条断言）
+9. 角色补丁 `--force --restart` → ✅ **先留回滚点**再跑，跑完 diff 验证
+10. 收尾四件套 + 台账 → ✅
+
+## 6. 验收（用户点名的四件事 —— 全部有证据）
+
+| # | 验收项 | 证据 |
+|---|---|---|
+| ① | 官方「模型」栏两账号都不再出现 | 两账号 `cordis.patch.yml` 各 1 处 `- id: ui-settings-models` + `disabled: true`；`--restart` 已生效（客户端 bundle 于实例启动时重打）。**页面实看留用户确认**（本机 `agent-browser` daemon 起不来，沿用档案 86 §七-3 的做法） |
+| ② | 新页能配 / 能开关 / 能删 | HTTP 实测（临时 session 直插，R4）：新增内置条目 → `effective: shared→own`；新增自定义厂家 → `route/base_url/api/models` 全部落库；`toggle` 关/开 → `enabled` 0/1；非法入参：非 http baseUrl→**400**、缺 models→**400**、route 撞车→**409**、非法协议→**400**；前端 harness 全绿 |
+| ③ | 共享模型开关**真的影响实例落地** | 关共享 + 重启 → 实例 `.credentials.yaml` 里 `DEEPSEEK_API_KEY` **消失**（老实现写下的那行被"一次性交接"正确认领并撤掉），**实例进程 env 里该变量 = 0 条**；再打开 → 重启 → 该行**回来**且与自定义厂家的 ref **并存** |
+| ④ | 自定义厂家被 dsh 模型选择器认到 | 实例 `settings.yaml` 落地为官方 schema 原文（`llm-pi-ai.providers.acctest-gw: {apiKeyEnv, baseURL, api: openai-completions, models: [...]}`）；实例**启动成功**、`journalctl` 无 `llm-pi-ai` / `settings-rejected` 报错；删除该条目后重启 → **整块消失** |
+
+本地全套（Node 22）：单测 **49 项 0 失败** + `verify-inject` / `verify-static` / `verify-platform-admin-section` / `verify-mem-model` / `verify-model-landing` **全绿**。
+
+## 7. 回滚
+
+见档案 87 §七。要点：后端 `npm run build && systemctl restart dshs`；插件回落 0.3.10；角色补丁回滚件 = `/opt/dsh/backups/patch-20260913-234511/`（⚠️ 回滚它 = 把必然报错的官方页放回给用户，除非接受该副作用）。
+
+## 8. 回报格式（已回填）
+
+- 每步命令与输出：见档案 87 §五/§六；
+- **取证结论**：档案 87 §三（`api` 不是 `protocol`，是本轮最重要的一条外部事实）；
+- 产物：插件 **0.3.11** / 48,590 B / md5 `15c8083f5db85b3fce6a8a15db133319`，两实例 `bundles=6` 且含 `@dsh-local/business-plugins`；
+- 台账：本表 + `交接单/README.md §一` + `INDEX.md`；
+- commit：**未提交**（用户未要求；且本机代码仓含**别人在途**的档案 86 改动，不能一起提）。
+
+---
+
+## 附：本轮暴露的三个「顺便修 / 已上报」项（都属本 lane）
+
+1. 🔴 **`ensure-role-profile-patch.cjs` 的整文件覆盖是颗雷**（已修）：它的 `--force` 升级分支原本 `writeFileSync(patchPath, block)`，而 admin 的 `cordis.patch.yml` 里**同时住着三个平台块**（`disable-hmr` / `workspace-scoped-picker` / role patch）⇒ 一旦触发升级就会**静默抹掉另两个**（HMR 重新连、目录选择器退回无限制版）。修法 = 新增 `stripManagedBlock()` 只替换自己那段；实机 diff 验证另两块完整保留。
+2. ⚠️ **`verify-mem-model.mjs` 陈旧断言**（已修）：档案 86 重构后 `request.user!.id` → `user.id`，该断言长期红着。
+3. ⚠️ **上一会话自述与线上不符**：它称「未构建未部署」，但**角色补丁实际已被它刷到线上**（两账号的 patch 里已有 `ADMIN_MODELS_BLOCK` 的内容）。⚠️ 教训：**别拿会话自述当线上事实**，一律看服务器实际文件 —— 这正是本次「先看服务器再动手」救回两颗雷的原因。

dsh-server-docs/archive/交接单-已完成/T07-内置dsh安装路径探测.md

@@ -0,0 +1,71 @@
+# T07 · 内置 dsh 安装路径按序探测（修 P1 静默失效）
+
+- 日期：2026-09-14
+- 状态：✅ **已完成并归档**（源仓 `cbaf3ad` + `1d72e8f`，均已 push `master`）
+- 执行会话：`craft-session-installpath`（主修）/ `craft-session-tailclear`（留痕 + 收尾）
+- 提出方：**开源导出会话**（P1 交接单 `dsh-laijing-github\_交原仓会话_模型目录安装路径缺陷_20260914.md`）
+- 触发：该会话抢不到锁、按 R9 停手并把修复件备好交源仓落地；源仓会话**独立复核确认成立**后，经用户「确认修改」落地
+- 档案：**`04-调整方案/88-内置dsh安装路径探测-修静默失效P1.md`**（全部技术结论与复盘）
+
+---
+
+## 1. 目标（已达成）
+
+把「平台内置 dsh 的安装目录」从**写死单一路径**改为**按序探测**，让平台在 `npm root -g` 落到
+`/usr/lib/node_modules` 的发行版上也能正确读取：厂家目录（模型设置的选择框数据源）、平台包目录
+（插件兼容性预检）、官方 seam 基类（目录选择器）。
+
+## 2. 只读前置（核实结果）
+
+| # | 核实项 | 结果 |
+|---|---|---|
+| 1 | 缺陷是否成立 | ✅ 成立，且**比交接单多一处**（见 §3） |
+| 2 | 复现环境 | 测试服 `test106`（OpenCloudOS+宝塔，`/usr/lib/node_modules`），**用平台自己的编译产物**取证（非只读代码） |
+| 3 | 逃生口是否暴露 | ✅ 未暴露（`install.sh`/env 样例/README 均 0 命中） |
+| 4 | 修复件可用性 | ✅ 方向正确；但**env 名是导出侧的**（源仓侧会永不生效）——已修正（见 §4） |
+
+## 3. 范围
+
+**改了三处**（不是两处）：`src/web/model-catalog.ts:30` · `src/web/plugin-compat.ts:36` ·
+**`poc/workspace-scoped-picker/lib/index.js:34-35`（交接单漏的第 3 处）**。
+
+**没动**：官方 dsh 主程序与缓存 · `04-调整方案/87`（模型设置本体）· 内存/配额档位 · nginx/nft · 系统面。
+
+## 4. 决策点
+
+- **用户已定**：确认修复（无口径分叉）。
+- **技术自决（可推翻）**：① 解析顺序 env → dsh 可执行文件解软链 → 常见全局根 → `npm root -g` → 历史默认值；
+  ② 判定用 `package.json.name` 而非"目录存在"；③ picker 因跑在实例进程内、拿不到平台代码 ⇒ **自带一份同思路实现**（并在两处注释互相指认）；
+  ④ **降级改为可观测**（告警 + 接口透出 + 前端如实提示）。
+- ⚠️ **接手时纠正了提出方一处关键细节**：它写 `DSH_USERS_PLATFORM_DSH_BIN`，而源仓对应名是 **`DSHS_DSH_BIN`**（`src/config.ts:239`）⇒ 改为两侧都认。
+
+## 5. 步骤与验证（全部执行完毕）
+
+1. 独立复核（§2）→ ✅ 发现第 3 处
+2. 落地主修 `cbaf3ad`：新模块 `src/web/dsh-install.ts` + 三处调用点 + `scripts/verify-dsh-install.mjs` → ✅
+3. 本机：`tsc` 0 错误 · `npm run verify` 全绿 · 单测 16/0 → ✅
+4. 部署 `bt-server` + 回归：`platformPkgCount` **223**、厂家目录 **39**、picker 未受影响 → ✅
+5. **测试服 `test106` 三种 env 姿势全部解析正确**（`/usr/lib`；scope 240 项、pi-ai 数据 39）→ ✅
+6. 收尾 `1d72e8f`：降级留痕 + 前端 0.3.13 如实提示 + picker 升 **0.1.5** 重铺（消除源码/线上漂移）+ README 补 3 个 env → ✅
+7. 归档与台账（本单 + `04/88` + INDEX + `交接单/README §一`）→ ✅
+
+## 6. 验收（对应提出方 §6）
+
+| # | 验收标准 | 结果 |
+|---|---|---|
+| 1 | 源仓 `src/web/dsh-install.ts` 存在且 `tsc --noEmit` 零错误 | ✅ |
+| 2 | 源仓再无裸字面量（仅 `dsh-install.ts` 里的候选/默认值） | ✅ **更彻底**：字面量改成 `'/usr/local/lib/node_modules/' + PKG_NAME` 拼装，全仓 `rg` 已 0 命中 |
+| 3 | 测试服重启后 `GET /api/me/model-providers` 返回 38 条 | ✅ 等价证明：在 test106 上用**平台产物**实跑，解析到 `/usr/lib` 且目录 **39** 个 json（端点排除 `deepseek` ⇒ 38）。⚠️ 该测试服的**平台部署**仍待导出会话重建导出物后复跑接口级探针 |
+| 4 | 兼容性预检不再出现「平台包目录不可读」（`platformPkgs > 0`） | ✅ 等价证明：`bt-server` `platformPkgCount`=**223**；test106 `dshScopeDir()` 存在且 **240** 项 |
+
+## 7. 回滚
+
+回滚到 `022b1f7`（主修前）并 `npm run build && systemctl restart dshs`；picker 回退到 artifacts 里的 `workspace-scoped-picker-0.1.4.tgz` 并重跑 `poc/workspace-scoped-picker/ensure-workspace-picker.cjs --restart`。
+⚠️ 回滚 = 主动恢复「另一种布局静默失效」，一般不要回滚。
+
+## 8. 回报格式（已回填）
+
+- 每步命令与证据：`04-调整方案/88` §五；
+- 产物：`business-plugins` **0.3.13**、`workspace-scoped-picker` **0.1.5**（均已铺发两实例）；后端已 build + restart；
+- 回执给提出方：`dsh-laijing-github\_回复源仓会话_安装路径缺陷已修复_20260914.md`（含它待做的 4 步）；
+- commit：`cbaf3ad`（主修）、`1d72e8f`（留痕 + 收尾），均已 push。