diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index 5f13f85..ca1c8e5 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "jsc-cli",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "CLI 偵測、模型能力標籤、子代理派工與技能庫批次部署",
   "skills": "./skills",
   "author": {
diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
index e73b34e..d2b6bdc 100644
--- a/.codex-plugin/plugin.json
+++ b/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "jsc-cli",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "CLI 偵測、模型能力標籤、子代理派工與技能庫批次部署",
   "skills": "./skills"
 }
diff --git a/plugin.json b/plugin.json
index ce80adb..37ea632 100644
--- a/plugin.json
+++ b/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "jsc-cli",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "CLI 偵測、模型能力標籤、子代理派工與技能庫批次部署",
   "skills": "./skills/"
 }
diff --git a/tools/deploy.sh b/tools/deploy.sh
index 62e2dc5..d52a02a 100755
--- a/tools/deploy.sh
+++ b/tools/deploy.sh
@@ -132,6 +132,12 @@ marketplace_cli() { # $1=執行檔
   esac
 }
 
+# codex 沒有 plugin update 子指令，只有 add、list、marketplace、remove。
+# marketplace upgrade 只重抓 marketplace 快照，而 jsc 的 marketplace.json 只列各網域的
+# git URL、不含版本，所以那份檔案內容不會變，codex 一律回「already up to date」並結束碼 0。
+# 已安裝外掛的版本是 plugin add 當下決定的，快取不會被連帶重抓——換句話說，只跑
+# marketplace upgrade 的話，指令全部成功而版本一個都沒動，是最難察覺的那種失敗。
+# 正確做法是照樣逐網域 plugin add：codex 的 add 會就地升級到快照裡的最新版。
 deploy_codex() {
   bin=$(cli_bin codex)
   case "$MODE" in
@@ -141,6 +147,7 @@ deploy_codex() {
       ;;
     update)
       run "$bin" plugin marketplace upgrade jsc
+      for d in $DOMAINS; do run "$bin" plugin add "jsc-$d@jsc"; done
       ;;
     uninstall)
       for d in $DOMAINS; do run "$bin" plugin remove "jsc-$d@jsc"; done