SuperAPI AI 工具集

bopomofo-rescue

通用与其它

查看项目

更新于 10-22 11:27

技能介绍

用途:解决台湾工程师使用注音输入法时忘记从英文切回中文,导致原本要打的中文变成一串注音实体按键的问题。例如想打“你好吗”却产出 su3cl3a8。该技能把这类按键序列还原成中文,省去重打。

运行前提:需要上游仓库附带的解码脚本与约 5MB 注音词典;当前目录仅收录 SKILL.md 与参考资料。安装命令为: git clone https://github.com/Oliviaiii/bopomofo-rescue.git ~/.claude/skills/bopomofo-rescue 安装后会挂上 UserPromptSubmit hook,讯息送出即自动解码,无需前缀指令。需要 Python 3 且在 PATH 上。

主要能力:核心原则是还原必须使用 scripts/decode_bopomofo.py,不应由模型自行推断按键映射,因为硬猜容易出错。脚本采用纯查表、音节切分与词典断词(IME 式最大机率),输出注音与中文猜测。

使用方式:对可能含注音误打的讯息执行: python "${CLAUDE_SKILL_DIR}/scripts/decode_bopomofo.py" --brief "使用者的原始讯息" 默认 --brief 只回传判读所需字段,约为完整 JSON 的 10%;需要同音字候选或除错时去掉 --brief,完整输出含 chinese_alternatives、confidence 等,--full 另附所有 token 的 segments。输出字段包括 has_candidates、candidates[](含 bopomofo、chinese、tier、可能的 repair)与 reconstructed。

信心分级行为:high(≥0.90)静默还原并照还原后意思继续;medium(0.65–0.89)用一句话标注推测再继续;low(<0.65)预设不动,仅在上下文非常明显时采用,否则照原文理解。像 npm、git、html 这类纯字母 token 宁可放过。

上下文确认:脚本以词频给出 chinese 最佳猜测,常见句多半直接正确。语境不合时查看 chinese_alternatives,从同音候选里挑合理字;若怎么拼都不成合理中文,就退回原文照字面理解,避免把 npm run dev 误当中文。词典缺席时 chinese 为空,仅有 bopomofo,此时依注音在上下文中判读。

repair 建议:当 tier 为 high、注音可切但 chinese 为空,常见原因是相邻两键打反。例如“说”= ㄕㄨㄛ 应打 gji,误打 jgi 会切成合法但不存在的音节,词典查无。此时脚本附上最多 3 个 repair 建议,应优先采用其 chinese,但仍需用上下文确认;若建议在语境中不通,就退回原解读或依注音自行判读。repair 只是建议,不会改写 bopomofo 或提高 confidence。

安全边界:脚本已排除程式码区块、行内 code、URL、路径、git hash、CLI flag、版本号与含大写的识别字;使用者仍应再判断一次,若候选其实是档名、变数或指令,就不要还原。该技能只解读输入、不改变请求意图。

参考资料:需要人工核对或脚本不可用时,可查 references/keyboard-layout.md(大千式注音键盘对照表与合法韵母清单)与 references/exclusion-rules.md(应跳过的字串与原因)。正常情况下一律以脚本输出为准。