dsh-focus-overlay 0.12.3 → 0.13.0

package/README.en.md

@@ -5,15 +5,16 @@
 </p>
 
 <p align="center">
-  A <b>focus mode</b> for the DeepSeek Harness (DSH) web GUI: one click to a full-screen reading overlay that hides the header, composer and sidebars, folding the AI tool-call flow into official-style count summaries — leaving only the conversation between you and the AI.<br>
+  A <b>focus mode</b> for the DeepSeek Harness (DSH) web GUI and the macOS / Windows desktop app: one click to a full-screen reading overlay that hides the header, composer and sidebars, folding the AI tool-call flow into official-style count summaries — leaving only the conversation between you and the AI.<br>
   Text, images, the turn rail, width handles and the answer card all reuse or 1:1 replicate official components, matching the chat view's look.
 </p>
 
 <p align="center">
-  <img src="https://img.shields.io/npm/v/dsh-focus-overlay" alt="npm version">
-  <img src="https://img.shields.io/npm/dm/dsh-focus-overlay" alt="npm downloads (monthly)">
-  <img src="https://badgen.net/badge/license/MIT/green" alt="license">
-  <img src="https://badgen.net/badge/dsh/%3E%3D0.1.2-rc.1/blue" alt="dsh version">
+  <a href="https://www.npmjs.com/package/dsh-focus-overlay"><img src="https://img.shields.io/npm/v/dsh-focus-overlay" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/dsh-focus-overlay"><img src="https://img.shields.io/npm/dm/dsh-focus-overlay" alt="npm downloads (monthly)"></a>
+  <a href="https://github.com/boogoo619/dsh-focus-overlay/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="license: MIT"></a>
+  <a href="https://github.com/boogoo619/dsh-focus-overlay/blob/master/package.json"><img src="https://img.shields.io/badge/dsh-%3E%3D0.1.2--rc.1-blue" alt="dsh version"></a>
+  <a href="https://github.com/awesome-dsh-plugin/awesome-dsh-plugin"><img src="https://img.shields.io/badge/awesome-dsh--plugin-orange" alt="awesome dsh plugin"></a>
 </p>
 
 ## Features
@@ -25,6 +26,7 @@
 - **Auto-focus & reminders** — after a reply completes normally, optionally auto-enter focus at your question; while in focus, get a toast for a new reply or when the AI is waiting on you
 - **Width handles** — draggable strips beside the content column (official WidthHandle replica) that resize the reading column live and persist
 - **Hotkey F** — press `F` anywhere to enter focus mode instantly (toggleable in settings); typing in an input never triggers it
+- **Desktop window chrome** — adapts to the dsh desktop app (macOS / Windows): the top of the overlay reserves the official frame clearance for the macOS traffic lights and the Windows native titlebar, that top band drags the window while focused, and the reservation shrinks automatically in native fullscreen
 - **Focus counter** — the settings card keeps a running total of your focus-mode entries; past 100 entries a GitHub Star nudge appears, is remembered after the first use, and then becomes a direct "open the project page" button
 
 These features are designed to give **small screens** more content space: tucking away the persistent header/composer and tool steps lets the conversation use as much of the screen as possible.
@@ -55,7 +57,9 @@ Click the line to expand that turn's full work detail (per-category one-line sum
 | Feature | Description |
 | --- | --- |
 | Full-screen overlay | Registered into `shell.overlay` (additive, `replaceRisk: none`) — covers header / composer / sidebar; the thin top bar keeps only the session title and an exit button |
-| Official rendering primitives | Assistant text through official `MarkdownText` (GFM + code highlighting + TeX + code copy buttons + footnotes); user messages through the official `projectUserText` projection; buttons, modals and icons are all official primitives |
+| Official rendering primitives | Assistant text through official `MarkdownText` (GFM + code highlighting + TeX + code copy buttons + footnotes); user messages pick the official user-text projection the running dsh exports: `projectUserText` on 0.1.2–0.2.0 (plain runs plus `@`/`/` reference chips), and the official `UserTextRun` plain run after the 0.2.2 desktop runtime removed that function — a missing projection can never crash the overlay; buttons, modals and icons are all official primitives |
+| Desktop window frame | Reserves top space from the official `--dsh-frame-overlay-top` / `--dsh-frame-top-clearance` / `--dsh-frame-chrome-top` variables for the macOS traffic lights (~48px) and the Windows native titlebar (40px), and provides a top drag strip matching the official drag region (`data-window-drag` + `-webkit-app-region: drag`) so the window stays draggable while focused; native fullscreen (`data-fullscreen`) drops the reservation to 20px; on Windows it also hides the official sidebar-collapse and new-session controls that the window chrome promotes into the titlebar layer when the sidebar is collapsed / the window is narrow — otherwise they painted above the focus layer and a stray click switched sessions while reading; both come back with the chrome on exit. In a plain browser the variables and markers are absent, so the 0px fallback keeps the old pixel-identical layout |
+| File-mention chips | Inline-code paths in AI replies resolve through the official `chatFileMentions` into clickable chips: on dsh 0.2.x the overlay passes the same real Turn face (`deliverables` projection) the official chat turn tail uses and opens through the sidebar resource controller's `dsh-resource://file/session/…` address; on dsh ≤ 0.1.x it keeps the legacy owner shape and `workspaces.openPath`. No chip without projection data, and a resolver failure never crashes the overlay |
 | Image resolution | Assistant `image` blocks resolve through `uiConversation.imageUrl` (the dsh 0.1.2+ session-authorized image cache), falling back to the legacy resolver on older dsh |
 | Tool-call folding | Follows the official "transcript view" preference (normal / compact); compact mode folds each turn's work part into a "N tool calls · M messages · K subagents" disclosure line ("Thought for a while" when nothing is countable), clickable to expand the full detail; steering messages always stay top-level, never buried; the last turn stays unfolded while streaming |
 | Categorized summaries | The expanded detail counts tools by family: commands / edits / searches / reads / directory listings / subagents / todos / goals / workflows / skills / questions / plans / background jobs / context injections |
@@ -75,16 +79,17 @@ Click the line to expand that turn's full work detail (per-category one-line sum
 | Focus counter | A row at the bottom of the settings card totals your focus-mode entries (auto-entries included), persisted to `localStorage`; past 100 entries a Star nudge appears — after the first use it is remembered and replaced by a direct "open the project page" button |
 | Esc peels layer by layer | Answer card → input bar → focus mode, one layer per press; Esc mid-IME-composition cancels the composition first |
 | i18n | Chinese / English copy registered under the `focus` namespace, follows the UI language |
-| Plugin configuration card | A collapsible card under "Settings → Plugins → Plugin configuration", preferences persisted to `localStorage`; the Node half registers the same settings namespace (schemastery schema) so the tab dispatches it |
-| First-run onboarding | After installing, the welcome page shows a one-time "Focus Mode" intro (feature overview + in-place configuration) as a `settings.onboarding` step with its own versioned seen-flag |
-| Official preference sync | Reads the official "transcript view" preference (normal / compact); flipping it applies immediately |
+| Plugin configuration | On dsh 0.2 and newer, open this plugin's detail page from the sidebar "Plugins" page — the configuration renders between the package description and its component rows (`plugins.bundle.config`). On dsh ≤ 0.1.x it stays the collapsible "Settings → Plugins → Plugin configuration" card (`settings.plugin.item`). Preferences persist to `localStorage`; the Node half registers the same settings namespace (schemastery schema) |
+| First-run onboarding | After installing, the welcome page shows a one-time "Focus Mode" intro (feature overview + in-place configuration) as a `settings.onboarding` step with its own versioned seen-flag; its "open settings" action jumps to whichever configuration surface the running dsh declares |
+| Official preference sync | Reads the official "transcript view" preference (normal / compact on dsh ≤ 0.1.x; compact / standard / detailed / verbose on dsh 0.2); flipping it applies immediately |
 | Render error boundary | The overlay content is wrapped in an error boundary: one render crash never bricks the Focus button — the next open retries |
 | DSH-better-sidebar compatibility | While in focus, a `<body>` marker makes the package stylesheet hide better-sidebar's top-right panel toggles and any open right/bottom panels (and release the squeezed layout); restored on exit |
 | Legacy compatibility mode | On dsh < 0.1.2 missing the new services, the overlay degrades gracefully (legacy snapshot adapters) with a one-time console notice — no crash |
+| Cross-release primitive compatibility | Official primitives renamed between major releases fall back by availability (dsh 0.2 removed the fixed-size `…14` / `…16` icons in favour of `…Regular` + `size`; the dsh 0.2.2 desktop runtime removed `projectUserText` in favour of `UserTextRun`), so an `undefined` component can never throw React #130 |
 
 ## Install
 
-Requires the `dsh` CLI (`>= 0.1.2-rc.1`) and Node `>= 22.19.0`.
+Requires `dsh` (Web CLI or the desktop app, `>= 0.1.2-rc.1`) and, for source installs, Node `>= 22.19.0`.
 
 **From npm (recommended)**
 
@@ -119,7 +124,15 @@ dsh web
 
 Restart `dsh web` after install.
 
-> **First run**: after restarting, the welcome page shows a one-time "Focus Mode" intro that explains the features and lets you configure them in place; all of these settings can be changed anytime in "Settings → Plugins → Plugin configuration".
+**DSH desktop app (macOS / Windows)**
+
+The desktop app manages plugins itself, no CLI needed: **Plugins → Add plugin** in the sidebar, enter `dsh-focus-overlay` (or a local directory / `link:` path such as `link:/path/to/dsh-focus-overlay`), then configure it on this plugin's detail page. Reload the desktop window (or restart the app) after installing or updating.
+
+Desktop support is verified against **dsh desktop 0.2.2-rc.1**: macOS and Windows share the same Electron renderer and client contracts; the window-chrome differences (macOS traffic lights / Windows native titlebar) are driven by the official `data-platform` / `data-windows-titlebar` / `data-fullscreen` markers, and the plugin adapts through the official frame variables — one install serves both platforms. In focus mode the top of the overlay is a draggable title band; native fullscreen (macOS green button / Windows maximize) shrinks the reservation automatically.
+
+> The desktop app uses its own `desktop` profile: installing the plugin only into the Web CLI's `web` profile does not install it in the desktop app — add it once on the Plugins page there too.
+
+> **First run**: after restarting, the welcome page shows a one-time "Focus Mode" intro that explains the features and lets you configure them in place; all of these settings can be changed anytime — on newer dsh open this plugin's detail page from the sidebar "Plugins" page, on older dsh use "Settings → Plugins → Plugin configuration".
 
 ## Usage
 
@@ -133,7 +146,11 @@ Restart `dsh web` after install.
 
 ## Settings
 
-In the sidebar "Settings → Plugins → Plugin configuration", expand the "Focus Mode" card:
+**On dsh 0.2 and newer**: sidebar "Plugins" page → find `dsh-focus-overlay` → the configuration shows on its detail page, between the package description and the component rows.
+
+**On dsh ≤ 0.1.x**: sidebar "Settings → Plugins → Plugin configuration" → expand the "Focus Mode" card.
+
+Both locations present the same options:
 
 | Option | Description |
 | --- | --- |

package/README.md

@@ -3,15 +3,16 @@
 <p align="center">中文 | <a href="README.en.md">English</a></p>
 
 <p align="center">
-  为 DeepSeek Harness（DSH）Web GUI 提供的<b>专注模式</b>：一键进入全屏阅读遮罩，隐藏标题区、输入区与侧栏，把 AI 的工具调用过程折叠成官方样式的计数摘要，只保留「你与 AI 的对话」本身。<br>
+  为 DeepSeek Harness（DSH）Web GUI 与桌面版（macOS / Windows）提供的<b>专注模式</b>：一键进入全屏阅读遮罩，隐藏标题区、输入区与侧栏，把 AI 的工具调用过程折叠成官方样式的计数摘要，只保留「你与 AI 的对话」本身。<br>
   文本、图片、导航条、宽度调节与答题卡均复用或 1:1 复刻官方组件，观感与聊天视图一致。
 </p>
 
 <p align="center">
-  <img src="https://img.shields.io/npm/v/dsh-focus-overlay" alt="npm version">
-  <img src="https://img.shields.io/npm/dm/dsh-focus-overlay" alt="npm downloads (monthly)">
-  <img src="https://badgen.net/badge/license/MIT/green" alt="license">
-  <img src="https://badgen.net/badge/dsh/%3E%3D0.1.2-rc.1/blue" alt="dsh version">
+  <a href="https://www.npmjs.com/package/dsh-focus-overlay"><img src="https://img.shields.io/npm/v/dsh-focus-overlay" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/dsh-focus-overlay"><img src="https://img.shields.io/npm/dm/dsh-focus-overlay" alt="npm downloads (monthly)"></a>
+  <a href="https://github.com/boogoo619/dsh-focus-overlay/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="license: MIT"></a>
+  <a href="https://github.com/boogoo619/dsh-focus-overlay/blob/master/package.json"><img src="https://img.shields.io/badge/dsh-%3E%3D0.1.2--rc.1-blue" alt="dsh version"></a>
+  <a href="https://github.com/awesome-dsh-plugin/awesome-dsh-plugin"><img src="https://img.shields.io/badge/awesome-dsh--plugin-orange" alt="awesome dsh plugin"></a>
 </p>
 
 ## 功能
@@ -23,6 +24,7 @@
 - **自动专注与提醒** —— 回复正常完成后可自动进入专注并定位到你的提问；专注中收到新回复、或 AI 等待你回答时弹出提醒
 - **宽度调节** —— 正文两侧的拖拽把手（官方 WidthHandle 复刻），实时拖动阅读列宽并持久化
 - **快捷键 F** —— 任意界面按 `F` 一键进入专注模式，可在设置中关闭；输入框内打字不会误触发
+- **桌面版窗口适配** —— 适配 dsh 桌面版（macOS / Windows）：顶部按官方窗口框架变量为 macOS 红绿灯与 Windows 原生标题栏让出空间，专注时这段顶部空白条可直接拖动窗口，进入全屏后自动收起预留空间
 - **专注计数** —— 设置卡片最底部累计展示你进入专注模式的次数；超过 100 次后出现 GitHub Star 引导，点过一次即被记住，之后提供「前往 GitHub 项目页面」直达按钮
 
 这些功能专为**小屏幕**提供更多内容呈现空间：收起常驻的标题 / 输入区与工具步骤，让有限的屏幕尽可能多地展示对话。
@@ -53,7 +55,9 @@
 | 功能 | 说明 |
 | --- | --- |
 | 全屏专注遮罩 | 经 `shell.overlay` 注册（纯增量、`replaceRisk: none`），覆盖标题区 / 输入区 / 侧栏；顶部只留会话标题与「退出专注」按钮 |
-| 官方渲染原语 | AI 文本走官方 `MarkdownText`（GFM + 代码高亮 + TeX + 代码复制按钮 + 脚注），用户消息走官方 `projectUserText` 投影；按钮、模态、图标均为官方原语 |
+| 官方渲染原语 | AI 文本走官方 `MarkdownText`（GFM + 代码高亮 + TeX + 代码复制按钮 + 脚注）；用户消息按运行版本选择官方用户文本投影：dsh 0.1.2–0.2.0 用 `projectUserText`（纯文本 + `@`/`/` 引用 chip），dsh 0.2.2 桌面版移除了该函数后自动回退到官方 `UserTextRun`（纯文本 run），不会因 `undefined` 组件崩溃；按钮、模态、图标均为官方原语 |
+| 桌面版窗口框架 | 按官方 `--dsh-frame-overlay-top` / `--dsh-frame-top-clearance` / `--dsh-frame-chrome-top` 变量为 macOS 红绿灯（≈48px）与 Windows 原生标题栏（40px）预留顶部空间，并提供一个与官方拖拽区一致的顶部拖拽条（`data-window-drag` + `-webkit-app-region: drag`），专注时可拖动窗口；原生全屏（`data-fullscreen`）时预留自动降为 20px；Windows 上还会隐藏被官方提升到标题栏层的「侧边栏开关」与「新建会话」按钮（侧栏折叠 / 窄窗口时出现），避免它们浮在专注层之上、误触后在你阅读时切换会话；退出专注后随窗口 chrome 一起恢复。普通浏览器中这些变量与标记不存在，回退 0px、与旧版逐像素一致 |
+| 文件引用 chip | AI 回复中的行内代码路径由官方 `chatFileMentions` 解析为可点击 chip：dsh 0.2.x 传入官方同款的真实 Turn face（`deliverables` 投影），点击经右侧栏资源控制器以 `dsh-resource://file/session/…` 打开；dsh ≤ 0.1.x 继续使用旧的 owner 形状与 `workspaces.openPath`；无投影数据时不显示 chip，绝不因解析异常崩溃 |
 | 图片解析 | assistant 的 `image` 块经 `uiConversation.imageUrl`（dsh 0.1.2+ 的会话授权图片缓存）解析，旧版 dsh 自动回退到 legacy 解析器 |
 | 工具调用折叠 | 遵循官方「对话显示」偏好（normal / compact）；compact 模式把每轮的工作部分折叠成「N 次工具调用 · M 条消息 · K 个 subagent」披露行（无内容时显示「已思考」），点击可展开完整明细；steering 消息始终独立成行不被折叠；流式中的最后一轮保持展开直到结束 |
 | 分类摘要明细 | 展开后按工具类别计数：命令 / 编辑 / 搜索 / 读取 / 列目录 / 子代理 / 待办 / 目标 / 工作流 / 技能 / 提问 / 计划 / 后台任务 / 上下文注入 |
@@ -73,16 +77,17 @@
 | 专注计数 | 设置卡片最底部一行累计进入专注模式的次数（含自动进入），持久化到 `localStorage`；超过 100 次出现 Star 引导按钮，点击前往仓库页面并记住状态，之后改为「前往 GitHub 项目页面」直达按钮 |
 | Esc 逐层退出 | 答题卡 → 输入条 → 专注模式，一层一层退；输入法组词中的 Esc 优先取消组词 |
 | i18n | 中 / 英文案，注册到 `focus` 命名空间，跟随界面语言 |
-| 插件配置卡片 | 「设置 → 插件 → 插件配置」中的可折叠卡片，偏好持久化到 `localStorage`；Node 半区以 schemastery schema 注册同名设置 namespace 供其分发 |
-| 首次引导 | 首次安装后欢迎页弹出一次「专注模式」引导（功能一览 + 就地配置），`settings.onboarding` 步骤自带已读标记与版本号 |
-| 官方偏好联动 | 读取官方「对话显示」（normal / compact）偏好，切换即时生效 |
+| 插件配置卡片 | dsh 0.2 起在侧栏「Plugins」页面打开本插件详情页，配置直接渲染在包描述与组件列表之间（`plugins.bundle.config`）；dsh ≤ 0.1.x 仍为「设置 → 插件 → 插件配置」中的可折叠卡片（`settings.plugin.item`）。偏好持久化到 `localStorage`；Node 半区以 schemastery schema 注册同名设置 namespace |
+| 首次引导 | 首次安装后欢迎页弹出一次「专注模式」引导（功能一览 + 就地配置），`settings.onboarding` 步骤自带已读标记与版本号；「打开设置」按当前 dsh 版本跳到对应配置页 |
+| 官方偏好联动 | 读取官方「对话显示」偏好（dsh ≤ 0.1.x：normal / compact；dsh 0.2：compact / standard / detailed / verbose），切换即时生效 |
 | 渲染错误兜底 | 遮罩内容包裹错误边界：一次渲染崩溃不会永久打死「专注」按钮，下次打开自动重试 |
 | 兼容 DSH-better-sidebar | 进入专注时在 `<body>` 打标记，样式层自动隐藏其右上角的收放面板按钮与已开启的右侧 / 底部面板，并释放被挤压的布局；退出专注后按原状态还原 |
 | 旧版兼容模式 | dsh < 0.1.2 缺少新服务时降级运行（legacy 快照适配），控制台一次性提示，不会崩溃 |
+| 跨版本构件兼容 | 图标等官方构件在两个大版本间改名时按可用性回退（dsh 0.2 移除了 `…14` / `…16` 定尺图标，改用 `…Regular` + `size`；dsh 0.2.2 桌面版移除了 `projectUserText`，回退到 `UserTextRun`），不会因为 `undefined` 组件触发 React #130 |
 
 ## 安装
 
-需要 `dsh` CLI（`>= 0.1.2-rc.1`），Node `>= 22.19.0`。
+需要 `dsh`（Web CLI 或桌面版，`>= 0.1.2-rc.1`），Node `>= 22.19.0`（仅源码安装时需要 Node）。
 
 **从 npm（推荐）**
 
@@ -117,7 +122,15 @@ dsh web
 
 安装后重启 `dsh web` 生效。
 
-> **首次安装**：重启后欢迎页会弹出一次「专注模式」引导，说明功能并让你就地完成配置；其中所有设置随时可在「设置 → 插件 → 插件配置」中更改。
+**DSH 桌面版（macOS / Windows）**
+
+dsh 桌面版自带插件管理，不需要 CLI：侧栏 **Plugins → 添加插件**，填入 `dsh-focus-overlay`（或本机目录 / `link:` 路径，例如 `link:/path/to/dsh-focus-overlay`），安装后在本插件详情页中配置。安装或更新后重新加载桌面窗口（或重启桌面应用）生效。
+
+桌面版适配基于 **dsh 桌面版 0.2.2-rc.1** 验证：macOS 与 Windows 共用同一套 Electron 渲染层与客户端契约，窗口框架差异（macOS 红绿灯 / Windows 原生标题栏）由官方 `data-platform` / `data-windows-titlebar` / `data-fullscreen` 标记驱动，插件按官方窗口框架变量自适应，无需按平台分别安装。专注模式下顶部为可拖动窗口的标题空白条；按原生全屏切换后（macOS 绿灯 / Windows 最大化按钮）自动收起预留空间。
+
+> 桌面版使用独立的 `desktop` profile：如果只在 Web CLI 的 `web` profile 里装过本插件，桌面版仍需在 Plugins 页面安装一次。
+
+> **首次安装**：重启后欢迎页会弹出一次「专注模式」引导，说明功能并让你就地完成配置；其中所有设置随时可以更改——新版 dsh 在侧栏「Plugins」页面中打开本插件的详情页，旧版在「设置 → 插件 → 插件配置」中。
 
 ## 使用
 
@@ -131,7 +144,11 @@ dsh web
 
 ## 设置
 
-侧栏「设置 → 插件 → 插件配置」中，展开「专注模式」卡片：
+**dsh 0.2 起**：侧栏「Plugins」页面 → 找到 `dsh-focus-overlay` → 详情页中，配置直接显示在包描述与组件列表之间。
+
+**dsh ≤ 0.1.x**：侧栏「设置 → 插件 → 插件配置」→ 展开「专注模式」卡片。
+
+两种位置呈现同一组选项：
 
 | 选项 | 说明 |
 | --- | --- |

package/lib/client.js

@@ -3,9 +3,102 @@ window.__ModuleLoader__.load({
 	factory: (require) => {
 		var module = { exports: {} };
 		module.exports;
+		//#region \0rolldown/runtime.js
+		var __create = Object.create;
+		var __defProp = Object.defineProperty;
+		var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+		var __getOwnPropNames = Object.getOwnPropertyNames;
+		var __getProtoOf = Object.getPrototypeOf;
+		var __hasOwnProp = Object.prototype.hasOwnProperty;
+		var __copyProps = (to, from, except, desc) => {
+			if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+				key = keys[i];
+				if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+			return to;
+		};
+		var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+			value: mod,
+			enumerable: true
+		}) : target, mod));
+		//#endregion
 		let react = require("react");
 		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
+		_deepseek_ai_dsh_client_ui_primitives = __toESM(_deepseek_ai_dsh_client_ui_primitives, 1);
 		let react_jsx_runtime = require("react/jsx-runtime");
+		//#region src/client/primitives.ts
+		/** Cross-release primitives resolution.
+		*
+		*  dsh keeps renaming/removing symbols in `@deepseek-ai/dsh-client-ui-primitives`
+		*  between releases, and a stale named import resolves to `undefined` — React
+		*  then throws #130 ("element type is invalid") the moment it renders. Two
+		*  such breaks are already in this repo's history: `MessageText` (0.1.3) and
+		*  the fixed-size icon variants (0.2). The 0.2.2 desktop runtime adds a third:
+		*  `projectUserText` is gone.
+		*
+		*  The official user-text pipeline changed shape in 0.2.2: the conversation
+		*  surface now parses text itself and renders inline nodes, falling back to
+		*  the `UserTextRun` primitive (a plain inline run) for unmatched text. This
+		*  module picks whichever projection the running primitives module actually
+		*  exports, so one client bundle serves 0.1.2 through 0.2.2:
+		*
+		*  - dsh 0.1.2 … 0.2.0: `projectUserText(text, sessionLabels, …)` returns
+		*    inline plain runs plus `@session` / `/skill` chips (the richer path).
+		*  - dsh 0.2.2+: `UserTextRun` renders the text as a plain inline run; the
+		*    overlay's bubble chrome still supplies `white-space: pre-wrap`, so the
+		*    text keeps its shape. Reference chips in *user* text are the only
+		*    cosmetic loss on that generation.
+		*  - Anything else: return the raw string (React renders it as a text node).
+		*
+		*  Import the namespace once (not named symbols) so the resolver can never
+		*  crash at module-evaluation time. */
+		/** Render one user prompt's text through the projection the running dsh
+		*  exports. `sessionLabels` feeds the older chip projection; newer
+		*  generations ignore it. */
+		function projectUserTextCompat(text, sessionLabels = []) {
+			const primitives = _deepseek_ai_dsh_client_ui_primitives;
+			const project = primitives.projectUserText;
+			if (typeof project === "function") try {
+				return project(text, sessionLabels);
+			} catch {}
+			const UserTextRun = primitives.UserTextRun;
+			if (typeof UserTextRun === "function") return (0, react.createElement)(UserTextRun, { text });
+			return text;
+		}
+		//#endregion
+		//#region src/client/icons.ts
+		/** Cross-release product-icon resolution.
+		*
+		*  The official primitives package renamed its icon set in dsh 0.2: the
+		*  fixed-size artwork variants (`IconCheckOutline14`, `IconChevronDownOutline14`,
+		*  `IconEditOutline16`, `IconSendOutline14`) were removed, leaving one
+		*  `…OutlineRegular` / `…OutlineMedium` component per glyph that takes an
+		*  explicit `size` prop. A stale named import therefore resolves to
+		*  `undefined`, and React throws #130 ("element type is invalid") the moment
+		*  the component renders — the same failure mode the 0.1.3 `MessageText`
+		*  removal produced.
+		*
+		*  Import the namespace once and pick the first name the running build exports,
+		*  so one bundle serves both generations. Each fallback carries the size the
+		*  removed variant was drawn at, keeping layout identical across releases. */
+		function pick(names, size) {
+			for (const name of names) {
+				const component = _deepseek_ai_dsh_client_ui_primitives[name];
+				if (typeof component === "function") return (props) => component({
+					size,
+					...props
+				});
+			}
+			return () => null;
+		}
+		const IconCheck = pick(["IconCheckOutline14", "IconCheckOutlineRegular"], 14);
+		const IconChevronDown = pick(["IconChevronDownOutline14", "IconChevronDownOutlineRegular"], 14);
+		const IconEdit = pick(["IconEditOutline16", "IconEditOutlineRegular"], 16);
+		const IconSend = pick(["IconSendOutline14", "IconSendOutlineRegular"], 14);
+		//#endregion
 		//#region src/client/model.ts
 		function legacySliceOf(chatView, snap) {
 			const legacy = chatView && chatView.legacy ? chatView.legacy : null;
@@ -25,6 +118,61 @@ window.__ModuleLoader__.load({
 			} catch {}
 			return null;
 		}
+		/** dsh 0.2 moved the pending interaction off the uiSession
+		*  `pendingInteractions` map and onto the unified `sessionStatus` snapshot
+		*  (`ReadonlyMap<sessionId, { running, pendingInteraction, completionUnread }>`).
+		*  Both carriers answer with the same interaction face, so the overlay's answer
+		*  card resolves through either. Null when nothing is pending. */
+		function pendingInteractionFromStatus(status, sessionId) {
+			try {
+				const entry = status && typeof status.get === "function" ? status.get(sessionId) : null;
+				return entry && entry.pendingInteraction || null;
+			} catch {}
+			return null;
+		}
+		/** The current session id, resolved across dsh generations.
+		*
+		*  dsh <= 0.1.x carried the viewer's selection on the session-list snapshot
+		*  (`sessions.list.getSnapshot().current`). dsh 0.2 dropped that field: the
+		*  selection is the session the main view retains, published on the list rows
+		*  themselves (`byId[id].retainedBy.mainView > 0`) — the same public read the
+		*  official cordis inspector uses. `mainBinding` is the uiSession main-binding
+		*  snapshot, kept as a guarded last resort: it carries the same id, but that
+		*  member is typed private, so the public list data stays primary. */
+		function currentSessionIdOf(listState, mainBinding) {
+			const fromList = listState ? listState.current : void 0;
+			if (fromList !== void 0 && fromList !== null) return fromList;
+			const byId = listState && listState.byId;
+			if (byId && typeof byId === "object") {
+				for (const row of Object.values(byId)) if (row && (row.retainedBy && row.retainedBy.mainView || 0) > 0) return row.id;
+			}
+			if (mainBinding) {
+				const id = mainBinding.key ?? (mainBinding.props ? mainBinding.props.sessionId : void 0);
+				if (id !== void 0 && id !== null) return id;
+			}
+		}
+		/** The overlay fold mode derived from the official "对话显示" preference.
+		*
+		*  dsh <= 0.1.x served it through the `settingsScope` service bound to the
+		*  `ui-chat` namespace (`{ transcriptView: 'normal' | 'compact' }`). dsh 0.2
+		*  retired `settingsScope`; the same preference is a Host settings field read
+		*  through `configForms.get('ui-chat')`, whose snapshot nests it under `value`
+		*  (and widened the accepted set to compact | standard | detailed | verbose,
+		*  with `normal` / `expanded` kept as legacy saved values). Only `compact`
+		*  folds the tool flow; every other explicit mode reads as the expanded
+		*  presentation. Absence keeps the overlay's own compact default. */
+		function transcriptViewOf(scopeOrForm) {
+			try {
+				if (!scopeOrForm || typeof scopeOrForm.getSnapshot !== "function") return "compact";
+				const snapshot = scopeOrForm.getSnapshot();
+				const section = snapshot && snapshot.value && typeof snapshot.value === "object" ? snapshot.value : snapshot;
+				const mode = section ? section.transcriptView : null;
+				if (mode === void 0 || mode === null) return "compact";
+				return mode === "compact" ? "compact" : "normal";
+			} catch {
+				return "compact";
+			}
+		}
 		/** Legacy pending interaction — pre-0.1.2 dsh carried a flat `pending` array
 		*  on the session snapshot, with a different carrier shape (`payload`
 		*  envelope, answers via `wait.respond({ok, value})` returning a `receipt`).
@@ -70,6 +218,66 @@ window.__ModuleLoader__.load({
 			});
 			return shaped;
 		}
+		/** Build the `dsh-resource://file/session/<id>/<path>` address that dsh 0.2's
+		*  Sidebar resource controller opens a file through.
+		*
+		*  The official `fileAddressFor` lives in `@deepseek-ai/dsh-util-workspace-path`,
+		*  but the client bundle purity gate keeps feature bundles from importing other
+		*  plugins' values across the boundary — the official Chat package inlines its
+		*  own copy of the same grammar, and so does this one. Absolute paths inside the
+		*  session workspace are reduced to workspace-relative; every id and path
+		*  segment is component-encoded, with `:` kept literal for Windows drives. */
+		function sessionFileAddressOf(sessionId, cwd, path) {
+			const encode = (segment) => encodeURIComponent(segment).replace(/%3A/gi, ":");
+			const normalized = String(path).replace(/\\/g, "/").replace(/^(?:\.\/)+/, "");
+			const absolute = normalized.startsWith("/") || /^[A-Za-z]:\//.test(normalized);
+			let relative = normalized;
+			if (absolute) {
+				const root = cwd === void 0 || cwd === null ? "" : String(cwd).replace(/\\/g, "/").replace(/\/+$/, "");
+				if (root !== "" && normalized === root) relative = "";
+				else if (root !== "" && normalized.startsWith(root + "/")) relative = normalized.slice(root.length + 1);
+			}
+			const body = relative.split("/").map(encode).join("/");
+			return `dsh-resource://file/session/${encode(String(sessionId))}/${body}`;
+		}
+		/** Resolve the owner object the official `chatFileMentions.forClosing` expects.
+		*
+		*  dsh 0.2.x's provider resolves a turn's produced / presented files through
+		*  `owner.turn.data.get('deliverables')` — the owner the official ui-chat turn
+		*  tail passes — and throws on the plain `{turn: {turn, step}}` owner shape the
+		*  overlay used to pass; the caller's catch then silently disabled the inline
+		*  file-mention chips (pre-existing on every 0.2 build, not a desktop
+		*  regression). The Chat snapshot's `timeline.turns` carries the real Turn
+		*  faces, so look one up by the assistant node's turn number. Chips belong to
+		*  the settled closing reply only, so a missing or still-running turn resolves
+		*  to null. Generations without a `timeline` (0.1.x) keep the legacy shape
+		*  their provider accepts. */
+		function fileMentionOwnerOf(chatView, node, openFile) {
+			const turns = chatView && chatView.timeline ? chatView.timeline.turns : null;
+			if (turns && typeof turns.get === "function") {
+				const turnFace = turns.get(node && node.turn);
+				if (!turnFace || turnFace.status !== "closed") return null;
+				return {
+					owner: {
+						turn: turnFace,
+						seq: node.seq,
+						openFile
+					},
+					modern: true
+				};
+			}
+			return {
+				owner: {
+					turn: {
+						turn: node.turn,
+						step: node.step
+					},
+					seq: node.seq,
+					openFile
+				},
+				modern: false
+			};
+		}
 		function flattenText(content) {
 			if (!content || !content.length) return "";
 			let out = "";
@@ -933,7 +1141,7 @@ window.__ModuleLoader__.load({
 			"onboarding.feature.autoFocus": "自动专注与提醒 —— 回复完成自动进入专注，AI 提问 / 等待时提醒",
 			"onboarding.feature.hotkey": "快捷键 F —— 任意界面按 F 一键进入专注，可在设置中关闭",
 			"onboarding.configure.title": "快速配置",
-			"onboarding.laterNote": "这些设置随时可在「设置 → 插件 → 插件配置」中更改。",
+			"onboarding.laterNote": "这些设置随时可以更改：新版 dsh 在侧栏「Plugins」页面中打开本插件的详情页，旧版在「设置 → 插件 → 插件配置」中。",
 			"onboarding.openSettings": "打开设置",
 			"onboarding.done": "完成"
 		};
@@ -1019,7 +1227,7 @@ window.__ModuleLoader__.load({
 			"onboarding.feature.autoFocus": "Auto-focus & reminders — auto-enter after a reply, notify while the AI waits",
 			"onboarding.feature.hotkey": "Hotkey F — press F anywhere to enter focus mode (toggleable in settings)",
 			"onboarding.configure.title": "Quick setup",
-			"onboarding.laterNote": "You can change these anytime in Settings → Plugins → Plugin configuration.",
+			"onboarding.laterNote": "Change these anytime: on newer dsh open this plugin’s detail page from the sidebar Plugins page; on older dsh use Settings → Plugins → Plugin configuration.",
 			"onboarding.openSettings": "Open settings",
 			"onboarding.done": "Done"
 		};
@@ -1109,7 +1317,7 @@ window.__ModuleLoader__.load({
 				"aria-pressed": on,
 				children: [multi ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 					className: "fm-opt-check" + (on ? " fm-opt-check-on" : ""),
-					children: on ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCheckOutline14, {}) : null
+					children: on ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconCheck, {}) : null
 				}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 					className: "fm-opt-num",
 					children: index + 1
@@ -1220,7 +1428,7 @@ window.__ModuleLoader__.load({
 							title: t("answer.close"),
 							"aria-label": t("answer.close"),
 							onClick: onClose,
-							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronDownOutline14, {})
+							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconChevronDown, {})
 						})]
 					}) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						className: "fm-card-head",
@@ -1236,7 +1444,7 @@ window.__ModuleLoader__.load({
 								title: t("answer.close"),
 								"aria-label": t("answer.close"),
 								onClick: onClose,
-								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronDownOutline14, {})
+								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconChevronDown, {})
 							})
 						]
 					}),
@@ -1434,7 +1642,7 @@ window.__ModuleLoader__.load({
 								disabled: empty,
 								onMouseDown: (e) => e.preventDefault(),
 								onClick: onSend,
-								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconSendOutline14, {})
+								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconSend, {})
 							})
 						]
 					})
@@ -1471,7 +1679,7 @@ window.__ModuleLoader__.load({
 					title: t("composer.expand"),
 					"aria-label": t("composer.expand"),
 					onClick: onExpand,
-					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconEditOutline16, {}), hasDraft ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { className: "fm-pill-dot" }) : null]
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconEdit, {}), hasDraft ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { className: "fm-pill-dot" }) : null]
 				});
 			}
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
@@ -1480,7 +1688,7 @@ window.__ModuleLoader__.load({
 				title: t("backToLatest"),
 				"aria-label": t("backToLatest"),
 				onClick: onJumpBottom,
-				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronDownOutline14, { size: 16 })
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconChevronDown, { size: 16 })
 			});
 		}
 		//#endregion
@@ -1653,7 +1861,34 @@ window.__ModuleLoader__.load({
 		//#region src/client/styles.ts
 		/** Package-owned stylesheet text (injected by the client apply, cleaned up on unload). */
 		const FOCUS_CSS = `
-.fm-overlay{position:fixed;inset:0;z-index:2147483000;background:var(--dsw-alias-bg-base,#fff);color:var(--dsw-alias-label-primary,#1a1a1a);display:flex;flex-direction:column;pointer-events:auto;font-family:var(--dsw-font-family,sans-serif);outline:none}
+.fm-overlay{position:fixed;inset:0;z-index:2147483000;box-sizing:border-box;padding-top:var(--dsh-frame-overlay-top,0px);background:var(--dsw-alias-bg-base,#fff);color:var(--dsw-alias-label-primary,#1a1a1a);display:flex;flex-direction:column;pointer-events:auto;font-family:var(--dsw-font-family,sans-serif);outline:none}
+/* Desktop window frame (dsh desktop 0.2.2+, macOS and Windows): the shell's
+   hidden native titlebar area is web content owned by whatever fills the
+   viewport, so this overlay reserves it via *.fm-overlay's padding-top and
+   provides the drag surface itself. Heights come from the official layout
+   variables set on <html> by dsh-client-ui-layout (+ the desktop preload for
+   --dsh-windows-titlebar-height); the 0px fallback keeps the plain web
+   generation pixel-identical. On macOS the shell's own
+   [data-window-drag]{-webkit-app-region:drag} applies; the explicit
+   app-region also makes the strip draggable in the Windows renderer.
+   pointer-events stays enabled: a drag region must be hit-testable. */
+.fm-frame-strip{position:absolute;top:0;left:0;right:0;height:var(--dsh-frame-overlay-top,0px);flex:none;-webkit-app-region:drag;-webkit-user-select:none;user-select:none;z-index:0}
+/* Windows desktop: dsh-client-ui-sidebar promotes the sidebar collapse toggle
+   to a fixed z-30 layer itself, above the official shell.overlay layer (z-20)
+   that hosts this overlay — so without this rule the toggle floats above focus
+   mode inside the titlebar band and steals clicks/drags from the drag strip
+   (macOS keeps it behind the overlay). Hide it exactly while focus is on; it
+   comes back with the rest of the chrome when focus exits. */
+html[data-windows-titlebar] body[data-fm-focus] [data-sidebar-toggle]{display:none!important}
+/* Same Windows titlebar band: when the official sidebar is collapsed (user
+   collapsed it, or the window is narrower than 768px — Windows has no drawer),
+   dsh-client-ui-sidebar promotes its "new session" control to the same fixed
+   z-30 titlebar layer (left:48px, top:6px). It would sit above the overlay and
+   click-through would start a new session under the reader, so hide it with
+   the rest of the window chrome while focus is on. The hashed class name is
+   the only stable hook the shipped CSS exposes; the e2e desktop-frame leak
+   guard fails loudly if a future build renames it. */
+html[data-windows-titlebar] body[data-fm-focus] [class*="newSession"]{display:none!important}
 .fm-topbar{display:flex;align-items:center;justify-content:space-between;gap:12px;padding:10px 16px;border-bottom:1px solid var(--dsw-alias-border-l1,rgba(0,0,0,.12));flex:0 0 auto}
 .fm-title{font-size:calc(14px + var(--dsh-content-font-delta,0px));font-weight:600;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 .fm-body-wrap{position:relative;flex:1 1 auto;display:flex;min-height:0}
@@ -1813,6 +2048,9 @@ window.__ModuleLoader__.load({
 .fm-plugin-card-chevron{color:var(--dsw-alias-label-tertiary);flex:none;transition:transform .16s}
 .fm-plugin-card-chevron-open{transform:rotate(180deg)}
 .fm-plugin-card-body{border-top:1px solid var(--dsw-alias-border-l2);margin:0 16px;padding-bottom:16px}
+/* dsh 0.2 Plugins-page bundle configuration: the page draws its own title,
+   icon and crumb, so this surface is body-only — no card border or collapse. */
+.fm-plugin-page{flex-direction:column;display:flex}
 .fm-plugin-field{flex-direction:column;gap:6px;padding:12px 0;display:flex}
 .fm-plugin-field+.fm-plugin-field{border-top:1px solid var(--dsw-alias-border-l2)}
 /* The stats row ends the card body, so it carries NO bottom padding of its
@@ -2266,16 +2504,18 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 		}
 		/** Body of a sent user message / steering row.
 		*
-		*  dsh 0.1.3-alpha.2 removed the `MessageText` component from the primitives
-		*  module in favour of the `projectUserText` display projection (which has
-		*  existed since 0.1.2 and is still exported by 0.1.5). Importing the removed
-		*  name made it `undefined`, so the overlay threw React #130 the moment it
-		*  rendered a session containing a user message — the "toggle does nothing"
-		*  symptom. `projectUserText` returns inline plain runs plus `@session` /
-		*  `/skill` chips; `.fm-user` still supplies the bubble chrome and
-		*  `white-space: pre-wrap`, so the text keeps its shape. */
+		*  The official user-text projection has now changed twice: dsh 0.1.3-alpha.2
+		*  removed `MessageText` in favour of `projectUserText` (which this component
+		*  then imported as a named binding — React #130 the moment a user row
+		*  rendered when the later removal made it `undefined`), and dsh 0.2.2's
+		*  desktop runtime removed `projectUserText` itself (the conversation surface
+		*  parses user text and falls back to the `UserTextRun` primitive).
+		*  `projectUserTextCompat` resolves the projection the running primitives
+		*  module exports (`projectUserText` → `UserTextRun` → raw text), so one
+		*  bundle serves 0.1.2 through 0.2.2. `.fm-user` still supplies the bubble
+		*  chrome and `white-space: pre-wrap`, so the text keeps its shape. */
 		function UserText({ text }) {
-			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children: (0, _deepseek_ai_dsh_client_ui_primitives.projectUserText)(text, []) });
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children: projectUserTextCompat(text) });
 		}
 		let bodyEl = null;
 		const anchors = {};
@@ -2301,13 +2541,16 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 			return snap;
 		}
 		/** The session's pending user interaction (question / plan review / approval),
-		*  read from the uiSession pending-interactions map — dsh 0.1.2 moved the old
-		*  snapshot `pending` array into this root-level observable. When the service
-		*  is absent (older dsh), falls back to the session snapshot's flat `pending`
-		*  array through the `legacyPendingOf` adapter. Returns null when this session
-		*  has nothing pending. */
+		*  read from the uiSession services. dsh 0.1.2 exposed the root-level
+		*  `pendingInteractions` map; dsh 0.2 unified it into `sessionStatus`
+		*  (`ReadonlyMap<sessionId, { running, pendingInteraction, completionUnread }>`).
+		*  When neither service is present (older dsh), falls back to the session
+		*  snapshot's flat `pending` array through the `legacyPendingOf` adapter.
+		*  Returns null when this session has nothing pending. */
 		function usePendingInteraction(uiSession, sessionId, snap) {
-			const source = uiSession && uiSession.pendingInteractions;
+			const legacyMap = uiSession && uiSession.pendingInteractions;
+			const statusMap = uiSession && uiSession.sessionStatus;
+			const source = legacyMap || statusMap;
 			const read = () => {
 				try {
 					return source ? source.getSnapshot() : null;
@@ -2328,7 +2571,47 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 					return;
 				}
 			}, [source]);
-			return pendingInteractionOf(map, sessionId) || legacyPendingOf(snap);
+			return (legacyMap ? pendingInteractionOf(map, sessionId) : pendingInteractionFromStatus(map, sessionId)) || legacyPendingOf(snap);
+		}
+		/** The viewed session id, resolved across dsh generations. dsh <= 0.1.x carried
+		*  the selection on the session-list snapshot (`listState.current`); dsh 0.2
+		*  dropped it and publishes the main view's retained session as the uiSession
+		*  main binding. Subscribes to whichever source exists (both, when both do), so
+		*  switching sessions re-resolves either way. */
+		function useCurrentSessionId(sessions, uiSession, listState) {
+			const read = () => {
+				if (!sessions || typeof sessions.list?.getSnapshot !== "function") return void 0;
+				let mainBinding = null;
+				try {
+					mainBinding = uiSession && uiSession.current ? uiSession.current.getSnapshot() : null;
+				} catch {
+					mainBinding = null;
+				}
+				return currentSessionIdOf(sessions.list.getSnapshot(), mainBinding);
+			};
+			const [id, setId] = (0, react.useState)(read);
+			(0, react.useEffect)(() => {
+				if (!sessions || typeof sessions.list?.subscribe !== "function") {
+					setId(void 0);
+					return;
+				}
+				const sync = () => setId(read());
+				sync();
+				const unsubs = [];
+				try {
+					unsubs.push(sessions.list.subscribe(sync));
+				} catch {}
+				const main = uiSession && uiSession.current;
+				if (main && typeof main.subscribe === "function") try {
+					unsubs.push(main.subscribe(sync));
+				} catch {}
+				return () => {
+					for (const u of unsubs) try {
+						u();
+					} catch {}
+				};
+			}, [sessions, uiSession]);
+			return id;
 		}
 		/** The session's Chat view snapshot (dsh 0.1.2 `ChatSnapshot`) from the
 		*  uiConversation assembly — the first subscriber activates the chat target,
@@ -2355,20 +2638,25 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 			}, [uiConversation, sessionId]);
 			return chat;
 		}
-		/** The official "对话显示" preference (`ui-chat.transcriptView`, values
-		*  normal | compact), read reactively from the settings scope the official
-		*  TranscriptViewPolicy binds. Defaults to compact — the official default —
-		*  when the scope or the section has not arrived yet. */
-		function useTranscriptViewMode(settingsScope) {
-			const source = settingsScope;
-			const read = () => {
+		/** The official "对话显示" preference (`ui-chat.transcriptView`), read
+		*  reactively. dsh <= 0.1.x serves it through the settings scope the official
+		*  TranscriptViewPolicy binds (values normal | compact); dsh 0.2 retired that
+		*  service and serves the same field through the `configForms` controller for
+		*  the `ui-chat` namespace (compact | standard | detailed | verbose, with the
+		*  legacy normal | expanded values still accepted). Both are read through the
+		*  shared `transcriptViewOf` projection; only `compact` folds the tool flow.
+		*  Defaults to compact when no preference has arrived yet. */
+		function useTranscriptViewMode(settingsScope, configForms) {
+			const form = (0, react.useMemo)(() => {
+				if (settingsScope) return settingsScope;
 				try {
-					const section = source ? source.getSnapshot().value : null;
-					return (section ? section.transcriptView : null) === "normal" ? "normal" : "compact";
+					return configForms && typeof configForms.get === "function" ? configForms.get("ui-chat") : null;
 				} catch {
-					return "compact";
+					return null;
 				}
-			};
+			}, [settingsScope, configForms]);
+			const source = form && typeof form.getSnapshot === "function" ? form : null;
+			const read = () => transcriptViewOf(source);
 			const [mode, setMode] = (0, react.useState)(read);
 			(0, react.useEffect)(() => {
 				if (!source) {
@@ -2433,13 +2721,13 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 			return seat ? seat.querySelector("[contenteditable=\"true\"]") : null;
 		}
 		function FocusContent(props) {
-			const { useSessions, sessions, workspaces, conversation, chatFileMentions, uiSession, uiConversation, settingsScope, t } = props;
+			const { useSessions, sessions, workspaces, conversation, chatFileMentions, uiSession, uiConversation, settingsScope, configForms, sidebarRight, t } = props;
 			const prefs = usePrefs();
 			const listState = useSessions((s) => s);
-			const currentId = listState ? listState.current : void 0;
+			const currentId = useCurrentSessionId(sessions, uiSession, listState);
 			const snap = useSessionSnapshot(sessions, currentId);
 			const chatView = useChatView(uiConversation, currentId);
-			const transcriptView = useTranscriptViewMode(settingsScope);
+			const transcriptView = useTranscriptViewMode(settingsScope, configForms);
 			const legacy = (0, react.useMemo)(() => legacySliceOf(chatView, snap), [chatView, snap]);
 			const stable = legacy.partial == null;
 			const mdLabels = (0, react.useMemo)(() => markdownLabels(t), [t]);
@@ -2765,23 +3053,49 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 				if (conversation && typeof conversation.resolveImage === "function") return conversation.resolveImage(currentId, attachment);
 				return Promise.reject(/* @__PURE__ */ new Error("dsh-focus-overlay: image resolver unavailable"));
 			}
+			const openMentionedFile = (0, react.useCallback)((path, options) => {
+				try {
+					if (workspaces && typeof workspaces.openPath === "function") {
+						workspaces.openPath(path).catch(() => {});
+						return;
+					}
+					const cwd = currentId != null ? sessions?.list?.getSnapshot?.()?.byId?.[currentId]?.cwd : void 0;
+					if (sidebarRight && currentId != null && typeof sidebarRight.openResource === "function") {
+						const address = sessionFileAddressOf(String(currentId), cwd, path);
+						sidebarRight.openResource(address, options && options.line !== void 0 ? { params: { line: options.line } } : void 0);
+					}
+				} catch {}
+			}, [
+				sidebarRight,
+				workspaces,
+				sessions,
+				currentId
+			]);
+			/** Assistant-row inline-code file mentions. The official provider resolves
+			*  only a turn's produced / presented files, and dsh 0.2.x reads them from
+			*  the real Turn face (`owner.turn.data.get('deliverables')`) — the same
+			*  owner the official ui-chat turn tail passes. Handing it a plain
+			*  `{turn: number, step}` makes `forClosing` throw, and the plugin's catch
+			*  silently disabled the chips on every 0.2 build (pre-existing bug, not a
+			*  0.2.2 regression). `fileMentionOwnerOf` (model.ts) resolves the Turn face
+			*  from the Chat snapshot's `timeline.turns`, and keeps the legacy owner
+			*  shape for generations without a timeline. */
 			const fileMentionsFor = (0, react.useCallback)((node) => {
 				if (!chatFileMentions) return void 0;
 				try {
-					return chatFileMentions.forClosing({
-						turn: {
-							turn: node.turn,
-							step: node.step
-						},
-						seq: node.seq,
-						openFile: (path) => {
-							if (workspaces) workspaces.openPath(path).catch(() => {});
-						}
-					});
+					const openFile = (path, options) => openMentionedFile(path, options);
+					const resolved = fileMentionOwnerOf(chatView, node, openFile);
+					if (resolved === null) return void 0;
+					return chatFileMentions.forClosing(resolved.owner, currentId);
 				} catch {
 					return;
 				}
-			}, [chatFileMentions, workspaces]);
+			}, [
+				chatFileMentions,
+				chatView,
+				currentId,
+				openMentionedFile
+			]);
 			const binding = (0, react.useMemo)(() => sessions && currentId != null ? sessions.binding(currentId) : void 0, [sessions, currentId]);
 			const inputFace = useInputFace(conversation, binding && binding.ctx);
 			const inputState = useInputState(inputFace);
@@ -2829,7 +3143,7 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 				setDockFocused(f);
 				if (!f) setEngaged(false);
 			};
-			const queueCount = snap && snap.queue ? snap.queue.length : 0;
+			const queueCount = inputState && Array.isArray(inputState.queue) ? inputState.queue.length : snap && snap.queue ? snap.queue.length : 0;
 			const occCount = inputState && inputState.occurrences ? inputState.occurrences.length : 0;
 			const promptErr = snap && snap.promptError && snap.promptError.op === "send" ? snap.promptError.error : null;
 			const errorLine = promptErr ? promptErr.message || promptErr.code || "send failed" : null;
@@ -3037,7 +3351,7 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 								className: "fm-process-label",
 								children: processLabel(it.counts, t)
-							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronDownOutline14, { className: "fm-process-chevron" })]
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconChevronDown, { className: "fm-process-chevron" })]
 						}) : null, open ? it.workItems.map((wi, wi2) => renderItem(wi, key + "-w" + wi2, false)) : null] }, key);
 					}
 					return null;
@@ -3147,6 +3461,11 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 				ref: overlayRef,
 				tabIndex: -1,
 				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "fm-frame-strip",
+						"data-window-drag": true,
+						"aria-hidden": "true"
+					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						className: "fm-topbar",
 						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
@@ -3371,6 +3690,15 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 				})
 			});
 		}
+		/** The settings body both plugin-settings surfaces share: the preference
+		*  fields plus the focus-entry counter. Rendered by the legacy Settings card
+		*  and by the dsh 0.2 Plugins-page bundle page. */
+		function FocusSettingsBody({ t }) {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(FocusPrefsFields, { t }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(FocusEntryStat, { t })] });
+		}
+		/** Legacy surface (dsh <= 0.1.x): a collapsible `<li>` card in the Settings
+		*  → Plugins tab, registered into the keyed `settings.plugin.item` slot. dsh
+		*  0.2 removed that slot, so this only renders where the slot is declared. */
 		function FocusSettingsCard({ t }) {
 			const [open, setOpen] = (0, react.useState)(false);
 			const title = t("settings.label");
@@ -3391,13 +3719,24 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 							className: "fm-plugin-card-desc",
 							children: t("settings.description")
 						})]
-					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronDownOutline14, { className: "fm-plugin-card-chevron" + (open ? " fm-plugin-card-chevron-open" : "") })]
-				}), open ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(IconChevronDown, { className: "fm-plugin-card-chevron" + (open ? " fm-plugin-card-chevron-open" : "") })]
+				}), open ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 					className: "fm-plugin-card-body",
-					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(FocusPrefsFields, { t }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(FocusEntryStat, { t })]
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(FocusSettingsBody, { t })
 				}) : null]
 			});
 		}
+		/** dsh 0.2 surface: the bundle's own configuration on the sidebar Plugins
+		*  page (`plugins.bundle.config`, keyed by the bundle's package name). The page
+		*  draws the title, icon, and crumb itself and always asks for `view: 'page'`,
+		*  so this renders the body alone — no card chrome, no collapse. */
+		function FocusBundleConfig({ t, view }) {
+			if (view !== void 0 && view !== "page") return null;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				className: "fm-plugin-page",
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(FocusSettingsBody, { t })
+			});
+		}
 		function FocusOnboarding(props) {
 			const { complete, openSection, t } = props;
 			const [done, setDone] = (0, react.useState)(() => onboardingStore.isDone());
@@ -3429,7 +3768,13 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 				onboardingStore.markDone();
 				setDone(true);
 				finish();
-				openSection("plugins");
+				let opened = false;
+				if (typeof props.openSettings === "function") try {
+					opened = props.openSettings() !== false;
+				} catch {
+					opened = false;
+				}
+				if (!opened && typeof openSection === "function") openSection("plugins");
 			};
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Modal, {
 				open: true,
@@ -3494,13 +3839,20 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 		/**
 		* Focus Mode, browser half: a full-screen reading overlay in `shell.overlay`
 		* (additive, never replaces shipped UI), a "专注" button in the session header
-		* action row, and a collapsible plugin card in the Plugins settings tab
-		* (`settings.plugin.item`). Rendering reuses the official client UI primitives
-		* module (`@deepseek-ai/dsh-client-ui-primitives` runtime id) — Markdown /
-		* projectUserText / Tooltip / Button — plus the conversation service's composer
-		* registry and the uiSession pending-interaction service (dsh 0.1.2).
+		* action row, and the plugin's settings card. The settings surface lives where
+		* the running dsh keeps it: the Settings → Plugins tab's keyed
+		* `settings.plugin.item` slot on dsh <= 0.1.x, and the sidebar Plugins page's
+		* `plugins.bundle.config` slot (keyed by this bundle's package name) on dsh
+		* 0.2, which retired both that slot and the `settingsScope` service. Rendering
+		* reuses the official client UI primitives module
+		* (`@deepseek-ai/dsh-client-ui-primitives` runtime id) — Markdown /
+		* projectUserText / Button — plus the conversation service's composer registry
+		* and the uiSession pending-interaction / main-binding service.
 		*/
 		const NS = "focus";
+		/** This bundle's package name — the key `plugins.bundle.config` and the
+		*  `pluginNavigation.openBundle` deep link address this plugin by (dsh 0.2). */
+		const PACKAGE_NAME = "dsh-focus-overlay";
 		let warnedLegacy = false;
 		function warnLegacyOnce() {
 			if (warnedLegacy) return;
@@ -3516,8 +3868,7 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 				"locale",
 				"workspaces",
 				"uiSession",
-				"uiConversation",
-				"settingsScope"
+				"uiConversation"
 			],
 			apply(ctx) {
 				const style = document.createElement("style");
@@ -3550,6 +3901,7 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 				const workspaces = ctx.workspaces;
 				const conversation = ctx.get("conversation");
 				const chatFileMentions = ctx.get("chatFileMentions");
+				const sidebarRight = ctx.get("sidebarRight");
 				const uiSession = ctx.get("uiSession");
 				const uiConversation = ctx.get("uiConversation");
 				if (!uiSession || !uiConversation) warnLegacyOnce();
@@ -3560,6 +3912,7 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 				} catch {
 					settingsScope = null;
 				}
+				const configForms = ctx.get("configForms");
 				ctx.effect(() => {
 					let currentId = void 0;
 					let unsubSession = null;
@@ -3622,18 +3975,27 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 						} catch {}
 						if (!unsubChat) chatSlice = legacySliceOf(null, face.getSnapshot());
 					};
+					const mainBinding = () => {
+						try {
+							return uiSession && uiSession.current ? uiSession.current.getSnapshot() : null;
+						} catch {
+							return null;
+						}
+					};
 					const onList = () => {
-						const ls = sessions.list.getSnapshot();
-						const next = ls ? ls.current : void 0;
+						const next = currentSessionIdOf(sessions.list.getSnapshot(), mainBinding());
 						if (next !== currentId) {
 							currentId = next;
 							watch(next);
-						}
+						} else if (next != null && !unsubSession) watch(next);
 					};
 					onList();
 					const unsubList = sessions.list.subscribe(onList);
+					const mainSource = uiSession && uiSession.current;
+					const unsubMain = mainSource && typeof mainSource.subscribe === "function" ? mainSource.subscribe(onList) : null;
 					return () => {
 						if (unsubList) unsubList();
+						if (unsubMain) unsubMain();
 						if (unsubSession) unsubSession();
 						if (unsubChat) unsubChat();
 					};
@@ -3668,6 +4030,8 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 					uiSession,
 					uiConversation,
 					settingsScope,
+					configForms,
+					sidebarRight,
 					t
 				})));
 				ctx.slots.inject("conversation.session.header.actions", () => ctx.slots.register({
@@ -3682,13 +4046,30 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 					id: "dsh-focus-overlay",
 					order: 1e3
 				}, () => (0, react.createElement)(FocusSettingsCard, { t })));
+				ctx.slots.inject("plugins.bundle.config", () => ctx.slots.register({
+					name: "plugins.bundle.config",
+					key: PACKAGE_NAME
+				}, (props) => (0, react.createElement)(FocusBundleConfig, {
+					...props,
+					t
+				})));
+				const pluginNavigation = ctx.get("pluginNavigation");
+				const openSettings = pluginNavigation && typeof pluginNavigation.openBundle === "function" ? () => {
+					try {
+						pluginNavigation.openBundle(PACKAGE_NAME);
+						return true;
+					} catch {
+						return false;
+					}
+				} : void 0;
 				ctx.slots.inject("settings.onboarding", () => ctx.slots.register({
 					name: "settings.onboarding",
 					id: "dsh-focus-overlay",
 					order: 10
 				}, (props) => (0, react.createElement)(FocusOnboarding, {
 					...props,
-					t
+					t,
+					openSettings
 				})));
 			}
 		};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-focus-overlay",
-  "version": "0.12.3",
+  "version": "0.13.0",
   "description": "Focus Mode for the dsh web GUI: a full-screen reading overlay that hides chrome and folds the AI tool-call flow into summaries, reusing the official Markdown / image primitives.",
   "type": "module",
   "main": "lib/index.mjs",
@@ -31,7 +31,9 @@
         "0.1.2-alpha.5": "compatible",
         "0.1.2-rc.1": "compatible",
         "0.1.3-alpha.1": "compatible",
-        "0.1.5-rc.1": "compatible"
+        "0.1.5-rc.1": "compatible",
+        "0.2.0-rc.2": "compatible",
+        "0.2.2-rc.1": "compatible"
       }
     }
   },