 hanfuit
|
3b240ec176
|
docs：新增 AGENTS.md 作为 AI / 新人接续开发的入口文件
一页纸解决「接手时不知道从哪读、哪些不能碰、改完怎么验」：
- 0 组件与端口速览；1 必读顺序（踩坑记录 P-001/P-002/P-011 列为首要）+ 按改动选文档
- 2 硬规则 R1–R9：DLL 与 exe 成对、改 DLL 要补 CRC 并重编服务端、Z 盘只是部署副本、
gmweb 只能 IE11、静态 no-store、sys.executable 陷阱、不提交产物、版本号三处一致、声明与 GPL
- 3 构建命令（服务端三个 exe / 启动器单文件 / 客户端补丁 / PVF 导出）
- 4 代码地图：server.py 按功能给出行号区间，其余给模块职责
- 5 验证方法：进程端口、启动器日志、CRC verify、diff -rq，
以及本项目一直在用的「静态服务 + 无头浏览器截图/量 rect」手法，附分场景清单
- 6 发版七项清单；7 当前状态；8 提交约定；9 不要做的事
- CLAUDE.md 作为指向 AGENTS.md 的兼容入口；根 README 顶部与文档索引、docs/README 同步挂上
|
2026-11-05 17:40:13 +08:00 |
|
|
hanfuit
|
adcc5b0f3a
|
docs：新增踩坑记录，13 条坑的成因复盘与判断规则
和「排查记录」不同，这份文档不写怎么修，只回答「为什么会踩、为什么没早发现」，
给的是可迁移的判断，而不是单次操作步骤。
- P-001 启动器套娃开窗：三层成因（打包改变 sys.executable 语义 / Popen 只保证
进程创建不保证脚本执行 / 端口顺延把必然失败伪装成正常启动）、四个掩盖因素、
四个不成立的隐含假设，以及「拉起子进程要校验副作用而非返回值」等五条教训
- P-002~P-013：DLL 指纹绑定、CRC32 种子、CRC 槽位扫错节、CSS 特异性、IE11、
旧进程占端口、WebView2 缓存、console=False、图片占位时序、仓库与部署副本、
replace 静默失败、补丁包缺文件
- 结尾提炼八条通用规则与发版检查清单
- 文档索引：根 README、docs/README 各补一行；排查文档顶部加成因复盘的交叉链接
|
2026-11-05 17:27:47 +08:00 |
|
|
hanfuit
|
c6587d88ee
|
启动器：修复打包后自我套娃开窗，补运行日志与排查文档
根因：start_gmweb() 用 sys.executable 拉起 gmweb/serve.py，源码运行时是
python.exe，PyInstaller 单文件打包后却是启动器自身 —— 于是 `exe serve.py`
又开了一个启动器，新启动器再去拉 serve.py，每代顺延一个端口并各开一个
空窗口，直到 19546 端口用尽。开发机因为 18112 早被占用走了 early return，
所以看不出来。
- 新增多调用模式 run_script_instead()：exe <xxx.py> [args] 时用 runpy 直接
执行该脚本，不开窗口/不提权/不占互斥量，打包后拉起 serve.py 才合法
- 新增单实例互斥（Local\DNF90Launcher-5E9C1B7A）：重复启动把已有窗口
ShowWindow+SetForegroundWindow 后退出，不再开第二个窗口
- start_gmweb() 增加就绪校验：spawn 后最多等 6 秒确认 18112 在监听，未监听
则改用 importlib 在本进程线程里跑 serve.py 的 main()，绝不再拉起新窗口
- self_elevate() 提权重启带上原始参数（原来 ShellExecuteW 传 None，参数全丢）；
DNF90_GMWEB_CHILD=1 的子进程不再触发 UAC
- WebView2 数据目录固定到 %LOCALAPPDATA%\DNF90Launcher\WebView2 且
private_mode=False，避免 exe 在只读目录/网络盘时窗口空白且无报错；
启动前查注册表确认运行时是否存在
- 新增 启动器日志.txt（exe 同目录，512KB 转 .old.txt）：console=False 下
print 与未捕获异常全部落盘，顶部记录 pid/argv/SERVER_ROOT
- 文档：新增 docs/启动器窗口风暴排查.md（现象、根因、复现手法、修复点、
日志判读表），README 常见坑与文档索引、docs/README、launcher/README 同步
|
2026-11-05 17:22:51 +08:00 |
|
|
hanfuit
|
da502b3524
|
docs：补上 90CN.dll 自校验 CRC 工具的文档说明
- 新增 docs/客户端补丁与CRC校验.md：SelfCrcSlot 结构、CRC32 算法与种子坑、
槽位为什么只在 .data/.rdata 里找、info/verify/patch 用法与退出码、
build_90cn.ps1 集成、与「服务端 DLL 指纹」的区别、六类故障排查
- 新增 client-patch/tools/README.md：脚本清单与常用命令速查
- docs/README.md：文档索引与上手路径补一条
- 根 README：关键设计说明补「客户端自校验（CRC32）」小节，文档索引补一行
- 90CN.cpp：清掉过期的重复注释（旧的 patch_selfcrc.py / .text 段说法），与实现对齐
|
2026-11-05 16:40:33 +08:00 |
|
|
hanfuit
|
645b64fe21
|
DNF90 服务端与启动器完整源码（含 GM 工具功能增强）
服务端（Go）：
- GM 塞背包/带属性装备发放：在线角色推送 op14 增量物品行，背包实时刷新，无需回角色选择界面
- GM 改金币/改等级：去掉在线拒绝，落库后推送 op14 钱包/op37 等级状态，在线实时刷新
- 等级端点统一切换到新版 GMSetCharacterLevel（自带在线刷新）
- 无限/锁死疲劳模式 + 燃烧疲劳：每房间消耗 2 点、打怪与通关经验双倍
- 燃烧疲劳开关时给所有在线角色推送系统提示（op12 mode 0）
- 深渊史诗掉率：GM 全局倍率 + 城镇增益药剂窗口倍率，真实接入掉落结算
启动器（Python/JS）：
- 标题栏自绘、窗口 1204x717、禁止拖拽改大小、仅最小化/关闭
- GM 工具：疲劳与燃烧、深渊史诗掉率、拍卖行上架（单一定价对齐）
- 拍卖行上架前端对齐服务端单一价格语义，修复 400 报错
|
2026-11-04 14:31:55 +08:00 |
|