$ cat ~/map/aft.md

aft

为 Pi 与 OpenCode 提供薄适配器的感知运动皮层，替代原始的读写与 bash 调用。

tools✓ 10月16日

事实速查

仓库: github.com/cortexkit/aft ↗
GitHub Stars: ★ 324
Forks: 39
许可证: MIT
npm / 月: —
最后推送: 2026年10月16日

安装

npx @cortexkit/aft@latest setup

## 速览

编码代理的感知运动皮层：一个 Rust 二进制加薄适配器——在 pi 里把内置的 read、write、edit、grep 换成基于 tree-sitter 的符号级实现，并在其上追加 aft_ 工具族。

## 要点

$对 pi，setup 会把内置的 read、write、edit、grep 替换为 AFT 支撑的版本并注册 aft_ 工具族——agent 调用的工具名不变，底层已换成 tree-sitter 解析、索引检索、输出压缩与符号级操作。
$感知层工具：aft_outline 列出文件、目录或远程 URL 中的全部符号；aft_zoom 检视单个符号（callgraph: true 附带调用关系）；aft_search 做语义与词法混合检索，支持本地、OpenAI 兼容或 Ollama 嵌入后端；aft_inspect 汇报 LSP 错误、TODO、指标、死代码、未用导出与重复代码。
$动作层工具：edit 支持模糊查找替换与按符号名替换，可批量、可跨文件事务；write 自动建目录、带备份与格式化；apply_patch 提供多文件原子回滚；aft_refactor 做工作区级符号移动、函数提取与内联；aft_import 按语言管理导入；ast_grep_search/ast_grep_replace 做结构化匹配替换。
$脑干层：bash 带逐命令输出压缩；后台任务跨重启存活（bash_status、bash_kill、bash_watch）；PTY 会话可驱动 REPL 与终端应用；aft_safety 提供逐文件撤销栈与命名检查点，跨桥接与宿主重启持久。
$npx @cortexkit/aft@latest setup 自动探测已安装的 harness 并逐个配置，--harness pi 可指定 pi；运行时每个项目根共享一个常驻 aft 进程，经 stdio 上的 JSON 协议通信，数据存于 ~/.local/share/cortexkit/aft/。
$通过用户级或项目级 aft.jsonc 配置；npx @cortexkit/aft@latest doctor 打印近七天使用情况与卸载后会残留什么；pi remove npm:@cortexkit/aft-pi 可从 pi 注销。

## 常见问题

Q 它到底怎么改 pi 的工具？

pi 适配器会接管宿主的工具槽——agent 照旧调用 read、write、edit、grep，但底层换成 tree-sitter 解析、trigram 索引检索、输出压缩与符号级操作，aft_ 工具族叠加注册在其上。

Q 怎么从 pi 卸载？

运行 pi remove npm:@cortexkit/aft-pi（别名 pi uninstall），它会从 ~/.pi/agent/settings.json 的包列表中移除 AFT；再按 docs/config.md 的卸载路径说明删除配置文件与数据目录。

## 参考链接

## 相关条目

最后更新: 2026年8月31日