对话大纲 YesSanSan/dsh-conversation-outline

dsh-conversation-outline

对话大纲 —— 一个静态 DSH Web 插件：在 DSH-better-sidebar 侧边栏注册「对话大纲」tab，把当前会话按轮次结构化展示，为每一轮用 LLM 生成一句话标题，并支持点击跳转到对应消息。

License: MIT
GitHub release
dsh-plugin
better-sidebar

概览

适合谁：使用 DeepSeek Harness Web（npx @deepseek-ai/dsh web）、希望快速浏览当前会话结构、不用来回滚动长对话的用户。

解决什么问题：

- 按轮次结构化大纲 —— 用户消息、助手回复、工具调用（连续调用自动合并为可折叠分组）、压缩检查点、错误行，全部按轮次分组展示。
- 一键跳转 —— 点击任意条目，自动加载历史并滚动到聊天视图 / 轨迹视图的对应行。
- 每轮一句话标题 —— Host 直接调用 llm.stream 生成（不创建 subagent），按内容指纹缓存；分支会话前缀相同即可复用标题。
- 标题生成完全并行 —— 已结束轮次即时生成，即使 agent 仍在处理后续轮次；只有当前进行中的轮次等待本轮结束。
- 可配置 —— 标题模型、推理等级、并发数、单次超时、失败重试、禁用开关，全部在齿轮设置中持久化。
- 窄面板自动收缩 —— 面板变窄（≤360px）时，行内类型标签（用户/助手/工具等）自动从文字收缩为图标（悬停显示文字），与轨迹视图行为一致。

效果图

右侧边栏中的「对话大纲」面板：按轮次折叠展示，每轮带 LLM 标题，点击任意条目可跳转到对应消息。

兼容性

| 项目 | 值 |
| 平台 | DSH web（npx @deepseek-ai/dsh web） |
| 客户端平台 | dsh.client.platform = "web" |
| 依赖 | dsh-better-sidebar v0.12.0+（settings.render 与 pluginSettings） |
| Peer 依赖 | @deepseek-ai/dsh-client-runtime、@deepseek-ai/dsh-client-ui-primitives、dsh-better-sidebar（可选 peer） |
| 最后验证 | DSH web profile + better-sidebar v0.12.0（本地构建），2025 |

npm 上的 dsh-better-sidebar 可能仍是 0.11.0；v0.12.0 功能需从源码构建后链接到 profile
（见 better-sidebar 文档）。

安装

方式一：一行命令（推荐）

直接安装到你的 web profile，无需手动 clone：

npx @deepseek-ai/dsh plugin --profile web add github:YesSanSan/dsh-conversation-outline#main

git 托管插件安装时会执行构建脚本，pnpm 默认拦截；若提示需要 allowBuilds，
把 pnpm 打印的 key 加入 /pnpm-workspace.yaml 的 allowBuilds 后重跑即可。
本插件是纯 JS 静态包，通常无需构建脚本。

方式二：clone 后本地安装

git clone https://github.com/YesSanSan/dsh-conversation-outline
cd dsh-conversation-outline
npx @deepseek-ai/dsh plugin --profile web add .

重启与启用

重启 DSH：

npx @deepseek-ai/dsh web

打开 better-sidebar 的 + 菜单，选择「对话大纲」。

卸载

npx @deepseek-ai/dsh plugin --profile web remove dsh-client-ui-conversation-outline

快速开始

1. 安装插件后启动 npx @deepseek-ai/dsh web。
2. 打开任意会话，在侧边栏 + 菜单添加「对话大纲」tab。
3. 大纲展示每轮及其 LLM 标题；点击条目即可跳转。
4. 可选：齿轮设置里选择标题模型 / 推理等级，或调整超时与重试。

配置

持久化到 better-sidebar pluginSettings['conversation-outline'] （localStorage 键 dsh-conversation-outline-settings:v1 作为旧版回退）。

| 键 | 默认 | 范围 | 含义 |
| model | '' | — | 标题模型；空 = 跟随主会话模型 |
| reasoningEffort | '' | off / low / medium / high / max | 推理等级；空 = 跟随会话 |
| maxConcurrency | 3 | 1–8 | 客户端并发生成标题的 worker 数 |
| timeoutSeconds | 60 | 5–300 | 单次尝试超时；对整个尝试生效（Promise.race 强制） |
| maxRetries | 2 | 0–5 | 失败重试次数（退避 0.8s 起，封顶 5s） |
| disabled | false | — | 完全禁用标题生成 |

权限与数据

- 会话日志：Host 通过 ctx.sessionQuery（readSession / listEvents）只读当前会话日志构建大纲，不回写。
- LLM 调用：标题生成只把当前轮可见文本（用户 + 助手块，去掉工具调用，截断）发送到配置的模型路由，提示词为固定短摘要指令。
- 浏览器存储：标题缓存于 localStorage（dsh-conversation-outline-titles:v1）；设置在 pluginSettings + localStorage。
- 不读取任何凭据；除配置的模型 provider 外无其他网络访问。

故障排查

| 现象 | 含义 / 处理 |
| 标题一直「等待本轮结束...」 | 该轮尚无 turn/end 事件，是当前运行中的轮次；本轮结束后自动生成。 |
| 「未生成 · title timeout after ...」 | 单次尝试超过 timeoutSeconds（网络/模型卡顿）。调大超时或检查模型路由。 |
| 「未生成 · signals[0] is not of type AbortSignal」 | 静态 Host（Node）有真实 AbortController，正常不应出现；如出现请附日志反馈。 |
| 更新后标题不生效 | 静态包与 Host 半需要完整重启 npx @deepseek-ai/dsh web，再刷新浏览器。 |
| 没有「对话大纲」tab | 确认 better-sidebar v0.12.0+ 且插件已安装（dsh --profile web --dump-config）。 |
| 失败标题缓存 60 秒 | 瞬时错误缓存 60s 后自动重试；确定性错误（无文本 / 无 Agent / 无模型参数）永久返回。 |

开发

见 docs/PLUGIN_DEV_NOTES.md：WebUI 关键接口（slots、会话快照、锚点）、目录行为与最容易踩的坑。dev/dynamic/ 保留早期动态插件原型供对比，正式交付以仓库根目录静态包为准。

npm run check # node --check index.js && node --check client.js

贡献方式：fork → 修改 → npm run check → 提 PR。客户端是手写 window.__ModuleLoader__.load bundle，无需构建步骤。

许可证与安全

MIT。安全问题请通过 Issues 私密反馈，或先邮件联系作者，再公开披露。

已收录于 awesome-dsh-plugins 插件生态目录（dsh-plugin topic）。收录 ≠ 兼容性审计；安装前请自行审查源码。