Ode to Gallantry 2017

WASM 修复摘要（迁移自 meta.json 的 group_note）

侠客行（"The Story of Hero"），MudOS v21 世系——和 110 号 xkx100、111 号 xkx2000zxb 是同一个核心代码库家族（从共享的 combatd.lpc/quest.h 结构就能看出）。WASM 修复：（1）和 xkx2000zxb 上已经见过的完全相同的错误 #include bug：adm/daemons/combatd.lpc 的 '#include </quest/quest.h>'（绝对路径写法）在这个驱动的 include 目录规则下解析不了——已改成 '#include <quest.h>' 并挪到 'inherit F_DBASE;' 之后以满足随之而来的"全局变量在 inherit 之前"排序规则（完全相同的修法，因为这是两份独立的压缩包，所以各自独立打的补丁）。（2）一处真正由损坏的留言板存档导致的下游后果：inherit/misc/bboard.lpc 的 setup() 未加保护地呼叫了 restore()；那份特定损坏的存档（clone/board/kedian_b 的）在解析过程中抛出"Illegal file format"，而由于 restore() 是 setup() 里的最后一条语句，这个异常（只被调用链更外层一个很远的 catch() 捕获）在呼叫者（kedian_b.lpc 的 create()）剩下的 set()/replace_program() 语句能执行之前就中止了执行，导致这个留言板的名字/短称状态处于损坏状态——之后每次在那个房间 look 都会崩溃报"Bad argument 1 to capitalize(), Got: 0"，出在 feature/name.lpc 的 short() 里。已给 bboard.lpc 的 restore() 呼叫包一层 catch()（这是一个共享的继承，所以能保护整个 mudlib 里的每一个留言板分身，不只是 kedian_b 那一个）——那一个特定损坏留言板的旧留言内容已经无法挽回，但房间/留言板物件本身现在能干净地初始化了。没有发现 is_chinese()/check_legal_name() bug——"小浮侠"（三个字）第一次尝试就通过了，不需要修。管理员账号播种：fluffos (admin) 加入 adm/etc/wizlist（这份档案的 securityd.lpc 真的会在开机时读取 WIZLIST，不像 xkx2000zxb 那种基于存档档案的机制——已通过源码确认，而不是假设文本档案方式能用；也没有 xkx2000zxb 那种 valid_wiz_login() 站点锁定闸门）。注册流程在一次连续的 WASM 客户端会话里完整验证过：英文 id→y/n 创建确认→中文名字→密码+确认→接受天赋赠礼（y）→电子邮件（id@address 格式）→性别→带着完整角色属性表和可用的 score/look 指令（包括之前会崩溃的留言板房间）进入游戏世界，全程没有任何意外错误。管理员权限已直接通过 'wizlist' 指令输出确认"目前权限：(admin)"。LPC 格式化工具对全部 3268 个档案运行（写入 3239 个，29 个因为杂乱的历史代码报错，0 个未改动）。没有 :: 父类呼叫拆分命中，没有 CJK 重新加空格命中，没有 case 标签带尾随注释的候选。全部 3 个 map.lpc 档案确认内容完全相同（只是空白差异）。格式化后用同样的完整注册流程重新验证过——干净，管理员权限依然是 (admin)。

深度功能测试（§10.7，本轮）：确认这份档案也带着 jqxz2008 家族那一整套 bug（虽然不是同一份代码库）

这份档案的 group_note 自己已经指出和 xkx100/xkx2000zxb 同属"MudOS v21"/ES II 世系，但没提过和 jqxz2008 系列（金庸群侠传）有关系——不过这次深挖发现两者的 adm/daemons/{chinesed,combatd,logind}.lpc、cmds/std/kill.lpc、cmds/skill/{bai,apprentice}.lpc 这几个关键档案结构高度相似，最近几轮在 jqxz2008/jqxz2008dlx/jqxz2008std 上依次确认的 5 个 bug，在这里逐一核对后全部命中：(1) chinesed.lpc 的 create() 对损坏的 data/e2c_dict.o 做未加保护的 restore()，会崩溃第一次真正用到 chinese()/to_chinese() 的地方；(2) /log/nosave/ 目录不存在，combatd.lpc 的 killer_reward()（每次死亡都会跑到）、kill.lpc、bai.lpc/apprentice.lpc 对着这个不存在的目录裸调 write_file()，会让 die() 中途崩溃并在心跳里死循环重现；(3) bai.lpc/apprentice.lpc 里判断是否从风清扬门下叛出的分支有括号位置错误，== 比较被夹进了 query() 的参数列表，分支永远不会触发。全部按已经验证过的相同修法处理（catch(restore()) + mapp() 守卫、四处 write_file() 前加 assure_file()、括号挪到 query() 外面比较返回值）。

这次还额外发现了第 4 类，本档案独有：adm/daemons/logind.lpc 的 §8.9 食物/饮水初始化检查错了对象——if (!user->query("food") && !user->query("water") && ob->query("age") == 14)，age 是角色（user）的属性不是登录物件（ob）的，这个分支永远不会触发，新角色的食物/饮水从创建起就永远是空的。改成 user->query("age") == 14。

以及 3 处 §7.68 死亡/复活软锁：d/death/npc/{wgargoyle,newgargoyle,bgargoyle}.lpc 的 death_stage() 都有 if (!ob || !present(ob)) return; 这种把"角色永久离开"和"暂时不在场"混在一起的写法，已按各文件自己的重试间隔（均为 5 秒）拆分成"暂时不在场则重试"。

用真实驱动完整验证了两次全新注册（小四、小五），score 正确显示食物/饮水两条状态全满；用小四实际去攻击 NPC"萧峰"（「铁掌降龙」），角色被打死，干净地触发"你死了"→"鬼门关"死亡场景→NPC"白无常"打招呼——debug.log 全程保持空白，确认 combatd.lpc 的修复生效、没有死循环崩溃。这份档案再次印证了"同一大家族（哪怕不是同一份具体代码库）的多个档案值得直接核对已知 bug 列表"这条经验——这次跨越了两个原本以为不相关的具体世系分支（jqxz2008 系列 vs xkx100/xkx2000zxb 系列）。

未继续测试的部分

时间关系，没有测试拜师、购物、留言板（虽然 group_note 里已经记录过这一块此前修复过存档损坏问题）。

更正（2026-08-05）：§7.68 复活软锁"修复"已撤销

上面提到的"鬼魂离开/不在场时被永久放弃复活流程"曾被当作 AGENTS.md §7.68 记录的一类 bug 修复（把单次判定改成每 5 秒重试）。经用户指出并 重新审视：这更可能是有意的游戏设计，不是 bug——大多数这类档案里 鬼魂根本无法自行移动，所以"不在场"要么从未真正发生，要么是"离开去 在阴间游荡，想回来时再走回这个房间、流程会通过 init() 重新从头开始" 这种有意为之的宽松机制，而不是需要强制追上玩家的错误。强行重试还可能 引入新问题：如果鬼魂之后又走回这个房间，旧的重试和 init() 重新触发的 新一轮流程可能同时运行，导致对话重叠错乱。已把这处改动撤销，恢复成 原始的 if (!ob || !present(ob)) return; 单次判定写法（bmxkx2001 除外——那份档案里这确实是一个真实存在、经过实际复现验证的 bug：鬼魂 本身完全无法移动，是另一个不相关的 NPC 强行把鬼魂拖走导致的）。详见 AGENTS.md §7.68 顶部的撤销说明。

§7.86 跨库扫描修复（留言板 post 崩溃）

• BULLETIN_BOARD inherit + 多余 replace_program() 致命形状（AGENTS.md §7.86，post 命令崩溃）：全档案 19 处命中，已删除多余的 replace_program(...) 调用（保留 inherit），逐文件保留原有行尾格式（CRLF/LF 按文件原样）。本次为跨库 §7.86 扫描修复（触发原因：该 bug 已在 6+ 个互不相关的血统家族独立确认，属于近乎普遍的拷贝粘贴模式），仅做编译检查（驱动干净启动、端口正常监听），未做完整 §10.7 深度游玩测试。

深度功能测试（2026-08-13，round two，新驱动重测）

针对驱动升级（quest_times/win_times %-operator 修复 + Warning/warning 大小写回退兼容）做的重测。

发现并修复的 PROGRAMMING bug

1. log_error()（adm/obj/master.lpc，实际生效的 master file） 完全没有严重度检查（AGENTS.md §7.34-class）：已加上 strsrch(message, "arning:") == -1 判断。 2. log_file()（adm/simul_efun/file.lpc）完全没有 assure_file() 保护（AGENTS.md §7.11-class）：已加上前向声明 + assure_file(LOG_DIR + file);。 3. feature/name.lpc 的通用 short() 兜底逻辑对 query("id") 没有做类型检查，任何 id 属性缺失的物件都会在被 look 到时崩 溃——新发现的一类通用性 bug，波及全库任何走这条兜底路径的物件， 不止留言板：str = name(raw) + "(" + capitalize(query("id")) + ")"——capitalize() 拿到非字符串直接抛 *Bad argument 1 to capitalize() Expected: string Got: 0.。Live 测试注册后第一次 look 客店就撞上：留言板 /clone/board/kedian_b 的存档数据本身 已损坏（见下），restore_object() 把 create() 里 set_name() 刚设好的 dbase 映射整个替换成了存档里那份不完整/损坏的映射， id/name 字段全部丢失。这个兜底路径是全库任何"没有自定义 short"物件共用的通用逻辑，不是留言板专属代码，所以修复方式选 在这个通用点上加防御性检查，而不是逐个物件类型修：str = name(raw) + "(" + (stringp(query("id")) ? capitalize(query("id")) : "") + ")"（stringp(query("id")) 这个判断风格和 feature/command.lpc/clone/misc/corpse.lpc 里已有的写法一 致，是这份代码库自己认可的惯用防护模式）。 4. **data/board/*.o 里 12 份存档数据本身已损坏（AGENTS.md §7.7 第三条"restore_object() 会整个替换/清零全域变量"那一类）， 修复方式是删除而不是只在 #3 那样加防御**：bonze_b、 gaibang_b、gaibang_r、huashan_b、kedian_b、shaolin_b、 taohua_b、towiz_b、wiz_b、xiaoy_b、xingxiu_b、 xueshan_b 共 12 份（缺少 # 存档头，或者括号/圆括号计数不配 对），逐一核对 raw/ 原始压缩包确认这些档案本身就是这个字节形 状，转档前就已损坏，不是本项目引入的回归。只加 #3 的防御性检查 能防止崩溃，但不能修复"留言板显示名字变成裸档案路径而不是中文名 字"这个副作用（restore_object() 会把 create() 里 set_name() 刚设好的整个 dbase 映射替换成损坏存档里解析出来 的残缺内容）——live 测试确认：只加 #3 的修复时，look 客店显示 /clone/board/kedian_b() [ 没有任何留言 ]，删除损坏存档后重 测，正确显示 客店留言板(Board) [ 没有任何留言 ]。 restore_object() 对不存在的文件只会静默返回 0，不会替换 dbase，所以删除这些无法再被正确解析的损坏存档是安全的。另外 6 份留言板存档（baituo_b、kedian2_b、lingjiu_b、tiandi_b、 wudang_b、xiaoyao_b）确认存档头和括号计数都正常，未触碰。

Proactive checks（无需改动）

• win_times 的 %-operator 修复确认存在且正确： d/city2/npc/refereew.lpc:176、d/npc/refereew.lpc:176 均已用 to_int(query("win_times")) % 5；d/huashan/npc/refereew.lpc 未 用到 %，不适用。
• feature/dbase.lpc 未发现 tybxjh/wlhd 那种密码写保护，不适用。

实测过程

adm/etc/wizlist 里的 fluffos (admin) 一直没有对应存档。本轮通 过完整注册流程创建（id → y → 中文名 → 密码 ×2 → 天赋接受 y → email → 性别 m），落地"客店"，score 显示"【天神】"头衔，食物/饮 水满格。随后单独一步做了真实断线重连+密码验证：用刚设的密码 重新连线成功登录，look 确认客店留言板正确显示"客店留言板(Board) [ 没有任何留言 ]"。全程 debug.log 无运行时错误。驱动按精确 PID 结束；管理员存档已提交；data/{login,user}/x/{xiaosi,xiaowu}.o 是 2026-08-05 遗留的、无 git 历史的测试存档，与本轮无关，未触碰。

§7.100 扫描修复（ROOM 基类多余 replace_program()）

#define ROOM "/inherit/room/room"：删除 818 处多余的、独立成行的 replace_program(ROOM);（保留 inherit ROOM;），与 jqxz2008 系列同一血统同一形状。clone/misc/roommaker.lpc 同样有两套模 板——"造一间空房间"的 heredoc 本来干净，"克隆我所在的房间"命令的 字符串拼接模板把同一枚多余的 replace_program(ROOM); 烤进了每一 个新克隆的房间，已同步修正。已用 build-debug 驱动干净启动验证 （0 个新增编译错误，端口正常监听）；未做完整 §10.7 深度游玩测 试。

``§7.112`` residual-gap closure (2026-08-20)

Corpus re-scan (grep -rl 'call_out("death_stage"' ... | filter for missing guard) found unguarded init()-scheduled death_stage() call_out chain(s) in d/death/npc/newgargoyle.lpc that the original two-wave sweep (see AGENTS.md §7.112) missed -- same reconnect-triggered duplicate-chain bug, different filename/lineage. Added the standard query_temp("death_stage_active")/set_temp/delete_temp re-entry guard, adapted per file's own exit points. Compile-verified via lpcc --batch.

§7.30 uninitialized-mapping accessor sweep (2026-08-20)

Corpus-wide mechanical sweep of the feature/skill.lpc shared-lineage bug (confirmed independently on xiakexing2017/jqxz2015/haiyang2 via round-four testing): 4 accessor(s) in this file returned a raw never-initialized mapping instance variable (defaults to int 0, not ([]), until first assigned), crashing any unguarded keys()/sizeof()/indexing caller for a fresh/untrained character. Fixed at the accessor level (mapp(x) ? x : ([])) per the documented remedy. Verified via lpcc --batch static compile check only (not a live boot) as part of a large mechanical sweep; not individually functionally re-tested live on this lib.

深度功能测试（2026-09-04，round three，shop + 拜师）

新角度：醉仙楼购物 + 丐帮左全拜师。§10.7 原文明确写「没有测试拜师、 购物」；2026-08-13 round two 修了 log_error/log_file/short() 和损坏留言板存档，仍然没走这两步。

实测过程

管理员 fluffos / Mud@2026。第一输入是「您的英文名字：」，落地 客店，留言板显示「客店留言板(Board) [ 没有任何留言 ]」（round two 删损坏存档后的状态仍在）。score 「【天神】普通百姓」。

goto /d/city/zuixianlou，list 烤鸡腿八十文铜板 / 牛皮酒袋一两 白银 / 包子五十文 / 鲸鱼十两黄金。clone /clone/money/gold 后 buy jitui 成功（「你从店小二那里买下了一根烤鸡腿」）。当场 i 还挂着「一两黄金」+ 九十九两白银 + 二十文铜板，那是 MONEY_D->player_pay() 把金锭 set_amount(0) 后物件还没析构的显 示；断线重连后黄金条目消失，只剩九十九两白银 + 二十文铜板 （10000−80 = 9920），找零数学正确，不是复制金钱。这份档案的 feature/dealer.lpc 里丐帮「穷叫化」拒绝购买整段是注释掉的，先买 再拜仍然按家族惯例走，没有撞上拒绝。

goto /d/gaibang/inhole，左全在树洞里，apprentice zuo 一次成功： 左全收徒，score 「丐帮第二十代弟子」、师父左全。cmds/usr/save.lpc 真正调用两个 save()。user.o 立刻带上 family_name":"丐帮" / master_name":"左全" / generation":20。断线后再连（「重新连线完 毕」），score 仍是丐帮 / 左全，银子还在。左全只收男性（gender != "男性" 就静默 return），本账号是男的所以没撞上。

本轮没有新的 programming bug。live debug.log 是 libs/xkx2017/log/debug.log（Boot Time Fri Sep 4 01:23:45 2026）， 无 error: / Too deep recursion。error_handler 把轨迹交回驱动 debug.log。work/log/log 只有编译期 Unused local variable 警告； work/log/{condition.err,move.bug} 停在 2026-07-30，不是本轮写入。 管理员存档未提交（本轮只记 NOTES）。