lzbaclz/dsh-conversation-outline

dsh-conversation-outline

banner

npm
npm downloads
license
node
stars
dsh plugin

English · 使用文档 · 常见问题 · 安全说明 · 发布指南 · 设计规格

找到任何一次提问，一键跳回任何一处回答。

智能体的长对话滚起来没完。dsh-conversation-outline 是
DeepSeek Harness Web 的 Codex 风格「会话大纲」插件：
界面右侧一条常驻细竖条——每个问题一根小横条，像一张会话的 minimap——鼠标悬停即展开
预览面板，列出每个问题开头的几个字。点一下横条或某一行，直接瞬移到 Chat 视图里的那条消息，
并高亮闪烁让你不会看漏。界面中英双语（zh-CN / en）。

亮点

- 右侧细条（minimap）——紧贴右边缘的窄竖条，按时间顺序每个问题一根小横条。
平时不占地方、不影响阅读；超过 60 个问题折叠为顶部 +N 标记。
- 悬停预览——鼠标移到细条上，面板滑出：每个问题开头几个字（单行截断）、#轮次
徽标与 HH:MM 时间。移开 240ms 后自动收起。纯覆盖层，正文布局纹丝不动。
- 点击也能打开——点细条本身（或任意一根小横条）会把面板钉住，直到你用 Esc、
× 或点击面板外才关闭；因此触屏、手写笔、自动化脚本这类「永远没有 hover 事件」的场景
同样可用。
- 点击跳转——即使停在「轨迹」视图也会自动切回聊天视图，滚动定位并闪烁 1.8s，
尊重 prefers-reduced-motion；万一目标消息不在已加载的历史窗口里，面板会明确告诉你，
而不是静默失败。
- 搜索 & 加载更早——大小写不敏感过滤 + 翻历史分页。
- 实时——会话进行中新问题自动出现；跟随当前会话，切换即收起。
- 运行时零依赖——浏览器包只引用 React 等平台公共模块，其余全部内联并在构建期
过「纯度门」检查。

安装

环境要求：DSH ≥ 0.1.5-rc.2（next 通道 / DSH Desktop 桌面版）。

| 插件版本 | 适配的 DSH |
|---|---|
| 0.2.x | DSH ≥ 0.1.5-rc.2 |
| 0.1.2 及更早 | DSH 0.1.0-rc.x（Chat 节点图还在 snapshot.chat 里） |

用 DSH Desktop 桌面版？ 在应用内终端执行同样的命令、不用写 --profile
（会自动指向 desktop profile）。首次安装需要重启一次；以后升级走热更新，无需重启。

前置要求：已安装 DeepSeek Harness
（dsh 命令可用）且版本 ≥ 0.1.5-rc.2；Node.js ^22.19 或 >=24；pnpm 10+。
通过 npx 运行 DSH 的话，给下面命令加上 npx -p @deepseek-ai/dsh  前缀。
更老的宿主请装插件 0.1.3，见兼容表。

1) npm（推荐，一条命令）
dsh plugin --profile web add @chestnut23/dsh-conversation-outline

2) GitHub（最新提交，无需构建步骤）
dsh plugin --profile web add github:lzbaclz/dsh-conversation-outline
注意：npm 上无 scope 的同名包属于另一个无关项目，
务必安装 @chestnut23 scope）
dsh plugin --profile web add @chestnut23/dsh-conversation-outline

3) 从源码（本地开发）
git clone https://github.com/lzbaclz/dsh-conversation-outline.git
cd dsh-conversation-outline
pnpm install && pnpm build
dsh plugin --profile web add "link:$(pwd)"

GitHub 路径零构建脚本：本仓库把构建产物 lib/ 一并提交（.gitignore 故意不忽略），
github: 安装拿到的就是可直接加载的产物——不需要 prepare 脚本，也不需要 profile
里的 allowBuilds 配置。
名称提醒：npm 上无 scope 的 dsh-conversation-outline 属于另一个无关项目；
本插件只以 @chestnut23/dsh-conversation-outline 发布，请务必安装带 scope 的名字
（或走上面的 GitHub 路径）。

安装之后：重启 DSH Web 服务并刷新页面（link: 安装只需在 pnpm build 后刷新）。
确认插件在 profile 里：

dsh plugin --profile web list

升级用同一条 add 命令（可钉版本：@chestnut23/dsh-conversation-outline@0.1.4）。

与官方「Turn navigation」轨道的关系

DSH 0.1.5 自带一条右边缘轨道（TurnNavigatorRail），它按 turn 打刻度、标签写作
Turn N——其 prompt 预览字段是空的，所以从不显示你的提问原文（实测某会话 72 个
turn 却只有 2 个提问），而且刻度仅 20×10px、无文字，无法分辨哪条对应哪个问题。

因此本插件加载期间会隐藏那条轨道（通过 nav[aria-label] 识别，另有面向视图重建的
结构化兜底，并用 MutationObserver 持续补标记），由本插件接管右边缘。该行为完全可逆：

- 卸载插件会自动恢复官方轨道；
- 想让它与本插件并存：在  上加 data-dsh-outline-keep-turn-nav，例如在浏览器
控制台执行 document.documentElement.setAttribute('data-dsh-outline-keep-turn-nav','')。

使用

装好重启后，打开任何一个已有消息的会话，右侧边缘会出现细竖条：悬停预览问题；点击细条
（或小横条）打开并钉住面板；点列表行跳转；搜索过滤、加载更早 翻历史。
完整走查：docs/usage.md。没看到？先看 常见问题。

界面预览

真实截图占位：装好后把细条 + 面板的截图放到 assets/ui.png，就会显示在这里。

会话大纲

开发

pnpm install     # 安装钉死版本的 @deepseek-ai 0.1.5-rc.2 类型包
pnpm typecheck   # host + client 双 tsc program
pnpm build       # tsc(host) → tsc(client) → tsdown 打包 lib/client.js
pnpm verify      # 离线冒烟：manifest/exports/patch/产物形状 + 纯逻辑断言
pnpm test:dom    # 无头 DOM 测试：jsdom 里挂载真实组件，断言细条渲染/悬停/点击跳转

类型面由 devDependencies 里钉死版本的 @deepseek-ai/ 0.1.5-rc.2 包提供（npm 上有
完整 lib/types/）。注意 DSH Desktop 应用内置的副本裁掉了声明文件*，所以不要把
类型指到 Electron 的 node_modules；类型版本与运行时版本保持一致，才能真正校验适配。

热更新：DSH 组合常驻 dsh-client-hmr 链（实测桌面版组合 - id: client-hmr，未禁用），
它监听已安装插件 bundle 的变化并自动重载：

- 升级已装插件 → 热更新，无需重启应用，页面通常自动生效（开发时 pnpm exec tsdown --watch
改完即生效；手动 pnpm build 后刷新页面亦可）
- 首次新增插件（名册新增条目）→ 需要重启一次 DSH 服务

scratch profile 测试配方：docs/implementation-spec.md §4.2。

一起聊聊

随时欢迎提 issue：点这里。
问题、点子、你用这个插件做了什么、截图——都欢迎。

License

MIT——见 LICENSE。纯客户端插件：无遥测、无额外网络请求
（安全说明）。