English | 简体中文

Psychevo

Psychevo 是一款面向现有代码库的本地编码智能体。配置提供方后，可以从终端、本地 Workbench 或支持的 ACP 编辑器完成任务。配置、权限策略和会话历史都保留在本机，可随时检查。

你可以用它做什么

• 按自己的方式工作：使用 pevo run 运行一次性任务，使用全屏终端 UI，打开本地 Workbench，从源码检出目录启动 Desktop，或连接支持的 ACP 编辑器。
• 选择提供方、模型和智能体：配置兼容 OpenAI 的提供方，在可用时使用本地智能体，或在 Workbench 中选择托管的 Codex、OpenCode 和 Hermes ACP 后端。
• 扩展和委派工作流：组合基于文件系统的技能、插件、钩子、MCP 工具、本地智能体和子智能体流程。
• 在聊天界面中工作：需要时，可通过管理式 Gateway 连接已获授权的 WeChat、Telegram、Feishu 和 Lark 会话。

Psychevo 当前聚焦可靠的本地执行，不宣称已经具备自治评估循环、工作流挖掘或长期记忆能力。

从源码安装

Psychevo 当前通过源码安装。先安装 Git、Rust/Cargo、本机编译器、Node.js 和 pnpm，再运行检出目录中的安装器：

git clone https://github.com/wowfun/psychevo.git
cd psychevo
sh scripts/install.sh --check
sh scripts/install.sh

安装器会构建本地 pevo 二进制文件和 Workbench Web UI 资源。有关前置条件、诊断、Windows Git Bash 说明、企业网络指导和开发命令，请参阅安装指南（英文）。

如仅需命令行安装，可使用底层 Cargo 命令：

cargo install --locked --path crates/psychevo-cli --force

如需直接开发而不安装：

cargo run -p psychevo-cli -- --help
pnpm --filter @psychevo/workbench dev

快速开始

先为提供方和模型完成一次 Psychevo 设置：

pevo setup

向导会初始化 Psychevo 主目录、配置提供方和模型、保存或引用 API 密钥、检查 Web UI 资源，并以 doctor 摘要结束。在不联系提供方的情况下确认本地设置：

pevo doctor

在需要处理的项目目录中运行第一个任务：

pevo run "summarize this repository"

需要交互式工作区时：

pevo tui
pevo web

如需编辑器集成，请配置 ACP 客户端启动 pevo acp。详见ACP 配置指南（英文）。

为单次调用选择提供方和模型：

pevo run -m deepseek/deepseek-chat "inspect the CLI entrypoints"

文档

• Rust 与 Python SDK 指南（英文）
• 安装指南（英文）
• ACP 配置指南（英文）
• Channels 指南（英文）
• TUI 故障排除（英文）
• 贡献指南（英文）

Rust 与 Python SDK

psychevo Rust crate 在进程内运行 Framework。一个 Application 负责
Thread 与 Turn 状态、已接受任务、控制、交互和有序关闭：

use psychevo::{Application, StartThreadRequest, TurnRequest};

let application = Application::builder()
    .home("/tmp/psychevo-sdk")
    .build()
    .await?;
let client = application.client();
let thread = client
    .start_thread(StartThreadRequest::new("."))
    .await?;
let turn = thread
    .start_turn(TurnRequest::new("Inspect this repository"))
    .await?;
let result = turn.wait().await?;
application.shutdown().await?;

异步 Python SDK 默认通过标准输入输出启动版本完全一致的 App Server：

from pathlib import Path

import psychevo


async with psychevo.Client() as client:
    thread = await client.start_thread(cwd=Path.cwd())
    turn = await thread.start_turn("Inspect this repository")
    result = await turn.wait()
    print(result.final_answer)

Python 客户端也支持显式指定 App Server 可执行文件，或连接带身份验证的
WebSocket 地址。它不会搜索 PATH、下载二进制文件或探测守护进程。生命周期、
事件、控制、回调、传输配置和包结构详见 SDK 指南（英文）。

更多使用方式

命令

运行 pevo <command> --help 查看参数和子命令。

开发

修改项目前，请阅读AGENTS.md。Psychevo 使用 spec-first 原则：在更改行为、公开文档、测试或开发流程之前，先阅读并更新最贴切的 specs/<topic>/spec.md。

Rust 工作区的广泛验证：

cargo xtask ci run --profile rust-broad

当更窄范围的验证能够覆盖改动行为时，应优先使用它。实际提供方、API 密钥和实时服务验证均需显式选择。

仓库本地的 live 验证由 xtask 管理：

cargo xtask init dev-env
cargo xtask live run
cargo xtask live run --env isolated
cargo xtask live run --suite provider

常用本地命令：

cargo run -p psychevo-cli -- --help
cargo test -p psychevo-cli smoke_cli
pnpm --filter @psychevo/workbench build
pnpm --filter @psychevo/workbench dev

工作区（贡献者）

许可证

Psychevo 使用 MIT License 授权。