amenbo 2.0.0 — 插件:任务一动,你自己的程序就跑起来
装上插件,任务有动静时它就会跑。团队可以用自己的目录来分发插件。在 CLI 上,`--actor` 现在每条命令都必须写。
从这个版本起,任务有动静时可以跑你自己写的程序。CLI 的调用方式也有一处改动,以前能用的命令现在会被拒绝——升级前请先读“关于更新”。
插件
- 任务事件会调用你的程序——任务完成时、状态变化时、有人加评论时,插件就会跑。你也可以用
amenbo plugin run <name>自己跑一次。 - 从“市场”画面装,或者从命令行装——在 GUI 的“市场”画面里从官方目录挑一个,或者跑
amenbo plugin install <name>。今天那里有一个条目:worktree,它按任务切出 git worktree。 - 装上不等于打开——打开是另一步,
amenbo plugin enable <name>。这个开关是按项目还是按机器,由插件作者决定。 - 落地之前先验签名和校验和——验不过的东西不会被装上。
- 插件就是一个可执行文件——用什么语言写都行。amenbo 把它作为子进程启动,从标准输入把 JSON 递给它。见 如何写一个插件。
你能读到、设定和确认什么
- 打开一行,就知道自己要装的是什么——详情会在你安装之前告诉你,哪些事件会调用这个插件,装进来之后你得配置什么。
- 设置就是一张表单——作者在清单里声明的字段变成表单。密文字段会被遮住,项目也可以覆盖它需要的那些值。
amenbo plugin log——最近几次运行,带输出和退出码。插件没照你想的那样做时,先看这里。
用自己的目录分发插件
- 注册一个目录,它的插件就排在官方的旁边——
amenbo plugin catalog add <catalog.json 的 URL> --name "Team catalog",它们就出现在同一个列表里,随时可装。内部插件不必过官方目录也能分发。 - 一个目录就是三个静态文件——没有服务进程要跑。见 如何运营一个目录。
- 注册时把签名密钥钉住——注册时会给你看这个目录公布的密钥指纹,你同意就把它钉住。此后从那个目录装的插件都用这把密钥来验。密钥被换过的目录会被拒绝;不公布密钥的目录只能浏览。
- 每一行都带着它所属目录的名字——而且列表可以按来源筛选。“官方”标记只给官方目录里的条目:第三方目录自称官方,是拿不到这个标记的。
- 装上的插件记得自己从哪来——更新从那个目录取,所以别的目录里同名的东西绝不会被误取。
这个版本还有
- 在 GUI 上否决决定记录——在那里写下理由并否决。不必为此切到 CLI。
- 两个原本没有效果的设置现在有效果了——
default_view,启动时打开的视图;date_locale,日期的写法。 - 创建任务时就分类——
amenbo task add --dim <axis>=<value>。amenbo task show也会打印任务的分类。
关于更新
- 凡是碰存储的 CLI 命令,
--actor现在都必须写——它以前可以从AMENBO_ACTOR环境变量填进来,你什么都不写时也有默认值。从这个版本起你每次都要写:你在敲的时候写--actor human,AI 在敲的时候写--actor ai。比如amenbo task list --actor human。如果你以前是用环境变量设的,请把它挪到命令上。amenbo 放下的AGENTS.md和CLAUDE.md现在也把--actor ai写清楚了。GUI 那边什么都不变。 - 存储的数据格式往上抬——在这个版本上第一次启动时迁移,迁移前的备份会自动留一份。迁移之后,更早的版本就打不开它了。GUI 和 CLI 由同一个安装程序一起更新,所以别把其中一边留在旧版本上。
获取方式
从 最新版本 打开你所用操作系统的安装程序。GUI 和 CLI 装在一起,而且不需要管理员权限。
- macOS——
.pkg,Apple 芯片和 Intel 各一个(第一次打开会出现 Gatekeeper 提示:右键 →“打开”) - Windows——setup
.exe - Linux——
.deb/.rpm
更新方式:在 GUI 上,“有更新版本可用”的横幅现在会就地完成更新。如果你只装了 CLI,amenbo update --apply 会把它换掉。
第一次用?请看 开始使用。