dsh-conversation-strip

Readme

# DSH 对话导航

一个用于 DeepSeek Harness（DSH）Web 界面的 **Codex 风格纵向对话回合导航插件**。它会在主侧栏右侧、聊天内容左侧的空白区域显示一列短横线；每条短横线对应一个完整的“用户问题 + 助手回复”回合。

[English](./README.en.md)

## 功能

- 参考 Codex 的极简纵向刻度：默认所有刻度等长，当前回合仅加深颜色；悬停后当前刻度与相邻刻度按距离逐级展开。
- 自动测量 DSH 主侧栏宽度，侧栏缩放或折叠后同步调整位置。
- 按对话回合聚合内容，而不是把用户消息和助手消息拆成两个刻度。
- 悬停刻度后，从右侧展开紧凑 Codex 风格卡片：顶部单行显示用户问题，下方显示助手正文首行，并用分隔线呈现标题、列表和段落；沿刻度上下移动时，同一张卡片会持续跟随目标刻度平滑滑动。
- 每个刻度都具有连续的纵向悬停热区，鼠标穿过视觉间距时不会反复闪烁或重新弹出卡片。
- 卡片纵向中心与对应刻度精确对齐，自动忽略 Think / 推理区块以及消息日期、时间、运行耗时等界面信息。
- 点击刻度可平滑定位到该回合开头，并显示短暂高亮。
- 流式生成中的回合带轻微呼吸效果；没有回复时显示“等待回复…”或“正在生成…”。
- 消息很多时围绕当前回合显示最多 24 个刻度，并提示前后还有内容。
- 支持全部、对话、仅助手三种过滤方式。
- 可设置距侧栏边缘、刻度密度、自动跟随、悬停预览和动效。
- 窄于 900px 时自动隐藏，避免遮挡聊天区域。
- 设置页面支持完整滚动，不会因窗口高度不足而被截断。

> 插件只通过浏览器中的 `MutationObserver` 读取当前页面已经渲染的 DOM，不会上传对话内容，也不会修改 DSH 会话数据。

## 快捷键

- `Ctrl+Shift+J`：显示或隐藏对话导航。
- `Alt+↑`：切换到上一个对话回合并定位。
- `Alt+↓`：切换到下一个对话回合并定位。

## 环境要求

- DeepSeek Harness Web Profile
- 推荐 DSH `0.1.1-rc.2` 或兼容版本

## 安装

如果系统中有全局 `dsh`：

```powershell
dsh plugin --profile web add "D:\path\to\dsh-conversation-strip"
```

从 DSH 源码仓库运行：

```powershell
cd "D:\path\to\deepseek-harness"
pnpm dsh plugin --profile web add "D:\path\to\dsh-conversation-strip"
```

安装或更新后必须彻底重启 DSH Web Profile，再执行一次 `Ctrl+F5` 强制刷新。仅刷新网页通常不会重新加载插件 bundle。

## 使用

1. 打开任意 DSH 对话。
2. 导航刻度会出现在主侧栏右边默认约 28px 的位置。
3. 将鼠标悬停在短横线上，展开邻近刻度并查看该回合的问题、正文首行和结构化摘要。
4. 点击短横线，定位到该回合开头。
5. 在 DSH 设置中打开 **对话导航**，调整过滤、距离、密度、自动跟随和动效。

## 开发与打包

```powershell
npm run check
npm test
npm run pack:release
```

安装包会生成在 `dist/`。

## 卸载

```powershell
dsh plugin --profile web remove dsh-conversation-strip
```

卸载后重启 DSH 并刷新网页。

## 许可证

MIT