DSH VERIFY KIT · dsh-numberlint

文档内数字写法一致性检查

它决定一件事:同一数量在文档内是否只有一种写法。

检查规则

规则判定
thousands-inconsistent4,985 与 4985 同时出现 → warn,报两种拼写
percent-spacing58.6% 与 58.6 % 同时出现 → warn
range-dash区间连接号混用(11-02–08 与 11-02-08)→ warn

用法

npx numberlint report.md --json
npx numberlint report.md --warnings-fail

真实输入输出

输入
目录 4,985 个条目,我们实测了 4985 个。命中率 58.6%,另一处写 58.6 %。
$ numberlint report-numbers.md
warn thousands-inconsistent 4985 is written "4,985" and "4985" in the same document
warn percent-spacing 58.6% is written "58.6%" and "58.6 %"
ok: 0 errors, 2 warnings

出口码:0(警告不失败;--warnings-fail 时为 1)。输出为真实 CLI 运行的逐字结果,由测试与工具保持同步。

出口码:0 干净、1 有发现、2 用法或读文件错误。--json 输出机器可读结果,--warnings-fail 让警告也算失败。DSH 内同样的函数在 POST /numberlint/api({"text":"…"} 或 {"path":"…"}),面板与 CI 调同一实现,不可能不一致。

这是清单,不是专业人士。每条发现都是文件里可判定的结构缺陷,带行号或路径;它从不说「内容好不好」。
比较的是形态不是值:不同数量允许不同写法;带小数点的版本号不会被误判成千位分隔候选。 · dsh-verify-kit 全部五个检查