migration: preserve mentor and llm streaming slice

docs/migration/evidence/slice-07/README.md

@@ -0,0 +1,71 @@
+# 切片 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。

docs/migration/evidence/slice-07/api-diff.json

@@ -0,0 +1,27 @@
+{
+  "all_equal": true,
+  "endpoints": [
+    {
+      "name": "mentor setup and public skill catalog",
+      "method": "GET",
+      "endpoint": "/api/mentors/setup?trade_date=2026-07-30",
+      "original_status": 200,
+      "migrated_status": 200,
+      "original_sha256": "3a5bd83b58e849757664bbfe8cf54e704bc9a7682333deb8297212c488aa3ddc",
+      "migrated_sha256": "3a5bd83b58e849757664bbfe8cf54e704bc9a7682333deb8297212c488aa3ddc",
+      "equal": true,
+      "first_difference": null
+    },
+    {
+      "name": "mentor messages scoped by user mentor and date",
+      "method": "GET",
+      "endpoint": "/api/mentors/messages?mentor_id=kobe92-perspective&trade_date=20260730",
+      "original_status": 200,
+      "migrated_status": 200,
+      "original_sha256": "eef46741adfc3a9f76294d3b78f37a45f113092ac9d44ee77c7a038a88ff09a1",
+      "migrated_sha256": "eef46741adfc3a9f76294d3b78f37a45f113092ac9d44ee77c7a038a88ff09a1",
+      "equal": true,
+      "first_difference": null
+    }
+  ]
+}

docs/migration/evidence/slice-07/api-requests.json

@@ -0,0 +1,14 @@
+[
+  {
+    "name": "mentor setup and public skill catalog",
+    "method": "GET",
+    "endpoint": "/api/mentors/setup?trade_date=2026-07-30",
+    "payload": null
+  },
+  {
+    "name": "mentor messages scoped by user mentor and date",
+    "method": "GET",
+    "endpoint": "/api/mentors/messages?mentor_id=kobe92-perspective&trade_date=20260730",
+    "payload": null
+  }
+]

docs/migration/evidence/slice-07/database-diff.json

@@ -0,0 +1,51 @@
+{
+  "all_equal": true,
+  "schema": {
+    "object_count": 62,
+    "original_sha256": "60a4e044f0ddb6502e44b45f65bedc1a0a31d4bd596f386d4ccfe153a6c8ddd1",
+    "migrated_sha256": "60a4e044f0ddb6502e44b45f65bedc1a0a31d4bd596f386d4ccfe153a6c8ddd1",
+    "equal": true
+  },
+  "tables": [
+    {
+      "table": "mentor_messages",
+      "original_count": 28,
+      "migrated_count": 28,
+      "original_sha256": "b906b776d575ff6fe459b2aa0e8b396267feed36d3d85f7edd7947b284482aeb",
+      "migrated_sha256": "b906b776d575ff6fe459b2aa0e8b396267feed36d3d85f7edd7947b284482aeb",
+      "equal": true
+    },
+    {
+      "table": "mentor_preferences",
+      "original_count": 45,
+      "migrated_count": 45,
+      "original_sha256": "c19c7d05e6745e4f1787d1eed5f39d7e555ec24f8e490b585c19158edc2505ec",
+      "migrated_sha256": "c19c7d05e6745e4f1787d1eed5f39d7e555ec24f8e490b585c19158edc2505ec",
+      "equal": true
+    },
+    {
+      "table": "llm_usage",
+      "original_count": 72,
+      "migrated_count": 72,
+      "original_sha256": "03a070316a125cef904bbfb2bb06b06e792242d5713142e70354402c741393c3",
+      "migrated_sha256": "03a070316a125cef904bbfb2bb06b06e792242d5713142e70354402c741393c3",
+      "equal": true
+    },
+    {
+      "table": "system_settings",
+      "original_count": 1,
+      "migrated_count": 1,
+      "original_sha256": "86d333a5c7feaf7111cd79b2db29513326a9b0d3781607f78bf633579e2ca8e9",
+      "migrated_sha256": "86d333a5c7feaf7111cd79b2db29513326a9b0d3781607f78bf633579e2ca8e9",
+      "equal": true
+    },
+    {
+      "table": "users",
+      "original_count": 3,
+      "migrated_count": 3,
+      "original_sha256": "4a0f135bef8ebae454693d3f40e1157d84d814d18d849f33e2e760ed1d8a7f89",
+      "migrated_sha256": "4a0f135bef8ebae454693d3f40e1157d84d814d18d849f33e2e760ed1d8a7f89",
+      "equal": true
+    }
+  ]
+}

docs/migration/保真迁移状态.json

@@ -1,6 +1,6 @@
 {
   "schema_version": 1,
-  "updated_at": "2026-07-31T03:56:00+08:00",
+  "updated_at": "2026-07-31T04:17:23+08:00",
   "status": "active",
   "migration_mode": "behavior_preserving_source_migration",
   "source_of_truth": "current_original_webapp_runtime_and_source",
@@ -9,10 +9,10 @@
   "failed_roots": [
     "next"
   ],
-  "current_slice": "slice-07-mentor-skills-llm-streaming",
-  "last_completed_slice": "slice-06-screener-custom-tracking",
-  "last_checkpoint": "xiaobai-preservation-slice-06-20260731",
-  "next_action": "capture_slice-07_mentor_skill_model_pool_and_streaming_contracts_then_move_original_implementations",
+  "current_slice": "slice-08-heaven-trend-fortune-heart",
+  "last_completed_slice": "slice-07-mentor-skills-llm-streaming",
+  "last_checkpoint": "xiaobai-preservation-slice-07-20260731",
+  "next_action": "capture_slice-08_heaven_trend_fortune_heart_and_animation_contracts_then_move_original_implementations",
   "authoritative_documents": [
     "AGENTS.md",
     "docs/migration/原版保真迁移总纲.md",

docs/migration/保真迁移账本.md

@@ -1,6 +1,6 @@
 # 小白复盘保真迁移账本
 
-> 当前状态：正式迁移，切片06“智能选股、自定义选股与策略持续跟踪”已完成
+> 当前状态：正式迁移，切片07“问师、模型 Skill 与 LLM 流式链路”已完成
 
 本账本是上下文恢复和人工审计的连续记录。任何迁移提交必须在同一提交中更新本文件及
 `保真迁移状态.json`。
@@ -26,6 +26,7 @@
 | 2026-07-31 | `xiaobai-preservation-slice-04-20260731` | 市场天梯与板块轮动原实现归位 | 自动、API与浏览器差分通过，进入切片05 |
 | 2026-07-31 | `xiaobai-preservation-slice-05-20260731` | 集合竞价、题材库、人气热榜与龙虎榜原实现归位 | 自动、API、数据库与浏览器差分通过，进入切片06 |
 | 2026-07-31 | `xiaobai-preservation-slice-06-20260731` | 智能选股、自定义选股与策略持续跟踪原实现归位 | 自动、API、数据库与浏览器差分通过，进入切片07 |
+| 2026-07-31 | `xiaobai-preservation-slice-07-20260731` | 问师、模型Skill与LLM流式链路原实现归位 | 自动、API、数据库、Skill与浏览器差分通过，进入切片08 |
 
 ## 资产处置登记
 
@@ -53,6 +54,10 @@
 | `DashboardService`选股方法 | 业务服务 | 选股三个工作区 | 按职责机械移动 | `app/backend/features/screener/service.py` | 13个方法AST及3个真实API一致 | 已移动 |
 | `ReviewDatabase`选股方法 | 持久化 | 因子、策略运行、候选与跟踪 | 按职责机械移动并保持Mixin原接口 | `app/backend/features/screener/repository.py` | 25个方法AST一致；62个schema对象及13张关键表逐行一致 | 已移动 |
 | `StrategyTrackingService` | 业务服务 | 手动候选持续跟踪 | 保持唯一实现并调整容器导入 | `app/backend/features/screener/tracking.py` | 类定义AST、真实API与浏览器行为一致 | 已归位 |
+| `mentor_agent.py`与问师服务 | 业务服务 | Skill发现、问师上下文与流式回答 | 整体机械移动并保留兼容别名 | `app/backend/features/mentor/` | Agent文件哈希、8个服务方法AST、2个真实API及浏览器行为一致 | 已移动 |
+| 问师消息与偏好方法 | 持久化 | 用户对话、置顶和排序 | 按职责机械移动并保持Mixin原接口 | `app/backend/features/mentor/repository.py` | 5个方法AST一致；相关表逐行一致 | 已移动 |
+| `llm_stream.py`与模型访问方法 | 公共模型能力 | 问师、问天、复盘助手与策略编译 | 移入唯一模型边界并保留兼容别名 | `app/backend/llm/` | 流式文件哈希一致；21个服务方法与既有用户边界一致 | 已移动 |
+| 公开`游资skills` | 运行资产 | 问师模型库 | 原样保留 | `app/游资skills/` | 190个文件逐路径和SHA-256一致 | 已复制 |
 
 处置只允许：`原样保留`、`移动`、`合并重复`、`待定`、`确认废弃`。
 
@@ -130,6 +135,16 @@
 - 回档：标签`xiaobai-preservation-slice-06-20260731`。
 - 完整证据：`docs/migration/evidence/slice-06/README.md`。
 
+已完成切片：`slice-07-mentor-skills-llm-streaming`。
+
+- 原版基线：提交`4bab921`，即切片06回档点。
+- 迁移范围：问师Agent、Skill注册表、8个服务方法、5个持久化方法、模型解析、额度、回退、流式累积器和调用审计。
+- 兼容边界：根级`mentor_agent.py`和`llm_stream.py`指向正式模块对象；系统管理继续独占模型池配置。
+- API与数据库：2个真实API完全一致；62个schema对象及5张关键表逐行一致；190个公开Skill文件哈希一致。
+- 验收：原版231项、迁移版273项Python测试、8项切片源码等价测试、45项Playwright及真实问师页面通过。
+- 回档：标签`xiaobai-preservation-slice-07-20260731`。
+- 完整证据：`docs/migration/evidence/slice-07/README.md`。
+
 ## 决策记录
 
 | 日期 | 决策 | 原因 |