IOS-INFO-006 P0 | ReadingRuntimeSessionManager 【审计: 不存在】 #71

New Issue

wangdl · 2026-06-07T11:55:22+08:00

wangdl commented

2026-06-07 11:55:22 +08:00

审查

不支持 session 生命周期管理。需新建。

职责

start/pause/resume/close，保存 current session 和 context，防重复 start，防 close 后 heartbeat，暴露 clientSessionId。状态: idle|active|paused|closed。

## 审查不支持 session 生命周期管理。需新建。 ## 职责 start/pause/resume/close，保存 current session 和 context，防重复 start，防 close 后 heartbeat，暴露 clientSessionId。状态: idle|active|paused|closed。

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

wangdl changed title from ~~IOS-INFO-005 P0 | ReadingRuntimeSessionManager~~ to IOS-INFO-006 P0 | ReadingRuntimeSessionManager 【审计: 不存在】

2026-06-07 12:10:02 +08:00

wangdl referenced this issue

2026-06-08 21:45:49 +08:00

IOS-INFO-004 P0 | V1 ReadingEventCollector 断链修复【审计: 致命F1】 #70

wangdl commented

2026-06-08 21:48:24 +08:00

完成报告

交付

Features/MaterialReader/ReadingRuntimeSessionManager.swift — V2 Session Manager:

@MainActor
final class ReadingRuntimeSessionManager {
    var state: ReadingSessionState  // idle|active|paused|closed
    var activeSessionId: String?
    var activeContext: ReadingMaterialContext?
    var adapter: ReadingRuntimeAdapter  // 可注入 mock

    // Session lifecycle
    func openMaterial(_ ctx: ReadingMaterialContext) throws  // → active
    func closeMaterial()                                     // → closed
    func pause() / resume()                                 // active ↔ paused

    // Events
    func updatePosition(_ pos: ReadingPosition)  // 2s debounce → pushPositionChanged
    func markAsRead()                            // → pushMarkedAsRead

    // Heartbeat: Timer 15s → pushHeartbeat(delta:15)
}

防重复 start: openMaterial 检查 state != idle/closed → throw SessionError.alreadyActive
防 close 后 heartbeat: startHeartbeat 检查 state == .active
adapter 注入: 默认 RustReadingRuntimeAdapter()，可注入 mock 用于测试

## 完成报告 ### 交付 `Features/MaterialReader/ReadingRuntimeSessionManager.swift` — V2 Session Manager: ```swift @MainActor final class ReadingRuntimeSessionManager { var state: ReadingSessionState // idle|active|paused|closed var activeSessionId: String? var activeContext: ReadingMaterialContext? var adapter: ReadingRuntimeAdapter // 可注入 mock // Session lifecycle func openMaterial(_ ctx: ReadingMaterialContext) throws // → active func closeMaterial() // → closed func pause() / resume() // active ↔ paused // Events func updatePosition(_ pos: ReadingPosition) // 2s debounce → pushPositionChanged func markAsRead() // → pushMarkedAsRead // Heartbeat: Timer 15s → pushHeartbeat(delta:15) } ``` **防重复 start:** `openMaterial` 检查 state != idle/closed → throw `SessionError.alreadyActive` **防 close 后 heartbeat:** `startHeartbeat` 检查 `state == .active` **adapter 注入:** 默认 `RustReadingRuntimeAdapter()`，可注入 mock 用于测试

wangdl closed this issue

2026-06-08 21:48:25 +08:00

wangdl referenced this issue

2026-06-08 21:58:39 +08:00

IOS-INFO-008 P0 | Heartbeat Timer / pause / resume 【审计: Timer已有，需接V2】 #73

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: wangdl/ios-projects#71