smqjh-agent/smqjh-admin-agent

市民请集合智能助手

这是给 smqjh-cloud 管理端准备的 Windows 桌面智能助手初始框架。当前阶段先把 exe 项目的外壳、对话界面、配置、登录、任务注册表、运行日志和预演模式搭好，管理员操作需求确定后再逐个接真实接口。

技术选型

• Electron + React + TypeScript
• 对话优先界面，接近 Codex 的“对话 + 工具确认 + 日志上下文”形态
• 应用名称和 exe 产品名：市民请集合智能助手
• 应用图标来自 src/renderer/assets/logo.png，Windows 打包图标为 build/icon.ico
• 后端对接 smqjh-cloud 测试环境网关，默认 http://192.168.1.242:8080
• OAuth 后台客户端默认 mall-admin / 123456
• 打包工具 electron-builder

目录

src/main      Electron 主进程、配置、OAuth、任务执行器
src/renderer  管理员工作台 UI
src/shared    主进程与页面共享类型
docs          架构和需求收集文档
scripts       本地构建脚本

本地启动

npm install
npm run dev

构建 exe

便携版 exe：

npm run dist

安装包：

npm run dist:installer

产物会输出到 release/。

当前已接入的接口线索

• POST /smqjh-auth/oauth2/token
• GET /smqjh-auth/api/v1/auth/captcha
• GET /smqjh-system/api/v1/users/me
• POST /smqjh-system/api/v1/member/export/task/start
• GET /smqjh-system/api/v1/pointsRecharge/exportTemplate
• GET /smqjh-system/api/v1/members/enterprise/getByMobile

测试环境

• 网关：http://192.168.1.242:8080
• Nacos：http://192.168.1.242:8848/nacos
• 命名空间：public
• 网关路由：/smqjh-auth/**、/smqjh-system/**、/smqjh-pms/**、/smqjh-oms/**

下一步

1. 补齐管理员常用操作清单。
2. 给每个操作标注接口、权限、参数、是否需要审批。
3. 把危险操作继续保持预演模式，确认回滚策略后再开放真实执行。