项目 01 //2026

Harbor

一个跑在本机的 AI 助手:指定一个文件夹,它自己读、自己改、自己跑测试。

维护中 Electron / React / TypeScript 源码 ↗

为什么做这个

现有的 AI 编程工具大多是给「写代码」这一个场景设计的:把代码复制到网页里、等它回复、再把结果搬回来。

我想要的是另一样东西——给它一个文件夹,它自己动手,而且全程看得见。不是为了更快,是为了能信任。

它是什么

一个跑在本机的 AI 助手。你告诉它一个文件夹,它就在里面:读文件、改文件、跑起来试试。

数据、密钥、对话全留在这台机器上,没有账号,没有云端同步。

真正难的部分

不是让它干活。让它停得下来才是难的。

问题 做法
用户怎么相信它没乱改 写文件前弹 diff,默认折起来——不打扰,但随时能查
出错了怎么收 改动走事务,能整批撤回;顺手存存档点,能回到某一步重来
它会不会失控 轮数、操作次数、时长、重试、token 五项都有上限,撞上就停下来问
同样的操作绕圈 先自己换走法,几次还不行就交还给人
崩溃时状态不明 单独标出「动过但不知道成没成」的操作,让人先看现场,不是默默重跑

还有一条是主动砍掉的:不做「自动跑一整天」。那听起来很酷,但没人能验收。

学到的

边界比功能重要。 一个工具能不能用,往往不取决于它能做多少事,取决于做它的人知不知道哪里会坏、坏了怎么办、什么时候该停下来问人。

这个判断后来也用在了别的地方——比如我看别人项目时的标准。

代码与协作

代码由 AI 写,方向、验收标准和「什么不做」由我定。README 里每一条已知问题都是真实存在的,不是事后补的。