Synergy：把 AI Agent 的工作变成可恢复的持久状态
该项目围绕「SII-Holos/synergy」构建，面向真实业务场景提供可复用的开源实践方案，支持稳定落地与可扩展的项目实践。
秒懂
- 它是什么？
- Synergy 是一个本地优先的开源工作区，将 AI Agent 的会话、文件、浏览器和工具整合进单一运行时。它用持久化 Scope 和可恢复会话解决任务中断问题，但基准测试的时效性和多安装通道的冲突值得注意。
- 适合谁用？
- Synergy 适合那些需要长时间运行、经常中断后恢复的软件和知识工作团队，尤其是愿意在本地维护一个常驻运行时的用户。它不适合只想跑一次性脚本或依赖云端托管的轻量用户，因为桌面版、CLI 和包管理器多通道并存容易引发命令冲突，且基准数据基于涨价前的 API 价格，实际成本可能更高。
- 能商用吗？
- 可以。MIT 是宽松许可证：你可以使用、修改并销售基于它的软件，只需保留版权和许可证声明。
- 还在维护吗？
- 在维护。仓库在最近一天内有新的提交。
- 用什么语言写的？
- 主要是 TypeScript（依据 GitHub 的语言统计）。
以上回答依据项目的 GitHub 数据（最近同步于 2026年9月15日）和我们的分析，不构成法律意见。
开源项目深度解析
一个把 Agent 工作当持久状态处理的运行时
Synergy 要解决的问题很具体：AI Agent 的工作经常超过一次对话的寿命。模型上下文会被压缩，会话会关闭，任务进行到一半就丢失。Synergy 把 Agent 工作当作工作区状态来持久化，让任务能在 Web、桌面、CLI、后台执行之间移动，同时保留项目、历史、文件和工具。它面向的是软件开发和知识工作场景，尤其是那些需要跨多个会话、甚至跨天完成的任务。README 里的关键词是“durable by default”，默认就持久，不是事后补救。
Scope、Blueprints 和 Boss Mode：协调机制的具体分工
Synergy 的架构核心是 Scope，每个会话都挂在一个显式的 home 或 project Scope 下，历史完整保留，即使模型上下文被压缩也不丢。协调层面有几种模式：Blueprints 是持久化的计划，可以重复执行；BlueprintLoops 是独立审查的循环；Light Loop 处理轻量任务；Boss Mode 则编排一棵持久化的专家子代理树。这些机制不是摆设，README 明确说它们用于“delegate”和“orchestrate”，意味着用户可以把复杂任务拆给多个子代理，每个子代理有自己的上下文和状态。文件系统和浏览器会话也保持在同一个上下文里，不需要把任务挪到别的工具。
安装与命令行：一条 curl 命令，但通道冲突是真的
快速开始很简单。桌面版从 GitHub Releases 下载安装包，macOS 用 .pkg，Windows 用 NSIS .exe，Linux 用 .deb。CLI 安装用一条命令：`curl -fsSL https://raw.githubusercontent.com/SII-Holos/synergy/main/install | bash`。然后运行 `synergy config wizard` 配置模型提供商，`synergy start` 启动后台运行时，`synergy web` 打开 Web 客户端。直接跑一个任务用 `synergy send "summarize this repository"`。诊断命令有 `synergy status`、`synergy logs`、`synergy doctor`、`synergy stop`。注意，CLI 安装器把运行时放在 `~/.synergy/`，可以通过 `SYNERGY_HOME=/path` 改变根目录，但它不装 Electron 桌面应用。一个机器可以同时存在 CLI、包管理器安装和桌面版，但只有一个应该是 shell 里的 `synergy` 命令。`synergy doctor` 会列出所有检测到的安装通道，如果冲突就退出非零。升级时如果多通道存在，`synergy upgrade` 会停下来，要求你用 `--method` 指定通道。这是设计上的谨慎，但也意味着多通道用户每次升级都要多一步操作。
基准测试：数字好看，但价格时效性有硬伤
README 引用了 DeepSWE v1.1 基准，113 个真实仓库工程任务。同一个模型 deepseek-v4-flash 在 synergy-max 代理下 Pass@1 从 53% 升到 67.3%，成本 $0.54/task。这个提升幅度不小，而且 76 个任务完全通过，24 个未通过的任务只差 1 到 2 个测试，说明不是系统性失败。但有个关键限制：所有成本计算用的是 2026-08-17 之前的价格，DeepSeek 在那之后全面涨价并引入了峰谷定价。README 自己标注了这一点，意味着 $0.54/task 在当前价格下可能偏高。另外，Synergy 的数字来自本地全基准运行，不是官方 leaderboard 上的第三方验证。如果你要用这个数字做预算，必须先按现在的 API 价格重算。
扩展边界：本地优先，但 Holos 连接是可选的
Synergy 定位是本地优先，数据归你所有。它支持添加 providers、tools、Skills、commands、MCP servers、plugins、Channels 和远程 Synergy Link 目标。插件系统有官方和本地注册表，可以扩展技能和 UI。一个重要的边界是：连接 Holos agent 会加入账户身份、消息、在线状态和 Synergy Link 远程执行，但这不会替换你本地的项目、提供商、会话或数据。换句话说，Holos 是可选增强，不是依赖。README 提到产品模型里还有 Lattice Pathways、Agenda、Channels、Library 等概念，但细节在 docs/product/overview.md 里，资料没展开。如果你需要完整的扩展机制说明，得去读那个文档。
许可证与维护成本：MIT 下自由改，但升级路径要自己管
项目采用 MIT 许可证，这意味着你可以自由使用、修改和分发，商用也没问题。维护成本方面，更新频率不算低，最近三个版本 v3.0.21、v3.0.19、v3.0.18 都在 2026 年 8 月内发布，说明项目处于活跃迭代期。升级命令是 `synergy upgrade`，但多通道时必须手动指定 `--method`，否则命令会停止。安装器不会自动卸载其他通道，只会警告。这意味着你升级时可能留下旧版本，长期下来磁盘占用和配置漂移是实际成本。另外，Homebrew 的 `synergy` formula 与这个项目无关，`synergy doctor` 不会检测它，如果你之前用过 Homebrew 版本，需要自己注意区分。
替代方案：对比原生 harness 和云端 Agent 平台的差异
README 里隐含的替代方案是模型的 stock harness，比如 mini-swe-agent 的官方运行方式。Synergy 的差异在于它把状态持久化、子代理协调和文件上下文都包进一个运行时，而 stock harness 通常是一次性会话，任务结束状态就没了。另一个替代是云端 Agent 平台，比如托管式的 coding agent 服务，它们帮你管理基础设施，但数据不在你手上，且通常按任务或按席位收费。Synergy 选择了本地运行时，你要自己维护 `synergy start` 的后台进程，处理升级和通道冲突。如果你不想管这些，云端平台更省事，但你就失去了本地数据所有权和可恢复性的控制。
编辑结论
Synergy 适合那些需要长时间运行、经常中断后恢复的软件和知识工作团队，尤其是愿意在本地维护一个常驻运行时的用户。它不适合只想跑一次性脚本或依赖云端托管的轻量用户，因为桌面版、CLI 和包管理器多通道并存容易引发命令冲突，且基准数据基于涨价前的 API 价格，实际成本可能更高。在采用前，先确认你的模型提供商能通过 `synergy config wizard` 正确配置，并检查 `synergy doctor` 的输出，确保只有一个安装通道被 shell 使用。如果任务需要严格的成本预测，请基于当前 DeepSeek 定价重新计算，而不是依赖 README 中的 $0.54/task 数字。
社区笔记