Pinvou/pinvou-agent

Open-source desktop AI agent for tools, files, knowledge, workflows, and real deliverables.

Pinvou Agent – 桌面 AI 助手工作区

是什么 – 一个开源桌面应用程序，让你能将对话式 AI 作为现实世界的助手来工作。它将聊天、文件处理、知识库搜索和工具集成整合为三种“模式”：工作（研究、写作、分析）、设计（将提示转化为可编辑的海报或图表）和代码（将编码代理引入实际代码库）。该应用可完全本地运行（例如使用 vLLM 服务器）或连接到任何 OpenAI 兼容 API，并可通过插件式技能、MCP 服务器、CLI 工具和第三方连接器进行扩展。

核心概念与工作流

概念	你能获得
工作区	带标题的会话，持久保存聊天记录、工具调用和生成的成果（文件、Markdown、图像等）。
成果面板	自动收集代理创建/编辑的每个文件；你可以预览、打开或进一步编辑它们。
计划 / YOLO 模式	选择在执行前查看逐步计划，或在任务明确时让代理直接运行。
知识库	对附加的 PDF、Office 文档、图像等进行本地向量/全文搜索；你可以在每个聊天中启用/禁用集合。
角色卡	保存的专家角色（例如“法律分析师”、“设计师”），可引导模型行为。
技能与工作流	可重复调用的命令组合，代理可将其作为稳定的能力使用。
工具商店	本地 MCP 服务器、远程 MCP 服务器、CLI 工具和 API 连接器（飞书、钉钉、Obsidian 等）的中央目录。
远程控制	扫描二维码，即可从手机查看或操控正在运行的工作区。
语音输入	可选的按需语音识别模型，支持免提提示输入。

显著功能

支持标题搜索的多会话 UI，可快速在项目间切换。
文件处理 – 拖拽 PDF、Office 文件、图像、归档文件；代理可读取并响应它们。
可编辑的 Markdown 成果 – 可直接编辑，或让代理重写选定段落。
带向量检索的本地知识库，保留每个文件的来源。
记忆中心，存储长期偏好，并让你确认候选记忆。
可扩展的连接器生态系统 – 支持 OAuth/SSO，以及为热门中国企服工具准备的现成连接器。
编码模式支持 Codex、Claude Code 或 Kimi 通过 ACP（代理-代码协议），允许代理读写真实项目文件、运行命令，并展示操作计划。
设计模式可从自然语言提示生成海报或数据可视化，并在应用内图形化编辑。

技术栈

Tauri 2 – 原生桌面封装（Rust 后端，WebView 前端）。提供 Windows、macOS、Linux 的跨平台构建。
React 19 + Vite – UI 层。
Rust 引擎（CodeWhale 子模块） – 处理模型调用、流式传输、工具执行、MCP 服务器编排、技能和会话管理。
模型访问 – 支持任何 OpenAI 兼容端点（OpenAI、Anthropic、Gemini、DeepSeek、Kimi、Qwen 等）和本地 vLLM 服务器。
文件系统布局 – 所有用户数据均位于 ~/.pinvou3/ 下（会话、知识集合、设置、扩展）。

快速入门

安装前置条件：Git（支持子模块）、Node ≥ 18、最新 Rust 工具链，以及你操作系统对应的 Tauri 2 系统依赖。

递归克隆仓库：

git clone --recursive https://github.com/Pinvou/pinvou-agent.git
cd pinvou-agent/pinvou3-app
npm ci
cd ..
./pinvou3-app/run-dev.sh

在应用设置中添加模型配置（本地 vLLM 地址或云 API 密钥）。
创建新工作区，附加文件，选择角色或技能，在工作、设计或代码模式中开始任务。

预构建二进制文件也可在发布页面获取，支持所有三个平台。

可扩展性

技能 – 添加 SKILL.md 包描述一个工具或方法；代理可在任何会话中调用它。
MCP 服务器 / CLI 连接器 – 通过统一工具商店接入外部服务（如企业知识库）。
自定义指令 – 将 instructions.md 与技能打包，以引导模型行为。
UI 变更 – 修改 pinvou3-app/ 文件夹；引擎变更请修改 CodeWhale/ 子模块。

社区与治理

聊天与支持 – QQ 群（中文）#1108909346，GitHub Issues，Discussions。
安全 – 私密报告渠道见 SECURITY.md。
贡献 – 遵循 CONTRIBUTING.md 和 CodeWhale 引擎的 fork 策略。

许可证

MIT – 宽松开源许可证，第三方版权信息见 THIRD_PARTY_NOTICES.md。

总结 – Pinvou Agent 是一个功能齐全的跨平台桌面环境，将对话式 LLM 转化为日常办公、视觉设计和软件开发的实用助手，当你本地运行时可确保数据私密。它基于现代 Web 原生（React/Vite）和原生（Tauri/Rust）技术构建，设计为通过模块化技能/连接器生态系统进行扩展。