# 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。

安装公共 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。
