验证码登录与令牌持久化
手机号 + 6 位验证码;令牌写入 MySQL 会话表,重启客户端或服务后仍可免登录,401 自动清理并回到登录窗。
Qt Widgets · .NET 8 · 本地化部署
AiWork 采用客户端 / 服务端分离:Qt 负责原生窗口体验,.NET 8 提供鉴权与业务接口,数据落在本机 MySQL,热点接口由 MongoDB 缓存加速,配置文件始终跟随程序目录。
Features
从登录门禁到面板懒加载,从预加载遮罩到双数据源兜底,客户端该有的细节都按真实工作流做完了。
手机号 + 6 位验证码;令牌写入 MySQL 会话表,重启客户端或服务后仍可免登录,401 自动清理并回到登录窗。
顶部固定「工作组 / 项目 + 首页」,中部是服务器下发的动态项目与进度,底部固定设置、用户与存储空间。
启动只建主窗口,点击导航才创建面板;隐藏不销毁,再次显现时重新拉取服务端数据,兼顾启动速度与数据新鲜度。
窗口先出遮罩,按「连后台 → 拉引导数据 → 载入主题 → 恢复会话」推进进度;失败给重试与退出出口,而不是白屏。
标题栏与最小化 / 最大化 / 关闭交给系统;QSS 模板一键切换深色与浅色,QPalette 同步,切换后控件颜色不串。
后台可用时走真实接口;后台不可用或断网时自动回退内置 JSON,界面信号完全一致,演示与离线都不断档。
Quick start
安装包和后台服务都在本机运行,不依赖公网;下载页的安装包由这个服务自己托管。
取 Windows 绿色包,解压到任意目录,双击 AiWork.exe 即可,无需安装。
输入手机号获取验证码。演示模式下验证码随响应返回并显示在登录窗里,直接填入即可。
在「设置 → 数据源」把服务器地址填成下面这个地址,点「测试连接」看到“连接正常”即可。
http://127.0.0.1:5187
Download
绿色免安装,解压即用。安装包由本服务托管,下载时间、来源与次数会写入 MySQL 统计。
下载完成后可用 certutil -hashfile <文件> SHA256 校验文件完整性;SHA-256 值同时显示在卡片上。
API
路径、字段与状态码均与原 MockBackend 保持一致,客户端只要改服务器地址就能切换到本服务。
| 方法 | 路径 | 鉴权 | 说明 |
|---|---|---|---|
| GET | /api/health | 否 | 探活,返回 MySQL / MongoDB 状态 |
| POST | /api/auth/send-code | 否 | 发送验证码(演示环境随响应返回) |
| POST | /api/auth/login | 否 | 手机号 + 验证码登录,返回令牌与用户信息 |
| GET | /api/auth/me | Bearer | 校验当前令牌,返回用户信息 |
| POST | /api/auth/logout | Bearer | 注销会话 |
| GET | /api/bootstrap | Bearer | 应用 / 用户 / 动态项目 / KPI / 配额 / 导航 |
| GET | /api/projects/{projectId}/records | Bearer | 指定项目下的记录 |
| GET | /api/records | Bearer | 全量记录(概览与列表共用) |
| GET | /api/storage/quota | Bearer | 存储空间份额 |
| GET | /api/downloads | 否 | 安装包清单与下载地址(官网使用) |
| GET | /downloads/{fileName} | 否 | 文件下载,自动记录来源与计数 |
{ "error": "..." }
缓存:bootstrap / records / quota 走 MongoDB,TTL 到期自动刷新