amenbo 3.0.0 — 插件按项目打开，它的设置也随备份一起走

插件现在一次打开一个项目，它们的设置放在哪里也变了。升级前请读更新那一节。

插件的开关，一个项目一个

• 按设备的开关没了——以前有两种开关：一种按项目打开，一种对整台设备打开，插件拿到哪一种由作者决定。现在每个插件都只有一个按项目的开关。
• 那一行写出它在哪些项目里跑——你看到的不是“是/否”，而是这个插件跑起来的那些项目的名字。关掉一个，你还看得见它在别的项目里跑着。一个名字都没列出，就是哪里都不跑。
• 也可以从项目的设置里开关——从两头都到得了同一个开关：“这个插件在哪些项目里跑”和“这个项目跑哪些插件”。你不必再翻插件列表去关掉什么。
• 安装时不再问项目——安装不瞄准任何项目，所以它不问。画面会说现在什么都还没跑，以及在哪里打开它。
• 打开它本身就是允许它跑——单独的同意提示没有了。
• CLI 也会写出项目——amenbo plugin list 的每一行都显示这个插件跑起来的那些项目。amenbo plugin enable / disable 动的是你所在文件夹那个项目的开关。

设置和密文现在随备份一起走

• 还原之后它们是能用的——从备份还原以前，回来时设置没了，每个凭据都得重新输一遍。现在备份会带上插件的全部状态。
• 值属于项目——amenbo plugin config set / get 上的 --scope 没了；它们读写的是你所在文件夹那个项目的值。GUI 里的设置表单编辑的是它正显示的那个项目。

插件的帮助现在来自插件

amenbo plugin run <name> --help 现在打印那个插件自己的用法。它以前递回来的是 amenbo 自己的文字，所以你没有办法知道一个插件怎么用。

名字之后的每一个词都属于插件。给 amenbo 自己的选项（比如 --actor）写在名字之前。

amenbo --actor ai plugin run worktree --help

Linux 的 CLI 在较旧的发行版上也能跑

amenbo 命令在 Ubuntu 22.04 这类稍旧的发行版上起不来。GUI（AppImage）在那里跑得动，所以你可能在同一台机器上只有一半能用。

更新之前

• 存储的数据格式往上抬——新版本第一次打开它时会自动迁移，迁移前先做备份。之后更旧的版本就打不开了，所以别把 GUI 或 CLI 留在旧版本上（同一个安装程序会更新两边）。
• 原来对整台设备打开的插件，会挪到按项目——原本在那台设备上每个项目里都跑的东西，会在每个项目里都以打开的状态出现。把你不想要的关掉。
• 如果你在传 --scope，把它去掉——amenbo plugin config set / get 不再接受它。

获取方式

从 最新版本 打开你所用操作系统的安装程序。不需要管理员权限。

• macOS——.pkg，Apple 芯片和 Intel 各一个（GUI 和 CLI 装在一起；第一次打开会出现 Gatekeeper 提示：右键 →“打开”）
• Windows——setup .exe（GUI 和 CLI 装在一起）
• Linux——GUI 是 AppImage；amenbo 命令来自 CLI 的安装程序

更新方式：在 GUI 上，“有更新版本可用”的横幅会就地完成更新。如果你只装了 CLI，amenbo update --apply 会把它换掉。

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