liliuCourier/dsh-chat-outline

dsh-chat-outline — DeepSeek Harness 插件

awesome · DSH plugin

对话一长就没法一直往上翻了。这个插件在对话栏左侧常驻一个侧边栏式对话大纲：按轮次列出每次提问和该轮最后一条回复，点击任意一条即可跳回对应位置，按住 Ctrl/Shift 再点击则直接切到轨迹视图的同一位置。蓝框会始终标记你当前读到哪，随滚动跟随；面板可一键收起以恢复对话全宽。顶部的输入框可以按关键词过滤。它有两种模式：默认的轻便模式只反映官方已加载的窗口，零额外开销；需要完整大纲时可切换到全面模式，进入即主动加载全部历史（长会话会有明显的性能开销）。

dsh-chat-outline 演示

中文文档

功能特性

- 按轮次列出每次提问与该轮最后一条回复，点击即定位
- 侧边栏式固定布局（260px），窄窗口也常驻显示，对话内容自动让位
- 头部 ▸ 一键收起/展开，收起即恢复对话全宽
- 蓝框标记当前阅读位置，随滚动跟随
- 两种模式，头部按钮切换，选择会被记住：
- 轻便模式（默认）：大纲只显示官方已加载窗口的内容，零额外加载；
- 全面模式：进入即主动加载全部历史，覆盖整个会话
- 按住 Ctrl/Shift 点击条目，直接切到轨迹视图并定位到对应位置
- 支持按关键词过滤
- 跟随 DSH 明暗主题

安装

通过 npm 安装：

dsh plugin --profile web add dsh-chat-outline

或者从 GitHub 安装：

dsh plugin --profile web add github:liliuCourier/dsh-chat-outline

然后在 $DSH_HOME/profiles/web/cordis.patch.yml 中加入：

- insert:
- id: dsh-chat-outline
name: dsh-chat-outline

最后刷新浏览器页面即可生效。

从 0.1.6 起包内已含 dsh.bundle，通过 npm / GitHub 安装会自动激活，无需手动追加上面的 insert；手动 insert 仅对旧版本或源码目录安装适用。

使用

面板常驻在对话栏左侧，为固定宽度的侧边栏式布局（对话内容自动让位）。每条记录分「我」和「助手」两行，点击任意一行即可跳转。按住 Ctrl/Shift 再点击，会切到轨迹视图并定位到同一位置。面板头部右侧的 ▸ 可收起面板恢复对话全宽，收起后点聊天区左缘的 ☰ 重新展开。面板顶部的输入框支持按关键词过滤。

轻便模式与全面模式

面板头部右侧有两个按钮：模式按钮（轻便/全面）切换两种模式，选择会被记住；最右侧的 ▸ 按钮可收起（缩进）对话定位边栏、恢复对话全宽，收起后点聊天区左缘的 ☰ 重新展开。

模式与收起按钮位置（面板头部右侧）

- 轻便模式（默认）：大纲只显示官方已加载窗口里的内容，插件不做任何额外的历史抓取，零性能开销。窗口只覆盖最近的一部分时，大纲里也只有最近的轮次；想看到更早的内容，点聊天区官方自带的「加载更早记录」按钮把窗口往前扩，大纲会跟着变全。
- 全面模式：进入会话（对话加载完成后）即主动分页加载全部历史，大纲覆盖整个会话，不用去点官方的加载按钮。

⚠️ 性能警告：全面模式会在后台逐页解析整个会话历史，长会话（尤其是带大量工具调用和流式输出的会话）会明显拖慢加载与整体响应，请按需开启。轻便模式没有这个问题。

对话与轨迹的跳转关系

对话和轨迹是同一个会话的两种视图：对话按轮次展示内容，轨迹按请求、工具调用和时间线展示执行过程。大纲面板里的每条记录都对应会话中的一个位置，两种跳转方式落点是同一个：

- 单击：在对话视图里滚动定位到对应消息；
- 按住 Ctrl 或 Shift 单击：切到轨迹视图，定位到同一位置。提问行落在轨迹中的用户消息行，回复行落在这轮最后一条回复所在行。

两个视图共用同一套事件编号，所以无论当前在哪个视图，跳转后看到的都是同一条内容。

常见问题

- Windows 下 Git 报 SSL 凭据错误：fatal: schannel: AcquireCredentialsHandle failed: SEC_E_NO_CREDENTIALS。这是 Windows Git 的 schannel 后端问题，改用 OpenSSL 后端即可：

git -c http.sslBackend=openssl clone https://github.com/liliuCourier/dsh-chat-outline.git

或者直接使用 npm 方式安装，不经过 Git。
- 安装时提示 peer dependency 警告：pnpm 报 unmet peer dependency 属正常，DSH 的 web bundle 已包含这些模块，不影响使用。
- 安装后看不到面板：先刷新浏览器页面，必要时重启 dsh web。服务端清单会即时更新，但已经打开的页面需要刷新一次才会加载插件。

兼容性

适配 DSH 0.1.0-rc.7（已在 rc.7 上验证，暂未发现问题；rc.6 同样可用）。DSH 升级后如遇异常，请更新插件。

许可证

MIT

English Documentation
长对话让回滚变得痛苦。此插件在聊天栏左侧保留一个常驻侧边栏大纲：每个问题及其最终回复按轮次列出，一键跳转到任意一轮——按住 Ctrl/Shift 点击可直接跳转到 Trajectory 视图中的同一位置。蓝色边框始终标记你正在阅读的位置并跟随滚动，面板可一键折叠以恢复完整聊天宽度。顶部的输入框可按关键词过滤。它有两种模式：默认的 Light 模式仅反映官方已加载的窗口，零额外开销；切换到 Full 模式可获得完整大纲，进入时会主动加载全部历史记录（长会话中开销明显）。

功能

- 按轮次列出每个问题及其最终回复；点击任意条目即可跳转
- 固定宽度侧边栏布局（260px），在窄窗口中依然可见；聊天内容为其让出空间
- 通过标题栏的 ▸ 按钮折叠/展开；折叠后恢复完整聊天宽度
- 蓝色边框标记你当前的阅读位置并跟随滚动
- 两种模式，通过面板标题栏中的按钮切换；选择会被记住：
- Light 模式（默认）：大纲仅反映官方已加载的窗口——零额外加载；
- Full 模式：进入时主动加载全部历史记录，覆盖整个会话
- Ctrl/Shift+点击条目可直接跳转到 Trajectory 视图中的该位置
- 按关键词过滤
- 跟随 DSH 浅色/深色主题

安装

通过 npm：

dsh plugin --profile web add dsh-chat-outline

或从 GitHub：

dsh plugin --profile web add github:liliuCourier/dsh-chat-outline

然后将以下内容添加到 $DSH_HOME/profiles/web/cordis.patch.yml：

- insert:
- id: dsh-chat-outline
name: dsh-chat-outline

最后，刷新浏览器页面。

自 0.1.6 起，该包附带 dsh.bundle 清单，因此 npm / GitHub 安装会自动激活——上面的手动插入仅适用于旧版本或源码文件夹安装。

用法

面板作为固定宽度侧边栏停留在对话左侧（聊天内容为其让出空间）。每个条目有一行“Me”和一行“AI”；点击任意一行即可跳转。按住 Ctrl/Shift 点击可切换到 Trajectory 视图中的同一位置。面板标题栏右侧的 ▸ 按钮可折叠面板以恢复完整聊天宽度；聊天左边缘的浮动 ☰ 按钮可重新展开它。顶部的输入框可按关键词过滤列表。

Light 模式与 Full 模式

面板标题栏右侧有两个按钮：模式按钮（Light/Full）在两种模式之间切换并记住你的选择；最右侧的 ▸ 按钮折叠（收起）大纲侧边栏以恢复完整聊天宽度——聊天左边缘的浮动 ☰ 可重新展开它。
模式和折叠按钮（面板标题右侧）

- 轻量模式（默认）：大纲只显示官方已加载窗口内的内容。插件不会额外拉取历史记录，因此没有任何性能开销。当窗口只覆盖会话的近期部分时，大纲也只列出近期的轮次；要查看更早的条目，请点击聊天中官方的“加载更早记录”按钮来扩展窗口——大纲会随之更新。
- 完整模式：会话加载完成后，插件会主动分页遍历整个历史记录，使大纲覆盖整个会话，无需官方加载按钮。

⚠️ 性能警告：完整模式会在后台解析整个会话历史。长会话——尤其是包含大量工具调用和流式输出的会话——加载和响应会明显变慢。仅在你需要完整大纲时启用它。轻量模式没有这种影响。

聊天与轨迹跳转之间的关系

聊天和轨迹是同一会话的两种视图：聊天按轮次排布对话，而轨迹按请求、工具调用和时间线展示执行过程。每个大纲条目都映射到会话中的一个位置，两种跳转方式会落到同一处：

- 点击：将聊天滚动到对应的消息。
- Ctrl/Shift+点击：切换到轨迹视图中的同一位置。问题条目会落到用户消息行；回复条目会落到该轮次的最后一条助手消息行。

两种视图共享相同的事件编号，因此无论你从哪个视图跳转，最终都会落到同一段内容上。

故障排除

- Windows 上的 Git SSL 凭据错误：fatal: schannel: AcquireCredentialsHandle failed: SEC_E_NO_CREDENTIALS。这是 Windows 上 Git 的 schannel 问题；请切换到 OpenSSL 后端：

git -c http.sslBackend=openssl clone https://github.com/liliuCourier/dsh-chat-outline.git

或者直接通过 npm 安装，它不会经过 Git。
- 安装期间的对等依赖警告：pnpm 可能会报告 unmet peer dependency；这些是预期内的，无害——DSH web 打包包已经包含了这些模块。
- 安装后面板不可见：先刷新浏览器页面，必要时重启 dsh web。服务器清单会立即更新，但已打开的页面需要刷新才能加载插件。

兼容性

适用于 DSH 0.1.0-rc.7（已在 rc.7 上验证，目前未发现问题；rc.6 也可用）。如果你在 DSH 升级后遇到问题，请更新插件。

许可证

MIT