起点:smbeditor_5.0-0_all.deb 在原厂中标麒麟/银河麒麟 + 飞腾 D2000 上装完即崩,无法使用。
终点:smbeditor_5.0-1fix16_all.deb,可正常启动、编辑、保存、导出 PDF、导入 Word/WPS。
关键判断:不是"软件有 bug",而是"软件绑定的运行时与国产 CPU/内核/安全模块不兼容"。改应用代码解决不了,必须换运行时 + 加兼容层。
headerSize 在 offset 4,base=8+headerSize,jsonLen 从 base+4 读,json 从 base+8 开始kysec_set 加白名单 + 启动参数 --no-sandbox/dev/dri 节点,GPU 栈残缺chmod -R 777 /opt/smbeditor 破坏了 chrome-sandbox 的 setuidresources/app/temp 开放 777,chrome-sandbox 保持 4755Electron 9 到 37 跨了 28 个大版本,API 语义变了但不报错,全部表现为"点了没反应"。逐个踩。
Module._load 用 __ecompatProxied 标记防重复包装,第二次 require('electron') 返回了原始对象 → nodeIntegration 没生效proxyCache,每次调用都返回代理close/closed 事件对象不再带 senderxxxWindow.webContents.send(...)confirmFun 统一返回 .then(r=>r.response),全部判断点 Promise 化(VerifyRulePars.js 用重入标志续存)showMessageBox(win, opts, callback) 第三参被忽略,回调永不执行.then()webContents.print 的回调版本print 适配,与 printToPDF 一致node-native-printer 原生模块 ABI 不兼容lp 命令做桩webContents.getPrinters 由同步变异步application/ext + *.ext weight=60,update-desktop-database 把 application/ext=smbeditor.desktop 写进全局 mimeinfo.cacheapplication/ext;postinst 删孤儿 ext.xml(先 grep 校验 owner)→ 重建 mime 库 → 重建 desktop cache → 遍历各用户 mimeapps.list 只删 ^application/ext=.*smbeditor 行/optrm -rf /opt/smbeditorresources/app/temp/,原包靠全局 777 放行,收权后普通用户写不进resources/app/temp 递归 777 并预建 4 个子目录control.tar.gz 被打成 DEBIAN/control 嵌套结构,dpkg 解析失败tar -czf x -C DEBIAN control preinst postinst postrm 平铺;打完必跑 dpkg-deb -I 校验Exec 加了 --no-sandbox,argv[1] 变成参数而不是文件路径,原代码直接取 argv[1]extractFileArg() 扫描全部 argv,取第一个不以 - 开头、后缀合法的参数(first/second-instance 两处都改)extractFileArg 正则只认 .lrmx/.lrm;渲染层 SMB_Open_Default 也没有 docx 分支docx|doc|wps,大小写不敏感showOpenDialog 单文件时返回字符串;而 open-file.js 按数组遍历 → files[0] 是路径第一个字符 /,扩展名判断全失败,静默丢弃normalizeFilePaths() 数组/字符串统一;对话框与拖拽两个入口都归一化readFilePathSync 直接 fs.readFileSync,无存在性/后缀校验showErrorBox 全换异步 showMessageBox(6 处)+ 主进程 uncaughtException 兜底GPU process isn't usable. Goodbye. 整进程被杀--disable-gpu(disableHardwareAcceleration() 单独用无效)第 20 条最隐蔽:不报错、不写日志、任何文件都没反应,容易误判成"解析函数坏了"。定位手法是用桩件模拟对话框回调,拿旧代码跑一遍,把中间变量打出来——一眼看到逐字符 . d o c x,真相立刻明确。
showSaveDialog 结果也不含所选 filter.lrmxappendHtml 后 1 秒定时器就派发,不等页面导航/渲染完成did-start-navigation/did-finish-load 状态;渲染端 whenPrintContentReady(图片字体就绪 + 3 秒兜底)再触发;打印窗口 backgroundThrottling:falsemainHandleCompleted 里写成 webContents.fromId(id).webContents.send,E37 下 .webContents 为 undefined → 抛异常 → 外层 catch 把状态误置为"完成" → 任务重入队 → 管线死锁send;调度器加 60 秒看门狗(超时重试 ≤3 次);全链路 pipeline.log 打点printToPDF 未指定纸型时 Chromium 默认 Letter(612×792pt),比 A4 矮约 50pt,内容挤出第 3 页sanitizePrintOptions 兜底 pageSize=A4(8.27×11.69in) + margins=0这一层最能体现"改一个 bug 冒一个 bug"的连锁性。
docx/doc/wps;文件头嗅探:PK\x03\x04 走 zip 解析(docx 及 docx 内核的 wps),D0CF11E0 是老二进制格式 → 弹提示并用系统 WPS 打开让用户另存 docxtemp/template/cellPosition.json 写死了"姓名取第 1 行第 2 格、民族取第 2 行第 2 格……"row 15 / col 1,那一格是标签文字本身WORD_LABEL_FIELDS 白名单:19 个中文标签 ↔ lrmx 字段,只导入白名单内的标签w:t 切片会截断clearEditorFormForImport() 清空表单,避免上篇文档身份证、成员行残留xmlObjParserStr 加 XML 转义,内容含 & < > 时不再生成非法 XML| 坑 | 表现 | 绕过方式 |
|---|---|---|
| KYSEC 拦脚本 | bash xx.sh、bash -n file 报"权限不够" | bash < file / bash -s < script 管道方式 |
| /opt 受 file protect | 直接 cp 覆盖(root 也不行) | 只能重新打 deb 安装 |
| sudo 坏了 | sudoers.so 必须属于用户 ID 0 | 走 deb 安装,debroot 目录权限放开直接改文件 |
| 单实例锁残留 | 新实例静默退出(status 0),像"双击没反应" | 删 ~/.config/…/SingletonLock |
| 命令跑在 PID 命名空间 | ps/pgrep 看不到真实进程,误判"没启动" | 用 systemd-run --user --pipe --wait + X 视角(wmctrl/xwininfo)判断 |
| --disable-software-rasterizer | 加了它 jQuery 变 undefined、ligerUI 全崩 → 误判"jQuery 缺失" | 只用 --no-sandbox --disable-gpu;任何诊断先跑 lrmx 基线 |
| CDP target 正则太宽 | URL 里含用户名 zzbqf,宽松正则误配到 ZZB 页面 | 主窗口锚定 /SMB\.html$/ |
| /tmp 只有 10M | 打 146M 的 deb 时 tar 失败 | TMPDIR 设到项目目录 |
| 用户测的是旧进程 | 改完代码但用户窗口还是老进程,验证结论对不上 | 交付时提醒"装新包 + 完全退出重启" |
require('electron') 拿到原始模块,检查兼容层的代理缓存。FATAL,GPU 相关一律先加 --disable-gpu。