SkyJourneyandClaude Sonnet 5 1606d73c41 chore: memory-sync — 归档 Codex 插件骨架/bearer_token_env_var/不做Antigravity兼容等决策
新增 3 条 decisions.md 条目:Codex/ChatGPT 桌面应用插件骨架设计(三插件
共享 skills/、memcore 独立目录的原因)、Codex 侧 MCP Token 用
bearer_token_env_var 字段的踩坑与本地缓存刷新方法、调研后决定不做
Google Antigravity(agy)兼容。project_overview.md 已发布插件表格补
Codex 支持列,CLAUDE.md 补 Codex plugin.json 硬约束小节与并行结构说明。

memory-lint 顺带修了本机 shell 环境下 Phase 3C 快扫自引用排除逻辑失效
的问题(grep -r 输出不带 ./ 前缀导致误判),修复 1 处断链 + 1 处双链
缺失反向链接。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LVyxoP4cDXeoQ3uAqLcEd2
2026-08-22 18:20:31 +08:00

蚁熊技能市场

蚁熊团队内部的插件市场,同时支持 Claude CodeCodex(含 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/开始菜单启动的图形应用不会继承 ~/.zshrcexport 的变量——这是终端应用和图形应用两种不同的启动路径决定的,不是我们插件的问题。桌面应用场景要设置成系统级/用户级持久环境变量才行,具体见下一节。

⚠️ 插件级 Token 配置目前是 Codex 官方还没定案的能力:截至本文写作时,插件打包的 MCP server 没有类似 Claude 侧「安装时弹窗填 Token」的正式支持(见 openai/codex#24401),环境变量是目前唯一现实可用的路径。装完插件连不上 MCP,先检查 Token 环境变量是不是在 Codex/ChatGPT 启动之前就已经生效。

Codex 侧的插件清单独立维护在 .agents/plugins/marketplace.json。除 memcore 外,其余三个插件与 Claude Code 版共用同一份 skills/memcore 因为架构差异(会话入口、记忆目录约定、有无远程同步都不同)走的是独立目录 plugins/memcore-codex/,两边分开维护。

插件一览

插件 技能数 适用场景 谁需要装 Claude Code Codex
huanxi 7 寰汐企业管理系统个人端——日报、负责人日报、任务、议题、会议、组织检索 全员
huanxi-admin 4 寰汐管理端——汇报盘点、模块与成员配置、运维简报 需要后台管理员发放 hxa_ Token 的管理岗
memcore / memcore-codex 4 项目记忆体系核心引擎——跨会话记忆的同步/增量更新/健康校验 用 Claude Code 或 Codex 做长期项目的开发者
obsidian 10 Obsidian 知识库全套协作工作流——vault 管理、搜索图谱、Bases、Canvas、每日笔记等 用 Obsidian 做知识管理的人

huanxi / huanxi-admin

寰汐是蚁熊内部的项目管理与团队协同系统。huanxi 以你本人的身份操作,权限与网页端一致;huanxi-admin 是全量管理视角,高危操作(账号启停、提权、删除)不在这个端点里,普通员工不需要装。

配置步骤:

  1. 去寰汐「个人中心 → MCP Token 管理」自助生成一个 hxp_ 开头的 Tokenhuanxi-adminhxa_ Token 由后台管理员单独发放,普通员工无需申请)。

  2. Claude Code:执行 /plugin install 时会提示输入 Token,直接粘贴即可——存放在系统钥匙链,不会明文写入配置文件。

  3. Codex CLI / ChatGPT 桌面应用:Codex 没有等价的钥匙链机制,Token 走环境变量注入,两种运行方式的设置方法不一样:

    • 命令行:启动前 export 即可,建议写进 shell 启动脚本(~/.zshrc / ~/.bashrc),避免每次开新终端都要重新导出:

      export HUANXI_TOKEN=hxp_你的token          # huanxi 个人端
      export HUANXI_ADMIN_TOKEN=hxa_你的token     # huanxi-admin 管理端
      
    • ChatGPT 桌面应用(图形界面启动,不经过 shell)export 对它无效,要设成系统级持久变量:

      • macOS:终端里跑一次 launchctl setenv HUANXI_TOKEN hxp_你的tokenhuanxi-admin 同理换成 HUANXI_ADMIN_TOKEN),然后重新打开桌面应用;这个设置只在当前登录会话有效,重启电脑要重新执行,长期用建议放进登录项脚本
      • Windows:「系统属性 → 环境变量」里新增用户变量 HUANXI_TOKEN / HUANXI_ADMIN_TOKEN,保存后重新打开应用

memcore

给 AI 编程助手加一套跨会话持久记忆的引擎:memory-sync 做全量同步、memory-update 做增量写入、memory-lint 做健康校验(孤儿引用、断链、内容矛盾、过期检测)。不依赖 MCP,纯技能实现,无需任何配置,安装即用

Claude Code 版(plugins/memcore)以 .claude/memory/ 为唯一权威,memory-sync 会额外和 ~/.claude/projects/*/memory/ 做远程镜像同步,支持多机协作。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

Codex 插件的 .codex-plugin/plugin.json 有几个硬性约束(用本机 plugin-creator 技能自带的 validate_plugin.py 校验):skills 字段必须精确指向 ./skillsmcpServers 字符串路径必须精确指向 ./.mcp.json(都在插件根目录,不能嵌套在 .codex-plugin/ 里),且顶层 interface 块(displayName/shortDescription/longDescription/developerName/category/capabilities/defaultPrompt)是必填项。

更新记录

CHANGELOG.md

S
Description
No description provided
Readme
800 KiB
Languages
Markdown 100%