专为 macOS Squirrel （鼠须管）打造的打字数据统计扩展 Rime Typing Speed 由两部分组成：
- Lua 日志脚本：挂载到 Rime 输入法底层，监听文字上屏事件，仅记录字数、编码长度、时间戳、输入方案，绝不保存你输入的原文内容；日志单独存放，不污染 Rime 同步目录。
- rspeed /rts 命令行工具：零依赖 Python 脚本，读取日志并计算多维度打字指标，输出可视化统计报表，支持按日 / 周 / 月 / 自定义时间段查询，还能导出 CSV 明细。
核心定位：不干扰日常打字、完全本地隐私、长期真实输入数据复盘工具，适合文案、程序员、五笔 / 双拼爱好者用来优化输入方案、降低平均码长、提升长期写作效率。
限制：目前仅支持 macOS 鼠须管， Windows 小狼毫暂不兼容，需要系统已启用 librime-lua （雾凇、万象等主流方案均自带 Lua 环境）。
核心功能
1. 极致隐私保护，零文字采集
这是本工具最大优势：
- 日志只记录数字指标：上屏总字符、汉字数量、平均编码长度、时间戳、使用方案
- 不会存储、上传任何你打出的句子、词语，不存在隐私泄露风险
- 日志文件夹独立于 Rime 同步目录， WebDAV 同步配置时不会同步打字记录
2. 四大专业打字统计指标
工具区分多维度速度口径，覆盖不同分析需求，全部附带严谨计算公式：
- 活跃速度（字 / 分钟） 剔除 5 秒以上停顿，只统计连续打字时段，真实反映纯手速，适合对比不同输入方案手感。
- 上屏速度（字 / 分钟） 按 5 分钟分割打字会话，包含思考停顿，代表日常真实产出效率，写文章、办公参考核心指标。
- 峰值速度（字 / 分钟） 滑动 60 秒窗口计算最高瞬时速度，对标在线打字测试成绩，检验极限手速。
- 输入效率（平均码长，击键 / 每字） 总编码长度 ÷ 总上屏字数，数值越低方案越高效；双拼普遍 2 左右，全拼更高，用来对比双拼 / 辅码优化效果。
3. 丰富时间维度查询报表
一键调取任意周期数据，命令极简好记：
rspeed today：今日实时打字概况，含小时分布rspeed report yesterday：昨日完整统计rspeed report week：近 7 天汇总rspeed report month：近 30 天汇总rspeed report 2026-07-20：指定单日历史rspeed export --csv：导出全部明细表格，可 Excel 分析
4. 一键安装 / 卸载，自动适配所有输入
极简部署流程，无需手动修改 yaml ：
- 终端执行
make install绑定系统命令rspeed（简写rts） - 执行
rspeed install自动写入 Lua 脚本、挂载所有已启用输入方案 - 自动触发鼠须管重新部署，立刻开始记录打字日志
- 卸载：
rspeed uninstall；rspeed --purge可连带删除全部历史日志
新增输入方案后，重新执行rspeed install即可新增监听。
5. 轻量化无负担
- Lua 脚本常驻占用极低，不增加输入法输入延迟
- Python 工具无第三方依赖，系统自带 Python3 即可运行
- 日志增量写入，长期使用不会产生超大文件
- 开源 GPL3 协议，代码完全透明可审计
6. 数据复盘优化输入方案
长期统计可直观发现问题：
- 平均码长偏高：说明当前方案重码多，可更换辅码、优化词库
- 活跃速度远高于上屏速度：写作时思考停顿过长，适合短句拆分写作
- 切换方案对比速度：直观对比双拼 / 五笔 / 全拼的长期效率差异
使用步骤
1. 前置条件
macOS 系统，已安装鼠须管 Squirrel ，输入方案启用 librime-lua （雾凇、几维、极点五笔等主流配置均自带）。
2. 安装流程
打开终端依次执行
# 克隆项目仓库
git clone https://github.com/ryekee/rime-typing-speed
cd rime-typing-speed
# 绑定 rspeed 系统命令
make install
# 自动部署 Lua 统计脚本到 Rime
rspeed install执行完成后，右键鼠须管菜单栏「重新部署」，正常打字即可自动记录数据。
3. 常用查询命令示例
# 查看今日实时数据
rspeed today
# 查看近 7 天完整报表
rspeed report week
# 导出全部记录为 csv 文件
rspeed export --csv > typing_log.csv
# 彻底卸载并删除所有日志
rspeed uninstall --purge工具局限说明
- 仅支持 macOS 鼠须管， Windows 小狼毫、 Linux 中州韵暂不兼容
- 纯英文直通模式（不经过 Rime 编码）打出的文字不会计入统计
- 时间戳精度为秒，极速同秒多击时峰值速度会略微偏低
- 新增输入方案后需要重新执行
rspeed install才能开启统计
总结
rime-typing-speed 是 macOS 鼠须管独一份本地打字统计工具，完美弥补在线测速只能临时测试的短板，如果你使用 mac 鼠须管，想客观量化自己的打字效率、对比不同输入方案优劣，这款本地统计工具是不可替代的辅助神器。
