dsh-typing-practice

A typing practice page for the DeepSeek Harness Web UI: English, Chinese and Cantonese text, recent local conversation passages, native IME input, Pinyin and Jyutping hints, live speed and accuracy, and local best scores.

给 DeepSeek Harness Web GUI 加的「打字练习」插件：英文、中文和粤语文本练习，可选默认语料或近期本地对话，使用自己的输入法上屏，可查看拼音或粤拼提示，实时统计速度与准确率，最佳成绩存在本机浏览器。

非官方项目，只是一个 DSH 插件 bundle（dsh.bundle.patch + dsh.client）。

功能

项	说明
入口	左侧栏「打字练习」（键盘图标）→ 主区域练习页
语料	英文生成句子、简体中文短文、繁体粤语短文；与界面语言独立
本地对话	按当前语言，从当前 DSH profile 近 30 天的用户消息和已完成模型回复中选取片段；无结果时回退到默认语料
来源切换	「默认语料／本地对话语料」位于「换一段」旁；记住选项，重新打开页面时恢复；回退不改变选项
注音	中文带声调拼音、粤语数字声调粤拼；默认「当前词」，可选「全部」或「关闭」
模式	默认语料为 15 / 30 / 60 秒限时；本地对话为「完成一段」，不计入限时最佳
实时反馈	英文四行、中文和粤语三行视区；逐字符高亮，组字预览，计时条与剩余时间
成绩	英文用 WPM，中文和粤语用字/分钟（CPM）；另显示准确率、正确字符和错误数
最佳成绩	按语言、时长、语料类别、提示状态和规则版本分别保存到 localStorage['dsh.typing-practice.v2']
操作	首次有效组字或直接文字输入开始计时；上屏后判分；原生退格、选区替换；始终可见的重开按钮
键盘导航	Tab / Shift+Tab 依次切换来源、换一段、语言、时长、注音选项、输入区与重开按钮；Enter / 空格激活按钮；组字时候选操作交给输入法
界面	中英双语，跟随 DSH locale；只用 --dsw-alias-* 主题 token，亮/暗色自适应

达到所选时长时即截止，之后的文字确认和退格都不计入本轮成绩，即使浏览器尚未执行下一次计时回调。截止时仍在组字的内容不进入成绩；旧输入框迟到的组合事件不会写入重开后的新一轮。界面优先使用宿主翻译；缺少翻译时，按 getLocale().active 选择内置中英文文案。

页面打开时保留宿主焦点。切换语料语言或时长会开始新一轮，焦点留在该按钮；重开按钮将焦点送回输入区。输入区有可见焦点框，输入、退格、重新聚焦和视区尺寸变化时会滚动到当前字符，保留相邻行作为上下文。原生输入元素跟随当前字符定位，为系统候选窗提供锚点。持续输入和退格只滚动文本视区；聚焦或缩放时，如输入区已离开可见范围，页面会滚动以显示整个输入区。重开会回到文本开头。

选文加载与回退提示使用语料栏中的固定位置。输入区未聚焦时，卡片底部显示「点击或用 Tab 聚焦后输入」；聚焦后在同一位置显示计时规则，不覆盖正文。注音下拉框保留原生键盘操作，并单独为文字和箭头留出间距。布局测量见 UI 微调验证记录。

英文练习文本由常用词和标点本地生成。中文与粤语分别有六段原创短文，按完整句子循环补足限时语料。粤语内容使用「返屋企」「落緊雨」「傾偈」等粤语表达，使用者可以自行选择拼音、粤拼、仓颉等输入法。当前严格比较原文，不自动转换简繁或中英文标点，也不删除输入法自动补全的成对标点。语料不联网获取。

拼音由 pinyin-pro 生成，粤拼采用与 jyut 项目相同的 to-jyutping 引擎，结合词语上下文选音。注音在汉字上方显示；「当前词」会随输入位置移动，并保留隐藏注音的位置，避免每输入一个字就改变换行。自动注音不改写原文，未知读音留空。切换提示档位会保留当前语料并开始新一轮，三个档位的最佳成绩分别保存。

两个词库随插件打包，按所选语言在本地加载并缓存，不调用远程注音服务。首次准备注音期间暂不接收输入、不启动计时；加载失败时可重试，或关闭提示继续练习。

本地对话语料

在「换一段」旁选择「本地对话语料」，插件立即按当前英文／中文／粤语模式选取文本。之后点击「换一段」可重新选取。切换语言、重新打开练习页时，也会按保存的来源选取；首次使用默认为「默认语料」，不读取聊天正文。选择默认语料会取消正在进行的读取。

本地对话只使用近 30 天的用户正文和已完成的模型回复，不区分两种来源。英文片段为 40–100 词，中文和粤语为 80–200 个可见字符，按完整句子选取。保留原文字形，不把普通话改写成粤语。没有合适内容、读取失败或超时时，自动使用默认语料，并保留「本地对话语料」选项，下次「换一段」仍尝试本地对话。读取中可点击「取消选取」。

提取会跳过推理、工具调用及结果、系统上下文、代码、表格、附件和明显的密钥等片段；清理 Markdown 后只显示普通文本，不执行内容。各消息分别提取，不拼接不同消息。完成片段后显示实际用时和成绩，重开保留同一片段；片段正文不持久化，也不进入限时最佳记录。

速度按当前正确匹配的可见字符计算：英文每五个字符折合一词；中文与粤语每个可见字符计一字，包含标点及拉丁字符。组字和选词时间计入用时。准确率按累计确认输入计算；取消组字不计错误，修正已上屏错误不抹去累计错误。使用 Intl.Segmenter 划分可见字符，避免把非 BMP 汉字或组合字符拆成多个计分单位。提前打完会显示实际用时，不写入完整时长最佳。

安装

本插件是 DSH 的 bundle。克隆后，在 DSH 里让 agent 用 plugin_manager 安装这个目录：

git clone https://github.com/yishan/dsh-typing-practice.git

plugin_manager(action: "install_bundle", target: "/absolute/path/to/dsh-typing-practice")

如果你的环境里有 dsh CLI，也可以直接：

dsh plugin --profile <profile> add /absolute/path/to/dsh-typing-practice

安装后刷新 DSH Web 页面，左侧栏会出现「打字练习」。仓库包含已构建的注音文件，直接安装无需自行构建；包管理器会安装 Host 所需依赖。注音分块和本地对话接口已在 DSH 0.2.2-rc.1 验证；缺少对话查询服务时回退到默认语料，不具备相同模块加载能力的宿主可关闭提示使用。已有本地安装更新 Host 代码后，可在插件管理页关闭再开启「打字练习」。安装是 profile 级的，该 profile 下所有会话可见；删除时用 plugin_manager 卸载即可。

数据

最佳成绩写入 dsh.typing-practice.v2，其值为以下结构的 JSON 字符串：

{
  version: 2,
  best: {
    "en:30:builtin:plain:2": { speed: 76, accuracy: 0.94, at: 1793900000000 },
    "yue:30:builtin:plain:2": { speed: 102, accuracy: 0.98, at: 1793900000000 },
    "zh:30:builtin:current:2": { speed: 108, accuracy: 0.97, at: 1793900000000 },
    "yue:30:builtin:all:2": { speed: 96, accuracy: 0.99, at: 1793900000000 }
  }
}

键依次表示语言、秒数、内置语料、提示档位和评分规则版本。提示档位使用 plain（关闭）、current（当前词）、all（全部）；原有 v2 无注音记录继续使用 plain，不迁移到有提示的档位。speed 的单位由语言决定。旧 dsh.typing-practice.v1 原样保留；当前条件没有新版英文记录时，显示带「旧版最佳」标识的旧成绩，不将旧成绩混入新规则比较。删除 v2 只清空新记录，旧记录仍会保留。保存失败会显示提示，不中断练习。

语料来源单独保存在 dsh.typing-practice.preferences.v1：{"version":1,"source":"local"} 或 {"version":1,"source":"builtin"}。该设置与成绩分开；无效设置回退到默认语料。保存失败会提示，下次打开时可能需要重新选择。

本地对话模式通过当前 DSH Host 读取当前 profile 的聊天历史，不向外部服务上传正文，不调用远程模型或翻译服务。选中的片段只留在本次页面内存中；浏览器存储只保留上述来源选项和最佳成绩。没有收藏、正文缓存或跨设备同步。

结构

dsh-typing-practice/
├── package.json        # bundle 清单 + dsh.client 声明（platform: web, inject: ["slots"]）
├── cordis.patch.yml    # 只插入一行 Host 插件
├── index.js            # Host 半：注册受宿主鉴权保护的近期语料接口
├── client.js           # Client 半：侧边栏入口 + 练习页（手写）
├── client.pinyin.js    # 生成文件：拼音引擎与对齐适配
├── client.jyutping.js  # 生成文件：粤拼引擎与对齐适配
├── src/               # 注音、字符对齐、词语范围、corpus.js 提取及 corpus-routes.js 接口
├── scripts/build.mjs  # esbuild 打包为 DSH 异步模块
├── tests/             # 输入、计时、记录、注音、语料提取、接口及来源记忆测试
├── icon.svg            # 插件图标（原创键帽）
├── locale/{zh,en}.json # 插件管理页的标题 / 描述
├── LICENSE
├── THIRD_PARTY_NOTICES.md
└── README.md

实现要点：

• 挂载点：sidebar.panellist（id: typing-practice，order 15）+ main（key: typing-practice）。
• 计时、默认文本生成、成绩统计在浏览器端；Host 的 GET /api/typing-practice/recent?language=en|zh|yue 返回一个片段或回退原因。
• Host 使用当前 profile 的 sessionQuery.listSessions 和可取消的 observeSession；每次观察结束均释放。桌面 Client 优先使用宿主 __DSH_TRANSPORT__.fetch，Web 使用相对路径请求。
• mdast-util-from-markdown 在 Host 解析 Markdown。先过滤事件时间、来源和内容类型，再按句子边界选文；保留来源位置与指纹，接口不返回完整聊天日志。
• client.js 通过 window.__ModuleLoader__.load 注册，React 来自页面运行时；不 import 任何 Harness Client 包。
• 注音代码构建成两个独立的 DSH chunk，通过 require.async 按需加载。构建后更新主入口时间戳，使宿主刷新词库版本。
• 页面文案注册到 Client locale 服务，切换语言自动刷新。

开发

• 改 client.js 后刷新页面即可；改 Host 入口或语料模块后，在插件管理页关闭再开启本插件，或重启 DSH。修改注音源码或依赖后，重新构建并一并提交生成文件与第三方声明。
• 静态检查：

node --check client.js
node --check index.js
python3 -m json.tool package.json > /dev/null

• 安装开发依赖、构建注音分块并运行回归测试（Node 内置测试运行器）：

npm ci
npm run build
npm test

npm pack 会在打包前重新构建。运行这些开发命令需要包含 src/、scripts/ 和测试文件的仓库 checkout。

83 项测试覆盖截止、组字、Unicode、编辑、记录、存储、注音和分块，以及对话角色／内容过滤、30 天时间边界、Markdown 清理、完整句子长度、粤语原文识别、去重、读取预算、取消、有限段落完成、桌面请求通道、来源选择记忆和回退。组件测试使用受控时钟和 React hooks 替身，不包含真实 DOM 或操作系统候选窗。

2026-11-06 已在真实 DSH 0.2.2-rc.1 中确认三语界面、中文组字与选词上屏，以及两个注音分块实际加载。用户在输入层阶段同步确认候选窗位置正常。模拟宿主页另验了注音随词切换、当前词／全部排版一致、带注音长文本内部滚动、输入锚点、键盘导航和窄屏。详见 IME 验证记录与注音验证记录。这些检查不代表所有输入法和设备均已验收。

本地对话已在真实 DSH 选出近期中文片段并进入带拼音练习。三语片段完成、来源切换与记忆、自动回退和 360px 布局的检查见本地语料验证记录。

已知限制

• 当前已交付输入层、三语示例语料、拼音／粤拼提示和近期本地对话选文。手动导入、收藏、历史记录页、音效和自定义外观尚未实现，后续见 多语言规划。
• 每次最多检查 30 个会话，Host 使用 8 秒协作取消预算，Client 最长等待 12 秒；下次从后续会话继续。无结果表示本次预算内未找到，不保证遍历全部历史。宿主读取超大会话仍可能加载整份日志，预算不是严格的磁盘字节上限。
• 粤语识别使用用词特征初筛，可能漏选或误选；不保证所有片段的语言与自然度。不同宿主版本的历史格式可能需要适配，失败时回退默认语料。来源仅限当前 DSH profile，不读取其他应用历史。
• 自动注音和分词仍可能有误。内置粤语已为「慢慢行」「返到屋企」增加上下文读音校正；暂未提供用户选音、人工覆盖或读音教学功能。
• 内置语料规模较小，限时练习会循环使用；还需要扩充和人工审校。
• Windows、其他输入法，以及组字中跨行、缩放、截止等组合操作仍需真实环境回归。自动测试通过不代表所有输入法均已验证。
• 切换侧边栏面板会卸载页面，进行中的测试重置；已保存的最佳成绩不受影响。
• 成绩只存在本机浏览器，不跨设备同步。

License

MIT。随包注音依赖的版本、来源和许可见 THIRD_PARTY_NOTICES.md。

---