用 dsh-side-chat 在 DeepSeek Harness 主会话旁开一条侧边追问

前言

用 DeepSeek Harness(命令名 dsh)跑长任务时,主会话里很快会堆出大段代码、报错和解释。真正卡住的往往只是其中一小段:某次工具输出、某段实现说明、某一行假设。如果直接在主输入框追问,新问题会混进当前任务的上下文;另开一个会话,又丢掉刚才那一轮的前缀。

DeepSeek Harness 的官方仓库把这件事写得很直接:Everything is a Plugin(一切皆插件)。模型、工具、会话、界面都可以换成社区插件。dsh-side-chat 做的就是其中一块会话交互:在网页客户端里选中已完成消息中的文字,到右侧独立侧栏追问,主对话继续留在原处。

需要先说清来源。DeepSeek Harness 由 DeepSeek AI 开源,仓库是 deepseek-ai/deepseek-harness,目前仍是 developer preview,接口还会变。下面介绍的插件目录 deepseek-harness-plugin.com 是社区站点,和 DeepSeek / 幻方没有官方从属关系,不能当成官方应用商店。本文按该目录详情页、插件 GitHub 仓库(含中英文 README、package.json、CHANGELOG)交叉核对后整理。

这是什么

dsh-side-chat 是一款面向 DeepSeek Harness Web 客户端的会话与消息插件,由 GitHub 用户 AHGGG 维护,许可证 MIT,主要语言 TypeScript。npm 包名是 @ahggg/dsh-side-chat,当前仓库版本为 0.6.1(CHANGELOG 日期 2026-08-17)。截至 2026 年 8 月 18 日,GitHub 仓库显示 12 星。

它解决的问题可以收成一句话:在不离开、也不改写当前主会话的前提下,针对选中的文本开一条聚焦的侧边对话。

目录页和仓库 README 都写明:当前发布精确对应 @deepseek-ai/dsh@0.1.0-rc.6package.json 里的 peerDependencies 同样钉在 0.1.0-rc.6,客户端 platformweb。换到别的 dsh 版本前,先看仓库是否已经跟进。

核心功能

选中文字,三种入口

主会话至少完成一轮之后,在同一条已完成的用户或助手消息内选中文字,会出现三个动作(仓库中英文 README 用的是英文按钮文案):

  1. Add to chat:先写一条可选批注,再把选中段落挂到主会话输入框。已有草稿会保留;多段带序号的文本和各自批注可以收进同一个 annotation 胶囊。
  2. More details:立刻发出一条解释请求。
  3. Ask in side chat:自己写聚焦问题,在右侧侧栏里继续聊。

自己输入时,Enter 发送,Shift+Enter 换行。完成后按 Esc 或点 × 关闭。回复生成期间,发送图标会变成停止按钮。助手回复走 DSH 自带的 Markdown 渲染。

侧栏模型与主会话分开

发送按钮旁有模型控件,用来选 provider / model 以及可用的推理等级。这项选择只属于 Side Chat,不会改主会话的模型;保存后会作为下一次打开 Side Chat 的全局默认值。CHANGELOG 0.6.0 起加入了模型与推理控件,并会记住上次选择。

主会话会一直留在页面上,不会被切到 child Session。

第一次发送会 fork 一条真实会话

第一次在侧栏发送时,插件会在所选消息处创建一个真实的 DSH Session fork。child 继承完整事件前缀、preset 和 workspace。初始模型优先用最近一次被接受的 Side Chat 选择;没有已保存选择时,才快照主会话配置。之后改模型或推理等级,只作用于 child 的后续 step。

README 说明:保持前缀不变有利于供应商的 prompt cache 复用,但不保证命中缓存。

关闭侧栏时,插件会停掉正在跑的任务、归档 child Session,并释放对应 Agent。磁盘上的 child 历史不会删除,因此 child 和复制出来的完整前缀会占用正常的 DSH Session 存储。

批注可以送回主输入框

Add to chat 这条路径和侧栏追问是分开的。保存批注后,选区会出现在主会话 composer 里;发送前可以悬停胶囊点 × 去掉,发送后同一个胶囊会出现在用户消息上方。悬停 N annotations 能预览每一段选中文本和对应批注。

安装与启用

社区目录给出的安装命令如下,在 DeepSeek Harness 终端里运行即可:

dsh plugin add github:AHGGG/dsh-side-chat

目录页同时提示:如需可复现安装,应固定 commit 哈希。截至 2026 年 8 月 18 日,仓库 master 对应 0.6.1 发布提交为 81d62a07c35d6a301eeeaa27b793c868a6572fe6

dsh plugin add github:AHGGG/dsh-side-chat#81d62a07c35d6a301eeeaa27b793c868a6572fe6

仓库 README 写的是装到 web profile、并从 npm 拉 @ahggg/dsh-side-chat。添加前只刷新这个包的 registry 元数据,避免 pnpm 刚发版后仍复用旧的 latest

npm install --global @deepseek-ai/dsh@0.1.0-rc.6
pnpm cache delete "@ahggg/dsh-side-chat"
dsh plugin --profile web add @ahggg/dsh-side-chat@latest

然后进入希望 Agent 操作的真实工程目录,启动 Web 界面:

cd /path/to/your-project
dsh web --port 3080

打开 dsh 打印出来的地址,插件会自动加载到 Web 客户端。package.json 要求 Node.js 为 ^22.19.0>=24.0.0

升级和卸载(同样来自仓库 README):

pnpm cache delete "@ahggg/dsh-side-chat"
dsh plugin --profile web update @ahggg/dsh-side-chat --latest
dsh plugin --profile web remove @ahggg/dsh-side-chat

插件以当前 dsh 进程的权限运行,安装时可能执行代码。装之前请核对源代码仓库和许可证;不要只凭插件名搜索,确认仓库是 AHGGG/dsh-side-chat、包名是 @ahggg/dsh-side-chat

典型用法

下面按仓库 README 的步骤走一遍,不额外编造界面截图或效果数据。

  1. 确认本机是 dsh 0.1.0-rc.6,并已按上一节把插件装进 web profile。
  2. 在目标工程目录执行 dsh web --port 3080,用浏览器打开输出的本地地址。
  3. 在主会话里先完成至少一轮对话,让页面上出现已完成的用户或助手消息。
  4. 同一条消息内拖选一段文字,例如某次命令输出、某段函数说明。
  5. 若只是想把这段话带回主输入框并加一句自己的备注,点 Add to chatEnterSave 保存;点批注框外部或 Cancel 则放弃。
  6. 若希望马上得到解释,点 More details
  7. 若要围绕这段文字多问几轮、又不想打乱主任务,点 Ask in side chat,在右侧输入问题后按 Enter。需要换模型或推理等级时,用发送按钮旁的控件,改的是侧栏,不是主会话。
  8. 问完后按 Esc 或点 ×。主会话还在,侧栏这条 child 会被归档。

仓库 docs/assets/side-chat-demo.gif 是官方演示动画,安装前可以先看一遍交互。

适用场景与注意事项

比较适合这些情况:

  • 主任务还在跑,只想对某一段输出做局部追问。
  • 希望侧栏用另一套模型或推理等级,主会话保持原配置。
  • 需要把多段原文连同批注一起送回主输入框,而不是把整段历史复制粘贴一遍。

使用前要看清边界,这些都来自仓库 README,不是推测:

  • 选区必须落在同一条已完成消息内,不能跨消息、也不能选正在生成的内容。
  • 暂不支持附件,也没有 /side 命令。
  • 关闭后不能从面板重新打开原来的 Side Chat;没有自动清理历史,也没有「保留为普通会话」的操作。
  • 已归档的 child 可能短暂出现在普通会话列表里。
  • 父会话和 child 共用同一个 workspace。 侧栏里产生的文件修改、命令执行和其他工具副作用都是真实的,关掉面板不会撤销。
  • child 历史留在磁盘上,会占用正常的 Session 存储。

另外,DSH 仍在快速迭代,插件又钉死 0.1.0-rc.6。升级 dsh 之后如果侧栏不出现或报错,先回到仓库核对兼容性,而不是假设新版本一定能用。

小结

dsh-side-chat 把 Codex 风格的侧边追问接到了 DeepSeek Harness 的网页会话上:选中一段已完成消息,在右侧独立会话里把细节问完,主对话不被带跑。它是 AHGGG 维护的 MIT 开源插件,当前版本 0.6.1,只适配 dsh 0.1.0-rc.6 的 Web 客户端。

安装前读源码、看许可证,并记住侧栏和主会话共享工作区——侧栏里改过的文件不会在关面板时自动还原。目录页和仓库地址如下:

  • 目录页:https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-side-chat/
  • GitHub:https://github.com/AHGGG/dsh-side-chat
  • DeepSeek Harness 官方仓库:https://github.com/deepseek-ai/deepseek-harness
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜