docs: README 补充 ChatGPT 桌面应用(原 Codex App)的图形界面安装引导
注册自定义市场源目前只有命令行/手动改配置文件两种方式,桌面应用本身 没有输入市场 URL 的图形入口——如实标注这个限制。市场源生效后可在桌面 应用「设置 → 插件」里图形化安装。另外补充桌面应用(Dock/开始菜单启动) 不继承 shell export 的环境变量这个坑,huanxi/huanxi-admin 的 Token 在 桌面应用场景下需要用 launchctl setenv(macOS)或系统环境变量(Windows) 设置。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01LVyxoP4cDXeoQ3uAqLcEd2
This commit is contained in:
co-authored by
Claude Sonnet 5
parent
3de9b054ef
commit
eb0e7c3006
@@ -1,6 +1,6 @@
|
|||||||
# 蚁熊技能市场
|
# 蚁熊技能市场
|
||||||
|
|
||||||
蚁熊团队内部的插件市场,同时支持 **Claude Code** 和 **Codex CLI**——汇聚团队在真实业务场景里打磨出来的技能与工作流插件,从项目管理到知识库协作,从代码审查到数据工程,装上它,让 AI 编程助手更懂蚁熊。
|
蚁熊团队内部的插件市场,同时支持 **Claude Code** 和 **Codex(含 ChatGPT 桌面应用与 CLI 两种形态)**——汇聚团队在真实业务场景里打磨出来的技能与工作流插件,从项目管理到知识库协作,从代码审查到数据工程,装上它,让 AI 编程助手更懂蚁熊。
|
||||||
|
|
||||||
## 快速安装
|
## 快速安装
|
||||||
|
|
||||||
@@ -21,28 +21,45 @@
|
|||||||
|
|
||||||
已安装的插件会在会话启动时自动检测更新——本仓库不走语义化版本号,每次推送 `main` 分支即视为新版本。
|
已安装的插件会在会话启动时自动检测更新——本仓库不走语义化版本号,每次推送 `main` 分支即视为新版本。
|
||||||
|
|
||||||
### Codex CLI
|
### Codex CLI / ChatGPT 桌面应用
|
||||||
|
|
||||||
|
Codex 的桌面客户端已经并入 **ChatGPT 桌面应用**(原先叫 Codex App),插件市场和技能在 CLI、桌面应用、VS Code 插件三端共用同一套 `.agents/plugins/marketplace.json`。
|
||||||
|
|
||||||
|
**第一步——注册市场源(仅命令行,桌面应用没有输入市场 URL 的图形入口):**
|
||||||
|
|
||||||
```
|
```
|
||||||
codex plugin marketplace add https://gitea.rk-health.com/yixiong/yixiong-claude-marketplace.git
|
codex plugin marketplace add https://gitea.rk-health.com/yixiong/yixiong-claude-marketplace.git
|
||||||
```
|
```
|
||||||
|
|
||||||
添加市场源之后,按需安装具体插件:
|
没有终端环境,或者只想用桌面应用的话,也可以手动把同样的条目写进配置文件,效果等价:
|
||||||
|
|
||||||
```
|
- 只想在这台机器全局生效:`~/.agents/plugins/marketplace.json`
|
||||||
codex plugin add huanxi@yixiong-codex-hub
|
- 只想在某个仓库生效:`<仓库根目录>/.agents/plugins/marketplace.json`(本仓库已经自带一份,克隆下来就有)
|
||||||
codex plugin add huanxi-admin@yixiong-codex-hub
|
|
||||||
codex plugin add memcore@yixiong-codex-hub
|
写完保存后,**完全退出并重新打开 ChatGPT 桌面应用**(不是切后台,是完全退出进程)才会生效,官方文档目前没有提供"设置里粘贴 URL"这种图形化入口。
|
||||||
codex plugin add obsidian@yixiong-codex-hub
|
|
||||||
```
|
**第二步——安装插件:**
|
||||||
|
|
||||||
|
- **命令行**:
|
||||||
|
|
||||||
|
```
|
||||||
|
codex plugin add huanxi@yixiong-codex-hub
|
||||||
|
codex plugin add huanxi-admin@yixiong-codex-hub
|
||||||
|
codex plugin add memcore@yixiong-codex-hub
|
||||||
|
codex plugin add obsidian@yixiong-codex-hub
|
||||||
|
```
|
||||||
|
|
||||||
|
- **ChatGPT 桌面应用(图形界面)**:市场源注册生效后,打开 **设置(Settings)→ 插件(Plugins)**,或侧边栏的 **Plugins** 入口,就能看到我们的市场和这四个插件,点击安装即可,不用碰命令行。
|
||||||
|
|
||||||
安装完成后开一个新会话,Codex 才会加载新装的技能和 MCP 工具。
|
安装完成后开一个新会话,Codex 才会加载新装的技能和 MCP 工具。
|
||||||
|
|
||||||
|
> ⚠️ **桌面应用读不到 shell 里 `export` 的环境变量**:`huanxi`/`huanxi-admin` 的 Token 走环境变量注入(见下一节),但 macOS/Windows 上从 Dock/开始菜单启动的图形应用不会继承 `~/.zshrc` 里 `export` 的变量——这是终端应用和图形应用两种不同的启动路径决定的,不是我们插件的问题。桌面应用场景要设置成**系统级/用户级持久环境变量**才行,具体见下一节。
|
||||||
|
|
||||||
> Codex 侧的插件清单独立维护在 [`.agents/plugins/marketplace.json`](./.agents/plugins/marketplace.json)。除 `memcore` 外,其余三个插件与 Claude Code 版共用同一份 `skills/`;`memcore` 因为架构差异(会话入口、记忆目录约定、有无远程同步都不同)走的是独立目录 [`plugins/memcore-codex/`](./plugins/memcore-codex),两边分开维护。
|
> Codex 侧的插件清单独立维护在 [`.agents/plugins/marketplace.json`](./.agents/plugins/marketplace.json)。除 `memcore` 外,其余三个插件与 Claude Code 版共用同一份 `skills/`;`memcore` 因为架构差异(会话入口、记忆目录约定、有无远程同步都不同)走的是独立目录 [`plugins/memcore-codex/`](./plugins/memcore-codex),两边分开维护。
|
||||||
|
|
||||||
## 插件一览
|
## 插件一览
|
||||||
|
|
||||||
| 插件 | 技能数 | 适用场景 | 谁需要装 | Claude Code | Codex CLI |
|
| 插件 | 技能数 | 适用场景 | 谁需要装 | Claude Code | Codex |
|
||||||
|---|---|---|---|:---:|:---:|
|
|---|---|---|---|:---:|:---:|
|
||||||
| [`huanxi`](./plugins/huanxi) | 7 | 寰汐企业管理系统个人端——日报、负责人日报、任务、议题、会议、组织检索 | 全员 | ✅ | ✅ |
|
| [`huanxi`](./plugins/huanxi) | 7 | 寰汐企业管理系统个人端——日报、负责人日报、任务、议题、会议、组织检索 | 全员 | ✅ | ✅ |
|
||||||
| [`huanxi-admin`](./plugins/huanxi-admin) | 4 | 寰汐管理端——汇报盘点、模块与成员配置、运维简报 | 需要后台管理员发放 `hxa_` Token 的管理岗 | ✅ | ✅ |
|
| [`huanxi-admin`](./plugins/huanxi-admin) | 4 | 寰汐管理端——汇报盘点、模块与成员配置、运维简报 | 需要后台管理员发放 `hxa_` Token 的管理岗 | ✅ | ✅ |
|
||||||
@@ -57,14 +74,18 @@ codex plugin add obsidian@yixiong-codex-hub
|
|||||||
|
|
||||||
1. 去寰汐「个人中心 → MCP Token 管理」自助生成一个 `hxp_` 开头的 Token(`huanxi-admin` 的 `hxa_` Token 由后台管理员单独发放,普通员工无需申请)。
|
1. 去寰汐「个人中心 → MCP Token 管理」自助生成一个 `hxp_` 开头的 Token(`huanxi-admin` 的 `hxa_` Token 由后台管理员单独发放,普通员工无需申请)。
|
||||||
2. **Claude Code**:执行 `/plugin install` 时会提示输入 Token,直接粘贴即可——存放在系统钥匙链,不会明文写入配置文件。
|
2. **Claude Code**:执行 `/plugin install` 时会提示输入 Token,直接粘贴即可——存放在系统钥匙链,不会明文写入配置文件。
|
||||||
3. **Codex CLI**:Codex 没有等价的钥匙链机制,Token 走环境变量注入。启动 Codex 前设置:
|
3. **Codex CLI / ChatGPT 桌面应用**:Codex 没有等价的钥匙链机制,Token 走环境变量注入,两种运行方式的设置方法不一样:
|
||||||
|
|
||||||
```bash
|
- **命令行**:启动前 `export` 即可,建议写进 shell 启动脚本(`~/.zshrc` / `~/.bashrc`),避免每次开新终端都要重新导出:
|
||||||
export HUANXI_TOKEN=hxp_你的token # huanxi 个人端
|
|
||||||
export HUANXI_ADMIN_TOKEN=hxa_你的token # huanxi-admin 管理端
|
|
||||||
```
|
|
||||||
|
|
||||||
建议写进 shell 的启动脚本(`~/.zshrc` / `~/.bashrc`),避免每次开新终端都要重新导出。
|
```bash
|
||||||
|
export HUANXI_TOKEN=hxp_你的token # huanxi 个人端
|
||||||
|
export HUANXI_ADMIN_TOKEN=hxa_你的token # huanxi-admin 管理端
|
||||||
|
```
|
||||||
|
|
||||||
|
- **ChatGPT 桌面应用(图形界面启动,不经过 shell)**:`export` 对它无效,要设成系统级持久变量:
|
||||||
|
- macOS:终端里跑一次 `launchctl setenv HUANXI_TOKEN hxp_你的token`(`huanxi-admin` 同理换成 `HUANXI_ADMIN_TOKEN`),然后重新打开桌面应用;这个设置只在当前登录会话有效,重启电脑要重新执行,长期用建议放进登录项脚本
|
||||||
|
- Windows:「系统属性 → 环境变量」里新增用户变量 `HUANXI_TOKEN` / `HUANXI_ADMIN_TOKEN`,保存后重新打开应用
|
||||||
|
|
||||||
### memcore
|
### memcore
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user