dsh-conversation-overview
gushengsheng/dsh-conversation-overview
Conversation turn overview: a header button turns the chat into a per-turn list with jump-to-turn, focus selection, cross-session distribution, browsing other sessions for that agent to read, and multi-session task composition into a brand new session.
설치
dsh plugin --profile web add github:gushengsheng/dsh-conversation-overviewREADME
dsh-conversation-overview
把 DSH 的对话变成一张可以跳转、勾选、分发的目录。
一个 DeepSeek Harness 插件:长对话快速定位、选中几轮让 AI 重点看、把内容发给别的会话、把多个会话合成一个新任务。
A conversation turn overview plugin for DeepSeek Harness.

截图使用示例数据,仅用于展示界面。
先统一几个词
- 会话:左侧列表里的一个对话。
- 轮次:一次你的提问 + AI 的回复。
- 批注:用
@changfenhuang/dsh-annotation选中一段文字后写的备注。本插件只读「待发送」的批注。
它解决什么问题
- 对话太长,想翻回第 3 轮、第 18 轮,只能一直往上滚;
- 想把这轮对话发给另一个会话,让那边的 AI 也看看;
- 想从好几个会话里各取一点内容,拼成一个任务交给新会话。
这个插件在对话标题栏右上角加一个按钮,点开后把对话区换成「第 1 轮、第 2 轮……」的列表,上面这些事都在这个列表里完成。
安装
从插件市场
DSH 里打开 插件 → 发现,搜索「对话概览」或 conversation-overview,安装后重启或刷新。
从 GitHub
# 桌面版
dsh plugin --profile desktop add github:gushengsheng/dsh-conversation-overview
# Web 版
dsh plugin --profile web add github:gushengsheng/dsh-conversation-overview
注意:npm 上的
dsh-conversation-overview是另一个无关的包,请用上面的 GitHub 源安装,避免装错。
装完重启 DSH,或者刷新一次页面。打开任意一个有内容的会话,标题栏右侧会多一个列表图标。
30 秒上手
- 打开一个会话,点标题栏右上角的列表图标。
- 对话区会变成轮次列表。点条目正文 = 跳到那一轮;点左侧方框 = 选中它。
- 选中后,在底部选你要做的事:
- 让 AI 重点关注:把选中的几轮发给当前会话;
- 分发到…:选另一个会话,把内容发过去;
- 复制:复制成文本,自己粘贴到别处。
再点一次列表图标,或者点面板右上角的 ×,回到对话。
界面
- 顶部:本会话 / 全部会话、搜索、排序、刷新、关闭;
- 中间:每条显示「第 N 轮」、你的提问、AI 回复摘要、步数、时间、是否进行中;
- 底部:补充说明、批注开关,以及发送/复制按钮。

功能
1. 快速跳到某一轮
在「本会话」页签里,点条目正文或右边的「跳转」:
- 这一轮已经加载:直接滚过去并高亮;
- 还没加载:插件会自动点对话区自带的「加载更早」,找到后再跳(最多重试 12 次)。
在「全部会话」页签里点条目不会跳转,因为那不是当前打开的会话;它只会选中。
2. 让当前 AI 重点关注几轮
勾选几轮 → 点 让 AI 重点关注。
插件会把这些轮次整理成一条普通消息发给当前会话,AI 会先复述理解,再等你的下一步指令。适合:
- 让 AI 把前面几轮当作前提;
- 把散落在多轮的结论收拢起来;
- 明确告诉 AI「以这些内容为准」。
3. 把几轮分发到另一个会话
勾选几轮 → 在「分发到…」里选一个会话 → 点 发送。
对方会话会收到一条普通用户消息,里面是选中的轮次内容。适合:
- 让另一个会话的 AI 了解前因后果;
- 把调研结论带到执行会话;
- 把一个会话的背景同步给另一个会话。
目标会话没在运行会自动唤醒;正在运行时消息会进入它的队列,不会打断当前回合。
4. 看别的会话,让它读
切到 全部会话,左侧会列出所有可见会话:
- 点一个会话,右侧显示它的轮次;
- 勾选你想让它读的条目;
- 点 让该会话阅读(发给它自己)或 发回本会话(发给当前会话)。
归档的会话默认不出现在列表里。
5. 把多个会话合成一个任务
在「全部会话」里:
- 勾选左侧的多个会话;
- 在左下角「任务合成」里写任务目标;
- 点 新建会话并发送。
插件会把每个会话最近几轮摘成简报,创建一个新会话、发送任务并自动打开。新会话使用当前会话所在的工作区(拿不到时退回当前目录)。
6. 补充说明 + 批注
底部有一行:
- 补充说明:写你自己的话,会附在选中条目后面一起发出去;按会话保存在本地,关掉面板再打开还在。
- 带上当前会话批注(N):如果你装了
@changfenhuang/dsh-annotation,并且当前会话有待发送批注,这里会出现一个开关;勾上后会按「原文 + 你的批注」附进去。

拼出来的消息顺序是:
【选中的对话轮次】
...
【我在当前会话中的批注,共 N 条】
1. 原文:...
批注:...
【补充说明】
你写的话
(原本的“请确认理解 / 等待下一步指令”)
批注是可选、只读、默认不勾的:
- 没装批注插件:开关不出现,其他功能不受影响;
- 装了但没勾:不会发送任何批注;
- 只读待发送批注,不修改、不清空,你仍然可以在输入框里正常发送它们;
- 已经发出去的历史批注不会被读取;这里只处理当前会话输入框旁「批注 ×N」里的待发送内容。
勾选还是跳转?
| 你在哪个页签 | 点条目正文 | 点左侧方框 |
|---|---|---|
| 本会话 | 跳到这一轮 | 选中这一轮 |
| 全部会话 | 选中这一轮 | 选中这一轮 |
「全部会话」里要看某个会话,请点左侧的会话名;想真正切过去,用右上角的 打开该会话。
数据与隐私
- 只读:
session.list、session.page、workspace.follow(会话列表、历史事件、工作区归属)。 - 写入:
session.prompt(发消息)、session.create(新建会话)。 - 不注册 Host 服务、不写文件、不新增工具。
- 分发的消息就是普通用户消息,目标会话能看到,和你自己打字发送一样。
- 补充说明保存在本机 localStorage,按会话隔离。
- 批注只读,不清空;只有勾选「带上当前会话批注」时才会被读进分发内容。
- 归档会话默认不出现在「全部会话」里。
常见问题
看不到右上角的按钮?
确认已经打开一个会话(不是空白的新会话页);然后刷新一次页面,或在插件设置里确认插件是启用状态。
打开概览是空的?
这个会话还没有可展示的轮次,或者历史还没加载。先发一轮对话,或打开面板点「刷新」;很老的条目点「加载更早条目」。
点了条目不跳?
你可能在「全部会话」页签。切到「本会话」再点,或者先点「打开该会话」真正切过去。
批注开关不出现?
两种可能:没装 @changfenhuang/dsh-annotation;或者当前会话没有待发送批注(已经发出去了)。插件不会读取已发送的历史批注。
发给别的会话,对方没马上回复?
目标会话在运行时,消息会排队,等它当前回合结束;不在运行时会被唤醒。发送成功后面板会提示。
任务合成的新会话在哪?
会自动打开;如果找不到,去左侧会话列表的「未分组」或当前工作区看看。
补充说明会发给谁?
只发给本次操作的目标会话,不会广播;它按会话保存在本机。
会不会把我的批注删掉?
不会。插件只读批注存储,不写、不清空。
已知限制
- 概览按需分页读取历史(每页 200 条事件,初始最多 5 页);更早的条目需要点「加载更早条目」。
- 轮次预览取「第一条人类提问 + 最后一条助手文本」,不含注入的运行时上下文和工具结果。
- 跳转到未加载轮次依赖对话区自带的「加载更早」,最多重试 12 次。
- 任务合成给每个会话摘最近 6 轮,总预算约 15000 字符,超出会截断。
- 补充说明上限 8000 字;批注块上限 12000 字;单次分发的对话条目上限 20000 字。
- 批注只支持待发送内容,历史已发送批注不包含。
开发
给维护者 / 想改代码的人
lib/client.js:浏览器端全部实现,window.__ModuleLoader__工厂形式,无需构建。lib/index.mjs:宿主端空apply,只承载 bundle 行;不注册服务、路由或工具。- 数据通道:
ctx.remote.session.list/page/prompt/create、ctx.remote.workspace.follow。 - 补充说明存储:
dsh.conversation-overview.note.<sessionId>。 - 批注读取:
dsh.annotation.pending.<version>.<sessionId>,只读并做格式校验;读不到就返回空。 - 调试:
localStorage.setItem('dsh.overview.debug', '1')后刷新,可在控制台用window.__dshConversationOverview.api调数据层。 - 本地安装:
dsh plugin --profile <profile> add <本目录>;link 安装后刷新页面即可看到lib/client.js的改动。
版本
- 0.2.0:补充说明、可选批注联动
- 0.1.0:首个版本(轮次概览、跳转、重点、跨会话分发、任务合成)
License
MIT