面向技术型个人与小团队的一体化工具平台，立项原因是把分散的日常工具收敛到一个入口。
痛点：运维面板、AI 写作、股票工具、教室设备各是一套系统，账号、权限、日志各管一摊。人员一多，账号维护成负担；要做审计，数据凑不齐。
典型场景：
1、教育——教师在手机上直接对教室电脑喊话，不必跑到教室开机登录；一句自然语言需求（如"每周2课时、从第2周写到第18周，共34篇"）自动拆解成文档清单，后台排队生成。
2、运维——管理员在手机上完成服务器状态查看、服务重启、网站与数据库管理，写操作全程留痕。
3、个人投资——持仓读写、交易记账、每日收益、打新中签登记，与盯盘程序共用同一份数据。
核心价值：一套账号按角色分配可见模块，一套审计覆盖所有写操作，接口按手机浏览器场景设计，而非把桌面端后台硬塞进小屏。
系统由服务端（131 路径 / 171 接口）、后台管理端、H5 移动端三部分组成。
【AI 能力】
· AI 助手（DeepSeek）：多会话隔离、图片识别与文档解析、SSE 流式对话、一键生成并导出 Word / PDF / PPT / Excel
· 批量文档生成：自然语言拆解需求、模板范围自动展开、后台排队生成、进度轮询、整批打包下载
【运维与业务】
· 服务器运维（60+ 接口）：对接主机面板 API，覆盖系统状态、网站、数据库、文件、计划任务、防火墙、备份
· 股票操作：持仓、交易记账（服务端加权成本）、资金、每日收益、打新中签登记
【系统能力】
· 教室喊话：设备绑定、实时音频对讲、音量控制、喊话记录
· 权限体系：用户 → 角色 → 模块三级模型，JWT + 令牌版本号失效机制
· 文件管理、登录与操作日志
【两端界面】
· 后台管理（Vue 3 + Element Plus）：用户 / 角色 / 模块 / 文件 / 日志 / 教室 / 股票管理，路由级 + 按钮级双层权限，国际化
· H5 移动端（Vue 3 + Vant）：按角色呈现模块，含 AI 对话与流式渲染、文档预览、实时对讲页
技术栈：服务端 PHP 8.0 + Hyperf 3.0 + Swoole 协程、MySQL、Redis、WebSocket；前端 Vue 3.5 + TypeScript + Vite（后台管理用 Element Plus，H5 用 Vant）。独立完成全部设计、开发、测试与部署。
四个实现难点：
1、长耗时任务异步化——AI 生成一篇文档需 1-2 分钟，批量 35 篇同步等待几十分钟。拆成"一篇一个队列任务"而非"一批一个"：失败只影响一篇、可单独重试；接口立即返回批次 ID，前端轮询进度。
2、WebSocket 实时音频中继——对讲连接分散在不同 Worker 进程，进程间无法直接互发。音频帧经 Redis 发布订阅广播到所有进程，各进程自查本地连接后再转发。
3、手写 OOXML——目标服务器是 PHP 8.0，主流文档库的依赖链装不上。直接按 OOXML 规范拼装 zip + XML 实现 Word / PDF / PPT / Excel 四种格式，共用一套 Markdown 解析层。
4、前端安全与性能——AI 回复是模型生成的 Markdown，解析后必须再由 DOMPurify 净化才能渲染，否则就是现成的 XSS 入口；PDF / Word 预览库体积大，全部动态加载、不进首屏包。
规模：服务端 149 个文件 / 约 2.6 万行，前端 192 个文件 / 约 3.9 万行；18 张数据表，171 个接口的 OpenAPI 文档 100% 覆盖。
评论