Qt Widgets · .NET 8 · 本地化部署

把日常运营,
装进一个桌面工作台

AiWork 采用客户端 / 服务端分离:Qt 负责原生窗口体验,.NET 8 提供鉴权与业务接口,数据落在本机 MySQL,热点接口由 MongoDB 缓存加速,配置文件始终跟随程序目录。

  • 版本v1.0.0
  • 平台Windows 10/11 x64
  • 形态绿色免安装
手机号登录6 位验证码 + Bearer 令牌
MySQL 存储用户 / 项目 / 记录 / 下载统计
MongoDB 缓存热点接口结果 + TTL 自动过期
配置随目录走不写注册表,不写系统目录

Features

为桌面场景准备的工作台骨架

从登录门禁到面板懒加载,从预加载遮罩到双数据源兜底,客户端该有的细节都按真实工作流做完了。

验证码登录与令牌持久化

手机号 + 6 位验证码;令牌写入 MySQL 会话表,重启客户端或服务后仍可免登录,401 自动清理并回到登录窗。

三段式导航

顶部固定「工作组 / 项目 + 首页」,中部是服务器下发的动态项目与进度,底部固定设置、用户与存储空间。

面板懒加载

启动只建主窗口,点击导航才创建面板;隐藏不销毁,再次显现时重新拉取服务端数据,兼顾启动速度与数据新鲜度。

启动预加载

窗口先出遮罩,按「连后台 → 拉引导数据 → 载入主题 → 恢复会话」推进进度;失败给重试与退出出口,而不是白屏。

原生窗口 + 深浅主题

标题栏与最小化 / 最大化 / 关闭交给系统;QSS 模板一键切换深色与浅色,QPalette 同步,切换后控件颜色不串。

HTTP / 本地双数据源

后台可用时走真实接口;后台不可用或断网时自动回退内置 JSON,界面信号完全一致,演示与离线都不断档。

Quick start

三步接入本地服务

安装包和后台服务都在本机运行,不依赖公网;下载页的安装包由这个服务自己托管。

  1. 01

    下载并解压

    取 Windows 绿色包,解压到任意目录,双击 AiWork.exe 即可,无需安装。

  2. 02

    登录

    输入手机号获取验证码。演示模式下验证码随响应返回并显示在登录窗里,直接填入即可。

  3. 03

    连接服务

    在「设置 → 数据源」把服务器地址填成下面这个地址,点「测试连接」看到“连接正常”即可。

    http://127.0.0.1:5187

Download

下载桌面客户端

绿色免安装,解压即用。安装包由本服务托管,下载时间、来源与次数会写入 MySQL 统计。

累计下载 — 次 版本 v1.0.0
正在获取安装包信息…

下载完成后可用 certutil -hashfile <文件> SHA256 校验文件完整性;SHA-256 值同时显示在卡片上。

API

客户端接口一览

路径、字段与状态码均与原 MockBackend 保持一致,客户端只要改服务器地址就能切换到本服务。

方法路径鉴权说明
GET/api/health否探活,返回 MySQL / MongoDB 状态
POST/api/auth/send-code否发送验证码(演示环境随响应返回)
POST/api/auth/login否手机号 + 验证码登录,返回令牌与用户信息
GET/api/auth/meBearer校验当前令牌,返回用户信息
POST/api/auth/logoutBearer注销会话
GET/api/bootstrapBearer应用 / 用户 / 动态项目 / KPI / 配额 / 导航
GET/api/projects/{projectId}/recordsBearer指定项目下的记录
GET/api/recordsBearer全量记录(概览与列表共用)
GET/api/storage/quotaBearer存储空间份额
GET/api/downloads否安装包清单与下载地址(官网使用)
GET/downloads/{fileName}否文件下载,自动记录来源与计数
失败响应统一为 { "error": "..." } 缓存:bootstrap / records / quota 走 MongoDB,TTL 到期自动刷新