amenbo

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.mdCLAUDE.md 现在也把 --actor ai 写清楚了。GUI 那边什么都不变。
  • 存储的数据格式往上抬——在这个版本上第一次启动时迁移,迁移前的备份会自动留一份。迁移之后,更早的版本就打不开它了。GUI 和 CLI 由同一个安装程序一起更新,所以别把其中一边留在旧版本上。

获取方式

最新版本 打开你所用操作系统的安装程序。GUI 和 CLI 装在一起,而且不需要管理员权限。

  • macOS——.pkg,Apple 芯片和 Intel 各一个(第一次打开会出现 Gatekeeper 提示:右键 →“打开”)
  • Windows——setup .exe
  • Linux——.deb / .rpm

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

第一次用?请看 开始使用