这个项目能做什么
MyAgents 是一款开源桌面端个人 Agent 工作台,定位不是聊天窗口,而是把对话、工作区、文件、工具、模型、任务和长期记忆放进同一个桌面系统。项目采用 AGPL-3.0-only 许可,官网与下载入口为 myagents.io。
核心体验
- 工作区优先:每个 Agent 绑定真实工作区,提供文件树、文件预览、Git 分支、Skills 与命令入口;支持 @ 引用文件、/ 调用技能、MCP 工具调用与模型选择。
- 多标签 Agent:Chrome 风格多标签页,每个 Tab 独立运行一个 Agent 与 Sidecar,适合并行工作。
- 内嵌终端与浏览器:右侧分屏提供 xterm.js + portable-pty 终端和 Tauri 多 Webview 浏览器,便于边执行边验证。
- 想法与任务中心:可先速记想法、打标签归档,再与 AI 讨论并沉淀为任务;支持一次性任务、周期任务、Cron 表达式、可选本地命令感知器、任务状态、运行次数、执行日志与异常恢复。
- 多模型供应商:支持 Anthropic 订阅或 API,以及 DeepSeek、Moonshot、智谱、MiniMax、Google Gemini、火山方舟、硅基流动、ZenMux、OpenRouter、小米 MiMo、阿里云百炼等,实际列表以应用内页面为准。
- 开放能力:MCP 支持 STDIO / HTTP / SSE;Skills 分内置、用户级与工作区级;可为不同工作区配置自定义 Agent 的 Prompt、模型、工具与权限;实验室功能支持 Claude Code CLI、OpenAI Codex CLI、Google Gemini CLI 作为外部 Runtime。
- 多入口:内置 Telegram、钉钉 IM Bot,更多平台可通过 OpenClaw 插件接入;另有小助理、桌面宠物/浮窗与定时任务。
- 本地优先:会话、任务、配置与生成产物默认保存在本机;本地全文搜索基于 Tantivy + jieba,可检索会话历史与工作区文件。
技术栈与架构
桌面层为 Tauri v2 + Rust,前端为 React 19 + TypeScript + Vite + TailwindCSS,后端 Sidecar 为 Node.js v24 + Claude Agent SDK,通信经 Rust HTTP/SSE 代理,前端通过 Tauri invoke 访问 Sidecar。搜索使用 Tantivy + tantivy-jieba,终端使用 portable-pty + xterm.js。
关键架构原则包括:Session 与 Sidecar 为 1:1,Tab、CronTask、BackgroundCompletion、Agent 通过 Owner 模型共享生命周期;Chat Tab 使用 tab-scoped API,Settings 与 Launcher 使用 Global Sidecar;控制面 HTTP/SSE 走 Rust 代理,仅 /refs/:id 与 /attachment/* 大载荷数据面在 CORS/CSP/路径安全约束下原生 fetch;工作区文件 IO 走 Tauri/Rust;配置写盘 disk-first;Session 操作统一走 src/server/session-engine/ facade,由 selector 选择 builtin 或 external adapter。
开发与构建
最终用户支持 macOS 13.0+(Apple Silicon 与 Intel)和 Windows 10+。开发者需要 Node.js >=22(推荐 24)、npm、rustup 安装的 Rust(toolchain 由 rust-toolchain.toml 固定);冷构建原生推理资源需要 CMake 3.28+ 与平台 C/C++ 工具链,macOS 还需 Git、Python 3.10+ 与 Apple Clang。
macOS / Linux 使用 ./setup.sh 与 ./start_dev.sh;Windows 使用 .\setup_windows.ps1 与 .\build_windows.ps1。常用命令包括 npm run typecheck、npm run lint(含 dependency-cruiser 架构边界检查)、分层测试 test:classification / test:unit / test:dom / test:integration,以及需显式本地运行的 test:credentialed;构建脚本有 build_dev.sh、build_macos.sh、build_linux.sh。Linux 构建机需安装 Tauri/WebKit 相关系统依赖。
项目结构分为 src/renderer(React 前端)、src/server(Node Sidecar)、src/server/plugin-bridge(OpenClaw Plugin Bridge)、src/cli(myagents CLI)、src/shared(共享类型)、src-tauri(Rust 层)、bundled-agents、bundled-skills 与 specs(架构与设计文档)。提交信息遵循 Conventional Commits。
许可与商业使用
项目采用 GNU Affero General Public License v3.0(AGPL-3.0-only),个人与企业均可免费使用,也可商业使用;分发修改版或通过网络向用户提供修改版等场景需完整履行 AGPL。若希望在不履行 AGPL 开源义务的情况下闭源修改、嵌入、OEM、分发或托管,需要单独的商业许可证。第三方组件继续适用各自许可证。
评论
0 人表达喜爱 · 满10人后显示 Deer Point
登录后参与讨论。