docs: settings dialog for update config (gear entry, not a numbered tab)

A low-key "⚙ 配置" button at the right end of the flow-tab row (separated by
stretch, not a numbered step) opens a settings dialog to edit update_source /
update_user / update_pass, with a test-connection check. Dialog is pure UI;
main_window owns save_config. docs/07 §3/§4.1/§4.3/§4.4; tasks 17.20.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
2026-06-18 11:03:36 +08:00
co-authored by Claude Opus 4.8
parent ac428fb5ec
commit 3327276c9a
2 changed files with 57 additions and 2 deletions
+29 -2
View File
@@ -20,7 +20,7 @@
主窗口采用固定工具型布局(软件名称与版本号由系统窗口标题栏显示,内容区不再单设标题栏):
```text
流程页签
流程页签(左:1/2/3 编号步骤 · 右端:⚙ 配置)
主工作区:左侧素材栏 | 中间预览区 | 右侧参数栏
底部合成队列
底部状态栏
@@ -52,7 +52,6 @@
- 软件名称与版本号通过窗口标题常驻显示,便于用户和管理员确认当前运行版本。
- 不在窗口内容区重复软件名称与版本号——内容区自绘标题栏会与系统标题栏重复,故不设置(除非后续改为无边框窗口、由自绘标题栏取代系统标题栏)。
- 暂不提供「设置」入口:当前可配置项不多,且输出目录/格式/质量在导出面板就地可改。待确有集中设置需求时再加,避免放置点了无反应的占位按钮。
### 4.2 流程页签
@@ -69,6 +68,34 @@
- 未实现页签可以置灰或隐藏。
- 若保留未实现页签,点击时应提示“暂未开放”,不能进入空白页面。
### 4.3 设置入口(更新配置)
在流程页签同一行的**最右端**放一个低调的 `⚙ 配置` 按钮,用 `addStretch()` 与左侧编号页签隔开,使其读作「工具」而非工作流的第 4 步。
要求:
- `配置` 按钮**不是编号页签**,不参与 `1/2/3` 顺序;样式低调(图标 + 文字,悬停出强调色)。
- 点击打开**设置对话框**(`QDialog`,见 4.4),不进入新的内容页(页签栏当前不切换内容面板)。
- 之所以现在提供集中设置入口:在线更新需要配置更新地址与凭据,属于「确有集中设置需求」的情形(区别于之前移除的点了无反应的占位按钮)。
### 4.4 设置对话框
集中编辑在线更新相关配置,对应 `app_config.json` 的 `update_source` / `update_user` / `update_pass`(见 `docs/02-prd.md`、`docs/10-lan-update.md`)。
字段与控件:
- `更新地址`:`update_source` 的 HTTP(S) 地址。
- `账号` / `密码`:HTTP Basic Auth 凭据;密码框默认掩码,提供「显示」切换。
- `测试连接`:点击用 `services.update_service.check_for_update` 实拉一次清单,反馈「已是最新 / 发现新版本 vX.Y.Z / 连接失败」,便于保存前验证。
- `当前版本`:只读显示 `APP_VERSION`。
- 一行小字安全提示:建议使用**只读账号**、生产环境走 HTTPS(凭据为明文存储)。
行为与架构:
- 对话框是**纯 UI**:打开时由 `main_window` 注入当前配置值;保存时把新值发回主窗口,由主窗口集中 `save_config`,UI 控件不直接读写配置文件(遵守 `docs/05` 4.12 与 `docs/04` 第 6 节)。
- 保存后主窗口重新触发一次在线更新检查(横幅按新配置刷新)。配置写入 `~/.cmbot/config/app_config.json`,启动器下次启动自然读到,两端一致。
- 取消不改动配置。
## 5. 左侧素材栏
左侧素材栏分为上下两块: