TypingPractice
打字练习 分类：Control 描述：使用本地或在线文章进行打字练习，并按文章记录成绩与未完成进度。
需求
- 安全级别：常规模块
- 权限需求：无
- 驱动依赖：否
- 联网需求：仅在线文章需要
- 开发状态：稳定/常规
- 版本属性：普通可用
介绍
TypingPractice（打字练习）位于 Apps 页面。模块开启后会自动进入练习界面并保持暂停，首次敲击按键时开始或继续计时。
右上角的“选择文章”按钮会打开 Material Design 3 风格的右侧文章浏览器：Local 标签页保存添加过的本地文章，Online 标签页按目录浏览 Gitee 仓库中的中英文文章。在线文章下载后缓存到 output/Cache/Articles，并保留仓库中的 cn、en 等相对目录。列表会在成功获取时显示文章的字节大小，页面标题同时显示当前文章文件名。也可在 ResourceMarket 的 Article 标签页右键文章并选择“设为打字练习文章”，该操作会自动切换到 Online 来源并保存文章相对路径。
练习进度、最近成绩、最佳用时、WPM、准确率、错误数和退格数均按文章分别保存。文章浏览器会在文章条目下显示对应成绩摘要。
配置项
- Article Source（文章来源） 类型：枚举；默认：Custom 说明：选择自定义本地文章或在线文章。 可选：Custom（自定义）；Online（在线）
- Custom Article Path（自定义文章路径） 类型：文本；默认：
assets/TYPING_EXAMPLE.txt说明：本地 TXT 文章路径，可使用相对客户端目录的路径或绝对路径。 - Online Article Name（在线文章名称） 类型：文本；默认：空 说明：在线文章相对于 typing 目录的路径，例如
cn/桃花源记.txt。通常通过文章浏览器自动设置。 - Text Scale（文本缩放） 类型：数值；默认：1.5 说明：调整练习正文大小，也可使用页面顶部滑动条修改。
- Text Space（文本间距） 类型：数值；默认：4.0 说明：调整正文字符之间的额外间距。
- Allow Wrong Input（允许错误输入） 类型：布尔；默认：false 说明：开启后错误字符仍会写入并继续前进，错误位置以红色显示。
- Show Box（显示方框） 类型：布尔；默认：true 说明：在下一个待输入字符周围显示定位框。
- Box Easing（方框缓动） 类型：布尔；默认：true 说明：定位框移动时使用缓动。
- Box Easing Speed (0~1)（方框缓动速度） 类型：数值；默认：0.1 说明：控制定位框跟随速度。
- Completed Color（已完成颜色） 类型：枚举；默认：White 说明：已输入正文的颜色。
- Remaining Color（剩余颜色） 类型：枚举；默认：Gray 说明：尚未输入正文的颜色。
- Next Color（下一字符颜色） 类型：枚举；默认：Yellow 说明：下一个待输入字符及定位框的颜色。
操作
- 点击“选择文章”打开文章浏览器，点击弹窗外区域或按 Esc 关闭。
- Local 页底部的加号按钮可添加任意 TXT 文件。
- Online 页使用文件夹进入下级目录，使用左上角返回按钮或 Alt+上方向键回到上级目录。
- 将鼠标悬停在文章文件上，点击右侧键盘图标切换文章；图标悬停 500 毫秒后会显示“开始练习”提示。
- 文章列表支持 Home、End、PageUp、PageDown、上、下与 Enter 键浏览和载入。
- 中文文章支持输入法提交，候选窗口会跟随当前待输入字符。
- F5 重新开始当前文章，F6 重新载入当前文章。
相关命令
无