chinese-script-policy:在 DSH 里约束与转换中文书写

前言

在 DeepSeek Harness(DSH)或智能体工作流里,模型输出的中文往往混用繁简、夹杂粤语口语写法,或混入日文新字体与日语词。项目若要求统一用繁体(或简体)书面语存储与发布,单靠提示词很难稳定;事后人工扫一遍又成本高。下面介绍社区插件 chinese-script-policy:同一套逻辑既可作 DSH 插件做写入前检查,也可离线转换,且不依赖运行时拉取 OpenCC 等外部表。

这是什么

chinese-script-policy 由维护者 KSF1216 发布,仓库为 KSF1216/chinese-script-policy。README 将其定位为 harness-neutral 工具:同一代码库同时是 DSH bundle、Agent Skill、npm 包、CLI 与 Web 库,没有单独的「DSH 构建」与「通用构建」,避免两套实现漂移。

它解决两类问题:检查你指定的中文书写是否符合目标(并可选过滤粤语口语与日文专用字词);转换繁简、粤语口语→书面语、日文新字体→中文等步骤均可按需单独开启。工具声明不主张某一种汉字体系「正确」,只按你设定的目标报告或改写。

核心功能

检查:一条书写轴 + 两个独立过滤轴

书写轴(二选一,不可同时开启):

  • 目标为 Traditional(繁体) 时,报告文中出现的 简体专用字形(README 记载共 2,637 个)。
  • 目标为 Simplified(简体) 时,报告 繁体专用字形(3,083 个)。

你指定目标,工具报告「不属于该目标」的字形。README 明确警告:切勿同时开启书写轴两个方向,否则几乎任何中文文档都会被判为不合规。

过滤轴(各自独立开关,与书写轴方向无关):

  • 粤语口语语域(Cantonese colloquial register)。
  • 日文专用字符与词(367 个新字体/国字 + 123 个日语词)。该轴用于捕获「看起来像中文、实际是日文」的内容;纯简体字表无法覆盖这类问题。

在 DSH 插件(Plugins 页卡片)上:书写轴可在 要求繁体(默认) / 要求简体 / 不检查 三者选一;粤语与日文过滤可分别关闭。CLI 默认 --variant traditional;离线网页默认勾选繁体方向及两个过滤;Claude Code 格式的 write hook 固定为「要求繁体」并启用两个过滤(无简体侧)。

转换:三步可选 + 用词偏好

转换分三个可独立执行的步骤(均需显式开启,无「全自动全改」默认):

步骤 CLI 示意 默认
繁 ↔ 简 --to-traditional / --to-simplified 须自选方向
粤语口语 → 书面语 --to-written 关闭
日文新字体 → 中文 --convert-japanese 关闭

可选 用词偏好(--wording,网页上为 checkbox,默认关闭):在字形转换之外,按目标书写体系选用本地词汇表(例如简体→繁体时 软件→軟體;繁体→简体时 軟體→软件)。关闭时仅做字形层转换(如 軟件 在繁体语境下可视为正确)。

其它已文档化能力

  • 单文件离线页 dist/tradzh.html:双击即用,无 Node、无上传、不修改原文文件。
  • 零运行时依赖:映射表以仓库内 JSON 编译进产物,dependencies 为空,结果不随本机是否安装 OpenCC 变化。
  • 自行识别 UTF-8、BOM、UTF-16、Big5、GB18030;无法判定编码时不静默猜测。
  • 同一决策函数用于 CLI、写入 hook、DSH 插件与网页,行为一致。

npm 包当前版本为 1.4.0(见 package.json),许可证 MIT。

安装与启用

DSH Web 侧安装(README 原文命令):

dsh plugin --profile web add chinese-script-policy

安装后可在 DSH Plugins 页找到该插件卡片,配置书写轴(繁体 / 简体 / 不检查)以及粤语、日文过滤开关。

若只需本地转换、机器无 Node 或不想开终端,可下载仓库中的 dist/tradzh.html 离线使用,无需安装。长期 CLI 或 CI 可使用 npx chinese-script-policy … 或 npm i -g chinese-script-policy(命令名 tradzh、chinese-script)。

典型用法

DSH 插件

  1. 执行上述 dsh plugin --profile web add chinese-script-policy。
  2. 打开 Plugins 页,按项目约定选择「要求繁体」或「要求简体」,按需关闭粤语/日文过滤。
  3. 与 DSH 写入流程配合,在内容落盘前由同一套规则拦截不合规字形或过滤轴命中项。

CLI 检查与转换(摘录 README 行为说明)

检查(默认繁体方向,粤语与日文需加 flag):

npx chinese-script-policy --variant traditional 你的文件.txt

需同时检查粤语书面语与日文时,CLI 分别需要 --written、--japanese(与 DSH 卡片默认全开不同,CLI 侧过滤要显式打开)。

繁体转换并启用用词偏好:

npx chinese-script-policy --to-traditional --wording 输入.txt

仓库内也可直接运行(已有本目录时无需全局安装):

node scripts/tradzh.js …

更完整的参数说明见仓库 CLI reference。

适用场景与注意

适合:必须区分繁体、简体、粤语口语写法与日文汉字的项目;需要在 DSH Web 界面用开关统一管理策略的团队;希望离线、可审计、无运行时依赖的繁简与语域转换。

注意:

  • 插件在 当前 dsh 进程权限 下运行;安装前请自行审阅 GitHub 源码 与 MIT 许可证。
  • 社区目录 SkillHub 插件页 与 DeepSeek / 幻方无官方从属关系;DSH 生态遵循「一切皆插件」,目录为独立社区站点。
  • 转换中的「粤语→书面语」只处理 不可能出现在书面语中的部分,其余仍可能需要模型或人工润色。
  • 含 intentional 日文引用的文档,不应默认开启 --convert-japanese,避免误改引用。

结尾

chinese-script-policy 把「按目标报告不合规中文」与「可选的多步离线转换」收进同一实现,DSH 侧一条命令即可接入 Web 配置卡片。需要进一步了解时,可看社区目录页与仓库 README(含 中文说明)。

  • 目录页:https://www.skillhub.cn/plugins/KSF1216/chinese-script-policy
  • GitHub:https://github.com/KSF1216/chinese-script-policy
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜