dsh-focus-overlay 0.12.3 → 0.12.4

package/README.en.md

@@ -10,10 +10,11 @@
 </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
@@ -75,12 +76,13 @@ 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`), so an `undefined` component can never throw React #130 |
 
 ## Install
 
@@ -119,7 +121,7 @@ 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".
+> **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 +135,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

@@ -8,10 +8,11 @@
 </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>
 
 ## 功能
@@ -73,12 +74,13 @@
 | 专注计数 | 设置卡片最底部一行累计进入专注模式的次数（含自动进入），持久化到 `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`），不会因为 `undefined` 组件触发 React #130 |
 
 ## 安装
 
@@ -117,7 +119,7 @@ dsh web
 
 安装后重启 `dsh web` 生效。
 
-> **首次安装**：重启后欢迎页会弹出一次「专注模式」引导，说明功能并让你就地完成配置；其中所有设置随时可在「设置 → 插件 → 插件配置」中更改。
+> **首次安装**：重启后欢迎页会弹出一次「专注模式」引导，说明功能并让你就地完成配置；其中所有设置随时可以更改——新版 dsh 在侧栏「Plugins」页面中打开本插件的详情页，旧版在「设置 → 插件 → 插件配置」中。
 
 ## 使用
 
@@ -131,7 +133,11 @@ dsh web
 
 ## 设置
 
-侧栏「设置 → 插件 → 插件配置」中，展开「专注模式」卡片：
+**dsh 0.2 起**：侧栏「Plugins」页面 → 找到 `dsh-focus-overlay` → 详情页中，配置直接显示在包描述与组件列表之间。
+
+**dsh ≤ 0.1.x**：侧栏「设置 → 插件 → 插件配置」→ 展开「专注模式」卡片。
+
+两种位置呈现同一组选项：
 
 | 选项 | 说明 |
 | --- | --- |

package/lib/client.js

@@ -3,9 +3,62 @@ 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/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 +78,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 +178,28 @@ 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}`;
+		}
 		function flattenText(content) {
 			if (!content || !content.length) return "";
 			let out = "";
@@ -933,7 +1063,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 +1149,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 +1239,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 +1350,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 +1366,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 +1564,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 +1601,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 +1610,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
@@ -1813,6 +1943,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
@@ -2301,13 +2434,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 +2464,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 +2531,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 +2614,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,6 +2946,24 @@ 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
+			]);
 			const fileMentionsFor = (0, react.useCallback)((node) => {
 				if (!chatFileMentions) return void 0;
 				try {
@@ -2774,14 +2973,16 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 							step: node.step
 						},
 						seq: node.seq,
-						openFile: (path) => {
-							if (workspaces) workspaces.openPath(path).catch(() => {});
-						}
-					});
+						openFile: (path, options) => openMentionedFile(path, options)
+					}, currentId);
 				} catch {
 					return;
 				}
-			}, [chatFileMentions, workspaces]);
+			}, [
+				chatFileMentions,
+				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);
@@ -3037,7 +3238,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;
@@ -3371,6 +3572,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 +3601,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 +3650,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 +3721,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 +3750,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 +3783,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 +3794,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 +3857,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 +3912,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 +3928,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.12.4",
   "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,8 @@
         "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"
       }
     }
   },