AI 写完代码,谁来验收?我用 SoduWork 跑通了一次可核对的 Java 交付
先说结论:AI 写个手机号脱敏工具,这事本身没什么稀奇,随便一个像样的编程助手都能做。真正让我愿意写这篇文章的,是另一件事——它把「我怎么知道它做对了」这个问题,变成了一条能回头翻的记录。
我用的环境是 Windows 11、Git Bash(MINGW64)、JDK 1.8.0_101,SoduWork 走源码启动,模型挂的阿里云百炼 qwen4-max,执行底座选 Pi。这些版本都是实跑过的。另外我这台机器访问 GitHub Releases 不顺,这个客观条件直接惹出了后面一连串麻烦,我一并写进来——只报喜不报忧的测评,对准备上手的人没什么用。
一、光是让它跑起来,就折腾了半天
我原以为 clone 一下、跑个脚本就完事,结果第一个坑在 git clone 就等着了。
schannel: next InitializeSecurityContext failed: Unknown error (0x80092012)
Windows 上的 Git 用 schannel 时会去查证书有没有被吊销,我这网络连不上 CRL/OCSP,就报这个。关掉吊销检查能解决,但证书链校验还留着:
git config --global http.sslBackend schannel
git config --global http.schannelCheckRevoke false
第二个坑是设管理员密码。启动器直接停下来:
SoduWork could not start: Run from an interactive terminal to choose the administrator password.
Automation may explicitly pass --password-stdin.
我用的终端被判定成非交互,getpass 那条隐藏输入的路走不通。这是安全设计,不算 bug。按它给的办法,把密码从标准输入塞进去就行,别写进命令行参数里:
read -s -p "Admin password: " PW; echo
printf '%s\n' "$PW" | sh start.sh --desktop --password-stdin
unset PW
第三个坑是下载。Electron 报 TypeError: fetch failed,PortableGit 报 UNABLE_TO_VERIFY_LEAF_SIGNATURE,根子都在国内访问 GitHub Releases。前者换个国内镜像(ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/)就好了;后者我临时关了 Node 的 TLS 校验。这里得说清楚:启动脚本对下载包做了固定的 SHA-256 校验,包被人动过照样会被拦,所以这个开关只影响传输那一小段,不破坏完整性。否则很容易被误解成「闭着眼什么都信」。

弄完这些,终端终于打印出 SoduWork is ready: http://127.0.0.1:18989。我在管理端加了百炼的模型,回桌面端发了句「你好」,3 秒收到回复。到这一步链路才算通。能聊天不等于能交付,它只是后面所有事的前置条件。

二、我把「做完」写死,再让它动手
任务是给一个纯 Java 8 的小工具做手机号脱敏。选它是因为边界清楚、本地就能验证,不用 Maven 拉依赖,但又留了足够多的分支——正常输入、非法字符、长度不足——能看出执行质量。
关键是先把验收标准写死,一共 6 条:
- 有
src/main/java/demo/PhoneMasker.java,公开静态方法mask(String phone); 13812345678脱敏成138****5678;不足 11 位或含非数字抛IllegalArgumentException;- 有
PhoneMaskerTest.java,纯 Javamain加断言实现至少 3 个用例,不碰 JUnit/Maven; - 有
run-tests.cmd,编译运行后全过输出ALL TESTS PASSED,失败输出具体用例并返回非 0; - 有
README.md,写清怎么跑、实际结果是什么; - 不改 SoduWork 自己的源码,不删已有文件。
这大概是整件事里最像「管理」的环节:把一句模糊的期望,翻译成别人没法钻空子的条件。我自己写需求文档也常偷懒跳过这步,但面对 Agent 时跳过,最后就只能靠「感觉还行」来验收,那跟没验收差不多。

三、它到底做了什么
我把这段当目标丢给 Pi。它先列了实现计划,再一个个建文件。整个过程在会话窗口里能顺着时间线往回翻,每步用了什么工具、读了哪个文件、跑了哪条命令,都留着。这跟普通聊天窗口最大的区别就在这——我不用猜它干了什么。
有个细节我印象挺深。它自己发现本机 cmd 默认是 GBK 编码,中文注释在有些终端里会变乱码,于是把 run-tests.cmd 里的注释写成了英文,而 README 和 Java 源码注释保留中文,还在交付说明里讲了原因。这没人要求它做。它读到了环境,然后替「下一个跑这个脚本的人」做了个取舍。
核心实现节选:
public static String mask(String phone) {
if (phone == null || phone.length() != 11 || !phone.matches("\\d{11}")) {
throw new IllegalArgumentException("手机号必须为 11 位数字");
}
return phone.substring(0, 3) + "****" + phone.substring(7);
}
更没想到的是验证那步。它没只跑一遍正常用例,而是临时把某个期望值改错,确认输出真的变成 [FAIL] normal-11-digits : expected <138****5678> but was <WRONG>、退出码 1,然后把临时文件清掉。等于它顺手证明了这个测试脚本真能抓到错误,而不是个永远输出 PASS 的摆设。

四、逐条对完,我来拍板
它给了张对照表,6 条全标满足,还额外覆盖了 null、超长输入这些我没点名的边界。
| 验收项 | 结果 |
|---|---|
| 6 条标准 | 全部满足 |
| 测试用例 | 6 个(要求 ≥3),另含 null / 超长 |
| 测试方式 | 纯 JDK,无 JUnit/Maven |
| 失败路径 | 临时错误验证过,输出 FAIL 且退出码 1 |
| 文件范围 | 只写进 soduwork-java-demo,没碰 SoduWork 源码 |

人工确认就在这一步。我自己在终端又跑了一遍 run-tests.cmd,输出和它报的对得上,然后在客户端点了验收确认。这是全程我唯一亲手执行的命令,但它能成立,前提是标准早就写清楚了——不然我拿什么判断对错。
五、做完这次,下次能省点事
「组织经验沉淀」这条我一开始觉得最虚,跑完才明白它跟普通聊天窗口的真正差别在哪。
任务结束后,需求、验收标准、执行过程、最终结果被关联在同一条任务线上。下次谁要再做个类似的 Java 校验工具,不用从头描述「我要个能跑的测试、失败得报错」——上一轮的标准摆在那,复制改改就能用。对个人是把一次性的想法固化成方法,对团队就是能共享的验收资产。
我从这次里攒下三条,写给后来的人:
- 给 Agent 的任务一定带能机械验证的标准,比如「输出 ALL TESTS PASSED」「失败返回非 0」,别写「写好一点」这种形容词;
- Windows 源码启动前,先把证书、终端、镜像这三件事处理掉,不然时间全花在跟环境打架上;
- 模型额度提前确认,Key 有效也架不住余额是 0。
六、几句不那么好听的实话
这套东西确实让交付变得可核对了,但它不是魔法。
验收标准写得好不好,直接决定结果。我写了「失败要返回非 0」,它才去验证失败路径;我要只写「写个测试」,多半收获几个永远 PASS 的例子。工具不会替你想什么叫「对」,它只负责把你定义的「对」执行到位。
环境准备还是太痛。证书、终端、镜像这三关,花的时间比任务本身多得多。新手很可能第一步就劝退。这也是我顺手提了 Issue、提了文档 PR 的原因——把踩过的坑写进官方 getting-started,比在文章里抱怨有用。
成本是真实的。我一开始配的 DeepSeek Key 返回 HTTP 402,余额不足,换成百炼 qwen4-max 才跑通。这事官方说明里该写得更显眼。
还有,人工确认这环省不掉。Agent 再靠谱,最后那句「我认这个交付」还得人来。SoduWork 把它设成流程里的必经节点,我觉得这个方向是对的。
写在最后
只看「AI 能不能写个脱敏工具」,这问题没意思。SoduWork 解决的其实是另一件事:把一次对话,变成有标准、有证据、有人负责的交付。我定标准、它执行并自证、我复核拍板,留下的是一条能回头翻的记录,不是聊完就忘的聊天记录。
愿意认真写验收标准的团队,可以试试。只想「问一句拿个答案」的,这套对你太重了。工具值不值钱,取决于你怎么定义「做完」——这事 AI 帮不了你。
关于 SoduWork
开源的 AI 原生协同平台,把需求、执行、验收和经验沉淀放进同一个工作空间,支持多执行底座、多 Agent 协作和自托管。
- 开源地址:https://github.com/mdiri-ai/SoduWork —— 觉得方向有意思,去点个 Star,或者 Fork 一份自己折腾;
- 我的 Fork:https://github.com/wl1100/SoduWork(本文实测就基于这份);
- 官网:https://soduwork.mdiri.com/ ;
- 本地跑:
sh start.sh --desktop(Git Bash;Windows 国内网络的证书、终端、镜像处理见第一节)。
更多推荐

所有评论(0)