# BetterLearn for DSH 路线图

本路线图只描述独立 DSH 插件主线，不继承旧 Nobei 的企业产品化批次或 Claude Code sidecar 方案。

## P0：独立仓库收口（已完成）

- 独立构建、测试与 tarball 验证通过；
- 建立 DSH rc.7 开发基线，运行兼容性后续由 P4 实测；
- 默认验证不依赖旧仓库、旧数据库和历史 evidence。

## P1：状态同步闭环（已完成）

- Core 生成完成后 WebUI 自动进入审核界面；
- 短轮询作为同步机制：1→2→4→8 秒退避，有新事件即重置回 1 秒；
- 失败、重试和恢复的基础文案已具备。

## P1.1：体验优化（已完成）

- Host 在生成结果写入 Core 后通过 SSE 发送状态变化提示，唤醒现有 pollRun，立即读取状态并进入审核；
- 1→2→4→8 秒轮询兜底保留；SSE 断开静默回退，进入审核/终态、切换任务或卸载时释放订阅；
- 失败、重试和恢复文案已统一审计；审核失败页补上“重新连接”，复用既有幂等审核恢复；
- 仅新增通知通道，不新增业务状态副本、Core 轮询或 Python RPC。实现约定见 [架构](architecture.md)，定向验证见 [验证说明](validation.md)。

## P2：独立产品数据模型（已完成）

- 产品自有11表，去掉旧v8、p1前缀、import_jobs双投影和单块chunks正文；
- 不可变候选与审核定稿分离，全部证据使用文档绝对Unicode字符坐标；
- 写事务维护计数，读取不重算原始输出、证据或历史账本；
- 干净重建，无旧数据迁移，原公开快照字段保持兼容。

设计稿见 [数据模型设计](data-model.md)。

## P3：能力扩展（已完成）

- 有文字层PDF的只读解析与预览，扫描/加密/损坏文件明确提示；
- 长文物理分块，实际执行L2语义规划与分组、L3重叠容器与边界提取；
- 跨批次同一知识点合并多证据，重复quote以范围与相邻上下文消歧；
- 真实DSH浏览器覆盖Unicode、80,006字符尾段、多证据切换与审核；
- 正文512KiB、PDF5MiB，不支持OCR；模型语义质量不由fake验收担保。

## P4：交付（已完成）

- tarball内CLI支持安装、前台启动、先备份再升级、保留数据卸载；
- 在线SQLite备份、离线恢复前保存现库，运行中恢复明确拒绝；
- 真实DSH rc.8独立安装与不同版本插件包升级演练通过；
- 重启、恢复、升级、卸载的数据结果逐项核对通过；
- 安装说明与限制已记录；未发布npm、未推送远程，也不新增后台服务。

2026-08-31验收标准与结果见 [验证说明](validation.md) 和 [交付记录](delivery-plan.md)。历史真实模型、授权批次和provider账本封存，本轮零真实模型调用。