From 98781a331fed225f35de6091d9ecc616f561b15c Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 27 Aug 2026 18:49:58 +0800 Subject: [PATCH] =?UTF-8?q?fix(deploy):=20=E9=83=A8=E7=BD=B2=E5=B7=A5?= =?UTF-8?q?=E5=85=B7=E7=9A=84=E9=87=8D=E5=95=9F=E7=8B=80=E6=85=8B=E6=AA=94?= =?UTF-8?q?=E8=B7=AF=E5=BE=91=E6=94=B9=E7=82=BA=E4=B8=80=E6=94=AF=20CLI=20?= =?UTF-8?q?=E4=B8=80=E4=BB=BD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit What：`tools/deploy.sh` 的 `restart` 那一行改印 `$JSC_HOME/restart-required.d/{CLI 代號}`，檔頭註解一併改寫成「轉呼叫 `restart-gate.sh require` 掛上這支 CLI 的閘門」。`tools/write-guides.sh` 產生的更新指引，狀態檔說明改成一支 CLI 一份、重啟只清自己那份、別支的閘門不受影響。`tools/config-spec.tsv` 的 `$JSC_HOME/restart-required` 那一列改成 `$JSC_HOME/restart-required.d` 目錄，說明改為「該 CLI 那份不存在代表這支沒有待重啟的部署」。 Why：`jsc-hooks` 這一輪把狀態檔改成一支 CLI 一份，路徑從單一檔案變成狀態目錄底下的一份。`deploy.sh` 印的是操作者接下來要看的檔案路徑，印錯就指向一個不存在的檔案；`write-guides.sh` 寫出的更新指引是下一輪部署的依據，留著舊路徑會讓人以為刪掉那個檔案就能解除閘門；`config-spec.tsv` 是 `/jsc-cli:doctor` 比對設定落點的依據，路徑對不上就查不到這份執行期暫態。 How：三處都只跟著改路徑與說明，掛閘門的動作本來就是轉呼叫 `jsc-hooks` 的 `restart-gate.sh require`，這裡不重寫一份判定，也不自己組狀態檔內容——路徑與格式的唯一來源留在 `restart-gate.sh`。`config-spec.tsv` 那一列的型別仍是 `global` 的執行期暫態、備份與還原都維持 `none`，欄位數不變。 Who：`jsc-cli:deploy` 的部署收尾與更新指引，對齊 `jsc-hooks` 一支 CLI 一份的重啟狀態檔。 --- tools/config-spec.tsv | 2 +- tools/deploy.sh | 8 ++++---- tools/write-guides.sh | 2 +- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/tools/config-spec.tsv b/tools/config-spec.tsv index 5a961e1..5dc1d64 100644 --- a/tools/config-spec.tsv +++ b/tools/config-spec.tsv @@ -50,7 +50,7 @@ $JSC_HOME/models.conf file global no - file ask 各 SDLC 階段的偏好模型 $JSC_HOME/html-styles.conf file global no - file ask 各類頁面的 HTML 匯出版型與樣式，專案 .jsc/html-styles 可覆寫 $JSC_HOME/update-guide.md file global no - file manual 這台機器的更新指引，由 jsc-cli/tools/write-guides.sh 產生；缺了就重跑 /jsc-cli:deploy $JSC_HOME/remove-guide.md file global no - file manual 這台機器的移除指引，由 jsc-cli/tools/write-guides.sh 產生；缺了就重跑 /jsc-cli:deploy -$JSC_HOME/restart-required file global no - none - 部署收尾寫下的重啟狀態檔，執行期暫態；不存在代表沒有待重啟的部署，jsc-hooks 讀它提示重啟 +$JSC_HOME/restart-required.d file global no - none - 部署收尾寫下的重啟狀態檔目錄，一支 CLI 一份，執行期暫態；該 CLI 那份不存在代表這支沒有待重啟的部署，jsc-hooks 讀它提示重啟 .jsc/models file project no - file ask 本專案的 SDLC 偏好模型鏈，覆寫 $JSC_HOME/models.conf .jsc/html-styles file project no - file ask 本專案的 HTML 匯出版型與樣式，覆寫 $JSC_HOME/html-styles.conf .claude/settings.json file project no - file manual claude 的專案層設定；jsc hook 由 plugin 的 hooks.json 接線，這裡不該有 jsc 殘留接線 diff --git a/tools/deploy.sh b/tools/deploy.sh index d4845f0..c1795fc 100755 --- a/tools/deploy.sh +++ b/tools/deploy.sh @@ -19,9 +19,9 @@ # kiro 的執行檔是 kiro-cli；先探測這個版本認不認得 plugin 子指令（部分版本已經完全 # 移除，例：2.18.1），認得才逐一嘗試、失敗才退回複製，不認得就整批直接走複製， # 不逐一撞一次「unrecognized subcommand」才退回。 -# install 或 update 全數成功時，收尾寫一行進 $JSC_HOME/restart-required，代表這台機器有一輪 -# 部署還沒重啟。擋人邏輯不在這裡：由 jsc-hooks 讀這個檔案提示使用者重啟，逃生門 -# JSC_RESTART_GATE=off 也由那邊判讀。 +# install 或 update 全數成功時，收尾轉呼叫 jsc-hooks 的 restart-gate.sh require，掛上這支 CLI +# 的重啟閘門（狀態檔一支 CLI 一份，落在 $JSC_HOME/restart-required.d/{cli}）。擋人邏輯不在 +# 這裡：由 jsc-hooks 讀該 CLI 那一份提示使用者重啟，逃生門 JSC_RESTART_GATE=off 也由那邊判讀。 # 更新指引與移除指引由同目錄的 write-guides.sh 產生，一輪部署跑一次，不在這支腳本裡： # 這支腳本的職責是「對單一 CLI 部署」，指引寫的是整台機器的樣貌。 # 環境變數： @@ -93,7 +93,7 @@ mark_restart() { return 0 fi if JSC_CLI="$CLI" sh "$rg" require "$MODE" $DOMAINS