dsh-conversation-navigator 0.2.5 → 0.2.7

package/README.en.md

@@ -22,7 +22,7 @@ Browser-only (no host behavior), plain JavaScript, zero build step, zero npm dep
 ![Minimal mode · collapsed](https://raw.githubusercontent.com/gjj-star/dsh-conversation-navigator/main/assets/modes/mode-minimal-hide.png)
 ![Minimal mode · expanded](https://raw.githubusercontent.com/gjj-star/dsh-conversation-navigator/main/assets/modes/mode-minimal-expand.png)
 
-> Four forms: full, hidden, minimal-right, and minimal-left (the minimal strips collapse to the in-row indicator bars; hover expands the positioning panel). More screenshots in [assets/screenshots](./assets/screenshots). The two "community skins" shots are taken under third-party skins (whale-girl maid theme and the "Your Name" theme), not bundled with the plugin.
+> Three forms: full, hidden, and minimal-left (minimal-right is shelved as of 0.2.6, code retained). The minimal strips collapse to the in-row indicator bars; hover expands the positioning panel. More screenshots in [assets/screenshots](./assets/screenshots). The two "community skins" shots are taken under third-party skins (whale-girl maid theme and the "Your Name" theme), not bundled with the plugin.
 
 ## Features
 
@@ -30,12 +30,11 @@ Browser-only (no host behavior), plain JavaScript, zero build step, zero npm dep
 - **Keyword filter**: click the top-left search icon to reveal the inline input; matches only your questions + the assistant's actual reply text (context, tool calls, commands, compaction and reasoning never match); hits are highlighted and the list text is windowed to the keyword
 - **Expand / collapse steps**: the arrow button on the right of each turn row (`▸ N`, rotates to `▾` when expanded) smoothly expands or collapses the turn's step details (assistant replies, tool calls, commands, compaction points, etc.)
 - **Hover full text**: rest the mouse on a turn row and a bubble shows the user's complete question, no longer truncated to one line
-- **Full / Hidden / Minimal modes**: the header toggle cycles four states —
+- **Full / Hidden / Minimal-left modes**: the header toggle cycles three states —
   - **Full**: the classic grouped view (system events like compaction are shown bold, at the same level as turns)
   - **Hidden**: every row is a trajectory badge + text (user = business blue, assistant = violet, compaction = neutral gray)
-  - **Minimal-right**: the indicator-bar strip docked to the right edge of the viewport
-  - **Minimal-left**: the same strip pinned to the left edge of the conversation area (at the right border of the DSH sidebar), leaving the right side for dsh-better-sidebar
-  - The minimal strip collapses to the in-row indicator bars (current = solid brand color, others = 40% foreground-color mix); hovering expands a fixed 7-row positioning panel (click to jump, hover bubble for the full question, thumb-only scrollbar beyond 7 rows; right-aligned expands from right to left, left-aligned from left to right); a floating button above the bars keeps cycling forward (minimal-right → minimal-left → Full); the toggle yields while the search input is open
+  - **Minimal-left**: the indicator-bar strip pinned to the left edge of the conversation area (at the right border of the DSH sidebar), leaving the right side for dsh-better-sidebar and zero overlap with the official rail
+  - The minimal strip collapses to the in-row indicator bars (current = solid brand color, others = 40% foreground-color mix); hovering expands a fixed 7-row positioning panel (click to jump, hover bubble for the full question, thumb-only scrollbar beyond 7 rows; left-aligned expands from left to right); a floating button above the bars keeps cycling forward (minimal-left → Full); the toggle yields while the search input is open
 - **Draggable panel**: in Full / Hidden mode, grab the header to drag the panel anywhere in the viewport (auto-clamped to the edges; the expanded height is capped at half the viewport with the top edge fixed and the panel growing downward — expanding a huge turn scrolls the list internally while the "Back to latest / Collapse all" footer stays reachable); the pin button in the header toggles between the default right-dock and the last dragged position; the dragged position and the minimal left/right alignment survive page reloads via localStorage
 - **Resizable panel**: drag from the bottom-left rounded corner (Full / Hidden modes only) — width 240–560 px, height vertical. Height follows a content-adaptive + cap model: actual height = min(turn content, the cap you drag to), tracking the number of turns with no blank space under the footer; floor ~3 turns, ceiling within the conversation viewport. The drag tracks the pointer 1:1 and is fully reversible; width/height persist in localStorage
 - **Silky motion**: panel fade, step expand/collapse height transitions, staggered fade-in of filter results, rotating collapse arrow — all pure CSS, zero dependencies
@@ -64,34 +63,37 @@ pnpm pack
 dsh plugin --profile web add ./dsh-conversation-navigator-<version>.tgz
 ```
 
-`dsh plugin` forwards to pnpm inside the profile directory, so **pnpm must be on your PATH**; installation appends this package to the profile's `dsh.profile.bundles`, and its bundled `cordis.patch.yml` layer inserts the plugin row. Restart `dsh web` and the panel appears (expanded by default).
+`dsh plugin` forwards to pnpm inside the profile directory, so **pnpm must be on your PATH**; installation appends this package to the profile's `dsh.profile.bundles`, and its bundled `cordis.patch.yml` layer inserts the plugin row. Restart `dsh web` and the panel appears. **Dual-form defaults**: on official DSH < 0.1.2-rc.1 (no built-in navigator) the panel is expanded by default; on official DSH ≥ 0.1.2-rc.1 (the conversation view ships the built-in TurnNavigator rail) the panel starts closed in "minimal-left" form with the search box collapsed, summoned by the "导航" title-bar toggle, with zero overlap against the official right-edge rail.
 
 > Manual install (no pnpm): place the repo at `<DSH_HOME>\profiles\<profile>\node_modules\dsh-conversation-navigator` and append the content of [`example.patch.yml`](./example.patch.yml) to the top-level array of the profile's `cordis.patch.yml`.
 
 ## Updates
 
-Edit `lib/client.js` and restart `dsh web`. Docked state, dragged position, minimal alignment and the panel width/height persist (localStorage `dsh-cnvnav:ui:v1`); expand/collapse, mode selection and search keywords still live only within the page session.
+Edit `lib/client.js` and restart `dsh web`. Docked state, dragged position, minimal alignment and the panel width/height persist (localStorage `dsh-cnvnav:ui:v2`); the open/closed state is deliberately NOT persisted — on the new host the panel always starts closed — and search keywords still live only within the page session.
 
 > Published to npm as `dsh-conversation-navigator` (the version badge above always shows the latest release); to upgrade an installed copy, update from the marketplace or run `dsh plugin --profile web add dsh-conversation-navigator` again, then restart.
 
 ## How it works
 
 - Slots: `conversation.session.header.utilities` (the "导航" toggle in the title bar) + `shell.overlay` (the floating panel)
-- Data: the session-level standard props `useSession` (selects the stable render order `order` of `ConversationSnapshot.chat` + the `ChatNodeStore`), grouped by `node.location` turn
+- Data (dual-form): legacy hosts read the session-level standard props `useSession`; new hosts (official ≥ 0.1.2-rc.1) read the `uiConversation.binding(binding).target("chat")` snapshot — the primary channel groups by the official `timeline.turnOrder` + `locations` index, backs off to `ChatNodeStore.values()` (mapping via the node's own `location` or its `anchorSeq` against the official turn boundaries), and finally merges the official `turnOutline` projection (`sessions.projectionStore(sid).get("turnOutline")` / the slot standard prop `useProjection`, the same source the official rail's `mergeTurnRailItems` uses) to restore user messages the assembly index drops and to add out-of-window turns; re-derived automatically on `loadOlder`
 - History backfill: pages back through `sessions`'s `binding(sessionId).session.loadOlder()`, "Load all" loops until `hasMore=false`
 - Jumping: reuses the DSH chat view's own stable DOM anchor `[data-chat-anchor-key]` (the same anchor the product uses internally for paging/scroll positioning) with `scrollIntoView` smooth scrolling
 - Position tracking: captures scroll events on the `[data-conversation-scroll]` container (throttled 120ms) and computes the first visible node at the viewport top
 - Keyword filter: extracts searchable text only for `user` and `assistant-step` nodes (`dialogueText`), case-insensitive matching, hits wrapped in `<mark>` and the display windowed around the first hit
 - Hover full text: the turn-row bubble reads `fullDialogueText` (all text blocks of the user node joined), shown via `Tooltip` with a 340px width cap
-- Modes: the header button cycles `viewMode` (full/hidden/minimal/minimal-left); hidden replaces the turn head title with a trajectory badge (`titleNode` strategy); minimal-right is docked by CSS `right`, minimal-left is pinned to `scrollport.left + 12` (the placement key includes `r.left` and a ResizeObserver on the chat area re-anchors it whenever the left sidebar expands or collapses); the toggle yields while the search input is open
+- Modes: the header button cycles `viewMode` (full/hidden/minimal-left; `minimal`/minimal-right is commented out and retained); hidden replaces the turn head title with a trajectory badge (`titleNode` strategy); minimal-left is pinned to `scrollport.left + 12` (the placement key includes `r.left` and a ResizeObserver on the chat area re-anchors it whenever the left sidebar expands or collapses); the toggle yields while the search input is open
 - Drag & persistence: the full-panel header is draggable (pointer events, clamped to the viewport); dragging or the pin toggles `docked`; `place()` only clamps a freely-placed panel into the viewport instead of re-docking it; the position, docked state and alignment choice persist in localStorage (`dsh-cnvnav:ui:v1`)
 - Resize: a transparent bottom-left corner grip captures pointer events; width writes `style.width` directly (240–560), height only adjusts `maxHeight` while `height` stays `auto`, so the actual height is always min(content, cap) with no blank space; dragging follows the start point linearly (`base + delta`) and shares the same container/viewport clamps as `place()` so nothing snaps on release; width/height persist as `panelWidth`/`panelHeight`
 - Styling: `Button`/`Tooltip`/search & close icons reuse `@deepseek-ai/dsh-client-ui-primitives`, the rest are inline Lucide SVGs (ISC License); the panel injects its own `<style>` element, colors use `--dsw-*` theme tokens; everything is cleaned up with the fiber on unload
 
 ## Compatibility
 
-- Target platform: DSH Web (`dsh.client.platform: web`), depends on the kernel seed's `react`, `slots`, `sessions` services and `@deepseek-ai/dsh-client-ui-primitives`, plus the standard capabilities provided by `dsh-client-runtime` and `dsh-client-ui-conversation` (`dsh.client.inject` declares runtime and conversation)
-- **Version-sensitive points**: `[data-chat-anchor-key]` / `[data-conversation-scroll]` are the current DOM anchor conventions of the DSH chat view; if they change after a DSH upgrade, only `findAnchor` / `computeActiveKey` in `lib/client.js` need adjusting
+- Target platform: DSH Web (`dsh.client.platform: web`), depends on the kernel seed's `react`, `slots`, `sessions` services and `@deepseek-ai/dsh-client-ui-primitives`; `dsh.client.inject` declares `@deepseek-ai/dsh-client-ui-conversation` (`dsh-client-runtime` was removed in official v0.1.2-rc.1 and is no longer injected)
+- **Dual form (0.2.6)**: the host form is detected at runtime via feature detection — the presence of the `uiConversation` service marks the new host (official ≥ 0.1.2-rc.1); no hardcoded version numbers. `uiConversation` is now declared in the client `exports.inject`, so the runtime guarantees it is ready and host detection no longer flips with load timing. Legacy hosts keep the full navigator (expanded by default); new hosts coexist with the official TurnNavigator: closed by default, "minimal-left" form, search box collapsed by default — the official rail handles jumping, this plugin focuses on keyword search, bulk "Load all" and step-level badges
+- **Host version note**: fully verified on official **DSH v0.1.2-rc.1** (Web) — the new `uiConversation` service, the `conversation.session.header.utilities` empty-props contract, the chat target snapshot (`timeline`/`locations`/`nodes`/`navigation`/`legacy`) and the `turnOutline` projection. Legacy hosts (no `uiConversation`) are covered by the `useSession` path; older official versions are not individually regression-tested
+- **Host dependency declaration**: `@deepseek-ai/dsh-client-ui-conversation` is declared as a `peerDependencies` semver range (the awesome-dsh-plugin convention; dshmarket's dependency check surfaces host compatibility from it)
+- **Version-sensitive points**: `[data-chat-anchor-key]` / `[data-conversation-scroll]` are the current DOM anchor conventions of the DSH chat view (verified still present in official v0.1.2-rc.1); if they change after a DSH upgrade, only `findAnchor` / `computeActiveKey` in `lib/client.js` need adjusting
 - No hard `timer` dependency: the client timer service is used for throttling when present, and degrades to unthrottled otherwise
 
 ## Structure

package/README.md

@@ -22,7 +22,7 @@
 ![极简模式·收起](https://raw.githubusercontent.com/gjj-star/dsh-conversation-navigator/main/assets/modes/mode-minimal-hide.png)
 ![极简模式·展开](https://raw.githubusercontent.com/gjj-star/dsh-conversation-navigator/main/assets/modes/mode-minimal-expand.png)
 
-> 四种形态:显示轮次、隐藏轮次、极简·右、极简·左(极简收起仅露行内指示条,悬停展开定位面板)。完整截图见 [assets/screenshots](./assets/screenshots)。其中「社区皮肤适配」两张为第三方皮肤下的效果(鲸鱼娘女仆主题与君の名は主题),非插件自带。
+> 三种形态:显示轮次、隐藏轮次、极简·左(极简·右已暂缓,代码保留在仓库中;极简收起仅露行内指示条,悬停展开定位面板)。完整截图见 [assets/screenshots](./assets/screenshots)。其中「社区皮肤适配」两张为第三方皮肤下的效果(鲸鱼娘女仆主题与君の名は主题),非插件自带。
 
 ## 功能
 
@@ -30,8 +30,8 @@
 - **关键词过滤**:点击左上角搜索图标呼出输入框,只按「你的提问 + 助手实际回复文本」过滤(上下文、工具、命令、压缩、推理等不参与匹配),命中词高亮,列表文本自动定位到关键词处
 - **展开/折叠步次**:点击轮次行右侧的箭头按钮(`▸ N`,展开时旋转为 `▾`)平滑展开/折叠该轮的步次明细(助手回复、工具调用、命令、压缩点等)
 - **悬停查看全文**:鼠标在轮次行停留片刻,气泡显示该轮用户提问的完整原文,不再被单行截断
-- **显示 / 隐藏 / 极简四种形态**:头部切换按钮四态循环——「显示轮次」为经典分组视图(压缩等系统事件与轮次同级加粗展示)→「隐藏轮次」每行统一为轨迹徽标 + 文本(用户 = 业务蓝、助手 = 紫罗兰、压缩 = 中性灰)→「极简·右」视口右缘指示条→「极简·左」锚定对话区左缘(为 dsh-better-sidebar 让出右侧),再回到「显示轮次」;
-- 「极简」形态收起时只露行内指示条(当前 = 品牌色实色、非当前 = 主题前景色掺 40%),悬停展开 7 行画幅的定位面板(点击跳转、悬停全文气泡、超 7 条仅滑块滚动;右对齐从右向左展开、左对齐向右展开),外置悬浮按钮继续循环(极简·右→极简·左→显示轮次),搜索框展开时按钮自动让位
+- **显示 / 隐藏 / 极简·左三种形态**:头部切换按钮三态循环——「显示轮次」为经典分组视图(压缩等系统事件与轮次同级加粗展示)→「隐藏轮次」每行统一为轨迹徽标 + 文本(用户 = 业务蓝、助手 = 紫罗兰、压缩 = 中性灰)→「极简·左」锚定对话区左缘(为 dsh-better-sidebar 让出右侧,并与官方右侧轨道零重叠),再回到「显示轮次」;「极简·右」形态自 0.2.6 起暂缓(与官方 TurnNavigator 轨道视觉重叠),代码保留;
+- 「极简」形态收起时只露行内指示条(当前 = 品牌色实色、非当前 = 主题前景色掺 40%),悬停展开 7 行画幅的定位面板(点击跳转、悬停全文气泡、超 7 条仅滑块滚动;左对齐向右展开),外置悬浮按钮继续循环(极简·左→显示轮次),搜索框展开时按钮自动让位
 - **面板可拖动**:显示轮次 / 隐藏轮次面板按住头部即可拖到视口任意位置(自动夹边;展开高度至多半屏,上边缘固定、下边缘展开,超长轮次时列表内部滚动,底部「回到最新/全部折叠」始终可达),头部图钉按钮在「默认右侧停靠」与「上次拖动位置」间切换;拖动位置与极简左/右对齐选择持久化于 localStorage,刷新页面原样恢复
 - **面板尺寸可调**:左下角圆角处拖拽缩放(仅显示轮次 / 隐藏轮次)——横向拖宽(240–560px),纵向拖高/拖矮;高度采用「内容自适应 + 上限」模型:实际高度 = min(轮次内容, 你拖到的上限),随轮数变化、不会在底部产生空白,下限约 3 轮,上限不超过会话可视区;拖拽 1:1 线性跟随、可逆,尺寸持久化于 localStorage
 - **丝滑动效**:面板开合淡入淡出、步次展开/折叠高度过渡、过滤结果逐条级联淡入、折叠箭头旋转——全部纯 CSS 实现,零依赖
@@ -60,34 +60,37 @@ pnpm pack
 dsh plugin --profile web add ./dsh-conversation-navigator-<version>.tgz
 ```
 
-`dsh plugin` 在 profile 目录内转发给 pnpm,因此需要 **pnpm 在 PATH 上**;安装会自动把本包追加进 profile 的 `dsh.profile.bundles`,其自带的 `cordis.patch.yml` 层负责插入插件行。重启 `dsh web` 后生效,面板默认展开。
+`dsh plugin` 在 profile 目录内转发给 pnpm,因此需要 **pnpm 在 PATH 上**;安装会自动把本包追加进 profile 的 `dsh.profile.bundles`,其自带的 `cordis.patch.yml` 层负责插入插件行。重启 `dsh web` 后生效。**双形态默认值**:官方 < 0.1.2-rc.1(无内置导航)时面板默认展开;官方 ≥ 0.1.2-rc.1(会话视图内置 TurnNavigator 轮次轨道)时面板默认关闭、默认形态为「极简·左」、搜索框默认收起,由标题栏「导航」按钮主动呼出,与官方右侧轨道零重叠。
 
 > 手动方式(不依赖 pnpm):把仓库放进 `<DSH_HOME>\profiles\<profile>\node_modules\dsh-conversation-navigator`,并在 profile 的 `cordis.patch.yml` 顶层数组追加 [`example.patch.yml`](./example.patch.yml) 的内容。
 
 ## 更新
 
-修改 `lib/client.js` 后重启 `dsh web` 即可;停靠状态、拖动位置、极简左/右对齐与面板宽高持久化于 localStorage(`dsh-cnvnav:ui:v1`),展开/折叠、模式、搜索关键词等界面状态仍只存于页面会话内。
+修改 `lib/client.js` 后重启 `dsh web` 即可;停靠状态、拖动位置、极简左对齐、面板宽高持久化于 localStorage(`dsh-cnvnav:ui:v2`;面板的展开/收起 `open` 不再持久化——新宿主每次启动都从默认关闭开始,搜索关键词等界面状态仍只存于页面会话内。
 
 > 已发布到 npm(`dsh-conversation-navigator`,徽章实时显示最新版本);升级已安装副本:市场更新或 `dsh plugin --profile web add dsh-conversation-navigator` 后重启。
 
 ## 工作原理
 
 - 注册槽位:`conversation.session.header.utilities`(标题栏「导航」开关)+ `shell.overlay`(浮动面板)
-- 数据来源:会话级标准 props 的 `useSession`(选择 `ConversationSnapshot.chat` 的稳定渲染顺序 `order` + `ChatNodeStore`),按 `node.location` 的 turn 分组
+- 数据来源(双形态):旧宿主走会话级标准 props 的 `useSession`;新宿主(官方 ≥ 0.1.2-rc.1)走 `uiConversation.binding(binding).target("chat")` 快照——主通道为官方 `timeline.turnOrder` + `locations` 索引分组,`ChatNodeStore.values()` 兜底(依节点自带 `location` 或 `anchorSeq` 对照轮次边界归组),再用官方 `turnOutline` 投影(`sessions.projectionStore(sid).get("turnOutline")` / slot 标准 props 的 `useProjection`,与官方 rail 的 `mergeTurnRailItems` 同源)补上被组装器漏挂的用户消息与加载窗口外的轮次;随 `loadOlder` 自动重派生
 - 历史补载:通过 `sessions` 服务的 `binding(sessionId).session.loadOlder()` 分页向后加载,「加载全部」循环至 `hasMore=false`
 - 跳转定位:复用 DSH 聊天视图自身的稳定 DOM 锚点 `[data-chat-anchor-key]`(与产品内部 paging/scroll 定位同源),`scrollIntoView` 平滑滚动
 - 位置跟踪:捕获 `[data-conversation-scroll]` 滚动容器的 scroll 事件(节流 120ms),计算视口顶部首个可见节点
 - 关键词过滤:仅为 `user` 与 `assistant-step` 节点提取检索文本(`dialogueText`),大小写不敏感匹配,命中片段以 `<mark>` 高亮并按首个命中位置截取显示窗口
 - 悬停全文:轮次头气泡读取 `fullDialogueText`(用户节点全部文本块拼接),用 `Tooltip` 展示并限宽 340px
-- 显示/隐藏/极简模式:`viewMode` 四态循环(full/hidden/minimal/minimal-left),隐藏时仅把轮次头标题替换为轨迹徽标(`titleNode` 策略);极简右对齐由 CSS `right` 锚定视口右缘、左对齐以 `scrollport.left + 12` 钉在对话区左缘(定位 key 含 `r.left`,并用 ResizeObserver 监听对话区宽度变化,左侧栏展开/折叠时紧贴跟随);搜索框展开时按钮让位
+- 显示/隐藏/极简模式:`viewMode` 三态循环(full/hidden/minimal-left,「极简·右」minimal 已注释保留),隐藏时仅把轮次头标题替换为轨迹徽标(`titleNode` 策略);极简左对齐以 `scrollport.left + 12` 钉在对话区左缘(定位 key 含 `r.left`,并用 ResizeObserver 监听对话区宽度变化,左侧栏展开/折叠时紧贴跟随);搜索框展开时按钮让位
 - 拖动定位与持久化:面板头部拖拽(pointer events,视口夹边),拖动或图钉切换 `docked` 状态;`place()` 对自由放置的面板只做视口夹边、不再自动停靠;位置、停靠状态与对齐选择存于 localStorage(`dsh-cnvnav:ui:v1`)
 - 拖拽缩放:左下角透明热区捕获 pointer 事件;宽度直接写 `style.width`(240–560),高度只调 `maxHeight` 并保持 `height:auto`,使实际高度恒为 min(内容, 上限) 而不产生空白;拖动以起点为基准线性跟随(`base + 位移`),上限与 `place()` 的容器/视口钳制同源,松手零回弹;宽高随 `panelWidth`/`panelHeight` 持久化
 - 样式:`Button`/`Tooltip`/搜索与关闭图标复用 `@deepseek-ai/dsh-client-ui-primitives`,其余图标为 Lucide 内联 SVG(ISC License);面板容器自建 `<style>` 注入,颜色使用 `--dsw-*` 主题 token;插件卸载时随 fiber 清理
 
 ## 兼容性说明
 
-- 目标平台:DSH Web 端(`dsh.client.platform: web`),依赖内核 seed 的 `react`、`slots`、`sessions` 服务与 `@deepseek-ai/dsh-client-ui-primitives`,以及 `dsh-client-runtime`、`dsh-client-ui-conversation` 提供的标准能力(`dsh.client.inject` 已声明 runtime 与 conversation)
-- **版本敏感点**:`[data-chat-anchor-key]` / `[data-conversation-scroll]` 是当前 DSH 聊天视图的 DOM 锚点约定,DSH 升级后若锚点变化,只需调整 `lib/client.js` 中 `findAnchor` / `computeActiveKey` 两个函数
+- 目标平台:DSH Web 端(`dsh.client.platform: web`),依赖内核 seed 的 `react`、`slots`、`sessions` 服务与 `@deepseek-ai/dsh-client-ui-primitives`;`dsh.client.inject` 声明 `@deepseek-ai/dsh-client-ui-conversation`(`dsh-client-runtime` 已于官方 v0.1.2-rc.1 移除,不再注入)
+- **双形态(0.2.6)**:运行时用 feature detection 区分宿主——存在 `uiConversation` 服务即新宿主(官方 ≥ 0.1.2-rc.1),不硬编码版本号。`uiConversation` 已加入客户端 `exports.inject` 声明,运行时保证其先就绪,宿主检测稳定不再随加载时序翻转。旧宿主保持全功能导航器(默认展开);新宿主与官方内置 TurnNavigator 共存:默认关闭 + 「极简·左」 + 搜索框默认收起,官方轨道负责跳转,本插件专注关键词搜索、批量「加载全部」与步次级徽标
+- **宿主版本说明**:已在官方 **DSH v0.1.2-rc.1**(Web 端)完整验证——含新的 `uiConversation` 服务、`conversation.session.header.utilities` 空 props 契约、chat target 快照(`timeline`/`locations`/`nodes`/`navigation`/`legacy`)与 `turnOutline` 投影;旧宿主(无 `uiConversation`)经 `useSession` 路径兼容保留,未在 0.1.2-rc.1 之前的官方版本上逐一回归
+- **宿主依赖声明**:`@deepseek-ai/dsh-client-ui-conversation` 以 peerDependencies + semver 范围声明(awesome-dsh-plugin 约定,dshmarket 的依赖检查据此展示宿主兼容性)
+- **版本敏感点**:`[data-chat-anchor-key]` / `[data-conversation-scroll]` 是当前 DSH 聊天视图的 DOM 锚点约定(官方 v0.1.2-rc.1 中已验证仍在),DSH 升级后若锚点变化,只需调整 `lib/client.js` 中 `findAnchor` / `computeActiveKey` 两个函数
 - 未声明 `timer` 硬依赖:客户端的 timer 服务存在则用于节流,不存在时自动退化为未节流模式
 
 ## 目录结构

package/lib/client.js

@@ -351,17 +351,33 @@ window.__ModuleLoader__.load({
 			if (slots === undefined) return;
 			const timer = ctx.get("timer");
 			const sessions = ctx.get("sessions");
+			/* 宿主形态检测:官方 v0.1.2-rc.1 起引入 uiConversation 服务并把会话节点
+			   数据从 session 快照挪到 chat target 快照。用 feature detection,
+			不硬编码版本号。 */
+			const uiConversation = ctx.get("uiConversation");
+			const NEW_HOST = uiConversation !== undefined;
+			/* 运行时只保证 exports.inject 声明的服务先就绪; uiConversation 未声明时
+			   会在"已物化/未物化"之间随机翻转(apply 竞态), 导致宿主检测时好时坏。
+			   这里提供实时重查, 供效果/布局在运行时使用, 不缓存负结果。 */
+			const getUiConv = () => ctx.get("uiConversation");
+			const isNewHostNow = () => getUiConv() !== undefined;
 
 			/* own stylesheet with fiber-scoped cleanup */
 			const styleEl = document.createElement("style");
 			styleEl.setAttribute("data-dsh-cnvnav", "");
 			styleEl.textContent = CSS;
 			document.head.appendChild(styleEl);
-			ctx.effect(() => () => styleEl.remove());
+			ctx.effect(() => () => {
+				styleEl.remove();
+				if (chatUnsub !== null) { chatUnsub(); chatUnsub = null; }
+			});
 
 			/* ---------- shared store (toggle button + overlay panel) ---------- */
-			const UI_KEY = "dsh-cnvnav:ui:v1";
-			const VIEW_MODES = ["full", "hidden", "minimal", "minimal-left"];
+			/* 0.2.6: 键名升级 v2 —— 旧 v1 记录(0.2.5 时代)在新宿主下会以 viewMode:"full" 等旧值
+			   覆盖新的 minimal-left 默认,导致"验收不过";升级后新宿主从干净默认开始 */
+			const UI_KEY = "dsh-cnvnav:ui:v2";
+			/* 极简·右(minimal)与新宿主官方 rail 视觉重叠,先注释掉保留代码,待有更好的共存方案再恢复 */
+			const VIEW_MODES = ["full", "hidden", /* "minimal", */ "minimal-left"];
 			function readUi() {
 				try {
 					const raw = window.localStorage.getItem(UI_KEY);
@@ -370,6 +386,8 @@ window.__ModuleLoader__.load({
 					const out = {};
 					if (VIEW_MODES.indexOf(o.viewMode) !== -1) out.viewMode = o.viewMode;
 					if (o.docked === true || o.docked === false) out.docked = o.docked;
+					/* open 不持久化: 新宿主每次启动都从默认(关闭)开始,
+					   避免重启/正常启动时面板被旧状态默认展开 */
 					if (typeof o.panelWidth === "number" && o.panelWidth >= 240 && o.panelWidth <= 560) out.panelWidth = o.panelWidth;
 					if (typeof o.panelHeight === "number" && o.panelHeight >= 90 && o.panelHeight <= 2000) out.panelHeight = o.panelHeight;
 					if (o.userPos && typeof o.userPos.left === "number" && typeof o.userPos.top === "number"
@@ -384,15 +402,18 @@ window.__ModuleLoader__.load({
 			function persistUi() {
 				try {
 					window.localStorage.setItem(UI_KEY, JSON.stringify({
-						viewMode: state.viewMode, docked: state.docked, userPos: state.userPos, panelWidth: state.panelWidth, panelHeight: state.panelHeight,
+						viewMode: state.viewMode, docked: state.docked, userPos: state.userPos, panelWidth: state.panelWidth, panelHeight: state.panelHeight, open: state.open,
 					}));
 				} catch (err) { /* 隐私模式等场景忽略 */ }
 			}
 			const savedUi = readUi();
 			let state = Object.assign({
-				open: true, sessionId: null, outline: null, activeKey: null, expanded: {},
+				/* 双形态默认值:旧宿主保持全功能导航器(默认展开);
+				   新宿主(官方内置 TurnNavigator 常显)默认关闭 + 极简·左,
+				   与官方右侧 rail 零重叠,由用户主动呼出。 */
+				open: NEW_HOST ? false : true, sessionId: null, outline: null, activeKey: null, expanded: {},
 				hasMore: false, loadingOlder: false, loadingAll: false,
-				viewMode: "full", docked: true, userPos: null, panelWidth: 288, panelHeight: null,
+				viewMode: NEW_HOST ? "minimal-left" : "full", docked: true, userPos: null, panelWidth: 288, panelHeight: null,
 			}, savedUi);
 			const listeners = new Set();
 			function setState(patch) {
@@ -457,6 +478,12 @@ window.__ModuleLoader__.load({
 			function firstText(blocks) {
 				if (!Array.isArray(blocks)) return null;
 				for (const b of blocks) {
+					/* 官方 user.content 为嵌套数组(多 part),递归展平提取 */
+					if (Array.isArray(b)) {
+						const inner = firstText(b);
+						if (inner !== null) return inner;
+						continue;
+					}
 					if (!b || typeof b !== "object") continue;
 					if ((b.type === "text" || b.kind === "text") && typeof b.text === "string" && b.text.trim() !== "") return b.text;
 				}
@@ -467,11 +494,13 @@ window.__ModuleLoader__.load({
 			function dialogueText(node) {
 				const d = node && node.data;
 				if (!d || typeof d !== "object") return null;
-				if (node.kind === "user") return firstText(d.content);
+				if (node.kind === "user" || node.kind === "input-message") return firstText(d.content);
 				if (node.kind === "assistant-step") {
 					if (!Array.isArray(d.blocks)) return null;
 					const parts = [];
-					for (const b of d.blocks) {
+					/* 官方 assistant.blocks 同样可能嵌套,先展平 */
+					const flat = d.blocks.flatMap((x) => Array.isArray(x) ? x : [x]);
+					for (const b of flat) {
 						if (!b || typeof b !== "object") continue;
 						if ((b.type === "text" || b.kind === "text") && typeof b.text === "string" && b.text.trim() !== "") parts.push(b.text.trim());
 					}
@@ -483,14 +512,16 @@ window.__ModuleLoader__.load({
 		function fullDialogueText(node) {
 			const d = node && node.data;
 			if (!d || typeof d !== "object") return null;
-			if (node.kind !== "user") return null;
+			if (node.kind !== "user" && node.kind !== "input-message") return null;
 			if (typeof d.content === "string") {
 				const t = d.content.trim();
 				return t === "" ? null : t;
 			}
 			if (!Array.isArray(d.content)) return null;
 			const parts = [];
-			for (const b of d.content) {
+			/* 官方 user.content 为嵌套数组(多 part),先展平 */
+			const flat = d.content.flatMap((x) => Array.isArray(x) ? x : [x]);
+			for (const b of flat) {
 				if (!b || typeof b !== "object") continue;
 				if ((b.type === "text" || b.kind === "text") && typeof b.text === "string" && b.text.trim() !== "") parts.push(b.text.trim());
 			}
@@ -632,6 +663,220 @@ window.__ModuleLoader__.load({
 				return cacheValue;
 			}
 
+			/* ---------- 新宿主大纲:官方 v0.1.2-rc.1 起会话节点从 session 快照
+			   挪到 chat target 快照(uiConversation.binding(...).target("chat"))。
+			   走其 legacy 兼容投影(有序 nodes + turnEnds 轮次边界)派生大纲。 ---------- */
+			const KIND_META_NEW = {
+				"user": { label: "你", cls: "traj-user" },
+				"steering": { label: "插话", cls: "traj-user" },
+				"context": { label: "上下文", cls: "traj-context" },
+				"assistant-step": { label: "助手", cls: "traj-assistant" },
+				"tool-call": { label: "工具", cls: "traj-tool" },
+				"command": { label: "命令", cls: "other-command" },
+				"compaction": { label: "压缩", cls: "traj-compacted" },
+				"manual-compaction": { label: "压缩", cls: "traj-compacted" },
+				"model-retry": { label: "重试", cls: "other-retry" },
+				"turn-error": { label: "出错", cls: "other-error" },
+				"turn-max-tokens": { label: "截断", cls: "other-error" },
+				/* 官方 Chat 节点额外 renderer kind:
+				   turn-process 回合过程折叠、turn-tail 轮尾、system-prompt 系统提示 */
+				"turn-process": { label: "过程", cls: "other-neutral" },
+				"turn-tail": { label: "轮尾", cls: "other-neutral" },
+				"system-prompt": { label: "系统提示", cls: "other-neutral" },
+				"unknown": { label: "其他", cls: "other-neutral" },
+			};
+			function previewForNew(node) {
+				const d = node && node.data;
+				if (!d || typeof d !== "object") return null;
+				switch (node.kind) {
+					case "user":
+					case "steering":
+					case "context":
+						return firstText(d.content);
+					case "assistant-step": {
+						const text = firstText(d.blocks);
+						if (text !== null) return text;
+						if (Array.isArray(d.blocks) && d.blocks.some((b) => b && b.kind === "tool-call")) return "调用工具";
+						return d.status === "running" ? "进行中…" : null;
+					}
+					case "tool-call": {
+						/* data = ToolChatData { root: RunningToolCall | ToolResultNode } */
+						const root = d.root;
+						if (!root || typeof root !== "object") return null;
+						if (root.isError === true) return "执行失败";
+						const name = typeof root.name === "string" && root.name !== "" ? root.name
+							: (root.call && typeof root.call.name === "string" ? root.call.name : null);
+						return name !== null ? name : "工具";
+					}
+					case "command":
+						return typeof d.name === "string" && d.name !== "" ? d.name + (typeof d.args === "string" && d.args !== "" ? " " + d.args : "") : "命令";
+					case "manual-compaction": {
+						const c = d.compaction;
+						if (c && typeof c.summary === "string" && c.summary !== "") return c.summary;
+						return "手动压缩";
+					}
+					case "compaction":
+						return typeof d.summary === "string" && d.summary !== "" ? d.summary : "上下文已压缩";
+					case "model-retry": {
+						const n = Array.isArray(d.attempts) ? d.attempts.length : 0;
+						return "自动重试" + (n > 0 ? " ×" + n : "…");
+					}
+					case "turn-error":
+						return typeof d.message === "string" && d.message !== "" ? d.message : "本轮出错";
+					case "turn-max-tokens":
+						return "达到输出上限";
+					case "turn-process": {
+						const n = typeof d.toolCallCount === "number" ? d.toolCallCount : 0;
+						const s = typeof d.subagentCount === "number" ? d.subagentCount : 0;
+						return "过程" + (n > 0 ? " · " + n + " 工具" : "") + (s > 0 ? " · " + s + " 子代理" : "");
+					}
+					case "turn-tail":
+						return null;
+					case "system-prompt":
+						return "系统提示";
+					case "unknown":
+						return typeof d.type === "string" ? "未知事件 " + d.type : "未知事件";
+					default:
+						return null;
+				}
+			}
+			function deriveOutlineNew(snap) {
+				const empty = { groups: [], count: 0, byKey: {} };
+				if (snap === null || snap === undefined) return empty;
+				/* 官方 Chat 快照: order = 可见节点(按展示序), nodes = 键→节点存储。
+				   只遍历 order 可见节点, 保证每个 item.key 都有对应 DOM 锚点
+				   (data-chat-anchor-key = node.key)。被 turn-process 折叠隐藏的
+				   "助手:调用工具" 等隐藏节点(无锚点)不再产生不可跳转的死行。 */
+				const order = snap.order;
+				const nodesMap = snap.nodes;
+				if (!Array.isArray(order) || nodesMap === undefined || nodesMap === null || typeof nodesMap.get !== "function") return empty;
+				function turnOfNode(node) {
+					const loc = node !== null && node !== undefined ? node.location : undefined;
+					if (loc === undefined || loc === null || typeof loc !== "object") return null;
+					if (loc.kind === "turn" || loc.kind === "step") {
+						const t = loc.turn;
+						return t !== undefined && t !== null && typeof t.turn === "number" ? t.turn : null;
+					}
+					return null;
+				}
+				const groups = [];
+				const byKey = {};
+				let current = null;
+				let count = 0;
+				for (const key of order) {
+					const node = nodesMap.get(key);
+					if (node === undefined || node === null) continue;
+					const meta = KIND_META_NEW[node.kind] || KIND_META_NEW.unknown;
+					const item = {
+						key: String(node.key !== undefined && node.key !== null ? node.key : node.anchorSeq),
+						kind: node.kind,
+						label: meta.label,
+						cls: meta.cls,
+						preview: previewForNew(node),
+						search: dialogueText(node),
+						full: fullDialogueText(node),
+						time: fmtTime(timeOf(node)),
+					};
+					const turn = turnOfNode(node);
+					if (turn === null) {
+						groups.push({ turn: null, items: [item], gid: "x" + groups.length });
+						count += 1;
+						current = null;
+						continue;
+					}
+					if (current === null || current.turn !== turn) {
+						current = { turn: turn, items: [], gid: "t" + turn };
+						groups.push(current);
+					}
+					current.items.push(item);
+					count += 1;
+				}
+				for (const g of groups) {
+					const first = g.items[0];
+					if (g.turn === null) {
+						g.title = first.label;
+						g.subtitle = truncate(first.preview || "", 60);
+						g.headKey = first.key;
+						g.headIsUser = false;
+					} else {
+						g.title = "第 " + g.turn + " 轮";
+						const head = first.kind === "user" ? first : null;
+						g.headKey = head ? head.key : first.key;
+						g.headIsUser = head !== null;
+						g.subtitle = truncate((head ? head.preview : first.preview) || "", 60);
+					}
+					for (const it of g.items) byKey[it.key] = g.gid;
+				}
+				return { groups: groups, count: count, byKey: byKey };
+			}
+			/* 投影合并:官方 turnOutline 投影(全会话 {turn, seq, prompt, response} 摘要),
+			   与官方 rail 的 mergeTurnRailItems 同源。用它为缺失用户消息的轮次补一个
+			   合成"你"条目, 并为加载窗口外的轮次生成纯投影分组。 */
+			function mergeOutlineWithProjection(outline, proj) {
+				if (outline === null || outline === undefined) return null;
+				if (!Array.isArray(proj) || proj.length === 0) return null;
+				const byTurn = {};
+				for (const e of proj) {
+					if (e === null || typeof e !== "object") continue;
+					if (typeof e.turn !== "number" || !Number.isSafeInteger(e.turn)) continue;
+					byTurn[e.turn] = e;
+				}
+				const groups = [];
+				const byKey = {};
+				let count = 0;
+				let changed = false;
+				for (const g of outline.groups) {
+					const items = g.items.slice();
+					const projE = byTurn[g.turn];
+					const headIsUser = items.length > 0 && (items[0].kind === "user" || items[0].kind === "input-message");
+					if (projE !== undefined && typeof projE.prompt === "string" && projE.prompt !== "" && !headIsUser) {
+						items.unshift({
+							key: "proj-" + g.turn + "-user",
+							kind: "user", label: "你", cls: "traj-user",
+							preview: truncate(projE.prompt, 120),
+							search: projE.prompt,
+							full: projE.prompt,
+							time: null, seq: null, synthetic: true,
+						});
+						changed = true;
+					}
+					const first = items[0];
+					const ng = {
+						turn: g.turn, items: items, gid: g.gid,
+						title: "第 " + g.turn + " 轮",
+						headKey: first !== undefined ? first.key : g.headKey,
+						headIsUser: first !== undefined && (first.kind === "user" || first.kind === "input-message"),
+						subtitle: truncate((first ? first.preview : null) || "", 60),
+					};
+					groups.push(ng);
+					count += ng.items.length;
+				}
+				for (const numStr of Object.keys(byTurn)) {
+					const num = Number(numStr);
+					if (groups.some((g) => g.turn === num)) continue;
+					const projE = byTurn[num];
+					const items = [];
+					if (typeof projE.prompt === "string" && projE.prompt !== "") {
+						items.push({ key: "proj-" + num + "-user", kind: "user", label: "你", cls: "traj-user", preview: truncate(projE.prompt, 120), search: projE.prompt, full: projE.prompt, time: null, seq: null, synthetic: true });
+					}
+					if (typeof projE.response === "string" && projE.response !== "") {
+						items.push({ key: "proj-" + num + "-resp", kind: "assistant", label: "助手", cls: "traj-assistant", preview: truncate(projE.response, 120), search: projE.response, full: projE.response, time: null, seq: null, synthetic: true });
+					}
+					if (items.length === 0) continue;
+					const first = items[0];
+					groups.push({ turn: num, items: items, gid: "t" + num, title: "第 " + num + " 轮", headKey: first.key, headIsUser: true, subtitle: truncate(first.preview || "", 60) });
+					count += items.length;
+					changed = true;
+				}
+				if (!changed) return null;
+				groups.sort((a, b) => a.turn - b.turn);
+				for (const g of groups) for (const it of g.items) byKey[it.key] = g.gid;
+				return { groups: groups, count: count, byKey: byKey };
+			}
+			/* 新宿主 chat target 订阅:随 loadOlder 等更新自动重派生大纲 */
+			let chatUnsub = null;
+			let projUnsub = null;
+
 			/* ---------- DOM helpers: jump + position tracking ---------- */
 			function findAnchor(key) {
 				const rows = document.querySelectorAll("[data-chat-anchor-key]");
@@ -686,9 +931,104 @@ window.__ModuleLoader__.load({
 				const outline = props.useSession(selectOutline);
 				const hasMore = props.useSession((s) => s.hasMore);
 				const loadingOlder = props.useSession((s) => s.loadingOlder);
+				/* 投影通道 B:slot 标准 props 的 useProjection(官方 rail 同款) */
+				const turnOutlineProj = typeof props.useProjection === "function" ? props.useProjection("turnOutline") : undefined;
 				React.useEffect(() => {
-					setState({ sessionId: props.sessionId, outline: outline, hasMore: hasMore, loadingOlder: loadingOlder });
+					if (!NEW_HOST || turnOutlineProj === undefined || !Array.isArray(turnOutlineProj) || turnOutlineProj.length === 0) return;
+					try {
+						const merged = mergeOutlineWithProjection(state.outline, turnOutlineProj);
+						if (merged !== null) setState({ outline: merged });
+					} catch (err) {
+						console.error("[cnvnav] projection(use) merge failed", err);
+					}
+				}, [turnOutlineProj]);
+				React.useEffect(() => {
+					/* 旧宿主:大纲来自 useSession 的 chat 快照;新宿主:大纲由下方
+					   chat target 订阅独立驱动,此处只同步会话级字段。 */
+					setState(Object.assign({
+						sessionId: props.sessionId, hasMore: hasMore, loadingOlder: loadingOlder,
+					}, NEW_HOST ? {} : { outline: outline }));
 				}, [outline, props.sessionId, hasMore, loadingOlder]);
+				React.useEffect(() => {
+					/* 实时重查宿主(apply 时 uiConversation 可能尚未物化, 不依赖 NEW_HOST 常量) */
+					if (getUiConv() === undefined) {
+						/* 旧宿主:大纲由上方 effect 的 props.useSession 派生, 无需此处订阅 */
+						return;
+					}
+					if (chatUnsub !== null) { chatUnsub(); chatUnsub = null; }
+					if (projUnsub !== null) { projUnsub(); projUnsub = null; }
+					/* 会话恢复的时序竞争修复:binding/target 未物化时不再静默放弃,
+					   订阅 sessions.list + 定时兜底自动重试(重启后导航空的根因) */
+					const trySubscribe = () => {
+						if (props.sessionId == null || sessions === undefined) {
+							setState({ outline: null });
+							return true; /* 无会话:状态已处理,无需重试 */
+						}
+						try {
+							const binding = sessions.binding(props.sessionId);
+							if (binding === undefined) {
+								return false;
+							}
+							const uiConv = getUiConv(); /* 兜底重查, 不依赖 apply 时刻的快照 */
+							if (uiConv === undefined) {
+								return false;
+							}
+							const target = uiConv.binding(binding).target("chat");
+							if (target === undefined) {
+								return false;
+							}
+						/* 投影兜底:官方 turnOutline 投影(全会话轮次摘要, 含加载窗口外轮次)
+						   与官方 rail 的 mergeTurnRailItems 同源 —— 用它补上被组装器
+						   漏掉的用户消息与窗口外轮次。 */
+						const projStore = sessions.projectionStore !== undefined && typeof sessions.projectionStore === "function"
+							? sessions.projectionStore(props.sessionId) : undefined;
+						const mergeProj = () => {
+							try {
+								const proj = projStore !== undefined ? projStore.get("turnOutline") : undefined;
+								const merged = mergeOutlineWithProjection(state.outline, proj);
+								if (merged !== null) setState({ outline: merged });
+							} catch (err) {
+								console.error("[cnvnav] projection merge failed", err);
+							}
+						};
+						const update = () => {
+							try {
+								const snap = target.getSnapshot();
+								const outline = deriveOutlineNew(snap);
+								setState({ outline: outline });
+								mergeProj();
+							} catch (err) {
+								console.error("[cnvnav] derive failed", err);
+								setState({ outline: null });
+							}
+						};
+						chatUnsub = target.subscribe(update);
+						update();
+						if (projStore !== undefined) projUnsub = projStore.subscribeAny(mergeProj);
+						mergeProj();
+						return true;
+						} catch (err) {
+							console.error("[cnvnav] subscribe failed", err);
+							return false;
+						}
+					};
+					if (trySubscribe()) return;
+					let dispose = null;
+					let timer = null;
+					let stopped = false;
+					const retry = () => {
+						if (stopped || chatUnsub !== null) return;
+						if (trySubscribe()) cleanup();
+					};
+					const cleanup = () => {
+						stopped = true;
+						if (dispose !== null) { dispose(); dispose = null; }
+						if (timer !== null) { window.clearInterval(timer); timer = null; }
+					};
+					dispose = sessions.list.subscribe(retry);
+					timer = window.setInterval(retry, 400);
+					return cleanup;
+				}, [props.sessionId]);
 				React.useEffect(() => {
 					if (state.sessionId !== null && state.sessionId !== props.sessionId) {
 						lastActive = null;
@@ -716,14 +1056,15 @@ window.__ModuleLoader__.load({
 			function Panel() {
 				const snap = useStore();
 				const [filter, setFilter] = React.useState("");
+				/* 新宿主搜索优先:面板打开时搜索框常驻;旧宿主保持隐藏搜索图标 */
 				const [searchOpen, setSearchOpen] = React.useState(false);
-				const viewMode = snap.viewMode; /* full | hidden | minimal | minimal-left */
+				const viewMode = snap.viewMode; /* full | hidden | minimal-left (极简·右已注释) */
 				const turnsHidden = viewMode !== "full";
 				function nextModeLabel() {
-					return viewMode === "full" ? "隐藏轮次" : viewMode === "hidden" ? "极简·右" : viewMode === "minimal" ? "极简·左" : "显示轮次";
+					return viewMode === "full" ? "隐藏轮次" : viewMode === "hidden" ? "极简·左" : "显示轮次";
 				}
 				function cycleMode() {
-					const next = viewMode === "full" ? "hidden" : viewMode === "hidden" ? "minimal" : viewMode === "minimal" ? "minimal-left" : "full";
+					const next = viewMode === "full" ? "hidden" : viewMode === "hidden" ? "minimal-left" : "full";
 					setState({ viewMode: next });
 					persistUi();
 				}
@@ -859,7 +1200,10 @@ window.__ModuleLoader__.load({
 						if (dragMove !== null) return true;
 						const vw = document.documentElement.clientWidth || 1000;
 						const vh = document.documentElement.clientHeight || 800;
-						const mini = viewMode === "minimal" || viewMode === "minimal-left";
+						/* 新宿主 dock 右侧需让出官方 rail 的 28px 竖带(right: calc(12px - clearance) + width:28px),
+						   留 40px 总避让;旧宿主维持 12px。运行时实时重查, 不依赖 apply 时刻的检测结果。 */
+						const railClearance = isNewHostNow() ? 40 : 12;
+						const mini = /* viewMode === "minimal" || */ viewMode === "minimal-left";
 						const alignLeft = viewMode === "minimal-left";
 						const width = (state.panelWidth || 288);
 						/* 面板宽度对非极简模式统一生效, 确保拖动(未停靠)状态下也能实时刷新 */
@@ -904,7 +1248,7 @@ window.__ModuleLoader__.load({
 									panel.style.top = Math.max(8, Math.round((vh - MINI_H) / 2)) + "px";
 									panel.style.maxHeight = MINI_H + "px";
 								} else {
-									panel.style.left = Math.max(8, vw - width - 12) + "px";
+									panel.style.left = Math.max(8, vw - width - railClearance) + "px";
 									panel.style.top = Math.max(8, 60) + "px";
 									const fh = state.panelHeight;
 									const cap = Math.round(vh - 90);
@@ -939,7 +1283,7 @@ window.__ModuleLoader__.load({
 								panel.style.top = Math.max(8, Math.round(r.top + (r.height - MINI_H) / 2)) + "px";
 								panel.style.maxHeight = MINI_H + "px";
 							} else {
-								panel.style.left = Math.max(8, vw - width - 12) + "px";
+								panel.style.left = Math.max(8, vw - width - railClearance) + "px";
 								panel.style.top = Math.max(8, Math.round(r.top + 8)) + "px";
 								const fh = state.panelHeight;
 								const cap = Math.max(minPanelH(), Math.round(Math.min(r.height - 24, vh - 40)));
@@ -1020,8 +1364,8 @@ window.__ModuleLoader__.load({
 				const count = snap.outline !== null ? snap.outline.count : 0;
 				const hasExpanded = Object.keys(snap.expanded).some((k) => snap.expanded[k] === true);
 
-				/* ---------- 极简模式(右/左对齐): 只保留定位 ---------- */
-				if (viewMode === "minimal" || viewMode === "minimal-left") {
+				/* ---------- 极简模式(左对齐): 只保留定位 (极简·右已注释,待共存方案) ---------- */
+				if (/* viewMode === "minimal" || */ viewMode === "minimal-left") {
 					const miniRows = [];
 					for (const g of groups) {
 						if (g.turn === null) continue;
@@ -1159,7 +1503,9 @@ window.__ModuleLoader__.load({
 					} else if (!turnsHidden) {
 						titleNode = React.createElement("span", { className: "cnvnav-group-title" }, g.title);
 					} else if (g.items.length > 0) {
-						const headItem = g.items[0];
+						/* 组头徽标优先取用户节点(官方节点顺序里 turn-process 常在 user 之前,
+						   直接取 items[0] 会显示「过程」而非「用户」) */
+						const headItem = g.items.find((it) => it.kind === "user" || it.kind === "input-message") ?? g.items[0];
 						titleNode = React.createElement("span", {
 							className: "cnvnav-badge cnvnav-badge-" + headItem.cls,
 						}, headItem.kind === "user" ? "用户" : headItem.label);
@@ -1475,7 +1821,7 @@ window.__ModuleLoader__.load({
 			));
 		}
 
-		const inject = ["slots", "sessions"];
+		const inject = ["slots", "sessions", "uiConversation"];
 		exports.apply = apply;
 		exports.inject = inject;
 		return module.exports;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-conversation-navigator",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "DSH(DeepSeek Harness)会话导航插件:按轮折叠的对话大纲面板,支持节点点击跳转、滚动位置高亮与轨迹视图同款配色。",
   "keywords": [
     "dsh",
@@ -32,6 +32,9 @@
   "engines": {
     "node": ">=18"
   },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-client-ui-conversation": ">=0.1.1-rc.2 <0.2.0"
+  },
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
@@ -39,7 +42,6 @@
     "client": {
       "platform": "web",
       "inject": [
-        "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-ui-conversation"
       ]
     }