backend/
├── app/
│   ├── core/           # 核心模块（配置、数据库、LLM、日志、Chat Models）
│   ├── models/         # SQLAlchemy 数据模型
│   ├── prompts/        # 提示词管理系统
│   ├── repositories/   # 数据访问层
│   ├── routers/        # FastAPI 路由
│   ├── schemas/        # Pydantic Schema
│   ├── services/       # 业务逻辑层
│   ├── scheduler/      # 定时任务调度
│   ├── utils/          # 工具函数
│   └── main.py         # 应用入口
├── tests/              # 测试用例
└── data/               # 静态数据

chat_models/
├── base.py             # ReasoningChunk 结构 + BaseReasoningChatModel 抽象基类
├── registry.py         # 模型创建工厂，按 provider 选择实现
└── providers/
    └── reasoning_content.py  # SiliconFlow 推理内容实现

prompts/
├── registry.py         # PromptRegistry - 提示词注册表
├── schemas.py          # Pydantic Schema
└── defaults/           # 默认提示词
    ├── agent.py        # Agent 提示词
    ├── crawler.py      # 爬虫提示词
    ├── memory.py       # 记忆提示词
    └── skill.py        # 技能提示词

agent/
├── core/               # 核心服务
│   ├── service.py      # AgentService 主入口
│   ├── factory.py      # Agent 工厂
│   ├── config.py       # Agent 配置管理
│   ├── intent.py       # 意图识别
│   └── policy.py       # 路由策略
├── middleware/         # 中间件（声明式注册，按 order 执行）
│   ├── registry.py           # 中间件注册表
│   ├── sliding_window.py     # 滑动窗口裁剪
│   ├── summarization_broadcast.py # 上下文压缩摘要
│   ├── todo_broadcast.py     # TODO 规划广播
│   ├── sequential_tools.py   # 工具串行执行
│   ├── noise_filter.py       # 工具输出噪音过滤
│   ├── response_sanitization.py # 响应内容安全过滤
│   ├── llm_call_sse.py       # LLM 调用事件推送
│   └── logging.py            # 日志记录
├── retrieval/          # 检索服务（已迁移到 knowledge/）
├── streams/            # 流式响应
├── tools/              # 工具定义（声明式注册）
│   ├── registry.py     # 工具注册表
│   ├── product/        # 商品工具（12+）
│   ├── knowledge/      # 知识库工具
│   └── common/         # 通用工具
└── bootstrap.py        # 默认 Agent 初始化

memory/
├── store.py            # UserProfileStore - LangGraph Store 基座
├── profile_service.py  # ProfileService - 用户画像服务
├── fact_memory.py      # FactMemoryService - 事实型长期记忆
├── graph_memory.py     # KnowledgeGraphManager - 图谱记忆
├── vector_store.py     # Qdrant 向量存储
├── models.py           # Entity, Fact, Relation, UserProfile
├── prompts.py          # 记忆提示词
└── middleware/         # 记忆编排中间件

skill/
├── service.py      # SkillService - CRUD、Agent 关联、技能匹配
├── generator.py    # SkillGenerator - AI 智能生成技能
├── registry.py     # SkillRegistry - 运行时缓存
├── injector.py     # SkillInjector - 技能注入到 Agent
└── system_skills.py # 系统内置技能定义

knowledge/
├── factory.py          # 检索器工厂
├── kb_retriever.py     # 知识库检索
├── faq_retriever.py    # FAQ 检索
└── faq_service.py      # FAQ CRUD

support/
├── gateway.py          # 客服网关
├── handoff.py          # 人工客服转接
├── heat_score.py       # 热度评分
└── notification/       # 通知渠道
    ├── base.py         # 通知基类
    ├── dispatcher.py   # 通知分发器
    └── channels/       # 具体渠道实现

scheduler/
├── scheduler.py        # 任务调度器
├── registry.py         # 任务注册
├── runner.py           # 任务执行器
├── state/              # 任务状态管理
├── tasks/              # 任务定义
│   ├── base.py         # 任务基类
│   └── crawl_site.py   # 爬虫定时任务
└── routers/            # 调度器 API

用户请求 → FastAPI Router → Service → Repository → Database
                ↓
           Agent 服务 → 中间件链 → LangGraph → LLM
                ↓
           工具调用 → 检索服务 → Qdrant/知识库
                ↓
           SSE 流式响应 → 事件推送
                ↓
           记忆抽取 → 用户画像更新

# 运行所有测试
uv run pytest

# 运行特定模块测试
uv run pytest tests/services/test_system_config.py -v

# 运行技能系统测试
uv run pytest tests/schemas/test_skill.py tests/services/test_skill.py tests/routers/test_skills.py -v