项目 01 //2026
Harbor
一个跑在本机的 AI 助手:指定一个文件夹,它自己读、自己改、自己跑测试。
为什么做这个
现有的 AI 编程工具大多是给「写代码」这一个场景设计的:把代码复制到网页里、等它回复、再把结果搬回来。
我想要的是另一样东西——给它一个文件夹,它自己动手,而且全程看得见。不是为了更快,是为了能信任。
它是什么
一个跑在本机的 AI 助手。你告诉它一个文件夹,它就在里面:读文件、改文件、跑起来试试。
数据、密钥、对话全留在这台机器上,没有账号,没有云端同步。
真正难的部分
不是让它干活。让它停得下来才是难的。
| 问题 | 做法 |
|---|---|
| 用户怎么相信它没乱改 | 写文件前弹 diff,默认折起来——不打扰,但随时能查 |
| 出错了怎么收 | 改动走事务,能整批撤回;顺手存存档点,能回到某一步重来 |
| 它会不会失控 | 轮数、操作次数、时长、重试、token 五项都有上限,撞上就停下来问 |
| 同样的操作绕圈 | 先自己换走法,几次还不行就交还给人 |
| 崩溃时状态不明 | 单独标出「动过但不知道成没成」的操作,让人先看现场,不是默默重跑 |
还有一条是主动砍掉的:不做「自动跑一整天」。那听起来很酷,但没人能验收。
学到的
边界比功能重要。 一个工具能不能用,往往不取决于它能做多少事,取决于做它的人知不知道哪里会坏、坏了怎么办、什么时候该停下来问人。
这个判断后来也用在了别的地方——比如我看别人项目时的标准。
代码与协作
代码由 AI 写,方向、验收标准和「什么不做」由我定。README 里每一条已知问题都是真实存在的,不是事后补的。