DrEden33773/eden-agent

eden-agent

一个由可替换原生插件构建的 Rust 编码代理。

此开发版本通过原生循环、上下文、提供程序、工具和历史记录角色执行编码任务。默认组合提供模型目录、私有 API 密钥管理、OpenAI Responses、Chat Completions、Anthropic Messages 和云模型协议，以及读/写/编辑/bash 和本地 JSONL 历史记录。通过模型和 API 密钥配置模型访问和凭据；原生角色可独立替换，无需重新构建宿主。

构建和运行

通过 rustup 安装 Rust，并安装 Python 3。仓库选择 Rust 1.98.1；Python 仅用于安装组装和验证。

cargo build --workspace --locked
python3 scripts/install.py artifacts/install
artifacts/install/bin/eden --cwd /path/to/project --session /path/to/task.jsonl --print 'Inspect the project and run its tests.'
artifacts/install/bin/eden --history /path/to/task.jsonl

在 Windows 上使用 python 和 artifacts/install/bin/eden.exe。在 OPENAI_MODEL 中设置确切的模型，并在 OPENAI_API_KEY 中设置 bearer 凭据，或者复制 .env.example 以用于 DeepSeek，并通过 --env-file PATH 显式加载它；有关配置、附件、恢复、队列和工具行为，请参阅编码会话。你可以从另一个工作目录调用已安装的可执行文件：其默认组合相对于可执行文件解析。使用 --composition PATH 显式选择另一个本地组合。

安装目录包含 bin/eden、composition.json、plugins/ 下的带版本原生包以及许可证声明。将该目录作为一个整体移动或归档。没有全局安装步骤，也不会在启动时隐式下载。

普通 JSON 结果使用两个空格缩进和末尾换行，包括通过管道或重定向时。终端 stdout 自动使用语法颜色；--color never 禁用颜色但不会移除缩进，--color always 强制使用颜色。自动颜色遵循 NO_COLOR 和 TERM=dumb，其中 CLICOLOR_FORCE 优先。使用 --json 获得无颜色的紧凑机器输出，即使与 --color always 一起使用也是如此；run 和 router 事件仍保持 JSONL。历史检查、--history 和会话树记录始终保持无颜色的 JSONL。使用 --apply 的会话复制操作会打印计划，随后将执行结果打印为两个 JSON 文档（使用 --json 时各占一行）。历史导出文件保留其存储格式。
使用 eden help、eden help models 或 eden help models select 可以在不加载插件的情况下探索命令。-h 和 --help 在每个命令层级仍然可用。仅使用 cargo run --bin eden 构建 CLI 并不会组装安装：其默认组合将是 target/composition.json。完成上述构建和安装步骤后，你还可以运行 cargo run --locked --bin eden -- --composition artifacts/install/composition.json models list。显式组合路径和历史路径相对于调用进程目录，与 --cwd 无关。

Rust 嵌入

cargo run -p eden-agent --example embedded -- artifacts/install/composition.json

embedded 示例使用与 CLI 相同的 Session::open、submit、wait 和 shutdown API。被接受的提交具有运行标识；即使等待的接收者被丢弃，最终结果也会保留以供 inspect 使用。events_after 读取有序的内存事件。在丢弃 Tokio 运行时之前，请等待 shutdown。

原生插件作者

阅读作者指南和原生契约。公共 SDK 是 crates/eden-plugin-sdk；它重新导出协议类型。Loop A 和 Context B 是独立构建的作者示例。第一方角色使用相同的 SDK 和加载器。

验证器首先构建并修复已安装的宿主，仅将 SDK/协议复制到单独的作者树中，然后构建并安装外部库。它从不同的工作目录测试默认和混合角色组合，并比较之前和之后的宿主字节。

pnpm markdown:check
pnpm rust:check
pnpm clippy:check
cargo test --workspace --locked
pnpm rust:test:authors
python3 scripts/verify.py
python3 scripts/verify-coding.py

原生 CI 矩阵在 Linux x86_64、Windows x86_64 以及实际的 macOS 运行器架构上运行这些检查。行为因操作系统而异的测试目标——进程所有权、链接创建、路径作用域和历史锁定——在三个平台上都运行；其余工作区测试在 Linux 上运行，而 Clippy 和验收套件仍在每个运行器上编译并加载每个插件。其产物包含安装归档以及机器可读的编码/原生验证结果，其中包含测试目标和提交。这些检查涵盖原生加载和生命周期，而非交互式终端行为。

贡献与许可证

安装 Node.js 22+ 和 pnpm 10.32.1 以进行开发检查，然后运行 pnpm install --frozen-lockfile 和 pnpm hooks:install。每个克隆都会配置自己的钩子。Node/pnpm 是开发依赖；构建后的应用程序仍然是 Rust 可执行文件。有关分阶段快照检查、独立作者覆盖和显式修复命令，请参阅开发检查。
变更通过带有独立审查和通过的 Quality 检查的 PR 进入 main，使用 squash merge。开发命令参见 AGENTS.md。

产品代码和 SDK：Apache-2.0。依赖项保留其第三方声明。

有关 Skills、模板、FFF 搜索、包命令和独立服务贡献，参见资源、信任与包组成。

有关目录刷新、私有凭据、模型选择和跨协议延续，参见模型与 API 密钥。

账户登录、设备授权、私有回调输入和令牌刷新可通过 CLI 和 SDK 使用；参见账户认证和模型路由。

本地模型发现、搜索、服务端下载、加载/卸载和取消使用可替换的 ModelManager 角色；参见 llama.cpp 路由器。

Rust 使用者可以使用嵌入 API；子进程客户端使用 stdio RPC 协议。

有关读取快照和交付服务，参见导出、显式共享与启动维护，有关完整安装事务，参见更新。

呈现契约通过显式的本地共享主机，为最小化的 Ratatui 和 React/Spectrum 适配器提供一个语义化 Rust 插件视图，并支持对已保存语义视图的无插件只读访问。