AIDotNet/OpenCowork

OpenCowork – 多智能体AI协作的桌面平台

是什么 – OpenCowork 是一个基于 Electron 构建的开源桌面应用程序，允许大型语言模型（LLM）智能体直接在您本地机器上的文件、终端和代码仓库中工作。智能体可以读取、编辑文件、运行命令、浏览网页，甚至相互协调，而您始终通过可见的工具调用审批来掌控全局。

为何重要 – 多数基于聊天的AI工具需要您复制粘贴代码或日志，导致上下文丢失并引发反复沟通。OpenCowork 将智能体运行在工作环境的“旁边”，使其能够原生访问本地文件系统、完整的终端（包括SSH），以及可搜索的代码图谱。这使得AI真正成为您的协作伙伴，而非孤立的聊天机器人。

核心功能（详见 README）

功能	你将获得
多智能体设计	可创建子智能体、智能体团队，并设定会话目标。平台并非单一聊天框，而是能协调多个共享运行时的智能体。
消息通道集成	可连接飞书、钉钉、Discord、QQ、Telegram、企业微信、微信公众号、WhatsApp 等，让智能体在团队已使用的沟通渠道中发送更新。
运行时栈	Electron + React 19 UI ↔ 狭窄的 Preload 桥接 ↔ Electron 主进程（主机网关） ↔ .NET 11 原生 AOT 工作进程（负责智能体循环、工具执行、SQLite 存储和 CodeGraph 索引）。
五种会话模式	`chat`（普通对话）、`clarify`（编码前规划）、`cowork`（完全访问文件、终端、浏览器、子智能体）、`code`（使用 Monaco 编辑器进行配对编程）、`acp`（架构主导的设计与委派）。
工具箱	• 文件与终端（读写、glob、grep、Bash、SSH） • 浏览器自动化（导航、点击、提取） • 任务与团队管理 • 计划模式 • 目标驱动记忆（`SOUL.md`、`USER.md`、`MEMORY.md`） • Cron 任务 • MCP 服务器（stdio、SSE、HTTP） • 技能市场与扩展 • CodeGraph（基于 tree-sitter 的代码库索引）。
工作区 UI	看板任务板、计划/一次性任务、资源探索器、技能/人格面板、WebDAV 同步、媒体管道用节点图画布、可视化 CodeGraph 视图、专用 SSH 终端。
国际化	通过 i18next 支持 16 种语言翻译。
桌面宠物与生命周期钩子	可选的吉祥物及自定义启动/停止行为钩子。

架构概览

Renderer (React 19)  ←→  Preload  ←→  Main (Electron 主机)  ←→  原生工作进程 (.NET 11 AOT)
      UI 与审批              IPC、窗口、通道、cron、SSH          智能体循环、工具、SQLite、CodeGraph
CLI (Ink TUI) ────────────────────────────────────────────────────────────────────────→ 同一原生工作进程

Renderer – 仅显示状态；从不运行智能体逻辑。
Preload – 通过 contextBridge 暴露安全 API 给渲染器的轻量层。
Main – 管理窗口、凭据、消息插件，并启动原生工作进程。
原生工作进程 – 负责运行 LLM 提供者循环、执行工具、在 SQLite 中存储数据、维护 CodeGraph 的权威进程。

桌面 UI 与基于终端的 CLI（cowork）均与同一原生工作进程通信，确保智能体、提供者和任务的单一真实来源。

快速入门（来自 README）

前提条件 – Node ≥18，npm ≥9，.NET 11 SDK（Preview 7+，支持原生 AOT）。因 CodeGraph 旁路组件需要，必须使用子模块克隆。
```
git clone --recurse-submodules https://github.com/AIDotNet/OpenCowork.git
cd OpenCowork
```

安装依赖并以开发模式运行

npm install
npm run dev   # 启动带热重载的 Electron

构建分发版本 – 使用提供的脚本（npm run build:win、build:mac、build:linux）。GitHub 发布页面也提供预构建安装包。

CLI 替代方案 – 全局安装后，可在终端中运行相同工作进程：

npm install -g @aidotnet/opencowork
cowork          # 启动 TUI 客户端
cowork --doctor # 诊断

所有配置、提供者、智能体和技能定义均位于 ~/.open-cowork/，在桌面应用与 CLI 间共享。

典型使用场景

自主编码 – 让智能体在您信任的仓库中直接重构、调试并提交更改。
定时操作 – 基于 Cron 的智能体监控日志或系统健康状况，并向飞书、Discord 等推送警报。
研究与报告生成 – 浏览网页、抓取数据、处理 CSV/Excel 文件并生成文档。
远程管理 – 在应用内打开 SSH 终端，无需离开 UI 即可在远程主机上执行命令。
设计与媒体流水线 – 使用“Draw”节点图画布和内置扩展，用于产品设计、创意制作或视频生成。

文档与社区

官方文档 – https://open-cowork.dev
仓库内指南 – AGENTS.md（智能体规范）、cli/README.md（CLI 使用）、docs/architecture/ 下的架构文档。
贡献指南 – 遵循 feat(scope): … 提交风格，提交 PR 前运行 npm run typecheck 和 npm run lint。
赞助者与致谢 – 项目列出了几位个人赞助者，并感谢 RoutinAI（LLM 网关）和 GeneralUpdate（自动更新库）。

许可证

Apache License 2.0 – 允许商业与非商业使用，遵循常规专利授权与署名要求。

总结 – OpenCowork 是一个功能完整的本地运行多智能体平台，将大语言模型能力与开发者的现有工作流无缝衔接，既提供丰富的桌面 UI，也提供终端客户端，同时确保所有数据保留在用户机器上。