23 lines
1.1 KiB
Python
23 lines
1.1 KiB
Python
|
"""设置页的界面结构。
|
|||
|
|
|
|||
|
|
分四组：Admin、Android 设备、自动化、安全与诊断。
|
|||
|
|
完整规范见 `docs/client/05-ui-specification.md` §8。
|
|||
|
|
|
|||
|
|
改动本文件前必读 `client/AGENTS.md`。以下几条最容易踩：
|
|||
|
|
|
|||
|
|
- **认证状态只显示“已配置/未配置”或掩码值，绝不回显完整 token。**
|
|||
|
|
- 本文件只负责显示和输入转发，“测试连接”这类会联网、会连手机的动作
|
|||
|
|
放 `settings_ui_event.py`，且必须走后台线程。
|
|||
|
|
- 表单必须有**可见标签**，占位符不能当标签用（占位符一输入就没了，
|
|||
|
|
用户会忘记这个框是干嘛的）。
|
|||
|
|
- 用可滚动布局和 Fluent 设置卡片；MVP 采用显式“保存设置”按钮，
|
|||
|
|
不要在同一页混用即时保存。
|
|||
|
|
- 校验失败时保留用户已输入的内容，并把焦点移到第一个出错的字段，
|
|||
|
|
不要清空重来。
|
|||
|
|
- 图标用 `FluentIcon`，**不得用表情符号**。
|
|||
|
|
- 页面 `objectName` 固定为 `settingsPage`，不要改。
|
|||
|
|
|
|||
|
|
注意：设备连接**不是**独立的顶级页面，统一放在本页，
|
|||
|
|
见 `docs/client/01-requirements.md` §3。
|
|||
|
|
"""
|