chiang21fcb/cn-linebreak

README 摘要

cn-linebreak 中文网页文案断行审查与修复工具。把《中文网页文案断行修复指南》中的规则变成可执行检查： - 审查 ：检查 显式断行错误及高风险写法 ——由 形成的孤字行、"一个字+标点"单独成行、行首/行尾出现禁则标点、缺少 word-break: keep-all 、覆盖文本元素的全局 white-space: nowrap 、过长 .no-break 、长文案零换行点、保护词被换行拆开等。 - 修复 ：在 ，。；：、 等自然停顿处自动插入 （跳过 script/style/pre/code/textarea/title 与 .no-break 保护区域、保护词典命中位置），产出修复版 HTML 供人工复核。 - DSH 插件 ：同一个包也是 DeepSeek Harness 标准插件包（ dsh.bundle ），安装后代理可直接调用 cn linebreak audit 工具。 能力边界 ：本工具是 静态 审查器，只能看到 HTML 中已明确存在的 / 和文本/CSS 结构。它不能知道浏览器按真实字号、容器宽度渲染后的实际换行结果——"识别真实渲染后的孤字行"与"识别浏览器自动切开的词组"属于路线图 v0.4.0 的渲染模式能力，详见 docs/RULES.md。 核心原则（摘自指南）：中文断行不应由浏览器按单字随机决定；应先划分语义单元，再明确"可断、必断、不可断"三类边界。 = 可断， = 必断， .no-break = 不可断。 零依赖，纯 JavaScript（CommonJS + 一个 ESM 插件入口），Node ≥ 18。 快速开始 尚未发布到 npm 时，可用 git 直装： CLI 选项 作用 --fix 审查并把修复后 HTML 输出到 stdout；审查摘要与修复后复审结果输出到 stderr（不污染重定向） --json 输出完整 JSON 报告（ ok / summary / issues / css / stats / fixedHtml ） --output 把结果写入文件（ --fix 写修复后 HTML；否则写报告），stdout 保持干净 --strict 警告也视为失败（影响退出码） --config 读取 JSON 配置（见 docs/CONFIGURATION.md） --help / --version 帮助 / 版本 退出码： 0 =通过， 1 =发现错误（ --strict 时含警告）， 2 =参数错误， 3 =读取/解析失败。 API 低层函数： insertWbr(html, { config }) 、 auditCss(html) 、 collectElements(html) 、 normalizeConfig(config) 、 buildProtectedSpans(html, ph…

分类