dsh-focus-overlay 0.7.2 → 0.8.1

package/README.en.md

@@ -10,7 +10,8 @@
 </p>
 
 <p align="center">
-  <img src="https://badgen.net/npm/v/dsh-focus-overlay" alt="npm version">
+  <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.0-rc.5/blue" alt="dsh version">
 </p>
@@ -22,6 +23,7 @@
 - **Fold tool calls** — an assistant turn collapses into a one-line summary
 - **Quick navigation** — a right-side node navbar with hover preview and click-to-jump
 - **Auto-focus & reminders** — after a reply completes, 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
+- **Hotkey F** — press `F` anywhere to enter focus mode instantly (toggleable in settings); typing in an input never triggers it
 
 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.
 
@@ -59,6 +61,7 @@ Once in focus mode, an assistant turn no longer shows every step — it folds in
 | i18n | Chinese / English copy, follows the UI language |
 | Plugin configuration card | A collapsible card under "Settings → Plugins → Plugin configuration": navbar toggle, open-position strategy, text-area width — persisted to `localStorage` |
 | Auto-enter focus | After a reply **completes normally**, auto-open focus at your question; abnormal endings (stop / error / max-tokens / interrupt) never fire |
+| F hotkey | Press `F` anywhere to enter focus mode instantly (default on, toggleable in settings); never fires while typing in an input, auto-repeat ignored |
 | Reply / waiting reminders | In focus, a "New reply ready + View" toast on completion; an "AI is waiting for your reply + Reply" toast on a question/approval, auto-cleared once answered |
 | DSH-better-sidebar compatibility | While in focus, auto-hide its top-right panel toggle buttons and any open right/bottom panels (and release the squeezed layout); restored on exit |
 
@@ -103,7 +106,7 @@ Restart `dsh web` after install.
 
 ## Usage
 
-1. Open a session and click the **"Focus"** button in the session header action row.
+1. Open a session and click the **"Focus"** button in the session header action row (or press `F` — toggleable in settings).
 2. You enter the full-screen focus view: a thin top bar (session title + exit) and the conversation only, with tool steps folded into summary lines.
 3. Hover the right-side dots to preview, click to jump; a centered "↓ back to latest" button appears when you're not at the bottom.
 4. Press `Esc` or click "Exit focus" to return — the original UI is untouched.
@@ -117,6 +120,7 @@ In the sidebar "Settings → Plugins → Plugin configuration", expand the "Focu
 | Option | Description |
 | --- | --- |
 | Auto-enter focus mode when the AI finishes a reply | On a normal completion: auto-open at your question when closed, or a "New reply ready" toast when open (default off) |
+| Press F to enter focus mode | Press `F` anywhere to enter focus mode instantly; never fires while typing in an input (default on) |
 | Sync the current reading position when entering focus mode | Open at the message you're reading; off opens at your most recent question (default on) |
 | Show right-side turn navbar | One navigation dot per user message (turn) — hover to preview, click to jump (default on) |
 | Text width | 480–1200px slider for the reading column (default 760px) |

package/README.md

@@ -8,7 +8,8 @@
 </p>
 
 <p align="center">
-  <img src="https://badgen.net/npm/v/dsh-focus-overlay" alt="npm version">
+  <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.0-rc.5/blue" alt="dsh version">
 </p>
@@ -20,6 +21,7 @@
 - **折叠工具调用** —— 一轮 AI 回复折叠成一句话摘要
 - **快速导航** —— 右侧节点导航条，悬停预览、点击跳转
 - **自动专注与提醒** —— 回复完成后可自动进入专注并定位到你的提问；专注中收到新回复、或被 AI 提问等待时弹出提醒
+- **快捷键 F** —— 任意界面按 `F` 一键进入专注模式，可在设置中关闭；在输入框内打字不会误触发
 
 这些功能专为**小屏幕**提供更多内容呈现空间：收起常驻的标题/输入区与工具步骤，让有限的屏幕尽可能多地展示对话。
 
@@ -57,6 +59,7 @@
 | i18n | 中 / 英文案，跟随界面语言 |
 | 插件配置卡片 | 在「设置 → 插件 → 插件配置」中的可折叠卡片，含导航条开关、打开定位策略、文字区宽度，持久化到 `localStorage` |
 | 自动进入专注 | 回复**正常完成**后自动打开专注并定位到本轮你的提问；异常结束（停止 / 报错 / 超 token / 打断）不触发 |
+| F 键快捷键 | 任意界面按 `F` 立即进入专注（默认开，可在设置中关闭）；输入框内打字不触发，长按自动忽略 |
 | 回复 / 等待提醒 | 专注中回复完成弹「新回复已生成 + 查看」；AI 提问 / 审批等待时弹「AI 正在等待你的回复 + 去回复」，回答完自动消失 |
 | 兼容 DSH-better-sidebar | 进入专注时自动隐藏其右上角的收放面板按钮与已开启的右侧/底部面板，并释放被挤压的布局；退出专注后按原状态还原 |
 
@@ -101,7 +104,7 @@ dsh web
 
 ## 使用
 
-1. 打开任意会话，点击标题栏操作区的 **「专注」** 按钮。
+1. 打开任意会话，点击标题栏操作区的 **「专注」** 按钮（或直接按 `F` 键，可在设置中关闭该快捷键）。
 2. 进入全屏专注视图：顶部只有一条极窄栏（会话标题 + 退出），正文只显示你与 AI 的对话，工具步骤折叠为摘要行。
 3. 右侧导航圆点可悬停预览、点击跳转；离开底部时右下出现居中的「↓ 回到最新」。
 4. 按 `Esc` 或点「退出专注」返回原界面，原位置/状态保持不变。
@@ -115,6 +118,7 @@ dsh web
 | 选项 | 说明 |
 | --- | --- |
 | AI完成回复后，自动进入专注模式 | AI 正常完成回复后自动进入并定位到你的提问；已打开时弹「新回复已生成」（默认关） |
+| 按 F 键进入专注模式 | 任意界面按 `F` 立即进入专注模式；输入框内打字不触发（默认开） |
 | 进入专注模式时，同步当前阅读位置 | 进入时定位到你正在阅读的消息；关闭则定位到你最近一次提问（默认开） |
 | 显示右侧轮次导航条 | 在右侧显示导航圆点，每个用户消息（一轮）对应一个，悬停预览、点击跳转（默认开） |
 | 文字区宽度 | 480–1200px 滑块，调整正文阅读列宽（默认 760px） |

package/lib/client.js

@@ -272,6 +272,20 @@ window.__ModuleLoader__.load({
 		function onboardingSeen(stored, version) {
 			return stored === version;
 		}
+		/** Whether a keydown should enter focus mode via the F hotkey. Pure decision so
+		*  the guard rails are unit-testable: the pref must be enabled, focus must not
+		*  already be open, the press must not land in an editable element (composer /
+		*  inputs — typing "f" must never yank the user into focus mode), no modifier
+		*  may be held, auto-repeat is ignored, and the key must be F (either case). */
+		function hotkeyShouldEnter(e, opts) {
+			if (!opts.enabled) return false;
+			if (opts.focusOn) return false;
+			if (opts.typing) return false;
+			if (e.repeat) return false;
+			if (e.ctrlKey || e.metaKey || e.altKey) return false;
+			const k = typeof e.key === "string" ? e.key : "";
+			return k === "f" || k === "F";
+		}
 		//#endregion
 		//#region src/client/settings.ts
 		const KEY = "dsh-focus-overlay:prefs";
@@ -279,7 +293,8 @@ window.__ModuleLoader__.load({
 			navbar: true,
 			scroll: "preserve",
 			width: 760,
-			autoFocus: false
+			autoFocus: false,
+			hotkey: true
 		};
 		function load() {
 			try {
@@ -815,6 +830,23 @@ window.__ModuleLoader__.load({
 						children: t("settings.autoFocus.hint")
 					})]
 				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "fm-plugin-field",
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+						className: "fm-plugin-check",
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+							type: "checkbox",
+							checked: prefs.hotkey,
+							onChange: (e) => prefsStore.update({ hotkey: e.target.checked })
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							className: "fm-plugin-check-label",
+							children: t("settings.hotkey")
+						})]
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "fm-plugin-field-hint",
+						children: t("settings.hotkey.hint")
+					})]
+				}),
 				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 					className: "fm-plugin-field",
 					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
@@ -966,7 +998,8 @@ window.__ModuleLoader__.load({
 								"fullscreen",
 								"fold",
 								"navbar",
-								"autoFocus"
+								"autoFocus",
+								"hotkey"
 							].map((f) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("li", { children: t("onboarding.feature." + f) }, f))
 						}),
 						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
@@ -1090,6 +1123,8 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 			"settings.scrollPreserve.hint": "进入时定位到你正在阅读的消息；关闭则定位到你最近一次提问",
 			"settings.autoFocus": "AI完成回复后，自动进入专注模式",
 			"settings.autoFocus.hint": "AI 正常完成回复后自动进入并定位到你的提问",
+			"settings.hotkey": "按 F 键进入专注模式",
+			"settings.hotkey.hint": "在任意界面按下 F 立即进入专注模式；在输入框内打字不会触发",
 			"settings.width": "文字区宽度",
 			"settings.width.hint": "专注模式正文的阅读列宽（480–1200px）",
 			"empty": "暂无打开的会话",
@@ -1121,6 +1156,7 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 			"onboarding.feature.fold": "折叠工具调用 —— 把 AI 的命令、编辑、搜索等步骤折叠成一行摘要",
 			"onboarding.feature.navbar": "右侧导航条 —— 按用户消息快速跳转，悬停预览",
 			"onboarding.feature.autoFocus": "自动专注与提醒 —— 回复完成自动进入专注，AI 提问 / 等待时提醒",
+			"onboarding.feature.hotkey": "快捷键 F —— 任意界面按 F 一键进入专注，可在设置中关闭",
 			"onboarding.configure.title": "快速配置",
 			"onboarding.laterNote": "这些设置随时可在「设置 → 插件 → 插件配置」中更改。",
 			"onboarding.openSettings": "打开设置",
@@ -1141,6 +1177,8 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 			"settings.scrollPreserve.hint": "Open at the message you're reading; off opens at your most recent question",
 			"settings.autoFocus": "Auto-enter focus mode when the AI finishes a reply",
 			"settings.autoFocus.hint": "Auto-open at your question after a normal reply",
+			"settings.hotkey": "Press F to enter focus mode",
+			"settings.hotkey.hint": "Press F anywhere to enter focus mode instantly; typing in an input never triggers it",
 			"settings.width": "Text width",
 			"settings.width.hint": "Reading column width (480–1200px)",
 			"empty": "No open session",
@@ -1172,6 +1210,7 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 			"onboarding.feature.fold": "Folded tool calls — collapses commands, edits and searches into one summary line",
 			"onboarding.feature.navbar": "Right-side navbar — jump between user messages with hover previews",
 			"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.openSettings": "Open settings",
@@ -1281,6 +1320,23 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 						if (unsubSession) unsubSession();
 					};
 				});
+				ctx.effect(() => {
+					const onKey = (e) => {
+						const el = e.target;
+						const tag = el ? el.tagName : "";
+						const typing = !!el && (tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT" || el.isContentEditable);
+						if (!hotkeyShouldEnter(e, {
+							enabled: prefsStore.get().hotkey,
+							typing,
+							focusOn: focusStore.get()
+						})) return;
+						e.preventDefault();
+						focusStore.captureChatAnchor();
+						focusStore.set(true);
+					};
+					window.addEventListener("keydown", onKey, true);
+					return () => window.removeEventListener("keydown", onKey, true);
+				});
 				ctx.slots.inject("shell.overlay", () => ctx.slots.register({
 					name: "shell.overlay",
 					id: "focus-mode-overlay",

package/lib/index.mjs

@@ -7,7 +7,8 @@ const FocusSettingsSchema = z.object({
 	navbar: z.boolean().default(true),
 	scroll: z.union(["preserve", "bottom"]).default("preserve"),
 	width: z.number().default(760),
-	autoFocus: z.boolean().default(false)
+	autoFocus: z.boolean().default(false),
+	hotkey: z.boolean().default(true)
 });
 function apply(ctx) {
 	ctx.inject(["settings"], (settingsCtx) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-focus-overlay",
-  "version": "0.7.2",
+  "version": "0.8.1",
   "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",