fix(dsh): slim packaged runtime and surface startup errors #14

Merged
abaishu0730 merged 1 commits from codex/dsh-runtime-fix into main 2026-11-02 13:58:59 +08:00
Owner

修复 DSH助手点击无反馈和发布包体积过大的问题。

  • 发布前仅暂存 Windows x64 运行包,去除其他平台依赖、测试/示例目录、TypeScript、source map 和文档。
  • DSH 懒启动异常进入任务中心可见错误路径。
  • 新增精简运行时、UI 失败提示和打包回归。
  • 48 项定向回归通过;精简暂存目录的 Harness doctor 和真实 Qt/CDP 点击验收通过。
修复 DSH助手点击无反馈和发布包体积过大的问题。 - 发布前仅暂存 Windows x64 运行包,去除其他平台依赖、测试/示例目录、TypeScript、source map 和文档。 - DSH 懒启动异常进入任务中心可见错误路径。 - 新增精简运行时、UI 失败提示和打包回归。 - 48 项定向回归通过;精简暂存目录的 Harness doctor 和真实 Qt/CDP 点击验收通过。
abaishu0730 added 1 commit 2026-11-02 11:39:04 +08:00
Author
Owner

审查提交:caa79e7fcf307e02df21be9ee247f4ba253e613d

建议修复后合并(Request changes):本轮发现 1 项 P1 凭据发布问题。

[P1] PyInstaller 仍会把 issue reporter 令牌打进 EXE

位置:packaging/DxPartReplace.spec:39-43。

当构建环境按发布流程配置了 integration/dsh/issue-bootstrap.json 时,spec 会在第 40 行把整个 JSON 作为 dsh-runtime/issue-bootstrap.json 加入 PyInstaller 数据,并在第 42–43 行把它设为 DSH 运行包存在时的构建前置条件。该文件包含 issue reporter 的 write:issue 令牌;令牌一旦进入便携 EXE/ZIP,任何拿到发行包的人都能提取并向仓库发起工单操作。PR14 新增的 Node 运行时裁剪不会影响这个文件,因此仍会把凭据带入冻结包。

建议:发布构建绝不把令牌作为 datas 打包,也不要把本机凭据作为构建前置条件。将 issue reporter 改为首次运行时由本机安全配置注入,或在没有凭据时禁用该能力;增加打包回归,断言冻结目录和 ZIP 中不存在 issue-bootstrap.json、令牌字符串或等价凭据。

已验证部分

  • python -m pytest -q tests/dsh tests/ui/test_dsh_native_menu.py tests/packaging --tb=short:219 passed。
  • Python compileall、修改的 JS node --check 通过。
  • dsh_runtime_staging.py 的单元回归覆盖 Windows x64 保留、其他平台依赖裁剪、测试/示例/文档/source map 清理;未发现新的功能阻断。

平台当前 mergeable=true 只表示无 Git 冲突;仓库检查状态为 pending 且没有实际 CI 检查项。凭据打包问题解决并加入回归后,再重新审查合并。

## 审查提交:`caa79e7fcf307e02df21be9ee247f4ba253e613d` **建议修复后合并(Request changes):本轮发现 1 项 P1 凭据发布问题。** ### [P1] PyInstaller 仍会把 issue reporter 令牌打进 EXE 位置:[packaging/DxPartReplace.spec:39-43](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/caa79e7fcf307e02df21be9ee247f4ba253e613d/packaging/DxPartReplace.spec#L39)。 当构建环境按发布流程配置了 `integration/dsh/issue-bootstrap.json` 时,spec 会在第 40 行把整个 JSON 作为 `dsh-runtime/issue-bootstrap.json` 加入 PyInstaller 数据,并在第 42–43 行把它设为 DSH 运行包存在时的构建前置条件。该文件包含 issue reporter 的 `write:issue` 令牌;令牌一旦进入便携 EXE/ZIP,任何拿到发行包的人都能提取并向仓库发起工单操作。PR14 新增的 Node 运行时裁剪不会影响这个文件,因此仍会把凭据带入冻结包。 建议:发布构建绝不把令牌作为 `datas` 打包,也不要把本机凭据作为构建前置条件。将 issue reporter 改为首次运行时由本机安全配置注入,或在没有凭据时禁用该能力;增加打包回归,断言冻结目录和 ZIP 中不存在 `issue-bootstrap.json`、令牌字符串或等价凭据。 ### 已验证部分 - `python -m pytest -q tests/dsh tests/ui/test_dsh_native_menu.py tests/packaging --tb=short`:**219 passed**。 - Python `compileall`、修改的 JS `node --check` 通过。 - `dsh_runtime_staging.py` 的单元回归覆盖 Windows x64 保留、其他平台依赖裁剪、测试/示例/文档/source map 清理;未发现新的功能阻断。 平台当前 `mergeable=true` 只表示无 Git 冲突;仓库检查状态为 pending 且没有实际 CI 检查项。凭据打包问题解决并加入回归后,再重新审查合并。
Author
Owner

复审跟进

根据维护者说明,issue-bootstrap.json 及其中的 issue reporter 凭据是有意保留并允许随发布包携带的部署配置,不属于本 PR 的阻断缺陷。此前评论 #158 的 P1 凭据打包意见撤回。

结合当前 head caa79e7fcf307e02df21be9ee247f4ba253e613d 的独立验证:相关 DSH、UI、打包和运行时回归 219 passed,Python 编译、修改的 JS 语法检查通过;本轮未发现其他可操作问题。

更新结论:建议通过(Approve)。

## 复审跟进 根据维护者说明,`issue-bootstrap.json` 及其中的 issue reporter 凭据是**有意保留并允许随发布包携带**的部署配置,不属于本 PR 的阻断缺陷。此前评论 #158 的 P1 凭据打包意见撤回。 结合当前 head `caa79e7fcf307e02df21be9ee247f4ba253e613d` 的独立验证:相关 DSH、UI、打包和运行时回归 **219 passed**,Python 编译、修改的 JS 语法检查通过;本轮未发现其他可操作问题。 **更新结论:建议通过(Approve)。**
abaishu0730 merged commit 344a2797b0 into main 2026-11-02 13:58:59 +08:00
Author
Owner

回审已合并 PR #14(fix(dsh): slim packaged runtime and surface startup errors)

merge 344a279,first-parent diff 7 文件 +159/−5。行号按 origin/main(aff228e)复核。

结论:这个 PR 的两件事——"运行时瘦身"与"暴露启动错误"——一件被回退、一件没做到;建议清理遗留并补上错误暴露(P2)


P2-1 "运行时瘦身"在合并 57 分钟后被整体回退,但模块/测试/文档仍留在 main

  • 本 PR 引入的 packaging/dsh_runtime_staging.py:53 stage_node_modules(...) 会按名字删除 .bin、__tests__、.ts 等目录。
  • 合并后约 57 分钟,cd94319 把打包用法整体回退;tests/packaging/test_release_configuration.py:25 现在用 AST 断言 spec 不得引用 stage_node_modules,SELF-EXTRACTING-RELEASE.md:3 也要求完整 node_modules。
  • 但 packaging/dsh_runtime_staging.py 本身、它的测试 tests/packaging/test_dsh_runtime_staging.py,以及 docs/testing/2026-11-02-dsh-runtime-fix.md 都还在 main;而且 CI 仍在跑这个测试(.gitea/workflows/ci.yml:49)。

后果:一套会删运行时文件的代码以"有测试覆盖"的姿态留在仓库里,未来任何人把它接回 spec 就直接踩回同一个坑;CI 也在为一个已被禁止的模块消耗时间。

建议:删除 packaging/dsh_runtime_staging.py 与对应测试(或移到 tools/legacy/ 并在 CI 里移除),文档标注"已回退,勿使用"。

P2-2 "暴露启动错误"没有真正做到

  • ui/dsh_native.py:232-233 把 node stderr 收进 self.last_error,但 _finished()(:243-248)只显示"DSH 运行时已退出,请检查安装后重试。";
  • main_window.py:1161 显示"DSH助手启动失败,请检查发布包中的运行时和 Node.js。"
  • self.last_error 在 src 中没有消费者(grep 只有赋值)。

也就是:本 PR 的标题目标"surface startup errors"仍然只到"通用文案"这一层。真实原因(例如 PR #17 里的 Stored DSH_API_KEY has no provider binding)永远到不了用户眼前。建议把 last_error 末尾 N 行脱敏后显示在失败页,并在 report_ui_error 的证据里带上同一段。

P3

  • main_window.py:1147-1163 的 report_ui_error(error) 返回的 error_id 被丢弃:界面显示的编号与日志里的编号对不上时,现场无法用界面文字定位日志。建议显示 id。
  • 同一段文案在两行里重复出现("DSH助手启动失败…" + _show_error 再包一层),建议合并成一句可操作的提示。
  • docs/testing/2026-11-02-dsh-runtime-fix.md:9/15/17 记录了"缩包"的数字,但没有写"已回退",容易被当成现行策略。

验证记录

  • 逐行读 344a279 全量 diff;dsh_runtime_staging.py、test_dsh_runtime_staging.py、test_release_configuration.py:25、ci.yml:49、dsh_native.py:232-248、main_window.py:1147-1163 均在 origin/main 上确认。
  • 未跑打包/EXE 构建;未验证 stage_node_modules 实际删除后的运行时行为(已禁止使用,未执行)。

未验证边界

未在真实发布包上验证启动失败路径;node_modules 不在克隆中,未做动态测试。

# 回审已合并 PR #14(`fix(dsh): slim packaged runtime and surface startup errors`) merge `344a279`,first-parent diff 7 文件 +159/−5。行号按 `origin/main`(`aff228e`)复核。 ## 结论:这个 PR 的两件事——"运行时瘦身"与"暴露启动错误"——**一件被回退、一件没做到**;建议清理遗留并补上错误暴露(P2) --- ## P2-1 "运行时瘦身"在合并 57 分钟后被整体回退,但模块/测试/文档仍留在 main - 本 PR 引入的 `packaging/dsh_runtime_staging.py:53 stage_node_modules(...)` 会按名字删除 `.bin`、`__tests__`、`.ts` 等目录。 - 合并后约 57 分钟,`cd94319` 把打包用法整体回退;`tests/packaging/test_release_configuration.py:25` 现在用 AST 断言 **spec 不得引用 `stage_node_modules`**,`SELF-EXTRACTING-RELEASE.md:3` 也要求完整 `node_modules`。 - 但 `packaging/dsh_runtime_staging.py` 本身、它的测试 `tests/packaging/test_dsh_runtime_staging.py`,以及 `docs/testing/2026-11-02-dsh-runtime-fix.md` 都还在 main;而且 **CI 仍在跑这个测试**(`.gitea/workflows/ci.yml:49`)。 **后果**:一套会删运行时文件的代码以"有测试覆盖"的姿态留在仓库里,未来任何人把它接回 spec 就直接踩回同一个坑;CI 也在为一个已被禁止的模块消耗时间。 **建议**:删除 `packaging/dsh_runtime_staging.py` 与对应测试(或移到 `tools/legacy/` 并在 CI 里移除),文档标注"已回退,勿使用"。 ## P2-2 "暴露启动错误"没有真正做到 - `ui/dsh_native.py:232-233` 把 node stderr 收进 `self.last_error`,但 `_finished()`(:243-248)只显示"DSH 运行时已退出,请检查安装后重试。"; - `main_window.py:1161` 显示"DSH助手启动失败,请检查发布包中的运行时和 Node.js。" - `self.last_error` 在 src 中没有消费者(`grep` 只有赋值)。 也就是:本 PR 的标题目标"surface startup errors"仍然只到"通用文案"这一层。真实原因(例如 PR #17 里的 `Stored DSH_API_KEY has no provider binding`)永远到不了用户眼前。建议把 `last_error` 末尾 N 行脱敏后显示在失败页,并在 `report_ui_error` 的证据里带上同一段。 ## P3 - `main_window.py:1147-1163` 的 `report_ui_error(error)` 返回的 `error_id` 被丢弃:界面显示的编号与日志里的编号对不上时,现场无法用界面文字定位日志。建议显示 id。 - 同一段文案在两行里重复出现("DSH助手启动失败…" + `_show_error` 再包一层),建议合并成一句可操作的提示。 - `docs/testing/2026-11-02-dsh-runtime-fix.md:9/15/17` 记录了"缩包"的数字,但没有写"已回退",容易被当成现行策略。 ## 验证记录 - 逐行读 `344a279` 全量 diff;`dsh_runtime_staging.py`、`test_dsh_runtime_staging.py`、`test_release_configuration.py:25`、`ci.yml:49`、`dsh_native.py:232-248`、`main_window.py:1147-1163` 均在 `origin/main` 上确认。 - 未跑打包/EXE 构建;未验证 `stage_node_modules` 实际删除后的运行时行为(已禁止使用,未执行)。 ## 未验证边界 未在真实发布包上验证启动失败路径;node_modules 不在克隆中,未做动态测试。
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Skyworth_Digital_Hardware/dxdesigner-part-replacement#14