DOC-FULL-034：V1 → V2 兼容层 #110

New Issue

wangdl · 2026-06-10T21:18:33+08:00

wangdl commented

2026-06-10 21:18:33 +08:00

目标

保留 V1 接口 deprecated，同时新增 V2 独立模块，避免 iOS 当前接入直接断裂。

要求

V1 不直接删除。
V1 标记 deprecated。
V2 使用独立模块或命名空间。
V1 的 active_seconds 不再作为新 API 计时依据。
V2 使用 activeSecondsDelta。
iOS 可逐步从 V1 迁移到 V2。

需要提供

v1 deprecated 标记
v2 module
V1/V2 差异文档
迁移说明

验收标准

V1 仍可编译。
V2 新接口可用。
V1 deprecated 信息清楚。
文档说明 active_seconds 与 activeSecondsDelta 差异。
文档说明 iOS 迁移路径。
有基础兼容测试。

## 目标保留 V1 接口 deprecated，同时新增 V2 独立模块，避免 iOS 当前接入直接断裂。 ## 要求 1. V1 不直接删除。 2. V1 标记 deprecated。 3. V2 使用独立模块或命名空间。 4. V1 的 active_seconds 不再作为新 API 计时依据。 5. V2 使用 activeSecondsDelta。 6. iOS 可逐步从 V1 迁移到 V2。 ## 需要提供 - v1 deprecated 标记 - v2 module - V1/V2 差异文档 - 迁移说明 ## 验收标准 1. V1 仍可编译。 2. V2 新接口可用。 3. V1 deprecated 信息清楚。 4. 文档说明 active_seconds 与 activeSecondsDelta 差异。 5. 文档说明 iOS 迁移路径。 6. 有基础兼容测试。

wangdl added this to the M-DOC-FULL：Document Runtime 完整阅读内核与学习事件协议 milestone 2026-06-10 21:18:33 +08:00

wangdl added the

priority:p0

area:document-runtime

repo:document-runtime

labels 2026-06-10 21:18:33 +08:00

wangdl commented

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

完成证据

产物: (83 行)
提交:

内容:

V1 保留 deprecated（events.rs, reading_material.rs）
V2 独立模块列表 (reading_material, session_v2, events_v2, time_tracker, progress)
V1 vs V2 差异表（8 维度）
iOS 迁移路径（4 阶段）
active_seconds vs activeSecondsDelta 差异说明
FFI 接口对比表
V1 仍可编译，V2 169 tests pass

## 完成证据 **产物**: (83 行) **提交**: **内容**: - V1 保留 deprecated（events.rs, reading_material.rs） - V2 独立模块列表 (reading_material, session_v2, events_v2, time_tracker, progress) - V1 vs V2 差异表（8 维度） - iOS 迁移路径（4 阶段） - active_seconds vs activeSecondsDelta 差异说明 - FFI 接口对比表 - V1 仍可编译，V2 169 tests pass

wangdl closed this issue

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

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: wangdl/zhixi-document-runtime#110