使用说明
Ghost
The Private Agent OS for Desktop & Mobile
Index files · Run AI agents · Connect to 10,000+ tools — all without sending data to the cloud
Website · Download · Features · Architecture · Roadmap · Contributing
Ghost是一个私人的,本地优先 代理操作系统 适用于台式机和移动设备。它为您的文件建立索引,了解您的上下文,通过开放协议连接到数千个工具,并代表您采取行动,而无需向云端发送任何字节。
你的数据永远不应该离开你的机器去完成事情。
Ghost在您的硬件上原生运行AI——没有云API,没有GPU要求,没有外部依赖。从语义搜索到代理工具调用,一切都在本地发生。它使用完整的2026代理协议栈(MCP、AG-UI、A2UI、A2A),因此您可以在不放弃隐私的情况下连接到每个AI生态系统。
特性
搜索--即时智能
- <5ms关键字搜索 (英尺5)+ <500ms语义搜索 (sqlite-vec KNN)通过 互逆排序融合
- 本土的 全迷你LM-L6-v2 通过Candle嵌入(384D,~23MB)——零外部依赖
- 备用链:本土蜡烛→ 奥利玛(768D)→ 仅关键字
- PDF、DOCX、XLSX、TXT、Markdown和50多种代码格式的实时文件查看器
AI——原生和硬件自适应
- 自动检测CPU/RAM/GPU→ 选择最优 Qwen2.5指导GGUF (0.5B–7B,Q4_K_M)
- ReAct代理:原因→ Act → 使用语法约束的工具调用和三层安全性进行观察
- 零配置:检测硬件→ 选择模型→ 从HuggingFace Hub下载→ 后台加载
- 优雅的回退:原生GGUF→ Ollama HTTP→ 离线模式
协议——完整的2026代理栈
Ghost是第一个实现所有主要代理协议的桌面应用程序——没有供应商锁定,没有专有API。
| 协议 | 状态 | 它的作用 |
|---|---|---|
| 主控程序 | ✅ 服务器+客户端 | 暴露Ghost工具+通过以下方式连接到10000多个外部服务器 rmcp |
| MCP目录 | ✅ App Store | 30+精选服务器+6000+来自MCP官方注册表,一键安装 |
| 运行时引导 | ✅ 零配置 | 自动安装Node.js、uv/Python——无需手动设置 |
| MCP应用程序 | 🔜 下一页 | 在对话中渲染交互式工具UI(官方MCP扩展) |
| AG-UI | ✅ 运行时 | 双向代理↔用户流——30多种事件类型(推理、活动、ToolCallResult)、SSE端点 |
| A2UI | ✅ 渲染器 | 生成式UI——17+种组件类型(带活动切换、输入、数据绑定的选项卡) |
| 技能 | ✅ 注册表 | YAML frontmatter技能定义+触发器匹配 |
| A2A | ✅ 发现 | 代理卡位于 /.well-known/agent.json +JSON-RPC存根——第二阶段的全任务布线 |
| WebMCP | 🔜 计划 | 用于结构化web交互的W3C浏览器桥 |
平台——一个代码库,五个目标
- 视窗 (NSIS) macOS (DMG×2)· Linux (DEB/RPM/AppImage)· 安卓 (APK/AAB)· iOS (准备好了)
- <10MB安装程序 · <40MB闸板 闲置· <500ms 冷启动
- 条件编译(
#[cfg(desktop)]/#[cfg(mobile)])--单个Rust代码库 - 机载向导、系统托盘、零配置文件发现
路线图
看 ROADMAP.md→ 全面发展规划。
- 下一步:MCP Apps交互式UI、A2A多代理协调、操作系统UI自动化
- 然后:WebMCP浏览器桥、技能市场、B2B/团队
建筑
Ghost使用6层 代理操作系统 每一层都可以独立替换的架构:
┌──────────────────────────────────────────────────────┐
│ Frontend (React/TypeScript) │
│ Omnibox │ Results │ Chat │ A2UI Renderer │ Settings │
├──────────────────────────────────────────────────────┤
│ AG-UI Runtime (Agent ↔ User Streaming) │
│ ~16 event types │ Human-in-the-loop │ State sync │
├──────────────────────────────────────────────────────┤
│ Tauri v2 IPC Bridge │
├──────────────────────────────────────────────────────┤
│ Agent Engine (ReAct Loop) │
│ Executor │ Tools │ Safety │ Memory │ Skills │
├──────────────────────────────────────────────────────┤
│ Protocol Hub (Rust — rmcp + custom) │
│ MCP Server │ MCP Client │ MCP Apps │ A2A │ WebMCP │
├──────────────────────────────────────────────────────┤
│ Core Engine (Rust) │
│ File Watcher │ Text Extractor │ Embedding Engine │
│ Vector DB │ OS Automation │ Micro-agents │
├──────────────────────────────────────────────────────┤
│ AI Layer (Local — Zero Dependencies) │
│ Native: Candle + all-MiniLM-L6-v2 (384D embeddings) │
│ Fallback: Ollama + nomic-embed-text (768D) │
│ Chat: Qwen2.5-Instruct GGUF (0.5B–7B, native) │
│ Agent: Qwen2.5-Instruct GGUF (0.5B–7B, tool calling) │
└──────────────────────────────────────────────────────┘
混合触发系统
Ghost使用双速架构,在不烧坏CPU的情况下感觉即时:
| 图层 | 时间 | 速度 | 资源使用情况 |
|---|---|---|---|
| 快层 | 始终 | <10ms | 0%GPU,<1%CPU |
| 智能夹层 | 按需 | 200-2000ms | 激活本地AI |
快速层使用操作系统可访问性API和FTS5关键字搜索。仅当用户提出自然语言问题、请求操作或新文件需要索引时,智能层才会激活。
技术栈
| 层 | 技术 | 目的 |
|---|---|---|
| Shell | Tauri v2+React 18 | <10MB安装程序,原生性能,5个平台 |
| 数据库 | SQLite+SQLite vec+FTS5 | 向量+文本+元数据合二为一 .db |
| 嵌入 | 蜡烛+全MiniLM-L6-v2 | 384D,~23MB,进程中,零deps |
| 聊天/代理 | 蜡烛GGUF+Qwen2.5指令 | 0.5B–7B层,工具调用,重新行动 |
| 协议 | rmcp·AG-UI·A2UI·MCP应用程序·A2A | MCP服务器+客户端、流媒体、gen UI |
| 提取 | lopdf·zip·炉甘石 | PDF、DOCX、XLSX——纯铁锈 |
下载
| 平台 | 格式 | 注释 |
|---|---|---|
| 视窗 x64 | .exe (NSIS) |
无需管理员,WebView2自动引导 |
| macOS 苹果硅 | .dmg |
M1/M2/M3/M4 |
| macOS 英特尔 | .dmg |
x64,macOS≥10.15 |
| Linux x64 | .deb .rpm .AppImage |
Debian、Fedora、通用 |
| 安卓 ARM64 | .apk .aab |
Min SDK 24,Tauri v2网络视图 |
没有外部依赖关系。 Ghost附带了原生AI——首次安装后没有Ollama、GPU和互联网。
从源代码构建
先决条件: 锈 (稳定)· 包子 ≥1.0(或节点≥18)· Tauri v2 deps
git clone https://github.com/ghostapp-ai/ghost.git && cd ghost
bun install
bun run tauri dev # Dev mode — native model downloads ~23MB on first run
bun run tauri build # Production build → src-tauri/target/release/bundle/
# Android (requires SDK + NDK 27+)
bun run tauri android build --target aarch64
可选安装 奥拉玛 然后拉 nomic-embed-text 用于更高质量的768D嵌入。
项目结构
src/ # React 18 + TypeScript frontend
components/ # Onboarding, GhostInput, ChatMessages, A2UIRenderer, Settings …
hooks/ # useSearch, useAgui, usePlatform, useHotkey
lib/ # Tauri IPC wrappers, types, mode detection
src-tauri/src/ # Rust backend
indexer/ # File watcher + text extraction + chunking
db/ # SQLite · sqlite-vec · FTS5
embeddings/ # Native Candle + Ollama fallback + hardware detection
search/ # Hybrid search + RRF ranking
chat/ # Candle GGUF inference + model registry
agent/ # ReAct executor + tools + safety + memory + skills
protocols/ # MCP server/client · MCP catalog · Runtime bootstrap · AG-UI · A2UI · A2A · WebMCP
website/ # Astro Starlight documentation (GitHub Pages)
branding/ # Icons, social, brand guidelines
路线图
看 ROADMAP.md 详细的开发计划,包括阶段、里程碑和技术交付成果。
隐私和安全
- 零遥测Ghost不收集使用数据,不进行分析,也不收集崩溃报告。
- 仅本地处理:所有AI推理都在你的机器上运行——原生Candle引擎或可选的Ollama。
- 单文件数据库:你的整个保险库就是一个
.db你控制的文件。 - 可选加密:ChaCha20-Poly1305,用于启用同步时的保险库加密(第2阶段)。
- 开源核心:发动机完全可审计。
贡献
欢迎投稿!阅读 贡献.md 用于设置和约定。安全问题→ 安全.md.
许可证
麻省理工学院 --免费和开源。
致谢
涛瑞 · 蜡烛 · sqlite-vc · rmcp · 奥拉玛 · 主控程序 · A2A · AG-UI · 开爪
Your data · Your machine · Your ghost
Website · Download · Discussions
