Pinvou Agent 代码模式实战通过 ACP 在同一工作台驱动 Codex、Claude Code 与 Kimi【免费下载链接】pinvou-agentOpen-source desktop AI agent for tools, files, knowledge, workflows, and real deliverables.项目地址: https://gitcode.com/gh_mirrors/pi/pinvou-agentPinvou Agent 是一款开源的桌面 AI 智能体工作台它的代码模式基于 ACP 协议让你用同一套界面驱动 Codex、Claude Code 与 Kimi 三大编码智能体真实项目目录、权限确认、计划与工具步骤、会话恢复全部开箱即用无需在终端和 IDE 之间来回切换。同一个工作台三种模式、四个编码智能体Pinvou Agent 的主页输入框上方提供工作 / 设计 / 代码三种模式切换。切到代码后输入框下方可以直接选择编码智能体Codex、Claude Code、Kimi三者走 ACP 链路另有品悟原生代码会话可选手动选择。三类会话按最近更新时间混排在左侧统一会话列表中以各自的 Agent 图标区分不再占用单独的侧边栏入口。也就是说你可以在同一个界面里继续昨天用 Claude Code 改的 bug又能新开一个 Codex 会话处理另一个项目。Agent启动方式登录方式品悟原生进程内 CodeWhale Engine非 ACP 子进程沿用工作模式的模型凭据无需独立登录CodexPinvou 内置codex-acpBridge应用内完成 Codex OAuth也支持OPENAI_API_KEYClaude CodePinvou 内置claude-agent-acpBridgeJS 适配器点击授权登录也支持 API Key 类环境变量Kimi系统kimi acpCLI≥ 0.9.0点击授权登录按提示完成设备码授权详细对照表见 docs/multi-agent-acp.mdACP 代码模式新手使用从选择目录到发送首条消息上手只需要四步进入代码模式主页切换到代码选择 Codex / Claude Code / Kimi 之一选择工作区输入框左下角默认临时会话Agent 在隔离目录干活也可以选择项目目录——Agent 的进程 cwd、session/new和session/load都使用该真实项目目录首次发送自动建会话直接发送首条消息时才创建会话避免只切换模式就产生空记录流式接收结果思考、工具步骤、计划、权限选择、停止生成、会话恢复全部可用。同一项目可以创建多个独立会话会话开始后不能更换目录需要切换项目时新建会话即可。CLI 一键安装与升级缺失自动装、过旧自动升这是 ACP 方案对新手最友好的地方。Pinvou 对三个 Agent 走同一套探测流程先探测本机 CLIPATH与常见安装位置再对照官方 latest 来源判断版本。CLI 缺失经你确认后自动调用官方安装脚本完成用户态安装无需管理员权限装到用户目录版本过旧先判定安装来源Homebrew / npm 全局 / 官方脚本再按来源用对应包管理器或脚本升级避免同一 CLI 多来源并存国内网络兜底官方脚本源不可达且系统存在 npm 时安装动作自动降级为 npm 全局安装。安装升级的实现位于 install.rs对应的应用层命令install_acp_agent定义在 codex.rs。整个过程不静默执行外部命令也不会创建 Pinvou 托管的 CLI 副本Bridge 本体隔离 Node JS 适配器随安装包自带不要求你系统安装 Node/npm。为什么 ACP 能统一驱动三个编码智能体ACPAgent Client Protocol的核心思想宿主应用负责壳Agent 负责脑。Pinvou 负责进程托管、ACP transport、session/workspace 绑定、事件持久化、权限交互与 UIAgent 自己负责system prompt、模型、工具循环、skills、MCP、登录态与自身配置。前端只消费 Agent 在initialize、session/new、session/load中实际上报的 capability、model、mode 和配置项不按 Agent 名称猜能力。三个 ACP Agent 共用同一条acp-timeline.jsonl时间线和工作区安全边界不复制三套界面逻辑。这意味着新 Agent 只要支持 ACP就能以几乎零成本接入同一个工作台。会话事件在前端被投影为结构化时间线思考、命令执行、文件变更、权限、计划、Agent 消息原始 ACP JSON 不会进入普通会话界面。投影逻辑见 acp-state.jsACP 会话的完整实现集中在 features/codex/ 目录。权限确认与会话恢复新手最关心的两个问题权限模式如何工作权限模式以 ACPconfig_options.mode为主只有 Agent 未上报该配置时才回退到session/set_mode。你确认过的权限模式、模型、推理强度等配置会按 Agent 持久化新建该 Agent 会话时自动重新应用历史会话仍使用自己的 session 配置不会被新会话的默认值覆盖。配置应用期间和回合运行期间会暂停另一项配置修改避免状态冲突。重启后不会卡在处理中应用被直接关闭时旧进程里的 Prompt 无法挂回新进程。Pinvou 的启动恢复会把时间线中只有turn_started没有turn_completed的遗留回合收口为Interrupted对应运行中的工具、权限和输入项显示为已取消。恢复后的会话保留原历史和工作目录可继续发送新消息——这是桌面端长任务场景下非常实用的容错设计。Provider 管理为编码智能体配置第三方中转三个 ACP Agent 都支持在设置 →「Provider 管理」中配置第三方中转预设/自定义 base URL、wire 协议Anthropic 兼容 / OpenAI 兼容、模型与 API key也可以一键恢复官方登录。几点新手须知 API key 只存系统凭据库keyringJSON、日志和仓库中都没有明文⚠️ 切换 Provider 是本机级操作会影响所有使用该 CLI 的入口终端、IDE 插件不只是 Pinvou 代码模式每次受管写入前原配置会备份为*.pinvou3-bak配置文件不可解析时拒绝覆盖并明确报错会话级解析优先级会话选项 全局当前 Provider 官方登录。源码与文档索引想深入可以看的模块路径使用、验证与发布含数据位置与 Provider 管理docs/codex-acp.md多 Agent 架构单一真相源CLI 探测、安装矩阵、架构边界docs/multi-agent-acp.md品悟原生代码会话的设计决策docs/code-native-agent.md前端 ACP 时间线投影与会话操作pinvou3-app/src/features/codex/后端 ACP 运行时与安装升级pinvou3-app/src-tauri/src/features/codex_acp/会话数据统一存放在~/.pinvou3/sessions/id/下acp-state.json、acp-timeline.jsonl等项目目录本身零污染——时间线、状态和会话文件都不会写进你的仓库。总结Pinvou Agent 的代码模式证明了一件事多编码智能体不需要多套入口。通过 ACP 这一层统一协议Codex、Claude Code 与 Kimi 以完全一致的心智模型运行在同一工作台统一的会话列表、一致的权限交互、可靠的崩溃恢复再加上免 Node 依赖的内置 Bridge 与一键安装升级让新手也能在几分钟内把最合适的编码智能体接入真实项目。如果你希望从源码运行克隆仓库后按文档执行./pinvou3-app/scripts/prepare-codex-bridge-runtime.sh准备 Bridge再运行./pinvou3-app/run-dev.sh启动即可git clone https://gitcode.com/gh_mirrors/pi/pinvou-agent cd pinvou-agent/pinvou3-app ./scripts/prepare-codex-bridge-runtime.sh ./run-dev.sh【免费下载链接】pinvou-agentOpen-source desktop AI agent for tools, files, knowledge, workflows, and real deliverables.项目地址: https://gitcode.com/gh_mirrors/pi/pinvou-agent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考