使用说明

MaQuanTableTool:检查、修复码表并转换为 .mb

码表导入失败时,先查看具体问题;能自动处理的另存修复,再导出供码圈导入的 .mb 文件。

更新于 2026-09-23

下载与适用范围

在官网下载页的「码表转换工具」下载 Windows x64 便携版,双击运行,无需安装输入法。工具与输入法版本独立,目前为 0.1.0;本次在 Windows 上完成了真实码表诊断和转换验证,未完成 Windows 7 实机验收。

图形界面:四步完成

  1. 01

    打开码表

    点击「打开码表…」选择文件,或把文件拖入工具窗口。先看报告中的致命问题、警告及行号。

  2. 02

    修复并另存

    需要时点击「自动修复并另存」。核对改动报告,使用新的文件名保存。工具会复检修复结果;未能自动判断的问题仍需手工处理。

  3. 03

    导出 .mb

    点击「导出 .mb」,另存到新文件。也可用「一键救急(修复→.mb)」完成两步。只有报告显示回读校验通过的文件才继续使用。

  4. 04

    在码圈导入

    把生成的 .mb 传到需要的设备,在码圈的码表管理中选择从本机文件导入,再切换到该方案试打几个常用字词。

自动修复之后仍要看报告

工具可处理部分头部、大小写、全角码元、分列、重复记录和空记录问题;部分疑似错码会根据同类词条给出修复依据。自动推断不等于作者确认,请检查修复后的编码和重码顺序。原表中的合法标点码元不应一概删除。

如果仍提示列错位、无效记录过多或无法识别,请点击「保存报告」,把报告和一小段有问题的码表样例交给维护者。不要反复盲目替换字符,也不要把未通过回读校验的文件当作正式码表。

批量处理(可选)

在工具所在目录打开终端,把下面的文件名换成自己的。建议先创建一个空的 converted 目录存放结果,避免覆盖先前输出。

.\MaQuanTableTool-Windows-0.1.0-x64.exe --check "我的码表.dict.yaml"
.\MaQuanTableTool-Windows-0.1.0-x64.exe --report "我的码表.dict.yaml"
.\MaQuanTableTool-Windows-0.1.0-x64.exe --rescue "我的码表.dict.yaml" --out .\converted
.\MaQuanTableTool-Windows-0.1.0-x64.exe --check .\converted\我的码表.mb

命令行救急的退出码也会计入原文件的问题;完成后请对新文件再运行 --check,并查看实际报告。下载遇到安全提示时先核对官网来源及 SHA-256,不要关闭系统安全保护。

← 返回使用说明