fix/scan-config-jsc-home-default-fallback #17

2026-08-26T04:27:21Z

jiantw83 commented

2026-08-26 04:27:21 +00:00

摘要

需求描述：scan-config.sh 的 expand() 展開 $JSC_HOME/... 這類設定值時，若使用者尚未設定 JSC_HOME 環境變數，展開結果會是空字串，導致 $JSC_HOME/* 開頭的設定列（例如 model-tags.tsv）被誤判為缺失或未設定；此次修正在展開子 shell 內補上文件記載的預設值 ~/.jsc，讓判定結果與實際生效路徑一致。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
tools/scan-config.sh	`expand()` 展開變數時，只在子 shell 內補上 `JSC_HOME` 的預設值 `~/.jsc`，讓 `$JSC_HOME/*` 開頭的設定列在未設環境變數時也能正確展開路徑並判定為 `ok`。
plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json	因應 scan-config.sh 的修正，將外掛版本由 0.1.3 升級至 0.1.4。

設計重點

預設值只在 expand() 內部的子 shell 用 : "${JSC_HOME:=$HOME/.jsc}" 賦值，不外流到主流程、不全域設定 JSC_HOME；這樣才不會連帶影響 JSC_HOME 這一列自己的檢查邏輯（該列仍要能正確回報「未設定，使用預設值」的狀態），只讓其他引用 $JSC_HOME/... 的設定列拿到正確的展開路徑。

測試結果

分別在 unset JSC_HOME 與 export JSC_HOME=/root/.jsc 兩種情況下執行 scan-config.sh 的 global 掃描，兩者輸出的 $JSC_HOME/model-tags.tsv 判定結果一致，皆為 ok。
確認 JSC_HOME 這一列自身的判定邏輯不受影響，在未設環境變數時仍正確回報為預設值狀態。

前置 Push Request

無

## 摘要 - 需求描述：`scan-config.sh` 的 `expand()` 展開 `$JSC_HOME/...` 這類設定值時，若使用者尚未設定 `JSC_HOME` 環境變數，展開結果會是空字串，導致 `$JSC_HOME/*` 開頭的設定列（例如 `model-tags.tsv`）被誤判為缺失或未設定；此次修正在展開子 shell 內補上文件記載的預設值 `~/.jsc`，讓判定結果與實際生效路徑一致。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | tools/scan-config.sh | `expand()` 展開變數時，只在子 shell 內補上 `JSC_HOME` 的預設值 `~/.jsc`，讓 `$JSC_HOME/*` 開頭的設定列在未設環境變數時也能正確展開路徑並判定為 `ok`。 | | plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json | 因應 scan-config.sh 的修正，將外掛版本由 0.1.3 升級至 0.1.4。 | ## 設計重點 - 預設值只在 `expand()` 內部的子 shell 用 `: "${JSC_HOME:=$HOME/.jsc}"` 賦值，不外流到主流程、不全域設定 `JSC_HOME`；這樣才不會連帶影響 `JSC_HOME` 這一列自己的檢查邏輯（該列仍要能正確回報「未設定，使用預設值」的狀態），只讓其他引用 `$JSC_HOME/...` 的設定列拿到正確的展開路徑。 ## 測試結果 - 分別在 `unset JSC_HOME` 與 `export JSC_HOME=/root/.jsc` 兩種情況下執行 scan-config.sh 的 global 掃描，兩者輸出的 `$JSC_HOME/model-tags.tsv` 判定結果一致，皆為 `ok`。 - 確認 `JSC_HOME` 這一列自身的判定邏輯不受影響，在未設環境變數時仍正確回報為預設值狀態。 ## 前置 Push Request - 無

jiantw83 added 2 commits 2026-08-26 04:27:22 +00:00

fix(cli): 展開 $JSC_HOME 時補上文件記載的預設值 ~/.jsc，避免 $JSC_HOME/* 設定列在未設環境變數時被誤判為缺失或未設定 7077d65766

chore(cli): 因應 scan-config.sh 修正，將外掛版本升級至 0.1.4 a2f1f65ff8

admin approved these changes 2026-08-26 04:34:03 +00:00

admin merged commit 2720bf4d33 into develop

2026-08-26 04:34:06 +00:00

admin deleted branch fix/scan-config-jsc-home-default-fallback

2026-08-26 04:34:06 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/cli#17