Pinvou/pinvou-agent

Pinvou Agent – 桌面 AI 驱动工作空间

它是什么 – 一个开源桌面应用，让你可以通过三种模式与对话式 AI 代理协作：工作（通用任务）、设计（创建和编辑视觉资产）和 代码（编程辅助）。它结合了聊天、文件处理、知识库和可扩展工具，使代理能够生成实际工件——文档、设计或代码——而不仅仅是文本回复。

核心理念

• 一个工作空间，多个会话 – 每个会话保留自己的聊天历史、工具调用和生成的文件。你可以按标题搜索会话。
• 工件面板 – 代理创建的每个文件（Markdown、图像、代码、PDF 等）都会自动收集，用于预览、打开或进一步编辑。
• 本地优先隐私 – 通过 vLLM 或任何兼容 OpenAI 的端点运行本地模型。当你只使用本地模型和工具时，没有数据离开你的机器。
• 可扩展工具 – 统一的“工具商店”让你添加 MCP 服务器、CLI 工具或 API 连接器（例如飞书、钉钉、Obsidian）。技能、命令和工作流将可重复的方法转化为可复用的能力。
• 知识与记忆 – 对附加文档进行内置向量/全文搜索，长期记忆中心用于偏好，以及用于领域特定角色的人设卡片。

主要功能

• 多会话工作空间，标题可搜索。
• 拖放附件（PDF、Office、图像等）。
• 可编辑的 Markdown 工件，并可通过代理进行就地修订。
• 计划模式（查看逐步计划）和 YOLO模式（直接执行）。
• 侧边聊天用于辅助问题，不影响主任务。
• 本地知识库，支持向量检索；你可以按聊天启用/禁用集合。
• 人设卡片池，用于专家角色。
• 工具商店，用于本地/远程 MCP 服务器、CLI 工具和 API 连接器。
• 通过手机扫描二维码进行远程控制。
• 语音输入，可选按需下载语音模型。
• 系统监控（GPU、内存、磁盘、模型使用情况）。
• 跨平台（Windows、macOS、Linux）桌面，基于 Tauri 2 构建。

典型用例

用例	Pinvou 如何帮助
研究与报告撰写	附加 PDF，让代理总结、整理笔记，并输出精美的 Markdown 报告。
平面设计	描述海报或图表，接收生成的图像，切换到 设计模式，直接调整布局、字体、颜色。
软件开发	通过 ACP 连接到 Codex、Claude Code 或 Kimi，让代理读取真实代码库、提出更改、运行命令并提交编辑后的文件。
企业工作流	使用内置连接器（飞书、钉钉、Obsidian）获取数据，应用技能（例如法律文本提取），并将结果存储在知识集合中。

技术栈

• 前端：React 19 + Vite，在 Tauri 2 桌面壳中渲染。
• 后端 / 代理引擎：CodeWhale 子模块（Rust）处理模型调用、流式传输、工具执行、MCP、技能和会话管理。
• 模型访问：支持本地 vLLM 服务器和任何兼容 OpenAI 的 API（DeepSeek、Kimi、Qwen、Anthropic、Gemini 等）。
• 存储：所有用户数据位于 ~/.pinvou3/（会话、知识库、设置）。
• 可扩展性：技能/命令在 SKILL.md 包中定义；外部工具作为 MCP 服务器或 CLI 连接器添加。

入门指南

1. 安装先决条件 – Git（带子模块）、Node ≥ 18、Rust 工具链，以及适用于你操作系统的 Tauri 2 系统依赖。
2. 递归克隆仓库：

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

3. 在应用设置中或通过 README 中所示的环境变量配置模型端点（本地 vLLM 或兼容 OpenAI 的 API）。
4. 启动应用，创建新工作空间，附加文件或选择模式（工作/设计/代码），然后开始与代理聊天。

社区与支持

• QQ 用户群（中文）– README 中的二维码。
• GitHub Issues 用于错误，Discussions 用于想法，以及私有安全渠道。
• 提供贡献指南、行为准则和分叉政策。

许可证 – MIT（见 LICENSE）。

---

Pinvou Agent 是一个积极维护的项目；main 分支和发布说明反映了当前功能集。