返回资讯中心
外部精选
软件工程
#开发者实时流

VB Harness 让本地编程代理自行验证代码,确保项目检查通过

来源标题:VB Harness – Make local coding agents verify their own work

VB Harness 是一个让本地小模型自主完成真实编程任务的工具,模型编写的代码必须通过项目自身的类型检查、lint、构建和测试才算有效。它在 6GB 笔记本 GPU 上无人值守运行 3 小时 28 分钟完成了一项评估任务。该工具支持 AstroJS 技术栈及任何 OpenAI 兼容端点,如 LM Studio、Ollama 和 vLLM。

Hacker News 最新vova2k2026/11/18 · 今天30 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

你笔记本上的小模型能开发真实功能,但它写出的任何东西,只有通过你项目自身的检查才算数。

一个由 6 GB 笔记本 GPU 上的本地模型在无人值守的单次运行中构建的四部分博客功能。一段真实运行的动画演示(并非屏幕录制):计划、代码、数字、审查意见和页面都来自评估任务 10 的一次真实 agent 模式运行,耗时 3 小时 28 分钟。引导说明展示了该功能,但不属于那次运行的一部分;页面展示所用的布局带有为视频制作的封面图;运行本身的文件未作改动。点击观看 1080p、60 fps 视频。

在你自己的机器上让模型完成真实的编码工作。该 harness 把功能规划为若干小任务,让你的本地模型逐一实现,用你项目自身的类型检查、lint、构建和测试来验证每一处改动,并通过证据门禁重新审查它构建出的内容。它的设计正是围绕本地模型的弱点:幻觉 API 和缺陷、错误编辑、损坏的 JSON,以及小上下文窗口。

AstroJS 是首个支持的栈。任何 OpenAI 兼容端点都可用:LM Studio、Ollama、llama.cpp 的 server、vLLM,或托管 API。

文档:vb-harness.vandbruno.net,包含指南、cookbook 和设计决策。

状态:早期开发阶段。以下所有内容均可工作并经过测试,但请预期会有粗糙之处和变化。

你需要 Ruby 3.3+、git 和一个模型服务器;LM Studio 或 Ollama 最简单。然后:

git clone https://github.com/Viktotovich/vb-harness-for-agentic-building.git cd vb-harness-for-agentic-building ruby exe/harness

应用会在浏览器中打开一个起始页,包含三个步骤:连接模型、添加项目、描述要构建的内容。若想在任何设置之前先看一次完整构建,请在那里选择 Try the demo(或运行 ruby exe/harness demo):一个脚本化的模型会构建一个小型示例项目,包含一次失败的检查、其修复和一次审查,耗时不到一分钟。然后 Connect 会打开 Settings → Models,你在其中对某个模型选择 Use。把文本框切换到 Build,选择你的项目,描述功能,然后选择 Start build。如果项目尚未就绪(依赖未安装、缺少生成文件夹、检查所需的某个包缺失),文本框下方会说明并提供 Fix 按钮:它会显示确切命令,在你确认后运行,然后你即可构建。唯一留给你处理的是未提交的改动:提交或暂存它们。项目旁边的 Preview 会在 127.0.0.1 上运行其 dev server(对 Astro 是 astro dev)并打开它;已完成的构建会有其所生成内容的 Preview。

📱 新功能:从手机使用 harness。ruby exe/harness ui --lan 让家庭网络中的手机可以聊天、启动构建、回答规划器并观看进度,而你的电脑负责实际工作。请先阅读 Use it from your phone (LAN mode):它默认关闭,需要配对码,且仅适用于可信网络。

在命令行中,ruby exe/harness init 会询问几个问题(按 Enter 接受每个默认值),ruby exe/harness run --repo ../my-site --request request.md 会构建 request.md 所描述的内容。

卡住了?ruby exe/harness doctor --repo ../my-site(或 Settings → Check setup)会列出构建无法启动的每一个原因,每个原因都附带该做什么,不会更改任何内容,也不会要求模型编写任何东西。

Fastest path How it works Requirements Install Quick start: the app Use it from your phone (LAN mode) Quick start: the command line Projects and workspaces Understanding a run Cookbook: an Astro landing page Using with Claude Building from a Figma design Configuration Choosing and checking a model Safety model Evaluation Troubleshooting Limitations Why Ruby Development License

How it works 你的检出永远不会被更改。工作会留在 harness/<runId> 分支上,直到你合并它。

Ruby 3.3 或更新版本。无需 gem。在 Windows 上,使用 RubyInstaller(包含 Devkit)。

git。

一个具有 OpenAI 兼容 API 的模型服务器,例如 http://127.0.0.1:8080/v1。至少具有 16K 上下文的模型可用;越大越好。

你项目自身的工具链。对 Astro 来说就是 Node.js,且你要构建的仓库中已安装项目依赖(npm install)。

Install git clone https://github.com/Viktotovich/vb-harness-for-agentic-building.git cd vb-harness-for-agentic-building ruby exe/harness --version

就是这样:无需用 gem 或 bundle 安装任何东西。要把 harness 放到 PATH 上,可以给 ruby /path/to/vb-harness-for-agentic-building/exe/harness 设置别名,或在本地构建并安装 gem:

gem build vb-harness.gemspec gem install ./vb-harness-*.gem

存放 config.json 的文件夹是 harness 的主目录:chats/、runs/、logs/、.cache/、projects/ 和 workspaces/ 都会在它旁边创建。它们全部被 git 忽略。

ruby exe/harness

这会在 http://127.0.0.1:4567/ 上启动本地应用,并在首次启动时在浏览器中打开起始页。侧边栏列出你的聊天,最新的在最上面;启动了构建的聊天会在那里显示其状态(Building、Needs you、Failed、Stopped 或 ✓),因此等待中的构建很容易被发现。使用中的模型及其是否在工作位于侧边栏底部,紧挨 Settings。

连接模型(Settings → Models)。应用会在这台机器上查找 LM Studio 和 Ollama。你可以一键启动 LM Studio 的服务器、加载已下载的模型,或拉取一个 Ollama 模型。对于任何其他服务器,请在 Another server 下输入其 OpenAI 兼容 URL,如果需要 key,则输入存放该 key 的环境变量名(绝不要输入 key 本身)。对某个模型选择 Use:harness 会探测它并以简单标签显示探测结果,例如 "48K context · JSON mode: yes · tools: yes · thinking can be turned off"。Plan & review on any model 会让它成为规划器、审查器和验证器所用的模型,即使它与第一个模型在同一服务器上也是如此。Settings → How runs work 选择模式(Careful、Balanced 或 Quick)和工作方式(Pipeline 或 Agent)。

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →