KeyInfo Bot
59c6b9f6cb
Constraint: Keep the official Superpowers plugin available under its existing ID while publishing the localized fork with a distinct ASCII ID.
Rejected: Reusing the upstream superpowers manifest name | It collides with the official marketplace entry.
Confidence: high
Scope-risk: narrow
Directive: Continue syncing this plugin from AreChen/superpowers-zh and preserve hooks: {}.
Tested: Marketplace validator, Codex local install/list/remove, KeyInfo adapter tests, upstream Codex manifest and package checks except its platform-specific tar epoch assertion.
61 lines
2.5 KiB
Markdown
61 lines
2.5 KiB
Markdown
# EAPIL Codex 插件市场
|
||
|
||
这是 EAPIL Codex 插件市场。首要用途是让 AI agent 能稳定安装公共 skills、MCP 插件和第三方 Codex plugin。
|
||
|
||
## 给 AI 的安装流程
|
||
|
||
当用户要求安装或使用 EAPIL 插件时，优先执行：
|
||
|
||
```bash
|
||
codex plugin marketplace add https://git.playones.com/arechen/EapilSkillMarket.git --ref main
|
||
codex plugin marketplace upgrade eapil-skill-market
|
||
codex plugin list --marketplace eapil-skill-market
|
||
codex plugin add <plugin-id>@eapil-skill-market
|
||
```
|
||
|
||
使用 `codex plugin list --marketplace eapil-skill-market` 输出里的精确 `plugin-id`。不要猜测中文名、翻译名或 display name。
|
||
|
||
同一插件的原版与本地化版本可能同时存在。它们的展示名可以相近，但 `plugin-id` 必须不同；安装前应通过列表确认语言版本和精确 ID。
|
||
|
||
安装公共 skill 或第三方 Codex plugin 时也使用同一套命令；具体可安装项以 `codex plugin list --marketplace eapil-skill-market` 的实时输出为准。
|
||
|
||
有些插件是 skill 集合，安装一个 `plugin-id` 后会同时提供多个 `$skill-name`。可安装项和安装后可用的 skills 均以 Codex 的实际输出为准。
|
||
|
||
如果插件刚安装到当前 Codex 会话中，启动新的 Codex thread 或新的 Codex 调用后再依赖新增 skills/hooks/MCP/app 配置。
|
||
|
||
卸载插件：
|
||
|
||
```bash
|
||
codex plugin remove <plugin-id>@eapil-skill-market
|
||
```
|
||
|
||
## MCP 插件
|
||
|
||
当前公开 MCP 插件是 `mcp-playwright`。
|
||
|
||
`mcp-playwright` 是本地 MCP 插件：
|
||
|
||
- 插件 ID：`mcp-playwright`
|
||
- MCP server id：`playwright`
|
||
- 本地命令：`bunx @playwright/mcp@latest`
|
||
- 鉴权：无
|
||
|
||
安装后如需覆盖启用状态或审批策略，可在用户 Codex 配置里追加：
|
||
|
||
```toml
|
||
[plugins."mcp-playwright@eapil-skill-market".mcp_servers.playwright]
|
||
enabled = true
|
||
```
|
||
|
||
## 官方插件能力
|
||
|
||
本市场中的插件可以包含 Codex 官方支持的这些能力：
|
||
|
||
- `skills`：`./skills/` 下的一个或多个 `SKILL.md`。
|
||
- `mcpServers`：通常是 `./.mcp.json`，允许 MCP-only 插件。
|
||
- `apps`：通常是 `./.app.json`，用于 app connector metadata。
|
||
- `hooks`：插件作用域 Codex hooks，可为路径、路径数组、inline object 或 object 数组。
|
||
- `interface` / `assets`：`interface.logo`、`interface.composerIcon`、`interface.screenshots` 可引用插件内 `assets/` 文件或公开 URL。
|
||
|
||
安装时请使用 `codex plugin list --marketplace eapil-skill-market` 显示的 `plugin-id`；中文展示名不是安装 ID。
|