AI Native 多 Agent 协作工作站操作系统

Human + Agent + Workflow + Knowledge + Tools

官网 · 设计蓝图 · English · 社区 · 贡献指南

MapleOS 不是又一个 AI Chat，不是又一个 AI IDE，不是又一个自动化工具。

它是一个 AI Operating System — 面向个人与团队的新一代智能工作站：

• 多 Agent 协作中枢 — 不是单 AI，而是 AI Team
• 工作流自动化编排 — Prompt + Tools + Logic 的融合系统
• Local-first 本地优先 — 隐私与离线能力，数据永远属于你
• 可自我进化 — 系统越用越聪明，长期资产沉淀
• Rust Runtime — 性能级 Agent OS，本地跑，云端跑，都能跑

真正实现 Human + AI Team 协同操作系统。

L1 Interface:  Web (Next.js 15) / Desktop (Tauri 2) / Mobile (React Native) / CLI
L2 Collaboration: Workspace / Permissions / Task Dispatch / Realtime Sync
L3 Orchestration: Workflow Engine / Event Bus / Agent Orchestrator / Hooks / SCALE Engine
L4 Capabilities: Skills / MCP / Browser / Code Exec / Webhooks / Plugin SDK
L5 Intelligence: LLM Router / Prompt Mgmt / Vector KB (BM25+Embedding) / Self-Evolution
L6 Storage: SQLite / PostgreSQL / Qdrant / Automerge CRDT / WebDAV

mapleos/
 ├── core/               # Rust 核心引擎 (Cargo workspace)
 │   ├── maple-engine/   # 工作流引擎 + 任务队列
 │   ├── maple-llm/      # LLM 路由层 + Embedding
 │   ├── maple-agent/    # Agent 管理 + React Loop
 │   ├── maple-kb/       # 知识库 (BM25 + Vector + Memory)
 │   ├── maple-sync/     # 同步引擎 (CRDT + WebDAV)
 │   ├── maple-gateway/  # Agent 接入网关 (WS/SSE/RPC)
 │   ├── maple-collab/   # 协作层
 │   ├── maple-rpc/      # JSON-RPC 2.0 服务
 │   ├── maple-macro/    # 过程宏 (#[tool] 派生宏)
 │   └── scale-engine/   # SCALE 治理引擎 (Node.js submodule)
 ├── server/             # Rust Axum 后端服务
 ├── apps/
 │   ├── web/            # Next.js 15 Web 应用
 │   ├── desktop/        # Tauri 2 桌面客户端
 │   └── mobile/         # React Native 移动端
 ├── packages/
 │   ├── ui/             # shadcn/ui 组件库 (React)
 │   ├── sdk/            # MapleOS TypeScript SDK
 │   └── config/         # 共享配置
 ├── plugins/            # 内置插件
 ├── infra/              # Docker 部署配置
 └── .monkeycode/        # 项目文档 / 蓝图 / 记忆

• Rust 1.95+ (edition 2024)
• Node.js 26+ & pnpm 11+
• Ollama (可选，用于本地 LLM)

# 克隆项目（含 scale-engine submodule）
git clone --recurse-submodules https://github.com/hongmaple0820/maple-os.git

# Rust 后端
cargo run --release -p mapleos-server

# SCALE Engine HTTP bridge（可选，端口 7790）
cd core/scale-engine && pnpm install && pnpm run build
node bridge-http.mjs

# 前端 Web 应用
pnpm install && pnpm --filter=mapleos-web dev

docker compose -f infra/docker/docker-compose.yml up

编辑 infra/routing_rules.yaml：

rules:
  - name: 代码生成
    condition: "task.type == 'code_generation'"
    preferred: ["claude-3-5-sonnet", "deepseek-coder-v2"]
  - name: 隐私数据
    condition: "task.privacy_level == 'sensitive'"
    preferred: ["ollama/qwen2.5:7b"]
    fallback_to_cloud: false

• #[tool] 派生宏 — 声明式工具定义，自动生成 JSON Schema 和执行器
• 竞品分析 — 深度竞品对比与最佳实践
• 统一实施计划 — 架构升级路线图
• v2.0.0 路线图 — v2.0.0 功能规划与实现

// 注册工具时自动向量化
registry.register_with_category(tool_def, "filesystem").await?;

// 语义搜索
let tools = registry.search("read file from disk", Some(5)).await?;

// 关键词搜索 (无需 embedding)
let tools = registry.search_by_keyword("file", Some(10)).await;

// 使用频率排序
let tools = registry.search_with_usage_boost("file", Some(5)).await?;

// 使用内置 provider 注册表
let registry = builtin_providers();

// 或手动创建 provider
let adapter = OpenAiCompatAdapter::deepseek(api_key);
let adapter = OpenAiCompatAdapter::qwen(api_key);
let adapter = OpenAiCompatAdapter::google(api_key, "gemini-2.0-flash");

// 本地执行
let backend = LocalBackend::new();
let result = backend.execute("ls -la", None).await?;

// Docker 容器执行
let backend = DockerBackend::new("ubuntu:latest")
    .with_volume("/host", "/container");
let result = backend.execute("apt update", None).await?;

// SSH 远程执行
let backend = SshBackend::new("server.com", "user")
    .with_key("/path/to/key");
let result = backend.execute("uname -a", None).await?;

// 自然语言解析
let schedule = CronExpression::parse_natural_language("every 5 minutes")?;
let schedule = CronExpression::parse_natural_language("daily at 9:00")?;
let schedule = CronExpression::parse_natural_language("weekly on Monday at 14:00")?;

// 创建 mock adapter
let mut adapter = MockLlmAdapter::new("test-model");
adapter.when(
    RequestMatcher::ContentContains("hello"),
    MockResponses::text("Hi there!"),
);

// E2E 对等测试
let mut harness = MockParityHarness::new("test-model");
harness.add_test_case(ParityTestCase { ... });
let report = harness.verify_parity().await?;

完整的「产品 + 设计 + 工程」统一蓝图见 .monkeycode/docs/product-design-blueprint.md，涵盖：

• Figma 设计体系（色彩 / 字体 / 组件 / Tokens）
• 核心产品模块（Dashboard / Workflow Editor / Agent Center / Knowledge）
• 技术架构设计（Rust Runtime / LLM Router / CRDT Sync / Plugin SDK）
• 开发阶段规划（Phase 1-3 Roadmap）
• Developer Handoff 规范

P0 — 核心竞争力:

• RAG-Retrievable Tools — 向量化工具描述 + 语义搜索 + 分类标签 + 使用频率排序
• LLM Provider 生态扩展 — 14+ 提供商 (OpenAI/Anthropic/DeepSeek/Qwen/Gemini/Mistral/Groq/Moonshot/Yi/Baichuan/Minimax/Stepfun)

P1 — 生产就绪:

• Cron 调度器 + 自然语言任务 — "every 5 minutes", "daily at 9:00", "weekly on Monday at 14:00"
• 终端后端扩展 — Local / Docker / SSH 多执行环境

P2 — 工程质量:

• Mock Parity Harness — 确定性 Mock LLM + E2E 对等测试框架
• ToolSearch 运行时发现 — 关键词工具搜索，无需 embedding

• Rust 核心引擎: Workflow / Agent / LLM Router / Knowledge / Task Queue
• Web 前端: Dashboard / Chat / Workflow Editor / Agent Center
• SCALE Engine 治理集成
• SQLite + BM25 + Vector 混合检索

• Agent 多面板协作 / 团队编排
• 知识自我进化 / 记忆沉淀
• Workflow 可视化 Canvas 编辑器
• WebDAV / Automerge CRDT 同步
• Tauri 2 桌面客户端

• 插件市场 / MCP 开放注册
• 企业版功能 / 团队管理 / 多租户
• Agent 市场 / SaaS 平台
• 私有部署方案

MapleOS 的核心信念是：AI 工作站应该是开放的、可积累的、属于每个开发者自己的。

我们选择开源，因为：

1. 透明信任 — Agent 系统直接影响你的工作流，你需要看清它在做什么
2. Local-first — 数据和隐私主权属于用户，开源是实现这一点的唯一方式
3. 生态共建 — Skills / MCP / 插件需要社区共创，一个人做不了所有工具
4. 长期沉淀 — 知识和记忆的积累需要稳定的、不受商业周期影响的载体

如果你相信 AI 应该是工作站的操作系统，而不是聊天框的附庸，欢迎加入我们。

我们欢迎所有形式的贡献！

1. Fork & Clone 项目
2. 选择一个 Good First Issue
3. 提交 PR，我们在 24 小时内 Review

feat: 新功能
fix: 修复 bug
refactor: 重构
docs: 文档
chore: 构建/CI/依赖

# 1. 创建分支
git checkout -b feat/your-feature

# 2. 开发 & 测试
cargo test && pnpm build

# 3. 提交 PR
git push origin feat/your-feature
# 在 GitHub 上创建 Pull Request

加入 MapleOS 开源社区，一起构建 AI 工作站的未来

扫码关注微信公众号，获取最新版本公告和技术深度文章。开发者群内有核心作者实时答疑。

关注微信公众号

微信交流群     飞书交流群

如果 MapleOS 对你有帮助，欢迎请作者喝杯咖啡 ☕

微信赞赏     支付宝赞赏

1. 自我进化 — 系统越用越聪明，记忆 + 规则 + 行为追踪 + Lesson 沉淀
2. 多 Agent 协作 — 不是单 AI，而是 AI Team 协同操作系统
3. Local-first — 隐私主权、离线能力、数据永远属于用户
4. Rust Runtime — 性能级 Agent OS，不是玩具
5. Workflow + Knowledge — 长期资产沉淀，不是临时对话

• SCALE Engine — AI Agent 治理引擎
• shadcn/ui — React 组件库设计体系
• Vercel AI Chatbot — Chat UI 参考架构
• Linear / Raycast — 产品视觉风格参考
• Automerge — CRDT 同步引擎
• Qdrant — 向量数据库
• Tauri — 桌面应用框架

MIT — 自由使用、修改、分发。我们相信 AI 工作站应该是开放的。