爱特工作室自主开发的长程自主开发跨平台 Agent。
构建出的二进制叫 ita。设计原则是克制的内核与自由的用户态分离:内核只做纯逻辑,
一切 IO、进程、沙箱与模型调用都在内核之外。这条分离不是风格偏好,而是被编译器与进程边界
共同强制的架构约束,因此系统的每个部分都可以独立替换、独立测试、独立崩溃。
当前状态:架构决策已定(见 docs/adr/)。十一个 crate 与单二进制 ita
的角色分发已经落地,CI 覆盖格式、静态检查、测试与 MSRV 四类门;内核的受限 bash 文法、
上下文树与纯函数解析已经完成,语义压缩只完成了纯逻辑的计划部分,模型调用与折叠编排尚未
接入;存储层完成了数据库打开、迁移、工作区作用域与核心表结构,事件与快照写入尚未开工;
协议、server、worker、执行器、沙箱、工具安装、模型适配与工作流仍是空壳。当前没有端到端
的工具调用路径,ita 只按角色启动占位。版本以 Cargo.toml 为准,进度以
.w1mer/ROADMAP.md 为准。
长程自主开发里最实际的三个障碍,分别对应三组设计:
上下文会爆,注意力会衰减。 待办做完之后,过程中的试错细节不再需要占据预算,但成果 必须保留。因此提供一层上下文回退:回到开启待办的位置,注入一条摘要,文件完全不动。 上下文与文件是两条独立的时间轴,可以自由组合。
试错改坏了工作区。 每次有改动的工具调用之后自动留一份文件快照(超过大小阈值的文件只 记录元数据、不回滚内容)。用户和 agent 共用同 一个回滚工具,因此 agent 可以在试错之后自己退回,不需要人来收拾。
多个工作区并发时互相污染。 一个 server 管全局路由、数据库与凭据,每个工作区一个 worker 进程加一个执行器。worker 无状态、无数据库连接、无密钥、默认无网络——崩溃即重建。
┌─────────────────────────────┐
ita (CLI/TUI) ────►│ server │
│ · 唯一数据库写者(SQLite) │
│ · 模型代理(凭据只在这里) │
│ · unit 监督(依赖拓扑) │
└──────────┬──────────────────┘
│ 本地 IPC
┌──────────▼──────────────────┐
│ worker(每工作区一个) │
│ · 无状态、无数据库、无密钥 │
└──────────┬──────────────────┘
│
┌──────────▼──────────────────┐
│ 执行器(每工作区一个) │
│ · 权限预检 · 租约 · 快照 │
└──────────┬──────────────────┘
│
┌──────────▼──────────────────┐
│ 沙箱 → 工具模板 → 二进制 │
└─────────────────────────────┘
代码分层:ita-kernel 只放纯逻辑(消息树与解析、命令文法、租约与权限谓词、检查点
类型),不得依赖任何带 IO 或时钟的 crate。存储、协议、沙箱、执行器、模型适配、工作流都在
内核之外。CI 会用依赖检查守住这条线,因为靠约定守不住。
工具调用是命令行,不是结构化参数。 模型只看到一条 command 字符串,文法是受限的
bash:参数、管道、重定向、heredoc(版本一限制为单命令加单个 heredoc,不与管道共存)。
因此命令可以直接粘贴到真实终端里复现,权限也能对整条
管道做执行前预检。heredoc 属于词法层而不是编辑工具,因为"给命令提供标准输入"是通用能力。
只用原生工具调用。 不做正文标签解析,也不做正文 JSON。工具定义只有一项且永久静态, 新增工具靠追加目录事件,这样供应商的前缀缓存不会失效。检索结果进消息而不进工具定义, 原因相同。
工具是"清单 + 模板 + 二进制"。 清单声明权限(文件范围、网络意图等),模板是固定的 回调 ABI,负责把请求交回执行器、拿到租约后再执行真正的二进制。首次安装需要人工批准, 批准绑定内容哈希;升级只批准新增的权限。
回滚保证的边界是明确的。 只保证工作区内、被工具声明范围内修改过的文件。构建产物、 工作区外的写入、网络副作用不在保证范围内,回滚结束后会打印"可能残留"清单。宁可说清 边界,也不让"回滚"这个词承担它做不到的承诺。
成本纪律。 不做付费评测。只做本地零成本测量(文法吞吐、解析耗时、数据库单写吞吐、 进程间往返、快照耗时、冷启动分解),加上供应商免费回传的用量字段。
| 位置 | 内容 |
|---|---|
docs/adr/ |
架构决策记录:决定了什么、为什么、否决了什么、代价是什么 |
AGENTS.md |
开发约束:架构不变量、提交与版本规范、验证纪律 |
.w1mer/ROADMAP.md |
史诗与二级任务路线图(段落顺序即优先级) |
.w1mer/codebase/ |
分层代码库文档,新加入者从 STACK 读起 |
.w1mer/COMMENT_GUIDELINES.md |
注释规范 |
.w1mer/DOC_GUIDELINES.md |
开发文档与 ADR 写作规范 |
建议阅读顺序:本文件 → docs/adr/0001 → 0002 → 0003,这三份决定了系统骨架。
git clone <repo> && cd ITAgent
.w1mer/scripts/install_hooks.sh # 装提交信息校验与提交前格式化钩子
cargo build --workspace # 十一个 crate 一次构建
cargo nextest run --workspace # 跑测试(nextest 需自行安装)
w1mer list # 看当前该做什么(w1mer 由 w1mer skill 安装到 PATH)日常验证统一入口:bash .w1mer/scripts/verify.sh all。它依次跑格式、静态检查与测试,
CI 的四个 job 调用同一脚本;MSRV 由单独的 verify.sh msrv 用 1.85.0 工具链检查。
开发由 W1MER 协议推进(三并调度:reviewer、implementer、explorer),规划目录
.w1mer/ 随仓库提交,是跨批次的事实来源。
MIT,见 LICENSE。