release: v0.2.2 develop 到 master #29

2026-08-27T02:04:13Z

jiantw83 commented

2026-08-27 02:04:13 +00:00

摘要

需求描述：把 develop 的兩支新 hook 發佈到 master。comment-scope.sh 擋程式碼註解夾帶文件相關資訊，lang-guard.sh 擋非程式碼輸出出現簡體字與亂碼。另含 version-guard 的死鎖修正。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
`hooks/comment-scope.sh`	新增第六支 hook。三種模式：規則提示、單檔掃描、整個工作區掃描
`hooks/lang-guard.sh`	新增第七支 hook。偵測簡體字、亂碼、非 UTF-8
`hooks/simplified.txt`	機檢用簡體字表，1006 字。本存取庫是單一真實來源，`jsc-meta` 的 lint 也優先讀這份
`hooks/version-guard.sh`	把 `jsc-ask:ask` 與 `jsc-gitea:wiki` 加進豁免清單，解掉 deploy 死鎖
`hooks/hooks.json`、`tools/wire-cli.sh`、`tools/jsc-wrap.sh`	把兩支新 hook 接到五種 CLI 各自有的事件
`hooks/ste100-guard.sh`	注入文字補上適用範圍與編碼要求
`.gitignore`	忽略本機接線檔目錄 `.kiro/`
文件與三份 manifest	同步到七支 hook，升版到 0.2.2

設計重點

掃描時機依各 CLI 實際有的事件配，文件不假裝五支一樣：claude 每次寫檔逐檔精準；codex 每輪結束；kiro 每輪提示送出時掃上一輪；copilot 與 antigravity 只有工作階段結束時掃一次。
包裝器絕不吃掉 CLI 的結束碼：jsc-wrap.sh 先接住 CLI 的結束碼，掃描以 || true 執行，最後回傳原本那個碼。
字表寧可漏抓，不可誤報：刻意排除正體也在用的字（后、台、干、只、里、面、制、志、出、斗、丑、了、卷、咸、云、留、言、短、困、陷、游、封、吞）。
規則實作本身跳過掃描：字表、ste100-guard.sh、lang-guard.sh、ste100-lint.sh、references/ste100.md 裡的簡體字是被列舉的對象，不是被使用；不跳過的話 hook 每次先抓到自己，訊號被自己的噪音蓋掉。

測試結果

發佈前對 develop 樹重跑一輪，實測數據：

sh -n 語法檢查所有 shell 腳本：0 錯；所有 JSON 通過解析：0 錯
tools/wire-cli.sh smoke claude：status=ok，七支 hook 十三個接線模式全部 exit 0
結束碼保護實測：假 CLI exit 42 搭配必定命中的工作區，lang-guard.sh sweep 單跑回 2，jsc-wrap.sh 仍回傳 42
誤報防線實測：「后台干了只有里面制度志向出現北斗丑時保留語言短句困難陷阱游標封裝吞掉異常」零命中；重音拉丁文字（café、crème、câmara）不誤判成亂碼
覆蓋率：21 個常見簡體詞，舊的 102 字表抓到 4 個，現行 1006 字表抓到 21 個
誤報回歸：對 jsc 全部存取庫的既有正體中文語料掃描，誤報 0
ste100-lint.sh 與 lang-guard.sh 掃整個存取庫：皆 0 命中

前置 Push Request

無

## 摘要 - 需求描述：把 develop 的兩支新 hook 發佈到 master。`comment-scope.sh` 擋程式碼註解夾帶文件相關資訊，`lang-guard.sh` 擋非程式碼輸出出現簡體字與亂碼。另含 version-guard 的死鎖修正。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `hooks/comment-scope.sh` | 新增第六支 hook。三種模式：規則提示、單檔掃描、整個工作區掃描 | | `hooks/lang-guard.sh` | 新增第七支 hook。偵測簡體字、亂碼、非 UTF-8 | | `hooks/simplified.txt` | 機檢用簡體字表，1006 字。本存取庫是單一真實來源，`jsc-meta` 的 lint 也優先讀這份 | | `hooks/version-guard.sh` | 把 `jsc-ask:ask` 與 `jsc-gitea:wiki` 加進豁免清單，解掉 deploy 死鎖 | | `hooks/hooks.json`、`tools/wire-cli.sh`、`tools/jsc-wrap.sh` | 把兩支新 hook 接到五種 CLI 各自有的事件 | | `hooks/ste100-guard.sh` | 注入文字補上適用範圍與編碼要求 | | `.gitignore` | 忽略本機接線檔目錄 `.kiro/` | | 文件與三份 manifest | 同步到七支 hook，升版到 0.2.2 | ## 設計重點 - **掃描時機依各 CLI 實際有的事件配，文件不假裝五支一樣**：claude 每次寫檔逐檔精準；codex 每輪結束；kiro 每輪提示送出時掃上一輪；copilot 與 antigravity 只有工作階段結束時掃一次。 - **包裝器絕不吃掉 CLI 的結束碼**：`jsc-wrap.sh` 先接住 CLI 的結束碼，掃描以 `|| true` 執行，最後回傳原本那個碼。 - **字表寧可漏抓，不可誤報**：刻意排除正體也在用的字（后、台、干、只、里、面、制、志、出、斗、丑、了、卷、咸、云、留、言、短、困、陷、游、封、吞）。 - **規則實作本身跳過掃描**：字表、`ste100-guard.sh`、`lang-guard.sh`、`ste100-lint.sh`、`references/ste100.md` 裡的簡體字是被列舉的對象，不是被使用；不跳過的話 hook 每次先抓到自己，訊號被自己的噪音蓋掉。 ## 測試結果發佈前對 develop 樹重跑一輪，實測數據： - `sh -n` 語法檢查所有 shell 腳本：0 錯；所有 JSON 通過解析：0 錯 - `tools/wire-cli.sh smoke claude`：`status=ok`，七支 hook 十三個接線模式全部 exit 0 - **結束碼保護實測**：假 CLI `exit 42` 搭配必定命中的工作區，`lang-guard.sh sweep` 單跑回 2，`jsc-wrap.sh` 仍回傳 42 - **誤報防線實測**：「后台干了只有里面制度志向出現北斗丑時保留語言短句困難陷阱游標封裝吞掉異常」零命中；重音拉丁文字（`café`、`crème`、`câmara`）不誤判成亂碼 - **覆蓋率**：21 個常見簡體詞，舊的 102 字表抓到 4 個，現行 1006 字表抓到 21 個 - **誤報回歸**：對 jsc 全部存取庫的既有正體中文語料掃描，誤報 0 - `ste100-lint.sh` 與 `lang-guard.sh` 掃整個存取庫：皆 0 命中 ## 前置 Push Request - 無

jiantw83 added 20 commits 2026-08-27 02:04:13 +00:00

fix(version-guard): 把 jsc-ask:ask 與 jsc-gitea:wiki 加進豁免清單 0c83495ba8

What：版本守門 hook 的豁免清單新增 jsc-ask:ask 與 jsc-gitea:wiki 兩支技能，並在檔頭註解補上理由。

Why：jsc-cli:deploy 要問使用者 install/update/uninstall，一定會呼叫 jsc-ask:ask；ask 問完又一定寫回 wiki 才算完成。這兩支只要版本落後就被擋下，訊息還指回 /jsc-cli:deploy，deploy 卡在問不出模式那一步，形成死鎖，跟直接擋 deploy 是同一種問題。

How：在 case "$skill" 的豁免比對加上 jsc-ask:ask 與 jsc-gitea:wiki 兩個樣式，維持原本 exit 0 的略過行為；檔頭豁免清單註解同步補上兩條說明，講清楚死鎖成因。

Who：hooks/version-guard.sh 的外掛版本守門功能，影響 jsc-cli:deploy 的部署流程。

chore(gitignore): 忽略本機接線檔目錄 .kiro/ 961af918bf

What：在 .gitignore 的暫存分類底下新增 .kiro/ 一行，讓該目錄維持不追蹤。

Why：.kiro/ 是 jsc-hooks:hooks-install 在本機產生的接線檔，內容含本機絕對路徑。這種檔案因人而異，提交進存取庫會讓別人拉到錯的路徑，也會每次接線就冒出雜訊變更。

How：於 .gitignore 加上獨立註解區塊與 .kiro/ 樣式，只忽略不刪檔；本機既有目錄原地保留，git status 不再列出。

Who：hooks 存取庫的版本控管設定，配合 jsc-hooks:hooks-install 的接線產出。

feat(comment-scope): 新增註解範圍檢查 hook 並接進 claude 的 hooks.json f81ceaf145

What：新增第六支 hook `hooks/comment-scope.sh`，並在 `hooks/hooks.json` 補上兩個接線點：UserPromptSubmit 走 `prompt` 模式、PostToolUse 的 `Write|Edit|MultiEdit` 走掃描模式。

Why：程式碼註解常被寫進工單編號、專案代號、負責人這類文件相關資訊，讓註解變成過期文件。過去只能靠 `/jsc-review:code-review` 事後抓，回饋太慢；把規則搬到寫檔當下，模型可以立刻修正。

How：`prompt` 模式印出規則摘要注入提示。無參數模式從 stdin JSON 取 `file_path`（或環境變數 `JSC_CHANGED_FILE`），只掃 `git diff HEAD` 的新增行，不翻舊帳；markdown、純文字、資料檔與二進位檔一律跳過。命中就把警告與最多三行證據送到 stderr 並以 exit 2 交回模型就地修正，不擋寫入。逃生門為 `JSC_COMMENT_SCOPE=off`。規則正文的唯一來源在 `jsc-review` 的 `references/comment-scope.md`，本存取庫不留副本。

Who：`jsc-hooks` 的 hook 層，服務 `jsc-hooks:hooks-install` 的接線流程與 `jsc-review:code-review` 的註解契約檢查。

feat(wire-cli): 接線腳本納入註解範圍 hook，五支改六支 e2232d26f1

What：`tools/wire-cli.sh` 新增 `comment_scope_text()`、`rules_text()` 與 `has_comment_scope()` 三個函式，把 `comment-scope.sh` 的 `prompt` 模式接進 codex、copilot、antigravity 的規則檔與 kiro 的 hook JSON，`smoke` 與 `status` 兩個子命令也補上這支 hook，全腳本由五支 hook 改口徑為六支。

Why：`hooks/hooks.json` 只服務 claude；其他四個 CLI 要靠這支腳本接線，不改就完全接不到新規則。`smoke` 與 `status` 不同步補上，接線成功與否也驗不出來。

How：`comment_scope_text()` 直接取 `comment-scope.sh prompt` 的實際輸出當規則文字，不在本存取庫留規則清單副本；`rules_text()` 把 STE100 與註解範圍併進同一個 `<!-- jsc-hooks -->` 標記段落，重跑等同先移除再重裝；`has_comment_scope()` 供 `status` 判斷標記段落在不在。`smoke` 把 `comment-scope.sh` 無參數模式的 exit 2 視為設計行為，與 `sdlc-gate.sh check` 同列例外。

Who：`jsc-hooks` 的接線工具層，供 `jsc-hooks:hooks-install` 與 `jsc-hooks:repair` 呼叫。

feat(hooks-install): 文件同步六支 hook 與降級說明 5d60e0f231

What：`skills/hooks-install/SKILL.md`、`README.md`、`AGENTS.md` 三份文件一併改口徑為六支 hook，補上 `comment-scope.sh` 的職責、兩種模式、環境變數 `JSC_COMMENT_SCOPE` 與 `JSC_CHANGED_FILE`，以及各 CLI 的覆蓋範圍差異。

Why：文件停在五支會誤導操作者，讓人以為每個 CLI 都受同等保護。實際上只有 claude 有 post-tool hook，其他四個 CLI 只接得到規則提示，這個落差必須據實寫明。

How：SKILL.md 的 `description` 與正文加上 comment scope scanner，並註明 exit 2 在冒煙測試裡算健康；README.md 的 hook 表格新增一列，接線工具那列改寫 `smoke` 的例外說明，環境變數表補兩列，另加一段講明四個 CLI 的降級實情；AGENTS.md 新增一條規則，寫明規則正文的唯一來源在 `jsc-review`，本存取庫不留副本。

Who：`jsc-hooks` 的文件層與 `hooks-install` 技能，供操作者與後續 sub agent 依循。

feat(manifest): 三份 manifest 版本升到 0.1.9 7690b697c7

What：`plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 三份 manifest 的 `version` 由 0.1.8 升到 0.1.9。

Why：本次新增了第六支 hook，屬於功能增修。版本不升，`version-guard.sh` 的版本前置檢查與 `jsc-cli:deploy` 的更新判斷都看不出本機落後，使用者不會收到更新提示。

How：三份檔案同步改同一個版本號，維持三份 manifest 版本一致的既有慣例。

Who：`jsc-hooks` 的發佈中繼資料，供 `hooks/version-guard.sh` 與 `jsc-cli:deploy` 比對版本。

Merge pull request 'fix/version-guard-exempt-ask-and-wiki' (#25 ) from fix/version-guard-exempt-ask-and-wiki into develop a4996064ff

Reviewed-on: #25

Merge pull request 'feat/comment-scope-hook' (#26 ) from feat/comment-scope-hook into develop 8f98e42171

Reviewed-on: #26

feat(comment-scope): 新增 sweep 模式，掃整個 git 工作區 8ede74e9e2

What：`hooks/comment-scope.sh` 由兩種模式變三種，新增 `sweep [dir]`：掃整個 git 工作區這次改過的所有檔案，命中就把報告與最多三行證據送到 stderr 並 exit 2，找不到 git 就安靜 exit 0。`prompt` 與無參數單檔掃描兩個模式的判定邏輯一行不動。

Why：只有 claude 有 PostToolUse，拿得到「剛剛寫了哪個檔」。codex、copilot、antigravity、kiro 四個 CLI 都沒有 post-tool 事件，註解範圍檢查在那邊只剩規則提示，違規註解寫進去了不會有人叫。改掃整個工作區的 git diff，時機晚一點，涵蓋範圍一樣。

How：單檔判定抽成 `scan_file()`，兩種掃描模式共用同一份禁止樣式與白名單，不會各自漂移。`sweep` 以 `git rev-parse --show-toplevel` 找庫根，所以在子目錄跑也掃得到整個庫；逐檔報告累積在暫存檔再一次輸出，因為迴圈跑在管線的子行程裡，變數帶不回本 shell。

Who：`jsc-hooks` 的 hook 實作層，供 `tools/wire-cli.sh` 接線給 codex、copilot、antigravity、kiro 四個 CLI 使用。

feat(wire-cli): 把 comment-scope sweep 接到其餘四個 CLI 0bebdef46f

What：`tools/wire-cli.sh` 把 `comment-scope.sh sweep` 接進 codex 的 `config.toml` 根層 `notify` 與 kiro 的 `.kiro/hooks/jsc-hooks.json` 的 `userPromptSubmit`；`tools/jsc-wrap.sh` 在 CLI 結束後、回傳結束碼之前跑一次 sweep，涵蓋 copilot、antigravity 與同樣走包裝器的 codex。`smoke` 多跑一輪 sweep，`status` 多盤點 codex 的 `notify-sweep` 與 kiro 的 `comment-scope-sweep` 兩項。

Why：這四個 CLI 沒有 post-tool hook，接不到逐檔即時掃描，先前只寫得進規則提示，違規註解寫進去沒有人叫。接上 sweep 之後五個 CLI 都掃得到，差別只剩回饋速度。`smoke` 與 `status` 不同步補上，就驗不出來接線少了哪一支。

How：codex 的 notify 串成 `start; mark; sweep`，位置仍由 `replace_block_toml` 保證落在第一個表頭之前，寫入後除了既有的根層鍵檢查，再 grep 一次確認 sweep 真的串進那一行。kiro 的 `run` 尾端接上 sweep，`prompt` 與 `sweep` 各驗一個 grep，只驗腳本名會漏掉少接的那一個。`jsc-wrap.sh` 的 sweep 加 `|| true` 接住 exit 2，包裝器一律原樣回傳 CLI 自己的結束碼——包裝器改掉結束碼，呼叫端的 `cmd && next` 就會誤判。`smoke` 的 exit 2 白名單由「無參數模式」放寬到「所有掃描模式」，因為 sweep 在髒工作區本來就會回 2，那是 hook 正常工作，不是 hook 壞掉。四個 CLI 的 `reason` 與 `[jsc]` 說明改寫成各自真正的掃描時機。

Who：`jsc-hooks` 的接線工具層，供 `jsc-hooks:hooks-install` 與 `jsc-hooks:repair` 呼叫，最終服務 codex、copilot、antigravity、kiro 的使用者。

docs(hooks-install): 據實寫明各 CLI 的註解範圍掃描時機 b23c546079

What：`skills/hooks-install/SKILL.md`、`README.md`、`AGENTS.md` 三份文件一併改寫註解範圍的覆蓋範圍說明：`comment-scope.sh` 由兩種模式改為三種，並以表格列出五個 CLI 各自的掃描時機——claude 逐檔即時（PostToolUse）、codex 每輪結束（`notify`）、kiro 每輪提示送出時（`userPromptSubmit`，掃的是上一輪寫的檔）、copilot 與 antigravity 只有工作階段結束時由 `tools/jsc-wrap.sh` 收尾掃一次。README 的 `tools/jsc-wrap.sh` 那列補上收尾 sweep 與「不影響結束碼」的約定，`smoke` 例外說明改成掃描模式通用。

Why：舊文件寫的是「四個 CLI 只剩規則提示」，接上 sweep 之後那句話已經不實。但也不能倒過來寫成五支一樣：時機差一輪或差一整個工作階段，操作者要知道自己現在用的 CLI 什麼時候才會收到警告。文件不同步，操作者會對保護程度有錯誤預期。

How：SKILL.md 全份維持英文，正文改用一張 CLI 對掃描時機的表格，並註明 sweep 讀的是 `git diff HEAD`、涵蓋範圍與 claude 相同、不在 git 工作區內就安靜 exit 0，frontmatter 的 `description` 不動；README.md 維持 STE100 繁中，hook 一覽表那列補上三種模式與各 CLI 時機，原本的降級段落換成同一張表；AGENTS.md 的第 5 條補上三種模式與「不得寫成五支一樣」的要求。

Who：`jsc-hooks` 的文件層與 `hooks-install` 技能，供操作者與後續 sub agent 依循。

feat(manifest): 三份 manifest 版本升到 0.2.0 542f0aab2c

What：把 plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 三份
manifest 的版本由 0.1.9 升到 0.2.0。

Why：0.1.9 已隨前一支 PR 發佈出去，本次新增的 sweep 模式與四支 CLI 的接線
沒有跟著升版，version-guard.sh 就看不出本機落後，使用者不會收到更新提示。

How：以 jsc-meta 的 sync-skill-manifest.sh 統一 bump，minor 進位、patch 歸零，
三份同步成同一個值。

Who：註解範圍檢查 hook 的跨 CLI 支援。

Merge pull request 'feat/comment-scope-sweep-all-clis' (#27 ) from feat/comment-scope-sweep-all-clis into develop 2f74d6473c

Reviewed-on: #27

feat(lang-guard): 新增第七支 hook，強制非程式碼輸出繁中無亂碼 e3a9c67781

What：新增 `hooks/lang-guard.sh` 與機檢字表 `hooks/simplified.txt`。腳本比照 `comment-scope.sh` 的結構，一樣三種模式：`prompt` 注入規則摘要、無參數掃剛寫入的單一檔案、`sweep [dir]` 掃整個 git 工作區這次改過的檔案。偵測三項：簡體字、亂碼（U+FFFD 與雙重編碼殘骸）、非 UTF-8 編碼。命中走 stderr 並 exit 2，資料不足或找不到 git 一律安靜 exit 0，逃生門 `JSC_LANG_GUARD=off`。

Why：使用者新增的規則是「非程式碼的輸出一律套用繁中無亂碼」，範圍涵蓋程式碼註解、commit 訊息、PR 描述、wiki 頁、對使用者的回報與各種文件。這條規則原本只有 `ste100-guard.sh` 的提示層，模型看得到卻沒有人檢查，寫出簡體字或亂碼不會有任何回饋。提示層擋不住的事，就要有機檢層。

How：簡體字樣式由字表組出，字表是單一真實來源，腳本裡不留第二份；字表讀不到就安靜跳過這一項，不中斷整支腳本。亂碼一律用位元組比對（`LC_ALL=C`），不靠語系的字元範圍，因為 `grep -E` 的字元範圍在不同語系下行為不一致。掃描深度沿用 `comment-scope.sh`：檔案已追蹤就只掃 `git diff HEAD` 的新增行，不翻舊帳。二進位檔只認 NUL 位元組判定，不拿「非可列印字元」當判準，那會把所有含中文的檔案誤判成二進位。字表刻意排除繁體也在用的字（后、台、干、只、里、面、制、志），並跳過 `simplified.txt`、`ste100-guard.sh`、`lang-guard.sh` 三份以簡體字與亂碼為討論對象的檔案，避免整支 hook 每次先抓到自己。

Who：`jsc-hooks` 的 hook 實作層，供 `hooks/hooks.json` 與 `tools/wire-cli.sh` 接線給五個 CLI 使用。

feat(wire-cli): 把 lang-guard.sh 接到五個 CLI 的既有時機 bbad6566f7

What：`hooks/hooks.json` 的 `UserPromptSubmit` 加 `lang-guard.sh prompt`、`PostToolUse` 的 `Write|Edit|MultiEdit` 加無參數模式；`tools/wire-cli.sh` 把 codex 的 `notify`、kiro 的 `userPromptSubmit` 串上 sweep，規則檔文字加上 `lang-guard.sh prompt` 的輸出，`smoke` 三種模式各跑一輪，`status` 補盤點項，寫入後驗證一併涵蓋；`tools/jsc-wrap.sh` 收尾再跑一次 sweep；`hooks/ste100-guard.sh` 的注入文字補上適用範圍與 UTF-8 無亂碼。

Why：hook 寫好了不接線等於沒寫。接的位置與 `comment-scope.sh` 完全一樣，因為兩支要解的是同一個問題——只有 claude 有 post-tool hook，其餘四個 CLI 拿不到「剛剛寫了哪個檔」，只能改掃整個工作區。各 CLI 的掃描時機本來就不同：claude 逐檔即時、codex 每輪結束、kiro 每輪提示送出時、copilot 與 antigravity 只有工作階段結束，回報時不能寫成五支一樣。

How：規則檔文字取 `lang-guard.sh prompt` 的實際輸出，不在接線腳本裡抄一份規則，抄了兩邊就會各自漂移。寫入後以 `has_lang_guard()` 比對腳本第一行實際輸出，確認規則檔真的收到那一段。`smoke` 沿用既有的 exit 2 例外：掃描模式掃到違規回 2 是設計行為，不是執行期錯誤。`jsc-wrap.sh` 的 sweep 一律加 `|| true`，包裝器原樣回傳 CLI 自己的結束碼——包裝器改掉結束碼，呼叫端的 `cmd && next` 就會誤判。

Who：`jsc-hooks` 的接線層，由 `hooks-install` 技能對 claude、codex、copilot、antigravity、kiro 五個 CLI 執行。

feat(hooks-install): 文件同步到七支 hook fe3c5723a5

What：`README.md` 的 hook 一覽表新增 `lang-guard.sh` 一列（事件、三種模式、逃生門），所有「六支 hook」改七支，環境變數表補 `JSC_LANG_GUARD`，`tools/jsc-wrap.sh` 那列補收尾 sweep；`skills/hooks-install/SKILL.md` 六支改七支並補覆蓋範圍與備註，`description` 的括號清單加上這支；`AGENTS.md` 清單同步，並新增一條繁中無亂碼規則。

Why：文件寫六支、實際跑七支，使用者與 sub agent 都會照文件辦事，少接的那一支永遠沒有人發現。`AGENTS.md` 是各 CLI 讀得到的規則檔，新規則不寫進去就只剩 hook 在擋，模型自己不會知道。

How：README 維持 STE100 繁中；SKILL.md 維持整份英文，`description` 保持 4 句、保留觸發時機。規則正文一律不在本存取庫留副本，只指向 `jsc-meta` 的 `references/ste100.md`，字表位置指向 `hooks/simplified.txt`。

Who：`jsc-hooks` 的文件層，讀者是使用者與執行 `hooks-install` 的 sub agent。

feat(manifest): 三份 manifest 版本升到 0.2.1 aee2f19699

What：把 `plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 三份 manifest 的版本由 0.2.0 升到 0.2.1。

Why：0.2.0 已隨前一支 PR 發佈出去，本次新增的第七支 hook 與五個 CLI 的接線沒有跟著升版，`version-guard.sh` 就看不出本機落後，使用者不會收到更新提示。

How：以 jsc-meta 的 `sync-skill-manifest.sh` 統一 bump，patch 進位，三份同步成同一個值。

Who：繁中與編碼檢查 hook 的跨 CLI 支援。

feat(simplified): 字表擴充到 1006 字並補齊跳過清單 75fba4715c

What：簡體字表由 102 字擴充到 1006 字；lang-guard.sh 的跳過清單補上
jsc-meta 的 references/ste100.md 與 tools/ste100-lint.sh。

Why：102 字的舊表覆蓋率太低——拿 21 個常見簡體詞實測只抓到 4 個，「简体字」
「举办」「觉得」「战争」「医药」這類全部漏掉，規則等於形同虛設。跳過清單則是
對稱性問題：規則文件與機檢工具本身會列舉簡體字當範例，不跳過就每次先抓到自己。

How：字表逐字檢查「簡化後才出現的字形」，剔除正體也在用的字（后、台、干、只、
里、面、制、志、出、斗、丑、了、卷、咸、云、留、言、短、困、陷、游、封、吞），
再拿 jsc 全部 11 個存取庫共 221 個檔案的既有正體中文語料回歸驗證，誤報為零。
檔頭寫明排除原則與「改完必須拿語料重驗」的要求。跳過清單比照 ste100-lint.sh 的做法。

Who：非程式碼輸出的繁中無亂碼檢查。

feat(manifest): 三份 manifest 版本升到 0.2.2 667b60c8e9

What：三份 manifest 由 0.2.1 升到 0.2.2。

Why：字表擴充後偵測能力大幅改變，本機沒跟著升版，version-guard.sh 就判不出落後，
使用者不會收到更新提示，繼續用覆蓋率只有兩成的舊字表。

How：以 jsc-meta 的 sync-skill-manifest.sh 統一 bump，三份同步成同一個值。

Who：非程式碼輸出的繁中無亂碼檢查。

Merge pull request 'feat/lang-guard-traditional-chinese-encoding' (#28 ) from feat/lang-guard-traditional-chinese-encoding into develop 9875f917bf

Reviewed-on: #28

admin approved these changes 2026-08-27 02:07:46 +00:00

admin merged commit 7110caedb3 into master

2026-08-27 02:07:49 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/hooks#29