From 5491409003ff1ca6c04b9448adb9278291b0d726 Mon Sep 17 00:00:00 2001 From: Leo Date: Tue, 7 Jul 2026 08:06:28 +0000 Subject: [PATCH] =?UTF-8?q?docs(mcp):=20README=20=E5=8A=A0=E3=80=8C?= =?UTF-8?q?=E6=9B=B4=E6=96=B0=20/=20acr=20update=E3=80=8D=E6=AE=B5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - acr update：self-hosted 重跑部署、只部署變動 Worker、未變動略過（--force 全部重部）。 - 說明「新裝 vs 更新」差不多同一套流程，拿新零件(如 code)/新版就跑更新。 - 標待核佔位：下載源正從 GitHub codeload 改指 Gitea（Arcrun#4），確切行為待該 PR 定案。 Co-Authored-By: Claude Opus 4.8 --- mcp/README.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/mcp/README.md b/mcp/README.md index c9bc48b..e93f1ea 100644 --- a/mcp/README.md +++ b/mcp/README.md @@ -106,6 +106,24 @@ Claude Desktop 的 `claude_desktop_config.json`（macOS：`~/Library/Application --- +## 更新（取得新零件 / 新版） + +**更新流程 ≈ 重跑一次部署，已安裝的自動略過。** self-hosted 用戶要拿新零件（例如新增的 `code` 零件）或新版引擎時： + +```bash +acr update +``` + +`acr update` 會下載最新的 Arcrun 部署物，只**部署新增 / 變更的 Worker，未變動的自動跳過**（終端會顯示「N 個未變動已跳過」）。它與 `acr init --self-hosted` 走同一條路（下載 → 注入 KV id → `wrangler deploy`），差別只在：`init` 是首次（建 KV / R2 + 寫 config），`update` 是沿用既有 config 重部署有變動的 Worker。所以「新裝 arcrun」和「更新」其實**差不多同一套流程**——想拿新零件 / 新版就跑更新。 + +- 只在 **self-hosted 模式**可用（部署在你自己的 Cloudflare）；官方 SaaS 用戶由平台自動更新，不需要跑。 +- 要強制把**全部** Worker 重部署一遍：`acr update --force`。 +- 冪等：KV namespace / D1 等基礎設施已存在則重用，不會重建。 + +> ⚠️ **更新源現況（待核佔位）**：`acr update` 的下載源正從 GitHub codeload 改指 **Gitea 自有真身**（修復追蹤 Arcrun#4）。上面描述以「修好後的 Gitea 版」為準；確切指令與來源行為**待該修復 PR 定案**，屆時再回來校正。 + +--- + ## 認證 MCP 打進 arcrun ＝ 觸及該租戶 **KBDB 全量讀寫**，必須有真認證。中介層（`src/middleware/partner-auth.ts`）依序嘗試：