Skip to content

[0947] 补全 QML 弹窗 ai-docs 并补登 UpdaterProgress - #4450

Merged
PinkMagicFly merged 2 commits into
mainfrom
pigmagicfly/0947/refresh-qml-ai-docs
Aug 28, 2026
Merged

[0947] 补全 QML 弹窗 ai-docs 并补登 UpdaterProgress#4450
PinkMagicFly merged 2 commits into
mainfrom
pigmagicfly/0947/refresh-qml-ai-docs

Conversation

@PinkMagicFly

Copy link
Copy Markdown
Contributor

背景

ai-docs/qml/README.md 停更于 [0926],其后 [2039](Statistics)、[2040](ConfirmRestart)、[2044](Preferences)、[2080](Version)、[0518](UpdaterProgress)落地的对话框、原子与机制均未入册;且 Preferences.qml 头注释引用的「README 的 Preferences 契约」一节从未存在,代码与文档断链。[0518] 还遗漏了 qml/qmldir 登记、设计稿面板与加载测试。

本 PR 全部为文档 / 登记 / 测试增量,不改动任何对话框的运行时行为(不触碰 [0518] 的功能代码,零影响)。

改动内容

ai-docs/qml/README.md(主体)

  • 成品表 6→10:补 Statistics / Version / Preferences / UpdaterProgress(各自模态引擎、bridge、数据模型)
  • 原子清单 10→12:补 Toggle、GroupHeader;更新 EnumCombo(editable 双击编辑 / isNarrow / actionLabel)、EnumComboList(valueSource 外部真相源双模式)、MiniButton(size 两档)、TabPanel(content reparent 坑)、SelectableList(syncActiveValue)、DialogShell(onCancel/onActivate 可覆盖)
  • 新增「Preferences 契约」节:prefBridge 四态契约(meta / submit / cancel / callAction)+ field-descriptor 全字段表 + utf8→cork 翻译编码注意——补上 Preferences.qml:12 引用却缺失的章节
  • 模态引擎节:补选 show 模态的两种理由(live 重绘;scheme delayed 轮询链不可被 exec 嵌套循环阻塞)、bridge 生命周期两式、autofit_height 与 contentW 绑定坑
  • 开发工作流:写明 glue 声明登记在 src/Scheme/L5/glue_qt.lua(与 CLAUDE.md 所述 src/Scheme/Glue/ 目录不同,避免误导)
  • 测试节:四种桩类说明、8 个 MOGAN_TEST_* 钩子与消费测试对照全表
  • 编码规矩:ConfirmQuestion 按钮反序协议、Theme 常量分段规则、translate 三方分工;pref-keys 表述稳定化(现有 117 个访问器)
  • 相关清单补齐:4 个专用 bridge、L5/glue_qt.lua、7 个 scheme facade

其余

  • ai-docs/qml/qml-dialog.html:补 UpdaterProgress 设计面板(spinner 动画),9→10 面板
  • src/Plugins/Qt/qml/qmldir:补登 UpdaterProgress 1.0(顶层弹窗均经 qrc 直接 setSource 加载,补登仅为消除与登记规矩的矛盾,不影响加载路径)
  • tests/Plugins/Qt/qml_load_test.cpp:新增 test_updater_progress_loads(补上 UpdaterProgress 唯一的测试缺口);文件头「四个成品」过时描述更新为十个

验证

  • xmake b --yes qml_load_test && xmake r qml_load_test16 passed, 0 failed(含新增用例;gf fmt 后复跑通过)
  • README 中 21 处文件引用逐一验证存在;markdown 表格列数脚本校验通过
  • 手动验证建议(可选):浏览器打开 ai-docs/qml/qml-dialog.html,左侧切换到 UpdaterProgress.qml 查看新增面板与转圈动画

后续

0928(QML 调色板)、2085(QML 最近文档)合入后,成品表各需追加一行——本 PR 补全表结构后,追加只是一行改动。

@MoonL79 MoonL79 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@PinkMagicFly
PinkMagicFly merged commit 9ebbdaa into main Aug 28, 2026
6 checks passed
@PinkMagicFly
PinkMagicFly deleted the pigmagicfly/0947/refresh-qml-ai-docs branch August 28, 2026 07:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants