OpenHuman — 个人 AI 超级智能桌面助手

开源个人 AI 超级智能桌面应用，定位为”私有、简单、极度强大”的 AI 助手。核心特色是 Memory Tree + Obsidian Wiki + 118+ 集成 + TokenJuice 压缩，让 Agent 在分钟级内了解你的全部上下文。

基本信息

仓库：https://github.com/tinyhumansai/openhuman
本地路径：/Users/zhaoweiguo/6ai/opensources/openhuman
状态：Early Beta，活跃开发中
许可证：GNU
技术栈：React + Tauri v2 + Rust（核心）+ SQLite + QuickJS（Skill 沙箱）

安装

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash
 
# 或从官网下载 DMG/EXE
# https://tinyhumans.ai/openhuman

核心特性

Memory Tree + Obsidian Wiki

受 Karpathy obsidian-wiki 工作流启发。所有连接的数据源（Gmail、Slack、GitHub 等）每 20 分钟自动拉取，经 TokenJuice 压缩后，切分为 ≤3k token 的 Markdown 块，存入 SQLite，同时写成 .md 文件到 Obsidian 兼容的 vault：

<workspace>/wiki/
├── summaries/   # 自动生成的来源/主题/全局摘要树
├── notes/       # 手写笔记（自动纳入 Agent 上下文）
└── <source>/    # 每个集成来源的数据

记忆完全透明可读，可直接在 Obsidian 中浏览/编辑
手写笔记会被同等对待，纳入 Agent 上下文
支持 agentmemory 后端（与 Claude Code、Cursor、Codex 共享同一记忆库）

118+ 第三方集成（OAuth 一键接入）

Gmail、Notion、GitHub、Slack、Stripe、Calendar、Drive、Linear、Jira 等，每个连接暴露为类型化工具，每 20 分钟自动同步到 Memory Tree。

TokenJuice（智能 Token 压缩）

移植自 vincentkoc/tokenjuice，集成在工具执行路径中，工具结果进入 LLM 前先压缩：

三层规则覆盖：内置默认 → 用户全局（~/.config/tokenjuice/rules/）→ 项目级（.tokenjuice/rules/）
处理 git、npm、cargo、docker、kubectl、ls 等常见工具输出
效果：处理 6 个月邮件只需个位数美元，而非数百美元
实现：src/openhuman/tokenjuice/

桌面吉祥物（Mascot）

Agent 有一张”脸”：桌面吉祥物，能说话、对环境做出反应、以真实参与者身份加入 Google Meet、跨周记住你。

模型路由

内置模型路由，按任务类型（推理/快速/视觉）自动选择合适 LLM，一个账号统一管理，无需多个 API Key。支持 Ollama 本地模型。

原生工具集

Web 搜索、网页抓取、完整编码工具集（文件系统、git、lint、test、grep）、原生语音（STT + ElevenLabs TTS + 吉祥物口型同步）。

架构

React Frontend (Redux + Socket.io + MCP Transport)
        │ Tauri IPC Bridge
Rust Core Engine
  ├── QuickJS Skill Runtime（沙箱执行）
  ├── Socket Manager（持久 WebSocket）
  ├── Memory Store（SQLite + 加密）
  ├── Skill Registry + Bridge APIs
  ├── Cron Scheduler（5s tick loop）
  ├── Session & Auth
  └── TokenJuice（工具输出压缩）

Rust 核心：业务逻辑、执行、RPC、持久化、CLI（权威层）
Tauri + React：UI、导航、桥接（展示层）
核心以 tokio 任务内嵌运行于 Tauri 宿主进程（无 sidecar，PR #1061 移除）
RPC 通过 HTTP JSON-RPC 到 http://127.0.0.1:<port>/rpc，per-launch bearer 认证

与其他 Agent Harness 对比

维度	Claude Code	OpenClaw	Hermes	OpenHuman
开源	🚫	✅ MIT	✅ MIT	✅ GNU
上手难度	✅ 桌面+CLI	⚠️ 终端优先	⚠️ 终端优先	✅ 分钟级
Memory	✅ 对话级	⚠️ 插件依赖	✅ 自学习	🚀 Memory Tree + Obsidian
集成	⚠️ 少	⚠️ 自建	⚠️ 自建	🚀 118+ OAuth
Auto-fetch	🚫	🚫	🚫	✅ 20 分钟同步
模型路由	🚫 单模型	⚠️ 手动	⚠️ 手动	✅ 内置
原生工具	✅ 代码专项	✅ 代码专项	✅ 代码专项	✅ 代码+搜索+抓取+语音

开发构建

# 依赖：Node.js 24+, pnpm 10.10.0, Rust 1.93.0, CMake, Ninja, ripgrep
git submodule update --init --recursive
pnpm install
 
pnpm dev              # 仅 Vite UI
pnpm dev:app          # 完整 Tauri 桌面
pnpm typecheck        # TypeScript 检查
cargo build --bin openhuman-core  # Rust 核心

值得关注的设计

TokenJuice 三层规则：内置 + 用户全局 + 项目级，JSON 配置无需重编译
agentmemory 后端：可与 Claude Code/Cursor/Codex 共享同一记忆库
Memory 透明性：记忆即 Markdown 文件，可直接编辑，Agent 立即感知
Auto-fetch 经济性：TokenJuice 使大规模数据摄入成本降低 80%

zhaoweiguo 的知识库

目录