@geminilight/mindos-linux-x64-musl 1.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 GeminiLight
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,385 @@
+<p align="center">
+  <img src="assets/logo-square.svg" alt="MindOS" width="100" />
+</p>
+
+<h1 align="center">MindOS</h1>
+
+<p align="center">
+  <strong>Human Thinks Here, Agents Act There.</strong>
+</p>
+
+<p align="center">
+  <a href="README.md">English</a> | <a href="README_zh.md">中文</a>
+</p>
+
+<p align="center">
+  <a href="https://tianfuwang.tech/MindOS"><img src="https://img.shields.io/badge/Website-MindOS-0ea5e9.svg?style=for-the-badge" alt="Website"></a>
+  <a href="https://www.npmjs.com/package/@geminilight/mindos"><img src="https://img.shields.io/npm/v/@geminilight/mindos.svg?style=for-the-badge&color=6366f1" alt="npm version"></a>
+  <a href="#wechat"><img src="https://img.shields.io/badge/WeChat-Group-07C160.svg?style=for-the-badge&logo=wechat&logoColor=white" alt="WeChat"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-64748b.svg?style=for-the-badge" alt="MIT License"></a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/GeminiLight/MindOS/releases?q=desktop"><img src="https://img.shields.io/badge/Desktop_App-Download-d97706.svg?style=for-the-badge" alt="Desktop App"></a>
+  <a href="https://github.com/GeminiLight/MindOS/releases?q=clipper"><img src="https://img.shields.io/badge/Web_Clipper-Install-c8873a.svg?style=for-the-badge" alt="Web Clipper"></a>
+</p>
+
+MindOS is where you think, and where your AI agents act — a local-first knowledge base shared between you and every AI you use. **Share your brain with every AI — every thought grows.**
+
+---
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="assets/images/demo-flow-dark.webp" type="image/webp" />
+    <source media="(prefers-color-scheme: dark)" srcset="assets/images/demo-flow-dark.png" />
+    <source media="(prefers-color-scheme: light)" srcset="assets/images/demo-flow-light.webp" type="image/webp" />
+    <source media="(prefers-color-scheme: light)" srcset="assets/images/demo-flow-light.png" />
+    <img src="assets/images/demo-flow-light.png" alt="MindOS: From Idea to Execution to Review" width="960" />
+  </picture>
+</p>
+
+<table>
+  <tr>
+    <td width="50%">
+      <picture>
+        <source srcset="assets/images/mindos-home.webp" type="image/webp" />
+        <img src="assets/images/mindos-home.png" alt="MindOS Home" />
+      </picture>
+    </td>
+    <td width="50%">
+      <picture>
+        <source srcset="assets/images/mindos-chat.webp" type="image/webp" />
+        <img src="assets/images/mindos-chat.png" alt="MindOS AI Agent" />
+      </picture>
+    </td>
+  </tr>
+  <tr>
+    <td align="center"><em>Home — Knowledge base overview</em></td>
+    <td align="center"><em>AI Agent — Proactively understand intent and execute tasks from your knowledge</em></td>
+  </tr>
+  <tr>
+    <td width="50%">
+      <picture>
+        <source srcset="assets/images/mindos-dashboard.webp" type="image/webp" />
+        <img src="assets/images/mindos-dashboard.png" alt="MindOS Agents Dashboard" />
+      </picture>
+    </td>
+    <td width="50%">
+      <picture>
+        <source srcset="assets/images/mindos-echo.webp" type="image/webp" />
+        <img src="assets/images/mindos-echo.png" alt="MindOS Echo" />
+      </picture>
+    </td>
+  </tr>
+  <tr>
+    <td align="center"><em>Agents — Manage all connected AI agents</em></td>
+    <td align="center"><em>Echo — Reflect and distill cognitive growth</em></td>
+  </tr>
+</table>
+
+> [!IMPORTANT]
+> **⭐ One-click install:** Send this to your Agent (Claude Code, Cursor, etc.) to set up everything automatically:
+> ```
+> Help me install MindOS from https://github.com/GeminiLight/MindOS with MCP and Skills. Use English template.
+> ```
+>
+> **✨ Try it now:** After installation, give these a try:
+> ```
+> Here's my resume, read it and organize my info into MindOS.
+> ```
+> ```
+> Help me distill the experience from this conversation into MindOS as a reusable SOP.
+> ```
+> ```
+> Help me execute the XXX SOP from MindOS.
+> ```
+
+## 📢 What's New
+
+| Date | Update |
+|------|--------|
+| 2026-04 | **Protocol runtimes internalized** — ACP and MCP source now live under `packages/mindos/src/protocols/*`; the published package ships self-contained `dist/protocols/*` bundles instead of nested protocol packages. |
+| 2026-04 | **Product main package** — MindOS now follows an OpenCode-style core package: `packages/mindos` (`@geminilight/mindos`) is the product runtime facade and CLI kernel boundary; Web/CLI adapt around it. |
+| 2026-04 | **OpenCode-style workspace flattening** — all source workspaces now live under `packages/`: `packages/web`, `packages/desktop`, `packages/mobile`, `packages/mindos`, and optional `packages/retrieval/*` adapters. npm tarball, CLI, MCP, Web standalone, Desktop, and Mobile checks have passed. |
+| 2026-04 | **Clean publish package** — legacy top-level `app/`, `mcp/`, `desktop/`, and `mobile/` source roots are removed; publish entries exclude tests, caches, and nested `node_modules`. |
+| 2026-04 | **Web Clipper** — Browser extension to clip any web page to your MindOS Inbox with one click. [Get it →](packages/browser-extension/) |
+| 2026-04 | **PDF & Image Import** — Drag PDFs and images into MindOS, auto-converted to searchable Markdown. |
+
+## 🧠 Human-AI Shared Mind
+
+> You shape AI through thinking, AI empowers you through execution. Human and AI, growing together in one shared brain.
+
+**1. Global Sync — Breaking Memory Silos**
+
+Switch tools or start a new chat and you're re-transporting context, scattering knowledge. **With a built-in MCP server, MindOS connects all Agents to your core knowledge base with zero config. Record profile and project memory once to empower all AI tools.**
+
+**2. Transparent & Controllable — No Black Boxes**
+
+Agent memory locked in black boxes makes reasoning unauditable, erasing trust as hallucinations compound. **MindOS saves every retrieval, reflection & action as local plain text. You hold absolute mind-correction rights with a full GUI to recalibrate Agents anytime.**
+
+**3. Symbiotic Evolution — Experience Flows Back As Instructions**
+
+You express preferences but the next chat starts from zero, leaving your thinking useless for AI. **MindOS auto-distills every thought into your knowledge base. Clarify your standards through interaction and sharpen your cognition with each iteration — AI will never repeat the same mistake.**
+
+> **Foundation:** Local-first by default — all data stays in local plain text for privacy, ownership, and speed.
+
+---
+
+## 🚀 Getting Started
+
+> [!IMPORTANT]
+> **Quick Start with Agent:** Paste this prompt into any MCP-capable Agent (Claude Code, Cursor, etc.) to install automatically, then skip to [Step 3](#3-inject-your-personal-mind-with-mindos-agent):
+> ```
+> Help me install MindOS from https://github.com/GeminiLight/MindOS with MCP and Skills. Use English template.
+> ```
+
+> Already have a knowledge base? Skip to [Step 4](#4-make-any-agent-ready-mcp--skills) to configure MCP + Skills.
+
+### 1. Install
+
+**Option A: Desktop App (macOS / Windows / Linux)**
+
+Download from the [official website](https://tianfuwang.tech/MindOS/#quickstart) or [GitHub Releases](https://github.com/GeminiLight/MindOS/releases/latest) — double-click to install, no terminal needed.
+
+**Option B: npm**
+
+```bash
+npm install -g @geminilight/mindos@latest
+```
+
+**Option C: Clone from source**
+
+```bash
+git clone https://github.com/GeminiLight/MindOS
+cd MindOS
+pnpm install
+pnpm link --global   # registers the `mindos` command globally
+```
+
+The npm package intentionally installs both the CLI and the prebuilt local Web runtime. `mindos` is the command entrypoint, while `_standalone/` provides the browser UI used by `mindos start` / `mindos open`; Web source (`packages/web`), tests, wiki, legacy source roots, and dev caches are excluded from the tarball.
+
+### 2. Interactive Setup
+
+```bash
+mindos onboard
+```
+
+The setup wizard guides you through knowledge base path, template, ports, auth, AI provider, and start mode — all with sensible defaults. Config is saved to `~/.mindos/config.json`. See **[docs/en/configuration.md](docs/en/configuration.md)** for all fields.
+
+> [!TIP]
+> Choose "Background service" during onboard for auto-start on boot. Run `mindos update` anytime to upgrade.
+
+Open the Web UI in your browser:
+
+```bash
+mindos open
+```
+
+### 3. Inject Your Personal Mind with MindOS Agent
+
+1. Open the built-in MindOS Agent chat panel in the GUI.
+2. Upload your resume or any personal/project material.
+3. Send this prompt: `Help me sync this information into my MindOS knowledge base.`
+
+
+### 4. Make Any Agent Ready (MCP + Skills)
+
+**MCP** (connection) — one command to auto-install:
+
+```bash
+mindos mcp install        # interactive
+mindos mcp install -g -y  # one-shot, global scope
+```
+
+**Skills** (workflow) — install one based on your language:
+
+```bash
+npx skills add https://github.com/GeminiLight/MindOS --skill mindos -g -y      # English
+npx skills add https://github.com/GeminiLight/MindOS --skill mindos-zh -g -y   # Chinese
+```
+
+> For remote access, manual JSON config, and common pitfalls, see **[docs/en/supported-agents.md](docs/en/supported-agents.md)**.
+
+### 5. Capture from Anywhere
+
+MindOS knowledge doesn't have to start from scratch — bring in what you already have:
+
+- **Drag & Drop**: drop files (PDF, images, Markdown, CSV) into the MindOS GUI — AI auto-organizes them into the right folders.
+- **Web Clipper**: install the [browser extension](packages/browser-extension/) to save any web page to your Inbox with one click. Ctrl+Shift+M or right-click → "Save to MindOS".
+- **Agent Import**: tell any connected Agent to read a document and sync it into your knowledge base.
+
+## ✨ Features
+
+**For Humans**
+
+- **GUI Workbench**: browse, edit, search notes with unified search + AI entry (`⌘K` / `⌘/`), designed for human-AI co-creation.
+- **Built-in Agent Assistant**: converse with the knowledge base in context; edits seamlessly capture human-curated knowledge.
+- **One-Click Import**: drag-and-drop files with Inline AI Organize — auto-analyzes, categorizes, and writes into the knowledge base with progress tracking and undo support.
+- **Guided Onboarding**: step-by-step first-run experience that helps new users set up their knowledge base and connect their first Agent.
+- **Plugin Extensions**: multiple built-in renderer plugins — TODO Board, CSV Views, Wiki Graph, Timeline, Workflow Editor, Agent Inspector, and more.
+- **Web Clipper**: browser extension to clip any web page as clean Markdown — one click, saves to Inbox for later AI-powered organizing. [Install →](packages/browser-extension/)
+
+**For Agents**
+
+- **MCP Server + Skills**: stdio + HTTP dual transport, full-lineup Agent compatible (Claude Code, Cursor, Gemini CLI, etc.). Zero-config access.
+- **ACP / A2A Protocols**: Agent communication protocols for discovery, delegation, and orchestration. Phase 1 is live with Agent Card discovery + JSON-RPC messaging.
+- **Workflow Orchestration**: YAML-based workflow editor with step execution engine — define, edit, and run multi-step agent workflows visually.
+- **Structured Templates**: pre-set directory structures for Profiles, Workflows, Configurations, etc., to jumpstart personal context.
+- **Agent-Ready Docs**: everyday notes naturally double as high-quality executable Agent commands — no format conversion needed, write and dispatch.
+
+**Infrastructure**
+
+- **Security**: Bearer Token auth, path sandboxing, INSTRUCTION.md write-protection, atomic writes.
+- **Knowledge Graph**: dynamically parses and visualizes inter-file references and dependencies.
+- **Backlinks View**: displays all files that reference the current file, helping you understand how a note fits into the knowledge network.
+- **Agent Inspector**: renders Agent operation logs as a filterable timeline to audit every tool call in detail.
+- **Git Time Machine**: Git auto-sync (commit/push/pull), records every edit by both humans and Agents. One-click rollback, cross-device sync.
+- **Desktop App**: native macOS/Windows/Linux app with system tray, auto-start, and local process management.
+
+<details>
+<summary><strong>Coming Soon</strong></summary>
+
+- [ ] Deep RAG integration: retrieval-augmented generation grounded in your knowledge base for more accurate, context-aware AI responses
+- [ ] ACP / A2A Phase 2: deep multi-agent collaboration with task delegation, shared context, and workflow chaining
+- [ ] Experience Compiler: auto-extract corrections and preferences from agent interactions into reusable Skills/SOPs
+- [ ] Knowledge Health Dashboard: visualize cognitive compound metrics — rules accumulated, agent reuse count, knowledge freshness
+
+</details>
+
+## ⚙️ How It Works
+
+```mermaid
+graph LR
+    H["👤 Human<br/><sub>thinks · reviews · evolves</sub>"]
+    M[("📚 MindOS")]
+    A["🤖 Agent<br/><sub>executes · retrospects · extracts SOPs</sub>"]
+    EXT["🌐 All Agents"]
+
+    H -- "ideas & feedback" --> M
+    M -- "context & insights" --> H
+    M -- "instructions & context" --> A
+    A -- "results & SOPs" --> 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
+```
+
+> **Both sides evolve.** Humans gain new insights from accumulated knowledge; Agents extract SOPs and get smarter. MindOS sits at the center — the shared second brain that grows with every interaction.
+
+---
+
+## 🤝 Supported Agents
+
+> The current registry supports 26 Agents. Full list with MCP config paths and manual setup: **[docs/en/supported-agents.md](docs/en/supported-agents.md)**
+
+| Agent | MCP | Skills |
+|:------|:---:|:------:|
+| OpenClaw | ✅ | ✅ |
+| Claude Code | ✅ | ✅ |
+| Cursor | ✅ | ✅ |
+| Codex | ✅ | ✅ |
+| Gemini CLI | ✅ | ✅ |
+| GitHub Copilot | ✅ | ✅ |
+| Trae | ✅ | ✅ |
+| CodeBuddy | ✅ | ✅ |
+| Qoder | ✅ | ✅ |
+| Cline | ✅ | ✅ |
+| Windsurf | ✅ | ✅ |
+| Hermes | ✅ | - |
+
+---
+
+## 📁 Project Structure
+
+```bash
+MindOS/
+├── packages/web/         # Next.js 16 frontend — browse, edit, and interact with AI
+├── packages/desktop/     # Electron desktop client
+├── packages/mobile/      # Expo mobile app
+├── packages/browser-extension/ # Web Clipper browser extension
+├── packages/desktop-tauri/     # Tauri desktop spike
+├── packages/mindos/      # Published product package: runtime facade, protocols, foundation/knowledge internals, CLI kernel
+├── packages/retrieval/   # Optional retrieval stack: search, vector, indexer, API
+├── skills/           # MindOS Skills (`mindos`, `mindos-zh`) — workflow guides for Agents
+├── templates/        # Preset templates (`en/`, `zh/`, `empty/`) — copied to knowledge base on onboard
+├── scripts/          # Setup wizard and helper scripts
+└── README.md
+
+~/.mindos/            # User data directory (outside project, never committed)
+├── config.json       # All configuration (AI keys, port, auth token, sync settings)
+├── sync-state.json   # Sync state (last sync time, conflicts)
+└── mind/             # Your private knowledge base (default path, customizable on onboard)
+```
+
+> In v1, top-level `app/`, `apps/`, `mcp/`, `desktop/`, `mobile/`, `browser-extension/`, `desktop-tauri/`, and root `bin/` are no longer source roots. The repo root is a private monorepo orchestrator. `packages/mindos` is the OpenCode-style published product package (`@geminilight/mindos`): its repo CLI entry is `packages/mindos/bin/cli.js`, installed npm users still receive the package-relative `bin/cli.js`, and the prebuilt local Web runtime is published as `_standalone/`. `packages/web` remains the only Web source tree and is not copied into the npm tarball. During `npm pack` / publish, `packages/mindos/_standalone`, `packages/mindos/packages`, `packages/mindos/scripts`, `packages/mindos/assets`, `packages/mindos/skills`, and `packages/mindos/templates` may be generated as staging output; they are ignored, excluded from pnpm workspace discovery, and cleaned by `pnpm run clean:product-stage` or product `postpack`.
+
+## ⌨️ CLI Commands
+
+> Full command reference: **[docs/en/cli-commands.md](docs/en/cli-commands.md)**
+
+| Command | Description |
+| :--- | :--- |
+| **Core** | |
+| `mindos onboard` | Interactive setup (config, template, start mode) |
+| `mindos start` | Start Web + MCP services |
+| `mindos start --daemon` | Start as background OS service |
+| `mindos stop` / `restart` | Stop or restart running processes |
+| `mindos dev` | Start in dev mode |
+| `mindos build` | Build for production |
+| `mindos status` | Show service status overview |
+| `mindos open` | Open Web UI in browser |
+| **Knowledge** | |
+| `mindos file <sub>` | File operations (list, read, create, delete, search) |
+| `mindos space <sub>` | Space management (list, create, info) |
+| `mindos search "<query>"` | Search knowledge base |
+| `mindos ask "<question>"` | Ask AI using your knowledge base |
+| `mindos agent <sub>` | AI Agent management (list, info) |
+| `mindos channel` / `mindos feishu-ws` | IM channel config and Feishu long connection |
+| `mindos api <METHOD> <path>` | Raw API passthrough for developers/agents |
+| **MCP & Config** | |
+| `mindos mcp install` | Auto-install MCP config into your Agent |
+| `mindos token` | Show auth token and MCP config |
+| `mindos config <sub>` | View/update config (show, set, validate) |
+| `mindos sync` | Show sync status (init, now, conflicts, on/off) |
+| `mindos gateway <sub>` | Manage background service (install, start, stop) |
+| `mindos doctor` | Health check |
+| `mindos update` | Update to latest version |
+
+**Main keyboard shortcuts:** `⌘K` Search · `⌘/` AI Assistant · `E` Edit · `⌘S` Save · `Esc` Close.
+
+---
+
+## 💬 Community <a name="wechat"></a>
+
+Join our WeChat group for early access, feedback, and AI workflow discussions:
+
+<p align="center">
+  <img src="assets/images/wechat-qr.png" alt="WeChat Group QR Code" width="200" />
+</p>
+
+> Scan the QR code or add WeChat **wtfly2018** to be invited.
+
+---
+
+## 👥 Contributors
+
+<a href="https://github.com/GeminiLight"><img src="https://github.com/GeminiLight.png" width="60" style="border-radius:50%" alt="GeminiLight" /></a>
+<a href="https://github.com/yeahjack"><img src="https://github.com/yeahjack.png" width="60" style="border-radius:50%" alt="yeahjack" /></a>
+<a href="https://github.com/USTChandsomeboy"><img src="https://github.com/USTChandsomeboy.png" width="60" style="border-radius:50%" alt="USTChandsomeboy" /></a>
+<a href="https://github.com/ppsmk388"><img src="https://github.com/ppsmk388.png" width="60" style="border-radius:50%" alt="ppsmk388" /></a>
+<a href="https://github.com/U-rara"><img src="https://github.com/U-rara.png" width="60" style="border-radius:50%" alt="U-rara" /></a>
+<a href="https://github.com/one2piece2hello"><img src="https://github.com/one2piece2hello.png" width="60" style="border-radius:50%" alt="one2piece2hello" /></a>
+<a href="https://github.com/zz-haooo"><img src="https://github.com/zz-haooo.png" width="60" style="border-radius:50%" alt="zz-haooo" /></a>
+
+### 🙏 Acknowledgements
+
+This project has been published on the [LINUX DO community](https://linux.do), and we deeply appreciate the community's support and feedback.
+
+---
+
+## 📄 License
+
+MIT © GeminiLight

package/README_zh.md

@@ -0,0 +1,385 @@
+<p align="center">
+  <img src="assets/logo-square.svg" alt="MindOS" width="100" />
+</p>
+
+<h1 align="center">MindOS</h1>
+
+<p align="center">
+  <strong>人类在此思考，Agent 依此行动。</strong>
+</p>
+
+<p align="center">
+  <a href="README.md">English</a> | <a href="README_zh.md">中文</a>
+</p>
+
+<p align="center">
+  <a href="https://tianfuwang.tech/MindOS"><img src="https://img.shields.io/badge/Website-MindOS-0ea5e9.svg?style=for-the-badge" alt="Website"></a>
+  <a href="https://www.npmjs.com/package/@geminilight/mindos"><img src="https://img.shields.io/npm/v/@geminilight/mindos.svg?style=for-the-badge&color=6366f1" alt="npm version"></a>
+  <a href="#wechat"><img src="https://img.shields.io/badge/WeChat-群聊-07C160.svg?style=for-the-badge&logo=wechat&logoColor=white" alt="WeChat"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-64748b.svg?style=for-the-badge" alt="MIT License"></a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/GeminiLight/MindOS/releases?q=desktop"><img src="https://img.shields.io/badge/桌面客户端-下载-d97706.svg?style=for-the-badge" alt="桌面客户端"></a>
+  <a href="https://github.com/GeminiLight/MindOS/releases?q=clipper"><img src="https://img.shields.io/badge/网页剪藏-安装-c8873a.svg?style=for-the-badge" alt="网页剪藏"></a>
+</p>
+
+MindOS 是你思考的地方，也是 AI Agent 行动的起点——一个你和所有 AI 共享的本地知识库。**每次思考，都在生长。**
+
+---
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="assets/images/demo-flow-zh-dark.webp" type="image/webp" />
+    <source media="(prefers-color-scheme: dark)" srcset="assets/images/demo-flow-zh-dark.png" />
+    <source media="(prefers-color-scheme: light)" srcset="assets/images/demo-flow-zh-light.webp" type="image/webp" />
+    <source media="(prefers-color-scheme: light)" srcset="assets/images/demo-flow-zh-light.png" />
+    <img src="assets/images/demo-flow-zh-light.png" alt="MindOS：从灵感到执行到复盘" width="960" />
+  </picture>
+</p>
+
+<table>
+  <tr>
+    <td width="50%">
+      <picture>
+        <source srcset="assets/images/mindos-home.webp" type="image/webp" />
+        <img src="assets/images/mindos-home.png" alt="MindOS 首页" />
+      </picture>
+    </td>
+    <td width="50%">
+      <picture>
+        <source srcset="assets/images/mindos-chat.webp" type="image/webp" />
+        <img src="assets/images/mindos-chat.png" alt="MindOS AI Agent" />
+      </picture>
+    </td>
+  </tr>
+  <tr>
+    <td align="center"><em>首页 — 知识库概览</em></td>
+    <td align="center"><em>AI Agent — 基于知识库主动识别意图并执行任务</em></td>
+  </tr>
+  <tr>
+    <td width="50%">
+      <picture>
+        <source srcset="assets/images/mindos-dashboard.webp" type="image/webp" />
+        <img src="assets/images/mindos-dashboard.png" alt="MindOS Agent 工作台" />
+      </picture>
+    </td>
+    <td width="50%">
+      <picture>
+        <source srcset="assets/images/mindos-echo.webp" type="image/webp" />
+        <img src="assets/images/mindos-echo.png" alt="MindOS Echo" />
+      </picture>
+    </td>
+  </tr>
+  <tr>
+    <td align="center"><em>Agent 工作台 — 管理所有已连接的 AI Agent</em></td>
+    <td align="center"><em>Echo — 复盘与认知沉淀</em></td>
+  </tr>
+</table>
+
+> [!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 暂存台。[安装 →](packages/browser-extension/) |
+| 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 步](#3-通过-mindos-agent-注入你的个人心智)：
+> ```
+> 帮我从 https://github.com/GeminiLight/MindOS 安装 MindOS，包含 MCP 和 Skills，使用中文模板。
+> ```
+
+> 已有知识库？直接跳到[第 4 步](#4-让任意-agent-可用mcp--skills)配置 MCP + Skills。
+
+### 1. 安装
+
+**方式 A：桌面客户端（macOS / Windows / Linux）**
+
+从[官网](https://tianfuwang.tech/MindOS/#quickstart)或 [GitHub Releases](https://github.com/GeminiLight/MindOS/releases/latest) 下载安装包，双击安装，无需终端。
+
+**方式 B：npm 安装**
+
+```bash
+npm install -g @geminilight/mindos@latest
+```
+
+**方式 C：克隆源码**
+
+```bash
+git clone https://github.com/GeminiLight/MindOS
+cd MindOS
+pnpm install
+pnpm link --global   # 将 mindos 命令注册为全局命令
+```
+
+npm 包会同时安装 CLI 和预构建的本地 Web runtime，这是设计目标：`mindos` 是命令入口，`mindos start` / `mindos open` 使用包内 `_standalone/` 启动浏览器 UI；Web 源码（`packages/web`）、测试、wiki、旧源码根和开发缓存不会进入发布包。
+
+### 2. 交互式配置
+
+```bash
+mindos onboard
+```
+
+配置向导会引导你完成知识库路径、模板、端口、认证、AI 服务商、启动模式等配置——所有选项都有合理默认值。配置自动保存到 `~/.mindos/config.json`。完整字段说明见 **[docs/zh/configuration.md](docs/zh/configuration.md)**。
+
+> [!TIP]
+> 选择"后台服务"模式可开机自启。随时运行 `mindos update` 升级到最新版本。
+
+在浏览器中打开 Web UI：
+
+```bash
+mindos open
+```
+
+### 3. 通过 MindOS Agent 注入你的个人心智
+
+1. 打开 MindOS GUI 中内置的 Agent 对话面板。
+2. 上传你的简历或任意个人/项目资料。
+3. 发送指令：`帮我把这些信息同步到我的 MindOS 知识库。`
+
+
+### 4. 让任意 Agent 可用（MCP + Skills）
+
+**MCP**（连接能力）— 一条命令自动安装：
+
+```bash
+mindos mcp install        # 交互式
+mindos mcp install -g -y  # 一键全局安装
+```
+
+**Skills**（工作流能力）— 根据语言偏好选择其一：
+
+```bash
+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](docs/zh/supported-agents.md)**。
+
+### 5. 随时随地捕获知识
+
+MindOS 的知识不必从零开始——把你已有的信息导入进来：
+
+- **拖拽导入**：将文件（PDF、图片、Markdown、CSV）直接拖入 MindOS GUI，AI 自动分析并归档到对应文件夹。
+- **网页剪藏**：安装[浏览器插件](packages/browser-extension/)，一键保存任意网页到暂存台。快捷键 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 自动整理归档。[安装 →](packages/browser-extension/)
+
+**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 应用，系统托盘、开机自启、本地进程管理。
+
+<details>
+<summary><strong>即将到来</strong></summary>
+
+- [ ] RAG 深度集成：基于知识库内容的检索增强生成，让 AI 回答更精准、更有上下文
+- [ ] ACP / A2A Phase 2：深度多 Agent 协作，支持任务委派、共享上下文、工作流链式执行
+- [ ] 经验编译器：从 Agent 交互中自动提取纠正和偏好，沉淀为可复用的 Skills/SOP
+- [ ] 知识库健康度仪表盘：可视化认知复利指标——已积累规则数、Agent 复用次数、知识新鲜度
+
+</details>
+
+## ⚙️ 运作机制
+
+```mermaid
+graph LR
+    H["👤 人类<br/><sub>思考 · 审查 · 进化</sub>"]
+    M[("📚 MindOS")]
+    A["🤖 Agent<br/><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](docs/zh/supported-agents.md)**
+
+| Agent | MCP | Skills |
+|:------|:---:|:------:|
+| OpenClaw | ✅ | ✅ |
+| Claude Code | ✅ | ✅ |
+| Cursor | ✅ | ✅ |
+| Codex | ✅ | ✅ |
+| Gemini CLI | ✅ | ✅ |
+| GitHub Copilot | ✅ | ✅ |
+| Trae | ✅ | ✅ |
+| CodeBuddy | ✅ | ✅ |
+| Qoder | ✅ | ✅ |
+| Cline | ✅ | ✅ |
+| Windsurf | ✅ | ✅ |
+| Hermes | ✅ | - |
+
+---
+
+## 📁 项目架构
+
+```bash
+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](docs/zh/cli-commands.md)**
+
+| 命令 | 说明 |
+| :--- | :--- |
+| **核心** | |
+| `mindos onboard` | 交互式初始化（生成配置、选择模板） |
+| `mindos start` | 前台启动 app + MCP 服务 |
+| `mindos start --daemon` | 以后台 OS 服务方式启动 |
+| `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 ask "<question>"` | 基于知识库向 AI 提问 |
+| `mindos agent <sub>` | AI 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>` | 管理后台服务（install, start, stop） |
+| `mindos doctor` | 健康检查 |
+| `mindos update` | 更新到最新版本 |
+
+**主要快捷键：** `⌘K` 搜索 · `⌘/` AI 助手 · `E` 编辑 · `⌘S` 保存 · `Esc` 关闭。
+
+---
+
+## 💬 社区 <a name="wechat"></a>
+
+加入微信内测群，抢先体验、反馈建议、交流 AI 工作流：
+
+<p align="center">
+  <img src="assets/images/wechat-qr.png" alt="微信群二维码" width="200" />
+</p>
+
+> 扫码加入，或添加微信 **wtfly2018** 邀请入群。
+
+---
+
+## 👥 贡献者
+
+<a href="https://github.com/GeminiLight"><img src="https://github.com/GeminiLight.png" width="60" style="border-radius:50%" alt="GeminiLight" /></a>
+<a href="https://github.com/yeahjack"><img src="https://github.com/yeahjack.png" width="60" style="border-radius:50%" alt="yeahjack" /></a>
+<a href="https://github.com/USTChandsomeboy"><img src="https://github.com/USTChandsomeboy.png" width="60" style="border-radius:50%" alt="USTChandsomeboy" /></a>
+<a href="https://github.com/ppsmk388"><img src="https://github.com/ppsmk388.png" width="60" style="border-radius:50%" alt="ppsmk388" /></a>
+<a href="https://github.com/U-rara"><img src="https://github.com/U-rara.png" width="60" style="border-radius:50%" alt="U-rara" /></a>
+<a href="https://github.com/one2piece2hello"><img src="https://github.com/one2piece2hello.png" width="60" style="border-radius:50%" alt="one2piece2hello" /></a>
+<a href="https://github.com/zz-haooo"><img src="https://github.com/zz-haooo.png" width="60" style="border-radius:50%" alt="zz-haooo" /></a>
+
+### 🙏 致谢
+
+本项目已在 [LINUX DO 社区](https://linux.do) 发布，感谢社区的支持与反馈。
+
+---
+
+## 📄 License
+
+MIT © GeminiLight

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@geminilight/mindos-linux-x64-musl",
+  "version": "1.0.3",
+  "description": "MindOS runtime package for linux-x64-musl",
+  "type": "module",
+  "license": "MIT",
+  "os": [
+    "linux"
+  ],
+  "cpu": [
+    "x64"
+  ],
+  "bin": {
+    "mindos": "bin/mindos"
+  },
+  "files": [
+    "bin/",
+    "package.json",
+    "runtime-manifest.json",
+    "README.md",
+    "README_zh.md",
+    "LICENSE"
+  ]
+}

package/runtime-manifest.json

@@ -0,0 +1,28 @@
+{
+  "schemaVersion": 1,
+  "product": {
+    "name": "@geminilight/mindos",
+    "version": "1.0.3"
+  },
+  "package": {
+    "name": "@geminilight/mindos-linux-x64-musl",
+    "platform": "linux-x64-musl",
+    "os": "linux",
+    "cpu": "x64",
+    "layout": "bun-single-binary"
+  },
+  "entrypoints": {
+    "cli": "bin/mindos",
+    "web": "bin/mindos",
+    "mcp": "bin/mindos"
+  },
+  "health": {
+    "route": "/api/health"
+  },
+  "artifacts": [
+    "bin/mindos",
+    "static-web/",
+    "package.json",
+    "runtime-manifest.json"
+  ]
+}