Synergy：面向持久 AI 代理工作的本地優先工作區
此專案圍繞「SII-Holos/synergy」建置，面向真實業務場景，提供可重複使用、可持續維運的開源實作。
秒懂
- 它是什麼？
- 一個開源執行環境，將工作階段、代理、檔案、瀏覽器、工具與自動化連結於 Web、桌面、CLI 與 API 中。
- 適合誰用？
- Synergy 以 MIT 授權發布，不提供任何明示或暗示的擔保。根據所查閱的元資料，該儲存庫目前有 542 個星標、14 個分支與 20 個未解決問題，預設分支為 dev。
- 可以商用嗎？
- 可以。MIT 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
- 還在維護嗎？
- 有在維護。儲存庫在最近一天內有新的提交。
- 用什麼語言寫的？
- 主要是 TypeScript（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月15日）與我們的分析，不構成法律意見。
開源專案深度解析
面向代理工作的開源工作區
Synergy 是一個用於軟體與知識工作的開源工作區。它自稱提供持久、可恢復的 AI 代理工作，並在單一執行環境中連接工作階段、代理、檔案、瀏覽器、工具與自動化。該專案由上海創智學院的 Holos 團隊開發。儲存庫以 TypeScript 撰寫，並組織為使用 ESM 模組的 Bun 單一儲存庫。儲存庫描述稱其為面向開放代理網路的新一代通用代理，但 README 更側重於本地工作區與可選的 Holos 代理連線。
超越單次對話的工作
AI 代理工作往往比單次對話更持久。Synergy 將其視為持久的工作區狀態。任務可以在 Web、桌面、CLI、背景執行與專用代理之間移動，同時保留專案、歷史、檔案、工具與操作上下文。工作階段附加到明確的家庭或專案範圍，即使舊模型上下文被壓縮，完整歷史也會保留。README 列出了多種特性，包括跨表面的統一執行環境、透過子代理與 Blueprint 進行的一流代理協調、檔案與瀏覽器保持上下文，以及透過 Library 與 Notes 實現知識累積。
四個產品表面，共享同一狀態
Synergy 提供 Web、桌面、CLI 以及伺服器 API 與 SDK。Web 工作台是工作階段、專案檔案、瀏覽器、Notes、Library、Agenda、外掛與設定的主要介面。桌面應用是基於 Electron 的產品，帶有受管打包伺服器、原生瀏覽器展示、本地資料夾選取、協定處理與更新。CLI 負責執行環境管理、一次性 send 執行、設定、工作階段、整合、診斷與開發工作流程。伺服器 API 與 SDK 構成第一方用戶端與整合使用的共享契約。README 聲明所有表面使用相同的工作階段與狀態。
快速開始：桌面與 CLI 安裝
桌面安裝程式針對 macOS 發布為 .pkg，Windows 為 NSIS .exe，Linux 為 .deb。它們包含應用並將打包的執行環境暴露為 synergy CLI。還發布了可攜式建構，但不會設定系統 CLI。對於 CLI 與 Web，README 提供了一個 curl 安裝腳本，將執行環境、Web UI 與模式資產放在 ~/.synergy/ 下；設定 SYNERGY_HOME 可以更改該根目錄。安裝後，使用者執行 synergy config wizard、synergy start 與 synergy web。可以透過 synergy send 傳送一次性任務。README 還列出了 status、logs、doctor 與 stop 命令。無頭瀏覽器工具需要 Chromium，可透過 synergy browser install 安裝。
從原始碼開發 Synergy
Synergy 是一個使用 TypeScript ESM 模組的 Bun 單一儲存庫。套件管理員固定在 package.json 中宣告。開發者執行 bun dev prepare，然後執行 bun dev server、bun dev app --open、bun dev web 或 bun dev desktop。核心執行環境測試在 packages/synergy 下執行，使用 bun test 或 bun run test:ci。前端套件透過標準腳本執行，並包含在 bun run quality 中。瀏覽器能力變更需要建置與私有 HTTP 冒煙測試。README 還描述了本地化：前端副本提取為英語與簡體中文目錄以及偽目錄，更改後執行 i18n:extract 與 localization:check。在自行使用 Synergy 開發時，建議啟動隔離的第二個執行個體。
透過外掛與技能擴展
外掛作者無需複製儲存庫即可開始。README 展示了使用 @ericsanchezok/synergy-plugin-kit 從 tool-ui 範本建立外掛，然後建置並驗證外掛的命令。外掛文件位於 docs/plugins/README.md，API 參考位於 packages/plugin/README.md。Synergy 還支援新增提供者、工具、技能、命令、MCP 伺服器、外掛、通道與遠端 Synergy Link 目標，同時保留對專案與資料的本地所有權。README 為編碼代理提供了 llms.txt，為儲存庫修改提供了 AGENTS.md。
授權、貢獻與安全
Synergy 以 MIT 授權開源。授權授予使用、複製、修改、合併、發布、分發、再授權與出售副本的權利，並附有條件。它明確否認擔保與責任。README 歡迎貢獻、錯誤報告與功能建議，並指向 CONTRIBUTING.md 與行為準則。安全漏洞應透過儲存庫的安全回報流程報告，而不是公開問題。根據儲存庫元資料，Synergy 有 542 個星標、14 個分支與 20 個未解決問題，預設分支為 dev。
針對 Synergy，實際閱讀時應把 Scope、Session、Agenda、Library 與 Blueprint 分開記錄。Scope 決定工作歸屬，Session 保存歷史，Agenda 負責排程，Library 保存可重用經驗，Blueprint 則承載可持續的工作文件。這些名稱在 README 中各自有位置，不能把它們簡化成一般聊天紀錄。CLI 的 synergy status、synergy logs、synergy doctor 與 synergy stop 也各有不同用途，前者看狀態，後者看執行紀錄，doctor 檢查安裝衝突，stop 結束執行個體。評估本機部署時，應先確認 SYNERGY_HOME、模型供應商與實際使用的安裝管道，再觀察工作是否能從 Web、Desktop 或 CLI 取回。
sii 的 README 還提供了幾個值得逐項對照的實作訊號。先看專案明列的安裝版本、啟動命令、設定檔和輸出位置，再分辨哪些內容是程式入口，哪些內容只是網站或範例的說明。這個區分會直接影響使用者能否重現結果，也會影響升級時要檢查的範圍。若文件只說明能力而沒有列出操作細節，文章便只保留該項聲明，不把它延伸成相容性保證。對於需要外部服務、模型、電信商、遊戲資料或作業系統支援的功能，也要把外部條件寫在判斷裡。實際採用時，先以最小輸入走完專案自己的範例，再查看命令列輸出、產生的檔案、視窗狀態、API 回應或服務日誌；這些觀察點比抽象的功能清單更能說明它是否適合目前工作。版本變動時，則以倉庫最新 README 和 Releases 的說明重新核對，不以舊文章推測新行為。
這些限制必須回到專案自己的名稱來讀。使用者可先確認版本與依賴，再執行 README 的最小範例，記下命令輸出和實際產物。遇到外部服務或平台差異時，應把環境條件與結果分開，不能把單次成功推成全面支援。對照設定鍵、文件路徑和日誌欄位，才能知道問題出在輸入、執行流程還是輸出格式。這也是本專案適合的使用邊界。
編輯結論
Synergy 以 MIT 授權發布，不提供任何明示或暗示的擔保。根據所查閱的元資料，該儲存庫目前有 542 個星標、14 個分支與 20 個未解決問題，預設分支為 dev。README 指向文件、貢獻指南與漏洞安全回報流程。
社群筆記