Pinvou Agent 不只是一个聊天界面。它把通用工作、视觉设计和代码开发放进同一个桌面应用，让 AI 从“回答问题”进一步走到“完成任务”。你可以让它调用工具、处理文件和沉淀知识，也可以通过 ACP 驱动专业代码 Agent，或把一句描述变成可继续编辑的视觉产物。

模型既可以运行在本地，也可以接入任意 OpenAI-compatible 服务；工具、Skills 与连接器按需启用。

🧭 一个工作台，三种工作方式

💼 工作：让 AI 处理真实任务

结合文件附件、个人知识、专家角色、Skills、MCP 工具和工作流，完成资料整理、公文写作、信息检索、业务分析等任务，并把结果交付为可继续使用的文件，而不只是一段聊天回复。

🎨 设计：从一句描述到可编辑的视觉产物

用自然语言生成海报和数据可视化产物。生成后可以直接进入编辑模式，选中画面中的元素，调整文案、字体、颜色、尺寸和布局；也可以继续描述要求，让 AI 在当前设计上迭代。

💻 代码：把代码 Agent 带进真实项目

通过 ACP 在同一工作台中使用 Codex、Claude Code 和 Kimi。代码 Agent 可以在真实项目目录或隔离的临时工作区中阅读和修改代码、运行命令，并展示计划、工具步骤、权限请求和文件变化；会话与工作区绑定，可在应用重启后继续。

✨ 功能特性

🎯 从对话到可交付产物

• 多会话管理与会话标题搜索，历史消息、工具调用和产物随会话持久化
• 支持 PDF、Office 文档、图片和文本附件，可拖拽或粘贴导入
• 产物面板自动收集 AI 创建或修改的文件，集中预览、定位和打开
• Markdown 产物可直接编辑，也可选中内容继续让 AI 修改
• Plan / YOLO 双模式：复杂任务先确认方案，明确任务可直接执行
• 辅助对话：任务运行期间旁路提问——每条任务挂独立侧会话，唯一工具是服务端强制的本任务历史只读视图（ADR-0024），与主任务执行上下文隔离

🧠 知识与记忆

• 本地知识库支持文件管理、全文检索与向量检索；同一对话可挂载多个知识库并分别启用、停用或移除，回答保留知识库与文件来源
• 记忆中心沉淀长期偏好和上下文，并提供候选确认与管理
• 专家卡牌池可创建、保存和加持不同领域角色
• Skills、Commands 与工作流把可复用的方法固化为稳定能力

🔌 连接真实业务工具

• 工具商店统一管理本地 MCP、远程 MCP、CLI 和 API 连接器
• 支持 OAuth / SSO 等免手填密钥的授权方式
• 可按需连接飞书、钉钉、企业微信、腾讯会议、腾讯文档、腾讯 ima、Obsidian，以及企查查、智慧芽、Canva、高德天气等能力
• 移动端扫码后可远程查看和控制当前工作区

🖥️ 面向实际运行

• 全局唤醒快捷键（默认关闭，Ctrl/Cmd+Alt+P）— 在 设置 → 通用 中开启后，窗口在后台时也能按键将其带到前台
• 本地语音输入，语音模型按需下载
• GPU、内存、磁盘、模型服务与上下文使用情况集中监控
• 版本更新通过 GitHub Releases 分发（应用内更新检查暂未启用）
• 会话、设置、知识和运行时扩展统一保存在 ~/.pinvou3/

[!NOTE] 数据是否离开本机取决于你选择的模型服务和工具。使用本地模型与本地工具时可保持本地闭环；启用云模型、远程 MCP 或第三方连接器时，相关请求会发送给对应服务。

📸 界面预览

设计模式：海报与数据可视化	代码模式：Codex、Claude Code 与 Kimi
工具与连接器按需扩展	产物集中预览与交付

🤖 模型接入

Pinvou Agent 支持本地 vLLM 和任意 OpenAI-compatible API。应用内可保存多个模型配置，为云端配置设置可选显示别名，并在不改变实际请求模型 ID 的情况下于不同会话间快速切换；当前提供本地 vLLM、DeepSeek、Kimi、通义千问、豆包、MiniMax、智谱、MiMo、OpenAI、Anthropic、Gemini、xAI 等配置模板，也可以填写自定义兼容端点。

本地 vLLM 示例：

export DEEPSEEK_BASE_URL="http://127.0.0.1:8000/v1"
export DEEPSEEK_API_KEY="local-no-auth"
export DEEPSEEK_MODEL="your-model-name"

模型地址、模型名和密钥也可以直接在应用设置中管理。对于可信开发网络内的非本机明文 HTTP 端点，开发环境还需显式设置 DEEPSEEK_ALLOW_INSECURE_HTTP=1。

🚀 快速开始

前置条件

• Git（支持 submodule）
• Node.js 与 npm
• Rust toolchain
• Tauri 2 系统依赖
• 一个可访问的 OpenAI-compatible 模型端点

源码树支持 Linux、Windows 和 macOS；Linux 发布包的目标基线为 Ubuntu 22.04 及以上（glibc 2.35+，x86_64 与 arm64；deb 另要求 WebKitGTK 2.40+，已应用标准更新源的 22.04 系统均满足），以及 LoongArch64（新世界：UOS V25 或 deepin 23 及以上，glibc 2.38+）。旧世界（old-world）龙芯系统（UOS V20 龙芯版、Loongnix 20、麒麟 V10 时代）不受支持：缺少 Tauri 2 运行所必需的 webkit2gtk-4.1/libsoup3，且系统 rustc 工具链停留在 1.58 及以下。macOS 发布包为 universal（Apple Silicon + Intel）构建、要求 macOS 11.0+。语音识别引擎可按构建配置打包；文件解析（PDF / Office / OCR / 压缩包等）依赖可选外部工具，可通过 Homebrew、apt 或各工具官网安装（见 pinvou3-app/INSTALL.md）。

启动应用

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

如果仓库已经克隆但 submodule 尚未拉取：

git submodule update --init --recursive

🏗️ 架构

React + Vite UI
       ↕ Tauri commands / events
pinvou3-app（桌面编排层）
       ↕ EngineHandle / AgentHarness
CodeWhale（Agent 底座 submodule）
       ├─ OpenAI-compatible 模型服务
       ├─ MCP servers / CLI connectors
       └─ Skills / Commands / Hooks / Compaction

模型调用、流式输出、工具循环、Session、MCP client、Skills、Hooks 和 Compaction 由 CodeWhale 底座提供。pinvou3-app/ 负责桌面 UI、运行时配置、业务编排和系统集成，不重复实现底座能力。

扩展能力时按以下边界落位：

需求	扩展位置
增加领域 Agent 或工具组合	SKILL.md
接入外部 API	独立 MCP server 或连接器
调整模型行为	bundle 中的 instructions.md
桌面 UI、系统能力或 Engine 配置	pinvou3-app/
修复底座通用问题	CodeWhale fork，并按 fork policy 维护

📁 仓库结构

pinvou3-app/          Tauri 2 + React/Vite 桌面应用
CodeWhale/            Agent 底座 submodule
pinvou-knowledge/     可复用知识库核心与自包含服务器
remote-control-relay/ 扫码远控的可选自托管 relay
pinvou3-app/resources/mcp-servers/
                      独立 MCP 服务
scripts/              测试、守卫、构建与发布脚本
docs/                 架构设计、验证报告与维护文档

🧪 常用验证

# 以下命令均从仓库根目录执行
(cd pinvou3-app && npm run lint:ui)
(cd pinvou3-app && npm run build:ui)
(cd pinvou3-app && npm test)

(cd pinvou3-app/src-tauri && cargo test --lib -- --test-threads=1)

./scripts/fork-guard.sh --fast

🤝 参与贡献

欢迎贡献！提交前请阅读 贡献指南 了解流程与 CI 门控；涉及 CodeWhale 底座的改动请遵循 fork 策略 与 当前 fork 修改清单。参与本项目即表示同意遵守 社区行为准则。

💬 社区与安全

• 🐧 QQ 用户交流群：1108909346 — 扫描下方二维码，或在 QQ 中搜索群号加入
• 🐛 GitHub Issues — 可复现的 bug 与聚焦的功能建议
• 💡 GitHub Discussions — 问题与想法交流（社区支持为尽力而为，见 SUPPORT.md）
• 🔒 请勿在公开 Issue 中报告安全漏洞 — 请使用 SECURITY.md 中的私有渠道，或发送邮件至 [email protected]

📖 进一步阅读

• 第三方许可声明
• 商标使用规则
• SBOM 说明
• 工具市场概览

🔗 友情链接

• LINUX DO

⭐ Star History

---