refactor(api,expo): 多智能体与会话收敛、回忆录兼容层移除、后端测试集大幅删减

- 对齐「多智能体收敛」与「回忆录 stories-first / markdown-first」方向:收紧运行时契约、
  删除过渡兼容路径与双轨逻辑,并同步更新客户端与文档。

- Chat:以 ChatOrchestrator 为实时编排入口;删除独立 conversation_agent,精简 prompts。
- Memoir:删除 memory_agent;MemoirOrchestrator、classification / story_route 与 prompts 收敛到
  prepare_batches + run_story_pipeline_for_category_batch 主链路。
- 将 agents 侧 processor 迁入 feature 层为 background_runner,并移除 features 下重复/过时
  processor 封装。

- 新增 history_store,强化「conversation_messages 为 DB 真源、Redis 为缓存」模型。
- 调整 models、repo、service、session_history;精简 WS message_types,重构 pipeline 与 router。

- 移除章节占位、整章再生等旧路径;章节列表与封面逻辑要求 story 关联;收紧 cover 资格与
  enqueue。
- helpers、repo、service、router、reading_segment_materialize、story_pipeline_sync、pdf_service
  等按 canonical markdown / cover_asset_id 收缩;删除 memoir_images/provider 等冗余。
- tasks:memoir_tasks、chapter_cover_tasks 等大幅瘦身;story_image_tasks 等与当前图片任务对齐。

- core:config、logging、redis、task_tracker 小幅调整。
- auth / user / payment / quota:路由或服务侧删减过时接口或逻辑(如 payment router 行数减少)。

- pyproject.toml、development.sh、.env.example / .env.production、README 等同步说明或变量。

- Alembic 0001_initial_schema 微调(与当前 schema 叙事一致的小改动)。

- 回忆录:types / mappers / api、章节页与 memoir 页与后端契约对齐;markdown-renderer 调整。
- 语音:删除 voice/player,voice-segment-store 相应精简。

- api/tests:删除 conftest 及绝大部分既有测试文件(websocket_baseline、conversation、memoir
  图片、PDF、SMS 等),属有意收缩/待按 backend-test-system 重建的信号。
- docs:新增多智能体收敛与移除兼容层计划摘要;更新 story-first 设计、backend-test-system、
  multi-agent-refactor-plan、实施总结等。

BREAKING CHANGE: 后端对外契约、回忆录章节字段与若干路由/任务行为已变更;大量 API 测试被移除,
  CI 若依赖这些用例需按新策略补测或调整流水线。
This commit is contained in:
Kevin
2026-03-22 16:45:57 +08:00
parent 70070216c4
commit 786ebf8ae6
122 changed files with 2802 additions and 7941 deletions

View File

@@ -86,6 +86,10 @@ class Settings(BaseSettings):
alipay_sign_type: str = "RSA2"
alipay_under_development: str = "true" # "1"/"true"/"yes" 视为开发中不可用
# ── Logging ──────────────────────────────────────────────
# 环境变量 LOG_LEVEL控制 loguru sink 最低级别TRACE/DEBUG/INFO/…)
log_level: str = "INFO"
# ── Misc ─────────────────────────────────────────────────
enable_test_subscription: int = 0
enable_test_plan: str = "" # "1" / "true" / "yes" 为 True

View File

@@ -1,5 +1,13 @@
"""
loguru 统一日志配置 + InterceptHandler 拦截标准库 logging。
日志约定:
- INFO面向运维的稳定摘要避免敏感字段与高频噪音。
- DEBUG可记录完整上下文、用户内容、连接串、URL 等敏感信息;仅用于受控环境排查,
生产环境勿长期开启 DEBUG。
由 ``Settings.log_level`` 控制(环境变量 ``LOG_LEVEL``,默认 ``INFO``
设为 ``DEBUG`` 时上述详细日志才会输出。
"""
import logging
@@ -7,6 +15,15 @@ import sys
from loguru import logger
from app.core.config import settings
def _sink_min_level() -> str:
raw = (settings.log_level or "INFO").strip().upper()
if raw in ("TRACE", "DEBUG", "INFO", "SUCCESS", "WARNING", "ERROR", "CRITICAL"):
return raw
return "INFO"
class InterceptHandler(logging.Handler):
"""Route standard-library logging messages into loguru."""
@@ -37,7 +54,7 @@ def setup_logging() -> None:
logger.add(
sys.stderr,
level="INFO",
level=_sink_min_level(),
format=(
"<green>{time:YYYY-MM-DD HH:mm:ss.SSS}</green> | "
"<level>{level.name: <8}</level> | "

View File

@@ -33,7 +33,8 @@ class RedisService:
decode_responses=True,
)
await self._client.ping()
logger.info("Redis 连接成功: %s", self.redis_url)
logger.info("Redis 连接成功")
logger.debug("Redis 连接 URL: %s", self.redis_url)
except Exception as e:
logger.error("Redis 连接失败: %s", e)
raise

View File

@@ -32,7 +32,7 @@ class TaskTracker:
}
await client.hset(key, task_id, json.dumps(task_info))
await client.expire(key, self.TASK_TTL)
logger.info("任务已记录: user_id=%s, task_id=%s", user_id, task_id)
logger.debug("任务已记录: user_id=%s, task_id=%s", user_id, task_id)
return True
except Exception as e:
logger.error("记录任务失败: %s", e)