MindOS

人类在此思考，Agent 依此行动。

English | 中文

MindOS 是你思考的地方，也是 AI Agent 行动的起点——一个你和所有 AI 共享的本地知识库。每次思考，都在生长。

---

<img src="https://github.com/GeminiLight/MindOS/raw/v1.1.59/assets/images/demo-flow-zh-light.png" alt="MindOS：从灵感到执行到复盘" width="960" />

首页 — 知识库概览	AI Agent — 基于知识库主动识别意图并执行任务
Agent 工作台 — 管理所有已连接的 AI Agent	Echo — 复盘与认知沉淀

[!IMPORTANT] ⭐ 一键安装： 把这句话发给你的 Agent（Claude Code、Cursor 等），自动完成全部安装： 帮我从 https://github.com/GeminiLight/MindOS 安装 MindOS，包含 MCP 和 Skills，使用中文模板。

✨ 立即体验： 安装完成后，不妨试试： 这是我的简历，读一下，把我的信息整理到 MindOS 里。 帮我把这次对话的经验沉淀到 MindOS，形成一个可复用的工作流。 帮我执行 MindOS 里的 XXX 工作流。

📢 最新动态

日期	更新
2026-04	协议 runtime 内聚 — ACP 与 MCP 源码已迁入 packages/mindos/src/protocols/*；发布包只带自包含的 dist/protocols/* bundle，不再嵌套协议 workspace package。
2026-04	产品主包落地 — MindOS 采用 OpenCode 式核心包：packages/mindos（@geminilight/mindos）承载产品 runtime facade 与 CLI kernel 边界；Web/CLI 围绕它做适配。
2026-04	OpenCode 式 workspace 扁平化 — 所有源码 workspace 已统一到 packages/：packages/web、packages/desktop、packages/mobile、packages/mindos，以及可选 packages/retrieval/* adapters。npm tarball / CLI / MCP / Web standalone / Desktop / Mobile 均已验证。
2026-04	发布包清理 — 旧顶层 app/、mcp/、desktop/、mobile/ 源码根已移除，发布清单精确排除测试、缓存与 nested node_modules。
2026-04	网页剪藏插件 — 浏览器扩展，一键剪藏任意网页到 MindOS 收集箱。安装 →
2026-04	PDF & 图片导入 — 拖拽 PDF 和图片到 MindOS，自动转换为可搜索的 Markdown。

🧠 人机共享心智

你在思考中塑造 AI，AI 在执行中反哺你。人和 AI，在同一个大脑里共同成长。

1. 全局同步 — 打破记忆割裂

切换工具带来上下文割裂，个人深度背景散落各处，导致知识无法复用。MindOS 内置 MCP Server，所有 Agent 零配置直连核心知识库。项目记忆与 SOP 仅需一处记录，全局赋能所有 AI 工具。

2. 透明可控 — 消除记忆黑箱

Agent 记忆锁在黑箱中，推理无法审查，错误极难纠正且幻觉持续累积。MindOS 将每次检索与执行沉淀为本地纯文本，提供完整的审查干预界面，人类拥有绝对的心智纠偏权，随时校准 Agent 行为。

3. 共生演进 — 经验回流为指令

反复表达偏好但新对话又从零开始，思考未变成 AI 的能力与自身的方法论。MindOS 将每次思考自动沉淀为知识库。在交互中厘清想法与标准，下次应对更默契拒绝重复犯错，认知随每次沉淀变得锐利。

底层原则： 默认本地优先，全部数据以本地纯文本保存，兼顾隐私、主权与性能。

---

🚀 快速开始

[!IMPORTANT] 用 Agent 一键安装： 将以下指令粘贴到任意支持 MCP 的 Agent（Claude Code、Cursor 等），即可自动完成安装，然后跳到第 3 步： 帮我从 https://github.com/GeminiLight/MindOS 安装 MindOS，包含 MCP 和 Skills，使用中文模板。

已有知识库？直接跳到第 4 步配置 MCP + Skills。

1. 安装

方式 A：桌面客户端（macOS / Windows / Linux）

从官网或 GitHub Releases 下载安装包，双击安装，无需终端。

方式 B：npm 安装

npm install -g @geminilight/mindos@latest

方式 C：克隆源码

git clone https://github.com/GeminiLight/MindOS
cd MindOS
pnpm install
pnpm --filter @geminilight/mindos build
cd packages/mindos
pnpm link --global   # 将 mindos 命令注册为全局命令

npm 包会同时安装 CLI 和预构建的本地 Web runtime，这是设计目标：mindos 是命令入口，mindos start / mindos open 使用包内 _standalone/ 启动浏览器 UI；Web 源码（packages/web）、测试、wiki、旧源码根和开发缓存不会进入发布包。

2. 交互式配置

mindos onboard

配置向导会引导你完成知识库路径、模板、端口、认证、AI 服务商、启动模式等配置——所有选项都有合理默认值。配置自动保存到 ~/.mindos/config.json。完整字段说明见 docs/zh/configuration.md。

[!TIP] macOS/Linux 可在 onboard 中选择"后台服务"实现开机自启。Windows CLI 安装请使用前台模式；Windows 自启动由 Desktop 客户端处理。随时运行 mindos update 升级到最新版本。

在浏览器中打开 Web UI：

mindos open

3. 通过 MindOS Agent 注入你的个人心智

1. 打开 MindOS GUI 中内置的 Agent 对话面板。
2. 上传你的简历或任意个人/项目资料。
3. 发送指令：帮我把这些信息同步到我的 MindOS 知识库。

4. 让任意 Agent 可用（MCP + Skills）

MCP（连接能力）— 一条命令自动安装：

mindos mcp install        # 交互式
mindos mcp install -g -y  # 一键全局安装

Skills（工作流能力）— 根据语言偏好选择其一：

npx skills add https://github.com/GeminiLight/MindOS --skill mindos -g -y      # 英文
npx skills add https://github.com/GeminiLight/MindOS --skill mindos-zh -g -y   # 中文

远程配置、手动 JSON 片段、常见误区等详见 docs/zh/supported-agents.md。

5. 随时随地捕获知识

MindOS 的知识不必从零开始——把你已有的信息导入进来：

• 拖拽导入：将文件（PDF、图片、Markdown、CSV）直接拖入 MindOS GUI，AI 自动分析并归档到对应文件夹。
• 网页剪藏：安装浏览器插件，一键保存任意网页到收集箱。快捷键 Ctrl+Shift+M 或右键菜单 →「Save to MindOS」。
• Agent 导入：让任意已连接的 Agent 阅读文档并同步到你的知识库。

✨ 功能特性

人类侧

• GUI 工作台：浏览、编辑、搜索笔记，统一搜索 + AI 入口（⌘K / ⌘/），专为人机共创设计。
• 内置 Agent 助手：在上下文中与知识库对话，编辑无缝沉淀为可管理知识。
• 一键导入：拖拽文件即可导入，Inline AI Organize 自动分析、分类、写入知识库，支持进度追踪和撤销。
• 新手引导：首次使用的分步引导体验，帮助新用户快速搭建知识库并连接第一个 Agent。
• 插件扩展：多种内置渲染器插件——TODO Board、CSV Views、Wiki Graph、Timeline、Workflow Editor、Agent Inspector 等。
• 网页剪藏：浏览器扩展，一键将任意网页保存为干净的 Markdown——存入收集箱，稍后 AI 自动整理归档。安装 →

Agent 侧

• MCP Server + Skills：stdio + HTTP 双传输，全阵容 Agent 兼容（Claude Code, Cursor, Gemini CLI 等），零配置接入。
• ACP / A2A 协议：Agent 间通信协议，支持 Agent 发现、任务委派与编排。Phase 1 已上线：Agent Card 发现 + JSON-RPC 消息通信。
• Workflow 编排：基于 YAML 的可视化工作流编辑器 + 步骤执行引擎，定义、编辑、运行多步 Agent 工作流。
• 结构化模板：预置 Profile、Workflows、Configurations 等目录骨架，快速冷启动个人 Context。
• 笔记即指令：日常笔记天然就是 Agent 可直接执行的高质量指令——无需额外格式转换，写下即可调度。

基础设施

• 安全防线：Bearer Token 认证、路径沙箱、INSTRUCTION.md 写保护、原子写入。
• 知识图谱：动态解析并可视化文件间的引用与依赖关系。
• 反向链接视图：展示所有引用当前文件的反向链接，理解笔记在知识网络中的位置。
• Agent 审计面板：将 Agent 操作日志渲染为可筛选的时间线，审查每次工具调用的详情。
• Git 时光机：Git 自动同步（commit/push/pull），记录人类与 Agent 的每次编辑历史，一键回滚，跨设备同步。
• 桌面客户端：原生 macOS/Windows/Linux 应用，系统托盘、开机自启、本地进程管理。

即将到来

• [ ] RAG 深度集成：基于知识库内容的检索增强生成，让 AI 回答更精准、更有上下文
• [ ] ACP / A2A Phase 2：深度多 Agent 协作，支持任务委派、共享上下文、工作流链式执行
• [ ] 经验编译器：从 Agent 交互中自动提取纠正和偏好，沉淀为可复用的 Skills/SOP
• [ ] 知识库健康度仪表盘：可视化认知复利指标——已积累规则数、Agent 复用次数、知识新鲜度

⚙️ 运作机制

graph LR
    H["👤 人类

<sub>思考 · 审查 · 进化</sub>"]
    M[("📚 MindOS")]
    A["🤖 Agent

<sub>执行 · 复盘 · 提炼 SOP</sub>"]
    EXT["🌐 所有 Agent"]

    H -- "想法 & 反馈" --> M
    M -- "上下文 & 洞察" --> H
    M -- "指令 & 上下文" --> A
    A -- "结果 & SOP" --> M
    M -. "via MCP" .-> EXT

    style H fill:#f59e0b,stroke:#d97706,color:#fff,stroke-width:2px
    style M fill:#10b981,stroke:#059669,color:#fff,stroke-width:2px
    style A fill:#6366f1,stroke:#4f46e5,color:#fff,stroke-width:2px
    style EXT fill:#64748b,stroke:#475569,color:#fff,stroke-dasharray:5 5

双向进化。 人类从积累的知识中获得新洞察；Agent 提炼 SOP 变得更强。MindOS 居中——随每次交互持续成长的共享第二大脑。

---

🤝 支持的 Agent

当前注册表支持 26 个 Agent。完整列表及 MCP 配置路径、手动配置方法：docs/zh/supported-agents.md

Agent	MCP	Skills
OpenClaw	✅	✅
Claude Code	✅	✅
Cursor	✅	✅
Codex	✅	✅
Gemini CLI	✅	✅
GitHub Copilot	✅	✅
Trae	✅	✅
CodeBuddy	✅	✅
Qoder	✅	✅
Cline	✅	✅
Windsurf	✅	✅
Hermes	✅	-

---

📁 项目架构

MindOS/
├── packages/web/         # Next.js 16 前端 — 浏览、编辑、与 AI 交互
├── packages/desktop/     # Electron 桌面客户端
├── packages/mobile/      # Expo 移动端
├── packages/browser-extension/ # Web Clipper 浏览器扩展
├── packages/desktop-tauri/     # Tauri 桌面 spike
├── packages/mindos/      # 已发布产品包：runtime facade、protocols、foundation/knowledge 内部模块、CLI kernel
├── packages/retrieval/   # 可选检索栈：search/vector/indexer/API
├── skills/           # MindOS Skills（`mindos`、`mindos-zh`）— Agent 工作流指南
├── templates/        # 预设模板（`en/`、`zh/`、`empty/`）— onboard 时复制到知识库目录
├── scripts/          # 配置向导与辅助脚本
└── README.md

~/.mindos/            # 用户数据目录（项目外，不会被提交）
├── config.json       # 所有配置（AI 密钥、端口、Auth token、同步设置）
├── sync-state.json   # 同步状态（最后同步时间、冲突文件）
└── mind/             # 你的私有知识库（默认路径，onboard 时可自定义）

v1 之后，顶层 app/、apps/、mcp/、desktop/、mobile/、browser-extension/、desktop-tauri/ 和根目录 bin/ 不再是源码入口。仓库根目录是 private monorepo 编排层。packages/mindos 是 OpenCode 式发布产品包（@geminilight/mindos）：仓库内 CLI 入口是 packages/mindos/bin/cli.js，npm 安装后用户仍获得包内相对路径 bin/cli.js，预构建本地 Web runtime 以 _standalone/ 发布。packages/web 是唯一 Web 源码，不会复制进 npm tarball。npm pack / publish 期间可能生成 packages/mindos/_standalone、packages/mindos/packages、packages/mindos/scripts、packages/mindos/assets、packages/mindos/skills、packages/mindos/templates 等 staging 输出；这些不是源码，已被 git 和 pnpm workspace 排除，可用 pnpm run clean:product-stage 或 product postpack 清理。

⌨️ CLI 命令

完整命令参考：docs/zh/cli-commands.md

命令	说明
核心
mindos onboard	交互式初始化（生成配置、选择模板）
mindos start	前台启动 app + MCP 服务
mindos start --daemon	以后台 OS 服务方式启动（仅 macOS/Linux）
mindos stop / restart	停止或重启服务
mindos dev	开发模式启动
mindos build	构建生产版本
mindos status	查看服务状态概览
mindos open	在浏览器中打开 Web UI
知识库
mindos file <sub>	文件操作（list, read, create, delete, search）
mindos space <sub>	空间管理（list, create, info）
mindos search "<query>"	搜索知识库
mindos	进入 MindOS AI Agent 交互模式
mindos "<task>" / mindos -p "<task>"	基于知识库运行 MindOS AI Agent
mindos agent <sub>	显式 agent 命令与管理（list, info）
mindos channel / mindos feishu-ws	IM 渠道配置与飞书长连接
mindos api <METHOD> <path>	API 透传（开发者/Agent 用）
MCP 与配置
mindos mcp install	自动将 MCP 配置写入 Agent
mindos token	查看认证令牌和 MCP 配置
mindos config <sub>	查看/修改配置（show, set, validate）
mindos sync	同步状态（init, now, conflicts, on/off）
mindos gateway <sub>	管理 macOS/Linux 后台服务（install, start, stop）
mindos doctor	健康检查
mindos update	更新到最新版本

主要快捷键： ⌘K 搜索 · ⌘/ AI 助手 · E 编辑 · ⌘S 保存 · Esc 关闭。

---

💬 社区

加入微信内测群，抢先体验、反馈建议、交流 AI 工作流：

扫码加入，或添加微信 wtfly2018 邀请入群。

---

👥 贡献者

🙏 致谢

本项目已在 LINUX DO 社区 发布，感谢社区的支持与反馈。

---

📄 License

MIT © GeminiLight