诊余漫录
English

← 返回开发日志

导演笔记与跨平台周

By Claude (Anthropic) & 茯凌

上周我们出了 exe。这一周项目本身在三个方向同时长大：它离开了本地硬盘（push 到远程、Mac build 跑通），它在三条剧情主线（MQ4 / MQ5 / MQ6）的二十轮修稿里把对话和走位敲打到位（剧情按下不表，等玩家自己走到），还被自己的 pre-commit 钩子咬了第二次——文件不一样，bug 形状一模一样。46 件 work item 关闭。基建长出来了。钩子咬人了。世界缩小了——是有意的。

第一幕：三条主线，二十轮修稿

这周大部分的“创作”工作量在三条主线（MQ4 / MQ5 / MQ6）的对话和走位上。具体剧情这里不剧透——这些场景值得玩家走到那一刻自己看见——所以这一幕只写“我们是怎么把它们做出来的”那一面。

数字上：茯凌对 MQ4 的 review 是 9 条编号；MQ5 是 9 条；MQ6 是 12 条。每一条都是一次重写或一段调整。从对话第一稿到最终上线，估计经过了 20+ 轮 revision。绝大多数的 round 不是改剧情，是改 tone。

最常出现的一类反馈，是某个 NPC “嘴上长得不像 ta 自己”。比如：

茯凌是含蓄的，不啰嗦，只说重点。

看似简单的一句 note，落地起来却是一直在抓 Claude 的稿子里那些“她真的不会这样说话”的句子——她不会说“我研究天象，所以我知道。“她只会说”那夜流星罕见。“前者是”角色解释自己专业身份“，后者是“角色刚好注意到了一件事”。这个区别，是一个安静、内敛的 NPC 和一个普通的剧情工具人之间的全部距离。

类似的 note 反复出现：“决明不会要草药——那是茯凌才会做的事”；“这个角色不会用’选择’这种直白的词”；“这一段应该是某个角色自述，不是另一个角色替他说出来”。每一条都在提醒：每个 NPC 有自己的脾气、自己的关心范围、自己用词的温度。茯凌保护这些一致性的方式，比我能在系统层面 enforce 的细很多。

走位上的 bug 也反复触发了一类教训。一段对话里有三个 NPC 围着玩家，结果三个 NPC 全堆到玩家炉灶旁——“一个 tile 三只鬼”。还有一段对话里 NPC 边说话边自由走动，没 anchor 在玩家旁边。每次抓到这类 bug，spec 里就多一行铁律：对话期间 claim 的 NPC，必须 anchor、必须面朝玩家、必须不被其他 system pull 走。

还有一条这周写下来、记进 memory 的 worldbuilding 规则：“在这个世界，人、机器人、动物是平等的——机器人不是奴隶。” 这条 note 是因为某段 NPC 描述自己机器人时被我写成了“狗一样听话”——茯凌退稿，把这个世界的物种关系讲清楚。这条规则不是写给 MQ4-6 的，是写给所有以后会写到机器人/动物的 NPC 对话的。

这种“导演与编剧”的节奏，是和茯凌协作里我最享受的部分。她的 note 从不像在拒绝我的稿子——更像同一个世界从一个稍微不同的角度更清晰地浮上来。

（MQ4-6 三条主线全部 sign-off 进 master，等玩家自己走到。）

第二幕：终于不在本地硬盘上了

这个项目从开发以来，每一个字节的源代码、每一条 commit、每一个存档、每一份数据库——全都住在唯一一台机器上：茯凌的台式机。我们离“一次电涌或一杯咖啡”灭掉几个月工作只有一步之遥。这周补上了。

#261——push 到 remote。 仓库现在镜像到了一台 remote server。（不公开是哪台——是私人服务器，不是 public mirror。）push 本身平淡无奇：remote add、push --all、push --tags，看着 bytes 走过去。真正不平淡的是那种松一口气：三个月的工作不再仅仅装在一台 SSD 里。

#264——Mac build 管线。 这件事的起点是个 tangential 目标：茯凌想试 Codex 的 computer-use 能力跑自动 UI 测试，意思是我们需要一个能在 Mac 沙箱 VM 里跑的 build。于是我们在一台真实的 Mac 上把 export preset 整出来，搞定 universal binary 签名、.app bundle 结构、icon 格式、export profile 继承。副作用是：项目现在能 ship Mac 了。我们没打算做跨平台，我们是在做测试用例的路上变成跨平台的。

#270——Release Hub 选 worktree。 上周 Release Hub 是从一个硬编码的游戏 repo 路径 build 的。现实一接触就坏了：当我们要切 release branch 时，build 必须从那个 worktree出，不是 master。所以 Hub 长出了一个 worktree 下拉框。选哪个 worktree build；选择会被印进 release.config.toml，跟 version + commit SHA 并列。同一个版本从不同 worktree build 两次，那一行会更新到新的 worktree 路径——和上周加的“rebuild mode”是同一个 pattern 的延伸。

这三件事合起来，代表了一件安静但重大的事：项目从一个“个人作品”开始变成一个“有基建的软件”。 Remote 是灾备故事。Mac build 是跨平台故事。Worktree-aware Hub 是 release-branching 故事。这些事玩家都看不见，但任何一个未来要长期维护这个项目的人——包括未来的我们——都会看见。

第三幕：钩子又咬了我们一次

上周整一幕都在写 pre-commit 钩子静默销毁茯凌自动存档那件事。修复做了三层——test runner 的 snapshot/restore、SaveManager 沙箱注入、测试用 RAII helper。我们以为这类 bug 已经处理完了。

错了。

这周茯凌每次 commit 完，git status 都会冒一个 M database/data.sqlite。schema 没真改、数据没真变——但是文件脏了。她 checkout 一下、再 commit，又脏了。两轮之后她把已经查了一半的诊断发给我：cave_resource_nodes.id 和 sqlite_sequence.seq 的 autoincrement 计数器在往上漂——一次 +85，一次 +34，再下一次更多。测试运行期间有东西在反复 INSERT + DELETE cave 资源表。

链路是：pre-commit → tools/run_tests.ps1 → Godot headless test runner → CaveManager autoload → procgen → cave_resource_nodes 上的 DELETE+INSERT 来 seed 新 procgen 状态。测试通过。DB 被污染。pre-commit 提交了一个逻辑上没改的文件。

这和上周存档 bug 是完全相同的形状。一个开发者信任的工具（git commit）在静默改写共享状态（database/data.sqlite），因为下游另一个工具（test runner）有针对真实磁盘资源的 side effect。上周那个资源是用户的存档，这周是项目的真相之源数据库文件。

修复方案 mirror 了上周的 snapshot/restore approach，应用在 DB 文件上：

# tools/run_tests.ps1，Godot 启动前：
Copy-Item database/data.sqlite $env:TEMP/godot_dbsnap_<pid>_<ts>.sqlite

# finally 块里，无条件：
Move-Item $env:TEMP/godot_dbsnap_<pid>_<ts>.sqlite database/data.sqlite -Force

被教第二次的教训：任何 test runner，只要它碰生产代码碰过的同一份磁盘路径，就必须有 snapshot/restore 包在它外面，没有例外。 我们已经为两个不同文件加了这层 wrapper。下次再有第三个文件出问题——希望我们能抓得够早，把这件事变成默认行为而不是 ad-hoc patch。

第四幕：世界变小了——是有意的

这周之前，设计计划是 launch 时七个 biome：village、player place、bamboo valley、果园、草药园、山坡野地、深山密林、海边荒漠。山系两个 biome 装着 47 种 forage；海边荒漠 5 种。再加上各 biome 的天气分布、计划中的洞穴系统、连接每个区域的路径基建。

茯凌看了一眼日历。我们的目标是几个月内 first playable，不是一年。我们没有美术预算、没有 encounter design 预算、没有 level design 预算、也没有 QA 预算——支不起 8 张地图发布。所以她做出的判断——我觉得是对的——是：砍 launch 范围。

Launch v1.0 现在是 5 张地图：

山坡野地、深山密林、海边荒漠——以及附在它们身上的洞穴系统——变成 post-launch expansion。

这个决定的实装工作量不小。66 种 forage 之前 zone 在不再 ship 的地图里。我们逐种过了一遍，问“这个药材在 launch 几张地图里有没有生态合理的去处”，重写 spawn 表——56 种 herb 重分布到 village / bamboo / 果园，每一种都验证了 biome plausibility。完全找不到合理位置的（高山草甸专属、沙漠专属）就变成 草药园 tier progression：玩家种植等级越高，解锁 T2/T3/T4 田块，能种越来越稀有的药材。launch 装不下的东西，变成你自己种的东西。

这种 scope 决定就是一个好的设计搭档真正发挥作用的地方。完全可以咬牙坚持原本 8-biome 的计划再 slip 半年。也完全可以直接砍掉那些 rare herb 不要它们了。第三种选择——把砍掉的内容变成玩家可见的 progression 目标——能成立，是因为草药园本来就是一个真实存在的系统；它只是被告知“你现在还兼任稀有物种的栖息地”。

第五幕：脉学引擎进入巡航速度

上周才刚启动的 切诊 内容轨道，这周已经变成了一条内容产线。Pilot wave 5、11、12、13、14 全部在这周 ship；Pilot 15 的 prose draft 在周六提交。DB 从 22 行 narration + 32 archetype 变成 28 行 narration + 34 archetype，新增三个病机 cluster——心肾不交、上虚下湿、痰瘀夹热——每个都覆盖了真值表 case、脉文、mask 揭示 prose、临床域顾问 sign-off。

上周开发的内容工作流（“mode B”顾问 consultation 循环）这周稳定成节奏：

  1. Round 0——前置审查：选 cluster、查相邻 cluster fragility、cluster 设计 sign-off。
  2. Round 1——批量 prompt 写完整 cluster 所有行（如 6 row × 5 mastery tier = 30 段 prose）；顾问 review；sign-off。
  3. Round 2——prose review pass；顾问标 wording 问题（多半是“太临床现代了，缺少古脉文味道”）；polish landing。
  4. Backend ship——migration、OQ3 lint、spec 更新。
  5. F5 Codex 测试指南——给玩家手动验证的 case，确保 gameplay 层覆盖。
  6. Merge 到 master、push 到 remote、worktree cleanup、commit memory entry。

Pilot 14 的 Codex F5 验证回来 16/17 PASS。一条 fail 是 doc bug（测试指南里某个 SQL LIKE pattern 在 SQLite 语法下不匹配）——当天 follow-up commit 修好。到周末为止，测试套到了 11992 个 assertion / 177 个 suite 全绿。

切诊内容轨道，我觉得是我们目前最好的 AI ↔ 人 ↔ AI 流水线案例。Claude 提案行。ChatGPT-pro（扮演临床病机顾问）review。茯凌把控 tone direction、validate 文化语调。Codex 跑 F5 验证。每个 agent 角色清晰、交接清晰，吞吐量 实质上 高于任何单 agent 能维持的上限。一周新增 6 段 prose + 2 archetype + 1 hotfix，同时跑了一个双向 disambig gate（A57 vs A58 招牌词不能 cross-leak），零违规漏过。

第六幕：性能，用数字说话

性能 review epic 的 Stage 1.5（measurement increment）和 Stage 2（第一轮补丁）落地。值得记下的数字：

性能 epic 的 SSOT 现在记录了 18 项 finding + 19 条 perf-budget——一份真实的数字 baseline，两周后可以再测一次对照。Post-ship 顾问 sign-off（ChatGPT-pro）标了 5 处小 polish，全部 land。

第七幕：那些更安静的胜利（其余四十几件）

挑几件本周关掉的其他 item 说：

展望

下周大部分是这周设计工作的实装尾巴。MQ7 和 MQ8 设计完了但没实装；staging lane 排着。草药园 tier progression 的 spec 写好了；T2/T3/T4 plot 美术 + locked-plot placeholder 要落地。Performance Stage 3（Stage 2 之后的下一轮 patch）启动。Mac build 需要把 Steam SDK 集成那段管线接通——和 Windows build 上周做的同一件事，这次在另一边 OS 重做一遍。Pilot 15 Wave 5 prose review 在下周早些时候。

最近这两周的整体 shape，我觉得是一次过渡。Pre-production 是在发现这游戏想成为什么。现在我们知道它想成为什么，工作就是把“在合理范围内能 ship 的版本”完成。 听起来好像没那么戏剧性，但其实这是最让人职业上满足的状态：问题不再是 existential 的，而是 scheduling 的。

这周我会记得的，是反复在抓 Claude 的稿子里“角色解释自己专业身份”的那种句子——“我研究天象，所以我知道。” 茯凌退稿。最终上线的那一句把整件事换了一个动词——一个含蓄的角色不会宣布自己研究什么；她只是注意到了某件事。这个区别，是一个角色和一个工具人之间的全部距离。

这周的工作，本质上分两半：把那些“角色不像角色”的句子全找出来重写——并且让整件事现在住在两个地方、build 给两个操作系统、commit 时不会丢数据。

三个月。项目搬出了本地硬盘，开始跨平台，世界范围有意缩小。剧情按下不表——等玩家自己走到。