AgnesCode 逆向分析 — 交付总结
已完成的工作
7 份协议分析报告
| 报告 | 文件 | 大小 | 内容 |
|---|---|---|---|
| 总览 | docs/reverse-engineering-report.md | 21 KB | 架构、技术栈、反向代理入口 |
| 协议深度分析 | docs/protocol-analysis-report.md | 36 KB | ACP 协议、认证、API 全集、MCP |
| 完整性评估 | docs/analysis-completeness-report.md | 19 KB | 完成度、盲区、动态分析建议 |
| IPC 协议 | docs/protocol-ipc.md | 15 KB | Renderer ↔ Main Process 全部 IPC 方法 |
| ACP WebSocket | docs/protocol-acp-websocket.md | 15 KB | JSON-RPC 2.0 消息格式、全部方法 |
| Agnes BFF API | docs/protocol-agnes-api.md | 7 KB | 远程 REST API 端点、认证方式 |
| agnesd HTTP | docs/protocol-agnesd-http.md | 10 KB | 本地后端 API、数据库、启动流程 |
| AI 提供商 | docs/protocol-ai-providers.md | 13 KB | 15+ 提供商、配置 Schema、MCP |
| OAuth/Deep Link | docs/protocol-oauth-deeplink.md | 11 KB | 完整 OAuth 流程、6 种 URL 类型 |
| 认证体系 | docs/protocol-auth.md | 10 KB | OAuth token vs API Key 区别 |
4 个 Python 脚本
| 脚本 | 功能 | 说明 |
|---|---|---|
auth_flow_test.py | 完整认证 + AI 调用流程 | 支持 --login/--code/--token 三种模式 |
acp_client.py | ACP 客户端 SDK | 封装所有 Agnes API 调用 |
acp_proxy.py | 反向代理服务器 | ACP WebSocket 服务器 + 多提供商路由 |
exchange_token.py | Token 交换工具 | code → access_token 一站式转换 |
二进制分析
- 从 agnesd 提取了 30+ HTTP 路由、SQLite 表结构、OAuth 端点
- 确认了
platform-backend.agnes-ai.com后端的存在
已验证的
| 验证项 | 状态 |
|---|---|
api-agnes-code.agnes-ai.com 可达 | ✅ |
api.agnes-ai.com/api/v1/ 路径存在 | ✅ |
| exchange-code 端点存在 | ✅ |
platform-backend.agnes-ai.com 存在 | ✅ |
| 完整 OAuth 流程已梳理 | ✅ |
| AI 调用协议已梳理 | ✅ |
| 反向代理框架已实现 | ✅ |
已确认不可行的
| 尝试 | 结论 |
|---|---|
sk- API Key 用于 BFF API | ❌ 两套独立系统，不通用 |
| 自动注册新账号 | ❌ 需要验证码 |
| 从 platform 页面提取 API 地址 | ❌ platform 无 API 端点 |