我羡慕他们能 Vibe Coding，但我选择了先修路
<![CDATA[你要说我羡慕别人用 vibe coding 吧，我是不可能不羡慕的。
别人用 AI，一天出一个主题。论坛大话王、农场插件，刷刷地就出来了。UI 是典型的 Tailwind CSS 风格——一眼就能看出来，这是 AI 生成的。但那又怎样？人家做出来了，有人用了，有人买了。
而我呢？我在整理文档。
从三月到四月，我几乎没写什么新功能。我在做的事情是：把 Xiuno BBS 的文档从头到尾重新整理和编写。程序作者写的原始文档？烂。Xiuno PHP 框架手册？有点质量但不多，用的是作者自己的文档组织方式，非标准。全网就我写出了开发教程——这话说出来都觉得悲哀。
### 我在怕什么
我害怕的是，如果我不把全部细节讲明白，AI 会：
- 宁愿用 `$_POST` 也不用 `param` 函数
- 宁愿直接写 PDO 操作，也不愿意用 `db_find` 函数，甚至不用 `thread__find` 来获取帖子
- 不用 `url` 函数（正确做法，可适配未启用伪静态的情况），而是自行写符合 REST 规范的网址
- 不知道缓存机制，不知道正确的获取数据方式应该是先 `cache_get`，结果为 null 才读数据库并写入缓存
- 无法理解 Xiuno BBS 的面向切面编程，跑去用 WordPress 风格的 `add_action` 或 `add_filter`
这些问题不是假设。每一个都是 AI 真的会犯的错。
因为 AI 不懂你的程序。它懂 PHP，它懂 Laravel，它懂 WordPress，但它不懂 Xiuno BBS。它不知道 `<!--{hook index_site_brief_before.htm}-->` 这行注释意味着什么。它不知道这个注释的位置就是插件注入代码的位置。它不知道 Xiuno BBS 的 hook 机制有多精妙——精妙到让 AI 脑袋爆炸。
### 所以我修路
我花了两个月，写了这些东西：
- Xiuno BBS 机制精讲：数据库、插件、附件
- 权限系统详解、缓存系统详解、数据库表结构详解
- Hook 点完整分析表
- 请求从开始到结束的完整路径详解
- 开发实践教程：主题的 Easy Way 和 Hard Way
- Xiuno PHP 4.0 开发手册清扫版
- Model 层 API 参考手册（12 个函数文件，逐个编写）
- 依赖链分析（8 个模块）
- Mermaid 流程图和架构图
总共大约 89 个文档文件。从底层框架到程序本体，再到主题开发实践，以及开发辅助工具。
这不是什么伟大的壮举。这是苦力活。是那种你明知道做了也没人鼓掌，但不做就永远走不下去的苦力活。
### 无规矩不成方圆
Vibe coding 的核心是"人类提供战略意图，AI 负责战术实现"。听起来很美。但前提是——AI 得理解你的战场。
如果 AI 不知道 Xiuno BBS 的 `param` 函数是 `$REQUEST` 的安全包装，它就会用 `$_POST`。如果 AI 不知道 `url` 函数能适配未启用伪静态的情况，它就会硬编码路径。如果 AI 不知道缓存机制的存在，它就会每次都直接查数据库。
这些不是小问题。这是根基。根基不稳，上面盖再快也是流沙上的房子。
我不是不想快。我是知道，快了之后会塌。
### 羡慕嫉妒恨
说实话，我嫉妒。
我嫉妒他们能用 vibe coding 一天出功能，而我还在整理文档。我嫉妒他们的 Tailwind CSS 风格能被人接受，而我精心设计的交互被人说"丑""不像论坛"。我嫉妒别人用 12px 的字号和并不出色的设计就能俘获人心，而我的 Stately 是整个 Xiuno 圈子里的标杆，却只有一百四十多人选择。
但嫉妒归嫉妒，我清楚自己在做什么。
我在修路。路修好了，我才能放心地让 AI 来帮我开车。路不修好，AI 开的车只会翻。
B5 版本的更新记录里我写了这句话："未来 Aether 可能会使用更多的 AI 辅助编程，以及人们常说的'Vibe Coding'来追进度。"
但我紧接着写的是："无规矩不成方圆。"
这不是鸡汤。这是实操。规矩就是我那 89 个文档。方圆就是 AI 终于能正确使用 `param` 函数、`url` 函数、`cache_get` 函数写出来的代码。
### 慢一点，没关系
他们在我发布开发手册之前，就已经通过 vibe coding 开发出了新的主题和插件。
而我到目前为止还只是在整理文档的阶段。
我不是不想前进，而是我需要主动扫清障碍，主动驱散雾霾，我才能前行。我 2025 到 2026 做的事情都是这个。
行至水穷处，坐看云起时。
重要的东西，总是最后才被人看见。
---
Geticer
2026年5月12日
]]>