API-AI-016：LearningAnalysisSnapshot Builder #187

New Issue

wangdl · 2026-06-11T21:49:59+08:00

wangdl commented

2026-06-11 21:49:59 +08:00

目标

实现 AI 分析快照构建服务，从已有学习信息体系中聚合用户设置、学习行为、设备场景、资料进度、内容结构摘要，生成 Runtime 可消费的 Snapshot。

输入来源

UserLearningProfile
UserAiSettings
MaterialReadingProgress
LearningSession
DailyLearningActivity
LearningRecord
ReadingEvent 聚合数据
设备上下文
资料 / 知识点结构摘要

输出结构

userProfile
aiSettings
deviceContext
learningBehaviorSummary
materialProgressSummary
contentStructureSummary
behaviorSignals
scoreSignals
constraints
privacyScope
allowedModelFields

关键规则

不直接塞原始 ReadingEvent 列表。
不包含未授权字段。
不包含用户关闭的资料原文内容。
用户设置作为硬约束。
缺失数据要给 confidence 降级。

验收标准

能生成 material 级 Snapshot。
能生成 user 级 Snapshot。
能处理用户画像缺失。
能处理学习行为数据缺失。
输出 allowedModelFields。
输出 scoreSignals。
输出 constraints。
Snapshot 写入 LearningAnalysisSnapshot 表。
提供单元测试。

## 目标实现 AI 分析快照构建服务，从已有学习信息体系中聚合用户设置、学习行为、设备场景、资料进度、内容结构摘要，生成 Runtime 可消费的 Snapshot。 ## 输入来源 - UserLearningProfile - UserAiSettings - MaterialReadingProgress - LearningSession - DailyLearningActivity - LearningRecord - ReadingEvent 聚合数据 - 设备上下文 - 资料 / 知识点结构摘要 ## 输出结构 - userProfile - aiSettings - deviceContext - learningBehaviorSummary - materialProgressSummary - contentStructureSummary - behaviorSignals - scoreSignals - constraints - privacyScope - allowedModelFields ## 关键规则 1. 不直接塞原始 ReadingEvent 列表。 2. 不包含未授权字段。 3. 不包含用户关闭的资料原文内容。 4. 用户设置作为硬约束。 5. 缺失数据要给 confidence 降级。 ## 验收标准 1. 能生成 material 级 Snapshot。 2. 能生成 user 级 Snapshot。 3. 能处理用户画像缺失。 4. 能处理学习行为数据缺失。 5. 输出 allowedModelFields。 6. 输出 scoreSignals。 7. 输出 constraints。 8. Snapshot 写入 LearningAnalysisSnapshot 表。 9. 提供单元测试。

wangdl added this to the M-API-AI-RUNTIME：API AI Runtime 调度与落库 milestone 2026-06-11 21:49:59 +08:00

wangdl added the

labels 2026-06-11 21:49:59 +08:00

wangdl closed this issue

2026-06-17 13:32:54 +08:00

Sign in to join this conversation.