メインコンテンツへスキップ
G

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-overview

README

dsh-conversation-overview

把 DSH 的对话变成一张可以跳转、勾选、分发的目录。

一个 DeepSeek Harness 插件:长对话快速定位、选中几轮让 AI 重点看、把内容发给别的会话、把多个会话合成一个新任务。
A conversation turn overview plugin for DeepSeek Harness.

轮次概览

截图使用示例数据,仅用于展示界面。

安装 · 30 秒上手 · 功能 · 常见问题


先统一几个词

  • 会话:左侧列表里的一个对话。
  • 轮次:一次你的提问 + 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 秒上手

  1. 打开一个会话,点标题栏右上角的列表图标。
  2. 对话区会变成轮次列表。点条目正文 = 跳到那一轮;点左侧方框 = 选中它。
  3. 选中后,在底部选你要做的事:
    • 让 AI 重点关注:把选中的几轮发给当前会话;
    • 分发到…:选另一个会话,把内容发过去;
    • 复制:复制成文本,自己粘贴到别处。

再点一次列表图标,或者点面板右上角的 ×,回到对话。

界面

  • 顶部:本会话 / 全部会话、搜索、排序、刷新、关闭;
  • 中间:每条显示「第 N 轮」、你的提问、AI 回复摘要、步数、时间、是否进行中;
  • 底部:补充说明、批注开关,以及发送/复制按钮。

全部会话

功能

1. 快速跳到某一轮

在「本会话」页签里,点条目正文或右边的「跳转」:

  • 这一轮已经加载:直接滚过去并高亮;
  • 还没加载:插件会自动点对话区自带的「加载更早」,找到后再跳(最多重试 12 次)。

在「全部会话」页签里点条目不会跳转,因为那不是当前打开的会话;它只会选中。

2. 让当前 AI 重点关注几轮

勾选几轮 → 点 让 AI 重点关注。

插件会把这些轮次整理成一条普通消息发给当前会话,AI 会先复述理解,再等你的下一步指令。适合:

  • 让 AI 把前面几轮当作前提;
  • 把散落在多轮的结论收拢起来;
  • 明确告诉 AI「以这些内容为准」。

3. 把几轮分发到另一个会话

勾选几轮 → 在「分发到…」里选一个会话 → 点 发送。

对方会话会收到一条普通用户消息,里面是选中的轮次内容。适合:

  • 让另一个会话的 AI 了解前因后果;
  • 把调研结论带到执行会话;
  • 把一个会话的背景同步给另一个会话。

目标会话没在运行会自动唤醒;正在运行时消息会进入它的队列,不会打断当前回合。

4. 看别的会话,让它读

切到 全部会话,左侧会列出所有可见会话:

  1. 点一个会话,右侧显示它的轮次;
  2. 勾选你想让它读的条目;
  3. 点 让该会话阅读(发给它自己)或 发回本会话(发给当前会话)。

归档的会话默认不出现在列表里。

5. 把多个会话合成一个任务

在「全部会话」里:

  1. 勾选左侧的多个会话;
  2. 在左下角「任务合成」里写任务目标;
  3. 点 新建会话并发送。

插件会把每个会话最近几轮摘成简报,创建一个新会话、发送任务并自动打开。新会话使用当前会话所在的工作区(拿不到时退回当前目录)。

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

関連プラグイン