工作盲区与下一步计划
已完成工作
| 工作项 | 状态 | 产出 |
|---|---|---|
| 官网调研 & 二进制下载 | ✅ | 5 个平台文件下载到 data/ |
| 源码结构分析 | ✅ | 243 个 crate 概览 |
| AI 通信协议分析 | ✅ | 完整协议文档 |
| 登录授权协议分析 | ✅ | 完整流程文档 |
| 反向代理方案设计 | ✅ | 方案文档 |
| 免费额度分析 | ✅ | 分析文档 |
| Python 授权脚本 | ✅ | 完整脚本 |
| 整体架构分层分析 | ✅ | docs/architecture/overview.md(243 crate 六大层次/核心数据流) |
| Agent 核心设计分析 | ✅ | docs/architecture/agent-core.md(Thread 主循环/权限/沙箱) |
| Agent 工具系统分析 | ✅ | docs/architecture/agent-tools.md(32+ 工具/流式编辑/MCP) |
| ACP 与外部 Agent 分析 | ✅ | docs/architecture/agent-servers.md(统一抽象/JSON-RPC 桥接) |
| LLM 抽象层与 Provider | ✅ | docs/architecture/language-model-layer.md(三层抽象/20 Provider) |
| 会话持久化 | ✅ | docs/architecture/agent-persistence.md(SQLite schema/zstd 序列化) |
| ACP 协议客户端 | ✅ | docs/architecture/acp-protocol-client.md(双向 JSON-RPC/方法清单) |
| Agent UI 与技能 | ✅ | docs/architecture/agent-ui-skills.md(面板状态机/Skills 格式) |
| crate 源码覆盖 | ✅ | notes/reports/ 89 份报告,243 个 crate 逐一定位(覆盖度 100%) |
公开状态说明
本项目已于 2026-08-17 公开发布(
vibe-coding-labs/zed-reverse-engineer)。所有协议/架构分析均基于 Zed 源码阅读(243 个 crate 覆盖 100%)。协议实现已于 2026-08-17 通过本地 mock 全链路验证(
scripts/zed_mock_server.py+scripts/zed_test.py,4/4 测试通过:授权 → 用户 → 建 LLM token → 模型 → 流式补全),但尚未使用真实账号向 cloud.zed.dev 发起过实际请求验证。下方 P0 的真实账号端到端与 OAuth 实测保留为未来工作,属于待验证而非已完成的状态。结论来源定位:源码推导(理论)+ 本地 mock 接口验证, 验证程度:真实账号实测 0 次(本地 mock 全链路 4/4 通过)。
分析盲区(按优先级)
P0 — 待验证(非已完成)
端到端实测(真实账号) — 协议实现已通过本地 mock 全链路验证(4/4),但从未用真实账号向 cloud.zed.dev 发过请求,真实服务器行为未验证。
OAuth 流程实测(真实账号) — 回调服务器 + RSA 解密逻辑已实现且 mock 下覆盖,但从未真实跑通过(需真实 GitHub 登录)。
P1 — 重要
反向代理实现 — 只有设计文档,没有实际代码。
账号池设计 — 多账号如何存储、检测过期、自动切换。
P2 — 锦上添花
- Collab RPC 协议分析(protobuf 版本 68)
- Edit Prediction (Zeta2) 协议分析
- 二进制逆向分析
优先级排序
P0 ────────────────────────────────────────────────
├── 端到端实测(验证协议推导)
│ └── 用 scripts/zed_auth_flow.py 跑一次真实登录
│
P1 ────────────────────────────────────────────────
├── 实现反向代理(Zed ←→ 代理 ←→ Claude Code)
├── 实现账号池(多账号自动切换)
│
P2 ────────────────────────────────────────────────
├── Collab RPC 分析
├── Edit Prediction 分析
└── 二进制逆向分析下一步行动
P0 最佳方式: 在这台机器上用 Playwright 自动化 GitHub OAuth 流程,拿到真实凭证后验证所有 API 端点。
P1 前置条件: P0 验证完成后,开始实现 ZED_SERVER_URL 劫持反向代理。
P2: P0/P1 全部完成后,再分析其他协议。
参考
notes/06-blindspots-and-next-steps.md— 完整盲区分析scripts/zed_auth_flow.py— OAuth 全自动化脚本