前言¶

在 DeepSeek Harness Web 里跑长会话时，常见的问题是：会话变长后，回找某一条用户输入很麻烦；如果只靠正文滚动，既慢也容易漏掉未加载的历史内容。

dsh-codex-timeline 是面向 DeepSeek Harness Web 的一个插件，提供 Codex-style turn timeline and local conversation search。它不改变模型回复本身，而是在页面侧增加一条用户 Turn 导航轨道，并支持对本地持久化会话日志做关键词搜索。

下面介绍它的定位、能力、安装方式、典型用法和注意事项。

这是什么¶

dsh-codex-timeline 由 Wine-Red 维护，许可证为 MIT。它面向 DSH Web 长会话，主要解决三件事：

• 为长会话提供用户 Turn 导航轨道，只标记真正改变会话方向的用户轮次。
• 在正文旁提供完整历史索引、预览、搜索和可靠跳转。
• 默认位于左侧，也可以完整镜像到右侧。

资料中给出的兼容 DSH 版本是 0.1.1-rc.2，Node.js 要求为 ^22.19.0 || >=24.0.0。

核心能力¶

轮次轨道¶

• 宿主 lite=1 索引覆盖完整持久化会话，不再截断 500 轮；正文仍只按需加载。
• 桌面轨道显示固定窗口，默认最近 25 轮，可调 5–50。
• 每个可滚方向额外保留两级完整边缘指引。
• 主索引与边缘指引支持预览、点击、Enter / Space 和方向键。
• 未激活时保持低干扰静态样式。

跳转与滚动¶

• 滚动正文时，轨道自动指示当前 Turn。
• 鼠标滚轮每格精确移动一轮。
• 连续滚动会从当前动画中间帧重新定向。
• 触控板小幅输入会先累积。
• 到达边界后，把滚动交还正文。

预览、搜索与设置¶

• 预览卡显示“第 x / y 条”、时间、状态、两行提问、两行回答，以及可用时的本轮用时、首 token 延迟和 tok/s。
• 搜索同时覆盖已加载正文与完整持久化会话日志，合并并高亮关键词上下文；未加载命中也能一次选择直达。
• 支持搜索、收藏、键盘导航。
• 设置项包括启用、跳转后闪烁提示、显示在右侧、距边缘距离、向中部偏移、标记间距、显示轮次数量。
• 窄屏使用折叠入口；桌面端点击未加载索引时自动补页。

全量搜索通过同源宿主路由 /codex-timeline/search 读取持久化会话日志，仅按关键词返回匹配轮次的摘要与上下文窗口；不会发给模型、不会写入遥测，也不会将内容发送到任何第三方。

安装与启用¶

先确认当前 DSH 版本，避免在不兼容版本上强行安装：

dsh --version

资料给出的兼容版本是 DSH 0.1.1-rc.2。如果后续升级 DSH，应先卸载本插件。

从 npm 安装到 Web profile：

dsh plugin --profile web add dsh-codex-timeline

也可以使用仓库内的版本检查脚本：

powershell -ExecutionPolicy Bypass -File .\install.ps1

安装后重启 DSH Web 进程并刷新页面。可以用下面命令确认 bundle 已生效：

dsh --profile web --dump-config | Select-String -Pattern "dsh-codex-timeline|ui-conversation"

从旧的本地覆盖版迁移¶

如果之前安装过旧的本地覆盖版，先移除旧包，再安装 dsh-codex-timeline：

dsh plugin --profile web remove "@deepseek-ai/dsh-client-ui-conversation"
dsh plugin --profile web add dsh-codex-timeline

卸载¶

dsh plugin --profile web remove dsh-codex-timeline

或者运行：

powershell -ExecutionPolicy Bypass -File .\uninstall.ps1

典型用法¶

1、滚动正文，轨道自动指示当前 Turn。

2、悬停查看两行提问与两行回答，点击或按 Enter / Space 跳转。

3、对未加载的轮次直接点击一次；插件会自动补齐所需历史、恢复阅读锚点并完成定位。

4、在轨道上滚轮每格移动一轮；到达首尾后，滚动会自然交还正文。

5、需要时使用搜索、收藏、键盘导航，或在设置中调整显示轮数与左右位置。

开发与验证¶

如果从源码构建，先做安装、检查和打包：

pnpm install
pnpm run check
pnpm pack --pack-destination artifacts

安装本地 tarball 做 profile 契约验证：

dsh plugin --profile web add ".\artifacts\dsh-codex-timeline-0.5.5.tgz"
dsh --profile web --dump-config

DSH 升级时，不要直接放宽 peer dependency。至少执行：

dsh --version
dsh --profile web --dump-config
pnpm run check
pnpm pack --pack-destination artifacts
pnpm run test

完成这些检查后，再核对兼容性契约。

适用场景与注意¶

• 适合需要频繁回溯 DSH Web 长会话中用户轮次的开发者。
• 适合需要在本地会话日志中搜索关键词上下文，并且不希望搜索内容发给模型或第三方的场景。
• 插件以当前 DSH 进程权限运行，安装前应检查源码、许可证和兼容性声明。
• 资料给出的兼容版本是 DSH 0.1.1-rc.2；请勿在其他 DSH 版本上强行安装，升级 DSH 前先卸载本插件。
• 许可证为 MIT；本包包含基于 DeepSeek Harness MIT 源码构建的 0.1.1-rc.2 compatibility adapter，上游衍生代码的许可见 NOTICE。
• lib/client.js 是为 DSH 0.1.1-rc.2 生成并锁定 SHA-256 的 compatibility artifact。

结尾¶

dsh-codex-timeline 的价值，是把 DSH Web 长会话里的“回找某条用户输入”从手动滚动，变成轨道索引、本地搜索和可靠跳转。

GitHub 地址：https://github.com/Wine-Red/dsh-codex-timeline

插件名：dsh-codex-timeline

另有插件线索给出目录页 https://www.skillhub.cn/plugins/Wine-Red/dsh-codex-timeline，但该 URL 未在本批已核实资料中确认，使用前请自行核对。