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
羽毛球分组比赛记分
小程序二维码

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

小夜