amenbo 10.0.0 — 插件只够得着它被触发的那个项目

插件被给到一扇窗，export、backup 和 restore 现在都止步于它。对一直留到 9.2.0 的这个行为，我们深表歉意。amenbo agent --json 返回的内容有一处形状上的改动——升级前请读更新那一节。

导出、备份和恢复止步于插件的那扇窗

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 里，导出的整个文件都是同一个瞬间的记录。

插件的命令出现在用到它的那一步上

amenbo agent --json 是 AI 用来知道在一个文件夹里该怎么工作的东西。装上并启用一个插件，它的那些命令行现在就落在它们该在的那一步上。来自 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 会把它换掉。

第一次用？请看 开始使用。