DSH Codex Timeline
当前源码适配版：0.6.4 / DSH 0.2.0-rc.1。设置入口为“设置 → 内置插件 → Timeline”；设置与收藏写入 profile 的 cordis.patch.yml。历史搜索使用只读存储句柄，分支通过官方工作区服务打开。
English | 中文
DSH Codex Timeline 是 DeepSeek Harness Web 的轮次导航增强插件。0.6.4 针对 DSH 0.2.0-rc.1 的虚拟化导航增加显示适配层，恢复短横渐变、左右布局、自定义间距和收藏筛选。会话内容、历史加载及分支仍调用官方接口；关闭增强后恢复官方导航。
插件只补充官方导航目前没有的能力：完整会话搜索、收藏、从指定轮次分支、包含时间与 Token 消耗的轮次预览，以及原有的个性化布局选项。
[!IMPORTANT]
0.6.4 适配 DSH 0.2.0-rc.1；DSH 0.1.2-alpha.3 请继续使用插件 0.6.0。
功能
- 增强 DSH 原生轮次导航，提供阶梯波浪和高亮动效。
- 收藏常用轮次，并可在导航栏中只查看收藏内容。
- 搜索完整会话，快速定位并跳转到目标轮次。
- 查看轮次内容、时间和 Token 信息预览。
- 从已完成的轮次创建新分支。
- 自定义导航栏左右位置、边距、纵向偏移、标记间距和显示数量。
效果预览
常态
悬停与轮次预览
兼容性
DSH 从 0.1.2 系列开始内置原生轮次导航栏。0.6.4 为新版虚拟化导航提供显示适配层，保留插件的搜索、收藏、分支、预览、阶梯波浪和个性化布局；会话数据和历史加载仍由 DSH 管理。
- DSH
0.2.0-rc.1、0.1.7-rc.1 / 0.1.7-rc.2：使用插件 0.6.4。
- DSH
0.1.2-alpha.3：使用插件 0.6.0。
- 此前版本的 DSH：使用旧版插件
0.5.5，由该版本提供完整的独立时间线。
旧版插件可以通过 npm 指定版本安装：
dsh plugin --profile web add "dsh-codex-timeline@0.5.5"
也可以下载 v0.5.5 源码包。当前主分支的 install.ps1 接受上表中的 0.1.7 与 0.2.0 版本，不用于安装旧版插件。
安装
npm 与 GitHub Release 提供预构建发布包；安装后重启 DSH。桌面端可在插件管理中安装包名，CLI 用户使用实际 profile 名称（例如 web 或 desktop）。
以下步骤适用于 DSH 0.2.0-rc.1 及上表中的 0.1.7 版本。更早的 DSH 请按兼容表安装指定的旧版插件。
先确认本机版本：
dsh --version
安装 npm 发布包：
dsh plugin --profile web add dsh-codex-timeline@0.6.4
本地开发时可以直接链接当前目录：
.\install.ps1 -Profile web -Source "E:\Program\DSH_plugin\dsh-codex-timeline"
安装后重启 DSH Web 并刷新浏览器。设置位于“设置 → 内置插件 → Timeline”。
隐私
完整历史搜索通过同源 Host 路由 /codex-timeline/search 读取当前会话记录，只返回轮次摘要、有限上下文和本地日志已有的时间/Token 指标。搜索内容、收藏与交互状态不会发送给模型、遥测服务或第三方。
开发与验证
pnpm install
pnpm run check
pnpm pack --pack-destination artifacts
scripts/verify-dist.mjs 会阻止旧 Conversation 副本、自建导航座位、Portal、私有运行时依赖或本机路径重新进入发布包，并验证 DSH 0.2.0-rc.1 的插槽、会话 API、设置和分支锚点契约。
License
MIT。当前版本不再分发官方 Conversation 或 TurnNavigator 实现；互操作与归属说明见 NOTICE。
DSH 0.2.0-rc.1 兼容更新（2026-09-29）
支持 DSH 0.2.0-rc.1，并保留 0.1.7-rc.1 / 0.1.7-rc.2 的兼容声明。宿主核心包通过可选 peerDependencies 声明，不再作为生产依赖安装，避免插件带入旧版核心。升级插件后请重启 DSH；未来版本仍需验证后扩展兼容范围。
