识策AI · 模块设计总览

本文为架构总览与导航。各模块详细设计见独立文档。

---

架构一览

前端 Monorepo (pnpm + Turborepo)
  @shice/composables → @shice/stores → @shice/api → @shice/shared
  apps/web (Vue 3 + Naive UI + UnoCSS + vue-i18n)
  apps/desktop (Electron 壳，可选；开发加载 Vite，发布加载 web-dist)

Go 后端 (Gin + GORM)
  cmd/server
  internal/
    ├── agent/        # 多 Agent 情感计算引擎
    ├── handler/      # HTTP Handler（chat / strategy / auth / person / subscription）
    ├── middleware/    # JWT / CORS / Subscription
    ├── config/       # Viper YAML + 环境变量
    ├── model/        # GORM 数据模型
    ├── repository/   # 数据访问层
    ├── service/      # 业务逻辑
    ├── quota/        # 额度与用量（Redis）
    └── observability/# Langfuse 可观测
  pkg/database/       # MySQL 连接 + AutoMigrate

基础设施 (Docker Compose)
  MySQL 8 · Redis 7 · Qdrant · MinIO

---

模块文档索引

模块	文档	概述
前端 Monorepo	modules/frontend.md	包结构、shared/api/stores/composables、Web 应用、路由、布局、核心页面
Go 后端	modules/backend.md	分层架构、配置、中间件、数据模型、Repository/Service/Handler
Agent 系统	modules/agent.md	情感计算引擎、Orchestrator（LLM/关键词双路由）、Pipeline 串联、4 个子 Agent、Prompt 设计、情绪追踪
API 路由	modules/api_routes.md	全量路由对照表、字段映射、响应格式、HTTP 与 Agent 层对接说明
SSE 流式对话	modules/sse.md	后端 SSE 推送、前端 fetch 解析、打字机效果、停止生成
基础设施	modules/infra.md	Docker Compose、网络、Qdrant 向量记忆、Timeline
部署说明	modules/deploy.md	生产部署步骤、容器架构、运维命令、安全清单、故障排查
隐私合规	modules/privacy.md	数据资产清单、风险评估、法律依据、优先级路线图
第三方依赖	modules/dependencies.md	前端/后端/基础设施全部第三方库分类清单

---

核心数据流

用户输入 → ChatHandler / StrategyHandler
  ├── 额度检查（quota 包，Redis）
  ├── 加载 Person 档案 + 近期互动摘要 + 情绪快照
  ├── 构建 AgentContext（history, persons, selfProfile, locale, maxTokens …）
  └── agent.System.Chat / Analyze / Advise / Script
        ├── Orchestrator: LLM 意图分类（primary + secondary）
        │   └── fallback: 中英文关键词匹配
        ├── 单 Agent 模式 → 直接流式输出
        └── Pipeline 模式 → primary 流式输出 → 结果注入 secondary → 继续流式
              (e.g. AnalyzerAgent → WriterAgent)
        └── 异步: EmotionExtractor → EmotionSnapshot 存 DB

---

技术栈速查

层级	技术
前端框架	Vue 3 + TypeScript
UI 组件库	Naive UI
国际化	vue-i18n（界面中/英；对话语言随 locale 传后端）
状态管理	Pinia
CSS	UnoCSS
构建工具	Vite + Turborepo
后端框架	Go 1.26 + Gin
ORM	GORM
数据库	MySQL 8
缓存/额度	Redis 7
向量数据库	Qdrant
AI Agent	情感计算多 Agent（OpenAI 兼容 API + Mock）；LLM 意图路由 + Pipeline
可观测	Langfuse（可选）