docs(插件): 添加公开安装与发布指南

README.md

@@ -0,0 +1,156 @@
+# 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 团队内部工作流分发。仓库虽然公开可读，但未向第三方授予开源许可。

plugins/easyai-product-intake/.codex-plugin/plugin.json

@@ -1,10 +1,12 @@
 {
   "name": "easyai-product-intake",
-  "version": "0.1.0+codex.20260811033837",
+  "version": "0.1.0+codex.20260811042632",
   "description": "\u5e2e\u52a9 EasyAI \u4ea7\u54c1\u7ecf\u7406\u4ee5\u7edf\u4e00\u683c\u5f0f\u63d0\u4ea4\u9700\u6c42\u548c Bug \u5230\u98de\u4e66\u591a\u7ef4\u8868\u683c\u3002",
   "author": {
     "name": "EasyAI"
   },
+  "homepage": "https://git.51easyai.com/cc/easyai-codex-plugins",
+  "repository": "https://git.51easyai.com/cc/easyai-codex-plugins.git",
   "skills": "./skills/",
   "interface": {
     "displayName": "EasyAI \u63d0\u9700\u6c42/\u62a5 Bug",