# 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 的实际输出为准。

`dingtalk-workspace` 提供钉钉官方办公协作 Skills。使用前请单独安装与插件版本匹配的 [dws CLI](https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli/releases)，执行 `dws auth login` 并取得企业授权；辅助脚本需要 Python 3。建议使用官方预编译二进制，避免安装器额外安装重复 Skills；升级 CLI 时可使用 `dws upgrade --skip-skills`，Skills 由本市场更新。插件不会附带账号凭据，消息发送、文档修改和审批等操作需要明确的用户指令。

例如 `grill-me` 插件会同时安装用户入口 `$grill-me` 和必需的基础能力 `$grilling`；请安装插件整体，不要只复制其中一个 skill 目录。

安装 `shuorenhua` 后，可显式调用 `$shuorenhua` 清理中文文本中的模板套话和生硬表达；需要只审阅不改写时，在指令中指定 `annotation mode`。

安装 `hardware-development` 后，可显式调用 `$hardware-development` 处理以 KiCad 为主的电路实施、PCB 布局布线、DRC 和制造交付；执行前应确认本机可用的 EDA 工具、有效工程版本和项目约束。

`embedded-app-pc-debug`、`firmware-app-development` 和 `firmware-lowlevel-development` 分别覆盖 Windows 电脑端设备调试、固件应用层开发及 BSP/PSP 等底层开发流程。使用前应确认项目工具链、目标设备和访问权限；构建、设备写入、刷机、升级、上传和发布等操作必须按插件门禁取得明确确认。

部分插件依赖特定运行环境。`$updating-gitea-repositories` 面向 Gitea HTTPS、GCM 和 PAT 工作流；`$etunel-role-collaboration` 仅在 Etunel 提供角色、成员、Hook 和任务上下文时使用。安装前应查看插件详情并确认运行前置条件。

`etunel-role-collaboration` 的插件版本对应上游正式 release 的版本号。更新插件不会自动修改 Etunel 的 Hook 配置或迁移在途项目；实际项目仍需按已确认的流程基线使用。

`caveman` 插件中的大多数工作流可直接使用。可选的 `$caveman-compress` 需要 Python 3.10，以及 `ANTHROPIC_API_KEY` 或已登录的 Claude CLI；仅在用户明确指定文件后执行，并会把该文件内容发送给 Anthropic。该插件不包含 Claude Code 专用统计 hooks、statusline、Caveman CLI、代理或 MCP shrink。

如果插件刚安装到当前 Codex 会话中，启动新的 Codex thread 或新的 Codex 调用后再依赖新增 skills/hooks/MCP/app 配置。

`caveman` 包含 Codex `SessionStart` hook，信任并启用后会在启动、恢复会话时注入精简表达模式。可要求 `normal mode` 停用当前模式；恢复会话时上游 hook 会再次注入。需要持续关闭时，请在 Codex 中禁用该 hook 或插件。

卸载插件：

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