fix(codex-deploy): 保留舊 hooks 快取相容路徑 #38

2026-08-28T10:18:53Z

jiantw83 commented

2026-08-28 10:18:53 +00:00

摘要

需求描述：避免 Codex 更新 jsc-hooks 後，尚未重啟的工作階段仍用舊 hook_run_id，導致 Stop hook 找不到舊版快取路徑。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
`tools/deploy.sh`	Codex update 前記錄舊版 `jsc-hooks` cache 版本，update 後把消失的舊版路徑補成指向最新版的 symlink。
`skills/deploy/SKILL.md`	補上 Codex `compat` 輸出與舊快取相容連結規則。
`README.md`	補上部署流程會保留 Codex 舊快取相容連結。
`plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json`	同步 jsc-cli 版本。

設計重點

只在 Codex update 後保留 jsc-hooks 舊版 cache 路徑。
只把已消失或已是 symlink 的舊版路徑補成相容連結。
若舊版路徑仍是實體目錄，部署工具不覆蓋它。
新工作階段仍會載入新版 cache，不受相容連結影響。

測試結果

find tools -type f -name '*.sh' -exec sh -n {} \;：通過。
python3 -m json.tool plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json：通過。
git diff --check：通過。
./tools/deploy.sh -n update codex jsc-hooks：通過。
使用臨時 CODEX_HOME 與假的 codex 指令模擬舊版 cache 被移走：輸出 compat，且舊版路徑成功連到新版路徑。
/root/plugins/hooks/hooks/comment-scope.sh sweep：通過。

前置 Push Request

無

## 摘要 - 需求描述：避免 Codex 更新 `jsc-hooks` 後，尚未重啟的工作階段仍用舊 hook_run_id，導致 Stop hook 找不到舊版快取路徑。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `tools/deploy.sh` | Codex update 前記錄舊版 `jsc-hooks` cache 版本，update 後把消失的舊版路徑補成指向最新版的 symlink。 | | `skills/deploy/SKILL.md` | 補上 Codex `compat` 輸出與舊快取相容連結規則。 | | `README.md` | 補上部署流程會保留 Codex 舊快取相容連結。 | | `plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` | 同步 jsc-cli 版本。 | ## 設計重點 - 只在 Codex update 後保留 `jsc-hooks` 舊版 cache 路徑。 - 只把已消失或已是 symlink 的舊版路徑補成相容連結。 - 若舊版路徑仍是實體目錄，部署工具不覆蓋它。 - 新工作階段仍會載入新版 cache，不受相容連結影響。 ## 測試結果 - `find tools -type f -name '*.sh' -exec sh -n {} \;`：通過。 - `python3 -m json.tool plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json`：通過。 - `git diff --check`：通過。 - `./tools/deploy.sh -n update codex jsc-hooks`：通過。 - 使用臨時 `CODEX_HOME` 與假的 `codex` 指令模擬舊版 cache 被移走：輸出 `compat`，且舊版路徑成功連到新版路徑。 - `/root/plugins/hooks/hooks/comment-scope.sh sweep`：通過。 ## 前置 Push Request - 無

jiantw83 added 1 commit 2026-08-28 10:18:53 +00:00

fix(codex-deploy): 保留舊 hooks 快取相容路徑 90b89047e3

admin approved these changes 2026-08-28 10:24:49 +00:00

admin merged commit ca58604afc into develop

2026-08-28 10:24:55 +00:00

admin deleted branch fix/codex-cache-compat

2026-08-28 10:24:55 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/cli#38