wangdl/ios-projects
2
0
Fork 0
Code Issues 14 Pull Requests Actions Packages Projects Releases Wiki Activity

IOS-INFO-001：定义 ReadingMaterialContext #109

New Issue
Closed
opened 2026-06-10 21:28:08 +08:00 by wangdl · 1 comment
wangdl commented 2026-06-10 21:28:08 +08:00
Owner
Copy Link

目标

定义 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. 有基础测试。
## 目标 定义 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 commented 2026-06-12 20:44:20 +08:00
Author
Owner
Copy Link

审查修复评论

B1 修复：3 个字段 + Codable 补全

补全字段（4 → 7）：

  • localFileURL: URL? — 新增，本地文件路径
  • materialType: MaterialType? — 新增，Rust 侧 MaterialType（Markdown/Text/PDF/Image/Epub/Word/Excel/PowerPoint/Unknown）
  • previewMode: PreviewMode? — 新增，Rust 侧 PreviewMode（NativeReader/PlatformPreview/ExternalOpen/Unsupported）

Codable 支持：

  • ReadingMaterialContext 添加 Codable conformance（原仅有 Equatable）
  • 为 FFI 生成的 MaterialType 和 PreviewMode 添加 Codable 扩展（String-based coding）
  • 所有编码 key 使用 camelCase，与 Rust serde rename_all = "camelCase" 一致

向后兼容：

  • 所有新增字段为 Optional + 默认 nil，已有调用方无需修改

修改文件

  • Core/Models/ReadingMaterialContext.swift：从 32 行 → 103 行

验收标准对照

字段 Issue 规范 修复后
readingTargetType ✅ ✅
materialId ✅ ✅
knowledgeBaseId ✅ (可选) ✅
title ✅ (可选) ✅
localFileURL ✅ (可选) ✅
materialType ✅ (可选) ✅
previewMode ✅ (可选) ✅
Codable ✅ ✅
Equatable ✅ ✅

是否建议进入 Review

  • 是，请重新审查
## 审查修复评论 ### B1 修复：3 个字段 + Codable 补全 **补全字段（4 → 7）：** - `localFileURL: URL?` — 新增，本地文件路径 - `materialType: MaterialType?` — 新增，Rust 侧 MaterialType（Markdown/Text/PDF/Image/Epub/Word/Excel/PowerPoint/Unknown） - `previewMode: PreviewMode?` — 新增，Rust 侧 PreviewMode（NativeReader/PlatformPreview/ExternalOpen/Unsupported） **Codable 支持：** - `ReadingMaterialContext` 添加 `Codable` conformance（原仅有 `Equatable`） - 为 FFI 生成的 `MaterialType` 和 `PreviewMode` 添加 `Codable` 扩展（String-based coding） - 所有编码 key 使用 camelCase，与 Rust serde `rename_all = "camelCase"` 一致 **向后兼容：** - 所有新增字段为 `Optional` + 默认 `nil`，已有调用方无需修改 ### 修改文件 - `Core/Models/ReadingMaterialContext.swift`：从 32 行 → 103 行 ### 验收标准对照 | 字段 | Issue 规范 | 修复后 | |------|-----------|--------| | readingTargetType | ✅ | ✅ | | materialId | ✅ | ✅ | | knowledgeBaseId | ✅ (可选) | ✅ | | title | ✅ (可选) | ✅ | | localFileURL | ✅ (可选) | ✅ | | materialType | ✅ (可选) | ✅ | | previewMode | ✅ (可选) | ✅ | | Codable | ✅ | ✅ | | Equatable | ✅ | ✅ | ### 是否建议进入 Review - 是，请重新审查
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
area:ai
AI对话
area:analysis
分析页
area:auth
认证/Apple登录
area:import
文件导入
area:ios-info
iOS 学习信息采集与上传
area:library
知识库
area:notification
通知推送
area:profile
我的页面
area:quiz
测验/自测
area:review
复习卡片
area:search
搜索
area:study
学习首页
audit:planned
已完成宏观规划
blocked-by:api
等待 API 接口
blocked-by:api-info-core
等待 API 学习信息体系核心
blocked-by:doc-runtime
等待 Rust document runtime
priority:p0
最高优先级
priority:p1
高优先级
priority:p2
中优先级
repo:ios
iOS App 仓库
status:blocked
被阻塞
status:done
已完成
status:partial
部分存在，需补全
status:todo
待执行
type:bug
缺陷修复
type:docs
文档
type:feature
新功能
type:ui
UI/UX
work:adapter
适配器
work:analysis
分析页
work:api-client
API Client
work:api-contract
API 契约
work:architecture
架构
work:auth
认证
work:background
后台
work:bg-task
BGTask
work:compatibility
兼容性
work:context
阅读上下文
work:continue-learning
继续学习
work:debug
调试
work:design
架构设计
work:developer-tool
开发者工具
work:diagnostics
诊断
work:docs
文档
work:dto
DTO/数据传输
work:e2e
端到端
work:error-handling
错误处理
work:event
事件
work:event-chain
事件链路
work:event-export
事件导出
work:ffi
FFI 绑定
work:flush
刷新推送
work:heartbeat
心跳计时
work:heatmap
热力图
work:history
历史
work:home
首页
work:integration
接入
work:lifecycle
生命周期
work:local-cache
本地缓存
work:local-queue
本地队列
work:logging
日志
work:mapping
字段映射
work:marked-as-read
标记已读
work:material-detail
资料详情
work:model
数据模型
work:network
网络
work:offline
离线
work:permission
权限
work:persistence
持久化
work:position
阅读位置
work:queue
队列
work:reader-view
阅读器视图
work:reading-progress
阅读进度
work:records
学习记录
work:recovery
恢复
work:restore
位置恢复
work:retry
重试
work:routing
路由
work:runtime
Runtime 接入
work:rust-runtime
Rust document runtime
work:scheduler
调度器
work:session-manager
会话管理
work:state
状态管理
work:summary
Summary
work:test
测试
work:time-tracking
时长追踪
work:trend
趋势
work:ui
UI
work:upload
上传
No Label
area:ios-info
audit:planned
blocked-by:doc-runtime
priority:p0
repo:ios
status:todo
work:context
work:model
Milestone
No items
No Milestone M-IOS-INFO：学习信息采集、上传、继续学习与基础分析闭环
Projects
Clear projects
No project
Assignees
Clear assignees
suyun-Claude wangdl
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: wangdl/ios-projects#109
No description provided.
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?