自动化与运维 oauth2api-keyscredential-managementhttp-proxysecrets-managementauthenticationclipython

Authsome

面向 AI 代理的开源凭证网关:通过 OAuth2 或 API Key 一次登录,所有代理持续保持认证、无头运行——代理永远接触不到你的凭证。

FollowSkills 评估 · FSRS-2.0
谨慎使用
46/ 100 五分制 2.3 / 5
1 2 3 4 5 6
1信任安全12 / 25 · 2.4/5

证据显示:凭据由网关持有、代理注入,skill 明确禁止 agent 接触或打印凭据,尊重 403 策略错误并要求用户确认 OAuth 端点,数据流披露较好。扣分:透明 MITM 代理架构对所有出站 HTTPS 生效,权限范围偏大;skill 未说明凭据存储位置/加密细节与撤销回滚的完整边界;依赖含 posthog(遥测)与 browser-cookie3(读取浏览器 cookie),隐私流向披露不完整;发布者未验证。

2可靠稳定9 / 20 · 2.3/5

证据显示:SKILL.md 结构自洽,含登录流程、401/403 决策树、安装回退与内置 help 引导;evals. 定义了 7 个场景。扣分:静态审读无执行证据,测试套件未覆盖 skill 关键路径;feedback.md 自身记录了 NO_PROXY 绕过代理导致约 8 次失败尝试的真实故障案例,说明 happy-path 声明与实际行为存在偏差,故障反馈成本曾转嫁给用户。

3适用触发7 / 15 · 2.3/5

证据显示:目标场景(agent 访问 Gmail/GitHub/Stripe 等)与触发描述(任何出站 HTTP 调用)清晰,evals 覆盖触发与多种连接状态。扣分:核心功能依赖本地代理守护进程/远程 daemon 及海外 OAuth 提供方,对中国大陆网络可达性无任何说明;无非适用边界声明;无中文支持考量。

4规范维护9 / 15 · 3.0/5

证据显示:MIT 许可明确(Copyright Manoj Bajaj),版本号存在(skill 0.2.0),有 references 分层文档、反馈路径、issue 模板与 CI 工作流,README 有安装与自托管说明。扣分:无 changelog,skill 版本(0.2.0)与包版本(0.7.2)脱节且无说明;关键注册指南依赖外部 raw.githubusercontent URL,稳定性存疑;维护责任与更新路径部分依赖未验证的发布者。

5有效结果6 / 15 · 2.0/5

证据显示:价值主张明确(凭据不进入 agent、免重复配置 auth),evals 描述了可用的输出路径。扣分:静态审读无法验证输出可直接使用;feedback.md 中的失败案例表明实际使用仍可能需要大量调试;相对 gh CLI 等替代方案的边际收益在已认证场景下有限(eval 4 本身也承认 gh 可直接完成)。

6证据核验3 / 10 · 1.5/5

证据显示:evals. 与报告生成脚本构成可审计的评测框架,README 引用 PyPI/CI/codecov 徽章。扣分:仓库内无已提交的评测结果或第三方执行证据,徽章为声明而非静态可验证材料;核心安全声明(凭据不可见、代理注入)无法从文件独立复现。

证据充分度: 评估于 2026年9月10日 审查版本 0d756011a6fe
使用前请注意
  • 静态审读,未执行;所有分数置信度低。
  • 该 skill 将 agent 的全部出站 HTTPS 流量导向透明代理,安装前应确认你接受这一网络层变更及其回滚方式。
  • 依赖含 posthog 遥测与 browser-cookie3(可读取浏览器 cookie),隐私敏感用户应先审查上游代码。
  • 核心功能依赖本地守护进程/远程 daemon 与海外 OAuth 提供方,中国大陆网络可达性未说明,可能不可用。
  • feedback.md 记录的真实故障(NO_PROXY 绕过代理)表明声明的'透明代理'在特定环境下会静默失效。
  • skill 版本 0.2.0 与包版本 0.7.2 不一致,无 changelog,升级行为不可预期。
查看完整评分方法 →

这个 Skill 能做什么,适合哪些场景?

Authsome 是一个位于 AI 代理与其调用的外部服务之间的凭证网关。你只需通过 OAuth2(浏览器 PKCE、设备码或浏览器桥接)或 API Key 完成一次认证,Authsome 会加密存储凭证,并通过 HTTP 代理把凭证注入到出站请求中。代理只需在命令前加 `authsome run --`,网关就会在请求时自动附加正确的认证头,子进程环境中不会暴露任何密钥。它内置大量服务商(Gmail、GitHub、Google 日历/云端硬盘、Stripe 等),支持令牌自动刷新、每个服务商多账号,并可通过 Docker 自托管。采用 MIT 许可,要求 Python 3.13+。

提供 CLI 工具 authsome,具体包括:通过一次性 authsome login <provider> 浏览器流程将 OAuth2 令牌和 API Key 存入加密存储;对以 authsome run -- 包装的命令透明代理出站 HTTPS 流量,按服务商 api_url 匹配并注入认证头;在令牌过期前自动刷新,并按 401(重新登录)与 403(用 --scopes 重新登录)处理失败;通过 authsome provider list/remove/revokeauthsome connections 管理服务商与连接;还可以 Docker + Postgres 方式以守护进程自托管。

  1. 使用 Claude Code 或 Codex 的开发者,想让代理读取 Gmail、查询 Stripe 余额或调用 GitHub API,而不必把令牌粘贴进对话或环境变量。
  2. 在 CI、定时任务、SSH 或后台 worker 中运行代理的团队,初次配置后需要无需人工、无浏览器的持续 API 访问。
  3. 注重安全的工程师,希望所有代理凭证集中在一个加密存储中,可轮换密钥、查看各代理活动,而不是在各个项目里散落硬编码的环境变量令牌。
  4. 自托管基础设施的运维人员,想要一个可掌控 TLS 和备份的集中式凭证守护进程(Docker + Postgres)。
  5. 代理因缺少 OAuth scope 遇到 403 的开发者,需要在既有服务商上用 `--scopes` 重新登录而不是重新注册。

这个 Skill 有哪些优点和局限?

优点
  • 代理永远看不到凭证值——认证在代理进程之外处理,杜绝凭证外泄风险和环境变量中的密钥。
  • 令牌自动刷新,内置 OAuth2/API Key 服务商,免去每个项目重复搭建认证逻辑。
  • 初次登录后完全无头运行,适合 CI、定时任务和后台 worker。
  • 支持每个服务商多账号,提供连接/服务商管理命令,并有清晰的 401/403 故障处理决策树。
  • MIT 开源、可用 Docker 自托管,并为 Claude Code、Codex、Cursor、OpenCode、LangChain、LlamaIndex 及 OpenAI/Anthropic SDK 提供集成。
局限
  • 要求 Python 3.13+,版本门槛较新。
  • 初次配置需要浏览器和人工操作,并非完全零接触。
  • 所有出站流量都经过网关/守护进程代理,多了一个需要信任和维护的环节。
  • 内置服务商之外的新服务商接入需按 references/adding-provider.md 操作,SKILL.md 正文未内联说明流程。
  • 来源未说明 Windows 下的具体行为,也没有安全审计或性能数据佐证。

如何安装这个 Skill?

要求 Python 3.13+。安装 CLI:uv tool install authsome(备选:pipx install authsome,或沙箱/一次性场景用 uvx authsome@latest <command>)。首次设置:authsome onboard(连接远程守护进程时加 --base-url https://...)。为代理添加技能:npx skills add agentrhq/authsome。可选自托管:设置 AUTHSOME_POSTGRES_PASSWORDAUTHSOME_MASTER_KEYAUTHSOME_UI_SESSION_KEY 后运行 Docker Compose,并通过 http://localhost:7998/health 检查。

如何使用这个 Skill?

每个服务商登录一次:authsome login github(浏览器在用户机器上打开,用户完成 OAuth,无需与代理共享凭证)。用 authsome provider list 确认连接。之后在任何出站调用前加网关前缀,例如:authsome run -- curl -s "https://api.github.com/user/repos?per_page=10"authsome run -- python my_agent_script.py。curl、git、requests、axios、Go net/http 等标准 HTTP 客户端会自动遵循 HTTPS_PROXY,无需手动设置认证头。遇到 401 时先 authsome provider revoke <provider> 再重新登录;遇到 403 时带 --scopes 重新登录。具体参数请查看 authsome --help 及各子命令帮助。

这个 Skill 与同类方案有什么区别?

README 自身将 Authsome 与硬编码环境变量令牌和自建认证方案对比:后者需要自行实现令牌刷新、OAuth 流程和密钥隔离;也区别于让用户手动开浏览器操作的方式。与硬编码令牌不同,Authsome 自动刷新令牌、支持每个服务商多账号,并让凭证完全不进入代理进程。

常见问题

Authsome 是免费/开源的吗?
是。采用 MIT 许可,可通过 Docker 自托管。来源提到可用 `AUTHSOME_BASE_URL` 指向托管守护进程,但未说明任何托管服务的定价。
代理是否有可能拿到我的真实令牌?
按项目设计不会。凭证加密存储,由代理在请求时以 HTTP 头注入;代理只执行 `authsome run -- ...`,按项目规则从不接触密钥值。
请求返回 401 或 403 怎么办?
先运行 `authsome provider list`。401 时执行 `authsome provider revoke <provider>` 后重新登录;403 时在既有服务商上带正确的 `--scopes` 重新登录,不要新注册服务商。若 403 响应体是 JSON 策略错误,说明网关主动拦截,不应重试或绕过。
能否在 CI 等无头环境中使用?
可以。浏览器只在首次登录时需要,之后代理完全无头运行。也可以通过 `--base-url` / `AUTHSOME_BASE_URL` 让 CLI 连接远程自托管的守护进程。

相关 Skills