Nuphus：本地优先桌面 AI Agent

项目简介

Nuphus 是一款运行在本机的 AI Agent，由 Tauri v2 + Rust + React 18 + TypeScript 构建，支持 Windows / macOS / Linux，采用 Apache-2.0 许可证。

它把 LLM 的推理转化为真实的桌面动作：识别屏幕、操控鼠标键盘、控制窗口、读写文件、调度浏览器。数据和记忆留在本机，模型由用户自行选择；桌面发起的会话会实时同步到手机，同一份记忆、同一个 Agent、同一场对话可以随时继续。

主要功能

真实桌面执行力

• 通过窗口 + OCR + 键鼠操控任意 GUI 软件与网页，无需对方提供 API
• 内置可编程浏览器内核，网页自动化、信息采集、表单交互均在本机完成
• 项目分析、代码生成、调试诊断、文件操作
• 并行调度 Cline、Claude Code 等外部 Agent，由 Leader 统一汇总决策

核心引擎为串行思考、并行执行：Leader 解析目标、规划路径、监督进度，内部按因果链调度 ExecAgent 逐步执行。

Workflow：把探索固化为确定性执行

用自然语言与 Agent 共同探索界面与流程，逐步固化参数，编译为确定性执行序列，之后由引擎以极低 token 重复执行；运行时 Agent 负责值守，出错时依据设计意图修复而非盲目重试。

双端实时同步

• 手机连接的就是桌面那个 Agent，共享历史、记忆与状态
• Agent 的思考、工具调用、执行结果通过 WebSocket 实时推送到手机
• 手机上可暂停、恢复、停止正在执行的工作流，并查看完整执行轨迹
• 同一 WiFi 自动局域网直连（零配置），离开后自动走中继远程通道，中继不落盘内容，只做身份校验与转发
• 手机以 PWA 形式添加到主屏幕使用

本地优先与隐私

• 对话、记忆、插件全部存储在本地
• PP-OCRv4（OCR）、Candle（语义搜索）本地运行，日常识别零 API 消耗
• 权限开关 → 人在回路 → 注入检测 → 熔断保护，共 4 层安全体系
• 统一接入 OpenAI / Anthropic / DeepSeek / Qwen / 智谱等主流模型厂商，可随时切换

其他能力

• 内置工具页 23 个处理命令：PDF（合并/压缩/文本提取/图片转 PDF/抽页/旋转）、图像（压缩/格式转换/缩放/拼接/批量）、视频（压缩/抽帧/转 GIF/截取）、音频（提取/转换/语音克隆）、文档（docx / pptx / xls / pdf 转文本）
• 记忆系统：SQLite 持久化 + FTS5 + 向量语义检索
• 零编译扩展：知识库、技能、工作流、ui-maps 均为纯文本文件，放入 plugin/ 即生效
• 视觉感知三层：内置 OCR → 可配置视觉模型 → 用户视觉引导
• 任务完成、错误、重试均有音效提示

安装与使用

npm 一键安装（推荐）

npm install -g @nuphus/nuphus-desktop

或免安装体验：npx @nuphus/nuphus-desktop。安装后终端输入 nuphus 启动，无需 Node.js / Rust 环境。

下载安装包

从官方网站或 GitHub Releases 下载对应平台安装包：

• Windows：.exe（NSIS 安装包，用户级安装，无需管理员权限）
• macOS：.dmg
• Linux：.deb / .AppImage

从源码构建

前置条件：Rust 1.95.0、Node.js ≥ 20、Tauri CLI。

git clone https://github.com/mrpulor-gh/nuphus.git
npm install
npx tauri dev

配置与连接手机

1. 首次启动进入引导页，选择模型提供商并填入 API Key
2. 在「设置 → 模型」中可随时修改配置
3. 在桌面端「手机」设置页开启移动端服务（默认端口 18772）
4. 手机浏览器打开配对页，输入配对密码完成绑定，再添加到主屏幕（PWA）

注意事项

• API Key 加密存储：Windows 上经系统级 DPAPI 加密后写入 config.toml（enc:v1: 格式，绑定当前用户）；macOS / Linux 暂以明文保存，依赖系统文件权限，请勿分享或提交该文件。
• 「Continue with ChatGPT」为官方预览接口接入，模型、额度与可用范围以账号和官方接口为准，可用性可能调整。
• 首次通过 npm 安装体积较大（含本地 OCR 与语音模型），需要耐心等待。
• 国内下载缓慢时可改从 Gitee Releases 获取 Windows 安装包；macOS / Linux 安装包暂仅托管在 GitHub。

本作品整理自 GitHub 开源项目 mrpulor-gh/nuphus，原作者 @mrpulor-gh，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。