分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

Agent-Field/CodeAF

开发工具

把开放模型的编码智能体变成多项目软件工厂的终端工具。

596
72
Go
Apache-2.0
创建于 2 个月前

CodeAF 是一个面向开放模型(DeepSeek、Qwen、GLM、Kimi、MiniMax、Ollama 或任何 OpenAI 兼容端点)的编码 harness。它解决的问题不是单个仓库里一个智能体写代码,而是同时有多件事在进行时,把调度、检查与合并也交给工具:用一个窗口管理机器上的所有项目,把请求拆成在独立仓库副本和分支上运行的任务,验证通过的改动才会合并。维护者将其标注为早期预览版。

工作如何流转

你用日常对话描述问题,比如某个重试测试在 CI 上五次失败一次、定价页在手机上从单词中间换行、部署密钥周五过期。每条都可以独立成任务,在自己的分支上运行。通过既有检查的改动会自动落到你的分支,绝不会进入 main、dev 或发布分支;无法验证的改动则等待 1 接受或 2 不对。只有真正阻塞的问题才会出现在 needs you 下。

三个内置专家以任务形式运行:/senior-dev 做代码修改并返回构建和测试结果,/sec 做本地安全审计(Markdown、JSON、SARIF 报告),/review 审查 GitHub pull request。senior-dev 在 macOS 和 Linux 上无需额外安装。README 说明 review 和 sec 只读取源码,不运行测试、构建、应用或漏洞利用,也不改动代码;报告需要查看覆盖范围和未完成的分析,没有发现并不能保证不存在安全问题。DeepSWE 基准只衡量 senior-dev;review 专家引自 PR-AF 的基准结果是原项目的结果,并非 CodeAF 导入版本的测量。

模型、自动化与无头模式

任务默认使用由 worker、planner、checker 三个席位组成的自动 crew,从已连接的服务商中挑选,单任务花费上限默认为 $5,可设置可选的每日上限。/crew 可以固定某个席位,或把所有席位限制在开放权重模型上。提醒、定时任务和监视只在 CodeAF 运行时执行;关闭期间错过的任务会在下次打开时补跑一次。

面向 CI、cron 和脚本,codeaf do "..." --json 接收你的简短说明,完成规划、执行和检查,然后输出一个 JSON 对象和退出码;遇到原本要问你的问题,它会采用最佳答案并记录假设。相关命令还有 exec(单个 worker,不做规划)和 run(执行你编辑过的计划),无头契约有单独文档。

远程使用与要求

codeaf chat --host devbox 让对话运行在拥有工作的机器上,界面在本地,复用你自己的 ssh 配置;那台机器上只需要有 CodeAF。关掉界面不会停止工作,连接断开后会重拨五分钟。手机可以通过移动终端 ssh 加入同一个对话,README 称不需要安装应用。通过中继和配对码连接没有 ssh 的机器已经实现,但要等托管中继上线后才会启用。

安装方式是一个 Go 二进制,支持 macOS、Linux 和 Windows,安装脚本会把它放进 ~/.codeaf/bin,也可以从源码构建。首次启动会在浏览器中连接 OpenRouter 或接受密钥;Codex 使用 ChatGPT 计划登录,多个服务商需要密钥,Ollama 则不需要。

隐私与状态

匿名使用计数默认开启:版本、操作系统、模式、会话数、错误和总 token 数,以随机安装 id 发送,明确不包含提示词、代码、路径和模型名。Model Pool 也默认开启,发送关于模型的无数值文本的纯数字测量;可以通过设置、CODEAF_MODEL_POOL=off 或 CODEAF_TELEMETRY=off 关闭。遥测披露文档提到有一个测试会确保文档与代码一致。

项目采用 Apache-2.0 许可,维护者称其为带粗糙边缘的早期预览版;仓库列表显示 596 个 star。

项目源码与说明

本文由 AI 根据项目 README 生成,更新于 2026年10月30日,以项目官方文档为准。