先说结论: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 校验,包被人动过照样会被拦,所以这个开关只影响传输那一小段,不破坏完整性。否则很容易被误解成「闭着眼什么都信」。

clone 与首次启动的终端报错

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

桌面端收到真实回复

二、我把「做完」写死,再让它动手

任务是给一个纯 Java 8 的小工具做手机号脱敏。选它是因为边界清楚、本地就能验证,不用 Maven 拉依赖,但又留了足够多的分支——正常输入、非法字符、长度不足——能看出执行质量。

关键是先把验收标准写死,一共 6 条:

  1. 有 src/main/java/demo/PhoneMasker.java,公开静态方法 mask(String phone);
  2. 13812345678 脱敏成 138****5678;不足 11 位或含非数字抛 IllegalArgumentException;
  3. 有 PhoneMaskerTest.java,纯 Java main 加断言实现至少 3 个用例,不碰 JUnit/Maven;
  4. 有 run-tests.cmd,编译运行后全过输出 ALL TESTS PASSED,失败输出具体用例并返回非 0;
  5. 有 README.md,写清怎么跑、实际结果是什么;
  6. 不改 SoduWork 自己的源码,不删已有文件。

这大概是整件事里最像「管理」的环节:把一句模糊的期望,翻译成别人没法钻空子的条件。我自己写需求文档也常偷懒跳过这步,但面对 Agent 时跳过,最后就只能靠「感觉还行」来验收,那跟没验收差不多。

写在会话里的需求与 6 条验收标准

三、它到底做了什么

我把这段当目标丢给 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 的摆设。

run-tests.cmd 的 ALL TESTS PASSED 输出 失败路径验证:FAIL 与退出码 1

四、逐条对完,我来拍板

它给了张对照表,6 条全标满足,还额外覆盖了 null、超长输入这些我没点名的边界。

验收项结果
6 条标准全部满足
测试用例6 个(要求 ≥3),另含 null / 超长
测试方式纯 JDK,无 JUnit/Maven
失败路径临时错误验证过,输出 FAIL 且退出码 1
文件范围只写进 soduwork-java-demo,没碰 SoduWork 源码

Agent 给出的逐条验收对照表

人工确认就在这一步。我自己在终端又跑了一遍 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 国内网络的证书、终端、镜像处理见第一节)。
Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐