前言¶
在 DeepSeek Harness (DSH) Web 界面进行长对话调试或智能体开发时，面对数百个回合的上下文，原生滚动体验往往难以快速定位关键节点。该插件引入 Codex 风格的导航机制，将对话回合转化为纵向刻度，旨在解决上下文切换效率低和内容概览困难的问题。
插件简介¶
dsh-conversation-strip 是由 mldhao 维护的客户端插件，它为 DSH 主侧栏右侧添加了一列对话导航刻度。插件不修改 DSH 会话数据，仅通过浏览器中的 MutationObserver 读取已渲染的 DOM，确保隐私安全。
核心功能¶
-
Codex 风格刻度与卡片
在主侧栏右侧默认约 28px 的位置显示短横线刻度，每条短横线对应一个完整的“用户问题 + 助手回复”回合。悬停刻度时，会展开 Codex 风格卡片，显示用户问题、助手回复首行以及结构化摘要（标题、列表、段落）。 -
连续热区与精准定位
每个刻度具备连续的纵向悬停热区，鼠标穿过刻度间的视觉间距时，卡片不会反复闪烁。点击刻度可平滑定位至该回合开头，并显示短暂高亮。 -
自动测量与响应式设计
插件自动测量 DSH 主侧栏宽度，侧栏缩放或折叠时同步调整位置。当窗口宽度小于 900px 时，导航刻度会自动隐藏，以避免遮挡聊天区域。 -
智能过滤与设置
支持全部、对话、仅助手三种过滤方式。设置页面支持完整滚动，允许调整距侧栏边缘距离、刻度密度、自动跟随、悬停预览和动效。 -
交互反馈
在流式生成过程中，当前回合刻度带有轻微的呼吸效果。当消息较多时，围绕当前回合显示最多 24 个刻度，并提示前后还有内容。
安装与启用¶
通过 DSH 命令行安装插件：
dsh plugin --profile web add "D:\path\to\dsh-conversation-strip"
安装或更新后，必须彻底重启 DSH Web Profile，再执行一次 Ctrl+F5 强制刷新网页，插件才能正常加载。
典型用法¶
- 打开任意 DSH 对话，导航刻度会出现在主侧栏右侧。
- 将鼠标悬停在短横线上，展开邻近刻度并查看该回合的问题、正文首行和结构化摘要。
- 点击短横线，平滑定位到该回合开头。
- 使用快捷键快速导航：
-Ctrl+Shift+J：显示或隐藏对话导航
-Alt+↑：切换到上一个对话回合并定位
-Alt+↓：切换到下一个对话回合并定位 - 在 DSH 设置中打开“对话导航”，调整过滤、距离、密度、自动跟随和动效。
注意事项¶
- 推荐使用 DSH
0.1.1-rc.2或兼容版本。 - 插件以浏览器端权限运行，仅读取页面渲染的 DOM，不会上传对话内容或修改 DSH 会话数据。
- 生态背景：DSH 理念为“一切皆插件”，社区目录（如技能库）为独立站点，与 DeepSeek / 幻方无官方从属关系。
总结¶
dsh-conversation-strip 通过 Codex 风格的纵向刻度，为 DSH 用户提供了高效的长对话导航能力。无论是快速定位还是概览上下文，该插件都能显著提升调试体验。
