IOS-INFO-001：定义 ReadingMaterialContext #109

New Issue

wangdl · 2026-06-10T21:28:08+08:00

wangdl commented

2026-06-10 21:28:08 +08:00

目标

定义 iOS 业务层阅读上下文 ReadingMaterialContext，用于连接业务资料、Rust materialId、readingTargetType、knowledgeBaseId、文件路径和页面展示信息。

字段建议

materialId
readingTargetType
knowledgeBaseId?
sourceId?
temporaryFileId?
localFilePath
fileName
fileType
mimeType?
displayTitle
coverURL?
createdAt?
updatedAt?

readingTargetType

knowledge_source
temporary_file

knowledgeBaseId 来源规则

从知识库资料 / 知识点详情页进入阅读页时，优先从页面导航参数传入 knowledgeBaseId。
如果导航参数没有 knowledgeBaseId，则尝试从资料详情 API / 当前 KnowledgeSource 模型读取。
如果资料属于个人知识库或官方知识库，knowledgeBaseId 应尽量存在。
temporary_file 场景允许 knowledgeBaseId 为空。
如果 knowledge_source 场景缺少 knowledgeBaseId，仍允许阅读，但上传 UploadItem 时 knowledgeBaseId 为空，并记录 warning。
ReadingMaterialContext 不自行请求网络；它只接收上层页面已知的上下文。

规则

Rust 只接收 materialId 和文件相关信息。
readingTargetType 不传给 Rust。
UploadItem 由 ReadingMaterialContext 补充 readingTargetType。
knowledge_source 场景应尽量包含 knowledgeBaseId。
temporary_file 场景允许 knowledgeBaseId 为空。

验收标准

新增 ReadingMaterialContext 类型。
支持 knowledge_source。
支持 temporary_file。
可从知识点 / 资料详情页构建。
可用于 Runtime Session 创建。
可用于 UploadItem 映射。
有基础测试。

## 目标定义 iOS 业务层阅读上下文 ReadingMaterialContext，用于连接业务资料、Rust materialId、readingTargetType、knowledgeBaseId、文件路径和页面展示信息。 ## 字段建议 - materialId - readingTargetType - knowledgeBaseId? - sourceId? - temporaryFileId? - localFilePath - fileName - fileType - mimeType? - displayTitle - coverURL? - createdAt? - updatedAt? ## readingTargetType - knowledge_source - temporary_file ## knowledgeBaseId 来源规则 1. 从知识库资料 / 知识点详情页进入阅读页时，优先从页面导航参数传入 knowledgeBaseId。 2. 如果导航参数没有 knowledgeBaseId，则尝试从资料详情 API / 当前 KnowledgeSource 模型读取。 3. 如果资料属于个人知识库或官方知识库，knowledgeBaseId 应尽量存在。 4. temporary_file 场景允许 knowledgeBaseId 为空。 5. 如果 knowledge_source 场景缺少 knowledgeBaseId，仍允许阅读，但上传 UploadItem 时 knowledgeBaseId 为空，并记录 warning。 6. ReadingMaterialContext 不自行请求网络；它只接收上层页面已知的上下文。 ## 规则 1. Rust 只接收 materialId 和文件相关信息。 2. readingTargetType 不传给 Rust。 3. UploadItem 由 ReadingMaterialContext 补充 readingTargetType。 4. knowledge_source 场景应尽量包含 knowledgeBaseId。 5. temporary_file 场景允许 knowledgeBaseId 为空。 ## 验收标准 1. 新增 ReadingMaterialContext 类型。 2. 支持 knowledge_source。 3. 支持 temporary_file。 4. 可从知识点 / 资料详情页构建。 5. 可用于 Runtime Session 创建。 6. 可用于 UploadItem 映射。 7. 有基础测试。

wangdl added this to the M-IOS-INFO：学习信息采集、上传、继续学习与基础分析闭环 milestone 2026-06-10 21:28:08 +08:00

wangdl added the

blocked-by:doc-runtime

work:model

work:context

labels 2026-06-10 21:28:08 +08:00

Sign in to join this conversation.