dsh-input-assistant 0.1.3 → 0.1.4

package/README.md

@@ -1,184 +1,215 @@
-# DSH 输入助手
-
-[![CI](https://github.com/Somnus678/dsh-input-assistant/actions/workflows/ci.yml/badge.svg)](https://github.com/Somnus678/dsh-input-assistant/actions/workflows/ci.yml)
-[![release](https://img.shields.io/badge/release-v0.1.3-blue)](https://github.com/Somnus678/dsh-input-assistant/releases/tag/v0.1.3)
-[![license](https://img.shields.io/badge/license-MIT-green)](LICENSE)
-[![dsh](https://img.shields.io/badge/DSH-0.2.1--rc.2-purple)](https://github.com/deepseek-ai/deepseek-harness)
-[![tests](https://img.shields.io/badge/tests-121%20passed-brightgreen)](docs/validation.md)
-
-[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的输入框增强插件：**提示词优化**、**下一句预测**、**输入续写**、**草稿暂存**。
-
-![优化界面](docs/images/optimize.png)
-
-## 功能
-
-| 功能 | 说明 |
-|---|---|
-| **提示词优化** | 把草稿或选中文字改写成更准确、可发送的表达。三档强度（轻/标准/深度），显示逐词差异，一键撤销。 |
-| **下一句预测** | 回复完成后预测你接下来可能说的话，以灰字提示，Tab 采纳，不发送。 |
-| **输入续写** | 根据当前草稿预测后续内容，停顿时间与最小间隔可调。 |
-| **草稿暂存** | 当前会话最多保留 3 份草稿，清空输入前自动保存，显式恢复。 |
-
-深色与浅色主题均已适配：
-
-| 浅色 | 深色 |
-|---|---|
-| ![浅色](docs/images/light.png) | ![深色](docs/images/dark.png) |
-
-### 保护机制
-
-改写时以下内容保持原样，模型无法篡改：
-
-- 代码块（``` 和 ~~~）与行内代码
-- URL 与盘符绝对路径（`C:\...`）
-- 相对路径与文件名（`src/core/generation.ts`、`package.json`、`README.md`）
-- 你显式锁定的片段
-
-占位符被模型篡改、丢失或重复时，插件拒绝该结果并保留你的原稿。
-
-### 失败不丢稿
-
-优化、续写、预测在超时、取消、网络失败、模型空输出时都保留原稿，只给出提示。一次瞬时状态轮询失败不会中断正在进行的手动优化。
-
-## 安装
-
-需要 **Node.js >= 22.19** 和 **DSH `0.2.1-rc.2` 或 `0.2.1-rc.3`**。安装预构建 `.tgz` 不需要在本地编译 TypeScript。
-
-一行命令直接从 GitHub Release 安装：
-
-```powershell
-dsh --version                                  # 确认 0.2.1-rc.2 或 rc.3
-dsh plugin --profile web add https://github.com/Somnus678/dsh-input-assistant/releases/download/v0.1.3/dsh-input-assistant-0.1.3.tgz
-dsh --profile web --dump-config                # 应看到 dsh-input-assistant 层
-dsh --profile web
-```
-
-也可以先从 [Releases](https://github.com/Somnus678/dsh-input-assistant/releases) 手动下载 `dsh-input-assistant-0.1.3.tgz` 再本地安装：
-
-```powershell
-dsh plugin --profile web add ./dsh-input-assistant-0.1.3.tgz
-```
-
-官方桌面端使用自己的 `desktop` profile（默认 Windows 安装位置）：
-
-```powershell
-$dsh = Join-Path $env:LOCALAPPDATA 'Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd'
-& $dsh --version
-& $dsh plugin --profile desktop add (Resolve-Path './dsh-input-assistant-0.1.3.tgz').Path
-```
-
-安装或升级后**完全退出并重新打开 DSH**，插件才会加载。
-
-### 卸载
-
-```powershell
-dsh plugin --profile web remove dsh-input-assistant
-```
-
-同样需要重启对应实例。卸载**不会**清除插件保存的草稿与设置（存在宿主私有 storage 中）。
-
-### 从源码构建
-
-```powershell
-git clone https://github.com/Somnus678/dsh-input-assistant.git
-cd dsh-input-assistant
-pnpm install
-pnpm build
-pnpm pack --pack-destination dist
-```
-
-## 快速上手
-
-1. 安装后重启 DSH，输入框右侧出现**「优化」按钮**。
-2. 在输入框写入草稿，点「优化」或按快捷键，查看差异后决定**采纳**或**撤销**。
-3. 左下角账号菜单 → **设置 → 输入助手**，可分别开关四个模块、调整强度与高级参数。
-
-> **默认会调用模型。** `下一句预测` 和 `输入续写` 默认开启，会在你输入时自动发起请求。若只想手动使用优化功能或控制成本，请先在设置中关闭这两项。
-
-## 设置项
-
-| 设置 | 默认 | 范围 | 说明 |
-|---|---|---|---|
-| 提示词优化 | 开 | — | 是否显示优化入口 |
-| 草稿暂存 | 开 | — | 清空输入前是否自动保存 |
-| 下一句预测 | 开 | — | 回复后是否预测下一句 |
-| 输入续写 | 开 | — | 输入时是否预测后续内容 |
-| 优化强度 | 标准 | 轻/标准/深度 | 改写幅度 |
-| 显示方式 | ghost | ghost/panel | 灰字或面板 |
-| 续写停顿 `debounceMs` | 600 | 200–5000 | 停止输入多久后触发 |
-| 最小间隔 `minIntervalMs` | 2000 | 500–30000 | 两次续写请求的最小间隔 |
-| 固定辅助模型 | 跟随输入框 | — | 可指定 provider/model；留空则跟随输入框所选模型 |
-
-### 各功能怎么用
-
-**优化整稿或选区**：输入草稿后点「优化」，或用菜单/快捷键。结果以差异视图展示，逐处标出增删；点「采纳」写入输入框，点「撤销」或按一次 `Ctrl+Z` 恢复原文。
-
-**下一句预测与输入续写**：预测结果以**灰字**显示在光标后。按 `Tab` 采纳，按 `Esc` 或继续输入忽略。采纳**不会**发送消息。
-
-**暂存长草稿**：清空输入前，非空草稿会自动暂存到当前会话（最多 3 份）。从插件菜单可查看并显式恢复；切换会话、切换模型、断线重连后暂存仍在该会话下。
-
-## 兼容性
-
-| 项目 | 支持范围 |
-|---|---|
-| DSH | `0.2.1-rc.2` ~ `0.2.1-rc.3`（声明范围 `>=0.2.1-rc.2 <0.3.0-0`，两端均经全量测试验证） |
-| Node.js | `>= 22.19` |
-| 操作系统 | Windows x64（已验证）；macOS/Linux 未验证 |
-| 浏览器测试 | Microsoft Edge |
-
-## 已知边界
-
-**这个插件没有完成完整的效果评测。** 请据此判断是否适合你的场景：
-
-- 60 条固定合成质量集尚未跑完真实模型评测，也没有独立人工语义标注，状态为 `not_evaluated`。
-- 6 次真实模型小样本对照只能说明链路可用（2,807 tokens），**不能证明效果优于同类工具**。
-- 中文 IME 候选组合、附件/引用组合、完整官方 Web 组合、其他插件组合、非 Windows x64 平台均未验证。
-- 兼容声明范围 `0.2.1-rc.2` ~ `0.2.1-rc.3`；此范围外的版本未经测试，可能不兼容。
-
-详见 [验收记录](docs/validation.md) 与 [低用量真实模型试验](docs/smoke-comparison.md)。
-
-## 数据与隐私
-
-- 不收集遥测，不上传使用数据。
-- 草稿与设置存在宿主 DSH 的私有 storage。
-- 模型调用走宿主已配置的提供商；插件不持有或记录 API key。
-- 优化/预测/续写会把当前草稿与相关上下文发给模型提供商 —— 这是功能必需，请按你所用提供商的数据政策评估。
-
-详见 [安全策略](SECURITY.md)。
-
-## 开发
-
-```powershell
-pnpm install
-pnpm typecheck     # 类型检查
-pnpm test          # 121 条测试
-pnpm build         # 构建 lib/
-pnpm test:package  # 校验打包产物（需先 pack）
-pnpm test:web      # 真实 Edge 回归
-```
-
-贡献前请阅读 [贡献指南](CONTRIBUTING.md)。技术细节见 [0.1.2 修正记录](docs/CHANGELOG-0.1.2.md)。
-
-### 持续集成
-
-每次 push 和 PR 都会在 GitHub Actions 上自动运行 [`.github/workflows/ci.yml`](.github/workflows/ci.yml)：
-
-| Job | 环境 | 内容 |
-|---|---|---|
-| `test-windows` | `windows-latest` | **全量 121 条测试** + 真实 Edge 冒烟 + 构建可复现性校验 |
-| `test-linux` | `ubuntu-latest` | 排除 Edge 专属渲染测试（116 条），验证核心/宿主/控制器无 Windows 假设 |
-| `package` | `ubuntu-latest` | 打包内容审计：必需文件齐全，且不含研究资料、缓存或测试夹具 |
-
-`test-windows` 是权威结果：`tests/browser-theme.test.ts` 和 `scripts/smoke-web.mjs` 使用
-`chromium.launch({ channel: 'msedge' })` 驱动真实 Microsoft Edge 渲染已发布的 DSH 主题，
-这两项在无 Edge 的 Linux 上无法运行，因此 Linux job 显式排除它们，覆盖由 Windows job 提供。
-
-本地想复现 Linux job：
-
-```powershell
-pnpm vitest run --exclude 'tests/browser-theme.test.ts'
-```
-
-## 许可证
-
-[MIT](LICENSE)。第三方依赖与参考实现各自适用其原许可证，见 [公开参考与实现边界](docs/references.md)。
+# DSH 输入助手
+
+简体中文 | [English](README.en.md)
+
+[![CI](https://github.com/Somnus678/dsh-input-assistant/actions/workflows/ci.yml/badge.svg)](https://github.com/Somnus678/dsh-input-assistant/actions/workflows/ci.yml)
+[![release](https://img.shields.io/github/v/release/Somnus678/dsh-input-assistant)](https://github.com/Somnus678/dsh-input-assistant/releases)
+[![license](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![dsh](https://img.shields.io/badge/DSH-0.2.1--rc.2-purple)](https://github.com/deepseek-ai/deepseek-harness)
+[![tests](https://img.shields.io/badge/tests-203%20passed-brightgreen)](docs/validation.md)
+
+[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的输入框增强插件：**提示词优化**、**下一句预测**、**输入续写**、**草稿暂存**。
+
+当前源码版本为 **0.1.4**，包含预测详略度、预设、独立预测按钮、预览采纳、手动重试、草稿复制及辅助模型选择。可从当前源码构建并安装本地 `dist/dsh-input-assistant-0.1.4.tgz`；公开发布情况请参见 [Releases](https://github.com/Somnus678/dsh-input-assistant/releases)。
+
+![优化界面](docs/images/optimize.png)
+
+截图来自本地浏览器夹具，使用正式组件、宿主主题及模拟模型输出。
+
+## 功能
+
+| 功能 | 说明 |
+|---|---|
+| **提示词优化** | 把草稿或选中文字改写成更准确、可发送的表达。三档强度（轻/标准/深度），先预览差异，采纳后写入，可还原。 |
+| **下一句预测** | 回复完成后预测你接下来可能说的话，以灰字提示，Tab 采纳，不发送。 |
+| **输入续写** | 根据当前草稿预测后续内容，停顿时间与最小间隔可调。 |
+| **手动建议与重试** | 点击独立「预测」按钮生成一次；自动建议关闭时仍可使用，失败后可明确重试。 |
+| **详略度与预设** | 简明、标准、详尽三档；详尽允许多行，始终遵守长度上限。三种预设经保存后生效。 |
+| **草稿暂存** | 当前会话最多保留 3 份草稿，点击“暂存并清空”先保存再清空，显式恢复；删除后 10 秒内可撤销。 |
+
+深色与浅色主题均已适配：
+
+| 浅色 | 深色 |
+|---|---|
+| ![浅色](docs/images/light.png) | ![深色](docs/images/dark.png) |
+
+### 保护机制
+
+改写时会识别并锁定以下内容：
+
+- 代码块（``` 和 ~~~）与行内代码
+- URL（含平衡括号）与盘符绝对路径（`C:\...`）
+- 正斜线或反斜线相对路径与常见文件名（`src/core/generation.ts`、`src\index.ts`、`package.json`、`.env`、`.gitignore`）
+- 你显式锁定的片段
+
+占位符被模型篡改、丢失或重复时，插件拒绝该结果并保留你的原稿。
+
+带空格的 Windows 路径支持引号边界，未加引号时会按文件名、标点或行尾识别。目录名和后续自然语言存在歧义时，请用引号、反引号或手动锁定，避免依赖自动识别。片段完整不等于语义不变，采纳前仍需审阅。
+
+中文紧贴普通文件名时会切出文件本身，例如“请修改package.json中的scripts”。未引用的纯中文文件名与紧贴的中文说明仍可能存在歧义；混合中英文名称请使用引号、反引号或手动锁定。
+
+### 失败不丢稿
+
+优化、续写、预测在超时、取消、网络失败、模型空输出时都保留原稿，只给出提示。一次瞬时状态轮询失败不会中断正在进行的手动优化。
+
+## 安装
+
+需要 **Node.js >= 22.19** 和 **DSH `0.2.1-rc.2` 或 `0.2.1-rc.3`**。安装预构建 `.tgz` 不需要在本地编译 TypeScript。
+
+构建本版后，将以下路径指向本地包并安装到 Web profile：
+
+```powershell
+dsh --version                                  # 确认 0.2.1-rc.2 或 rc.3
+dsh plugin --profile web add (Resolve-Path './dist/dsh-input-assistant-0.1.4.tgz').Path
+dsh --profile web --dump-config                # 应看到 dsh-input-assistant 层
+dsh --profile web
+```
+
+已发布的 GitHub 安装包可从 [Releases](https://github.com/Somnus678/dsh-input-assistant/releases) 下载，请核对版本号和文件来源。
+
+官方桌面端使用自己的 `desktop` profile（默认 Windows 安装位置）：
+
+```powershell
+$dsh = Join-Path $env:LOCALAPPDATA 'Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd'
+& $dsh --version
+& $dsh plugin --profile desktop add (Resolve-Path './dist/dsh-input-assistant-0.1.4.tgz').Path
+```
+
+安装或升级后**完全退出并重新打开 DSH**，插件才会加载。
+
+如果曾安装其他内容的同名 0.1.4 包，请先核对安装包的来源与 SHA256，并在重启后核对实际加载的插件文件。同版本缓存可能复用旧文件；仅看到版本号相同不能证明已更新。
+
+### 卸载
+
+```powershell
+dsh plugin --profile web remove dsh-input-assistant
+```
+
+同样需要重启对应实例。卸载**不会**清除插件保存的草稿与设置（存在宿主私有 storage 中）。
+
+### 从源码构建
+
+```powershell
+git clone https://github.com/Somnus678/dsh-input-assistant.git
+cd dsh-input-assistant
+pnpm install
+pnpm build
+pnpm pack --pack-destination dist
+```
+
+## 快速上手
+
+1. 安装后重启 DSH，输入框右侧出现**「优化」「预测」按钮**和快捷菜单。
+2. 在输入框写入草稿，点「优化」，查看差异后决定**采纳优化**或**保留原文**；等待期间可取消。
+3. 左下角账号菜单 → **设置 → 输入助手**，可分别开关四个模块、调整强度与高级参数。
+
+> **默认会调用模型。** `下一句预测` 和 `输入续写` 默认开启，会在你输入时自动发起请求。若只想手动使用优化功能或控制成本，请先在设置中关闭这两项。
+
+## 设置项
+
+| 设置 | 默认 | 范围 | 说明 |
+|---|---|---|---|
+| 提示词优化 | 开 | — | 是否启用优化 |
+| 草稿暂存 | 开 | — | 是否启用“暂存并清空”与恢复 |
+| 下一句预测 | 开 | — | 回复后是否预测下一句 |
+| 输入续写 | 开 | — | 输入时是否预测后续内容 |
+| 优化强度 | 标准 | 轻/标准/深度 | 改写幅度 |
+| 预测详略度 | 标准 | 简明/标准/详尽 | 不会自动提高长度上限；详尽使用可滚动的候选面板 |
+| 显示方式 | ghost | ghost/panel | 灰字或面板 |
+| 下一句长度上限 | 120 | 20–1000 | Unicode 字符上限 |
+| 续写长度上限 | 80 | 10–500 | Unicode 字符上限 |
+| 续写停顿 `debounceMs` | 600 | 200–5000 | 停止输入多久后触发 |
+| 最小间隔 `minIntervalMs` | 2000 | 500–30000 | 两次续写请求的最小间隔 |
+| 固定辅助模型 | 跟随输入框 | — | 可从宿主目录选择；高级选项支持手填 provider/model；留空跟随输入框模型 |
+
+### 各功能怎么用
+
+**优化整稿或选区**：输入草稿后点「优化」。原稿保持不变，结果以差异视图展示；点「采纳优化」才写入输入框，点「保留原文」或按 `Esc` 放弃预览。采纳后可在菜单点「还原」，或按一次 `Ctrl+Z` 恢复原文。
+
+**下一句预测与输入续写**：预测结果以**灰字**或候选面板显示。详尽模式统一使用可滚动的面板，完整展示多行候选。按 `Tab` 采纳，按 `Esc` 或继续输入忽略。采纳**不会**发送消息。
+
+**手动生成与重试**：点击「预测」或菜单中的「生成建议」，空稿时预测下一句，有草稿时续写。自动功能关闭时仍可使用，失败或正常弃权后可明确重试。输入框需为无附件、无引用的空闲纯文本，光标位于末尾。手动请求仍遵守宿主最小间隔；限流时最多延后重试一次，不会循环调用。页面隐藏会停止自动建议，重新可见后再判断是否触发。
+
+**暂存长草稿**：在菜单点击「暂存并清空」，保存成功后才清空输入（最多 3 份）。可显式追加或替换恢复；切换会话、切换模型、断线重连后暂存仍在该会话下。删除或清空暂存后，可在 10 秒内撤销；撤销不会覆盖其他窗口新保存的草稿，容量不足时会提示先释放空间再重试。
+
+保存期间可点「取消清空」保留输入，已开始的保存仍会完成。保存中编辑草稿、切换模型或修改设置，也只保存原快照并保留当前输入。该按钮不用于取消删除或撤销等存储操作。
+
+**预设档位**：「敏捷模式」「标准平衡」「节流省流」只修改设置表单，点击「保存设置」后才全局生效，不会立即生成。滑块用于快速调整，数值框支持范围内的精确整数，如 601 毫秒。
+
+最近一次删除的 10 秒撤销期限不会因切走会话再返回而改变。撤销失败的目标单独保留在当前插件运行内，后续删除不会覆盖该目标；可重试、复制或主动放弃。两批备份均恢复失败时，会先要求处理一批，避免继续删除覆盖备份。插件卸载或连接切换会释放这些内存备份。草稿卡和待恢复备份都支持复制，复制不受当前输入附件或引用限制。
+
+功能开关、显示方式、辅助模型和高级参数集中在 **设置 → 输入助手**，均为全局设置。快捷菜单只保留常用操作，并明确标注优化强度的全局作用范围。
+
+辅助模型选择只保存插件自己的路由，不切换主会话模型；目录部分失败或不支持目录接口时，可刷新或使用高级手动填写，已有选择会保留。输入、优化和暂存的字数预算均按 Unicode 码点统计。
+
+## 兼容性
+
+| 项目 | 支持范围 |
+|---|---|
+| DSH | 声明 `>=0.2.1-rc.2 <0.3.0-0`；本轮测试依赖以 `0.2.1-rc.3` 为基准，完整宿主组合尚未验证 |
+| Node.js | `>= 22.19` |
+| 操作系统 | Windows x64（已验证）；macOS/Linux 未验证 |
+| 浏览器测试 | Microsoft Edge |
+
+## 已知边界
+
+**这个插件没有完成完整的效果评测。** 请据此判断是否适合你的场景：
+
+- 60 条固定合成质量集尚未跑完真实模型评测，也没有独立人工语义标注，状态为 `not_evaluated`。
+- 6 次真实模型小样本对照只能说明链路可用（2,807 tokens），**不能证明效果优于同类工具**。
+- 中文 IME 候选组合、附件/引用组合、完整官方 Web 组合、其他插件组合、非 Windows x64 平台均未验证。
+- 声明允许 `0.2.1-rc.2` 至 `<0.3.0-0`；本版未对声明范围内每个宿主版本完成实机验证。
+
+详见 [验收记录](docs/validation.md) 与 [低用量真实模型试验](docs/smoke-comparison.md)。
+
+## 数据与隐私
+
+- 不收集遥测，不上传使用数据。
+- 草稿与设置存在宿主 DSH 的私有 storage。
+- 模型调用走宿主已配置的提供商；插件不持有或记录 API key。
+- 优化/预测/续写会把当前草稿与相关上下文发给模型提供商 —— 这是功能必需，请按你所用提供商的数据政策评估。
+
+详见 [安全策略](SECURITY.md)。
+
+## 开发
+
+```powershell
+pnpm install
+pnpm typecheck     # 类型检查
+pnpm test          # 全量工程回归（含 Edge）
+pnpm build         # 构建 lib/
+pnpm pack --pack-destination dist # 先生成当前版本归档
+pnpm test:package  # 校验打包产物（需先 pack）
+pnpm test:web      # 真实 Edge 回归
+pnpm test:package:web # 直接加载实际 .tgz 的 client/core 做 Edge 回归
+```
+
+贡献前请阅读 [贡献指南](CONTRIBUTING.md)。技术细节见 [0.1.2 修正记录](docs/CHANGELOG-0.1.2.md)。
+
+### 持续集成
+
+每次 push 和 PR 都会在 GitHub Actions 上自动运行 [`.github/workflows/ci.yml`](.github/workflows/ci.yml)：
+
+| Job | 环境 | 内容 |
+|---|---|---|
+| `test-windows` | `windows-latest` | 全量工程测试 + 源码与实际安装包的 Edge 回归 + 构建可复现性校验 |
+| `test-linux` | `ubuntu-latest` | Node 22.19 与 24.19 矩阵，排除 Edge 专属渲染测试，验证核心/宿主/控制器及包消费者 |
+| `package` | `ubuntu-latest` | 打包内容审计：必需文件齐全，且不含研究资料、缓存或测试夹具 |
+
+`test-windows` 是权威结果：主题测试、`scripts/smoke-web.mjs` 和 `scripts/smoke-package.mjs` 使用
+`chromium.launch({ channel: 'msedge' })` 驱动真实 Microsoft Edge 渲染已发布的 DSH 主题，
+浏览器检查在无 Edge 的 Linux 上无法运行，因此覆盖由 Windows job 提供。
+
+本地想复现 Linux job：
+
+```powershell
+pnpm vitest run --exclude 'tests/browser-theme.test.ts'
+```
+
+发布流程复用完整 CI，全部任务通过后才下载并发布其中已验证的同一份 `.tgz`，同时校验 tag 与包版本一致。
+
+推送 `v*` 标签会触发 npm 发布工作流，需要仓库配置 `NPM_TOKEN`；该工作流不会自动创建 GitHub Release。如需在 GitHub 提供下载，需在 CI 成功后另行创建 Release 并附上已验证的归档。发布前应确认版本号、标签和归档一致，且该版本尚未发布。
+
+## 许可证
+
+[MIT](LICENSE)。第三方依赖与参考实现各自适用其原许可证，见 [公开参考与实现边界](docs/references.md)。

package/cordis.patch.yml

@@ -1,3 +1,3 @@
-- insert:
-    - id: input-assistant
-      name: dsh-input-assistant
+- insert:
+    - id: input-assistant
+      name: dsh-input-assistant

package/docs/CHANGELOG-0.1.2.md

@@ -1,102 +1,102 @@
-# 0.1.2 修正记录
-
-记录日期：2026 年 10 月 23 日（Asia/Shanghai）。
-
-`0.1.2` 是 `0.1.1` 的缺陷修正版本，不新增用户可见功能。以下每条都先复现、再修复、再补回归用例。测试总数从 **105** 增至 **121**（12 个测试文件）。
-
-## 修正清单
-
-### 1. 相对路径与裸文件名不受保护（`src/core/protection.ts`）
-
-**问题**：`0.1.1` 的路径保护正则只覆盖代码块、行内代码、URL、盘符绝对路径（`C:\…`、`D:/…`）和以 `./` `../` `/` 开头的路径。编码类草稿里最常见的裸相对路径完全不保护：
-
-```
-"修改 package.json 里的 scripts"       =>  []
-"看看 src/index.ts 的实现"             =>  []
-"不要改 src/a.ts"                      =>  []
-```
-
-更严重的是**部分保护**造成静默改写。`src/core/generation.ts` 只匹配到 `/core/generation.ts`，前面的 `src` 裸露在外：
-
-```
-原稿  : 更新 src/core/generation.ts 的实现
-masked: 更新 src⟪DSH_KEEP_0⟫ 的实现
-模型把 src 改成 lib → 恢复成 lib/core/generation.ts   ← 不报错，路径已错
-```
-
-**修复**：新增四条规则——带扩展名的相对路径、无扩展名的深层相对路径、带已知扩展名的裸文件名、已知的无扩展名工程文件（`LICENSE`、`Makefile` 等）。扩展名用**闭集**而非形状猜测，避免把 `e.g.` 这类普通缩写误判成文件。
-
-**验证**：`tests/core.test.ts` 新增 3 条用例，覆盖 6 种路径形态、`e.g.`/`i.e.` 不误保护、以及"目录部分不得裸露"的回归。core 用例 25 → 28。
-
-### 2. 一次瞬时 status 轮询失败会静默杀死在途优化（`src/browser/controller.ts`）
-
-**问题**：状态轮询每 900ms 一次。`refresh()` 的 `catch` 分支注释写着"失败的 status 读取不构成草稿/模型/回合变化的证据"，但紧接着调用 `invalidate(false)`，而 `invalidate` 第一行就是 `cancelActive()`。实测：点"优化"→ 一次网络抖动 → 请求被 abort、按钮复位、**没有任何提示**，用户的操作无声消失。
-
-**修复**：`invalidate` 增加 `cancelInFlight` 参数。瞬时 status 失败走 `invalidate(false, false)`：清掉自动建议缓存（灰字便宜且必须随连接失效而消失），但保留在途的手动优化。真正的状态变化路径仍完整取消。
-
-**验证**：`tests/browser-controller.test.ts` 新增 1 条用例，断言失败轮询后 `busy` 仍为 `optimize`、请求 `signal.aborted === false`、随后正常完成并生成改动记录。controller 用例 35 → 36。
-
-### 3. `debounceMs > 900` 时输入续写完全失效（`src/browser/controller.ts`）
-
-**问题**：`driveSuggestions()` 第一行无条件 `clearTimer()`，末尾才重新 `setTimeout`。而它每 900ms 被状态轮询调用一次，于是**任何超过 900ms 的 debounce 定时器每 900ms 被清掉重建，永远等不到触发**。实测阈值是断崖式：
-
-```
-debounce=899 → 1 次调用     debounce=901 → 0 次调用
-debounce=900 → 1 次调用     debounce=2000/5000 → 0 次调用
-```
-
-设置页把"续写停顿"暴露为 **200–5000 ms**，也就是说用户按界面允许的范围调大停顿，续写功能会悄悄消失且没有任何提示。默认 600ms 在安全区，所以既有测试发现不了。
-
-**修复**：记住已武装定时器对应的 cache key（`timerKey`）。`driveSuggestions()` 在各提前返回分支显式 `clearTimer()`；只有 key 变化时才重排定时器，key 未变则保留已武装的那个。
-
-**验证**：新增 2 条用例——`debounceMs` 取 200/600/900/1000/2000/5000 时 20 次轮询后都恰好触发 1 次；以及草稿在定时器触发前变化时会正确重排并携带新草稿。controller 用例 36 → 43。
-
-### 4. 存储中的未知配置键会锁死整个插件（`src/core/config.ts`、`src/host/storage.ts`）
-
-**问题**：`resolveConfig` 对未知键直接抛 `CONFIG`，而设置是整份对象持久化的。版本漂移（新版本写入新键后用户降级，或记录被部分写入）会导致 `settings/get`、`status`、`generate`、`drafts/*` 全部失败，设置页也加载不出来，且**无法通过保存自愈**——`updateSettings` 把含坏键的旧对象再 merge 回去。
-
-**修复**：拆成两个入口。`resolveConfig` 保持严格（插件自身 Cordis 配置与每次 `settings/set` 补丁，调用方写错必须报错）；新增 `resolveStoredConfig` 用于**读取已存记录**——未知键忽略、单字段非法回退默认值、`provider`/`model` 半填对回退为跟随输入框。下一次成功保存会重写成干净记录。
-
-**验证**：`tests/host-storage.test.ts` 新增 5 条用例：未知键不锁死、保存后坏键消失、逐字段回退、半填对丢弃、显式补丁仍严格。storage 用例 4 → 9。
-
-### 5. 中文 diff 粒度过粗（`src/core/diff.ts`）
-
-**问题**：分词正则把不含空格的整段中文当作一个 token，于是 `请解释缓存机制` → `请说明缓存机制` 被渲染成整短语删除 + 整短语插入，中文用户基本看不出改了什么。
-
-**修复**：CJK 按码点切分，保留拉丁词/空白/标点的分组；同时先裁剪相同前后缀再做 DP，并保留超限时的降级路径（先句级，再整段替换），使最大长度草稿也不会卡住。
-
-**验证**：现有 diff 用例（无损重建、emoji 代理对不拆分）继续通过；人工核对 `解释`→`说明`、`不要修改`→`保持现有` 已是词级粒度。
-
-### 6. 无界集合与调度器语义（`src/browser/controller.ts`、`src/core/scheduler.ts`、`src/host/runtime.ts`）
-
-- `exposed` 与 `nextTurns` 两个 Set 只增不减。加入 512 上限，与既有的 `completionCache` 64 上限保持一致。
-- `settings/set` 原来调用 `scheduler.dispose()`，语义上是"销毁调度器"却当"取消在途"用。拆出 `cancelAll()` 表达真实意图并补注释说明为何设置变更要取消所有会话的在途请求。
-
-## 未改变的边界
-
-以下与 `0.1.1` 一致，没有因为本次修正而变化：
-
-- 60 条固定合成质量集仍为 `not_evaluated`（0/60）。本次修正**没有**新增任何真实模型调用，也没有做人工语义标注。
-- 6 次小样本对照结论不变：只能说明接线可用，不能证明同类领先。
-- 未验证项仍是未验证：中文 IME 候选组合、附件/引用组合、完整官方 Web 组合、其他插件组合、非 Windows x64 平台。
-- 本次修正未在官方桌面端重新做原生手测；相关证据仍是 `0.1.1` 时期记录，版本号与哈希需以新的 `verification.json` 为准。
-
-## 复现命令
-
-```powershell
-# 类型检查与构建
-node node_modules/typescript/bin/tsc --noEmit
-node scripts/build.mjs
-
-# 全部自动化测试（121 条）
-node node_modules/vitest/vitest.mjs run
-
-# 实际打包产物的 Loader 校验
-node scripts/verify-package.mjs dist/dsh-input-assistant-0.1.2.tgz
-
-# 真实 Edge 中的编辑器回归
-node scripts/smoke-web.mjs
-
-# 评测集结构校验（0 次模型调用）
-node scripts/evaluate.mjs validate
-```
+# 0.1.2 修正记录
+
+记录日期：2026 年 10 月 23 日（Asia/Shanghai）。
+
+`0.1.2` 是 `0.1.1` 的缺陷修正版本，不新增用户可见功能。以下每条都先复现、再修复、再补回归用例。测试总数从 **105** 增至 **121**（12 个测试文件）。
+
+## 修正清单
+
+### 1. 相对路径与裸文件名不受保护（`src/core/protection.ts`）
+
+**问题**：`0.1.1` 的路径保护正则只覆盖代码块、行内代码、URL、盘符绝对路径（`C:\…`、`D:/…`）和以 `./` `../` `/` 开头的路径。编码类草稿里最常见的裸相对路径完全不保护：
+
+```
+"修改 package.json 里的 scripts"       =>  []
+"看看 src/index.ts 的实现"             =>  []
+"不要改 src/a.ts"                      =>  []
+```
+
+更严重的是**部分保护**造成静默改写。`src/core/generation.ts` 只匹配到 `/core/generation.ts`，前面的 `src` 裸露在外：
+
+```
+原稿  : 更新 src/core/generation.ts 的实现
+masked: 更新 src⟪DSH_KEEP_0⟫ 的实现
+模型把 src 改成 lib → 恢复成 lib/core/generation.ts   ← 不报错，路径已错
+```
+
+**修复**：新增四条规则——带扩展名的相对路径、无扩展名的深层相对路径、带已知扩展名的裸文件名、已知的无扩展名工程文件（`LICENSE`、`Makefile` 等）。扩展名用**闭集**而非形状猜测，避免把 `e.g.` 这类普通缩写误判成文件。
+
+**验证**：`tests/core.test.ts` 新增 3 条用例，覆盖 6 种路径形态、`e.g.`/`i.e.` 不误保护、以及"目录部分不得裸露"的回归。core 用例 25 → 28。
+
+### 2. 一次瞬时 status 轮询失败会静默杀死在途优化（`src/browser/controller.ts`）
+
+**问题**：状态轮询每 900ms 一次。`refresh()` 的 `catch` 分支注释写着"失败的 status 读取不构成草稿/模型/回合变化的证据"，但紧接着调用 `invalidate(false)`，而 `invalidate` 第一行就是 `cancelActive()`。实测：点"优化"→ 一次网络抖动 → 请求被 abort、按钮复位、**没有任何提示**，用户的操作无声消失。
+
+**修复**：`invalidate` 增加 `cancelInFlight` 参数。瞬时 status 失败走 `invalidate(false, false)`：清掉自动建议缓存（灰字便宜且必须随连接失效而消失），但保留在途的手动优化。真正的状态变化路径仍完整取消。
+
+**验证**：`tests/browser-controller.test.ts` 新增 1 条用例，断言失败轮询后 `busy` 仍为 `optimize`、请求 `signal.aborted === false`、随后正常完成并生成改动记录。controller 用例 35 → 36。
+
+### 3. `debounceMs > 900` 时输入续写完全失效（`src/browser/controller.ts`）
+
+**问题**：`driveSuggestions()` 第一行无条件 `clearTimer()`，末尾才重新 `setTimeout`。而它每 900ms 被状态轮询调用一次，于是**任何超过 900ms 的 debounce 定时器每 900ms 被清掉重建，永远等不到触发**。实测阈值是断崖式：
+
+```
+debounce=899 → 1 次调用     debounce=901 → 0 次调用
+debounce=900 → 1 次调用     debounce=2000/5000 → 0 次调用
+```
+
+设置页把"续写停顿"暴露为 **200–5000 ms**，也就是说用户按界面允许的范围调大停顿，续写功能会悄悄消失且没有任何提示。默认 600ms 在安全区，所以既有测试发现不了。
+
+**修复**：记住已武装定时器对应的 cache key（`timerKey`）。`driveSuggestions()` 在各提前返回分支显式 `clearTimer()`；只有 key 变化时才重排定时器，key 未变则保留已武装的那个。
+
+**验证**：新增 2 条用例——`debounceMs` 取 200/600/900/1000/2000/5000 时 20 次轮询后都恰好触发 1 次；以及草稿在定时器触发前变化时会正确重排并携带新草稿。controller 用例 36 → 43。
+
+### 4. 存储中的未知配置键会锁死整个插件（`src/core/config.ts`、`src/host/storage.ts`）
+
+**问题**：`resolveConfig` 对未知键直接抛 `CONFIG`，而设置是整份对象持久化的。版本漂移（新版本写入新键后用户降级，或记录被部分写入）会导致 `settings/get`、`status`、`generate`、`drafts/*` 全部失败，设置页也加载不出来，且**无法通过保存自愈**——`updateSettings` 把含坏键的旧对象再 merge 回去。
+
+**修复**：拆成两个入口。`resolveConfig` 保持严格（插件自身 Cordis 配置与每次 `settings/set` 补丁，调用方写错必须报错）；新增 `resolveStoredConfig` 用于**读取已存记录**——未知键忽略、单字段非法回退默认值、`provider`/`model` 半填对回退为跟随输入框。下一次成功保存会重写成干净记录。
+
+**验证**：`tests/host-storage.test.ts` 新增 5 条用例：未知键不锁死、保存后坏键消失、逐字段回退、半填对丢弃、显式补丁仍严格。storage 用例 4 → 9。
+
+### 5. 中文 diff 粒度过粗（`src/core/diff.ts`）
+
+**问题**：分词正则把不含空格的整段中文当作一个 token，于是 `请解释缓存机制` → `请说明缓存机制` 被渲染成整短语删除 + 整短语插入，中文用户基本看不出改了什么。
+
+**修复**：CJK 按码点切分，保留拉丁词/空白/标点的分组；同时先裁剪相同前后缀再做 DP，并保留超限时的降级路径（先句级，再整段替换），使最大长度草稿也不会卡住。
+
+**验证**：现有 diff 用例（无损重建、emoji 代理对不拆分）继续通过；人工核对 `解释`→`说明`、`不要修改`→`保持现有` 已是词级粒度。
+
+### 6. 无界集合与调度器语义（`src/browser/controller.ts`、`src/core/scheduler.ts`、`src/host/runtime.ts`）
+
+- `exposed` 与 `nextTurns` 两个 Set 只增不减。加入 512 上限，与既有的 `completionCache` 64 上限保持一致。
+- `settings/set` 原来调用 `scheduler.dispose()`，语义上是"销毁调度器"却当"取消在途"用。拆出 `cancelAll()` 表达真实意图并补注释说明为何设置变更要取消所有会话的在途请求。
+
+## 未改变的边界
+
+以下与 `0.1.1` 一致，没有因为本次修正而变化：
+
+- 60 条固定合成质量集仍为 `not_evaluated`（0/60）。本次修正**没有**新增任何真实模型调用，也没有做人工语义标注。
+- 6 次小样本对照结论不变：只能说明接线可用，不能证明同类领先。
+- 未验证项仍是未验证：中文 IME 候选组合、附件/引用组合、完整官方 Web 组合、其他插件组合、非 Windows x64 平台。
+- 本次修正未在官方桌面端重新做原生手测；相关证据仍是 `0.1.1` 时期记录，版本号与哈希需以新的 `verification.json` 为准。
+
+## 复现命令
+
+```powershell
+# 类型检查与构建
+node node_modules/typescript/bin/tsc --noEmit
+node scripts/build.mjs
+
+# 全部自动化测试（121 条）
+node node_modules/vitest/vitest.mjs run
+
+# 实际打包产物的 Loader 校验
+node scripts/verify-package.mjs dist/dsh-input-assistant-0.1.2.tgz
+
+# 真实 Edge 中的编辑器回归
+node scripts/smoke-web.mjs
+
+# 评测集结构校验（0 次模型调用）
+node scripts/evaluate.mjs validate
+```