AFT

这个 Agent 能做什么，适合哪些场景？

AFT 是 CortexKit 家族中的「感觉运动皮层」，用 Rust 编写的共享内核加上按 harness 分发的薄适配层，为编码 Agent 提供结构化的代码感知与精确的代码改写能力。它的核心是一个 JSON-over-stdio 协议的 Rust 二进制，按项目根各常驻一个进程、跨会话共享，内部集成 tree-sitter 解析（覆盖约 27 种语言）、符号与调用图、trigram 索引、语义索引和 LSP 客户端。适配层目前覆盖 OpenCode（@cortexkit/aft-opencode）、Pi（@cortexkit/aft-pi），OMP 通过 Pi 插件支持；它们会「接管」宿主的 read、write、edit、bash、grep 等内置工具槽，并额外注册 aft_ 系列工具。安装入口是 npx @cortexkit/aft@latest setup，它会自动检测已装 harness 并写入配置，二进制按缓存、npm 平台包、PATH、cargo install、GitHub release 的顺序解析。数据（备份、索引、下载的 LSP 服务）存放在 ~/.local/share/cortexkit/aft/ 下，采用 MIT 许可。

感知侧：aft_outline 输出文件、目录或远程 URL 中所有符号的类别、名称、行范围与可见性；aft_zoom 深入单个函数或类，可加 callgraph: true 标注被调用者与调用者；aft_search 在索引上做语义+词法混合检索，支持本地、OpenAI 兼容与 Ollama 嵌入后端；aft_callgraph 追踪调用者、被调用者、数据流与最短调用路径；aft_inspect 一次返回 LSP 错误告警、TODO、指标、死代码、未用导出与重复代码。动作侧：edit 支持模糊匹配查找替换、按符号名替换、批量与多文件事务、glob 替换；write 自动建目录并备份、格式化、附内联诊断；apply_patch 支持多文件补丁与原子回滚；aft_import 做语言感知的 import 增删与整理；ast_grep_search / ast_grep_replace 用 AST 模式与元变量做结构化查找替换。常驻侧：bash 统一执行并按命令重写（cat→read、grep→grep 工具）、压缩输出；background: true 派生后台任务，配合 bash_status、bash_kill、bash_watch 管理；PTY 提供可交互终端，用 bash_write 输入、bash_status 查看渲染屏幕；aft_safety 提供按文件撤销栈、命名检查点与恢复。grep/glob 由后台构建、落盘并由文件监视保持新鲜，索引遵循 .gitignore 与可选 .aftignore。

1. 已经在用 OpenCode 或 Pi 写代码、但 Agent 常因整文件读取浪费 token 的开发者，希望用 aft_outline / aft_zoom 只取结构信息。
2. 需要跨文件重命名、提取函数或整理 import 的前端/TypeScript 团队，用 edit 的符号替换与 aft_import 代替脆弱的按行编辑。
3. 接手陌生大型仓库的工程师，用 aft_callgraph 与 aft_inspect 快速定位调用链、死代码与重复实现。
4. 经常让 Agent 跑测试、装依赖、看 docker ps 的人，用输出压缩与 background/bash_watch 避免海量日志淹没上下文。
5. 需要在 Agent 会话里操作 REPL、vim 或嵌套终端的用户，用 PTY（bash_write / bash_status）驱动交互式程序。
6. 担心 Agent 改坏代码的团队，用 aft_safety 的按文件撤销栈与命名检查点在出错后回滚。

如何安装或部署这个 Agent？

前置条件：已安装 Node.js（用于 npx）与目标 harness（OpenCode 或 Pi；OMP 走 Pi 插件）。执行统一安装命令：

npx @cortexkit/aft@latest setup

可指定单一 harness：

npx @cortexkit/aft@latest setup --harness opencode
npx @cortexkit/aft@latest setup --harness pi
npx @cortexkit/aft@latest setup --harness omp

从源码构建（开发用）需要 Bun ≥ 1.0 与 Rust stable 1.92+：

bun install
cargo build --release
bun run build

如何使用这个 Agent？

安装后下次会话启动时，aft 二进制会按需下载并让全部工具上线。用户或项目级配置写在 aft.jsonc：

// ~/.config/cortexkit/aft.jsonc 或 <project>/.cortexkit/aft.jsonc
{
  "enabled": true,
  "inspect": {
    "duplicates": {
      "expected_mirrors": [["packages/opencode-plugin/**", "packages/pi-plugin/**"]]
    }
  }
}

诊断与缓存管理：

npx @cortexkit/aft@latest doctor
npx @cortexkit/aft@latest doctor --fix
npx @cortexkit/aft@latest doctor lsp

卸载时先从宿主配置移除注册：OpenCode 编辑 ~/.config/opencode/opencode.jsonc 中顶层 "plugin" 数组里的 @cortexkit/aft-opencode 条目；Pi 执行：

pi remove npm:@cortexkit/aft-pi

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

1. grammars-1 Grammar artifacts 预发布 2026-11-01
   发布说明摘录

   Immutable content-addressed grammar assets.

   在 GitHub 查看 ↗
2. v0.63.5 2026-11-01
   发布说明摘录

   v0.63.5 AFT 0.63.5 fixes two problems introduced in 0.63.4. It has no other changes. Fixed - AFT starts again inside a Linux sandbox that does not let it read the disk root, such as nono with Landlock. 0.63.4 stopped at startup there ([#1245](https://github.com/cortexkit/aft/issues/1245)). - aft_inspect on two or more files outside the project no longer fails with "refused again after it was approved" after the first approval in OpenCode 2 daemon mode ([#1258](https://github.com/cortexkit/aft/issues/1258); thanks @iceteaSA).

   在 GitHub 查看 ↗
3. v0.63.4 2026-10-30
   发布说明摘录

   v0.63.4 AFT 0.63.4 replaces 0.63.0 through 0.63.3, which were not published because their release builds failed. It adds shell memory limits, changed-file reports and a separate cache location. Diagnostics, call graphs, command recovery and permissions are fixed, with lower resource use. Upgrading - Outdated call graphs and symbol caches rebuild on use; call-graph caches take about three quarters less disk space. …

   在 GitHub 查看 ↗

常见问题