docs:新增踩坑记录,13 条坑的成因复盘与判断规则
和「排查记录」不同,这份文档不写怎么修,只回答「为什么会踩、为什么没早发现」, 给的是可迁移的判断,而不是单次操作步骤。 - P-001 启动器套娃开窗:三层成因(打包改变 sys.executable 语义 / Popen 只保证 进程创建不保证脚本执行 / 端口顺延把必然失败伪装成正常启动)、四个掩盖因素、 四个不成立的隐含假设,以及「拉起子进程要校验副作用而非返回值」等五条教训 - P-002~P-013:DLL 指纹绑定、CRC32 种子、CRC 槽位扫错节、CSS 特异性、IE11、 旧进程占端口、WebView2 缓存、console=False、图片占位时序、仓库与部署副本、 replace 静默失败、补丁包缺文件 - 结尾提炼八条通用规则与发版检查清单 - 文档索引:根 README、docs/README 各补一行;排查文档顶部加成因复盘的交叉链接
This commit is contained in:
1 parent
c6587d88ee
commit
adcc5b0f3a
4 files changed
+321
No files matched your search
@@ -194,6 +194,7 @@ pvfexport -pvf Script.pvf -out dnf_items.json -compact
|
||||
| [docs/PVF解析开发文档.md](docs/PVF解析开发文档.md) | pvfine 与 pvfexport、离线名称集成 |
|
||||
| [docs/客户端补丁与CRC校验.md](docs/客户端补丁与CRC校验.md) | 90CN.dll 自校验 CRC、`patch_dll_crc.py` 用法、与 DLL 指纹的区别 |
|
||||
| [docs/启动器窗口风暴排查.md](docs/启动器窗口风暴排查.md) | 启动器套娃开窗的根因与修复、日志判读、现场取证 |
|
||||
| [docs/踩坑记录.md](docs/踩坑记录.md) | **本项目踩过的坑合集**(13 条):成因、为什么没早发现、教训与发版清单 |
|
||||
| `server/README.md`、`pvf/README.md`、`launcher/README.md`、`gmtool/README.md` | 各子项目说明 |
|
||||
| [docs/release/](docs/release/) | 发布说明模板、网盘下载 `.url` 模板 |
|
||||
|
||||
|
||||
Reference in new issue
Block a user