KeyInfo Bot
cdfe190697
Constraint: Public skills are published only by explicit administrator action unless they are tracked third-party market sources. Confidence: high Scope-risk: narrow Directive: Keep private/internal skills out of the public marketplace and preserve normal incremental market Git history. Tested: Marketplace validation passed.
69 lines
3.3 KiB
Markdown
69 lines
3.3 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。
|
||
|
||
Codex 插件页的大标题按 marketplace 来源分组，不是按插件 `category` 分组。本市场统一使用 Codex 官方分类值；本地化版本与原版放在同一功能分类，并通过 `-zh` 等 ID 后缀和说明文字区分。
|
||
|
||
安装公共 skill 或第三方 Codex plugin 时也使用同一套命令；具体可安装项以 `codex plugin list --marketplace eapil-skill-market` 的实时输出为准。
|
||
|
||
有些插件是 skill 集合，安装一个 `plugin-id` 后会同时提供多个 `$skill-name`。可安装项和安装后可用的 skills 均以 Codex 的实际输出为准。
|
||
|
||
例如 `grill-me` 插件会同时安装用户入口 `$grill-me` 和必需的基础能力 `$grilling`；请安装插件整体，不要只复制其中一个 skill 目录。
|
||
|
||
安装 `shuorenhua` 后，可显式调用 `$shuorenhua` 清理中文文本中的模板套话和生硬表达；需要只审阅不改写时，在指令中指定 `annotation mode`。
|
||
|
||
部分插件依赖特定运行环境。`$updating-gitea-repositories` 面向 Gitea HTTPS、GCM 和 PAT 工作流；`$etunel-role-collaboration` 仅在 Etunel 提供角色、成员、Hook 和任务上下文时使用。安装前应查看插件详情并确认运行前置条件。
|
||
|
||
如果插件刚安装到当前 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。
|