sqs-dsh-better-input 0.1.0

package/LICENSE

@@ -0,0 +1,27 @@
+MIT License
+
+Copyright (c) 2026 sanqianshuang
+
+This project is a secondary development (fork) of `dsh-better-input`
+(https://github.com/DIAG5/dsh-better-input), which is also MIT licensed.
+The original copyright notice is retained below, as the MIT terms require.
+
+Copyright (c) 2026 dsh-better-input contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,218 @@
+<p align="center">
+  <img src="./assets/banner.png" width="100%" alt="sqs-dsh-better-input banner" />
+</p>
+
+<h1 align="center">🎤 sqs-dsh-better-input</h1>
+
+<p align="center"><b>给 DeepSeek Harness 更好的「输入」体验。</b></p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/sqs-dsh-better-input"><img src="https://img.shields.io/npm/v/sqs-dsh-better-input.svg" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/sqs-dsh-better-input"><img src="https://img.shields.io/npm/dm/sqs-dsh-better-input.svg" alt="npm downloads" /></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="license MIT" /></a>
+</p>
+
+<p align="center">
+  输入体验增强插件 · 基于 dsh-better-input 的二次开发
+</p>
+
+> 💡 **它解决什么？** 与智能体对话，输入不只靠键盘打字。本插件把**语音识别、AI 润色、提示词优化、提示词模板**四件事做顺：说出来的话自动变成干净、可直接发送的文字；写好的提示词一键优化；常用提示词随用随插。
+
+***
+
+## ⚠️ 关于这个版本（二次开发说明）
+
+本仓库是 [`dsh-better-input`](https://github.com/DIAG5/dsh-better-input)（MIT）的**二次开发版本**，由 **sanqianshuang** 维护，专门适配 **DSH `0.1.7-rc.2`**。与原版的主要差别：
+
+| 变更 | 说明 |
+| --- | --- |
+| 🗑️ **移除「文件输入 / 文件转 Markdown / OCR」整块** | DSH `0.1.7` 已原生支持文件拖拽上传、上传进度、文件卡片与重试（`conversation.input.attachments` / `DropOverlay` / `FileCard`），插件再挂一套 📎 文件面板与 `@` 引用芯片属于重复实现，故整体删除。 |
+| 🔧 **修复 Typert 兼容性（关键）** | `0.1.7` 收紧了 Typert 边界：`mode: 'strict'` 的 codec 必须带 **`create()` 工厂**；旧版把 schema 直接放在 `schema` 属性上，会被 `requireStrictCodec` 拒绝（报 `strict codec has no create() factory`），导致整个 entry 无法激活、插件根本不加载。现已全部改为工厂形式。 |
+| 🔧 **修复设置存储被移除的 API** | `0.1.7` 删除了 `settings.register(namespace, schema)`，改为按 profile entry 的 `SettingsForms`（带 revision CAS）。本插件的设置改为**自持 JSON 文件**，不再依赖该 API，因而不会被后续版本反复打破。 |
+| 🔧 **对齐依赖版本** | `@deepseek-ai/cordis` → `~4.0.4`、`@deepseek-ai/schemastery` → `~3.18.4`，与 `0.1.7-rc.2` 的 peer 要求一致。 |
+| 🏷️ **身份与命名** | 包名 `sqs-dsh-better-input`（npm 同名）、作者 `sanqianshuang`；设置与模板数据目录为 `~/.dsh/sqs-dsh-better-input/`（与原版互不干扰，可并存安装）。 |
+
+> 原版的 LICENSE 与版权声明已在 [LICENSE](./LICENSE) 中保留，符合 MIT 要求。
+
+## ✨ 功能
+
+<table>
+<tr><th align="center" width="120">模块</th><th align="left">说明</th></tr>
+<tr>
+<td align="center">🎙️<br/><b>语音输入</b></td>
+<td>点击麦克风，边说边转写，文字<strong>实时流式</strong>进入输入框。浏览器原生识别（Web Speech API），<strong>无需 API Key</strong>、不走服务器。识别因静音自行中断时会自动重启。</td>
+</tr>
+<tr>
+<td align="center">🤖<br/><b>AI 润色</b></td>
+<td>识别后自动清理：去口头禅、修同音错字（根木鹿→根目录、脱肯→Token）、补标点、把口语列举转成编号列表、并处理自我纠正（「不对，我说的是…」只保留最终语义）。<strong>复用 dsh 已配置的模型，无需额外 Key</strong>。</td>
+</tr>
+<tr>
+<td align="center">✨<br/><b>提示词优化</b></td>
+<td>输入框右侧一个 ✨ 图标，AI 帮你把写好的提示词优化得更精准；点击后弹出<strong>原文 / 优化结果对比</strong>，确认满意再采用。可引用最近 N 轮对话作为语境。</td>
+</tr>
+<tr>
+<td align="center">📝<br/><b>提示词模板</b></td>
+<td>常用提示词存成模板，输入框键入 <code>/</code> 搜索并一键插入正文；设置页内新建 / 编辑 / 删除，<strong>本地存储</strong>不经服务器。</td>
+</tr>
+<tr>
+<td align="center">🐘<br/><b>防覆盖保护</b></td>
+<td>润色 / 优化进行中你手动改了草稿，结果<strong>不会覆盖</strong>你的编辑；失败保留原文。</td>
+</tr>
+<tr>
+<td align="center">⏱️<br/><b>录音自动停止</b></td>
+<td>可自定义单次录音上限（1–600 秒，默认 120），到点自动停止，不占麦克风。</td>
+</tr>
+<tr>
+<td align="center">⚙️<br/><b>可视化设置页</b></td>
+<td>识别语言、录音时长、润色开关 / 模型 / 思考强度 / 自定义提示词，优化模型 / 思考强度 / 提示词 / 上下文轮数，全部可在设置里配置；内置提示词可一键展开查看。首次打开会自动选中一个已配置模型。</td>
+</tr>
+<tr>
+<td align="center">🔄<br/><b>更新检查</b></td>
+<td>设置页底部「关于与更新」一键检测 npm 最新版，发现新版会给出<strong>一键复制更新命令</strong>。</td>
+</tr>
+</table>
+
+## 🚀 安装
+
+前置：[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（`0.1.7-rc.2`）+ Node.js `^22.19.0 || >=24.0.0` + Chrome/Edge 浏览器（语音识别需要 Chromium 内核）。
+
+### 方式 A：从 npm 安装（推荐）
+
+```sh
+# 有全局 dsh CLI
+dsh plugin --profile web add sqs-dsh-better-input
+
+# 没有全局 dsh（用 npx 拉取）
+npx -y @deepseek-ai/dsh plugin --profile web add sqs-dsh-better-input
+```
+
+升级到最新版：
+
+```sh
+dsh plugin --profile web update sqs-dsh-better-input
+```
+
+卸载：
+
+```sh
+dsh plugin --profile web remove sqs-dsh-better-input
+```
+
+### 方式 B：从本地目录安装（开发 / 二次开发）
+
+```sh
+dsh plugin --profile web add /path/to/sqs-dsh-better-input
+npx -y @deepseek-ai/dsh plugin --profile web add /path/to/sqs-dsh-better-input
+```
+
+### 方式 C：从源码构建
+
+```sh
+git clone https://github.com/sanqianshuang/sqs-dsh-better-input.git
+cd sqs-dsh-better-input
+npm install --legacy-peer-deps   # 见下方说明
+npm run build
+dsh plugin --profile web add "$PWD"
+```
+
+> `--legacy-peer-deps`：`0.1.7` 的这批类型包（dev 依赖）之间存在 npm 难以自解的 peer 链（如 `dsh-api-remotes` → `dsh-scope`）。它们只用于编译期类型、不会被打进产物（客户端 bundle 已把 `@deepseek-ai/*` 全部外置），因此放宽 peer 校验是安全的。
+
+### 备选：不装依赖，写进 preset 的 `cordis.yml`
+
+```yaml
+- insert:
+    - id: sqs-dsh-better-input
+      name: sqs-dsh-better-input
+```
+
+安装后刷新 Web UI，输入框右侧会出现**麦克风图标** 🎤。
+
+## 📖 使用
+
+### 1. 语音输入
+
+1. 打开任意对话，点击输入框右侧的**麦克风按钮**
+2. 开始说话，识别文字**实时流入**输入框
+3. 再点按钮（或识别条上的**停止**）结束
+4. 检查、修改、发送
+
+> 识别完全在浏览器本地完成（Web Speech API）。Firefox / Safari 不支持时按钮自动禁用。
+
+### 2. AI 润色
+
+设置 → **BetterInput** → 打开 **AI 润色** → 选择一个 dsh 里已配置的模型。
+
+内置提示词会：去口头禅、修 ASR 同音错字、补标点、把口语列举转成编号列表（如「第一…第二…」→ `1.` `2.`）。留空用内置提示词，点「查看内置提示词」可展开原文；或粘贴自定义提示词（总会追加输出契约保护，保证只返回正文、不答非所问）。
+
+### 3. 提示词优化
+
+1. 在输入框里写好你的提示词
+2. 点击输入框右侧的 **✨ 优化** 图标
+3. 稍等，弹出**原文 / 优化结果对比**画面
+4. 点 **采用** 用优化结果替换草稿，或点 **取消** 保留原文
+
+> 默认关闭思考，追求快速、低成本的直出结果。从设置页可手动提高思考强度。
+
+### 4. 提示词模板
+
+1. 到 设置 → **BetterInput** → 「**提示词模板**」分节，点「**新建模板**」
+2. 填写名称、描述（可选）、正文与标签（可选，逗号分隔，用于搜索），保存
+3. 回到输入框键入 `/`，模板候选即弹出；继续输入按名称 / 描述 / 标签实时过滤
+4. 选中候选，模板正文直接插入输入框，可继续修改后发送
+
+> 模板保存在宿主本地 `~/.dsh/sqs-dsh-better-input/templates.json`，不经服务器、不上传；最多 200 个模板，正文上限 8000 字，列表按最近更新排序。写入走「临时文件 + 原子重命名」，文件意外损坏时自动隔离为 `*.corrupt-<时间戳>` 并重建。
+
+### 5. 设置
+
+| 设置项 | 说明 |
+| --- | --- |
+| 界面语言 | 插件界面文案支持中文 / 英文，跟随 DSH 界面语言切换，即时生效 |
+| 识别语言 | 留空自动跟随浏览器语言（如 `zh-CN`、`en-US`） |
+| 单次录音上限 | 1–600 秒，默认 120，到点自动停止 |
+| AI 润色 | 开 / 关；开启后每次语音识别结束自动润色进草稿 |
+| 润色模型 / 思考强度 / 自定义提示词 | 各自独立配置 |
+| 优化模型 / 思考强度 / 自定义提示词 | 各自独立配置 |
+| 上下文引用轮数 | 优化时引用最近 N 轮对话（0 为关闭，默认 3） |
+| 提示词模板 | 设置页内新建 / 编辑 / 删除，数据保存在宿主本地 JSON |
+| 关于与更新 | 显示当前版本 / 许可证 / 仓库，一键「检查更新」 |
+
+> 以上设置保存在 `~/.dsh/sqs-dsh-better-input/settings.json`。
+
+## 🧩 兼容性
+
+- DeepSeek Harness `0.1.7-rc.2`（peer 范围 `>=0.1.7-rc.2 <0.2.0-0`）
+- Node.js `^22.19.0 || >=24.0.0`
+- Chromium 内核浏览器（Chrome / Edge）
+
+## 🛠️ 开发
+
+```sh
+npm install --legacy-peer-deps
+npm run check    # 类型检查
+npm run build    # 构建 lib/（Host ESM + 浏览器 bundle）
+```
+
+改 Client 端：`npm run dev:watch` 后刷新 UI；改 Host 端：重启 `dsh web`。
+
+## 🏗️ 架构
+
+- `src/index.ts` — Host 插件入口，挂载润色服务
+- `src/identity.ts` — 包名 / 作者 / 仓库等身份信息的唯一来源
+- `src/polish/service.ts` — `BetterInputPolishService`（Typert remote）：设置读写、dsh 模型路由发现、LLM 润色与提示词优化、提示词模板存取
+- `src/polish/prompts.ts` — 内置润色 / 优化提示词与输出契约守卫
+- `src/settings/store.ts` — 插件自持设置的 JSON 存储（原子写入、损坏自愈）
+- `src/templates/` — 提示词模板的数据模型与宿主端 JSON 存储
+- `src/about.ts` — 插件身份读取与 npm 版本检查
+- `src/client/` — 浏览器端：麦克风 / 优化按钮（`conversation.input.right`）、识别条（`conversation.input.dock`）、设置页与模板管理（`settings.section`）、`/` 模板候选源
+- `src/typert.ts` / `src/remote.ts` — Client↔Host 类型化通信契约
+
+## 📄 License
+
+[MIT](./LICENSE) — 保留原 `dsh-better-input` 项目的版权声明。
+
+## ⭐ 支持
+
+- 提交 Issue / PR
+- 分享给同样用 DSH 的朋友
+
+感谢原版作者与社区 ❤️

package/cordis.patch.yml

@@ -0,0 +1,6 @@
+# The sqs-dsh-better-input bundle patch. The package entry is
+# intentionally small; browser behavior is discovered through the package's
+# dsh.client manifest.
+- insert:
+    - id: sqs-dsh-better-input
+      name: sqs-dsh-better-input

package/lib/about.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Plugin identity and update-check helpers. The Host reads the installed
+ * package.json and queries the npm registry for the latest released version.
+ * The browser never talks to the npm registry directly — the Host owns the
+ * check and merely reports back a status plus the command the user runs to
+ * update (DSH has no programmatic self-update API).
+ *
+ * Pattern follows the official `dsh-ears` plugin, used by plugins in the
+dsh ecosystem.
+ */
+export declare const PLUGIN_LICENSE = "MIT";
+export declare const PLUGIN_REPOSITORY_URL = "https://github.com/sanqianshuang/sqs-dsh-better-input";
+/**
+ * Fallback repository slug (owner/repo), used only when a repository URL cannot
+ * be parsed. It must be the *repository* slug, not an npm package name: the
+ * package is unscoped, so prefixing it with the npm scope would invent a
+ * package that does not exist.
+ */
+export declare const PLUGIN_REPOSITORY_SLUG = "sanqianshuang/sqs-dsh-better-input";
+export declare const PLUGIN_PACKAGE_NAME = "sqs-dsh-better-input";
+/** Global-CLI form (works when `dsh` is installed globally). */
+export declare const UPDATE_COMMAND = "dsh plugin --profile web update sqs-dsh-better-input";
+/** npx form (works without a global `dsh` CLI; DSH is pulled on demand). */
+export declare const UPDATE_COMMAND_NPX = "npx -y @deepseek-ai/dsh plugin --profile web update sqs-dsh-better-input";
+export declare const NPM_LATEST_URL = "https://registry.npmjs.org/sqs-dsh-better-input/latest";
+export type AboutInfo = {
+    readonly repository: string;
+    readonly repositorySlug: string;
+    readonly version: string;
+    readonly license: string;
+    readonly updateCommand: string;
+    readonly updateCommandNpx: string;
+};
+export type UpdateCheckStatus = 'up-to-date' | 'update-available' | 'unpublished' | 'error';
+export type UpdateCheckResult = {
+    readonly status: UpdateCheckStatus;
+    readonly installed: string;
+    readonly latest: string | null;
+    readonly updateCommand: string;
+    readonly updateCommandNpx: string;
+};
+export declare function readInstalledAboutInfo(packageJsonPath?: string): AboutInfo;
+export declare function repositoryUrlFromPackage(value: unknown): string;
+export declare function repositorySlugFromUrl(url: string): string;
+export declare function resolvePackageJsonPath(): string;
+/** Compare dotted numeric cores only. `1.2` equals `1.2.0`. Null if either is not a version. */
+export declare function compareReleaseVersions(left: string, right: string): number | null;
+export declare function interpretUpdateCheck(installed: string, latest: string): Exclude<UpdateCheckStatus, 'unpublished' | 'error'> | null;
+export declare function fetchLatestPublishedVersion(options?: {
+    readonly fetchImpl?: typeof fetch;
+    readonly signal?: AbortSignal;
+}): Promise<{
+    status: 'ok';
+    version: string;
+} | {
+    status: 'unpublished';
+} | {
+    status: 'error';
+    message: string;
+}>;
+export declare function checkForPluginUpdate(options?: {
+    readonly installed: string;
+    readonly fetchImpl?: typeof fetch;
+    readonly signal?: AbortSignal;
+}): Promise<UpdateCheckResult>;

package/lib/client/MicrophoneButton.d.ts

@@ -0,0 +1,64 @@
+import type { SnapshotSelectorHook, TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+import type { InputState } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import { type BetterInputSettings, type BetterInputSettingsPatch } from '../config.js';
+import type { BetterInputRemote } from '../remote.js';
+import { type VoiceInputSession } from './voice-session.js';
+/** The framework-injected `t` seat for the BetterInput namespace. */
+type Translate = TranslateNS<'better-input'>;
+/**
+ * Standard props the conversation input zone hands to every
+ * `conversation.input.right` entry, plus the injected voice session and
+ * settings controller face.
+ */
+export type InputZoneLikeProps = {
+    readonly useInput: SnapshotSelectorHook<InputState>;
+    readonly inputActions: {
+        setDraft(text: string): void;
+    };
+    readonly voiceSession: VoiceInputSession;
+    readonly remote: BetterInputRemote;
+    readonly useSettings: () => SettingsFace;
+    readonly t: Translate;
+};
+export type SettingsFace = {
+    readonly status: 'loading' | 'ready' | 'error';
+    readonly settings: BetterInputSettings;
+};
+/**
+ * The microphone button in the composer tool row. Click to start listening,
+ * click again to stop. Transcripts stream into the draft in real time; when
+ * polishing is enabled, the committed transcript is polished through the Host
+ * LLM route and replaces the draft (unless the user edited it meanwhile).
+ */
+export declare function MicrophoneButton({ useInput, inputActions, voiceSession, remote, useSettings, t }: InputZoneLikeProps): import("react").JSX.Element;
+export interface PolishDraftOptions {
+    transcript: string;
+    baseDraft: string;
+    draftAtStop: string;
+    provider: string;
+    model: string;
+    remote: BetterInputRemote;
+    setState: (state: 'idle' | 'error' | 'polish-error' | 'polishing', detail?: string) => void;
+    latestDraftRef: {
+        current: string;
+    };
+    actionsRef: {
+        current: {
+            setDraft(text: string): void;
+        };
+    };
+    polishAbortRef: {
+        current: AbortController | null;
+    };
+}
+export declare function polishDraft(options: PolishDraftOptions): Promise<void>;
+/**
+ * Only replace the draft when the user has not edited it since the transcript
+ * landed. Both the transcript-at-stop and the base draft count as unchanged
+ * (the user may have reverted the interim edits).
+ */
+export declare function shouldApplyPolishResult(currentDraft: string, draftAtStop: string, baseDraft: string): boolean;
+/** Append transcript to a base draft with one space separator. */
+export declare function updateDraft(baseDraft: string, transcript: string): string;
+export declare function isSupported(): boolean;
+export type { BetterInputSettingsPatch };

package/lib/client/OptimizeButton.d.ts

@@ -0,0 +1,33 @@
+import type { SnapshotSelectorHook, TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+import type { InputState } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import type { ChatSnapshot } from '@deepseek-ai/dsh-client-ui-chat/client';
+import type { BetterInputRemote } from '../remote.js';
+import type { SettingsFace } from './MicrophoneButton.js';
+/** The framework-injected `t` seat for the BetterInput namespace. */
+type Translate = TranslateNS<'better-input'>;
+/**
+ * Props handed to a `conversation.input.right` entry, plus the injected
+ * remote and settings face. In dsh 0.1.2 the slot standard kit supplies
+ * `useChat` (Chat target snapshot, whose `legacy.nodes` carries the message
+ * array) and `useInput` (draft); message history is no longer exposed through
+ * a top-level `session` owner.
+ */
+export type OptimizeButtonProps = {
+    readonly useChat: SnapshotSelectorHook<ChatSnapshot>;
+    readonly useInput: SnapshotSelectorHook<InputState>;
+    readonly inputActions: {
+        setDraft(text: string): void;
+    };
+    readonly remote: BetterInputRemote;
+    readonly useSettings: () => SettingsFace;
+    readonly t: Translate;
+};
+/**
+ * The ✨ optimize button rendered above the composer card (in
+ * `conversation.input.dock`), right-aligned. Click reads the current draft,
+ * calls the Host LLM to optimize it, then shows a confirmation panel with
+ * the original and optimized text. The draft is replaced only when the user
+ * clicks "Adopt".
+ */
+export declare function OptimizeButton({ useChat, useInput, inputActions, remote, useSettings, t }: OptimizeButtonProps): import("react").JSX.Element;
+export {};

package/lib/client/VoiceRecognitionBar.d.ts

@@ -0,0 +1,14 @@
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+import { type VoiceInputSession } from './voice-session.js';
+/** The framework-injected `t` seat for the BetterInput namespace. */
+type Translate = TranslateNS<'better-input'>;
+export type RecognitionBarProps = {
+    readonly voiceSession: VoiceInputSession;
+    readonly t: Translate;
+};
+/**
+ * The recognition status bar above the composer. Shows live state and a stop
+ * button while recording; the bar renders nothing when idle.
+ */
+export declare function VoiceRecognitionBar({ voiceSession, t }: RecognitionBarProps): import("react").JSX.Element | null;
+export {};

package/lib/client/index.d.ts

@@ -0,0 +1,14 @@
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+/**
+ * Required Client services: the slot registry, the Typert remote hub, and
+ * the DSH locale runtime. `remote.betterInput` is mounted by this plugin's
+ * own apply() via `ctx.remote.$mount`, so it MUST NOT appear here — the
+ * outer inject gates plugin activation and would deadlock waiting for
+ * itself. It is declared only on the inner ctx.inject() below, which runs
+ * after the mount. Settings reach the browser through `SettingsScopeBinder`
+ * (provided by `@deepseek-ai/dsh-client-ui-settings`) and are read inside
+ * the settings section slot itself, not via a top-level `settings` service
+ * here.
+ */
+export declare const inject: string[];
+export declare function apply(ctx: ClientContext): Promise<() => Promise<void>>;

package/lib/client/settings-controller.d.ts

@@ -0,0 +1,80 @@
+import { type BetterInputSettingsPatch, type BetterInputSettingsView, type PolishRoute, type ReasoningEffortInfo } from '../config.js';
+import type { AboutInfoWire, UpdateCheckResultWire } from '../remote-contract.js';
+import type { BetterInputRemote } from '../remote.js';
+export type SettingsStatus = 'loading' | 'ready' | 'error';
+export type SettingsSnapshot = {
+    readonly status: SettingsStatus;
+    readonly view: BetterInputSettingsView;
+    readonly detail: string;
+};
+export type RoutesSnapshot = {
+    readonly status: 'loading' | 'ready' | 'error';
+    readonly routes: readonly PolishRoute[];
+    readonly detail: string;
+};
+/** Keyed by `${provider}\u0000${model}` — undefined effort = loading requested,
+ *  null effort = load failed, object = resolved efforts. */
+export type EffortsSnapshot = Readonly<Record<string, EffortsEntry>>;
+export type EffortsEntry = {
+    readonly status: 'loading' | 'ready' | 'error';
+    readonly efforts: readonly ReasoningEffortInfo[];
+    readonly defaultEffort?: string;
+    readonly detail: string;
+};
+export type AboutSnapshot = {
+    readonly status: 'loading' | 'ready' | 'error';
+    readonly about: AboutInfoWire;
+    readonly detail: string;
+};
+export type UpdateSnapshot = {
+    readonly status: 'idle' | 'loading' | 'ready' | 'error';
+    readonly update: UpdateCheckResultWire | null;
+    readonly detail: string;
+};
+type Listener = () => void;
+/**
+ * Settings read/write controller for the settings page and the microphone
+ * flow. Owns the remote calls and a simple external store so both the page
+ * and the voice button observe the same values. Also caches per-model
+ * reasoning-effort metadata loaded lazily through resolveModelEfforts so
+ * opening the effort dropdown never double-fetches across renders.
+ */
+export declare class SettingsController {
+    private readonly remote;
+    private settingsSnapshot;
+    private routesSnapshot;
+    private effortsSnapshot;
+    private aboutSnapshot;
+    private updateSnapshot;
+    private readonly listeners;
+    private disposed;
+    constructor(remote: BetterInputRemote);
+    readonly getSettingsSnapshot: () => SettingsSnapshot;
+    readonly getRoutesSnapshot: () => RoutesSnapshot;
+    readonly getEffortsSnapshot: () => EffortsSnapshot;
+    readonly getAboutSnapshot: () => AboutSnapshot;
+    readonly getUpdateSnapshot: () => UpdateSnapshot;
+    readonly subscribe: (listener: Listener) => (() => void);
+    refreshSettings(): Promise<void>;
+    refreshRoutes(): Promise<void>;
+    private readonly autoPopulateDefaultRoutesIfNeeded;
+    update(patch: BetterInputSettingsPatch): Promise<boolean>;
+    /**
+     * Lazily fetch reasoning efforts for a route. Results are cached in the
+     * controller so changing the effort dropdown back and forth doesn't
+     * re-trigger remote calls. Returns a snapshot entry immediately — the
+     * caller subscribes via `useEffortsSnapshot` to re-render when the data
+     * lands.
+     */
+    ensureEffortsFor(provider: string, model: string): Promise<void>;
+    refreshAbout(): Promise<void>;
+    checkForUpdate(): Promise<void>;
+    dispose(): void;
+    private emit;
+}
+export declare function useSettingsSnapshot(controller: SettingsController): SettingsSnapshot;
+export declare function useRoutesSnapshot(controller: SettingsController): RoutesSnapshot;
+export declare function useEffortsSnapshot(controller: SettingsController): EffortsSnapshot;
+export declare function useAboutSnapshot(controller: SettingsController): AboutSnapshot;
+export declare function useUpdateSnapshot(controller: SettingsController): UpdateSnapshot;
+export {};

package/lib/client/settings.d.ts

@@ -0,0 +1,15 @@
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+import type { SettingsController } from './settings-controller.js';
+/** The framework-injected `t` seat for the BetterInput namespace. */
+type Translate = TranslateNS<'better-input'>;
+export type SettingsSectionProps = {
+    readonly close: () => void;
+    readonly t: Translate;
+    readonly settingsController: SettingsController;
+};
+/**
+ * The BetterInput settings page. Renders the recognition and polishing
+ * configuration; every field edits a local draft and saves on blur/change.
+ */
+export declare function BetterInputSettingsSection({ close, settingsController, t }: SettingsSectionProps): import("react").JSX.Element;
+export {};

package/lib/client/strings.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Bilingual UI strings for sqs-dsh-better-input (zh/en). Registered as one
+ * namespace into the DSH locale runtime; every slot component declares that
+ * namespace and reads copy through the framework-injected `t` seat, so the
+ * UI follows the DSH settings language switch automatically.
+ */
+export type BetterInputStrings = {
+    voiceStart: string;
+    voiceStop: string;
+    voiceBusy: string;
+    voiceUnavailable: string;
+    listening: string;
+    transcribing: string;
+    polishing: string;
+    voiceFailed: string;
+    polishNotConfigured: string;
+    polishFailedKeepOriginal: string;
+    settingsTitle: string;
+    settingsDescription: string;
+    loading: string;
+    saveFailed: string;
+    languageLabel: string;
+    languageHint: string;
+    languagePlaceholder: string;
+    recordingLimitLabel: string;
+    recordingLimitHint: string;
+    polishLabel: string;
+    polishHint: string;
+    on: string;
+    off: string;
+    polishModelLabel: string;
+    polishModelHint: string;
+    polishModelNone: string;
+    polishEffortLabel: string;
+    polishEffortHint: string;
+    polishPromptLabel: string;
+    polishPromptHint: string;
+    polishPromptPlaceholder: string;
+    showDefaultPrompt: string;
+    hideDefaultPrompt: string;
+    defaultPromptLabel: string;
+    effortDefaultLabel: string;
+    effortLoadingLabel: string;
+    routesStatus: string;
+    routesUnavailable: string;
+    optimizeButton: string;
+    optimizeBusy: string;
+    optimizeFailed: string;
+    optimizeEmpty: string;
+    optimizePanelTitle: string;
+    optimizeOriginalLabel: string;
+    optimizeOptimizedLabel: string;
+    optimizeAdopt: string;
+    optimizeCancel: string;
+    optimizeNotConfigured: string;
+    optimizeSectionLabel: string;
+    optimizeModelLabel: string;
+    optimizeModelHint: string;
+    optimizeEffortLabel: string;
+    optimizeEffortHint: string;
+    optimizePromptLabel: string;
+    optimizePromptHint: string;
+    optimizePromptPlaceholder: string;
+    contextTurnsLabel: string;
+    contextTurnsHint: string;
+    aboutTitle: string;
+    aboutVersionLabel: string;
+    aboutRepositoryLabel: string;
+    aboutChangelogLabel: string;
+    aboutLicenseLabel: string;
+    checkUpdateButton: string;
+    checkingUpdate: string;
+    updateUpToDate: string;
+    updateAvailable: string;
+    updateUnpublished: string;
+    updateCheckFailed: string;
+    updateCommandLabel: string;
+    updateCommandNpxLabel: string;
+    updateCommandPick: string;
+    voiceSectionLabel: string;
+    polishSectionLabel: string;
+    templatesTitle: string;
+    templatesDescription: string;
+    templatesNew: string;
+    templatesEdit: string;
+    templatesSave: string;
+    templatesCancel: string;
+    templatesDelete: string;
+    templatesDeleteConfirm: string;
+    templatesEmpty: string;
+    templatesLoadFailed: string;
+    templatesRetry: string;
+    templatesActionFailed: string;
+    templatesNameLabel: string;
+    templatesNamePlaceholder: string;
+    templatesDescriptionLabel: string;
+    templatesDescriptionPlaceholder: string;
+    templatesContentLabel: string;
+    templatesContentPlaceholder: string;
+    templatesTagsLabel: string;
+    templatesTagsHint: string;
+};
+export declare const zh: BetterInputStrings;
+export declare const en: BetterInputStrings;
+/** Namespace owning every BetterInput surface string. Registered into the DSH
+ * locale runtime; slots declaring this namespace receive the typed `t`. */
+export declare const BETTER_INPUT_NS = "better-input";
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    /** BetterInput dictionary keys (one shared key set, zh/en bilingual). */
+    interface LocaleNamespaceMap {
+        'better-input': keyof BetterInputStrings;
+    }
+}