dreamweaver/.claude/specs/robustness-improvement/dev-plan.md

DreamWeaver 工程鲁棒性改进计划

概述

本计划旨在提升 DreamWeaver 项目的工程质量，包括测试覆盖、稳定性、可观测性等方面。

任务列表

P0 - 关键问题修复

Task-1: 修复 Rate Limit 内存泄漏 ✅

• 文件: backend/app/api/stories.py
• 方案: 已迁移至 Redis 分布式限流，内存泄漏问题不再存在

Task-2: 添加核心 API 测试 ✅

• 文件: backend/tests/
• 范围: test_auth, test_stories, test_profiles, test_universes, test_push_configs, test_reading_events, test_provider_router

P1 - 稳定性提升

Task-3: 添加 API 重试机制 ✅

• 方案: 所有适配器已使用 tenacity 指数退避重试 (gemini, openai, cqtai, antigravity, minimax, elevenlabs)

Task-4: 添加结构化日志 ✅

• 文件: backend/app/core/logging.py
• 方案: structlog JSON/Console 双模式，所有适配器和 provider_router 已集成

P2 - 代码优化

Task-5: 重构 Provider Router ✅

• 文件: backend/app/services/provider_router.py
• 方案: 已实现统一 _route_with_failover 函数

Task-6: 配置外部化 ✅

• 文件: backend/app/core/config.py, backend/app/services/provider_router.py
• 方案: 所有模型名已移至 Settings，支持环境变量覆盖

Task-7: 修复脆弱的 URL 解析 ✅

• 状态: drawing.py 已被适配器系统取代，不再存在

新增依赖 (已添加)

# pyproject.toml [project.dependencies]
cachetools>=5.0.0    # Task-1: TTL cache
tenacity>=8.0.0      # Task-3: 重试机制
structlog>=24.0.0    # Task-4: 结构化日志

# [project.optional-dependencies.dev]
pytest-cov>=4.0.0    # Task-2: 覆盖率报告