feat: integrate DSH assistant core and Acrylic task workspace #10

Merged
abaishu0730 merged 20 commits from codex/ui-update into main 2026-11-01 21:47:59 +08:00
Owner

本 PR 将 DSH 助手核心与 Harness 集成、Acrylic 任务工作区 UI 一并纳入主线。此前标题/说明仅描述 UI,遗漏了分支继承的 12 个 DSH 提交;本次按审查评论 #110允许的方案完整声明范围。PR #11 以本分支为基线继续实现生产监管闭环,其新增能力和审查修复属于后续 PR。

实际变更范围

  • src/dx_productivity/dsh/、integration/dsh/:固定 DeepSeek Harness 0.2.1-rc.5 的本机运行时、Qt WebEngine 页面、任务快照、原生确认创建任务、模型能力路由、异常诊断、受控的一次重试与 Git 工单证据上报;包含依赖锁文件、许可和打包集成。源码运行需 Node.js 24.9+,通过 tools/Install-DshRuntime.ps1 安装依赖。
  • 任务中心 UI:Windows 原生 Acrylic、SVG 图标、导航/摘要/计划工具和执行区布局;数据表保持实色,表头与主体同步滚动,可拖动列宽和列顺序。支持透明度回退、搜索反馈、空态与保存快捷键;保存会先提交活动单元格,未保存内容继续阻断执行。
  • 回归与证据:DSH/UI/安全门禁测试、固定依赖/打包检查、开源项目研究、材质探针、历史截图及本轮原生验收。docs/reviews/2026-10-30-ui/ 中包含设计过程资料,最终行为以源码和本轮修复记录为准。

安全边界与部署限制

  • Harness 仅监听回环地址,独立 profile,不继承个人 Harness/Codex 配置;使用进程环境白名单,模型密钥通过本机 DPAPI 配置加载。这些是应用侧控制,不是操作系统沙箱。
  • 普通对话工具仅提供任务快照和经原生确认的新建任务;异常诊断会话仅允许读取快照。没有注册通用 Shell、任意文件访问、插件安装或模型直接 CAD 写入工具;任务 ID、参数、版本、动作白名单和确认门禁在应用侧校验。
  • 自动重试仅用于此前已授权执行且服务确认无待核验结果的已知失败,同一任务/原执行轮次共享持久化的一次额度。暂停、不确定结果及未知错误阻断写入重放。保存、重新打开回读、强制结束确认和恢复保护沿用任务中心流程。
  • 证据脱敏后封存为 SHA256 manifest。工单默认固定 HTTPS 目标,预填身份仅有本仓库 issue 权限,绑定目标的令牌不会转发至其他目标。共享令牌的分发、吊销和轮换仍是部署风险;预填资源不进入 Git,需由维护者配置。上报失败保留本地待提交记录。
  • 本轮未重建便携 EXE,未启动真实用户 CAD、调用真实模型或提交远端工单。真实 DSH 对话/工具/工单历史证据见 docs/testing/2026-10-30-dsh-*.md,不作为本轮重新验收的结果。PR #11 的监管、调度与工单中转等能力需单独完成审查和部署。

审查修复与主线同步

  • 合并最新 main 2cf526e,合并提交 a41c6cf;没有强制推送或改写下游 PR 的历史。main_window.py 冲突联合保留 main 的异步 ResourceStatus/未知资源阻断和 UI 的未提交单元格门禁。
  • 主线 batch_runtime.py、supervisor_evidence.py、ui/resource_status.py 与该 main 一致,保留身份/快照、active_task 原子落盘及诊断保留修复。
  • 执行期间“强制结束…”直接显示在主按钮行,请求安全暂停后仍可见;原确认与核验流程保留。
  • 菜单保留注册前明确设置的 hidden 状态;首次同步前也不会把隐藏动作显示出来。
  • 文档明确 legacy accent API 的兼容性依赖、Win11 DWM 实验结论、支持矩阵与未验证场景。默认回退色由主题常量共享;高对比度下撤下自定义样式,使用系统调色板,并覆盖聚焦搜索框/标题/任务文字回归。
  • 策略轮询降为 30 秒,隐藏时不读策略;显示、激活及调色板事件仍检查。材质延迟回调绑定 QObject 生命周期,避免销毁后访问 Qt 窗口。

逐项修复记录及本轮截图:pr10-review-fixes.md。原生验收数据:pr10-review-acceptance.json。

本轮验证

  • python -m pytest -q tests/v1_1 tests/ui tests/dsh tests/packaging --junitxml=build/pr10-review-tests.xml:1086 passed,1 条已有 pywinauto COM 模式警告。独立检出,无忽略项或工作区未提交依赖。

  • 审查点名的四组安全回归:80 项通过;材质/菜单/停止控制专项:26 项通过(与完整回归有重叠)。

  • python tools/accept_acrylic_ui.py --output build/pr10-review-controls-final:Windows 11 build 26200、125% 缩放下通过 Acrylic、实色表格、透明度回退、搜索和 980×700 验收;执行/暂停控制截图只预览 UI 状态,没有派发执行 worker。

  • git diff --check、Python 编译及 Node 脚本语法检查通过。

未重新验证 Win10、其他驱动、多显示器/不同 DPI 和发布包的原生外观;系统 API 返回成功不等同于这些场景的视觉验收。

最新评论 #117 修复

  • P1:保留并传递原执行轮次 StopControl,单任务、批次与 worker 异常收尾都不会丢失暂停/强制结束状态。末项失败即使 paused=False,自动诊断仍只能取证/上报;新的明确执行授权才创建新控制。
  • P2:stdout/stderr 分别采用持续的 UTF-8 增量解码器,重启时清空半行及解码器状态,避免中文、目录及自定义 Value 跨块损坏。
  • 新增 15 项边界回归:真实服务/队列/诊断流程的停止与重授权、worker 异常传递、中文/emoji 所有字节切点、多行事件及重启清理。外部 CAD、模型和工单传输使用替身,未访问真实工程或创建工单。
  • 最新完整回归:python -m pytest -q tests/v1_1 tests/ui tests/dsh tests/packaging --junitxml=build/pr10-review-117-tests.xml:1101 passed,无忽略/跳过项,1 条已有 pywinauto COM 模式警告。前述 1086 项为上一轮结果,已由本轮合并后回归覆盖。
  • 定向回归 156 项通过;独立审查无阻塞,独立重跑新增测试 15 项通过。

详见 第二轮修复记录 与 测试摘要。未重建 EXE。

评论 #127 的两项 P3 修复

  • 协议解析按行隔离错误,拒绝非对象 JSON 和错误 READY 字段,坏行后继续处理本批合法消息。错误摘要不记录原始载荷;UTF-8、task_id/revision 与本机地址门禁保留。
  • 模型元数据改同目录唯一临时文件 + flush/fsync + os.replace,受控写入、刷盘和替换失败时保留旧 JSON 并清理临时文件。这是 metadata 单文件原子发布,不宣称密钥与元数据为跨文件事务。
  • 新增 27 项回归;与既有配置和上一轮边界用例合计 43 项通过,独立复核同样 43 项通过。
  • 最新完整回归:python -m pytest -q tests/v1_1 tests/ui tests/dsh tests/packaging --junitxml=build/pr10-review-127-tests.xml:1128 passed,无忽略或跳过项;1 条已有 pywinauto COM 模式警告。此前 1086/1101 项属于历史轮次。

详见评论 #127 修复记录和完整回归摘要。未重建 EXE,未调用真实模型、CAD 或工单传输。

评论 #134:配置与密钥一致性提交

  • 确认并修复上一轮只保证 metadata 单文件原子性留下的配置对缺口。现在采用版本化不可变 DPAPI 密钥,provider.json schema_version=2 引用对应 key_file,最后一次原子替换是唯一提交点;不会在元数据发布前覆盖旧密钥。
  • JSON 写入/刷盘/发布失败时保留完整旧 URL、模型与密钥并清理未发布文件;已发布旧密钥保留,使读取旧快照的并发读取者仍获得旧配置。新格式密钥缺失或引用错误时拒绝加载,不回退其他密钥。
  • 兼容读取旧版固定 provider-key.dpapi 组合;下次保存升级。新版配置需要更新后的客户端。桌面验收工具改用完整快照加载再保存,支持两种格式。
  • 新增跨提供方切换(URL 和密钥同时变化)、写入/metadata刷盘/发布失败、新旧格式、并发读取、缺失引用、首次发布清理和验收复制回归。专项及独立复核均 25 项通过,无阻塞或重要问题。
  • 最新完整回归:python -m pytest -q tests/v1_1 tests/ui tests/dsh tests/packaging --junitxml=build/pr10-review-134-tests.xml:1146 passed,无忽略/跳过项,1 条已有 pywinauto COM 模式警告。前述 1086/1101/1128 为历史轮次。

详见评论 #134 修复记录与测试摘要。全部测试使用临时配置和虚构密钥;没有改写实际本机 provider 配置、发出模型请求或执行 CAD,未重建 EXE。

本 PR 将 **DSH 助手核心与 Harness 集成**、**Acrylic 任务工作区 UI** 一并纳入主线。此前标题/说明仅描述 UI,遗漏了分支继承的 12 个 DSH 提交;本次按[审查评论 #110](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/pulls/10#issuecomment-110)允许的方案完整声明范围。PR #11 以本分支为基线继续实现生产监管闭环,其新增能力和审查修复属于后续 PR。 ## 实际变更范围 - `src/dx_productivity/dsh/`、`integration/dsh/`:固定 DeepSeek Harness `0.2.1-rc.5` 的本机运行时、Qt WebEngine 页面、任务快照、原生确认创建任务、模型能力路由、异常诊断、受控的一次重试与 Git 工单证据上报;包含依赖锁文件、许可和打包集成。源码运行需 Node.js 24.9+,通过 `tools/Install-DshRuntime.ps1` 安装依赖。 - 任务中心 UI:Windows 原生 Acrylic、SVG 图标、导航/摘要/计划工具和执行区布局;数据表保持实色,表头与主体同步滚动,可拖动列宽和列顺序。支持透明度回退、搜索反馈、空态与保存快捷键;保存会先提交活动单元格,未保存内容继续阻断执行。 - 回归与证据:DSH/UI/安全门禁测试、固定依赖/打包检查、开源项目研究、材质探针、历史截图及本轮原生验收。`docs/reviews/2026-10-30-ui/` 中包含设计过程资料,最终行为以源码和本轮修复记录为准。 ## 安全边界与部署限制 - Harness 仅监听回环地址,独立 profile,不继承个人 Harness/Codex 配置;使用进程环境白名单,模型密钥通过本机 DPAPI 配置加载。这些是应用侧控制,不是操作系统沙箱。 - 普通对话工具仅提供任务快照和经原生确认的新建任务;异常诊断会话仅允许读取快照。没有注册通用 Shell、任意文件访问、插件安装或模型直接 CAD 写入工具;任务 ID、参数、版本、动作白名单和确认门禁在应用侧校验。 - 自动重试仅用于此前已授权执行且服务确认无待核验结果的已知失败,同一任务/原执行轮次共享持久化的一次额度。暂停、不确定结果及未知错误阻断写入重放。保存、重新打开回读、强制结束确认和恢复保护沿用任务中心流程。 - 证据脱敏后封存为 SHA256 manifest。工单默认固定 HTTPS 目标,预填身份仅有本仓库 issue 权限,绑定目标的令牌不会转发至其他目标。共享令牌的分发、吊销和轮换仍是部署风险;预填资源不进入 Git,需由维护者配置。上报失败保留本地待提交记录。 - 本轮未重建便携 EXE,未启动真实用户 CAD、调用真实模型或提交远端工单。真实 DSH 对话/工具/工单历史证据见 `docs/testing/2026-10-30-dsh-*.md`,不作为本轮重新验收的结果。PR #11 的监管、调度与工单中转等能力需单独完成审查和部署。 ## 审查修复与主线同步 - 合并最新 main `2cf526e`,合并提交 `a41c6cf`;没有强制推送或改写下游 PR 的历史。`main_window.py` 冲突联合保留 main 的异步 `ResourceStatus`/未知资源阻断和 UI 的未提交单元格门禁。 - 主线 `batch_runtime.py`、`supervisor_evidence.py`、`ui/resource_status.py` 与该 main 一致,保留身份/快照、active_task 原子落盘及诊断保留修复。 - 执行期间“强制结束…”直接显示在主按钮行,请求安全暂停后仍可见;原确认与核验流程保留。 - 菜单保留注册前明确设置的 hidden 状态;首次同步前也不会把隐藏动作显示出来。 - 文档明确 legacy accent API 的兼容性依赖、Win11 DWM 实验结论、支持矩阵与未验证场景。默认回退色由主题常量共享;高对比度下撤下自定义样式,使用系统调色板,并覆盖聚焦搜索框/标题/任务文字回归。 - 策略轮询降为 30 秒,隐藏时不读策略;显示、激活及调色板事件仍检查。材质延迟回调绑定 QObject 生命周期,避免销毁后访问 Qt 窗口。 逐项修复记录及本轮截图:[pr10-review-fixes.md](docs/reviews/2026-10-30-ui/pr10-review-fixes.md)。原生验收数据:[pr10-review-acceptance.json](docs/reviews/2026-10-30-ui/pr10-review-acceptance.json)。 ## 本轮验证 - python -m pytest -q tests/v1_1 tests/ui tests/dsh tests/packaging --junitxml=build/pr10-review-tests.xml:**1086 passed**,1 条已有 pywinauto COM 模式警告。独立检出,无忽略项或工作区未提交依赖。 - 审查点名的四组安全回归:80 项通过;材质/菜单/停止控制专项:26 项通过(与完整回归有重叠)。 - `python tools/accept_acrylic_ui.py --output build/pr10-review-controls-final`:Windows 11 build 26200、125% 缩放下通过 Acrylic、实色表格、透明度回退、搜索和 980×700 验收;执行/暂停控制截图只预览 UI 状态,没有派发执行 worker。 - `git diff --check`、Python 编译及 Node 脚本语法检查通过。 未重新验证 Win10、其他驱动、多显示器/不同 DPI 和发布包的原生外观;系统 API 返回成功不等同于这些场景的视觉验收。 ## 最新评论 #117 修复 - P1:保留并传递原执行轮次 StopControl,单任务、批次与 worker 异常收尾都不会丢失暂停/强制结束状态。末项失败即使 paused=False,自动诊断仍只能取证/上报;新的明确执行授权才创建新控制。 - P2:stdout/stderr 分别采用持续的 UTF-8 增量解码器,重启时清空半行及解码器状态,避免中文、目录及自定义 Value 跨块损坏。 - 新增 15 项边界回归:真实服务/队列/诊断流程的停止与重授权、worker 异常传递、中文/emoji 所有字节切点、多行事件及重启清理。外部 CAD、模型和工单传输使用替身,未访问真实工程或创建工单。 - 最新完整回归:`python -m pytest -q tests/v1_1 tests/ui tests/dsh tests/packaging --junitxml=build/pr10-review-117-tests.xml`:**1101 passed**,无忽略/跳过项,1 条已有 pywinauto COM 模式警告。前述 1086 项为上一轮结果,已由本轮合并后回归覆盖。 - 定向回归 156 项通过;独立审查无阻塞,独立重跑新增测试 15 项通过。 详见 [第二轮修复记录](docs/reviews/2026-10-30-ui/pr10-review-117-fixes.md) 与 [测试摘要](docs/reviews/2026-10-30-ui/pr10-review-117-tests.json)。未重建 EXE。 ## 评论 #127 的两项 P3 修复 - 协议解析按行隔离错误,拒绝非对象 JSON 和错误 READY 字段,坏行后继续处理本批合法消息。错误摘要不记录原始载荷;UTF-8、task_id/revision 与本机地址门禁保留。 - 模型元数据改同目录唯一临时文件 + flush/fsync + os.replace,受控写入、刷盘和替换失败时保留旧 JSON 并清理临时文件。这是 metadata 单文件原子发布,不宣称密钥与元数据为跨文件事务。 - 新增 27 项回归;与既有配置和上一轮边界用例合计 43 项通过,独立复核同样 43 项通过。 - 最新完整回归:`python -m pytest -q tests/v1_1 tests/ui tests/dsh tests/packaging --junitxml=build/pr10-review-127-tests.xml`:**1128 passed**,无忽略或跳过项;1 条已有 pywinauto COM 模式警告。此前 1086/1101 项属于历史轮次。 详见[评论 #127 修复记录](docs/reviews/2026-10-30-ui/pr10-review-127-fixes.md)和[完整回归摘要](docs/reviews/2026-10-30-ui/pr10-review-127-tests.json)。未重建 EXE,未调用真实模型、CAD 或工单传输。 ## 评论 #134:配置与密钥一致性提交 - 确认并修复上一轮只保证 metadata 单文件原子性留下的配置对缺口。现在采用版本化不可变 DPAPI 密钥,`provider.json` schema_version=2 引用对应 key_file,最后一次原子替换是唯一提交点;不会在元数据发布前覆盖旧密钥。 - JSON 写入/刷盘/发布失败时保留完整旧 URL、模型与密钥并清理未发布文件;已发布旧密钥保留,使读取旧快照的并发读取者仍获得旧配置。新格式密钥缺失或引用错误时拒绝加载,不回退其他密钥。 - 兼容读取旧版固定 provider-key.dpapi 组合;下次保存升级。新版配置需要更新后的客户端。桌面验收工具改用完整快照加载再保存,支持两种格式。 - 新增跨提供方切换(URL 和密钥同时变化)、写入/metadata刷盘/发布失败、新旧格式、并发读取、缺失引用、首次发布清理和验收复制回归。专项及独立复核均 25 项通过,无阻塞或重要问题。 - 最新完整回归:`python -m pytest -q tests/v1_1 tests/ui tests/dsh tests/packaging --junitxml=build/pr10-review-134-tests.xml`:**1146 passed**,无忽略/跳过项,1 条已有 pywinauto COM 模式警告。前述 1086/1101/1128 为历史轮次。 详见[评论 #134 修复记录](docs/reviews/2026-10-30-ui/pr10-review-134-fixes.md)与[测试摘要](docs/reviews/2026-10-30-ui/pr10-review-134-tests.json)。全部测试使用临时配置和虚构密钥;没有改写实际本机 provider 配置、发出模型请求或执行 CAD,未重建 EXE。
abaishu0730 added 17 commits 2026-10-31 10:22:30 +08:00
Author
Owner

独立审查(PR #10,head 058a88b)

审查基线:main(2cf526e)← head 058a88b;git diff 显示 199 文件 / +17564 / −103、15 个提交。已阅读 UI 材料层、图标、命令菜单、主窗口与各面板改动,以及随分支携带的 DSH 核心模块;并独立复跑测试。

验证结果(本机复现)

  • python -m pytest -q --ignore=tests/ui/test_dsh_task_lifecycle.py:946 passed(PR 描述为 947,差 1 项,无失败)。
  • tests/ui + tests/dsh:103 passed。
  • git diff --check、compileall、.mjs/.js node --check 通过。
  • git merge-tree:与 main 在 src/dx_productivity/trial_task_center/ui/main_window.py 存在 content conflict(API mergeable=false)。

阻断项

[P1] PR 实际范围与标题/描述严重不符。
标题与描述只讲 Acrylic/UI 打磨,但该分支实际包含整个 DSH 助手核心:git merge-base 为 12895e9,分支携带 12 个 DSH 提交(bf14b20…be382a1)+ 3 个 UI 提交;main 中尚不存在 src/dx_productivity/dsh/ 与 integration/dsh/。规模上 integration/dsh/package-lock.json 一项就有 9,922 行,另有 dsh/ 新包、tools/ 多个验收脚本、83 个 docs/reviews 文件。按"UI PR"去评审会漏掉整个新子系统的威胁模型与能力边界。建议:拆分为「DSH 核心子系统」与「Acrylic UI 打磨」两个 PR(或至少在描述中完整列出 DSH 范围、安全边界与验收命令),否则无法按声明的范围完成合并前评审。

[P1] 分支落后 main 8 个提交且与 main 冲突,合并可能丢失 PR #9 的安全修复。
merge-base 12895e9 之后,main 已合入 PR #9 的后续修复(7da623d…24b655c),而本分支缺少:supervisor_evidence.py、ui/resource_status.py、tests/v1_1/test_missing_uid_inventory.py、batch_runtime.py 的 active_task 原子落盘、身份/快照安全修复、审查诊断保留等。ui/main_window.py 双方都改过(238 行差异),冲突解决时若简单取一边,会静默回退这些安全修复。PR 描述的 947 passed 是在旧基线上跑的,不覆盖合并后的代码。建议:rebase 到当前 main(2cf526e)→ 解决冲突 → 重跑双方回归(重点 tests/v1_1/test_safe_user_stop.py、test_batch_runtime.py、test_missing_uid_inventory.py、test_supervisor_evidence.py)→ 再请求合并。

其他发现

[P2] 「强制结束」被移入「更多操作」菜单,降低异常场景下的可发现性。
run_panel.py:50-53 把 force_stop_button 从主按钮行移入 CommandMenu(dsh/诊断/清理/历史/重置也一并移入)。门禁仍通过 sync() 生效(action.setEnabled(button.isEnabled())、setVisible(not button.isHidden())),但强制结束是主操作挂起时的安全逃生口;藏进二级菜单会让操作员在故障现场更难找到。建议活跃执行时仍将「强制结束…」保留在主按钮行,或给「更多操作」按钮加显著状态提示。

[P3] Acrylic 依赖未文档化的 SetWindowCompositionAttribute(WCA_ACCENT_POLICY=19),Win11 未走系统 backdrop。
material.py:60-76 使用 legacy accent policy;available()(:33)只判断 build ≥ 17763,未区分 Win11 的 DwmSetWindowAttribute(SYSTEMBACKDROP_TYPE) 路径。在 Win11 最大化/多显示器/远程会话下该接口可能失效或产生黑边。当前有 opaque fallback、高对比度与远程会话降级、以及截图差分验收(tools/accept_acrylic_ui.py 断言 sidebar/header 背景差分 > 2、表格 < 1.5),风险可控;建议补充 Win11 专用路径或在文档中写明支持矩阵。

[P3] MaterialMainWindow.paintEvent 硬编码 #edf1f5(material.py:19-24)。
fallback 颜色未与 styles.py 调色板共享常量;深色/高对比度主题下可能产生色差。建议引用统一主题色,并在高对比度时使用系统色。

[P3] AcrylicController._poll 每 2 秒读取注册表 + SPI(material.py:101-107)。
窗口可见期间持续轮询,开销小但企业受管环境可能对注册表访问敏感;已有 WindowActivate 触发,可考虑降低轮询频率或缓存策略结果。

[P3] CommandMenu.add_button 的 button.show() 有时序依赖(command_menu.py:17)。
show() 会清除既有 hidden 标记;若按钮在菜单构建前已被业务门禁隐藏,菜单动作会短暂显示为可见,直到下一次 _update_gates()。当前构造顺序下无实际影响,建议 sync() 以显式可见状态为准,避免时序假设。

随分支携带的 DSH 核心(抽查结论)

以下边界设计是扎实的:launch_environment 采用环境变量白名单(DSH_API_KEY 仅经 DPAPI 解密后注入,不继承无关凭据);DX_DSH_READY 强制 127.0.0.1+http;工具动作白名单与 task_id 绑定、非自动动作强制确认;incident 会话被 tools.guard 限制为只读;证据全量 scrub + SHA256 manifest;重试预算在变更前以独占文件 + fsync 消费;工单目标 HTTPS 校验、禁重定向、2MB 上限。生产监管层(调度/工单/决策日志等)的进一步问题已在 PR #11 审查中列出,本 PR 合并后需一并继承修复。

做得好的部分

  • Acrylic 生命周期完整:仅在支持且系统允许时启用;先遮蔽再切换、批量暂停绘制避免闪屏;句柄重建释放旧合成;所有失败路径回落到不透明表面,并有针对性测试(10 项 material 测试)。
  • 图标为原创 SVG,统一 normal/disabled/primary 配色并缓存。
  • 业务门禁保留完好:键盘保存会先提交活动单元格编辑(has_pending_editor)、干净计划不可重复保存、批量编辑要求选中行、命令菜单只调用 enabled+visible 的按钮;对应 test_ui_polish.py 13 项覆盖。

结论

Request changes。 两件 P1 必须处理:(a) 修正 PR 范围声明或拆分;(b) rebase 到当前 main、解决冲突并重跑合并后的回归。UI 打磨本身质量良好(Acrylic 回退、门禁保持、截图差分验收);处理 P1 后可按 P2/P3 逐项收敛再合并。

## 独立审查(PR #10,head `058a88b`) 审查基线:`main`(`2cf526e`)← head `058a88b`;`git diff` 显示 **199 文件 / +17564 / −103**、15 个提交。已阅读 UI 材料层、图标、命令菜单、主窗口与各面板改动,以及随分支携带的 DSH 核心模块;并独立复跑测试。 ### 验证结果(本机复现) - `python -m pytest -q --ignore=tests/ui/test_dsh_task_lifecycle.py`:**946 passed**(PR 描述为 947,差 1 项,无失败)。 - `tests/ui` + `tests/dsh`:**103 passed**。 - `git diff --check`、`compileall`、`.mjs/.js` `node --check` 通过。 - `git merge-tree`:与 main 在 `src/dx_productivity/trial_task_center/ui/main_window.py` **存在 content conflict**(API `mergeable=false`)。 ### 阻断项 **[P1] PR 实际范围与标题/描述严重不符。** 标题与描述只讲 Acrylic/UI 打磨,但该分支实际包含**整个 DSH 助手核心**:`git merge-base` 为 `12895e9`,分支携带 12 个 DSH 提交(`bf14b20`…`be382a1`)+ 3 个 UI 提交;main 中尚不存在 `src/dx_productivity/dsh/` 与 `integration/dsh/`。规模上 `integration/dsh/package-lock.json` 一项就有 9,922 行,另有 `dsh/` 新包、`tools/` 多个验收脚本、83 个 `docs/reviews` 文件。按"UI PR"去评审会漏掉整个新子系统的威胁模型与能力边界。建议:拆分为「DSH 核心子系统」与「Acrylic UI 打磨」两个 PR(或至少在描述中完整列出 DSH 范围、安全边界与验收命令),否则无法按声明的范围完成合并前评审。 **[P1] 分支落后 main 8 个提交且与 main 冲突,合并可能丢失 PR #9 的安全修复。** merge-base `12895e9` 之后,main 已合入 PR #9 的后续修复(`7da623d`…`24b655c`),而本分支缺少:`supervisor_evidence.py`、`ui/resource_status.py`、`tests/v1_1/test_missing_uid_inventory.py`、`batch_runtime.py` 的 active_task 原子落盘、身份/快照安全修复、审查诊断保留等。`ui/main_window.py` 双方都改过(238 行差异),冲突解决时若简单取一边,会静默回退这些安全修复。PR 描述的 947 passed 是在**旧基线**上跑的,不覆盖合并后的代码。建议:rebase 到当前 main(`2cf526e`)→ 解决冲突 → 重跑双方回归(重点 `tests/v1_1/test_safe_user_stop.py`、`test_batch_runtime.py`、`test_missing_uid_inventory.py`、`test_supervisor_evidence.py`)→ 再请求合并。 ### 其他发现 **[P2] 「强制结束」被移入「更多操作」菜单,降低异常场景下的可发现性。** `run_panel.py:50-53` 把 `force_stop_button` 从主按钮行移入 `CommandMenu`(`dsh`/诊断/清理/历史/重置也一并移入)。门禁仍通过 `sync()` 生效(`action.setEnabled(button.isEnabled())`、`setVisible(not button.isHidden())`),但强制结束是主操作挂起时的安全逃生口;藏进二级菜单会让操作员在故障现场更难找到。建议活跃执行时仍将「强制结束…」保留在主按钮行,或给「更多操作」按钮加显著状态提示。 **[P3] Acrylic 依赖未文档化的 `SetWindowCompositionAttribute`(WCA_ACCENT_POLICY=19),Win11 未走系统 backdrop。** `material.py:60-76` 使用 legacy accent policy;`available()`(`:33`)只判断 build ≥ 17763,未区分 Win11 的 `DwmSetWindowAttribute(SYSTEMBACKDROP_TYPE)` 路径。在 Win11 最大化/多显示器/远程会话下该接口可能失效或产生黑边。当前有 opaque fallback、高对比度与远程会话降级、以及截图差分验收(`tools/accept_acrylic_ui.py` 断言 sidebar/header 背景差分 > 2、表格 < 1.5),风险可控;建议补充 Win11 专用路径或在文档中写明支持矩阵。 **[P3] `MaterialMainWindow.paintEvent` 硬编码 `#edf1f5`(`material.py:19-24`)。** fallback 颜色未与 `styles.py` 调色板共享常量;深色/高对比度主题下可能产生色差。建议引用统一主题色,并在高对比度时使用系统色。 **[P3] `AcrylicController._poll` 每 2 秒读取注册表 + SPI(`material.py:101-107`)。** 窗口可见期间持续轮询,开销小但企业受管环境可能对注册表访问敏感;已有 `WindowActivate` 触发,可考虑降低轮询频率或缓存策略结果。 **[P3] `CommandMenu.add_button` 的 `button.show()` 有时序依赖(`command_menu.py:17`)。** `show()` 会清除既有 hidden 标记;若按钮在菜单构建前已被业务门禁隐藏,菜单动作会短暂显示为可见,直到下一次 `_update_gates()`。当前构造顺序下无实际影响,建议 `sync()` 以显式可见状态为准,避免时序假设。 ### 随分支携带的 DSH 核心(抽查结论) 以下边界设计是扎实的:`launch_environment` 采用环境变量白名单(`DSH_API_KEY` 仅经 DPAPI 解密后注入,不继承无关凭据);`DX_DSH_READY` 强制 `127.0.0.1`+`http`;工具动作白名单与 `task_id` 绑定、非自动动作强制确认;incident 会话被 `tools.guard` 限制为只读;证据全量 `scrub` + SHA256 manifest;重试预算在变更前以独占文件 + fsync 消费;工单目标 HTTPS 校验、禁重定向、2MB 上限。生产监管层(调度/工单/决策日志等)的进一步问题已在 PR #11 审查中列出,本 PR 合并后需一并继承修复。 ### 做得好的部分 - Acrylic 生命周期完整:仅在支持且系统允许时启用;先遮蔽再切换、批量暂停绘制避免闪屏;句柄重建释放旧合成;所有失败路径回落到不透明表面,并有针对性测试(10 项 material 测试)。 - 图标为原创 SVG,统一 normal/disabled/primary 配色并缓存。 - 业务门禁保留完好:键盘保存会先提交活动单元格编辑(`has_pending_editor`)、干净计划不可重复保存、批量编辑要求选中行、命令菜单只调用 enabled+visible 的按钮;对应 `test_ui_polish.py` 13 项覆盖。 ### 结论 **Request changes。** 两件 P1 必须处理:(a) 修正 PR 范围声明或拆分;(b) rebase 到当前 main、解决冲突并重跑合并后的回归。UI 打磨本身质量良好(Acrylic 回退、门禁保持、截图差分验收);处理 P1 后可按 P2/P3 逐项收敛再合并。
abaishu0730 added 2 commits 2026-10-31 14:22:23 +08:00
abaishu0730 changed title from feat(ui): refine acrylic task center workspace to feat: integrate DSH assistant core and Acrylic task workspace 2026-10-31 14:22:35 +08:00
Author
Owner

审查提交:6f9f820f85de058362934cfadc184aa02b268a42,基分支 main:2cf526e1769f354cd7e57861c4b0df9f165565dd。

Request changes:发现 1 项 P1、1 项 P2,均已在最新提交独立复现。

已核实本轮主线同步:当前 head 包含 main,API 的 mergeable=true;此前 main_window 冲突已解决。PR 说明已补全 DSH 范围,“强制结束”也已移回主按钮行。本轮不重复列这些已处理的问题,以下两项来自本 PR 引入的 DSH 基础功能。

[P1] 将用户停止意图传递到自动诊断/重试,不能创建未停止的新控制对象。

位置:dsh_automation.py:85–93,以及 main_window.py:743–753。

当用户在最后一个步骤运行期间点击“完成当前项后暂停”,且该步骤最终返回可重试的 batch_failed,底层队列可能已经耗尽,因此 result.paused=False,但原始 StopControl 已经 set。_show_batch_result() 先调用 _finish_run() 清除原控制对象,再对失败项排入自动诊断;_drain() 创建全新的 StopControl,仍携带原执行授权。这样 IncidentRunner 的 not_stopped 门禁会错误通过,一旦模型建议 retry,就会再次准备并执行失败任务,无需用户重新确认。一次重试额度不能替代用户停止意图。

独立复现使用真实 TaskCenterService/批次执行、窗口 _pause_queue()、_show_batch_result()、DshAutomation 和 IncidentRunner:以执行器替身在最后一步返回 batch_failed 前调用真实暂停按钮处理函数,再给诊断器返回 retry 建议,最终执行器实际被调用 2 次;预期停止后仅 1 次。不请求暂停的对照用例允许两次调用并通过。模型、CAD 进程和工单传输均使用替身,未操作真实工程。

请在 _finish_run() 前保存并传递原执行轮次的停止/强制结束状态,自动介入只能诊断或上报,直到用户重新授权执行;单任务和批次失败回调都应保留该状态。不能只判断 result.paused 或数据库中的业务状态,需要覆盖“最后一个失败项完成时停止事件已设置”的回归。

[P2] 使用增量 UTF-8 解码或先按字节组装完整协议行。

位置:dsh_native.py:146–149。

QProcess 的 readyReadStandardOutput 不保证一次提供完整字符。当前代码对每块字节分别 decode('utf8', 'replace'),随后才拼接文本;Node 通过 JSON.stringify 输出的中文不会自动变成 ASCII 转义。中文字符跨块时,每块会被替换为 U+FFFD,后续仍能解析 JSON,因此错误文本会进入任务名称、工程目录、自定义 Value 或诊断证据。将一条合法 CREATE_REQUEST 在“电”的第一个 UTF-8 字节后切成两块并调用生产 _stdout(),电阻替换 实际变成 ���阻替换;完整单块对照通过。建议使用持续的 incremental decoder,或保留 bytes 到换行后一次解码,并在重启时清理残留状态。

验证记录:

  • 最新 head:python -m pytest -q tests/v1_1 tests/ui tests/dsh --ignore=tests/ui/test_pr10_review_edges.py --tb=short:1084 passed,1 warning(已有 pywinauto STA 提示)。ignore 仅排除本次新增的审查故障注入文件,没有忽略仓库自带测试。
  • 最新 head:python -m pytest -q tests/packaging --tb=short:2 passed,与上项合计 1086 passed。
  • 额外边界复现:2 failed / 2 passed,分别为停止意图丢失、UTF-8 分块损坏及其正常对照。
  • Python compileall、Node 三个运行脚本语法检查、git diff --check 2cf526e 6f9f820 通过。

审查使用从 Git 精确提交导出的独立目录;未修改主工作区未提交内容或 PR 源码。本次未重建便携 EXE、未做真实 CAD/模型验收,也未新建测试工单。

审查提交:`6f9f820f85de058362934cfadc184aa02b268a42`,基分支 main:`2cf526e1769f354cd7e57861c4b0df9f165565dd`。 **Request changes:发现 1 项 P1、1 项 P2,均已在最新提交独立复现。** 已核实本轮主线同步:当前 head 包含 main,API 的 `mergeable=true`;此前 main_window 冲突已解决。PR 说明已补全 DSH 范围,“强制结束”也已移回主按钮行。本轮不重复列这些已处理的问题,以下两项来自本 PR 引入的 DSH 基础功能。 **[P1] 将用户停止意图传递到自动诊断/重试,不能创建未停止的新控制对象。** 位置:[dsh_automation.py:85–93](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/6f9f820f85de058362934cfadc184aa02b268a42/src/dx_productivity/trial_task_center/ui/dsh_automation.py#L85),以及 `main_window.py:743–753`。 当用户在最后一个步骤运行期间点击“完成当前项后暂停”,且该步骤最终返回可重试的 `batch_failed`,底层队列可能已经耗尽,因此 `result.paused=False`,但原始 StopControl 已经 set。`_show_batch_result()` 先调用 `_finish_run()` 清除原控制对象,再对失败项排入自动诊断;`_drain()` 创建全新的 StopControl,仍携带原执行授权。这样 IncidentRunner 的 `not_stopped` 门禁会错误通过,一旦模型建议 retry,就会再次准备并执行失败任务,无需用户重新确认。一次重试额度不能替代用户停止意图。 独立复现使用真实 TaskCenterService/批次执行、窗口 `_pause_queue()`、`_show_batch_result()`、DshAutomation 和 IncidentRunner:以执行器替身在最后一步返回 `batch_failed` 前调用真实暂停按钮处理函数,再给诊断器返回 retry 建议,最终执行器实际被调用 **2 次**;预期停止后仅 **1 次**。不请求暂停的对照用例允许两次调用并通过。模型、CAD 进程和工单传输均使用替身,未操作真实工程。 请在 `_finish_run()` 前保存并传递原执行轮次的停止/强制结束状态,自动介入只能诊断或上报,直到用户重新授权执行;单任务和批次失败回调都应保留该状态。不能只判断 `result.paused` 或数据库中的业务状态,需要覆盖“最后一个失败项完成时停止事件已设置”的回归。 **[P2] 使用增量 UTF-8 解码或先按字节组装完整协议行。** 位置:[dsh_native.py:146–149](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/6f9f820f85de058362934cfadc184aa02b268a42/src/dx_productivity/trial_task_center/ui/dsh_native.py#L146)。 QProcess 的 `readyReadStandardOutput` 不保证一次提供完整字符。当前代码对每块字节分别 `decode('utf8', 'replace')`,随后才拼接文本;Node 通过 JSON.stringify 输出的中文不会自动变成 ASCII 转义。中文字符跨块时,每块会被替换为 U+FFFD,后续仍能解析 JSON,因此错误文本会进入任务名称、工程目录、自定义 Value 或诊断证据。将一条合法 CREATE_REQUEST 在“电”的第一个 UTF-8 字节后切成两块并调用生产 `_stdout()`,`电阻替换` 实际变成 `���阻替换`;完整单块对照通过。建议使用持续的 incremental decoder,或保留 bytes 到换行后一次解码,并在重启时清理残留状态。 验证记录: - 最新 head:`python -m pytest -q tests/v1_1 tests/ui tests/dsh --ignore=tests/ui/test_pr10_review_edges.py --tb=short`:**1084 passed,1 warning**(已有 pywinauto STA 提示)。ignore 仅排除本次新增的审查故障注入文件,没有忽略仓库自带测试。 - 最新 head:`python -m pytest -q tests/packaging --tb=short`:**2 passed**,与上项合计 **1086 passed**。 - 额外边界复现:**2 failed / 2 passed**,分别为停止意图丢失、UTF-8 分块损坏及其正常对照。 - Python compileall、Node 三个运行脚本语法检查、`git diff --check 2cf526e 6f9f820` 通过。 审查使用从 Git 精确提交导出的独立目录;未修改主工作区未提交内容或 PR 源码。本次未重建便携 EXE、未做真实 CAD/模型验收,也未新建测试工单。
abaishu0730 added 1 commit 2026-10-31 14:50:14 +08:00
Author
Owner

复审(PR #10,head 6f9f820,相对 058a88b 增量 +3029/−201)

上轮 2 项 P1、1 项 P2、4 项 P3 已逐项核对:

上轮问题 复核结果
P1 PR 范围与标题/描述不符 ✅ 标题改为 feat: integrate DSH assistant core and Acrylic task workspace,描述完整列出 DSH 核心、安装依赖、安全边界与部署限制;与分支实际内容一致
P1 落后 main 8 个提交 + 冲突 ✅ 合并提交 a41c6cf 引入 main 2cf526e;git merge-base = 2cf526e,mergeable=True;batch_supervisor.py/batch_runtime.py/supervisor_evidence.py/stop_control.py/worker_monitor.py/isolated_cad.py/isolated_desktop.py/ui/resource_status.py 与 main 逐字节一致,active_task 落盘修复、身份/快照安全修复均未丢失;main_window.py 冲突联合保留了 _resource_status、force_event/_force_batch_stop 与活动单元格门禁
P2 强制结束入口隐藏 ✅ run_panel.py 已把 force_stop_button 放回主按钮行;新增 test_force_stop_is_directly_visible_during_execution_at_minimum_size 覆盖 980×700
P3 Acrylic legacy API / Win11 ✅ docs/user/frosted-ui.md 新增支持矩阵,明确 legacy accent API 依赖、Win11 DWM 实验结论与未验证环境
P3 回退色硬编码 ✅ 新增 ui/theme.py 共享 WINDOW_BACKGROUND,QSS 与 paintEvent 共用;高对比度时撤下自定义样式改用系统调色板,并覆盖聚焦搜索框/标题/任务文字
P3 2 秒轮询 ✅ 降为 30 秒;隐藏窗口不读注册表/SPI;新增 ApplicationPaletteChange 与 isValid/QObject context 保护
P3 菜单 hidden 时序 ✅ 用 WA_WState_ExplicitShowHide 保留注册前的明确隐藏状态,首次同步前动作也不可见

独立验证

  • python -m pytest -q tests/v1_1 tests/ui tests/dsh tests/integration:1556 passed,1 skipped(真实 7.9.5 type library 缺失,预期跳过),0 failed。
  • git merge-tree origin/main origin/codex/ui-update 无冲突。
  • docs/reviews/2026-10-30-ui/pr10-review-fixes.md 与本轮代码一致;docs/user/frosted-ui.md 支持矩阵诚实。

结论

Approve。 上轮阻断项全部关闭,安全关键文件与 main 完全一致,UI 修复有专项测试与截图验收。仍需在合并后按描述执行真实 DxDesigner / 打包 EXE 现场验收;合并顺序建议 #10 先入 main,#11 再 rebase。

## 复审(PR #10,head `6f9f820`,相对 `058a88b` 增量 +3029/−201) 上轮 **2 项 P1、1 项 P2、4 项 P3** 已逐项核对: | 上轮问题 | 复核结果 | |---|---| | P1 PR 范围与标题/描述不符 | ✅ 标题改为 `feat: integrate DSH assistant core and Acrylic task workspace`,描述完整列出 DSH 核心、安装依赖、安全边界与部署限制;与分支实际内容一致 | | P1 落后 main 8 个提交 + 冲突 | ✅ 合并提交 `a41c6cf` 引入 main `2cf526e`;`git merge-base` = `2cf526e`,**mergeable=True**;`batch_supervisor.py`/`batch_runtime.py`/`supervisor_evidence.py`/`stop_control.py`/`worker_monitor.py`/`isolated_cad.py`/`isolated_desktop.py`/`ui/resource_status.py` 与 main **逐字节一致**,active_task 落盘修复、身份/快照安全修复均未丢失;`main_window.py` 冲突联合保留了 `_resource_status`、`force_event`/`_force_batch_stop` 与活动单元格门禁 | | P2 强制结束入口隐藏 | ✅ `run_panel.py` 已把 `force_stop_button` 放回主按钮行;新增 `test_force_stop_is_directly_visible_during_execution_at_minimum_size` 覆盖 980×700 | | P3 Acrylic legacy API / Win11 | ✅ `docs/user/frosted-ui.md` 新增支持矩阵,明确 legacy accent API 依赖、Win11 DWM 实验结论与未验证环境 | | P3 回退色硬编码 | ✅ 新增 `ui/theme.py` 共享 `WINDOW_BACKGROUND`,QSS 与 `paintEvent` 共用;高对比度时撤下自定义样式改用系统调色板,并覆盖聚焦搜索框/标题/任务文字 | | P3 2 秒轮询 | ✅ 降为 30 秒;隐藏窗口不读注册表/SPI;新增 `ApplicationPaletteChange` 与 `isValid`/QObject context 保护 | | P3 菜单 hidden 时序 | ✅ 用 `WA_WState_ExplicitShowHide` 保留注册前的明确隐藏状态,首次同步前动作也不可见 | ### 独立验证 - `python -m pytest -q tests/v1_1 tests/ui tests/dsh tests/integration`:**1556 passed,1 skipped**(真实 7.9.5 type library 缺失,预期跳过),0 failed。 - `git merge-tree origin/main origin/codex/ui-update` 无冲突。 - `docs/reviews/2026-10-30-ui/pr10-review-fixes.md` 与本轮代码一致;`docs/user/frosted-ui.md` 支持矩阵诚实。 ### 结论 **Approve。** 上轮阻断项全部关闭,安全关键文件与 main 完全一致,UI 修复有专项测试与截图验收。仍需在合并后按描述执行真实 DxDesigner / 打包 EXE 现场验收;合并顺序建议 #10 先入 main,#11 再 rebase。
Author
Owner

复审提交:0bc1f64edc53b621305ce0e5e0da535316933776;相对上轮 6f9f820 检查新增修复和调用路径。

建议通过(Approve):评论 117 的 P1、P2 已修复,本轮未发现新的阻断问题。

  • 原执行 StopControl 在 _finish_run() 后仍保留,入队诊断时传入原对象,_drain() 不再用未停止的新对象覆盖它。单任务、批次以及异常回调均覆盖暂停/强制结束状态;重新原生授权开始新轮次后才使用新控制对象。
  • stdout/stderr 改为持续的增量 UTF-8 解码,运行时重启清理残留文本和解码状态。新增回归覆盖中文、emoji 的每个字节切点、多行单字节输入和重启残片。

本次在精确 Git head 的独立导出目录运行:

  • python -m pytest -q tests/v1_1 tests/ui tests/dsh tests/packaging --tb=short:1101 passed,1 warning(已有 pywinauto STA COM 提示)。其中包含新增的 15 项停止意图、重授权及协议边界回归。
  • python -m compileall -q src、增量及相对 main 的 git diff --check 通过。

当前 main 为 2cf526e,已包含在该 head 中;API 返回可合并。本次为代码与自动化复审,未运行真实用户 CAD、真实模型、远端测试工单或冻结 EXE 验收。以上是评论中的审查建议,未执行合并。

复审提交:`0bc1f64edc53b621305ce0e5e0da535316933776`;相对上轮 `6f9f820` 检查新增修复和调用路径。 **建议通过(Approve):评论 117 的 P1、P2 已修复,本轮未发现新的阻断问题。** - 原执行 StopControl 在 `_finish_run()` 后仍保留,入队诊断时传入原对象,`_drain()` 不再用未停止的新对象覆盖它。单任务、批次以及异常回调均覆盖暂停/强制结束状态;重新原生授权开始新轮次后才使用新控制对象。 - stdout/stderr 改为持续的增量 UTF-8 解码,运行时重启清理残留文本和解码状态。新增回归覆盖中文、emoji 的每个字节切点、多行单字节输入和重启残片。 本次在精确 Git head 的独立导出目录运行: - `python -m pytest -q tests/v1_1 tests/ui tests/dsh tests/packaging --tb=short`:**1101 passed,1 warning**(已有 pywinauto STA COM 提示)。其中包含新增的 15 项停止意图、重授权及协议边界回归。 - `python -m compileall -q src`、增量及相对 main 的 `git diff --check` 通过。 当前 main 为 `2cf526e`,已包含在该 head 中;API 返回可合并。本次为代码与自动化复审,未运行真实用户 CAD、真实模型、远端测试工单或冻结 EXE 验收。以上是评论中的审查建议,未执行合并。
Author
Owner

深入审查(PR #10,head 0bc1f64,相对 6f9f820 增量 +265/−9)

上轮及评论 117 的结论复核(全部关闭)

  • ✅ 停止意图传递:_dsh_run_stop 在 _begin_run/_finish_run 保存原 StopControl,_queue_dsh_incident 传入原对象,DshAutomation._drain 不再用新对象覆盖;暂停/强制结束状态贯穿单任务、批次与异常回调;重新原生授权才产生新控制对象。新增 tests/ui/test_pr10_review_edges.py 覆盖 last-item 暂停且 paused=False 的边界(单任务/批次 × none/pause/force/重授权)。
  • ✅ UTF-8 分块:dsh_native 改用持久 incremental decoder,_reset_output() 在构造和每次启动时清理;中文/emoji 任意字节切点、多行单字节、重启残片均有回归。
  • ✅ 上轮 P1/P2/P3(范围声明、main 同步、强制结束入口、主题色、轮询、菜单 hidden)保持修复状态。

独立验证

  • python -m pytest -q tests/v1_1 tests/ui tests/dsh tests/integration @ 0bc1f64:1571 passed,1 skipped(真实 7.9.5 type library 缺失,预期跳过),0 failed。
  • 新边界文件单独运行:15 passed。
  • 独立探针:将一条含「电阻替换」的 DX_DSH_CREATE_REQUEST 按逐字节切分喂给生产 _stdout,完整还原中文(非仓库自带测试)。
  • 交叉版本检查:本分支 dsh_automation 未引用 #11 专属的 _dsh_lifecycle/_dsh_operations,单独部署无 AttributeError。
  • git merge-base origin/main origin/codex/ui-update = 2cf526e,mergeable;安全关键文件与 main 一致。

新发现(均为非阻断 P3)

  1. dsh_native._stdout 无逐行异常保护:json.loads(line[...]) 对畸形协议行抛异常会中断整个 Qt 槽,且 self._buffer 已把同批次后续完整行取走 → 后续合法协议行被静默丢弃。子进程是本地可信组件,风险低;建议逐行 try/except + 记录并继续。
  2. provider_config.save_provider 元数据非原子写:DPAPI 密钥文件用了临时文件 + replace,但 provider.json 仍是直接 write_text;崩溃可能留下截断 JSON,load_provider 抛错后 DSH 只显示通用的"模型配置不可用"。建议同样用临时文件 + os.replace。

结论

Approve。 评论 117 的 P1/P2 已闭环,主分支同步完整,安全关键文件零差异,全量 1571 项通过。两条 P3 可在合并前后择机处理;真实 DxDesigner / 冻结 EXE / 真实模型与工单仍属现场验收前置条件。

## 深入审查(PR #10,head `0bc1f64`,相对 `6f9f820` 增量 +265/−9) ### 上轮及评论 117 的结论复核(全部关闭) - ✅ **停止意图传递**:`_dsh_run_stop` 在 `_begin_run`/`_finish_run` 保存原 StopControl,`_queue_dsh_incident` 传入原对象,`DshAutomation._drain` 不再用新对象覆盖;暂停/强制结束状态贯穿单任务、批次与异常回调;重新原生授权才产生新控制对象。新增 `tests/ui/test_pr10_review_edges.py` 覆盖 last-item 暂停且 `paused=False` 的边界(单任务/批次 × none/pause/force/重授权)。 - ✅ **UTF-8 分块**:`dsh_native` 改用持久 incremental decoder,`_reset_output()` 在构造和每次启动时清理;中文/emoji 任意字节切点、多行单字节、重启残片均有回归。 - ✅ 上轮 P1/P2/P3(范围声明、main 同步、强制结束入口、主题色、轮询、菜单 hidden)保持修复状态。 ### 独立验证 - `python -m pytest -q tests/v1_1 tests/ui tests/dsh tests/integration` @ `0bc1f64`:**1571 passed,1 skipped**(真实 7.9.5 type library 缺失,预期跳过),0 failed。 - 新边界文件单独运行:**15 passed**。 - 独立探针:将一条含「电阻替换」的 `DX_DSH_CREATE_REQUEST` 按**逐字节**切分喂给生产 `_stdout`,完整还原中文(非仓库自带测试)。 - 交叉版本检查:本分支 `dsh_automation` 未引用 #11 专属的 `_dsh_lifecycle`/`_dsh_operations`,单独部署无 AttributeError。 - `git merge-base origin/main origin/codex/ui-update` = `2cf526e`,mergeable;安全关键文件与 main 一致。 ### 新发现(均为非阻断 P3) 1. **`dsh_native._stdout` 无逐行异常保护**:`json.loads(line[...])` 对畸形协议行抛异常会中断整个 Qt 槽,且 `self._buffer` 已把同批次后续完整行取走 → 后续合法协议行被静默丢弃。子进程是本地可信组件,风险低;建议逐行 try/except + 记录并继续。 2. **`provider_config.save_provider` 元数据非原子写**:DPAPI 密钥文件用了临时文件 + replace,但 `provider.json` 仍是直接 `write_text`;崩溃可能留下截断 JSON,`load_provider` 抛错后 DSH 只显示通用的"模型配置不可用"。建议同样用临时文件 + `os.replace`。 ### 结论 **Approve。** 评论 117 的 P1/P2 已闭环,主分支同步完整,安全关键文件零差异,全量 1571 项通过。两条 P3 可在合并前后择机处理;真实 DxDesigner / 冻结 EXE / 真实模型与工单仍属现场验收前置条件。
abaishu0730 added 1 commit 2026-10-31 20:10:57 +08:00
Author
Owner

复审提交:dfbc14c081dc5ecec4772ca25d68a60a422795ba,相对上轮 0bc1f64。

建议修复后合并(Request changes):本轮确认 1 项 P2。 原停止意图、UTF-8 增量解码修复保持有效;新协议逐行校验可隔离畸形 JSON 并继续处理后续消息,且不会把原始坏行写入诊断。provider.json 的临时文件、flush/fsync/replace 避免截断,但仍缺少配置与密钥的一致性提交。

[P2] 元数据发布失败时,不能保留旧服务器地址却替换成新密钥。

位置:provider_config.py:23–29,关联同文件 15–19 行。

save_provider() 先替换 provider-key.dpapi,再发布 provider.json。更换提供方且后一步 replace/fsync/写入失败时,旧 JSON 被保留下来,但新密钥已经生效。随后 load_provider() 不会发现它们来自两次不同配置,返回旧 DSH_API_BASE 与新 DSH_API_KEY;重启 DSH 会把新密钥交给旧提供方端点,通常还会造成鉴权失败。此问题是配置对的一致性缺口,不是声称单个 JSON 仍会被截断。

独立故障注入使用真实 DPAPI 与生产 save/load 函数、临时目录和虚构密钥:先保存 old-provider/old-key,再保存 new-provider/new-key,仅让 provider.json 的 os.replace 抛 OSError。捕获错误后,实际加载得到 old-provider/new-key;无故障对照得到正确的新配置。没有使用真实凭据或发出模型网络请求。当前新增测试复用了相同的 api_key,所以没有覆盖跨提供方切换。

建议用单个受 DPAPI 保护的配置对象,或版本化密钥文件加最后一次原子发布的配置指针,使 URL/模型/密钥来自同一版本;失败后应保留完整旧版本或明确拒绝加载,而不能返回混合配置。请增加同时改变 base_url 和 api_key 的发布失败回归。

验证:

  • 精确 head 的 tests/dsh tests/ui tests/packaging tests/v1_1/test_task_queue.py tests/v1_1/test_safe_user_stop.py:187 passed。
  • 额外配置一致性探针:1 failed / 1 passed(发布失败与正常切换对照)。
  • compileall 和本轮 git diff --check 通过。

审查使用独立 Git 导出快照,未修改 PR 源码。未重跑完整 integration、真实 CAD、模型或冻结 EXE 验收。

复审提交:`dfbc14c081dc5ecec4772ca25d68a60a422795ba`,相对上轮 `0bc1f64`。 **建议修复后合并(Request changes):本轮确认 1 项 P2。** 原停止意图、UTF-8 增量解码修复保持有效;新协议逐行校验可隔离畸形 JSON 并继续处理后续消息,且不会把原始坏行写入诊断。provider.json 的临时文件、flush/fsync/replace 避免截断,但仍缺少配置与密钥的一致性提交。 **[P2] 元数据发布失败时,不能保留旧服务器地址却替换成新密钥。** 位置:[provider_config.py:23–29](https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement/src/commit/dfbc14c081dc5ecec4772ca25d68a60a422795ba/src/dx_productivity/dsh/provider_config.py#L23),关联同文件 15–19 行。 `save_provider()` 先替换 `provider-key.dpapi`,再发布 `provider.json`。更换提供方且后一步 replace/fsync/写入失败时,旧 JSON 被保留下来,但新密钥已经生效。随后 `load_provider()` 不会发现它们来自两次不同配置,返回旧 `DSH_API_BASE` 与新 `DSH_API_KEY`;重启 DSH 会把新密钥交给旧提供方端点,通常还会造成鉴权失败。此问题是配置对的一致性缺口,不是声称单个 JSON 仍会被截断。 独立故障注入使用真实 DPAPI 与生产 save/load 函数、临时目录和虚构密钥:先保存 old-provider/old-key,再保存 new-provider/new-key,仅让 `provider.json` 的 `os.replace` 抛 OSError。捕获错误后,实际加载得到 **old-provider/new-key**;无故障对照得到正确的新配置。没有使用真实凭据或发出模型网络请求。当前新增测试复用了相同的 api_key,所以没有覆盖跨提供方切换。 建议用单个受 DPAPI 保护的配置对象,或版本化密钥文件加最后一次原子发布的配置指针,使 URL/模型/密钥来自同一版本;失败后应保留完整旧版本或明确拒绝加载,而不能返回混合配置。请增加同时改变 base_url 和 api_key 的发布失败回归。 验证: - 精确 head 的 `tests/dsh tests/ui tests/packaging tests/v1_1/test_task_queue.py tests/v1_1/test_safe_user_stop.py`:**187 passed**。 - 额外配置一致性探针:**1 failed / 1 passed**(发布失败与正常切换对照)。 - `compileall` 和本轮 `git diff --check` 通过。 审查使用独立 Git 导出快照,未修改 PR 源码。未重跑完整 integration、真实 CAD、模型或冻结 EXE 验收。
abaishu0730 added 1 commit 2026-10-31 21:25:36 +08:00
Author
Owner

复审提交:da1806f7456da0bb35c8724036720aa796df2ebf,相对上轮 dfbc14c。

建议通过(Approve):评论 134 的配置/密钥一致性问题已修复,本轮未发现新的阻断问题。

  • 每次保存先写入独立的版本化 DPAPI 密钥并 flush/fsync,再以 provider.json 的原子替换作为唯一提交点。元数据发布前失败会保留完整旧配置,清理未发布的新文件;不会再组成“旧服务器+新密钥”。
  • 已发布旧密钥保留,读取者即使先取得旧元数据、随后遇到另一配置发布,也仍能读取匹配的旧密钥。新格式缺少所引用密钥时明确加载失败,不回退到 legacy key;旧格式兼容加载。
  • 验收工具改为经 load/save 复制完整配置,不再假定固定的密钥文件名。已检索生产代码和工具中的旧文件名引用,相关调用点已同步。

本次在精确 Git head 的独立导出目录验证:

python -m pytest -q tests/dsh/test_provider_config.py tests/dsh/test_native_runtime.py tests/ui/test_pr10_review_edges.py tests/ui/test_dsh_native_menu.py tests/ui/test_dsh_task_creation.py tests/packaging tests/dsh/test_independent_provider_pair.py --tb=short

结果:79 passed。其中 2 项为上轮独立配置探针的原样复验(正常切换及 metadata replace 故障);上轮故障例失败,本轮通过。仓库新增测试还覆盖新旧格式、写入/刷盘/发布失败、并发读取旧快照、缺失/非法 key 引用及首次保存失败。

python -m compileall -q src tools/accept_dsh_desktop.py、增量及相对 main 的 git diff --check 通过。当前 API 返回可合并。

本次仅运行与改动相关的回归,没有把 PR 自述的全量 1146 项当作本次独立结果。仅使用临时目录和虚构密钥,未修改实际 provider 配置、未调用模型、真实 CAD 或远端测试工单,也未重建 EXE。未执行合并。

复审提交:`da1806f7456da0bb35c8724036720aa796df2ebf`,相对上轮 `dfbc14c`。 **建议通过(Approve):评论 134 的配置/密钥一致性问题已修复,本轮未发现新的阻断问题。** - 每次保存先写入独立的版本化 DPAPI 密钥并 flush/fsync,再以 `provider.json` 的原子替换作为唯一提交点。元数据发布前失败会保留完整旧配置,清理未发布的新文件;不会再组成“旧服务器+新密钥”。 - 已发布旧密钥保留,读取者即使先取得旧元数据、随后遇到另一配置发布,也仍能读取匹配的旧密钥。新格式缺少所引用密钥时明确加载失败,不回退到 legacy key;旧格式兼容加载。 - 验收工具改为经 load/save 复制完整配置,不再假定固定的密钥文件名。已检索生产代码和工具中的旧文件名引用,相关调用点已同步。 本次在精确 Git head 的独立导出目录验证: `python -m pytest -q tests/dsh/test_provider_config.py tests/dsh/test_native_runtime.py tests/ui/test_pr10_review_edges.py tests/ui/test_dsh_native_menu.py tests/ui/test_dsh_task_creation.py tests/packaging tests/dsh/test_independent_provider_pair.py --tb=short` 结果:**79 passed**。其中 2 项为上轮独立配置探针的原样复验(正常切换及 metadata replace 故障);上轮故障例失败,本轮通过。仓库新增测试还覆盖新旧格式、写入/刷盘/发布失败、并发读取旧快照、缺失/非法 key 引用及首次保存失败。 `python -m compileall -q src tools/accept_dsh_desktop.py`、增量及相对 main 的 `git diff --check` 通过。当前 API 返回可合并。 本次仅运行与改动相关的回归,没有把 PR 自述的全量 1146 项当作本次独立结果。仅使用临时目录和虚构密钥,未修改实际 provider 配置、未调用模型、真实 CAD 或远端测试工单,也未重建 EXE。未执行合并。
Author
Owner

复审(PR #10,head dfbc14c,相对 0bc1f64 增量 +189/−26)

上轮两条 P3 复核:均已修复

  • ✅ 协议行隔离:dsh_native._stdout 改为 prefix, _, payload = line.partition(' ') + 前缀白名单(READY/DIAGNOSIS/CREATE_REQUEST/CREATE_CANCEL/ACTION)+ 逐行 try/except;坏行不再中断后续合法行,错误信息不保留原始协议文本(注释明确可能含凭据/用户数据)。新增 3 项故障注入(坏行后仍有合法消息、不完整 READY 行不丢后续 DIAGNOSIS、坏行不阻塞本地握手)。
  • ✅ 元数据原子发布:provider_config.save_provider 改用 NamedTemporaryFile(delete=False) + fsync + os.replace,失败时清理临时文件;新增 3 项注入(replace 失败、flush 失败、部分写入不截断已发布 JSON)。
  • 额外核对:白名单与 integration/dsh 实际发出的全部 stdout 前缀一一对应,无静默丢弃风险;DX_DSH_* 其余名称均为环境变量。

独立验证

  • python -m pytest -q tests/v1_1 tests/ui tests/dsh tests/integration @ dfbc14c:1598 passed,1 skipped(真实 7.9.5 type library 缺失,预期跳过),0 failed。
  • git merge-base origin/main origin/codex/ui-update = 2cf526e(main 为祖先),API mergeable=true;无冲突标记。

结论

Approve。 上轮全部意见闭环,无新阻断问题。剩余仅现场验收项(真实 DxDesigner、真实模型/工单、冻结 EXE),与代码质量无关。

## 复审(PR #10,head `dfbc14c`,相对 `0bc1f64` 增量 +189/−26) ### 上轮两条 P3 复核:均已修复 - ✅ **协议行隔离**:`dsh_native._stdout` 改为 `prefix, _, payload = line.partition(' ')` + 前缀白名单(READY/DIAGNOSIS/CREATE_REQUEST/CREATE_CANCEL/ACTION)+ 逐行 try/except;坏行不再中断后续合法行,错误信息**不保留原始协议文本**(注释明确可能含凭据/用户数据)。新增 3 项故障注入(坏行后仍有合法消息、不完整 READY 行不丢后续 DIAGNOSIS、坏行不阻塞本地握手)。 - ✅ **元数据原子发布**:`provider_config.save_provider` 改用 `NamedTemporaryFile(delete=False)` + `fsync` + `os.replace`,失败时清理临时文件;新增 3 项注入(replace 失败、flush 失败、部分写入不截断已发布 JSON)。 - 额外核对:白名单与 `integration/dsh` 实际发出的全部 stdout 前缀一一对应,无静默丢弃风险;`DX_DSH_*` 其余名称均为环境变量。 ### 独立验证 - `python -m pytest -q tests/v1_1 tests/ui tests/dsh tests/integration` @ `dfbc14c`:**1598 passed,1 skipped**(真实 7.9.5 type library 缺失,预期跳过),0 failed。 - `git merge-base origin/main origin/codex/ui-update` = `2cf526e`(main 为祖先),API `mergeable=true`;无冲突标记。 ### 结论 **Approve。** 上轮全部意见闭环,无新阻断问题。剩余仅现场验收项(真实 DxDesigner、真实模型/工单、冻结 EXE),与代码质量无关。
abaishu0730 merged commit 3ec395046b into main 2026-11-01 21:47:59 +08:00
Author
Owner

回审已合并 PR #10(feat: integrate DSH assistant core and Acrylic task workspace)

merge 3ec3950,first-parent diff 211 文件 +18,448/−104(仓库最大一次合并)。按风险抽查,不逐行读;行号按 origin/main(aff228e)复核。

结论:合并质量可以接受(边界控制优于同类:模型只有 2 类工具、8 道门禁、无 shell=True、凭据走 DPAPI 原子发布、证据白名单脱敏)。没有 P1;但两条"数据离开本机"的路径建议尽快定策略(P2×2)。


P2-1 共享的 write:issue 令牌被打进安装包,随包分发

  • tools/provision_dsh_issue_reporter.py:113-117:把 token、token_id、scopes:['write:issue'] 写进 integration/dsh/issue-bootstrap.json,并在同一次运行里生成报告(restricted_account: True、issuer_only_local_dpapi: True)。
  • packaging/DxPartReplace.spec:34-40:把 issue-bootstrap.json 列为必需文件并复制进 dsh-runtime。
  • src/dx_productivity/dsh/issue_credentials.py:14:frozen 后从 sys._MEIPASS/dsh-runtime/issue-bootstrap.json 读取。

后果:任何拿到安装包的人都能解出这个 bot 令牌,用它向仓库提 issue(scope 仅 write:issue,缓解了影响面)。它不是机器绑定,也无法按单台撤销——只能整体换令牌。

建议:首选改为"按安装/按机器签发"(首次启动时向内部端点换一次性令牌,DPAPI 存本机);做不到的话,至少把包内令牌视为"公开凭据",在文档里写明泄漏假设 + 轮换流程,并给该 bot 账号加上频率/标签限制。

P2-2 工程标识会离开本机(模型与内网工单)

  • src/dx_productivity/dsh/evidence.py:63-77:excerpt() 取 tasks/<task_id>/events.jsonl 尾部 16 KB 加 snapshot.json,scrub 后作为模型输入。scrub 剥的是凭据与用户 home,不剥工程路径、料号、命名。
  • src/dx_productivity/dsh/git_issues.py:74-89:把 issue.md 正文与 issuedir/<incident>-evidence.zip(上限 70 MB)提交到内网 Gitea issue。

后果:客户工程的目录名/料号/零件名会进入模型请求,并落到内网工单附件。对内部工具未必不可接受,但需要明确同意 + 明确数据分级,而现在文档措辞容易被读成"不含工程信息"。

建议:①在首次启用 AI 介入时给一次明确的"会发送哪些内容"提示;②默认把工程路径替换为 <project>、料号保留但可选;③issue.md 顶部自动生成"数据分类:不含/含工程标识"一行,让读工单的人知道边界。

P3

  1. 不变量与实现矛盾:src/dx_productivity/dsh/incidents.py:84-86 明确注释 "This local address is never sent as model input or issue body.",但 ui/dsh_automation.py:244-245 把 evidence_dir 放进 _dsh_view.automation,经 /dx/context 与 dx_task_snapshot 提供给模型。绝对路径(含用户名)实际是模型可见的。建议二选一:从 context 里移除,或改掉那句注释并在文档里承认。
  2. 默认测试集合不含安全关键目录:pyproject.toml 的 testpaths = ["tests/v1_1", "tests/ui"],不包含 tests/dsh(23 个文件)。CI 里显式跑了其中 7 个,但开发者本地 pytest 默认不会跑。建议把 tests/dsh 加进 testpaths,或加一个 CI job 全跑。
  3. 旧版 provider-key-*.dpapi 没有回收路径:凭据换代后旧文件留在用户目录,且 github-material-sources.json 原文收录 GPL-3.0 源码行,需要一次合规确认(本项只提出,不做结论)。

验证记录

  • 抽查了与数据外发、凭据、子进程、落盘相关的路径:provision_dsh_issue_reporter.py、DxPartReplace.spec、issue_credentials.py、evidence.py、git_issues.py、incidents.py、dsh_automation.py、pyproject.toml,均在 origin/main 上逐行确认。
  • 未跑测试;node_modules 不在克隆中,未做动态验证。

未验证边界

没有真实模型调用或真实 Gitea 上传;未审计全部 211 文件(按风险抽样);GPL 合规与 DPAPI 旧文件清理只做提示。

# 回审已合并 PR #10(`feat: integrate DSH assistant core and Acrylic task workspace`) merge `3ec3950`,first-parent diff **211 文件 +18,448/−104**(仓库最大一次合并)。按风险抽查,不逐行读;行号按 `origin/main`(`aff228e`)复核。 ## 结论:合并质量可以接受(边界控制优于同类:模型只有 2 类工具、8 道门禁、无 `shell=True`、凭据走 DPAPI 原子发布、证据白名单脱敏)。**没有 P1**;但两条"数据离开本机"的路径建议尽快定策略(P2×2)。 --- ## P2-1 共享的 `write:issue` 令牌被打进安装包,随包分发 - `tools/provision_dsh_issue_reporter.py:113-117`:把 `token`、`token_id`、`scopes:['write:issue']` 写进 `integration/dsh/issue-bootstrap.json`,并在同一次运行里生成报告(`restricted_account: True`、`issuer_only_local_dpapi: True`)。 - `packaging/DxPartReplace.spec:34-40`:把 `issue-bootstrap.json` 列为必需文件并复制进 `dsh-runtime`。 - `src/dx_productivity/dsh/issue_credentials.py:14`:frozen 后从 `sys._MEIPASS/dsh-runtime/issue-bootstrap.json` 读取。 **后果**:任何拿到安装包的人都能解出这个 bot 令牌,用它向仓库提 issue(scope 仅 `write:issue`,缓解了影响面)。它**不是机器绑定**,也无法按单台撤销——只能整体换令牌。 **建议**:首选改为"按安装/按机器签发"(首次启动时向内部端点换一次性令牌,DPAPI 存本机);做不到的话,至少把包内令牌视为"公开凭据",在文档里写明泄漏假设 + 轮换流程,并给该 bot 账号加上频率/标签限制。 ## P2-2 工程标识会离开本机(模型与内网工单) - `src/dx_productivity/dsh/evidence.py:63-77`:`excerpt()` 取 `tasks/<task_id>/events.jsonl` **尾部 16 KB** 加 `snapshot.json`,`scrub` 后作为模型输入。`scrub` 剥的是凭据与用户 home,**不剥工程路径、料号、命名**。 - `src/dx_productivity/dsh/git_issues.py:74-89`:把 `issue.md` 正文与 `issuedir/<incident>-evidence.zip`(上限 70 MB)提交到内网 Gitea issue。 **后果**:客户工程的目录名/料号/零件名会进入模型请求,并落到内网工单附件。对内部工具未必不可接受,但需要**明确同意 + 明确数据分级**,而现在文档措辞容易被读成"不含工程信息"。 **建议**:①在首次启用 AI 介入时给一次明确的"会发送哪些内容"提示;②默认把工程路径替换为 `<project>`、料号保留但可选;③`issue.md` 顶部自动生成"数据分类:不含/含工程标识"一行,让读工单的人知道边界。 ## P3 1. **不变量与实现矛盾**:`src/dx_productivity/dsh/incidents.py:84-86` 明确注释 "This local address is never sent as model input or issue body.",但 `ui/dsh_automation.py:244-245` 把 `evidence_dir` 放进 `_dsh_view.automation`,经 `/dx/context` 与 `dx_task_snapshot` 提供给模型。绝对路径(含用户名)实际是模型可见的。建议二选一:从 context 里移除,或改掉那句注释并在文档里承认。 2. **默认测试集合不含安全关键目录**:`pyproject.toml` 的 `testpaths = ["tests/v1_1", "tests/ui"]`,**不包含 `tests/dsh`**(23 个文件)。CI 里显式跑了其中 7 个,但开发者本地 `pytest` 默认不会跑。建议把 `tests/dsh` 加进 `testpaths`,或加一个 CI job 全跑。 3. **旧版 `provider-key-*.dpapi` 没有回收路径**:凭据换代后旧文件留在用户目录,且 `github-material-sources.json` 原文收录 GPL-3.0 源码行,需要一次合规确认(本项只提出,不做结论)。 ## 验证记录 - 抽查了与数据外发、凭据、子进程、落盘相关的路径:`provision_dsh_issue_reporter.py`、`DxPartReplace.spec`、`issue_credentials.py`、`evidence.py`、`git_issues.py`、`incidents.py`、`dsh_automation.py`、`pyproject.toml`,均在 `origin/main` 上逐行确认。 - 未跑测试;`node_modules` 不在克隆中,未做动态验证。 ## 未验证边界 没有真实模型调用或真实 Gitea 上传;未审计全部 211 文件(按风险抽样);GPL 合规与 DPAPI 旧文件清理只做提示。
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#10