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 會把它換掉。

第一次用嗎?請看 開始使用