xiaobaifupan/docs/migration/evidence/slice-07

切片 07：问师、模型 Skill 与 LLM 流式链路

基线：4bab921（切片 06） 回档标签：xiaobai-preservation-slice-07-20260731 结论：源码、API、数据库、Skill 资产、真实页面和全量回归通过；最终视觉仍等待全站人工验收

1. 原实现归位

本切片只移动原版问师、Skill 注册、模型访问与流式协议，没有从next/取用代码，也没有改写 提示词、数据侧重、模型排序、权限、计次、回退或流式去重逻辑。

原位置	新的唯一实现位置	兼容方式
app/mentor_agent.py	app/backend/features/mentor/agent.py	根级模块指向同一模块对象
DashboardService问师方法	app/backend/features/mentor/service.py	MentorServiceMixin
问师消息和偏好持久化	app/backend/features/mentor/repository.py	MentorRepositoryMixin
问师流式HTTP方法	app/backend/features/mentor/http.py	MentorHttpMixin
app/llm_stream.py	app/backend/llm/stream.py	根级模块指向同一模块对象
DashboardService模型访问方法	app/backend/llm/service.py	LLMServiceMixin
LLM调用审计持久化	app/backend/llm/repository.py	LLMAuditRepositoryMixin
旧个人模型HTTP兼容入口	app/backend/llm/http.py	LLMHttpMixin

模型池的增删、主辅模型选择及会员每日额度仍由系统管理负责；backend/llm只负责解析当前可用模型、 鉴权、计次、首段前回退、流式传输和调用审计，避免复制第二套系统设置逻辑。

2. 源码与 Skill 等价

• mentor_agent.py和llm_stream.py与原版文件SHA-256一致，根级兼容模块与正式模块为同一模块对象。
• 8个问师服务方法、5个问师Repository方法、2个LLM审计Repository方法与原版无位置信息AST一致。
• 21个LLM服务方法中19个与原版AST一致；_platform_usage_today及按用户查询的辅助方法保留切片01 已验证的用户边界适配，使会员管理可在不切换请求上下文的情况下显示每位用户当日用量。
• 问师流式和旧模型HTTP方法仅把原全局SERVICE改为Mixin的self.application_service，响应状态、 Content-Type、NDJSON事件、异常和断连处理不变。
• 公开游资skills共190个文件，原版与迁移版逐路径、逐SHA-256比较，差异为0。
• 私有“小白”Skill仍位于Git忽略的data/private-mentor-skills，未复制到公开目录或证据文件。

3. API与数据库差分

• 原版8786和迁移版8787使用同一数据库的独立副本。
• /api/mentors/setup和按用户、模型、日期读取消息的API状态码及业务JSON完全一致。
• 两版均为62个schema对象；mentor_messages 28行、mentor_preferences 45行、llm_usage 72行、 system_settings 1行、users 3行，均逐行一致。
• 接口证据见api-requests.json、api-diff.json，数据库证据见database-diff.json。
• 差分只在系统临时目录的数据库副本上运行，登录会话和后台任务运行数据未纳入业务表比较；临时副本 已在验收后删除，正式数据库未写入测试消息或LLM调用记录。

4. 真实浏览器检查

• 迁移版真实服务载入24个思维模型，管理员可见私有“小白”，公开模型的A/B/C标签、简介和置顶按钮正常。
• A级筛选显示13个模型；全部、A级、B级、C级、搜索、整理、清空对话、建议问题、输入框和发送按钮均存在。
• 页面宽度与1280像素视口一致，无横向溢出；浏览器控制台无错误。
• 浏览器不调用真实外部模型，防止模型容量和网络波动污染迁移结论；流式首段回退、输出后禁止切模、 完整快照去重和空响应处理由test_llm_gateway、test_mentor_stream与test_llm_stream覆盖。
• 截图SHA-256：
  • mentor-all.jpg：9cda4d6896da6932b8e9db014eed4882359287d6999e2181af7d945ea6272bd9
  • mentor-a-filter.jpg：5dca958d5edf7ab11767474a3c4405d4cb96029f7a1efb35fa8155c61c863984

5. 自动验证与保留边界

验证	结果
原版python -m unittest discover -s tests -q	231项通过
迁移版python -m unittest discover -s tests -q	273项通过
python -m unittest tests.test_preservation_slice_mentor_llm -q	8项通过
npx.cmd playwright test --reporter=dot	45项通过
git diff --check	通过

• assistant_agent.py属于切片09复盘助手，本切片不提前移动。
• 问天的模型调用属于切片08，本切片只复用统一LLM网关，不移动问天业务。
• 前端DOM、页面JS、CSS和移动端行为未改动，统一归档延至切片10。
• 没有删除待定代码、没有修改正式数据库、没有切换Docker/NAS。