dsh-focus-overlay 0.12.0 → 0.12.2

package/README.en.md

@@ -25,6 +25,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
+- **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.
 
@@ -71,6 +72,7 @@ Click the line to expand that turn's full work detail (per-category one-line sum
 | Auto-enter focus | After a reply **completes normally**, auto-open focus at your question; abnormal endings (stop / error / max-tokens / interrupt) never fire — the judgement waits for a stable snapshot (streaming tail drained) first |
 | Reply / waiting reminders | In focus, a one-shot "New reply ready + View" toast on completion (auto-dismissed after 6s); a question/approval raises "AI is waiting for your reply + Answer", whose button expands the in-place answer card — auto-cleared once answered, never leaving focus |
 | F hotkey | Press `F` anywhere to enter focus mode instantly (default on, toggleable in settings); never fires while typing in an input or editable element, modifiers and auto-repeat ignored |
+| 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 |

package/README.md

@@ -23,6 +23,7 @@
 - **自动专注与提醒** —— 回复正常完成后可自动进入专注并定位到你的提问；专注中收到新回复、或 AI 等待你回答时弹出提醒
 - **宽度调节** —— 正文两侧的拖拽把手（官方 WidthHandle 复刻），实时拖动阅读列宽并持久化
 - **快捷键 F** —— 任意界面按 `F` 一键进入专注模式，可在设置中关闭；输入框内打字不会误触发
+- **专注计数** —— 设置卡片最底部累计展示你进入专注模式的次数；超过 100 次后出现 GitHub Star 引导，点过一次即被记住，之后提供「前往 GitHub 项目页面」直达按钮
 
 这些功能专为**小屏幕**提供更多内容呈现空间：收起常驻的标题 / 输入区与工具步骤，让有限的屏幕尽可能多地展示对话。
 
@@ -69,6 +70,7 @@
 | 自动进入专注 | 回复**正常完成**后自动打开专注并定位到本轮你的提问；异常结束（停止 / 报错 / 超 token / 打断）不触发——判定要求快照稳定（流式尾部排空）后才下结论 |
 | 回复 / 等待提醒 | 专注中回复完成弹「新回复已生成 + 查看」（6 秒自动消失，一次性）；AI 提问 / 审批等待时弹「AI 正在等待你的回复 + 去回答」，按钮原地展开答题卡，作答后自动消失——全程无需退出专注 |
 | F 键快捷键 | 任意界面按 `F` 立即进入专注（默认开，可在设置中关闭）；输入框 / 可编辑元素内打字不触发，忽略修饰键与长按自动重复 |
+| 专注计数 | 设置卡片最底部一行累计进入专注模式的次数（含自动进入），持久化到 `localStorage`；超过 100 次出现 Star 引导按钮，点击前往仓库页面并记住状态，之后改为「前往 GitHub 项目页面」直达按钮 |
 | Esc 逐层退出 | 答题卡 → 输入条 → 专注模式，一层一层退；输入法组词中的 Esc 优先取消组词 |
 | i18n | 中 / 英文案，注册到 `focus` 命名空间，跟随界面语言 |
 | 插件配置卡片 | 「设置 → 插件 → 插件配置」中的可折叠卡片，偏好持久化到 `localStorage`；Node 半区以 schemastery schema 注册同名设置 namespace 供其分发 |

package/lib/client.js

@@ -519,6 +519,39 @@ window.__ModuleLoader__.load({
 		function onboardingSeen(stored, version) {
 			return stored === version;
 		}
+		/** Parse the persisted focus-entry counter (`{"entries":n}` JSON). Anything
+		*  unreadable — null, broken JSON, a non-number or a negative — reads as 0,
+		*  so one corrupted write can never make the settings page show a bogus
+		*  count; fractions floor (a counter is always whole). */
+		function readEntryCount(raw) {
+			try {
+				if (!raw) return 0;
+				const parsed = JSON.parse(raw);
+				if (!parsed || typeof parsed !== "object") return 0;
+				const n = parsed.entries;
+				if (typeof n !== "number" || !Number.isFinite(n)) return 0;
+				return Math.max(0, Math.floor(n));
+			} catch {
+				return 0;
+			}
+		}
+		/** Whether the settings card should show the Star nudge for this entry count. */
+		function shouldShowStar(entries) {
+			return entries > 100;
+		}
+		/** Whether the persisted stats mark the Star button as already used — the
+		*  card then offers a plain "open the project page" button instead of asking
+		*  for a star again. Anything unreadable reads as not-starred. */
+		function readStarred(raw) {
+			try {
+				if (!raw) return false;
+				const parsed = JSON.parse(raw);
+				if (!parsed || typeof parsed !== "object") return false;
+				return parsed.starred === true;
+			} catch {
+				return false;
+			}
+		}
 		/** 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 /
@@ -757,6 +790,254 @@ window.__ModuleLoader__.load({
 				} catch {}
 			}
 		};
+		const STATS_KEY = "dsh-focus-overlay:stats";
+		function loadStats() {
+			try {
+				const raw = localStorage.getItem(STATS_KEY);
+				return {
+					entries: readEntryCount(raw),
+					starred: readStarred(raw)
+				};
+			} catch {
+				return {
+					entries: 0,
+					starred: false
+				};
+			}
+		}
+		let stats = loadStats();
+		const statsListeners = [];
+		function persistStats(next) {
+			stats = next;
+			try {
+				localStorage.setItem(STATS_KEY, JSON.stringify(next));
+			} catch {}
+			for (const l of statsListeners) l();
+		}
+		const statsStore = {
+			getEntries: () => stats.entries,
+			isStarred: () => stats.starred,
+			/** One focus-mode open. Writes through to localStorage (best effort); when
+			*  storage is unavailable the in-memory value still counts for the session. */
+			bumpEntries: () => persistStats({
+				...stats,
+				entries: stats.entries + 1
+			}),
+			/** Mark the Star button as used (idempotent). */
+			markStarred: () => {
+				if (!stats.starred) persistStats({
+					...stats,
+					starred: true
+				});
+			},
+			subscribe: (l) => {
+				statsListeners.push(l);
+				return () => {
+					const i = statsListeners.indexOf(l);
+					if (i >= 0) statsListeners.splice(i, 1);
+				};
+			}
+		};
+		function useEntryCount() {
+			const [n, setN] = (0, react.useState)(statsStore.getEntries);
+			(0, react.useEffect)(() => statsStore.subscribe(() => setN(statsStore.getEntries)), []);
+			return n;
+		}
+		function useStarred() {
+			const [s, setS] = (0, react.useState)(statsStore.isStarred);
+			(0, react.useEffect)(() => statsStore.subscribe(() => setS(statsStore.isStarred)), []);
+			return s;
+		}
+		//#endregion
+		//#region src/client/locales.ts
+		/** i18n dictionaries for the `focus` namespace. */
+		const zh = {
+			"toggle": "专注",
+			"toggle.title": "进入专注模式",
+			"exit": "退出专注 (Esc)",
+			"backToLatest": "回到最新",
+			"nav.label": "回合导航",
+			"nav.jump": "跳转到第 {n} 回合",
+			"nav.turn": "第 {n} 回合",
+			"settings.label": "专注模式",
+			"settings.description": "全屏阅读遮罩的偏好设置",
+			"settings.expand": "展开",
+			"settings.collapse": "收起",
+			"settings.navbar": "显示右侧轮次导航条",
+			"settings.navbar.hint": "在右侧显示导航圆点，每个用户消息（一轮）对应一个，悬停预览、点击跳转",
+			"settings.scrollPreserve": "进入专注模式时，同步当前阅读位置",
+			"settings.scrollPreserve.hint": "进入时定位到你正在阅读的消息；关闭则定位到你最近一次提问",
+			"settings.autoFocus": "AI完成回复后，自动进入专注模式",
+			"settings.autoFocus.hint": "AI 正常完成回复后自动进入并定位到你的提问",
+			"settings.hotkey": "按 F 键进入专注模式",
+			"settings.hotkey.hint": "在任意界面按下 F 立即进入专注模式；在输入框内打字不会触发",
+			"settings.borrow": "使用官方输入框",
+			"settings.borrow.hint": "专注模式直接借用主界面的官方输入框（支持 / 指令、@ 引用文件与会话）；关闭时使用插件内置输入框。官方输入框不可用时自动回退。",
+			"settings.entries": "您已进入专注模式 {n} 次",
+			"settings.entries.cheer": "🎉 您已进入专注模式 {n} 次 ✨",
+			"settings.entries.star": "为这个项目点一个 GitHub Star ⭐",
+			"settings.entries.repo": "前往 GitHub 项目页面",
+			"process.toolCalls": "{n} 次工具调用",
+			"process.messages": "{n} 条消息",
+			"process.subagents": "{n} 个 subagent",
+			"process.thought": "已思考",
+			"process.separator": " · ",
+			"process.toolRow": "已完成",
+			"empty": "暂无打开的会话",
+			"loading": "正在读取会话…",
+			"running": "正在工作",
+			"reply.ready": "新回复已生成",
+			"reply.view": "查看",
+			"reply.waiting": "AI 正在等待你的回复",
+			"answer.open": "去回答",
+			"answer.title": "等待你的回答",
+			"answer.approvalTitle": "请求审批",
+			"answer.planTitle": "计划待审",
+			"answer.submit": "提交回答",
+			"answer.close": "收起",
+			"answer.custom": "其他答案（可选）",
+			"answer.recommended": "推荐",
+			"answer.incomplete": "请先回答所有问题",
+			"answer.rejected": "提交被拒绝",
+			"answer.allow": "允许",
+			"answer.reject": "拒绝",
+			"composer.placeholder": "输入回复…",
+			"composer.send": "发送",
+			"markdown.code.copy": "复制代码",
+			"markdown.code.copied": "已复制",
+			"markdown.footnotes": "脚注",
+			"composer.expand": "展开输入框",
+			"composer.queued": "已排队 {n}",
+			"composer.occurrences": "草稿中包含引用 / 命令，在此编辑可能使其失效，建议退出专注模式编辑",
+			"sum.context": "载入了 {n} 项上下文",
+			"sum.commands": "运行了 {n} 个命令",
+			"sum.edits": "编辑了 {n} 个文件",
+			"sum.searches": "搜索了 {n} 个正则",
+			"sum.files": "读取了 {n} 个文件",
+			"sum.dirs": "列出了 {n} 个目录",
+			"sum.subagents": "fork 了 {n} 个子代理",
+			"sum.todos": "更新了待办",
+			"sum.goals": "更新了目标",
+			"sum.workflows": "运行了 {n} 个工作流",
+			"sum.skills": "载入了 {n} 个技能",
+			"sum.questions": "问了 {n} 个问题",
+			"sum.plans": "计划了 {n} 次",
+			"sum.jobs": "后台任务 {n} 个",
+			"sum.others": "调用了 {n} 个工具",
+			"onboarding.title": "欢迎使用专注模式",
+			"onboarding.intro": "dsh-focus-overlay 为 DeepSeek Harness Web 提供全屏专注阅读。",
+			"onboarding.features.title": "功能",
+			"onboarding.feature.fullscreen": "全屏阅读 —— 隐藏标题栏、输入区与侧栏，纵向空间尽给对话",
+			"onboarding.feature.fold": "折叠工具调用 —— 把 AI 的命令、编辑、搜索等步骤折叠成一行摘要",
+			"onboarding.feature.navbar": "右侧导航条 —— 按用户消息快速跳转，悬停预览",
+			"onboarding.feature.autoFocus": "自动专注与提醒 —— 回复完成自动进入专注，AI 提问 / 等待时提醒",
+			"onboarding.feature.hotkey": "快捷键 F —— 任意界面按 F 一键进入专注，可在设置中关闭",
+			"onboarding.configure.title": "快速配置",
+			"onboarding.laterNote": "这些设置随时可在「设置 → 插件 → 插件配置」中更改。",
+			"onboarding.openSettings": "打开设置",
+			"onboarding.done": "完成"
+		};
+		const en = {
+			"toggle": "Focus",
+			"toggle.title": "Enter focus mode",
+			"exit": "Exit focus (Esc)",
+			"backToLatest": "Back to latest",
+			"nav.label": "Turn navigation",
+			"nav.jump": "Jump to turn {n}",
+			"nav.turn": "Turn {n}",
+			"settings.label": "Focus Mode",
+			"settings.description": "Preferences for the full-screen reading overlay",
+			"settings.expand": "Expand",
+			"settings.collapse": "Collapse",
+			"settings.navbar": "Show right-side turn navbar",
+			"settings.navbar.hint": "Show one navigation dot per user message (turn) — hover to preview, click to jump",
+			"settings.scrollPreserve": "Sync the current reading position when entering focus mode",
+			"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.borrow": "Use the official composer",
+			"settings.borrow.hint": "Focus mode borrows the main view's official composer (slash commands, @ file/session references included); turn off to use the built-in input bar. Falls back automatically when the official composer is unavailable.",
+			"settings.entries": "You have entered focus mode {n} times",
+			"settings.entries.cheer": "🎉 You have entered focus mode {n} times ✨",
+			"settings.entries.star": "Give this project a GitHub Star ⭐",
+			"settings.entries.repo": "Open the GitHub project page",
+			"process.toolCalls": "{n} tool calls",
+			"process.messages": "{n} messages",
+			"process.subagents": "{n} subagents",
+			"process.thought": "Thought for a while",
+			"process.separator": " · ",
+			"process.toolRow": "completed",
+			"empty": "No open session",
+			"loading": "Reading session…",
+			"running": "Working",
+			"reply.ready": "New reply ready",
+			"reply.view": "View",
+			"reply.waiting": "AI is waiting for your reply",
+			"answer.open": "Answer",
+			"answer.title": "Waiting for your answer",
+			"answer.approvalTitle": "Approval requested",
+			"answer.planTitle": "Plan review",
+			"answer.submit": "Submit answer",
+			"answer.close": "Collapse",
+			"answer.custom": "Other (optional)",
+			"answer.recommended": "Recommended",
+			"answer.incomplete": "Answer every question first",
+			"answer.rejected": "Submission rejected",
+			"answer.allow": "Allow",
+			"answer.reject": "Deny",
+			"composer.placeholder": "Type a reply…",
+			"composer.send": "Send",
+			"markdown.code.copy": "Copy code",
+			"markdown.code.copied": "Copied",
+			"markdown.footnotes": "Footnotes",
+			"composer.expand": "Expand input",
+			"composer.queued": "Queued {n}",
+			"composer.occurrences": "Draft contains references / commands — editing here may break them; edit outside focus mode",
+			"sum.context": "loaded {n} context items",
+			"sum.commands": "ran {n} commands",
+			"sum.edits": "edited {n} files",
+			"sum.searches": "ran {n} searches",
+			"sum.files": "read {n} files",
+			"sum.dirs": "listed {n} directories",
+			"sum.subagents": "forked {n} subagents",
+			"sum.todos": "updated todos",
+			"sum.goals": "updated goals",
+			"sum.workflows": "ran {n} workflows",
+			"sum.skills": "loaded {n} skills",
+			"sum.questions": "asked {n} questions",
+			"sum.plans": "planned {n} times",
+			"sum.jobs": "{n} background jobs",
+			"sum.others": "called {n} tools",
+			"onboarding.title": "Welcome to Focus Mode",
+			"onboarding.intro": "dsh-focus-overlay adds full-screen reading to the DeepSeek Harness web GUI.",
+			"onboarding.features.title": "Features",
+			"onboarding.feature.fullscreen": "Full-screen reading — hides the header, composer and sidebars",
+			"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",
+			"onboarding.done": "Done"
+		};
+		/** Labels the official MarkdownText requires for its code-block copy buttons
+		*  and footnotes section — mirrors the official `markdownLabels(t)` shape.
+		*  Lives here (not FocusView) so both the transcript items and the answer
+		*  card share it without an import cycle (FocusView imports Composer).
+		*  Without it the renderer throws `Cannot read properties of undefined
+		*  (reading 'code')` on the first fenced code block. */
+		function markdownLabels(t) {
+			return {
+				code: {
+					copyLabel: t("markdown.code.copy"),
+					copiedLabel: t("markdown.code.copied")
+				},
+				footnotes: t("markdown.footnotes")
+			};
+		}
 		//#endregion
 		//#region src/client/Composer.tsx
 		/**
@@ -854,6 +1135,8 @@ window.__ModuleLoader__.load({
 			const { t, width, wait, onClose } = props;
 			const isQuestion = !(wait.kind === "approval");
 			const questions = isQuestion && Array.isArray(wait.questions) ? wait.questions : [];
+			const isPlanReview = questions.some((q) => q && q.intent && q.intent.kind === "plan-review");
+			const mdLabels = (0, react.useMemo)(() => markdownLabels(t), [t]);
 			const [drafts, setDrafts] = (0, react.useState)({});
 			const [busy, setBusy] = (0, react.useState)(false);
 			const [error, setError] = (0, react.useState)(null);
@@ -929,7 +1212,7 @@ window.__ModuleLoader__.load({
 								children: t("reply.waiting")
 							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
 								className: "fm-card-title",
-								children: t("answer.title")
+								children: isPlanReview ? t("answer.planTitle") : t("answer.title")
 							})]
 						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 							type: "button",
@@ -973,7 +1256,10 @@ window.__ModuleLoader__.load({
 									}),
 									q.detail ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 										className: "fm-card-detail",
-										children: q.detail
+										children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.MarkdownText, {
+											text: q.detail,
+											labels: mdLabels
+										})
 									}) : null,
 									q.options && q.options.length ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 										className: "fm-card-opts",
@@ -1198,6 +1484,172 @@ window.__ModuleLoader__.load({
 			});
 		}
 		//#endregion
+		//#region src/client/celebrate.ts
+		/**
+		* Firework for the Star button: a short, self-contained canvas animation
+		* appended to document.body with pointer-events:none and removed when done,
+		* so it can never intercept clicks. No dependencies, no stylesheet injection:
+		* every style is inline, so cleanup is simply removing the element.
+		*
+		* Five staggered bursts of ~90 trailing particles each; the GitHub page opens
+		* only after the show ends (celebrateThenOpen).
+		*/
+		const BURSTS = 5;
+		const BURST_GAP_MS = 280;
+		const PARTICLES_PER_BURST = 90;
+		const GRAVITY = 300;
+		const MAX_LIFE_S = 2;
+		const COLORS = [
+			"#f43f5e",
+			"#fb923c",
+			"#facc15",
+			"#4ade80",
+			"#38bdf8",
+			"#a78bfa",
+			"#f472b6"
+		];
+		const FIREWORKS_TOTAL_MS = 4e3;
+		/** Play the fireworks, then open `url` in a new tab once the sky is clear.
+		*  Browsers honor the click's transient activation for a few seconds, so the
+		*  delayed open is not popup-blocked in Chrome; stricter browsers fall back
+		*  on the repo button beside the counter, which opens the page directly. */
+		function celebrateThenOpen(url) {
+			const launched = launchFireworks();
+			setTimeout(() => {
+				try {
+					window.open(url, "_blank", "noopener");
+				} catch {}
+			}, launched ? FIREWORKS_TOTAL_MS : 400);
+		}
+		/** Launch the bursts. Returns false when nothing was animated (reduced-motion
+		*  preference, an existing show, or an unavailable 2D context). */
+		function launchFireworks() {
+			try {
+				if (window.matchMedia && window.matchMedia("(prefers-reduced-motion: reduce)").matches) return false;
+				if (document.querySelector("[data-fm-fireworks]")) return false;
+				const canvas = document.createElement("canvas");
+				canvas.setAttribute("data-fm-fireworks", "");
+				const dpr = Math.min(window.devicePixelRatio || 1, 2);
+				const w = window.innerWidth;
+				const h = window.innerHeight;
+				canvas.width = Math.max(1, Math.floor(w * dpr));
+				canvas.height = Math.max(1, Math.floor(h * dpr));
+				canvas.style.cssText = "position:fixed;inset:0;width:100vw;height:100vh;pointer-events:none;z-index:2147483000";
+				document.body.appendChild(canvas);
+				const ctx = canvas.getContext("2d");
+				if (!ctx) {
+					canvas.remove();
+					return false;
+				}
+				ctx.scale(dpr, dpr);
+				const rand = (a, b) => a + Math.random() * (b - a);
+				const rockets = [];
+				const particles = [];
+				const spawnRocket = (i) => {
+					rockets.push({
+						x: w * (.22 + .14 * i) + rand(-30, 30),
+						y: h + 8,
+						vy: -h * rand(1.05, 1.25),
+						targetY: h * rand(.14, .36),
+						color: COLORS[i % COLORS.length]
+					});
+				};
+				const start = performance.now();
+				let spawned = 0;
+				const explode = (r) => {
+					for (let k = 0; k < PARTICLES_PER_BURST; k++) {
+						const angle = Math.PI * 2 * k / PARTICLES_PER_BURST + rand(-.07, .07);
+						const speed = rand(80, 430) * (k % 4 === 0 ? .55 : 1);
+						const maxLife = rand(1.2, MAX_LIFE_S);
+						particles.push({
+							x: r.x,
+							y: r.y,
+							px: r.x,
+							py: r.y,
+							vx: Math.cos(angle) * speed,
+							vy: Math.sin(angle) * speed,
+							life: maxLife,
+							maxLife,
+							color: Math.random() < .25 ? "#ffffff" : r.color
+						});
+					}
+				};
+				let prev = performance.now();
+				let raf = 0;
+				const step = (now) => {
+					const dt = Math.min((now - prev) / 1e3, .05);
+					prev = now;
+					ctx.clearRect(0, 0, w, h);
+					ctx.globalCompositeOperation = "lighter";
+					const elapsed = now - start;
+					while (spawned < BURSTS && elapsed >= spawned * BURST_GAP_MS) spawnRocket(spawned++);
+					for (let i = rockets.length - 1; i >= 0; i--) {
+						const r = rockets[i];
+						r.y += r.vy * dt;
+						ctx.globalAlpha = .9;
+						ctx.strokeStyle = r.color;
+						ctx.lineWidth = 2.4;
+						ctx.beginPath();
+						ctx.moveTo(r.x, r.y + 9);
+						ctx.lineTo(r.x, r.y);
+						ctx.stroke();
+						if (Math.random() < .6) particles.push({
+							x: r.x + rand(-2, 2),
+							y: r.y + rand(0, 6),
+							px: r.x,
+							py: r.y,
+							vx: rand(-30, 30),
+							vy: rand(10, 70),
+							life: rand(.25, .5),
+							maxLife: .5,
+							color: r.color
+						});
+						if (r.y <= r.targetY) {
+							explode(r);
+							rockets.splice(i, 1);
+						}
+					}
+					ctx.lineWidth = 1.8;
+					for (let i = particles.length - 1; i >= 0; i--) {
+						const p = particles[i];
+						p.life -= dt;
+						if (p.life <= 0) {
+							particles.splice(i, 1);
+							continue;
+						}
+						p.px = p.x;
+						p.py = p.y;
+						p.vy += GRAVITY * dt;
+						p.vx *= 1 - 1.1 * dt;
+						p.vy *= 1 - .4 * dt;
+						p.x += p.vx * dt;
+						p.y += p.vy * dt;
+						let a = p.life / p.maxLife;
+						if (p.life < p.maxLife * .4 && Math.random() < .35) a *= .3;
+						ctx.globalAlpha = Math.max(0, a);
+						ctx.strokeStyle = p.color;
+						ctx.beginPath();
+						ctx.moveTo(p.px, p.py);
+						ctx.lineTo(p.x, p.y);
+						ctx.stroke();
+					}
+					ctx.globalAlpha = 1;
+					if (elapsed < FIREWORKS_TOTAL_MS || rockets.length > 0 || particles.length > 0) {
+						raf = requestAnimationFrame(step);
+						return;
+					}
+					canvas.remove();
+				};
+				raf = requestAnimationFrame(step);
+				setTimeout(() => {
+					cancelAnimationFrame(raf);
+					canvas.remove();
+				}, 7e3);
+				return true;
+			} catch {}
+			return false;
+		}
+		//#endregion
 		//#region src/client/styles.ts
 		/** Package-owned stylesheet text (injected by the client apply, cleaned up on unload). */
 		const FOCUS_CSS = `
@@ -1323,7 +1775,10 @@ window.__ModuleLoader__.load({
 .fm-card-body{overscroll-behavior:contain;flex:1 1 auto;min-height:0;display:flex;flex-direction:column;overflow-y:auto;padding-bottom:8px;font-size:var(--dsh-content-font-size,14px);line-height:calc(22px + var(--dsh-content-font-delta,0px))}
 .fm-card-q{display:flex;flex-direction:column}
 .fm-card-q-text{margin:0 2px 8px;padding:0 22px;white-space:pre-wrap;word-break:break-word;font-size:calc(var(--dsh-content-font-size,14px) + 2px);font-weight:500;line-height:calc(22px + var(--dsh-content-font-delta,0px))}
-.fm-card-detail{color:var(--dsw-alias-label-secondary,#888);margin:0 2px 8px;padding:0 22px;font-size:var(--dsh-content-font-size,14px);line-height:calc(22px + var(--dsh-content-font-delta,0px))}
+.fm-card-detail{color:var(--dsw-alias-label-secondary,#888);margin:0 2px 8px;padding:0 22px;font:var(--dsw-font-markdown-base,400 var(--dsh-content-font-size,14px)/calc(24px + var(--dsh-content-font-delta,0px)) var(--dsw-font-family,sans-serif))}
+.fm-card-detail>*:first-child{margin-top:0}
+.fm-card-detail>*:last-child{margin-bottom:0}
+.fm-card-detail pre{overflow-x:auto}
 .fm-card-opts{display:flex;flex-direction:column;gap:1px;margin:8px 0 0;padding:4px 12px}
 .fm-opt{width:100%;min-height:40px;color:inherit;text-align:left;cursor:pointer;background:0 0;border:1px solid #0000;border-radius:12px;flex-shrink:0;display:flex;align-items:flex-start;gap:8px;padding:8px 12px 8px 8px;transition:background-color .12s,border-color .12s;font:inherit}
 .fm-opt:hover:not(:disabled),.fm-opt-on{background:var(--dsw-alias-interactive-bg-hover,rgba(0,0,0,.06))}
@@ -1357,9 +1812,13 @@ window.__ModuleLoader__.load({
 .fm-plugin-card-desc{color:var(--dsw-alias-label-tertiary);font-size:13px;line-height:1.5}
 .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:12px}
+.fm-plugin-card-body{border-top:1px solid var(--dsw-alias-border-l2);margin:0 16px;padding-bottom:16px}
 .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
+   own — the body's 16px padding-bottom is the entire below-gap, matching the
+   row's 16px above-gap after the divider (symmetric, one rhythm). */
+.fm-plugin-field-stat{padding:16px 0 0}
 .fm-plugin-field-head{align-items:center;gap:8px;display:flex}
 .fm-plugin-field-label{min-width:0;color:var(--dsw-alias-label-primary);flex:1;font-size:13px;font-weight:500;line-height:1.5}
 .fm-plugin-field-value{color:var(--dsw-alias-label-secondary);font-size:12px;line-height:1.5}
@@ -1748,7 +2207,9 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 		const focusStore = {
 			get: () => focusOn,
 			set: (v) => {
-				focusOn = !!v;
+				const next = !!v;
+				if (next && !focusOn) statsStore.bumpEntries();
+				focusOn = next;
 				notify();
 			},
 			subscribe: (l) => {
@@ -1928,19 +2389,6 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 				alt: ""
 			});
 		}
-		/** Labels the official MarkdownText requires for its code-block copy buttons
-		*  and footnotes section — mirrors the official `markdownLabels(t)` shape.
-		*  Without it the renderer throws `Cannot read properties of undefined
-		*  (reading 'code')` on the first fenced code block. */
-		function markdownLabels(t) {
-			return {
-				code: {
-					copyLabel: t("markdown.code.copy"),
-					copiedLabel: t("markdown.code.copied")
-				},
-				footnotes: t("markdown.footnotes")
-			};
-		}
 		function AssistantItem(props) {
 			const { blocks, loadImage, fileMentions, labels } = props;
 			const text = (blocks || []).filter((b) => b && b.kind === "text").map((b) => b.text).join("");
@@ -2875,6 +3323,41 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 				})
 			] });
 		}
+		/** The settings card's bottom row: the persisted focus-entry counter, and —
+		*  once the count passes the threshold — a nudge to star the repo. */
+		const REPO_URL = "https://github.com/boogoo619/dsh-focus-overlay";
+		function FocusEntryStat({ t }) {
+			const entries = useEntryCount();
+			const starred = useStarred();
+			const star = shouldShowStar(entries);
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				className: "fm-plugin-field fm-plugin-field-stat",
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "fm-plugin-field-head",
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: "fm-plugin-field-label",
+						children: t(star ? "settings.entries.cheer" : "settings.entries", { n: entries })
+					}), star ? starred ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+						variant: "outline",
+						size: "sm",
+						onClick: () => {
+							try {
+								window.open(REPO_URL, "_blank", "noopener");
+							} catch {}
+						},
+						children: t("settings.entries.repo")
+					}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+						variant: "primary",
+						size: "sm",
+						onClick: () => {
+							statsStore.markStarred();
+							celebrateThenOpen(REPO_URL);
+						},
+						children: t("settings.entries.star")
+					}) : null]
+				})
+			});
+		}
 		function FocusSettingsCard({ t }) {
 			const [open, setOpen] = (0, react.useState)(false);
 			const title = t("settings.label");
@@ -2896,9 +3379,9 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 							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.jsx)("div", {
+				}), open ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 					className: "fm-plugin-card-body",
-					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(FocusPrefsFields, { t })
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(FocusPrefsFields, { t }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(FocusEntryStat, { t })]
 				}) : null]
 			});
 		}
@@ -2994,171 +3477,6 @@ body[data-fm-focus] #root :has(> [data-slot="conversation"]){margin-bottom:0!imp
 			});
 		}
 		//#endregion
-		//#region src/client/locales.ts
-		/** i18n dictionaries for the `focus` namespace. */
-		const zh = {
-			"toggle": "专注",
-			"toggle.title": "进入专注模式",
-			"exit": "退出专注 (Esc)",
-			"backToLatest": "回到最新",
-			"nav.label": "回合导航",
-			"nav.jump": "跳转到第 {n} 回合",
-			"nav.turn": "第 {n} 回合",
-			"settings.label": "专注模式",
-			"settings.description": "全屏阅读遮罩的偏好设置",
-			"settings.expand": "展开",
-			"settings.collapse": "收起",
-			"settings.navbar": "显示右侧轮次导航条",
-			"settings.navbar.hint": "在右侧显示导航圆点，每个用户消息（一轮）对应一个，悬停预览、点击跳转",
-			"settings.scrollPreserve": "进入专注模式时，同步当前阅读位置",
-			"settings.scrollPreserve.hint": "进入时定位到你正在阅读的消息；关闭则定位到你最近一次提问",
-			"settings.autoFocus": "AI完成回复后，自动进入专注模式",
-			"settings.autoFocus.hint": "AI 正常完成回复后自动进入并定位到你的提问",
-			"settings.hotkey": "按 F 键进入专注模式",
-			"settings.hotkey.hint": "在任意界面按下 F 立即进入专注模式；在输入框内打字不会触发",
-			"settings.borrow": "使用官方输入框",
-			"settings.borrow.hint": "专注模式直接借用主界面的官方输入框（支持 / 指令、@ 引用文件与会话）；关闭时使用插件内置输入框。官方输入框不可用时自动回退。",
-			"process.toolCalls": "{n} 次工具调用",
-			"process.messages": "{n} 条消息",
-			"process.subagents": "{n} 个 subagent",
-			"process.thought": "已思考",
-			"process.separator": " · ",
-			"process.toolRow": "已完成",
-			"empty": "暂无打开的会话",
-			"loading": "正在读取会话…",
-			"running": "正在工作",
-			"reply.ready": "新回复已生成",
-			"reply.view": "查看",
-			"reply.waiting": "AI 正在等待你的回复",
-			"answer.open": "去回答",
-			"answer.title": "等待你的回答",
-			"answer.approvalTitle": "请求审批",
-			"answer.submit": "提交回答",
-			"answer.close": "收起",
-			"answer.custom": "其他答案（可选）",
-			"answer.recommended": "推荐",
-			"answer.incomplete": "请先回答所有问题",
-			"answer.rejected": "提交被拒绝",
-			"answer.allow": "允许",
-			"answer.reject": "拒绝",
-			"composer.placeholder": "输入回复…",
-			"composer.send": "发送",
-			"markdown.code.copy": "复制代码",
-			"markdown.code.copied": "已复制",
-			"markdown.footnotes": "脚注",
-			"composer.expand": "展开输入框",
-			"composer.queued": "已排队 {n}",
-			"composer.occurrences": "草稿中包含引用 / 命令，在此编辑可能使其失效，建议退出专注模式编辑",
-			"sum.context": "载入了 {n} 项上下文",
-			"sum.commands": "运行了 {n} 个命令",
-			"sum.edits": "编辑了 {n} 个文件",
-			"sum.searches": "搜索了 {n} 个正则",
-			"sum.files": "读取了 {n} 个文件",
-			"sum.dirs": "列出了 {n} 个目录",
-			"sum.subagents": "fork 了 {n} 个子代理",
-			"sum.todos": "更新了待办",
-			"sum.goals": "更新了目标",
-			"sum.workflows": "运行了 {n} 个工作流",
-			"sum.skills": "载入了 {n} 个技能",
-			"sum.questions": "问了 {n} 个问题",
-			"sum.plans": "计划了 {n} 次",
-			"sum.jobs": "后台任务 {n} 个",
-			"sum.others": "调用了 {n} 个工具",
-			"onboarding.title": "欢迎使用专注模式",
-			"onboarding.intro": "dsh-focus-overlay 为 DeepSeek Harness Web 提供全屏专注阅读。",
-			"onboarding.features.title": "功能",
-			"onboarding.feature.fullscreen": "全屏阅读 —— 隐藏标题栏、输入区与侧栏，纵向空间尽给对话",
-			"onboarding.feature.fold": "折叠工具调用 —— 把 AI 的命令、编辑、搜索等步骤折叠成一行摘要",
-			"onboarding.feature.navbar": "右侧导航条 —— 按用户消息快速跳转，悬停预览",
-			"onboarding.feature.autoFocus": "自动专注与提醒 —— 回复完成自动进入专注，AI 提问 / 等待时提醒",
-			"onboarding.feature.hotkey": "快捷键 F —— 任意界面按 F 一键进入专注，可在设置中关闭",
-			"onboarding.configure.title": "快速配置",
-			"onboarding.laterNote": "这些设置随时可在「设置 → 插件 → 插件配置」中更改。",
-			"onboarding.openSettings": "打开设置",
-			"onboarding.done": "完成"
-		};
-		const en = {
-			"toggle": "Focus",
-			"toggle.title": "Enter focus mode",
-			"exit": "Exit focus (Esc)",
-			"backToLatest": "Back to latest",
-			"nav.label": "Turn navigation",
-			"nav.jump": "Jump to turn {n}",
-			"nav.turn": "Turn {n}",
-			"settings.label": "Focus Mode",
-			"settings.description": "Preferences for the full-screen reading overlay",
-			"settings.expand": "Expand",
-			"settings.collapse": "Collapse",
-			"settings.navbar": "Show right-side turn navbar",
-			"settings.navbar.hint": "Show one navigation dot per user message (turn) — hover to preview, click to jump",
-			"settings.scrollPreserve": "Sync the current reading position when entering focus mode",
-			"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.borrow": "Use the official composer",
-			"settings.borrow.hint": "Focus mode borrows the main view's official composer (slash commands, @ file/session references included); turn off to use the built-in input bar. Falls back automatically when the official composer is unavailable.",
-			"process.toolCalls": "{n} tool calls",
-			"process.messages": "{n} messages",
-			"process.subagents": "{n} subagents",
-			"process.thought": "Thought for a while",
-			"process.separator": " · ",
-			"process.toolRow": "completed",
-			"empty": "No open session",
-			"loading": "Reading session…",
-			"running": "Working",
-			"reply.ready": "New reply ready",
-			"reply.view": "View",
-			"reply.waiting": "AI is waiting for your reply",
-			"answer.open": "Answer",
-			"answer.title": "Waiting for your answer",
-			"answer.approvalTitle": "Approval requested",
-			"answer.submit": "Submit answer",
-			"answer.close": "Collapse",
-			"answer.custom": "Other (optional)",
-			"answer.recommended": "Recommended",
-			"answer.incomplete": "Answer every question first",
-			"answer.rejected": "Submission rejected",
-			"answer.allow": "Allow",
-			"answer.reject": "Deny",
-			"composer.placeholder": "Type a reply…",
-			"composer.send": "Send",
-			"markdown.code.copy": "Copy code",
-			"markdown.code.copied": "Copied",
-			"markdown.footnotes": "Footnotes",
-			"composer.expand": "Expand input",
-			"composer.queued": "Queued {n}",
-			"composer.occurrences": "Draft contains references / commands — editing here may break them; edit outside focus mode",
-			"sum.context": "loaded {n} context items",
-			"sum.commands": "ran {n} commands",
-			"sum.edits": "edited {n} files",
-			"sum.searches": "ran {n} searches",
-			"sum.files": "read {n} files",
-			"sum.dirs": "listed {n} directories",
-			"sum.subagents": "forked {n} subagents",
-			"sum.todos": "updated todos",
-			"sum.goals": "updated goals",
-			"sum.workflows": "ran {n} workflows",
-			"sum.skills": "loaded {n} skills",
-			"sum.questions": "asked {n} questions",
-			"sum.plans": "planned {n} times",
-			"sum.jobs": "{n} background jobs",
-			"sum.others": "called {n} tools",
-			"onboarding.title": "Welcome to Focus Mode",
-			"onboarding.intro": "dsh-focus-overlay adds full-screen reading to the DeepSeek Harness web GUI.",
-			"onboarding.features.title": "Features",
-			"onboarding.feature.fullscreen": "Full-screen reading — hides the header, composer and sidebars",
-			"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",
-			"onboarding.done": "Done"
-		};
-		//#endregion
 		//#region src/client/index.ts
 		/**
 		* Focus Mode, browser half: a full-screen reading overlay in `shell.overlay`

package/package.json

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