Cindy - 開箱即用的開源 AI Agent 桌面端
makecindy/cindy
在本地電腦上直接操作檔案和應用的 AI Agent,支援 Claude Code/Codex 等多種模型,可驅動瀏覽器、電腦和手機完成實際工作
成熟度:維護活躍,最近提交 0 天前,open issues 306 個,處於快速迭代期
项目体检
技术 · TypeScript + Electron 桌面端 + React Native 移动端,基于 pnpm monorepo 架构
许可 · Apache-2.0,允许商用,客户端开源但后端服务未开源
活跃 · 最新版本 v0.1.21 发布于今日,44 位贡献者参与,保持每日提交活跃度
解決什麼
Cindy 解決的是 AI Agent 落地到實際工作場景的"最後一公里"問題。市面上的 AI 程式設計助手大多侷限在程式碼編輯器內,而 Cindy 將能力擴充套件到整個作業系統層面:它能直接操作你電腦上的真實檔案、驅動已登入的應用、控制瀏覽器甚至手機,把"想到就能做到"的 AI 助手從聊天視窗搬到了桌面環境。專案採用客戶端開源(Apache-2.0)+ 雲服務可選的混合模式,支援接入自有 API Key 或本地模型,也可使用官方託管服務按量計費。
為何火
該專案 7 天內獲得 1083 stars,核心吸引力在於三點:一是開箱即用,不需要複雜配置就能讓 AI 在本地環境幹活;二是多模型編排,同一任務可由不同 harness(如 Claude Code/Codex)和模型組合完成,中途切換時工作區、記憶和技能保持連續;三是可塑造性,通過記憶系統(糾正一次永久生效)、技能庫(可複用的工作流)、MCP 協議(接入內部工具)和外掛市場,使用者能持續訓練出符合自己習慣的專屬 Agent。對於擔心 AI 工具"黑盒化"的開發者,客戶端原始碼完全開放是重要加分項。
核心功能
- 多 Harness 支援:首批整合 Claude Code 和 Codex,可在任務執行中動態切換模型和執行引擎,原生 harness 正在開發中
- 跨裝置操作:通過 Electron 桌面端和 React Native 移動端,驅動瀏覽器、電腦和 Android 手機(需 platform-tools)
- 記憶與技能系統:糾正後的行為會跨 harness 持久化;可定義可複用的工作流技能,團隊共享功能規劃中
- 自動化排程:重複性任務可設定計劃自動執行並彙報結果
- 靈活接入模型:支援官方服務(透明釦費)、複用已有 Claude Code/Codex 訂閱(無重複計費)、自有 API Key 或本地模型
- MCP 協議:可接入企業內部工具和業務系統,擴充套件 Agent 能力邊界
安裝
需要 Node.js 22.x、pnpm 10.x 和 Git LFS。克隆倉庫後初始化協議子模組:
git clone https://github.com/makecindy/cindy.git
cd cindy
git submodule update --init --recursive cindy-protocol
git lfs pull
pnpm install
開發啟動(中國大陸使用者):
pnpm restart:desktop:remote --region=cn
全球使用者將 --region=cn 改為 --region=global。登入介面的"本地模式"是無需賬號的本地 Agent 模式,但服務端能力(如雲端同步)不可用。桌面端會從官方 CDN 自動更新,移動端需通過 Expo 構建。
適合誰
- 效率工具重度使用者:需要 AI 助手跨應用協同工作,而非侷限在單一編輯器內
- 注重隱私的開發者:本地執行 + 客戶端開源,可審計資料流向
- 企業定製需求:通過 MCP 接入內部系統,用技能庫沉澱團隊最佳實踐
- AI 工具探索者:想嘗試多模型編排和 Agent 可塑造性的前沿玩法
不適合純 Web 開發場景(Cursor/Windsurf 更專注),也不適合期望完全離線執行的使用者(後端服務未開源,本地模式功能受限)。
社群評價
⚠️ 注意:HN 討論資料指向的是 CindyJS(數學視覺化框架),與本專案 Cindy(AI Agent)完全無關,屬資料匹配錯誤。以下為基於專案本身的中立評估:
專案在 GitHub 上線 7 天即獲千星關注,issues 數量(306 個)反映出早期使用者活躍但也暴露穩定性問題。從 README 和架構文件看,開發團隊在工程規範上投入較多(DCO 簽名、詳細的貢獻指南、模組邊界文件),但後端服務閉源可能引發部分開源社群使用者的顧慮。技術棧選擇(Electron + React Native)保證了跨平臺能力,但也繼承了 Electron 的資源佔用問題。多 harness 編排是亮點,但實際穩定性和切換成本需長期驗證。
選型對比
vs Cursor/Windsurf(商業 AI 程式設計工具):Cindy 的操作範圍更廣(不限於程式碼編輯器),支援驅動瀏覽器和手機,且客戶端開源可定製。但 Cursor 在程式碼補全和 IDE 整合上更成熟,Windsurf 的 Cascade 多 Agent 協作也有獨特優勢。Cindy 適合需要跨應用自動化的場景,Cursor 適合純程式設計工作流。
vs AutoGPT/BabyAGI(開源 Agent 框架):Cindy 提供開箱即用的桌面客戶端和 UI,AutoGPT 更偏框架需自行搭建。Cindy 的記憶和技能系統更工程化,但 AutoGPT 的外掛生態更開放(雖然質量參差不齊)。
商用限制:客戶端 Apache-2.0 可商用,但依賴官方雲服務時需付費;本地模式功能受限,後端未開源意味著無法完全自託管。
已知坑
- 後端依賴:客戶端開源但後端服務閉源,本地模式下雲端同步、團隊協作等功能不可用,完全自託管無法實現
- 區域賬號隔離:中國大陸和全球賬號系統分離(
--region=cnvs--region=global),選錯區域會導致登入失敗 - 高 issue 數:306 個 open issues 反映早期版本穩定性問題,生產環境使用需謹慎
- 資源佔用:Electron 架構 + 多模型執行,對記憶體和 CPU 要求較高
- Android 依賴:Windows 打包時需下載 Android platform-tools(固定版本 + sha256 校驗),網路環境不佳可能失敗
- pnpm 版本鎖定:僅支援 pnpm 10.x,v11 不相容,依賴管理需注意版本
- Git LFS 必需:二進位制檔案通過 LFS 管理,未安裝會導致構建失敗
來源: GitHub makecindy/cindy + 專案 README + 架構文件
安装方式:pnpm