26 lines
1.4 KiB
Python
26 lines
1.4 KiB
Python
|
"""设置页的事件绑定。
|
|||
|
|
|
|||
|
|
处理保存设置、测试 Admin 连接、测试设备连接等动作。
|
|||
|
|
|
|||
|
|
改动本文件前必读 `client/AGENTS.md`。以下几条最容易踩：
|
|||
|
|
|
|||
|
|
- **凭据（token、密码）不写进 SQLite 的 `app_settings`，也不写进日志。**
|
|||
|
|
存到 Windows 凭据管理器，见 `docs/client/06-quality-security.md` §7。
|
|||
|
|
`data/` 目录是明文的、设计上就是整个拷走的，拷一次等于泄露一次。
|
|||
|
|
- “测试连接”会联网、会连手机，**必须走后台线程**，
|
|||
|
|
用 `QObject` + `moveToThread`（模板见 `docs/client/02-architecture.md` §5.1）。
|
|||
|
|
在主线程里直接连，界面会卡住好几秒。
|
|||
|
|
- 非敏感设置存 `app_settings` 表，键名沿用 `<分组>.<名称>` 的写法，
|
|||
|
|
清单见 `docs/client/03-data-model.md` §6。
|
|||
|
|
- 涉及路径的设置（日志目录、Artifact 目录）一律基于 `data_dir()`，
|
|||
|
|
**不要硬编码，也不要用 `os.getcwd()`**——打包成 exe 后会失效，
|
|||
|
|
见 `docs/client/03-data-model.md` §2.2。
|
|||
|
|
- 保存前要校验：数量上限、价格偏差、轮询周期这些填错了会直接影响
|
|||
|
|
采购安全，不能存进去再说。
|
|||
|
|
- 测试结果用 `InfoBar` 反馈，失败时说清“哪一步失败、下一步做什么”，
|
|||
|
|
不要把原始异常堆栈贴到界面上。
|
|||
|
|
|
|||
|
|
注意：真实下单开关属于红线，默认关闭，不得在这里做成
|
|||
|
|
一个随手能打开的普通开关，见根目录 `AGENTS.md` 红线第 2 条。
|
|||
|
|
"""
|