Tandem

本地优先的 AI 工作空间，基于 Rust 和 Tauri 构建，作为 AI 同事对任意文件夹进行安全、监督式自动化操作。支持多 LLM 后端、MCP 协议扩展及多模态文件处理。

项目定位#

Tandem 是一款本地优先、跨平台的 AI 工作空间，定位于「AI 同事」，在用户监督下对任意文件夹进行安全、自动化的操作与内容生成。

核心特性#

隐私与安全#

零遥测：无任何使用数据回传，仅用户主动调用的外部 LLM API 例外
API 密钥加密：使用 AES-256-GCM 算法加密存储于本地安全保险库
零信任文件访问：默认拒绝访问敏感文件（.env、.pem、.key、SSH 密钥等），所有操作需显式批准
沙箱化执行：基于 Tauri 安全模型，实施严格的 CSP 与权限管控

AI Agent 模式#

Chat Mode：交互式对话，支持上下文感知的文件操作
Plan Mode：执行前生成详细实施计划（.md 格式），支持批量审查与回滚
Ralph Loop：自主迭代循环，直到任务可验证完成
Ask Mode：只读探索与分析模式
Debug Mode：基于运行时证据的系统化调试
Multi-Agent Orchestration：协调 Planner/Builder/Validator 等专业化子代理解决复杂问题

提供商灵活性#

支持 OpenRouter、Anthropic、OpenAI、Ollama 及任何 OpenAI 兼容 API，提供商无关设计避免厂商锁定。

集成与扩展#

MCP Connectors：支持 Model Context Protocol，可连接任意 MCP 服务器
外部通道：Slack、Discord、Telegram 集成
自动化调度：Routine Scheduler 支持定时自动化任务
技能系统：支持自定义 AI 能力和指令导入

文件处理与输出#

格式解析：PDF、DOCX、PPTX、XLSX、RTF 文本提取
输出制品：HTML/Canvas 交互式仪表板、PPTX 演示文稿、Markdown 报告

架构设计#

┌─────────────────────────────────────────────────────────────┐
│                    Tandem Desktop App                       │
├─────────────────┬───────────────────┬───────────────────────┤
│  React Frontend │   Tauri Core      │  Tandem Engine Sidecar│
│  (TypeScript)   │   (Rust)          │  (AI Agent Runtime)   │
├─────────────────┴───────────────────┴───────────────────────┤
│                SecureKeyStore (AES-256-GCM)                 │
└─────────────────────────────────────────────────────────────┘

前端：React 18、TypeScript、Tailwind CSS、Framer Motion
后端：Rust、Tauri 2.0
Agent Runtime：Tandem Engine（Rust，HTTP + SSE）
向量数据库：sqlite-vec（长期记忆支持）

安装部署#

前置条件#

Node.js 20+
Rust 1.75+（通过 rustup 安装）
pnpm（推荐）或 npm

平台特定依赖#

Windows：Build Tools for Visual Studio
macOS：Xcode Command Line Tools
Linux：libwebkit2gtk-4.1-dev, libappindicator3-dev, librsvg2-dev, build-essential, pkg-config

从源码构建#

git clone https://github.com/frumu-ai/tandem.git
cd tandem
pnpm install
cargo build -p tandem-ai
pnpm tauri dev

NPM 包安装#

# TUI 终端界面
pnpm add -g @frumu/tandem-tui

# 无头引擎核心
pnpm add -g @frumu/tandem

典型应用场景#

场景	描述
代码库智能	全代码库理解能力，开源且提供商无关
研究与文档处理	从 PDF/DOCX/PPTX/XLSX 中提取文本，支持研究论文合成
多步骤自动化	复杂任务分解为可审查步骤，批量批准后执行
变更审查	可视化查看文件变更前后差异，一键回滚
跨职能团队支持	提供营销、法务、销售、数据科学等领域的专业化技能包

项目信息#

主要语言：Rust（48.5%）、TypeScript（19.3%）、Python（18.1%）、HTML（9.4%）
平台支持：Windows、macOS（Intel & Apple Silicon）、Linux
仓库活跃度：502 次提交，57 个发布版本（截至 v0.3.19）