chainbase-labs__agentkey/docs/README_zh.md

一条命令，解锁 Agent 全网访问能力。
刷推特、搜领英、逛社交媒体、抓网页。无需配置，装好即用。

安装 · 支持平台 · 常见问题 · English

---

安装 AgentKey，让你的 AI 拥有超能力

AgentKey 是 Agent 生态里的"万能钥匙"。用户在用 Claude、Manus 这些 Agent 时，经常需要获取外部数据（社交媒体、电商、链上数据、各种 API），但要么要自己找 API 填 Key，要么根本找不到解决方案。

装了 AgentKey，Agent 就自动具备了这些数据获取能力。无需逐个注册服务、逐个管理账单，一份订阅全部搞定。

⭐ 右上角 Star 本项目，我们会持续更新平台接入变化，有新版本自动通知你。

---

使用场景

你对 Agent 说	没装会怎样	装了 AgentKey 后
🐦 马斯克最近在推特上在说什么	看不了，搜不到完整推文	一次拉全相关推文，帮你总结结论
📕 Ins 上大家怎么看这个产品	打不开，必须登录才能看	直接抓真实笔记，按口碑帮你归纳
📺 这个 YouTube / B 站视频讲了什么	看不了，字幕拿不到	自动看视频/字幕，提炼要点
📖 去 Reddit 上看看有没有人遇到同样的痛点	403 被封，帖子进不去	找到相关帖子，把解法抽出来
👔 帮我看一下这家竞品 / 候选人的 LinkedIn	进不去，权限烦还老 403	打开公司/个人页，提炼关键信息
🎵 帮我看看抖音 / TikTok 最近哪些话题最热	刷不动榜单，只能自己刷	抓热门话题和标签，帮你总结趋势
🌐 帮我看看这个网页写了啥	抓回来一堆 HTML，没法读	把正文抠出来，用几段话讲清楚
📦 这个 GitHub 仓库是干嘛的？	只能自己点进仓库慢慢翻	看 README、Issue，一句话说清
🧾 帮我看看这个地址/基金最近在买什么	自己去区块浏览器一笔笔点	自动汇总最近交易，帮你看仓位变化

没有安装之前：10 个任务，10 个 Key，10 份账单。

Agent 就像半智能体，完全无法自主行动，不断需要人类帮助搜寻解决方案，管理复杂度直线上升。

现在，一个 AgentKey，所有服务全部搞定。AgentKey 统一了 AI 干活需要的一切外部访问。

---

第一次来？先到网页上看看

在动命令行之前，你可以先在浏览器里熟悉一下 AgentKey —— 官网和后台讲得比 README 更直观。

• 🌐 agentkey.app —— 产品介绍、支持的平台、在线演示、计费说明
• 🎛️ console.agentkey.app —— 注册账号、管理订阅、管理 API Key、查看用量

下面的一条命令是把 AgentKey 接进你的 AI Agent。如果只是想先看看，上面两个链接是更友好的入口。

---

安装

一条命令。浏览器弹出登录，完成即可。安装脚本会自动识别你机器上每一个支持的 Agent（已支持 40+，常见的如 Claude Code、Codex、Gemini CLI、Cursor CLI 等），逐个配好。

macOS / Linux

curl -fsSL https://agentkey.app/install.sh | bash

Windows（PowerShell）

irm https://agentkey.app/install.ps1 | iex

重启 Agent，然后问它一些需要联网的问题。正在运行的 DeepSeek Harness profile 会通过 HMR 监听 home patch；未运行的 profile 会在下次启动时加载。

"马斯克最近在推特上在说什么？"

就这样。不用复制 API Key，也不用改 JSON。

_{想只装到特定 Agent 或在 CI 里跑？→ 看 常见问题 里的"进阶安装"条目。}

---

DeepSeek Harness（DSH）

上面的一键安装会自动检测 ${DSH_HOME:-~/.dsh} 或 dsh 命令，把 AgentKey Skill 全局安装到 ~/.agents/skills/agentkey，完成 AgentKey 授权，并把一个受管 Loader 块写入 DSH home-level patch：

${DSH_HOME:-~/.dsh}/cordis.patch.yml

这是 CLI 管理的 DSH MCP 集成，不是可通过 dsh plugin 安装的原生 DSH plugin。home layer 使用 Loader id agentkey、模块 @deepseek-ai/dsh-mcp-client 和 MCP serverName: agentkey，会叠加到当前及未来的 profile；但 preset、session 或 subagent 的 tool policy 仍可隐藏这些工具。

DSH 0.1.0-rc.7 没有向 MCP SDK client 提供 OAuth authProvider。不带 header 的 server entry 无法完成 401/RFC 9728 自动发现，也不会弹出浏览器。因此 DSH 必须执行下面的 device-code 命令，由 CLI 写入本地 Bearer Key。

如果只想手动安装到 DSH，严格执行下面两步：

npx skills add chainbase-labs/agentkey -g -y
npx -y @agentkey/cli --auth-login --only dsh

CLI 只会把真实 API Key 写入单一的本地 home patch，API Key 不得进入 Git。重复运行会轮换 Key 并替换唯一的受管块，不会重复追加，也不要求已经存在 profile。迁移时只清除 per-profile patch 中位于 YAML 顶层、marker 从第 1 列开始的 AgentKey 受管块，并把旧 .agent-presets/agentkey 目录改名为带时间戳的备份；CLI 会输出备份位置。如果结构化检测到更早版本写入的未标记 AgentKey Loader 行，CLI 会在不修改任何 patch 的前提下停止，并提示手工删除对应的顶层 insert child。符号链接 profile patch 只做只读检查：不含旧 AgentKey 配置时允许安装；存在任一 legacy 形式时停止安装，输出路径并要求手工清理 symlink target。

只有正在运行的 profile 进程会通过 HMR 立即观察到 home patch 变化；已停止和未来创建的 profile 会在启动时加载。如果旧 preset 已在某个 session 中激活，迁移后关闭该 session，或重启一次 DSH。

如何确认 DSH 安装成功

1. 打开 DSH → Settings → Plugins → Plugin list，搜索配置 id agentkey，展开 mcp-client 行。DSH 0.1 当前显示为：

   • Loader path：include:agentkey（稳定的配置条目 id 仍是 agentkey）
   • module title：@deepseek-ai/dsh-mcp-client（卡片会缩写为 mcp-client）
   • Cordis status：Mounted（底层 fiber phase 是 active）

   Mounted/active 只证明 Cordis 已加载该配置行。由于 failOnStartupError: false，它不能证明 MCP 已认证或连接。

2. 在目标 preset/session 中确认三个核心工具可见：

   • mcp__agentkey__find_tools
   • mcp__agentkey__describe_tool
   • mcp__agentkey__execute_tool

   list_tools 已弃用，不是 readiness 条件。如果只有某个上下文看不到核心工具，检查该 preset/session/subagent 的 tool policy。

3. 提问：“请使用 AgentKey 搜索今天最新的 AI 新闻”。成功标准是实际完成 find_tools → describe_tool → execute_tool 调用，而不是只看到 Mounted 卡片。

故障诊断：

• 没有 agentkey 行： home patch 未写入，或 DSH_HOME 指错位置。重跑 DSH-only CLI 命令，并检查它输出的路径。
• 有配置行但不是 Mounted/active： 查看 Loader 错误，并确认 DSH 安装中存在 @deepseek-ai/dsh-mcp-client。
• Mounted 但没有工具： 检查 MCP 连接日志、本地 Authorization Key 和当前 tool policy；tools/list 中每个工具根 inputSchema.additionalProperties 必须缺省或为 true，不能为 false。
• 401： 本地 Key 缺失或无效；重跑 auth-login 轮换 Key。
• serverName already in use： 重跑当前 CLI 归档旧 preset，再关闭仍持有旧 preset 的 session，或重启一次 DSH。

---

装好之后能干什么

AgentKey 在云端维护与开放互联网各类平台的对接 —— 你不需要额外开账号，也不用再填 Key。

能力	覆盖范围
网页搜索	搜索引擎结果、新闻与实时信息发现
网页抓取	从任意 URL 提取正文、结构化数据与元信息
链上 / 加密	代币行情、链上活动、项目与市场元数据
社交与内容	主流社交、视频、问答平台的公开内容
金融	股票与外汇行情、技术指标、公司财务与财报
电商	主流电商平台的商品详情、价格、评价与热销榜
商业数据	公司、融资、投资人与关键人物数据，用于市场与竞品研究

底层 provider 由 AgentKey 自动路由并持续扩充 —— Agent 可以通过 find_tools 查看当前可用的接入。

规划中： 地图与天气

---

常见问题

安全吗？

安全。AgentKey 是 Agent 的"万能钥匙"—— 一个平台帮你的 Agent 解锁外部能力。按架构设计，我们看不到你的本地文件、凭证或 Agent 的对话。AgentKey 只采集匿名使用统计 —— 你装到了哪些 Agent、Skill 版本、升级结果 —— 永远不采集你的查询内容或返回数据。详见下方"我如何关闭遥测？"。

和 Claude / ChatGPT 自带的能力有什么不一样？

Claude 与 ChatGPT 的原生联网与平台覆盖有限，往往触达不到推特、链上数据等。AgentKey 让你的 Agent 能覆盖这些场景（具体以当前产品能力为准）。

怎么计费？套餐额度用完了怎么办？

AgentKey 采用订阅制。每档套餐包含每月的 credits 额度，超出部分按量计费（超额付费）。你可以随时在 console.agentkey.app 升级套餐或管理账单。具体套餐与价格见 agentkey.app。

怎么更新？

AgentKey 有两部分，更新方式不同：

• MCP server：真正的服务端在 https://api.agentkey.app/v1/mcp，永远自动最新，不需要本地升级。@agentkey/cli 包（npx -y @agentkey/cli --auth-login）只负责把远程 HTTP MCP 配置写入各个 AI client，除非要换 API Key，否则不用再跑。

• Skill 文件（SKILL.md 加辅助脚本）：升级方式取决于你用的 client。

Claude Code

完全自动。每次会话第一次调用 skill 时会静默跑版本检查；发现新版本会提示你升级，得到你确认后跑 npx skills update -g agentkey。

Claude Desktop / Cursor 等没有 inline Bash 工具的 client

Skill 自己跑不了 inline 检查，但从 v1.4.0 起 MCP server 通过专用 metadata tool（agentkey_skill_meta）发布最新 skill 版本号。Agent 在每个会话里调一次，对比本地 skill 版本，发现差异就用你 client 对应的精确命令提示你升级。协议细节见 protocol/skill-meta-v1.md。

Desktop 一次性破冰升级：如果你 Desktop 里的 skill 还停在 1.4.0 之前，metadata tool 存在但旧 skill 不懂怎么读。先手动同步一次到最新版：

# 把 <UUID1>/<UUID2> 替换成 skills-plugin 下实际的 session 目录
# （通常就一个，找包含 skills/agentkey/SKILL.md 的那个）
DESKTOP_BASE="$HOME/Library/Application Support/Claude/local-agent-mode-sessions/skills-plugin"
LATEST_REPO_ZIP=$(mktemp -d)/agentkey.tar.gz
curl -fsSL https://github.com/chainbase-labs/agentkey/archive/refs/heads/main.tar.gz -o "$LATEST_REPO_ZIP"
tar -xzf "$LATEST_REPO_ZIP" -C "$(dirname "$LATEST_REPO_ZIP")"
find "$DESKTOP_BASE" -type d -path "*/skills/agentkey" 2>/dev/null | while read -r dst; do
  cp -R "$(dirname "$LATEST_REPO_ZIP")"/agentkey-main/skills/agentkey/. "$dst/"
done
# 然后完全退出并重启 Claude Desktop。

破冰之后，后续每次新版都会通过 metadata tool 自动告知，无需再手动操作。

任意 client：强制手动更新

# 拉最新版的 Skill 内容
npx skills update agentkey

# 锁定特定版本
npx skills add chainbase-labs/agentkey@v1.0.0

注意：npx skills update 只写 ~/.agents/skills/agentkey 和 ~/.claude/skills/agentkey 这两个目录，是 Claude Code 读取的位置。Claude Desktop 读的是自己的 sandbox 路径，npx skills update 碰不到——Desktop 升级要用上面的破冰命令。

只有在需要换 API Key 时才需要再跑一次 npx -y @agentkey/cli --auth-login。

怎么卸载？

一条命令，清理所有 Agent 与配置。

macOS / Linux

curl -fsSL https://agentkey.app/uninstall.sh | bash

Windows（PowerShell）

irm https://agentkey.app/uninstall.ps1 | iex

把 Skill 从所有 Agent 里清理掉，同时删除各 MCP 客户端里的 agentkey 条目 + API Key，清理缓存和日志。加 --keep-marketplace（bash）/ -KeepMarketplace（PowerShell）可以保留 Claude Code 的 marketplace 条目。

想手动两步卸载？

# 1. 把 Skill 从所有 Agent 里移除
npx skills remove chainbase-labs/agentkey

# 2. 在各 MCP 客户端配置里删掉 mcpServers 下的 "agentkey" 条目：
#    - Claude Code：    ~/.claude.json
#    - Claude Desktop： ~/Library/Application Support/Claude/claude_desktop_config.json  (macOS)
#                      %APPDATA%\Claude\claude_desktop_config.json                       (Windows)
#    - Cursor：         ~/.cursor/mcp.json

一键卸载脚本还会额外清 npm/npx 缓存、旧的 shell rc 残留、CLAUDE.md 里的 AgentKey 段、MCP stdio 日志 —— 想一次清干净就用它。

我如何关闭遥测？

AgentKey 会上报匿名使用统计（你用的 Agent、Skill 版本、升级结果 —— 永远不会上报查询内容或返回数据）。任选一种方式关闭：

# 持久关闭（推荐）
touch ~/.config/agentkey/telemetry-disabled

# 进程级临时关闭（CI / 单次会话）
AGENTKEY_TELEMETRY=0 <your command>

# 安装时直接关
curl -fsSL https://agentkey.app/install.sh | bash -s -- --no-telemetry

想重新开启，删掉 ~/.config/agentkey/telemetry-disabled 即可。

好像哪里不对？怎么排查？

在 Agent 里试试 /agentkey status —— 会诊断 MCP 配置、版本、连通性。

可用的 Slash 命令：

命令	作用
/agentkey	主入口：数据查询时自动触发，通常不需要手动调用
/agentkey setup	初始安装：配置 API Key + 验证 MCP 连通性
/agentkey status	诊断当前配置状态（MCP、版本、连通性测试）

还是解决不了？看下面"怎么获取帮助"那条。

进阶安装（CI / 指定 Agent / 手动两步）

安装器会自动探测本机已安装的 AI Agent（依据 vercel-labs/skills 支持列表 比对配置目录和命令行工具），自动选中它们 —— 不再弹多选框。需要覆盖时用下面的旗标：

安装器参数：

# 非交互模式（CI / 无人值守）：安装到所有检测到的 Agent，不询问
curl -fsSL https://agentkey.app/install.sh | bash -s -- --yes

# 看一下安装器在本机会自动选中哪些 Agent（看完即退出）
curl -fsSL https://agentkey.app/install.sh | bash -s -- --list-agents

# 只安装到指定的 Agent（覆盖自动检测结果）
curl -fsSL https://agentkey.app/install.sh | bash -s -- --only claude-code,cursor

# 跳过我们的检测，让 skills CLI 自己识别全部 Agent
curl -fsSL https://agentkey.app/install.sh | bash -s -- --all-agents

# 只装 Skill 或只做 MCP 授权
curl -fsSL https://agentkey.app/install.sh | bash -s -- --skip-mcp
curl -fsSL https://agentkey.app/install.sh | bash -s -- --skip-skill

PowerShell 对应参数：-Yes、-ListAgents、-Only、-AllAgents、-SkipMcp、-SkipSkill。

手动两步安装（想自己跑两条底层命令，或一键脚本在你的环境里跑不起来）：

# 1. 把 Skill 装进所有检测到的 Agent
npx skills add chainbase-labs/agentkey

# 2. 浏览器授权并注册 MCP Server
npx -y @agentkey/cli --auth-login

没 GUI / SSH / Docker？ 授权步骤会同时尝试开浏览器并把 URL 打印到终端 —— 在没法弹浏览器的机器上，直接把打印出来的 URL 复制到任何能开浏览器的设备完成授权即可。如果完全不想走 URL 跳转、想自己手动粘 Key，可以用 npx -y @agentkey/cli --setup 走交互式向导。

我的 Agent 没被自动配置，怎么手动设置？

CLI 支持其当前 Supported agents 列表中的客户端，一键安装器会自动配置检测到的受支持客户端，其中包括 DeepSeek Harness。如果客户端未被检测到，或不支持自动配置，仍可全局安装 Skill，但需要把下面这段 MCP 片段手动贴到该客户端自己的配置里（路径因客户端而异）：

{
  "mcpServers": {
    "agentkey": {
      "type": "http",
      "url": "https://api.agentkey.app/v1/mcp",
      "headers": { "Authorization": "Bearer ak_..." }
    }
  }
}

写完后重启 Agent。你第一次在对话里触发 Skill 时，它也会引导你走这一步。

能自托管 / 本地开发吗？

从本地 checkout 安装：

git clone https://github.com/chainbase-labs/agentkey.git
cd agentkey

# 1. 把当前工作副本装进所有检测到的 Agent
npx skills add .

# 2. 注册 MCP Server（只需一次）
npx -y @agentkey/cli --auth-login

npx skills add . 支持本地路径（也支持 file:// URL），改完 skills/agentkey/SKILL.md 再跑一次就能立刻生效，是日常迭代最快的路径。MCP 注册步骤每台机器只需一次。

想改 MCP Server 本身？ MCP server 在 AgentKey-Server/（Go），端点是 /v1/mcp。本地起服务（make run），把 MCP 配置指向 http://localhost:8081/v1/mcp 就能端到端验证。

Claude Code 插件模式 —— 直接从 marketplace 安装。插件内置不带 header 的远程 HTTP 配置，并使用 Claude Code 原生 MCP OAuth，不用粘贴 API Key，也不需要再单独跑 @agentkey/cli：

# 公开安装
claude plugin marketplace add chainbase-labs/agentkey
claude plugin install agentkey@agentkey

# …或从本地 checkout 安装，用于开发
claude plugin marketplace add /absolute/path/to/agentkey
claude plugin install agentkey@agentkey

安装后运行 /reload-plugins，打开 /mcp，选择 AgentKey 并点击 Authenticate，然后在浏览器完成登录。也可以在终端运行 claude mcp login plugin:agentkey:agentkey 启动同一个 OAuth 流程。插件的 .mcp.json 会刻意保持无 Authorization header：一旦配置这个 header，Claude Code 就会把 server 判定为 header 认证，并在 401 后屏蔽 OAuth fallback。改了本地 checkout 后用 claude plugin update agentkey 重新加载。日常 Skill 迭代仍是 Skills CLI 最快；插件路径是 Claude Code 用户的 OAuth 安装方式。

Codex 插件模式 —— 从本仓库自带的 marketplace 安装。认证走 OAuth（安装时浏览器登录），不用粘贴 API Key，也不需要再单独跑 @agentkey/cli：

# 公开安装
codex plugin marketplace add chainbase-labs/agentkey
# 然后在 Codex 里运行 /plugins 安装 AgentKey，
# 或者：codex plugin install agentkey@agentkey

插件清单在 .codex-plugin/plugin.json；它捆绑了同一个 Skill，外加一条远程 HTTP MCP 配置（.codex-plugin/mcp.json），通过 MCP OAuth（RFC 9728 自动发现）对 https://api.agentkey.app/v1/mcp 做认证。Codex 提示时用你的 AgentKey 账号登录即可。

Kimi Code 插件模式 —— 直接在 Kimi Code 中安装本仓库。插件清单同时捆绑 Skill，并通过客户端归因路由 https://api.agentkey.app/kimi/v1/mcp 提供内联的远程 HTTP MCP 配置，不用粘贴 API Key，也不需要再单独跑 @agentkey/cli：

# 公开安装
/plugins install https://github.com/chainbase-labs/agentkey

# 或从本地 checkout 安装，用于开发
/plugins install /absolute/path/to/agentkey

安装成功后 Kimi 会显示 Run /new or /reload to apply plugin changes.。执行 /reload；当 Kimi 提示插件 MCP 需要 OAuth 时，执行 /mcp-config login plugin-agentkey:agentkey 并在浏览器完成授权，之后即可提出原本的 AgentKey 查询。

Kimi 会把本地插件复制到自己的托管目录。修改原 checkout 后，需要重新执行 /plugins install /absolute/path/to/agentkey，再执行一次 /reload。

如果你曾为旧版 AgentKey plugin 手工通过 /mcp-config 添加过用户全局的 agentkey 条目，请在 reload 前执行一次 /mcp-config remove agentkey 删除旧条目。现在 plugin 会维护自己的命名空间 MCP；同时保留两份会造成工具和鉴权流程重复。

Cursor 插件模式 —— 插件上架后，从 Cursor Marketplace 安装 AgentKey。.cursor-plugin/plugin.json 这个 Cursor 原生清单会同时捆绑同一个 Skill 和内联的远程 HTTP MCP 配置，因此不用粘贴 API Key，也不需要再单独运行 @agentkey/cli。Cursor 提示 MCP 需要认证时，在浏览器完成 AgentKey 登录即可。

维护者需要先把插件推送到公开 Git 仓库，再到 cursor.com/marketplace/publish 提交仓库地址。提交前请使用当前版本 Cursor 实际安装测试，确认 OAuth 完成后 agentkey Skill 和 MCP server 都能正常加载。清单遵循 Cursor 插件参考，其中所有组件路径都必须相对于插件根目录。

Gemini CLI 扩展模式 —— 把本仓库直接安装为 extension。根目录的 gemini-extension.json 会捆绑现有 AgentKey skill 和远程 Streamable HTTP MCP server，不用粘贴 API Key，也不需要再单独跑 @agentkey/cli：

# 公开安装
gemini extensions install https://github.com/chainbase-labs/agentkey

# 或链接本地 checkout，用于开发
gemini extensions link /absolute/path/to/agentkey

安装或链接后重启 Gemini CLI。首次连接时，extension 的 oauth.enabled 会要求 Gemini 自动启动原生浏览器授权；完成授权后执行 /mcp reload 和 /mcp list，确认 agentkey 已连接。如果 Gemini 只提示需要认证，或者浏览器流程被关闭，则执行 /mcp auth agentkey 手动重新发起。Gemini 会保存并自动刷新 OAuth token，因此通常只需要登录一次。Extension 模式下不要再添加一条用户级 MCP 配置，也不要运行 @agentkey/cli --auth-login。

如果 Gemini 提示 ~/.agents/skills/agentkey 覆盖了 extension 捆绑的 Skill，这是独立的 Skill 优先级告警，不是 OAuth 失败。之前安装的用户级 Skill 优先级更高；当两份版本一致时可以安全保留，尤其是其他 Agent 也依赖这个共享目录时。只有确认其他 Agent 不再需要它之后，才执行 gemini skills uninstall agentkey --scope user，再运行 /skills reload。

Antigravity 2.0 / Antigravity CLI 插件模式 —— 两个运行时共用根目录的 plugin.json、mcp_config.json 和现有 skills/。MCP 配置使用 Antigravity 规定的 serverUrl，并通过动态客户端注册自动发现 OAuth，不用粘贴 API Key、不用配置 OAuth client secret，也不需要再单独运行 @agentkey/cli。

Antigravity 2.0 可按 workspace 或全局范围放置插件，完成后重启 Antigravity：

# Workspace 范围
git clone https://github.com/chainbase-labs/agentkey.git /path/to/workspace/.agents/plugins/agentkey

# 或全局范围
git clone https://github.com/chainbase-labs/agentkey.git ~/.gemini/config/plugins/agentkey

Antigravity CLI 使用本地 checkout 安装并确认注册结果：

agy plugin install /absolute/path/to/agentkey
agy plugin list

Antigravity 发现插件后，应认证插件捆绑的 MCP 配置，不要重复添加另一条 server：

• **Antigravity 2.0：**打开 Settings → Customizations → Installed MCP Servers，在 AgentKey 旁点击 Authenticate；在浏览器完成授权后，把 authorization code 复制回设置面板并提交。Server 会自动重连；状态没有更新时点击 Refresh。
• **Antigravity CLI：**打开 /mcp，选择 agentkey 并点击 Authenticate，按界面给出的浏览器/验证码流程完成授权；在同一面板 reload server，确认 AgentKey 工具已经出现。如果仍是 disconnected，可直接在这里检查连接日志。

不要在 mcp_config.json 中写入静态 header、access token 或 OAuth client credential。AgentKey 已发布 protected-resource 与 authorization-server metadata，并提供 dynamic registration endpoint，两个 Antigravity 运行时都应通过这些元数据完成发现。

仓库结构：

agentkey/
├── .claude-plugin/plugin.json   # Claude Code 插件清单
├── .codex-plugin/
│   ├── plugin.json              # Codex 插件清单
│   └── mcp.json                 # Codex MCP 配置（OAuth，无 user_config）
├── .cursor-plugin/
│   └── plugin.json              # Cursor 清单，捆绑 Skill 与内联 MCP OAuth
├── .kimi-plugin/
│   └── plugin.json              # Kimi 清单，内联 MCP OAuth 配置
├── .agents/plugins/marketplace.json  # Codex marketplace（本仓库即自己的 marketplace）
├── .mcp.json                    # Claude 插件 MCP 配置（OAuth 自动发现，无 headers）
├── gemini-extension.json        # Gemini CLI 扩展清单（MCP OAuth + skills）
├── plugin.json                  # Antigravity 桌面端/CLI 插件清单
├── mcp_config.json              # Antigravity 远程 MCP 配置（serverUrl + OAuth）
├── skills/agentkey/
│   ├── SKILL.md                 # 决策树 & 路由规则
│   ├── scripts/                 # check-update 辅助脚本
│   └── version.txt              # 由 release-please 自动维护
└── scripts/
    ├── build-release-assets.sh  # 构建 Skill + Gemini GitHub Release 产物
    ├── install.sh               # 一键安装脚本（mac/linux）
    ├── install.ps1              # Windows PowerShell 安装脚本
    ├── uninstall.sh             # 一键卸载脚本（mac/linux）
    └── uninstall.ps1            # Windows PowerShell 卸载脚本

发布新版本（Maintainer）： 发版由 release-please 自动触发。合并一个 feat: 或 fix: 的 PR 后，release-please 会开一个 Release PR，自动 bump skills/agentkey/version.txt、四个带版本号的插件清单、gemini-extension.json 和 CHANGELOG.md。Antigravity schema 没有 version 字段，因此根目录 plugin.json 不参与版本同步。合并这个 Release PR 即会创建 tag + GitHub Release，保留 agentkey.skill 产物，并上传根目录包含 gemini-extension.json 的平台命名 Gemini 扩展压缩包。

目前产品是什么阶段？

早期内测阶段，产品仍有不少不完善之处，还请担待。功能建议与问题反馈欢迎通过 GitHub Issues 或下面的 Telegram 与我们联系。

怎么获取帮助 / 反馈 bug / 关注更新？

• Telegram： t.me/AgentKey_Official —— 通用咨询、支持、需求反馈
• 问题反馈： GitHub Issues
• 发布公告： ⭐ Star 本项目即可在有新版本时收到通知

---

Star 历史