← 返回列表
需源码安装
一键让 AI 智能体搜索网页并抓取社媒与链上数据
暂不能直接安装(需源码编译或环境不满足):缺少 main/exports/bin 入口声明;仓库 package.json 标记 private,未发布到 npm,需从源码安装。 · 最近上游提交 2026/8/25 · 已提供中文文档
将你的 AI 智能体连接到世界——网页搜索、社交媒体、加密货币与链上数据。一个插件,零额外配置。
综合分
66.5
GitHub 分
66.5
用户评分
—
★ Stars
648
周下载量
—
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add chainbase-labs/Agentkey缺少 main/exports/bin 入口声明;仓库 package.json 标记 private,未发布到 npm,需从源码安装,改用 GitHub 源安装
🟢实装验证通过· 2026/9/17
由 dsh-plugin-verify(GitHub Actions)在真实 dsh 环境安装成功,非静态推断。
数据截至 2026/9/16(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
安装兼容性检查需源码安装
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。
✗npm 包agentkey-skill(未发布到 npm,仅可源码安装)
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✗入口文件缺少入口声明
缺少 main/exports/bin 入口声明;仓库 package.json 标记 private,未发布到 npm,需从源码安装
验证方式:npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/17 00:29:05
用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
一条命令。为你的 AI 智能体提供完整的互联网访问能力。
浏览 Twitter、搜索 LinkedIn、抓取社交媒体、阅读任意网页。零配置。安装即用。
安装 ·
平台 ·
常见问题 ·
中文
安装 AgentKey。赋予你的 AI 超能力。
AgentKey 是智能体生态系统的万能钥匙。在使用 Claude、Manus 或其他智能体时,你经常需要外部数据:社交媒体、电商、链上数据、各种 API。这意味着要四处寻找 API 密钥、管理订阅,或者处处碰壁。
安装 AgentKey 后,你的智能体将自动获得所有这些数据能力。无需逐个服务商注册,无需应付多份 API 账单。一次订阅,即可畅行。
⭐ 为这个仓库点星,即可在我们新增平台支持或发布更新时收到通知。
使用场景
| 你让智能体去做…… | 没有 AgentKey | 有了 AgentKey |
| ------------------------------------------------------ | ----------------------------- | ---------------------------------------------- |
| 🐦 马斯克最近在 Twitter 上说了什么? | 无法访问,推文被屏蔽 | 抓取所有相关推文并总结 |
| 📕 Instagram 上人们怎么评价这个产品? | 被屏蔽,需要登录 | 抓取真实帖子,按情感倾向整理 |
| 📺 这个 YouTube / Bilibili 视频讲了什么? | 无法读取,没有字幕 | 读取视频/文字稿,提取要点 |
| 📖 找找 Reddit 上关于这个痛点的讨论帖 | 403 被屏蔽 | 找到相关帖子并提取解决方案 |
| 👔 查看这个竞争对手 / 候选人的 LinkedIn | 403,访问受限 | 打开页面,总结关键信息 |
| 🎵 抖音 / TikTok 现在什么最火? | 无法抓取热搜榜 | 拉取热门话题和标签 |
| 🌐 这个网页说了什么? | 返回一大堆原始 HTML | 提取内容,并清晰地解释 |
| 📦 这个 GitHub 仓库是做什么的? | 得自己一页页点进去看 | 读取 README 和 Issues,一句话总结 |
| 🧾 这个钱包 / 基金最近在买什么? | 得在区块浏览器里翻来翻去 | 总结近期交易和持仓 |
在使用 AgentKey 之前:10 个任务 → 10 个 API 密钥 → 10 份单独的账单。
你的智能体最多只能算半吊子水平,总是需要人工帮忙找数据、疲于应付各种凭证、淹没在复杂性之中。
现在:一个 AgentKey 搞定一切。AgentKey 统一了你的 AI 完成真正工作所需的所有外部访问。
新手?先从网页开始
在碰终端之前,你可以直接在浏览器里感受一下 AgentKey —— 网站和控制台比这份 README 更直观地解释了各种东西。
- 🌐 agentkey.app —— 产品概览、支持的平台、在线演示、定价详情
- 🎛️ console.agentkey.app —— 注册、管理订阅、管理 API 密钥、追踪用量
下面的一行安装命令才是把 AgentKey 接入你的 AI 智能体的方式。如果你只是想先随便看看,上面两个链接是更友好的起点。
安装
一条命令。会打开一个浏览器标签页用于登录,然后就好了。安装程序会自动检测你机器上的每一个智能体(支持 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
重启你的智能体,然后问它一个需要联网的问题。一个正在运行的 DeepSeek Harness 配置会通过 HMR 监视 home patch;已停止的配置会在下次启动时加载它。
“马斯克最近在推特上聊了些什么?”
就这样。不用复制 API 密钥,不用编辑 JSON。
需要针对特定智能体,或在 CI 中运行? → 参见 FAQ 中的“高级安装选项”条目。
DeepSeek Harness(DSH)
上面的一行安装程序会自动检测 ${DSH_HOME:-~/.dsh} 或 dsh 命令。它们会把 AgentKey 技能全局安装到 ~/.agents/skills/agentkey,用 AgentKey 进行身份验证,并向 DSH 的 home 级 patch 添加一个受管理的 Loader 块:
${DSH_HOME:-~/.dsh}/cordis.patch.yml
这是一个由 CLI 管理的 DSH MCP 集成,而不是原生可安装的 DSH 插件。home 层使用 Loader id agentkey、模块 @deepseek-ai/dsh-mcp-client 以及 MCP serverName: agentkey;它被组合到当前和未来的 profile 之上。工具允许/拒绝策略仍然控制着某个预设、会话或子代理能否看到这些工具。
DSH 0.1.0-rc.7 不会向其 MCP SDK 客户端提供 OAuth authProvider。一个无 header 的服务器条目无法完成 401/RFC 9728 发现流程,也无法打开浏览器。DSH 必须使用下面的设备码命令,以便 CLI 写入本地 Bearer key。
对于仅 DSH 的手动安装,请准确执行以下两步:
npx -y skills add chainbase-labs/agentkey -g -a universal -s agentkey -y
npx -y @agentkey/cli --auth-login --only dsh
CLI 仅将真实 API key 存储在单个本地 home patch 中;任何 key 都不应进入 Git。重新运行该命令会轮换 key 并替换受管理块。不需要任何现有 profile。在迁移期间,它只会从各 profile patch 中移除顶层的、位于第 1 列的 AgentKey 受管理块,并将遗留的 .agent-presets/agentkey 目录重命名为带时间戳的备份;CLI 会打印该备份路径。如果它以结构化方式检测到较旧的、未标记的 AgentKey Loader 行,它会停止且不更改任何 patch,并要求你手动移除该顶层 insert 子项。符号链接的 profile patch 会以只读方式检查:干净的符号链接 profile 会被允许,而任一遗留 AgentKey 形式都会停止安装并报告路径以供手动移除。
只有当前正在运行的 profile 进程会通过 HMR 立即观察到 home 文件变更。已停止和未来的 profile 会在启动时加载它。如果某个旧预设已在某个会话中处于活动状态,请在迁移后关闭该会话或重启一次 DSH。
如何确认 DSH 安装
1. 打开 DSH → Settings → Plugins → Plugin list,搜索已配置的 id agentkey,并展开 mcp-client 行。DSH 0.1 当前会渲染:
- Loader 路径:include:agentkey(稳定的已配置条目 id 是 agentkey)
- 模块标题:@deepseek-ai/dsh-mcp-client(卡片会将其缩短为 mcp-client)
- Cordis 状态:Mounted(底层 fiber 阶段为 active)
Mounted/active 仅证明 Cordis 已加载该行。由于 failOnStartupError: false,它并不证明 MCP 已认证或已连接。
2. 在预期的预设/会话中,确认三个核心工具可见:
- mcp__agentkey__find_tools
- mcp__agentkey__describe_tool
- mcp__agentkey__execute_tool
list_tools 已弃用,不是就绪要求。如果某个核心工具仅在一个上下文中被隐藏,请检查该预设/会话/子代理的工具策略。
3. 询问:“请使用 AgentKey 搜索今天最新的 AI 新闻。” 成功需要实际的 find_tools → describe_tool → execute_tool 调用,而不仅仅是一张 Mounted 卡片。
故障排除:
- 没有 agentkey 行: 主补丁未写入,或 DSH_HOME 指向了别处。请重新运行仅 DSH 的 CLI 命令,并检查其报告的路径。
- 行存在但未挂载/未激活: 检查 Loader 错误,并确认 DSH 安装中存在 @deepseek-ai/dsh-mcp-client。
- 已挂载但工具缺失: 检查 MCP 连接日志、本地 Authorization 密钥以及当前生效的工具策略。在 tools/list 中,每个工具的根级 inputSchema.additionalProperties 必须缺失或为 true,绝不能为 false。
- 401: 本地密钥缺失或无效;请重新运行 auth-login 以轮换密钥。
- serverName already in use: 重新运行当前 CLI,以便它归档旧预设,然后关闭仍持有旧预设的会话,或重启 DSH 一次。
你的智能体现在能做什么
AgentKey 在开放网络上维护云端集成——无需额外账户,无需额外密钥。
| 能力 | 覆盖范围 |
| :--- | :--- |
| 网页搜索 | 搜索引擎、新闻,以及开放网络上的实时发现 |
| 网页抓取 | 从任意 URL 进行干净的文章提取、结构化数据和元数据获取 |
| 链上 / 加密货币 | 代币价格、市场数据、链上活动和项目元数据 |
| 社交与内容 | 各大社交和内容平台上的公开帖子、视频和讨论 |
| 金融 | 股票与外汇报价、技术指标、公司财务和财报 |
| 电子商务 | 各大市场平台上的商品列表、价格、评论和畅销商品 |
| 商业 | 用于市场和竞争研究的公司、融资、投资者和人员数据 |
底层提供商会自动路由,并随时间不断扩展——你的智能体可以调用 find_tools 查看当前可用的能力。
计划中: 地图与天气
常见问题
它安全吗?
安全。AgentKey 是一把主密钥——一个为你的智能体解锁外部能力的平台。按照设计,我们无法访问你的本地文件、你的凭据或你的智能体对话。AgentKey 收集的唯一数据是匿名使用遥测——你安装到了哪个智能体、你的技能版本以及升级结果——绝不收集你的查询或响应。请参阅下方“如何选择退出遥测?”。
这与 Claude / ChatGPT 内置的网页访问有何不同?
Claude 和 ChatGPT 的原生网页访问平台覆盖范围有限。它通常无法访问 Twitter、链上数据等。AgentKey 填补了这些空白。
定价如何运作?如果我用完了套餐的额度怎么办?
AgentKey 采用订阅制。每个套餐包含每月额度;超出部分按即用即付方式作为超额费用计费。你可以随时在 console.agentkey.app 升级套餐或管理账单。当前套餐和定价请见 agentkey.app。
如何更新?
有两个部分,它们的更新方式不同:
- MCP 服务器:真正的服务器托管在 https://api.agentkey.app/v1/mcp,因此它始终是最新的——无需本地升级步骤。@agentkey/cli 包(以 npx -y @agentkey/cli --auth-login 运行)只是将远程 HTTP MCP 配置写入每个 AI 客户端,除非你想轮换密钥,否则无需重新运行。
- 技能文件(SKILL.md + 辅助文件):其更新方式取决于你的客户端。
Claude Code
更新是自动的。在会话的第一次调用时,技能会运行一次静默的版本检查;如果有新版本可用,它会提示你升级,并在你同意的情况下运行 npx skills update -g agentkey。
Claude Desktop、Cursor 以及其他没有内联 Bash 工具的客户端
技能本身无法运行内联检查,但从 v1.4.0 开始,MCP 服务器通过一个专用的元数据工具(agentkey_skill_meta)发布最新的技能版本。你的 agent 每个会话调用它一次,将其与此技能自身的版本进行比较,并提示你使用适合你客户端的准确命令进行升级。有关协议详情,请参阅 protocol/skill-meta-v1.md。
Desktop 上的一次性引导: 如果你在 Claude Desktop 中卡在 1.4.0 之前的技能上,元数据工具已存在,但你的技能规则不知道如何读取它。使用以下命令让自己更新一次:
Replace / with the actual session folder under skills-plugin
(usually there's just one; pick the one that contains 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
Then fully quit and restart Claude Desktop.
完成这一次引导后,未来的版本将通过元数据工具自动被发现。
强制手动更新(任何客户端)
Refresh the skill content
npx skills update agentkey
Pin a specific version
npx skills add chainbase-labs/agentkey@v1.0.0
注意:npx skills update 会写入 ~/.agents/skills/agentkey 和 ~/.claude/skills/agentkey,这正是 Claude Code 读取的位置。Claude Desktop 从它自己的沙盒路径读取,不受 npx skills update 影响——对于 Desktop,请使用上面的 Desktop 引导命令。
仅当你想要轮换 API 密钥时,才需要重新运行 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
从每个 agent 中移除该 skill,从所有 MCP 客户端配置中删除 agentkey MCP 条目和 API key,并清除缓存/日志。传入 --keep-marketplace(bash)/ -KeepMarketplace(PowerShell)以保留 Claude Code 插件市场条目。
更倾向于手动两步操作?
1. Remove the skill from every agent
npx skills remove chainbase-labs/agentkey
2. Delete the "agentkey" entry under mcpServers in each MCP client config:
- 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 部分以及 MCP stdio 日志——如果你想要完全干净的状态,请使用它。
如何选择退出遥测?
AgentKey 会发送匿名使用遥测(你使用哪个 agent、skill 版本、升级结果——绝不包含查询或响应)。有三种退出方式,任意一种都有效:
Persistent opt-out (recommended)
touch ~/.config/agentkey/telemetry-disabled
One-shot env override (CI / single session)
AGENTKEY_TELEMETRY=0
At install time
curl -fsSL https://agentkey.app/install.sh | bash -s -- --no-telemetry
要重新启用,请删除 ~/.config/agentkey/telemetry-disabled。
某些功能不工作——我该如何检查?
在你的 agent 中,尝试 /agentkey status——它会诊断你的 MCP 配置、版本和连接性。
可用的斜杠命令:
| 命令 | 作用 |
|---------|--------------|
| /agentkey | 在数据查询期间自动触发——你通常不需要手动调用它 |
| /agentkey setup | 首次设置:配置 API key + 验证 MCP 连接性 |
| /agentkey status | 诊断当前配置(MCP、版本、连接性测试) |
仍然卡住了?请参阅下面的“我在哪里可以获得帮助”条目。
高级安装选项(CI / 特定 agents / 手动两步操作)
安装程序会自动检测你在此机器上安装了哪些 AI agents(通过探测来自 vercel-labs/skills supported-agents list 的已知配置目录和二进制文件)并预先选择它们——没有多选提示。使用下面的标志进行覆盖。
安装程序标志:
Non-interactive (CI / unattended): install to every detected agent, no prompts
curl -fsSL https://agentkey.app/install.sh | bash -s -- --yes
See which agents the installer would auto-select on this host (and exit)
curl -fsSL https://agentkey.app/install.sh | bash -s -- --list-agents
Only install the skill for specific agents (overrides auto-detection)
curl -fsSL https://agentkey.app/install.sh | bash -s -- --only claude-code,cursor
跳过我们的代理检测;让 skills CLI 为它找到的每个代理安装
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 安装到每个检测到的代理中
npx skills add chainbase-labs/agentkey
2. 认证并注册 MCP 服务器
npx -y @agentkey/cli --auth-login
无头 / SSH / Docker? 认证步骤总是会尝试打开浏览器并打印 URL——因此,在没有可用显示器的机器上,只需将打印出的 URL 复制到任何有浏览器的设备上即可完成认证。更想手动输入密钥?npx -y @agentkey/cli --setup 会打开一个交互式向导。
我的代理不在自动配置列表中——如何手动设置?
CLI 支持其当前支持的代理列表中显示的客户端,一行式安装脚本会针对它检测到的受支持客户端——包括 DeepSeek Harness。如果你的客户端未被检测到或不受自动配置支持,该 skill 仍可全局安装,但你必须将以下 MCP 片段粘贴到该客户端自己的配置中(路径因客户端而异):
{
"mcpServers": {
"agentkey": {
"type": "http",
"url": "https://api.agentkey.app/v1/mcp",
"headers": { "Authorization": "Bearer ak_..." }
}
}
}
然后重启代理。该 skill 的首次运行激活也会引导你完成此操作。
我可以自行托管或基于此进行开发吗?
从本地检出安装:
git clone https://github.com/chainbase-labs/agentkey.git
cd agentkey
1. 将你的工作树安装到每个检测到的代理中
npx skills add .
2. 注册 MCP 服务器(如果你还没有注册)
npx -y @agentkey/cli --auth-login
npx skills add . 接受本地路径(或 file:// URL)——每次编辑 skills/agentkey/SKILL.md 后都要重新运行它。MCP 步骤每台机器只需运行一次。
要对 MCP 服务器本身进行迭代开发? 该服务器位于 AgentKey-Server/(Go),并在 /v1/mcp 暴露 MCP 端点。运行本地服务器(make run),并将你的 MCP 配置指向 http://localhost:8081/v1/mcp,以进行端到端测试更改。
Claude Code 插件模式——直接从市场安装。该插件捆绑了一个无需 header 的远程 HTTP 入口,并使用 Claude Code 原生的 MCP OAuth 流程,因此无需粘贴 API 密钥,也无需第二步 @agentkey/cli:
公开安装bash
claude plugin marketplace add chainbase-labs/agentkey
claude plugin install agentkey@agentkey
…或从本地检出安装,用于开发
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 头:添加该头会使 Claude Code 将该服务器视为使用头认证,并在 401 后抑制 OAuth 回退。编辑后,使用 claude plugin update agentkey 重新加载本地检出。日常的 Skill 迭代仍然通过 Skills CLI 路径最快;插件路径是面向 Claude Code 用户的基于 OAuth 的选项。
Codex 插件模式 —— 从本仓库中捆绑的 marketplace 安装。认证方式为 OAuth(安装时通过浏览器登录),因此无需粘贴 API 密钥,也无需第二步 @agentkey/cli:
bash
公开安装
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 以及一个内联的远程 HTTP MCP 条目,位于客户端归属的 https://api.agentkey.app/kimi/v1/mcp 路由,因此无需粘贴 API 密钥,也无需第二步 @agentkey/cli:
text
公开安装
/plugins install https://github.com/chainbase-labs/agentkey
或安装本地检出用于开发
/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 会将本地插件复制到其托管的插件目录中。编辑检出后,重新运行 /plugins install /absolute/path/to/agentkey,然后再次运行 /reload。
如果你之前为了绕过旧版 AgentKey 插件,通过 /mcp-config 添加了用户全局的 agentkey 条目,请在重新加载前先用 /mcp-config remove agentkey 移除该旧条目。该插件现在拥有其带命名空间的 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 提交仓库 URL。在提交之前,在当前 Cursor 版本中测试该插件,并确认在 OAuth 之后 agentkey Skill 和 MCP 服务器都能成功加载。该清单遵循 Cursor 插件参考;保持其组件路径相对于插件根目录。
Gemini CLI 扩展模式——将该仓库作为扩展安装。根目录的 gemini-extension.json 打包了现有的 AgentKey skill 和远程 Streamable HTTP MCP 服务器,因此无需粘贴 API key,也无需第二步 @agentkey/cli:
bash
Public install
gemini extensions install https://github.com/chainbase-labs/agentkey
Or link a local checkout for development
gemini extensions link /absolute/path/to/agentkey
安装或链接后重启 Gemini CLI。在首次连接时,该扩展的 oauth.enabled 设置会要求 Gemini 自动启动其原生浏览器授权。完成该流程,然后运行 /mcp reload 和 /mcp list 以确认 agentkey 已连接。如果 Gemini 仅报告需要身份验证,或者浏览器流程已关闭,请运行 /mcp auth agentkey 手动启动它。Gemini 会存储并刷新 OAuth 令牌,因此这通常是一次性登录。不要在扩展模式下添加第二个用户级 MCP 条目或运行 @agentkey/cli --auth-login。
如果 Gemini 报告 ~/.agents/skills/agentkey 覆盖了该扩展打包的副本,那是单独的 Skill 优先级警告,而不是 OAuth 失败。先前安装的用户 Skill 具有更高优先级,当版本相同时可以安全保留——尤其是如果其他代理使用该共享目录。仅当其他地方不再需要它时,才使用 gemini skills uninstall agentkey --scope user 将其移除,然后运行 /skills reload。
Antigravity 2.0 / Antigravity CLI 插件模式——两个运行时都使用根目录的 plugin.json、mcp_config.json 和现有的 skills/ 目录。MCP 条目使用 Antigravity 的 serverUrl schema,并通过动态客户端注册进行自动 OAuth 发现,因此无需粘贴 API key,无需配置 OAuth 客户端密钥,也无需第二步 @agentkey/cli。
对于 Antigravity 2.0,将仓库放在工作区范围或全局范围,然后重启 Antigravity:
bash
Workspace scope
git clone https://github.com/chainbase-labs/agentkey.git /path/to/workspace/.agents/plugins/agentkey
Or global scope
git clone https://github.com/chainbase-labs/agentkey.git ~/.gemini/config/plugins/agentkey
对于 Antigravity CLI,安装本地检出并验证其已注册:
agy plugin install /absolute/path/to/agentkey
agy plugin list
在 Antigravity 发现该插件后,对其捆绑的 MCP 条目进行身份验证,而不是添加重复条目:
- Antigravity 2.0: 打开 Settings → Customizations → Installed MCP Servers,点击 AgentKey 旁边的 Authenticate,完成浏览器流程,将授权码复制回设置面板并提交。服务器会自动重新连接;如果状态未更新,请点击 Refresh。
- Antigravity CLI: 打开 /mcp,选择 agentkey,选择 Authenticate,然后按照浏览器/代码提示操作。在同一面板中重新加载服务器,并确认列出了 AgentKey 工具;如果它仍处于断开状态,请在那里检查其连接日志。
保持 mcp_config.json 中不包含静态标头、访问令牌和 OAuth 客户端凭据。AgentKey 会发布受保护资源和授权服务器元数据,包括动态注册端点,供两个 Antigravity 运行时发现。
仓库布局:
agentkey/
├── .claude-plugin/plugin.json # Claude Code 插件清单
├── .codex-plugin/
│ ├── plugin.json # Codex 插件清单
│ └── mcp.json # Codex MCP 条目(OAuth,无 user_config)
├── .cursor-plugin/
│ └── plugin.json # 带有 Skill + 内联 MCP OAuth 的 Cursor 清单
├── .kimi-plugin/
│ └── plugin.json # 带有内联 MCP OAuth 条目的 Kimi 清单
├── .agents/plugins/marketplace.json # Codex 市场(此仓库即其自身的市场)
├── .mcp.json # Claude 插件 MCP 条目(OAuth 发现,无标头)
├── gemini-extension.json # Gemini CLI 扩展清单(MCP OAuth + 技能)
├── plugin.json # Antigravity 桌面/CLI 插件清单
├── mcp_config.json # Antigravity 远程 MCP 条目(serverUrl + OAuth)
├── skills/agentkey/
│ ├── SKILL.md # 决策树 + 路由规则
│ ├── scripts/ # 检查更新辅助脚本
│ └── 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 卸载程序
发布新版本(维护者): 版本由 release-please 自动发布。合并标题为 feat: 或 fix: 的 PR 会开启一个 Release PR,该 PR 会更新 skills/agentkey/version.txt、全部四个带版本的插件清单、gemini-extension.json 以及 CHANGELOG.md。Antigravity schema 没有 version 字段,因此其根目录下的 plugin.json 不参与版本同步。合并 Release PR 会创建 tag + GitHub Release,保留 agentkey.skill 资源,并上传以平台命名的 Gemini 扩展归档,其根目录包含 gemini-extension.json。
产品目前处于什么阶段?
早期访问。目前还有一些粗糙之处,感谢你的耐心。欢迎通过 GitHub Issues 或 Telegram(见下文)提交功能请求和 bug 报告。
我在哪里获取帮助 / 报告 bug / 关注更新?
- Telegram: t.me/AgentKey_Official — 一般问题、支持、功能请求
- Bug 报告: GitHub Issues
- 发布公告: ⭐ star 此仓库以获取通知
Star 历史
Star History Chart扫码进群