feat(injection): 统一面板宿主注入重构——含块层+几何写路径+chunk缓存+锚点弱化+桌面/移动适配 (#232)

* feat(injection): 统一面板宿主——固定含块层 + 挂载自检降级 + body 锚点守卫

- Sidebar 渲染根包 [data-dsh-panel-host]（fixed inset-0 pointer-events:none）
- 面板/开关簇由 fixed 改 absolute（层内视口坐标等价），免疫套壳中间层 transform 劫持
- 挂载后一次性几何自检：页面级 transform 时降级 absolute + rAF 视口同步
- MutationObserver（body childList）守卫锚点被宿主清空时重挂

* perf(injection): 几何写路径统一为 writeGeometry + 面板 layout 隔离

- 拖拽帧与打开态共用单一推挤写入器（--dsh-sidebar-width/height）
- .panel/.bottomPanel contain: layout style——内部重排不外泄
- 拖拽期（body[data-dsh-sidebar-dragging]）才挂 will-change: transform

* perf(chunks): HMR 激活保留未变 chunk 的已解析 exports + ETag HEAD 重验证

- 新增 revalidateChunksOnReactivate()：激活时 HEAD 每个已加载 chunk 对比 ETag，
  未变保留内存缓存（跳过重注入/重执行），变更或不可达则 fail-open 重取
- 测试夹具与孤儿缓存条目不跨激活存活
- index.tsx 激活路径由 resetChunks() 改为 revalidateChunksOnReactivate()

* fix(layout): 推挤锚点改 data 属性 + #root calc 宽度防桌面壳溢出

- nth-child(2) → #root [data-dsh-frame] > [data-pane="conversation"]（实证同元素）
- #root 宽度 calc(100% - var) 与 margin 同步过渡：web 视觉不变（实测 1140+300=1440 无溢出），
  Desktop 壳（#208）width:100% 的加性溢出根因消除

* feat(desktop): 桌面信号自动探测 + win32 顶栏 overlay 自动避让 + 键盘/safe-area 适配

- 新增 desktop-env.ts：解析 dsh-desktop-mode/platform URL 信号与 preload 标记
- win32 advanced 壳自动启用 titleBarCompat（32px overlay），手动 pref 仍可覆盖
- visualViewport 键盘 inset：底部面板/窄屏抽屉键盘弹起时上移
- 面板与开关簇 safe-area-inset 适配（env() 桌面端为 0）
- 单测 7 例（含 URLSearchParams 前导 ? 剥除修复）

* docs+e2e: 注入方案实施记录（路线B关闭、偏差记录、基线数据）+ 契约同步 + e2e 新断言

- 设计文档：路线 B 标记关闭、§8.1 改单 PR 步骤（含 commit 对照）、拖拽基线数据、实施偏差记录
- AGENTS.md §8：data-dsh-panel-host 含块层、推挤锚点契约（禁 nth-child）、桌面信号
- mount.e2e：data-dsh-panel-host 断言 + win32 advanced 桌面信号场景

* fix(cr): 响应 #232 CR 三条 findings

- P1 降级同步：按未修正几何判定（跟踪自身补偿量），祖先 transform 消失才退出循环——
  修正后矩形不再被误判为无需修正（自清除缺陷）
- P1 chunk 重验证成为 loadChunk 屏障：重验证挂起期间不提供缓存，杜绝 HMR 竞态陈旧 exports；
  测试夹具加载不再被误记为生产加载
- P2 键盘 inset：innerHeight - (vv.height + vv.offsetTop)，并监听 scroll（offsetTop 变化）
- 新增屏障单测 1 例；设计文档偏差记录更新

* fix(chunks): 屏障 HEAD 加超时兜底 + resetChunks 清 revalidation

- revalidateChunksOnReactivate 的 HEAD 与 recordEtag 均带
  AbortSignal.timeout(5s)：路由挂起时 fail-open（drop + 重取），
  屏障不再可能无限期阻塞所有懒加载 chunk（CR #232 P1 修复的健壮性缺口）
- resetChunks 同步清 revalidation：重验证挂起期间重置后，
  loadChunk 不再等待已丢弃状态的孤儿任务（finally 身份判断 no-op）
- 单测 +2：HEAD 挂起超时 fail-open（fake AbortSignal.timeout 触发中止）、
  resetChunks 清屏障后 loadChunk 立即放行

* fix(deps): align @deepseek-ai/* peers with DSH 0.1.0-rc.8

- peer/devDependencies: 13 个 @deepseek-ai/* 从 ^0.1.0-rc.7 升至
  ^0.1.0-rc.8；删除随 rc.8 消失的 dsh-client-web-react / dsh-client-schema-form
  （无 rc.8 发布、rc.8 依赖树与壳 bundle 零引用、插件 src 零引用）；
  cordis peer/devDep 同步升 ^4.0.0-rc.8
- 版本 0.13.1 -> 0.14.0（package.json / dsh.plugin.json /
  SIDEBAR_SERVICE_VERSION 三处同步）
- CHUNK_EXTERNALS / CLIENT_EXTERNALS / CLIENT_REQUIRE_ALLOWED 三处镜像
  同步删除两个死包（primitives/slots 仍是 rc.8 壳静态模块表种子，保留）
- CI 挂载冒烟钉版 @deepseek-ai/dsh@0.1.0-rc.7 -> rc.8
- pnpm clean --lockfile 全量重解析：lockfile 内 @deepseek-ai/* rc.7 残留
  清零（传递链同升 rc.8，杜绝 #206 式混用树）；pnpm-workspace.yaml
  minimumReleaseAgeExclude 按 #207 模式整体换为 rc.8 列表
- 文档同步：README 安装说明、AGENTS.md CI 钉版、外部插件指南与设计文档
  cordis 示例、issue 模板版本示例

* feat(prefs): editorExplorer 默认独立（关）——文件各自新开 tab

- SIDEBAR_PREFS_DEFAULTS 与 host PrefsSchema 的 editorExplorer 默认
  true -> false：新会话树点击/打开文件按 path 新开 tab，无路径窗口即
  纯资源管理器；合并模式保留为可选手动开启（持久化过的用户设置不受影响）
- 测试同步：prefs.spec 默认断言翻转、plugin-shape.spec 与 smoke.spec
  默认对象翻转；editor-host 合并模式用例显式开启 editorExplorer（split
  用例本已显式）；side-card-section-rows 的 select 行用例固定选中 Merged
- e2e 重写：mount.e2e 文件打开流程从 in-place 断言改为独立模式
  （新开 hello.txt tab、Files home tab 保留），文件头注释同步
- 契约文档同步：AGENTS.md §3.4 editor 行默认描述翻转 + CI 冒烟描述、
  README/README_EN v0.13.0 特性描述 + v0.14.0 changelog

* fix(client): rc.8 模块系统经 ctx.modules 注入 + chunk 副本全局共享

rc.8 不再暴露 window.__DSH_MODULES__ 页面全局（改由 ctx.modules 服务
提供），chunk 外部依赖解析全面失效（terminal/editor/mermaid 全部
"client module system unavailable"）。修复：

- src/client/index.tsx: inject 增加 'modules'（Cordis 服务访问守卫，
  此前直接读 ctx.modules 抛 "cannot get property modules without
  inject"）；apply() 激活时 setChunkModuleSystem(ctx.modules)
- package.json dsh.client.inject 增加 @deepseek-ai/dsh-client-modules
- chunk-loader: 注入写插件自有页面全局 __dshSidebarModuleSystem__——
  懒加载 chunk bundle 各自内联一份 loader（rc.7 靠官方全局回退工作，
  rc.8 全局消失后副本注入变量恒空）；moduleSystem() 按
  注入变量 → 插件全局 → rc.7 全局回退解析
- context-types: Context 镜像补 modules 服务声明（client half）
- e2e: assertNoCrash 失败时输出错误条文本；独立模式断言修正
  （Files 数量按存在性、mermaid 流程先切回 Files、md 预览 locator 去掉
  重复的 [data-dsh-better-sidebar] 嵌套）

验证：typecheck / 639 测试全绿；本地 rc.8 CLI + Chromium 挂载冒烟 3/3
通过（drag-layout、mount 深扫含 editor/mermaid chunk、桌面信号）

* feat(settings): 终端 shell/shellArgs 可在设置页配置（bash 管理）

- SidebarPrefs 新增 terminalShell / terminalShellArgs（默认空 = 保持
  yaml config.shell → $SHELL / 登录 shell / powershell.exe 的既有解析）
- 终端卡齿轮二级页面新增两行 text 配置（与字体行同列）
- host 侧生效链路：UI 终端 WS 打开与 agent terminal_create 均读取
  设置文档覆盖（ptyManager.open / AgentPtyRegistry.create 增加可选
  shell 覆盖参数；shellOverridesOf 解析设置文档）；设置页写入即时
  影响之后打开的终端（既有 pty 保持原 shell）
- locales zh/en 文案；parsePrefs 校验新字段；测试同步

* feat(settings): 侧边卡片设置页加 DSH-better-sidebar 版本徽标

- 设置页 intro 下新增身份徽标：名称 + v{service.version}（服务实例
  版本，与 package.json 由 tests/service.spec.ts 保持同步）
- token 驱动样式（--dsw-alias-*），名称/版本 pill 布局

* fix(drag): 快速拖动提交最后位置 + HMR 后中心列重定位兜底

快速释放（浏览器合并/丢失 pointermove 突发，超快速 flick 甚至可能
完全无 move）时的回退问题：
- pointerup 优先采用最后一次已知拖动值（rAF pending），而非 up 位置
  （事件合并时可能等于按下位置）
- pointercancel / lostpointercapture 中断时同样提交最后已知位置；
  无 move 时用中断事件自身的坐标计算（clamp 后提交）——只有真正
  未产生位移的拖动才回滚
- commitDrag 统一 flush + 同值提交 + 立即重测中心列（消除提交后
  React 用旧 centerRect 覆盖底栏 right 的中间帧）

HMR 重激活后底栏空白（输入框被推挤上移、强制刷新恢复）：
- 根因：新组件实例重跑 locate 时壳的 centerCol 尚未就绪，而壳重建
  复用 #root 子节点（childList 观察器不触发）→ centerRect 卡 {0,0}
  → 底栏 visibility:hidden 永久空白
- 修复：额外观察 <html> 的 style 属性（layout push 写回 --dsh-sidebar-*
  时重定位重测）；底栏打开时 effect 重跑 locate/measure 兜底
- 底栏未测量时由「不渲染」改为 visibility:hidden（渲染链不被几何
  门控，jsdom 测试不回归）

e2e 新增：极快拖动（单 move 立即 up）提交拖动位置、稳定后不回退

* feat(plugins): 添加插件目录支持搜索/分组/独立滚动（多插件场景）

- PluginListBody 顶部加实时搜索框（按名称/id/描述过滤，空结果提示）
- PluginEntry 增加可选 category 分组字段（i18n 友好），目录条目按组
  渲染（未分类条目保持平铺）；数量徽标跟随过滤结果
- 条目列表 max-height + overflow-y 独立滚动，插件多时弹窗不再无限
  增长；渲染数量由搜索天然收敛
- locales zh/en（搜索占位、无匹配）；测试文件固定英文环境
  （vitest 4.1.11+ jsdom 跟随系统 locale，本机 zh-CN 导致英文文案
  断言漂移）

* chore(deps): 适配 pnpm 11.8 supply-chain 校验（exclude 通配）

pnpm 11.8.0 起对 lockfile 既有条目强制 minimumReleaseAge 校验，
且精确 exclude（@scope/pkg@version）对带 peer 依赖后缀的解析条目
匹配失效（44 条误报违规，CI 全红）。@deepseek-ai/* scope 为官方
可信 scope，minimumReleaseAgeExclude 改为 '@deepseek-ai/*' 通配
（保留 rc.1 历史与 stable 条目）；通配经实测通过全部 504 条校验。

* docs: v0.14.0 changelog 补全（自 v0.13.1 全部更改 + 特别声明 rc.8 适配）

新增条目：终端 shell/shellArgs 设置页配置、设置页版本徽标、
添加插件目录搜索/分组/滚动、rc.8 模块系统迁移、拖拽健壮性修复；
版本说明块醒目声明本版适配 DSH 0.1.0-rc.8（rc.7 及更早无法解析依赖）

docs/external-plugin-guide.md

@@ -40,7 +40,7 @@ import type {} from 'dsh-better-sidebar'  // 触发 declare module 'cordis' 类
 {
   "name": "my-plugin",
   "peerDependencies": {
-    "cordis": "^4.0.0-rc.7",
+    "cordis": "^4.0.0-rc.8",
     "dsh-better-sidebar": "workspace:*"
   },
   "peerDependenciesMeta": {
@@ -690,7 +690,7 @@ ctx.effect(() =>
     "./client": { "types": "./lib/types/client/index.d.ts", "default": "./lib/client.js" }
   },
   "peerDependencies": {
-    "cordis": "^4.0.0-rc.7",
+    "cordis": "^4.0.0-rc.8",
     "dsh-better-sidebar": "workspace:*",
     "@deepseek-ai/dsh-client-runtime": "^0.0.1",
     "react": "^18.2.0"

docs/plans/2026-08-11-service-registry-design.md

@@ -267,7 +267,7 @@ return <viewer.component {...props} />
 ```jsonc
 {
   "peerDependencies": {
-    "cordis": "^4.0.0-rc.7",
+    "cordis": "^4.0.0-rc.8",
     "dsh-better-sidebar": "workspace:*"
   },
   "peerDependenciesMeta": {

docs/plans/2026-08-19-sidebar-injection-unified-host-design.md

@@ -75,14 +75,15 @@
 
 ```
 路线 A（主线，本仓库可控）┐
-  统一面板宿主：body 固定含块包裹层            ├─ 现在 → v0.13.x
-  + 桌面信号自动适配 + rAF 几何批处理           │
-路线 B（北极星，依赖上游）┘
-  ui-sidebar 模式：占用官方槽位（grid 内渲染） ─ 上游落地后 → 迁移（浮层部分保留）
+  统一面板宿主：body 固定含块包裹层            ├─ 现在 → v0.13.x（已实施，分支 feat/injection-unified-host）
+  + 桌面信号自动适配 + 几何写路径统一          │
+路线 B（已关闭）┘
+  ui-sidebar 模式：占用官方槽位（grid 内渲染） ─ 2026-08-19 用户决策关闭：无法向官方提 issue，
+                                                纯插件侧自己优化注入方式（调研结论保留于 §6）
 ```
 
-- **路线 A 立即做**：不依赖 DSH 新能力，纯插件侧，直接吸收桌面/移动/性能问题。
-- **路线 B 并行提官方 issue**：请求上游提供「可替换/可接管的右侧面板槽」（details 支持外部替换或新增 bottom-panel 槽），落地后 better-sidebar 主体迁入 grid，body 浮层收敛为纯浮层（菜单/弹窗/右键，与官方 ui-primitives 同姿势）。
+- **路线 A 已实施**：不依赖 DSH 新能力，纯插件侧，直接吸收桌面/移动/性能问题。
+- **路线 B 已关闭**（2026-08-19 用户决策）：不提交上游 issue；§6 的槽位可行性调研保留为后续参考，但不再推进。
 
 ## 5. 路线 A 详细设计：统一面板宿主
 
@@ -140,15 +141,18 @@ document.body
 - **契约文档化**：挂载点（`data-dsh-better-sidebar` / `data-dsh-panel-host`）、z-index 栈、CSS 变量（`--dsh-sidebar-width/height` 保持对外）、桌面信号（URL/全局标记）、推挤锚点策略 —— 同步 AGENTS.md §8 与本文档。
 - **服务契约不变**：`ctx.betterSidebar` API 零变化；#135 的 service 读取问题（dsh-web-mobile 下 `ctx.betterSidebar` 直接读抛错）由「注入层与服务的解耦」顺带收敛（面板渲染不再假设服务存在即可读）。
 
-### 5.4 性能清单（验收口径）
+### 5.4 性能清单（验收口径 + 实测基线）
 
-| 指标 | 现状 | 目标 |
+基线（2026-08-19 真实页面探针，本机 3080，拖拽 12 步 ≈192ms）：**40 帧、帧均 8.36ms / p95 10.2ms、1 帧超 16ms；62 次 `setProperty`（5 种几何属性：panel width / bottom height / bottom right / 两个 html 变量）**——即每帧 5 次写同一组元素，浏览器合并为单次样式重算。
+
+| 指标 | 现状 | 目标（v0.13.1 实施后） |
 |---|---|---|
-| 拖拽期宿主 layout 次数 | 每帧 1 次批写（`applyDrag` rAF，已达标） | 保持；拖拽 0 次 reflow 读 |
-| 懒加载 chunk 二次打开 | 不重下载（304）但重注入+重执行 | 内容哈希不变 → 内存缓存命中，0 脚本执行 |
+| 拖拽期宿主 layout 次数 | 每帧 1 次批写（`applyDrag` rAF），帧均 8.36ms | 保持帧率 ≥ 基线；面板 `contain: layout style` 隔离内部重排；拖拽期 `will-change` 提升合成层 |
+| 几何写路径 | 拖拽（`applyDrag`）与打开态（effect）两条路径写同一组变量 | 统一 `writeGeometry` 单写入器（已实施） |
+| 懒加载 chunk 二次打开 | 不重下载（304）但重注入+重执行 | ETag 未变 → 内存缓存命中，0 脚本执行（已实施） |
 | 会话切换 | 面板 DOM 不重建（已满足） | 保持 + 重组件懒挂载 |
-| 面板显隐动画 | transform+width/margin 过渡 | transform 优先（overlay 模式），推挤模式过渡保留 |
-| 观察器 | ResizeObserver 已 rAF 节流（已达标） | 保持；新增挂载自检/MutationObserver 守卫均为一次性廉价检查 |
+| 面板显隐动画 | transform+width/margin 过渡 | transform 优先（overlay 模式），推挤模式过渡保留（`#root` width/margin 锁步过渡） |
+| 观察器 | ResizeObserver 已 rAF 节流 | 保持；挂载自检/MutationObserver 守卫均为一次性廉价检查 |
 
 ## 6. 路线 B 详细设计：官方槽位迁移（ui-sidebar 模式）
 
@@ -204,19 +208,15 @@ document.body
 
 ### 8.1 拆分（文件级改动清单）
 
-- **PR1（核心注入 + 性能，外部契约零变化）**
-  - `src/client/index.tsx`：挂载结构升级——`host` 内新增 `data-dsh-panel-host` 固定含块层（`position:fixed; inset:0; pointer-events:none; z-index:40`），面板子级 `pointer-events:auto`；挂载后一次性自检（`host.getBoundingClientRect()` vs 视口，偏差阈值内通过；否则降级 absolute+同步模式并 warn 一次）；`MutationObserver`（仅 body childList）守卫锚点被宿主清空时重挂。
-  - `src/client/Sidebar.tsx`：抽取 `writeGeometry` 统一两条写路径（`applyDrag` + 打开态 effect）；拖拽/折叠行为不变。
-  - `src/client/chunk-loader.ts` + `index.tsx`：缓存键加内容哈希，激活时哈希未变保留内存缓存（跳过重注入）。
-  - `src/client/layout.css`：底部推挤锚点 `nth-child(2)` → `#root [data-dsh-frame] > [data-pane="conversation"]`（§3.4 实证的稳定锚点，注释更新）；`#root` 增加 `width: calc(100% - var(--dsh-sidebar-width, 0px))` 消除桌面壳 margin 溢出（#226 目标以根因方式吸收；web 环境实测无溢出、改动无副作用，Desktop 实测待 PR1 验证）；面板根 `contain: layout style` + 拖拽期 `will-change`。
-  - 测试：`tests/` 新增几何写入器单测（fake timers 断言单帧单写）、挂载自检降级单测；`tests/e2e/mount.e2e.ts` 深扫不变并新增 `data-dsh-panel-host` 断言。
-- **PR2（桌面/移动自动适配 + 契约文档）**
-  - 新增 `src/client/desktop-env.ts`：解析 URL `dsh-desktop-mode/platform` + `__DSH_DESKTOP_FILE_PATH__` → 类型化 `DesktopEnv`（win32-advanced / darwin / compatibility / web / unknown）。
-  - `Sidebar.tsx` + CSS：win32-advanced → `--dsh-desktop-top-inset: 32px`（折叠按钮簇/面板顶部内边距避让）；darwin → 左侧红绿灯区避让（~78px，仅左侧贴边控件）；现有 `titleBarCompat/titleBarStripPx`（`lib/types/prefs-shared.d.ts:77-84`）降级为手动覆盖位，默认「自动」。
-  - 移动端：`visualViewport` 键盘弹起时底部面板上移（`resize` 事件 + rAF 节流，沿用 `useNarrowViewport` 模式）；CSS 加 `env(safe-area-inset-*)` 内边距。
-  - 契约文档：AGENTS.md §8 同步（挂载点/`data-dsh-panel-host`/z-index/桌面信号/推挤锚点策略）。
-- **PR3（可选）**：路线 B 上游 issue 提交（§6.2 草案已备）+ 槽位渲染后端原型（feature-flag 后）。
-- 各 PR 独立可验证；PR1 不依赖 PR2。
+**实施方式（2026-08-19 定稿）**：单分支 `feat/injection-unified-host`、按步骤顺序提交（每步 CI 绿）；原 PR1/PR2 拆分为内部步骤，合并为**一个 PR** 交付（改动彼此耦合，且路线 B 关闭后无外部依赖）。各步骤：
+
+1. **挂载层**（`src/client/index.tsx`、`src/client/Sidebar.tsx`、`src/client/sidebar.module.css`）：`Sidebar` 渲染根包 `data-dsh-panel-host`（`position:fixed; inset:0; pointer-events:none; z-index:40`）；`.panel/.toggleCluster/.bottomPanel` 由 fixed 改 absolute（层 inset:0 即视口坐标）+ `pointer-events:auto`；挂载后一次性几何自检（偏差 >8px → `data-dsh-panel-host-degraded` + rAF 视口同步 + warn 一次）；`MutationObserver`（body childList）守卫锚点被清空时重挂。✅ 已实施（commit 9a4c160）
+2. **几何层**（`Sidebar.tsx`、`sidebar.module.css`）：`writeGeometry` 统一拖拽/打开态两条推挤写路径；面板 `contain: layout style`；拖拽期（`body[data-dsh-sidebar-dragging]`）`will-change: transform`。✅ 已实施（commit 553e650）
+3. **chunk 缓存**（`chunk-loader.ts`、`index.tsx`）：`revalidateChunksOnReactivate()`——激活时 HEAD 每个已加载 chunk 对比 ETag，未变保留已解析 exports（跳过重注入/重执行），变更/不可达 fail-open 重取；测试夹具与孤儿缓存不跨激活存活。✅ 已实施（commit 0264625）
+4. **锚点与防溢出**（`layout.css`）：底部推挤锚点 `nth-child(2)` → `#root [data-dsh-frame] > [data-pane="conversation"]`（§3.4 实证）；`#root` 加 `width: calc(100% - var(...))` 与 margin 锁步过渡（实测 1140+300=1440 无溢出；#226 桌面溢出根因吸收）。✅ 已实施（commit 9c9515d）
+5. **桌面/移动适配**（新增 `desktop-env.ts`、`Sidebar.tsx`、CSS）：解析 `dsh-desktop-mode/platform` + `__DSH_DESKTOP_FILE_PATH__`；win32 advanced 自动 `titleBarCompat`（32px overlay，手动 pref 覆盖）；`visualViewport` 键盘 inset（底部面板/窄屏抽屉上移）；`env(safe-area-inset-*)`。✅ 已实施（commit a1906c5，单测 7 例）
+6. **测试与文档**：`tests/desktop-env.spec.ts`（7 例）、chunk-loader 重验证 4 例、`mount.e2e.ts` 增 `data-dsh-panel-host` 断言 + 桌面参数场景、AGENTS.md §8 契约同步、本文档更新。🔄 进行中
+7. **交付**：CI 全绿（含 plugin-mount）→ `gh pr create`。⏳ 待执行
 
 ### 8.2 验证
 
@@ -247,6 +247,14 @@ document.body
 ## 11. 决策记录与实施偏差记录
 
 - 2026-08-19（第一轮）：方案定稿——路线 A（统一面板宿主）为主线、路线 B（官方槽位）并行提 issue；先出设计文档，实现拆 PR1/PR2 待批准。
-- 2026-08-19（第二轮，实施就绪打磨）：对照源码核实现状——拖拽 rAF 批处理/窄屏不推挤/观察器节流/header 弱锚点**已具备**（§3.1 已标注「实施勿重做」）；chunk 缺口精确为「激活后内存缓存清空重注入」（HTTP 已 304）；§8.1 落到文件级改动清单；§6.2 备好上游 issue 草案。**等待用户批准后开 PR1**。
-- 2026-08-19（第三轮，实证核对）：真实 dsh web 页面 Playwright 探针（§3.4）——frame 子项已含 overlay/handle（nth-child 脆弱性实锤）；`data-pane="conversation"` 为新弱锚点（`[data-slot=conversation]` display:contents 作废）；推挤在 web 无溢出（calc 改动无害）；host 本体 static（fixed 在内层面板，含块层为新元素）。设计文档据此更新 §5.3/§8.1。
-- 实施偏差记录：待实施时按既有文档惯例补充。
+- 2026-08-19（第二轮，实施就绪打磨）：对照源码核实现状——拖拽 rAF 批处理/窄屏不推挤/观察器节流/header 弱锚点**已具备**（§3.1 已标注「实施勿重做」）；chunk 缺口精确为「激活后内存缓存清空重注入」（HTTP 已 304）；§8.1 落到文件级改动清单；§6.2 备好上游 issue 草案。
+- 2026-08-19（第三轮，实证核对）：真实 dsh web 页面 Playwright 探针（§3.4）——frame 子项已含 overlay/handle（nth-child 脆弱性实锤）；`data-pane="conversation"` 为新弱锚点（`[data-slot=conversation]` display:contents 作废）；推挤在 web 无溢出（calc 改动无害）；host 本体 static（fixed 在内层面板，含块层为新元素）。
+- 2026-08-19（第四轮，用户决策）：**路线 B 关闭**——无法向官方提 issue，纯插件侧自己优化注入方式；实现合并为单 PR（分支 `feat/injection-unified-host`），按 §8.1 步骤顺序落地。
+- **实施偏差记录**：
+  - 挂载自检降级实现为「`data-dsh-panel-host-degraded` 属性 + rAF 视口同步」（非独立 absolute 模式，见 §5.1 注释）。
+  - chunk 缓存实现为 **ETag HEAD 重验证**而非内容哈希（bundle 路由已发 ETag，HEAD 更廉价）；`resetChunks()` 保留（测试隔离），激活路径改用 `revalidateChunksOnReactivate()`。
+  - `#root` 防溢出采用 `width: calc(100% - var)` + width/margin **锁步过渡**（避免动画断裂），并实测 1140+300=1440。
+  - 桌面避让复用既有 `titleBarCompat/titleBarStripPx` 通道（未新增 `--dsh-desktop-top-inset` 变量）；darwin 红绿灯区仅预留（当前无左侧贴边控件）。
+  - 测试环境为 Node + 手写 shim（非 jsdom）：`browser-globals.ts` 补 `location`；desktop-env 剥除 `location.search` 前导 `?`（真实 bug，顺带修复）。
+  - 本地 Node 24 跑 `test:mount` 需 `node --expose-internals` 启动 dsh CLI（HMR 服务要求，CI Node 22 无此问题）——本地用 DSH_CMD 包装，不改仓库脚本。
+  - **CR #232 修复（2026-08-19）**：① 降级同步改为按**未修正几何**判定（跟踪自身补偿量，祖先 transform 消失才退出循环）；② chunk 重验证成为 `loadChunk` 屏障（重验证挂起期间不提供缓存，杜绝 HMR 竞态陈旧 exports）；③ 键盘 inset 公式补 `visualViewport.offsetTop` 并监听 `scroll`。