[atoncooper]

概要

云盘 AI 能力与 Agent 工具闭环，并完成 app-cloud / app-ts / frontend 的 DTO、middleware、utils、测试结构整理。

云盘 AI

• 图片/截图/扫描 PDF OCR（Higress vision，pdfcpu 提取页图；OCR/摘要/embedding 均经 Higress）
• L1 摘要（overview/topics/entities/key_points/todos/answers_questions）与读取接口
• 语义检索、相似文件；文件夹范围、文件级聚合、snippets
• 云盘详情 AI 面板 / 语义搜索模式 / 「问这份文件」/ 聊天来源 uploadUuid 深链
• Agent 工具（app-ts）：
  • cloud_doc_summary
  • cloud_semantic_search
  • cloud_similar_files

结构整理

• app-cloud 全部 JSON 路由收口 internal/dto（12 个域文件），handler 不再手写 gin.H
• middleware 独立为 internal/middleware（UID / internal key / capability / CORS / security / metrics）
• cloudutil 统一为 internal/utils
• app-cloud Go 测试迁入 tests/ 黑盒包（84 个测试），service 包无 _test.go
• app-ts 出站 client 从 services/ 移到 auth/，services 只保留业务编排
• 前端入库状态 toast + 防重复点击；后端原子入库抢占 + 重入库 30s 冷却

验证

• app-cloud Linux 容器（CGO=0）：gofmt / go vet / go test 全绿，app-cloud/tests 84 tests
• app-ts：npm run typecheck 通过；全量 vitest（排除既有 Mongo 认证失败用例）67 文件、639 通过
• frontendv2：tsc --noEmit、next build --webpack 通过
• compose / client compose / kustomize 配置校验通过

部署注意

• 需重建：app-cloud、app-ts、frontend
• 新增 compose env：APPCLOUD__INTERNAL__API_KEY（复用 APISIX_CONSUMER_KEY）、APP_CLOUD_BASE_URL
• 无 MySQL schema 迁移；历史文件需重新入库生成 OCR/摘要
• 摘要/OCR 模型默认 z-ai/glm-5.3-flash，需 Higress 可路由

未包含

• 视频/音频自动 ASR
• 真正的 hybrid search + rerank
• 图像 caption / CLIP 视觉向量