# EasyAI Codex Plugins

EasyAI 团队的 Codex 插件市场。目前包含：

- `easyai-product-intake`（界面名称：**EasyAI 提需求/报 Bug**）：引导产品经理补齐需求或 Bug 信息，在明确确认后提交到飞书多维表格。

仓库公开可读，产品经理无需 Gitea 账号即可查看或下载。提交飞书任务仍然必须使用本人已授权的飞书身份；公开仓库不会授予任何飞书数据访问权限。

## 产品经理：首次安装

### 1. 检查命令

打开终端，确认 Codex CLI 和飞书 CLI 可用：

```bash
codex --version
lark-cli --version
```

如果任一命令不存在，请联系 EasyAI 自动化管理员完成对应客户端安装，不要从非公司渠道下载替代程序。

### 2. 添加团队插件市场

```bash
codex plugin marketplace add https://git.51easyai.com/cc/easyai-codex-plugins.git --ref main
```

检查是否已添加成功：

```bash
codex plugin marketplace list
```

输出中应包含市场名 `easyai-team`。

### 3. 安装插件

```bash
codex plugin add easyai-product-intake@easyai-team
```

也可以在 Codex CLI 输入 `/plugins`，切换到 `EasyAI Team`，找到 **EasyAI 提需求/报 Bug** 后安装。

安装完成后，重新启动 Codex 桌面应用或开启一个新任务；已打开的旧任务不会自动加载新插件。

### 4. 检查飞书身份

```bash
LARKSUITE_CLI_NO_UPDATE_NOTIFIER=1 \
LARKSUITE_CLI_NO_SKILLS_NOTIFIER=1 \
lark-cli auth status --json --verify
```

如果用户身份显示为未授权或已过期，运行：

```bash
lark-cli auth login --domain base
```

根据终端给出的链接在浏览器中完成飞书授权。插件始终使用当前产品经理本人的飞书身份，不接受也不需要在对话中提供 Token、Cookie 或密码。

如果提示 lark-cli 尚未初始化，先运行：

```bash
lark-cli config init --new
```

完成公司飞书应用配置后，再重新执行身份授权。若没有应用配置权限，请联系 EasyAI 自动化管理员。

## 产品经理：提交需求或 Bug

在一个新的 Codex 任务中直接输入，例如：

```text
提一个需求：在订单详情页显示预计完成时间。
```

或者：

```text
报一个 Bug：测试环境中，用户修改头像后页面仍然显示旧头像。
```

插件会：

1. 判断是需求还是 Bug。
2. 每轮最多追问 3 个会影响执行或验收的问题。
3. 展示结构化预览。
4. 等待你明确回复“确认提交”。
5. 使用你的飞书身份创建记录，并返回记录链接和提交幂等键。

没有明确确认时，插件不会写入飞书。任务状态、执行阶段、代码分支、PR、部署和审计字段由中央流水线维护，产品经理无需编辑。

## 更新插件

管理员发布新版本后，运行：

```bash
codex plugin marketplace upgrade easyai-team
codex plugin add easyai-product-intake@easyai-team
```

然后重新启动 Codex 桌面应用或开启一个新任务。

## 卸载

```bash
codex plugin remove easyai-product-intake@easyai-team
codex plugin marketplace remove easyai-team
```

卸载插件不会删除已经提交到飞书的任务，也不会自动撤销飞书服务端授权。如需撤销授权，请在飞书的授权管理页面操作。

## 直接下载

- 仓库页面：<https://git.51easyai.com/cc/easyai-codex-plugins>
- Git 克隆：`https://git.51easyai.com/cc/easyai-codex-plugins.git`
- `main` 分支 ZIP：<https://git.51easyai.com/cc/easyai-codex-plugins/archive/main.zip>

直接下载适合查看或归档；日常安装建议使用上面的 Codex 插件市场命令，以便后续升级。

## 管理员：发布新版本

1. 修改插件内容并完成本地测试。
2. 使用 plugin-creator 的 cachebuster 工具更新插件清单版本。
3. 校验插件和 Skill：

   ```bash
   python3 /Users/easyai/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py \
     plugins/easyai-product-intake

   python3 /Users/easyai/.codex/skills/.system/skill-creator/scripts/quick_validate.py \
     plugins/easyai-product-intake/skills/easyai-submit-task
   ```

4. 提交并推送 `main`。
5. 在一台未安装该版本的测试机上执行“首次安装”步骤。
6. 用新的 Codex 任务分别完成一次需求预览和 Bug 预览；真实写入测试必须使用专门的测试记录。
7. 通知产品经理运行“更新插件”命令。

不要把飞书 App Secret、访问令牌、Cookie、个人凭据或生产环境密码提交到本仓库。

## 目录结构

```text
.
├── .agents/plugins/marketplace.json
└── plugins/
    └── easyai-product-intake/
        ├── .codex-plugin/plugin.json
        └── skills/easyai-submit-task/
```

## 使用范围

本仓库用于 EasyAI 团队内部工作流分发。仓库虽然公开可读，但未向第三方授予开源许可。