amenbo 10.0.0 — 外掛只搆得到觸發它的那一個專案

外掛拿到的是一扇窗，export、backup 與 restore 現在都到這扇窗為止。9.2.0 之前一直是那樣的行為，我們感到抱歉。amenbo agent --json 回傳的內容有一處形狀上的改動——升級前請讀更新那一節。

export、backup 與 restore 到外掛的那扇窗為止

amenbo 遞給外掛一扇窗：觸發它的那一個專案，除此之外什麼也沒有。到 9.2.0 為止，有三個指令沒有去看這扇窗。從外掛裡呼叫時，export、backup 與 restore 作用在這台裝置上的每一個專案上——而 restore 是寫入而不是讀取，所以它有可能把儲存的紀錄本身換掉。

在 10.0.0，這樣的呼叫會被拒絕。

Error: export acts on this whole device, and a plugin reaches only through the window it fires in (AMB-P-…) — a window no argument widens. Nothing outside it was yours to read or to replace: the ids in the payload name what you were launched for.

backup 與 restore 以同樣的方式拒絕。

您自己執行這些指令沒有改變，您託付了一個資料夾的 AI 也一樣。只有從外掛裡發出的呼叫會被拒絕。

一次匯出是同一瞬間的紀錄

匯出進行的當中，紀錄還是可以被加進來。到 9.2.0 為止，匯出開始之後才加上的評論有可能進到檔案裡，而它所掛著的那個任務卻沒有，於是留下一個指向了不在自己裡面的東西的檔案。在 10.0.0，匯出的整個檔案都是同一瞬間的紀錄。

外掛的指令出現在會用到它的那一步上

AI 要知道在一個資料夾裡該怎麼工作，讀的就是 amenbo agent --json。裝上並打開一個外掛，它的指令行現在就落在它該在的那一步上。以 worktree 外掛為例：

{
  "id": "cut-per-task",
  "step": "Cut a worktree per task, whenever the work will produce commits. ...",
  "tools": [
    "amenbo plugin run worktree start <task-id>"
  ]
}

AI 不必再自己想到了那一步該怎麼呼叫這個外掛——呼叫就寫在那一步上。

如果您已經裝了 worktree 外掛，amenbo plugin update worktree 會把它換掉。

短的 commit SHA 會被拒絕，並附上怎麼組出完整的那一個

amenbo task commit add 只收完整長度的 SHA。現在拒絕的訊息會帶上怎麼把短的展開成完整的。

$ amenbo task commit add AMB-T-… 4a73991 --actor ai
Error: a commit sha must be full-length lower-case hex (40 for SHA-1, 64 for SHA-256) — not a short sha, branch, tag or revision
Hint: `git log --oneline` prints the short form. Expand it with `git rev-parse <short sha>` and pass what that returns — amenbo never runs git itself.

更新之前

amenbo agent --json 回傳的內容有一處形狀上的改動。您遞給 AI 的指示不必改，因為那些指示本來就出自 amenbo agent --json。受影響的只有您自己那些去解析這份輸出的指令稿。

**agentCycle 從一串句子變成了一個物件。**它現在裝著 description——說明這些步驟該怎麼讀——以及 steps。每一步都帶著一個 id。

儲存的資料格式這次不變，所以上一個版本的資料可以原樣打開。

取得方式

請到 最新版本 打開您所用作業系統的安裝程式。不需要管理者權限。

• macOS——.pkg，Apple 晶片與 Intel 各一個（GUI 與 CLI 裝在一起；第一次打開會出現 Gatekeeper 提示：按右鍵 →「打開」）
• Windows——setup .exe（GUI 與 CLI 裝在一起）
• Linux——GUI 是 AppImage；amenbo 指令來自 CLI 的安裝程式

要更新時：在 GUI 上，「有更新版本可用」的橫幅會就地完成更新。如果您只裝了 CLI，amenbo update --apply 會把它換掉。

第一次用嗎？請看 開始使用。