agent-maestro-plugins

Maestro 的第三方插件集合。本仓库是 Cargo 多插件工作区：根 Cargo.toml 以 plugins/* 通配纳管成员，plugins/ 下每个子目录是一个自包含插件。

插件

插件	工具	说明
kimi-code	Kimi Code	把 Maestro 中录入的 Provider 投影进 ~/.kimi-code/config.toml
opencode	OpenCode	把 Maestro 中录入的 Provider 投影进 ~/.config/opencode/opencode.json
sourcegit	SourceGit	把 Maestro 中录入的 Provider 投影进 ~/.config/SourceGit/preference.json

仓库结构

plugins/kimi-code/
├── manifest.json        # 插件 manifest，entry 相对本目录解析
├── .cargo/config.toml   # 把构建产物固定到本目录的 target/
├── Cargo.toml           # crate maestro-plugin-kimi-code
├── README.md            # 插件说明（投影规则、设计要点）
└── src/lib.rs

plugins/opencode/、plugins/sourcegit/ 布局相同（crate 分别为 maestro-plugin-opencode、maestro-plugin-sourcegit，依赖换为 jsonc-parser；sourcegit 另有 tests/fixtures/ 存放脱敏的 preference.json 样本）。

SDK 统一锁定在根 Cargo.toml 的 [workspace.dependencies]（其余依赖由各插件自持），Cargo.lock 由工作区共享。

新增插件：复制 plugins/kimi-code 为 plugins/<id>，改写 crate 名、manifest.json 与 README 即可，工作区配置无需改动。

构建

工具链由根 rust-toolchain.toml 锁定（Rust 1.98.1 与 wasm32-wasip2 target），rustup 会自动切换到该工具链并补齐 target，无需手动 rustup target add。

必须在插件目录内构建：宿主按 manifest 所在目录解析相对 entry 且拒绝含 .. 的路径，产物须落在插件目录之内。工作区默认共享根 target/，各插件用 .cargo/config.toml 把自己的 target-dir 固定在本目录；Cargo 只在从该目录（或其子目录）调用时读取该配置，因此在仓库根构建的产物不会落在正确位置。

cd plugins/kimi-code
cargo build --release --target wasm32-wasip2

产物为 WASM 组件 plugins/kimi-code/target/wasm32-wasip2/release/maestro_plugin_kimi_code.wasm。SDK 依赖锁定 agent-maestro 的发布 tag，随 tag 固化与宿主的兼容组合。

本地调试

按 Maestro 插件作者指南的 file 来源回路：

1. 构建 wasm（插件 manifest 的 entry 已指向 cargo 产物路径）。
2. 在 Maestro「添加插件」选「本地文件」，选择 plugins/kimi-code/manifest.json。
3. 改码后重新构建，在 Maestro 点「重新加载」。

发布

每个插件独立发布，版本由发布 tag 锚定，Cargo.toml 不声明 version。发布通过 .github/workflows/release.yml 手动触发（仅 main 分支，不接受 push / tag 触发）：在 GitHub「Actions → Release plugin → Run workflow」选择插件（下拉项为 plugins/ 下的目录名，新增插件时需同步更新该可选项）并填写版本号（semver，如 0.1.0），workflow 会构建该插件（--release --target wasm32-wasip2）、打 tag <plugin-name>/v<semver>（如 kimi-code/v0.1.0）、起草 Release（草稿状态，资产名固定 plugin.wasm 与 manifest.json，后者由 jq 把插件 manifest.json 的 entry 改写为本 Release 的 wasm 资产 URL 生成）；确认无误后在 Releases 页手动发布草稿，用户即可用 …/releases/download/<plugin-name>/v<semver>/manifest.json 安装。tag 已存在时 workflow 失败，重发需先删除旧 tag 或升版本号。详细约定见插件作者指南。