插件和 marketplace
插件用于给 Axiomate 增加额外能力。一个插件可以带来新的斜杠命令、Skill、Agent、hook、MCP server、输出样式，或一组项目/领域相关的说明。
marketplace 是插件列表来源。Axiomate 从 marketplace 读取可安装插件，再把选中的插件安装到当前配置范围里。
什么时候需要插件
适合使用插件的场景包括：
- 想安装一组官方或社区提供的能力，而不是手写 Skill。
- 想接入某个完整工具链，例如设计、浏览器、代码审查或特定模型 CLI。
- 团队希望把命令、Agent、MCP server 和规则打包成统一分发的能力。
- 需要跨项目复用一套完整工作流。
如果只是想保存一段简单流程，通常优先用 Skill；如果需要安装一整套能力，再考虑插件。
官方 marketplace
Axiomate 会优先使用官方插件 marketplace。源码里的官方 marketplace 名称是：
claude-plugins-official
它的主源是：
anthropics/claude-plugins-official
Axiomate 也内置了 fallback 源：
axiomates/axiomate-plugins-official
因此，当安装或刷新官方插件时，实际可能会从 GitHub 上的官方 marketplace 仓库读取插件列表和插件内容。这个机制也解释了为什么安装 Axiomate 时推荐安装 Python：插件生态里可能包含 Python runtime、Python 工具或 MCP bundle；有 Python 的环境更容易直接运行这类插件。不是每个插件都需要 Python，但提前准备好可以减少后续安装插件时的环境问题。
打开插件管理界面
在 Axiomate 对话里输入：
/plugin
也可以使用别名：
/plugins
/marketplace
日常管理插件时，通常优先使用这个 TUI 界面。它可以浏览可用插件、管理已安装插件、添加 marketplace、查看错误和进行配置；下面列出的命令更适合需要精确输入、复用或排查问题时使用。
添加 marketplace
添加 GitHub marketplace：
/plugin marketplace add owner/repo
例如添加一个 marketplace 仓库：
/plugin marketplace add axiomates/axiomate-plugins-official
也可以添加其他来源：
/plugin marketplace add https://example.com/marketplace.json
/plugin marketplace add ./path/to/marketplace
源码支持的 marketplace 输入形式包括 GitHub owner/repo、Git SSH URL、HTTP/HTTPS URL、本地 .json 文件和本地目录。
安装插件
安装插件：
/plugin install <plugin-name>
如果多个 marketplace 里可能有同名插件，可以指定 marketplace：
/plugin install <plugin-name>@<marketplace-name>
例如：
/plugin install codex@openai-codex
安装后通常需要重新加载插件，让新增命令、Agent、MCP server 等能力进入当前会话：
/reload-plugins
有些插件还会提供初始化命令。例如 Codex 插件安装后会使用 /codex:setup 检查本机依赖和登录状态。
安装范围
插件安装支持不同 scope：
| scope | 命令示例 | 适合场景 |
|---|---|---|
user | /plugin install -s user <plugin> | 默认范围。安装给当前用户，多个项目都可用。 |
project | /plugin install -s project <plugin> | 写入项目配置，适合团队共享。 |
local | /plugin install -s local <plugin> | 只对当前项目本机生效，适合个人或临时配置。 |
如果不确定，通常使用默认的 user scope。
常用命令
| 命令 | 作用 |
|---|---|
/plugin | 打开插件管理界面。 |
/plugin list | 列出已安装插件。 |
/plugin list --available --json | 以 JSON 输出 marketplace 中可安装的插件。 |
/plugin marketplace list | 列出已配置 marketplace。 |
/plugin marketplace update | 刷新 marketplace；不带名称时刷新全部。 |
/plugin update <plugin> | 更新指定插件，通常需要重新加载后生效。 |
/plugin disable <plugin> | 禁用插件。 |
/plugin enable <plugin> | 重新启用插件。 |
/plugin uninstall <plugin> | 卸载插件。 |
插件和其他能力的关系
插件是一种打包和分发方式，可以把多种 Axiomate 能力放在一起安装。
常见关系包括：
- 和 MCP：插件可以声明 MCP server。安装并加载插件后，Axiomate 会读取插件里的 MCP 配置，把对应 server 加入 MCP 连接流程。如果插件带有 MCP server，可以在
/mcp里查看连接状态。 - 和 MCP bundle：有些插件会包含 MCP bundle（
.mcpb/.dxt）。这类 bundle 的 manifest 支持python、node、binary三种运行类型。因此，Python 并不是 Axiomate 本体运行的必需项，但会影响部分插件或 MCP bundle 是否能顺利运行。 - 和 Skills：Skill 是可复用的任务说明，通常用于保存一段明确流程。插件可以包含一个或多个 Skills，并把它们和 slash commands、Agents、hooks、MCP servers 等能力一起打包分发。插件安装并重新加载后，插件提供的 Skills 会和项目 Skill、用户 Skill 一起进入可用范围。
简单区分：只想保存一段项目或个人流程时，优先写 Skill；想安装一整套能力，或者团队要统一分发多种能力时，用插件。
安全建议
插件来自外部 marketplace，安装前应确认来源可信。建议：
- 优先使用官方或团队认可的 marketplace。
- 不要随意安装来源不明的插件。
- 团队共享插件时，避免把 token、私钥或个人路径提交到项目配置。
- 安装后如果出现异常，可先用
/plugin disable <plugin>禁用，再排查。