面向任意垂类 Agent 的 Harness Checkpoint 开源 substrate。
围绕每一组模型 × 任务构建、评估并治理对应的 harness。
English · 简体中文
完整文档 · 安装 · 快速开始 · 为什么选择 Iteron · 架构 · 参与贡献
> [!WARNING] > **项目仍处于预发布阶段;普通新会话默认拥有危险的宽泛主机权限。** > 文件写入路径仍存在未解决的符号链接竞态,不应在敏感或不可信仓库中无人值守运行。 > 可用 `--ask-permissions`、显式受限的 `--mode` 或 `--confine` 收紧权限; > `--mode plan` 只读。Windows 没有代码执行沙箱,受限执行会拒绝命令。 Iteron 是用于构建、评估和治理**任意垂类 AI Agent Harness Checkpoint** 的开源 substrate。它提供覆盖上下文、工具、策略、权限、证据与 checkpoint 生命周期的 模块化 Rust 运行时契约。终端编码智能体是第一个参考实现,支持交互式工作、有界 自动化、提供商路由、持久会话、验证和机器可读输出。当前工作区目标版本为 **v0.0.30**;最新公开版本及可下载产物以 [GitHub Releases](https://github.com/Plantcore-AI/Iteron/releases/latest) 为准。 ## 安装 macOS 与 Linux: ```sh curl --proto '=https' --tlsv1.2 -LsSf https://github.com/Plantcore-AI/Iteron/releases/latest/download/install.sh | sh ``` Windows PowerShell: ```powershell [Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12; Invoke-RestMethod -Uri 'https://github.com/Plantcore-AI/Iteron/releases/latest/download/install.ps1' | Invoke-Expression ``` 发行包覆盖 macOS arm64、Linux arm64、Linux x86-64 与 Windows x86-64。 安装器会校验所选归档,并以当前用户身份安装,无需提权。Windows 获得 分发包并不改变其没有代码执行沙箱的边界。版本固定、校验和、证明材料和源码构建 说明见[安装与验证指南](docs/getting-started/installation.md)。 无需提供商凭据即可检查 shell 是否解析到正确命令: ```sh command -v iteron iteron --version ``` ## 快速开始 先验证并把提供商凭据保存到仓库之外: ```sh iteron setup --byok glm ``` 打开一个仓库并启动全屏界面: ```sh cd /path/to/repository iteron ``` 进入 TUI 后直接描述期望结果。使用 `/model` 选择账号可见的模型,使用 `/permissions` 检查权限,使用 `/help` 查看命令列表。 进行有界单次工作: ```sh iteron -p -C /path/to/repository \ --max-turns 24 \ --verify 'cargo test --workspace --all-targets --locked' \ "修复失败的测试,验证改动,并总结证据" ``` 处理不受信任的仓库时,使用只读模式或先人工检查: ```sh iteron -p -C /path/to/untrusted-repository --mode plan \ "解释这个仓库的构建脚本会执行什么" ``` 继续阅读[五分钟快速开始](docs/getting-started/quickstart.md)、 [设置与 BYOK](docs/getting-started/setup-and-byok.md)和 [权限与沙箱指南](docs/using/permissions-and-sandbox.md)。 ## 为什么选择 Iteron | 原则 | 契约 | | --- | --- | | **垂类 Agent substrate** | 共享运行时契约允许每个领域定义自己的模型与任务画像、harness 策略、证据和 checkpoint。 | | **终端原生** | 全屏 TUI,以及用于自动化的 text、JSON 与 stream-JSON 接口。 | | **有界运行时** | 明确限制轮次、时间、成本、重试、队列、输出与并发。 | | **权限分离** | 策略可以提出工作,但不能授予能力、放宽硬预算或改写证据。 | | **持久证据** | 哈希链会话、checkpoint、关联工具事件与基于提供商事实的用量状态。 | | **提供商事实** | 按凭据可见范围发现能力,并明确区分 available、disabled 与 unknown。 | | **模型—任务适配** | Harness 选择针对模型与任务画像评估,而不是把全局默认当作普适最优。 | | **模块化所有权** | 机器校验的 Rust 边界、可问责的人类维护者和受保护的评审路径。 | ### Harness checkpoints Iteron 的核心设计命题是:Agent 行为来自冻结模型、任务与外围 harness 的共同 作用。 ```text agent behavior = frozen model × task × harness ``` **Harness checkpoint** 是一组类型化、可版本化的上下文、prompt、工具、规划、 预算、验证与恢复策略,适用于有测量证据支持的模型—任务区域。质量、成本、延迟与 可靠性保持为独立结果;权限、证据完整性和硬资源上限始终是固定约束。 这个命题指导 Iteron 的架构,但不会让日常产品体验变成实验系统:用户安装一个 CLI、选择提供商、在终端中工作,并获得有界执行与持久证据。完整搜索空间、敏感度 模型、适用规则和当前实现边界见 [Harness checkpoints 中文版](docs/concepts/harness-checkpoints.zh-CN.md)。 ## 架构 Iteron 把权限冻结在 host 中,让类型化 harness policy 只能提出有界工作。离线 candidate 经过独立评估、人工晋升和内容固定的注册表后,resolver 才能把它装入 运行时 slot。
|
Jamal Cao@fr0m-scratch · Creator and Project Lead负责 Iteron 的项目方向,并依据公开治理契约持有最终的人类决策权。 |
![]() @gomnitrix |
![]() @XZhouuuu |
![]() @yadonkai |