架构与源码仓库
EvoX 的桌面交互、核心运行时、经验引擎与公开网站分别拥有自己的源码和发布产物。先确定修改对象及接口归属,再选择仓库,避免把文档、客户端和协议变更混成一次无法独立验收的交付。
系统如何协作
Desktop 提供界面、项目工作区与系统集成,通过受管理的核心运行时承接 Agent 执行。Evolver 负责经验资产、复用与进化流程,Proxy 将对应工具暴露给 Agent;Hub 承接网络身份、资产和任务协议。网站提供产品说明、文档与下载入口。
| 层级 | 源码或集成入口 | 修改对象 | 验收依据 |
|---|---|---|---|
| Desktop | EvoMap/evox-desktop | React 界面、Go/Wails 绑定、工作区、终端、系统集成、安装与更新 | 前后端契约、桌面交互、平台构建和安装产物 |
| 核心运行时 | EvoMap/evox | 核心 Agent 运行时及 evox-cli | 所属仓库的接口契约、测试与发布产物 |
| Evolver | EvoMap/evolver | CLI、Proxy、MCP、Gene/Capsule/Recipe 与本地记录 | 包入口、schema、单元与集成测试、npm 产物 |
| 网站 | EvoMap/evomap-website | 产品页、文档、下载清单消费和网站交互 | 内容与路由校验、浏览器验收和站点发布 |
| Hub 协议 | A2A 接入指南 | 节点认证、资产提交与任务请求 | 服务端契约、响应、操作状态和接收回执 |
从源码找到实际行为
在 Desktop 中,从 frontend/src 的页面与组件追踪用户操作,再查看 backend/bindings 对应的 Go 绑定与服务调用。界面显示一个开关,只能证明存在交互入口;保存、作用域、执行与恢复需沿调用链分别确认。
开发 Evolver 集成时,从 CLI 命令或 Proxy 工具的 schema 开始,追踪本地写入、远端请求和结果记录。读取源码中的内部函数不代表该函数是对外稳定接口。桌面内部绑定和 sidecar 调用也不能直接当作通用 HTTP API。
跨仓变更的交付顺序
- 在接口拥有方定义输入、输出、错误及兼容行为,并完成测试。
- 发布可验证的包或运行产物,记录消费方使用的依赖坐标。
- 在 Desktop 或 Agent 集成中验证连接、真实操作与失败恢复。
- 最后更新网站说明与下载入口,核对实际交付行为。
代码合并、桌面安装包发布、npm 发布与网站上线分别验收。一个仓库的绿灯不能替代另一交付物的构建与运行验证。
Desktop 交付按各支持平台分别检查安装启动与更新行为、产物摘要、签名、macOS 公证或 Windows 签名与时间戳要求,并核对发布清单与更新、下载消费者的一致性。受管理 sidecar 的生命周期、前后端接口契约与安装成功分别验收。
Evolver 变更保留运行时与包入口、声明的 Node engines、schema、已有本地数据及凭证边界。网站下载入口消费已发布的元数据;清单缺失、不一致或无法核验时停止该发布入口,不编造产物地址或标记发布就绪。各源码仓库定义自己的发布门禁;网站部署不发布 Desktop 安装包或 npm 包。
保持修改范围清晰
代码审阅需包含变更接口的调用方、持久化和失败路径。提交前确认没有混入其他工作区、凭证、缓存或构建输出。对外能力以实现和发布产物为证据,不以截图、mock 或计划说明推断。