SkyJourneyandClaude Sonnet 5
eb0e7c3006
注册自定义市场源目前只有命令行/手动改配置文件两种方式，桌面应用本身 没有输入市场 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
109 lines
7.8 KiB
Markdown
109 lines
7.8 KiB
Markdown
# 蚁熊技能市场
|
||
|
||
蚁熊团队内部的插件市场，同时支持 **Claude Code** 和 **Codex（含 ChatGPT 桌面应用与 CLI 两种形态）**——汇聚团队在真实业务场景里打磨出来的技能与工作流插件，从项目管理到知识库协作，从代码审查到数据工程，装上它，让 AI 编程助手更懂蚁熊。
|
||
|
||
## 快速安装
|
||
|
||
### Claude Code
|
||
|
||
```
|
||
/plugin marketplace add https://gitea.rk-health.com/yixiong/yixiong-claude-marketplace.git
|
||
```
|
||
|
||
添加市场源之后，按需安装具体插件：
|
||
|
||
```
|
||
/plugin install huanxi@yixiong-claude-hub
|
||
/plugin install huanxi-admin@yixiong-claude-hub
|
||
/plugin install memcore@yixiong-claude-hub
|
||
/plugin install obsidian@yixiong-claude-hub
|
||
```
|
||
|
||
已安装的插件会在会话启动时自动检测更新——本仓库不走语义化版本号，每次推送 `main` 分支即视为新版本。
|
||
|
||
### 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
|
||
```
|
||
|
||
没有终端环境，或者只想用桌面应用的话，也可以手动把同样的条目写进配置文件，效果等价：
|
||
|
||
- 只想在这台机器全局生效：`~/.agents/plugins/marketplace.json`
|
||
- 只想在某个仓库生效：`<仓库根目录>/.agents/plugins/marketplace.json`（本仓库已经自带一份，克隆下来就有）
|
||
|
||
写完保存后，**完全退出并重新打开 ChatGPT 桌面应用**（不是切后台，是完全退出进程）才会生效，官方文档目前没有提供"设置里粘贴 URL"这种图形化入口。
|
||
|
||
**第二步——安装插件：**
|
||
|
||
- **命令行**：
|
||
|
||
```
|
||
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 工具。
|
||
|
||
> ⚠️ **桌面应用读不到 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)，两边分开维护。
|
||
|
||
## 插件一览
|
||
|
||
| 插件 | 技能数 | 适用场景 | 谁需要装 | Claude Code | Codex |
|
||
|---|---|---|---|:---:|:---:|
|
||
| [`huanxi`](./plugins/huanxi) | 7 | 寰汐企业管理系统个人端——日报、负责人日报、任务、议题、会议、组织检索 | 全员 | ✅ | ✅ |
|
||
| [`huanxi-admin`](./plugins/huanxi-admin) | 4 | 寰汐管理端——汇报盘点、模块与成员配置、运维简报 | 需要后台管理员发放 `hxa_` Token 的管理岗 | ✅ | ✅ |
|
||
| [`memcore`](./plugins/memcore) / [`memcore-codex`](./plugins/memcore-codex) | 4 | 项目记忆体系核心引擎——跨会话记忆的同步/增量更新/健康校验 | 用 Claude Code 或 Codex 做长期项目的开发者 | ✅ | ✅ |
|
||
| [`obsidian`](./plugins/obsidian) | 10 | Obsidian 知识库全套协作工作流——vault 管理、搜索图谱、Bases、Canvas、每日笔记等 | 用 Obsidian 做知识管理的人 | ✅ | ✅ |
|
||
|
||
### huanxi / huanxi-admin
|
||
|
||
寰汐是蚁熊内部的项目管理与团队协同系统。`huanxi` 以你本人的身份操作，权限与网页端一致；`huanxi-admin` 是全量管理视角，高危操作（账号启停、提权、删除）不在这个端点里，普通员工不需要装。
|
||
|
||
**配置步骤：**
|
||
|
||
1. 去寰汐「个人中心 → MCP Token 管理」自助生成一个 `hxp_` 开头的 Token（`huanxi-admin` 的 `hxa_` Token 由后台管理员单独发放，普通员工无需申请）。
|
||
2. **Claude Code**：执行 `/plugin install` 时会提示输入 Token，直接粘贴即可——存放在系统钥匙链，不会明文写入配置文件。
|
||
3. **Codex CLI / ChatGPT 桌面应用**：Codex 没有等价的钥匙链机制，Token 走环境变量注入，两种运行方式的设置方法不一样：
|
||
|
||
- **命令行**：启动前 `export` 即可，建议写进 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
|
||
|
||
给 AI 编程助手加一套跨会话持久记忆的引擎：`memory-sync` 做全量同步、`memory-update` 做增量写入、`memory-lint` 做健康校验（孤儿引用、断链、内容矛盾、过期检测）。不依赖 MCP，纯技能实现，**无需任何配置，安装即用**。
|
||
|
||
Claude Code 版（[`plugins/memcore`](./plugins/memcore)）以 `.claude/memory/` 为唯一权威，`memory-sync` 会额外和 `~/.claude/projects/*/memory/` 做远程镜像同步，支持多机协作。Codex 版（[`plugins/memcore-codex`](./plugins/memcore-codex)）架构不同：会话入口是 `AGENTS.md` 而非 `CLAUDE.md`，记忆目录优先复用已有的 `.claude/memory/`、否则落在 `.codex/memory/`，且**不做远程同步**——Codex 没有等价的跨机器 auto memory 层，记忆只落在当前仓库内。两个版本共享同一套 `SYNTHESIS_THRESHOLD`、过期检测速度分档等常量设计，但各自独立维护。
|
||
|
||
### obsidian
|
||
|
||
检测到项目里有 `.obsidian/` 目录会自动激活，覆盖 vault 管理、全文与图谱搜索、frontmatter、任务、每日笔记、Bases 数据库、Canvas 视觉层、版本历史、插件配置、PKM 编排十个技能，对标社区里比较成熟的 Obsidian 技能实现后做了扩展。**无需任何配置**，Claude Code 和 Codex CLI 共用同一份技能内容。
|
||
|
||
## 开发
|
||
|
||
给这个市场新增插件、技能实现规范、`marketplace.json`/`plugin.json` 格式说明，见 [CLAUDE.md](./CLAUDE.md)。
|
||
|
||
Codex 插件的 `.codex-plugin/plugin.json` 有几个硬性约束（用本机 `plugin-creator` 技能自带的 `validate_plugin.py` 校验）：`skills` 字段必须精确指向 `./skills`、`mcpServers` 字符串路径必须精确指向 `./.mcp.json`（都在插件根目录，不能嵌套在 `.codex-plugin/` 里），且顶层 `interface` 块（`displayName`/`shortDescription`/`longDescription`/`developerName`/`category`/`capabilities`/`defaultPrompt`）是必填项。
|
||
|
||
## 更新记录
|
||
|
||
见 [CHANGELOG.md](./CHANGELOG.md)。
|