前言¶
在 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 插件¶
- 執行上述
dsh plugin --profile web add chinese-script-policy。 - 打開 Plugins 頁,按項目約定選擇「要求繁體」或「要求簡體」,按需關閉粵語/日文過濾。
- 與 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