dsh-conversation-outline

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

English

概览

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

解决什么问题：

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

效果图

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

兼容性

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 加入 <profile>/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 作为旧版回退）。

权限与数据

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

故障排查

开发

见 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）。收录 ≠ 兼容性审计；安装前请自行审查源码。