dsh-side-chat

在不离开当前 DeepSeek Harness 主会话的情况下，针对选中的文本发起聚焦讨论。支持 DeepSeek Harness 桌面端和 Web 端。

English

安装

请根据 DSH 运行时选择匹配的 Side Chat 版本：

Side Chat	DeepSeek Harness 运行时
@ahggg/[email protected]	0.2.0-rc.2
@ahggg/[email protected]	0.2.0-rc.1

以下安装和升级说明使用 Side Chat 1.0.2 + DSH 0.2.0-rc.2。如果暂时保留 DSH rc.1，请继续使用 Side Chat 1.0.1，等升级运行时后再更新插件。

当前源码已适配 DSH 0.2.1-rc.2。npm 已发布的 @ahggg/[email protected] 仍只支持 0.2.0-rc.2；DSH 0.2.1-rc.2 桌面端需要安装包含本次兼容更新的新插件版本。请保留 DSH 的插件兼容性检查，不要绕过它。

DeepSeek Harness 桌面端

在 DeepSeek Harness 0.2.0-rc.2 桌面应用的插件安装对话框中，输入完整的包名和版本：

@ahggg/[email protected]

安装后重启 DeepSeek Harness 桌面应用。桌面端请使用应用内的插件管理功能；下方 CLI 命令仅针对 Web profile。

Web 端（dsh web）

如有需要，先安装匹配版本的 DSH CLI，再安装并固定插件版本：

npm install --global @deepseek-ai/[email protected]
dsh plugin --profile web add @ahggg/[email protected] --save-exact

从希望 Agent 操作的真实工程目录启动 DSH：

cd E:\path\to\your-project
dsh web --port 3080

打开 DSH 输出的网址，插件会自动加载到 Web 客户端中。

本地链接调试

当 dsh plugin --profile web list 显示插件来自 link: 工作区时，DSH 加载的是已提交的 lib/client.js，而不是 src/。切换分支或修改客户端源码后，需要重新构建并重启 dsh web 进程：

pnpm install --frozen-lockfile
pnpm build

使用 Side Chat

在手机或平板上，可以长按已完成消息中的文字进行选中。有足够空间时，Side Chat 操作条会显示在选区下方，把浏览器系统选文菜单留在上方。你可以直接在触摸操作条中使用 Add to chat、More details 或 Ask in side chat。

1. 在主会话中至少完成一轮对话。
2. 在一条已完成的用户或助手消息内选中文字。
3. 点击 Add to chat 可以先填写一条可选批注，再把引用加入主会话输入框；点击 More details 可以立即发送详细解释请求；点击 Ask in side chat 可以自己输入聚焦问题。
4. 自己输入消息或问题时，按 Enter 发送。
5. Side Chat 回复完成后，点击 Add to conversation，即可把这段聚焦讨论作为一个会话引用加入主会话输入框。
6. 完成后点击 × 关闭，或者在 Side Chat 面板内聚焦时按 Esc。在其他输入框或菜单中按 Escape 不会关闭 Side Chat。

常用操作：

• Shift+Enter 换行。
• 点击发送按钮旁的模型控件，再选择 Effort（推理等级），即可调整模型的思考等级。回复生成期间也可以修改：当前回复仍使用原设置，新选择会用于下一次回复，并记住为当前客户端之后 Ask in side chat 和 More details 请求的默认设置，不会修改主会话。
• 点击 Add to chat 后，按 Enter 或点击 Save 保存 annotation；点击批注框外部或点击 Cancel 则直接取消。
• Add to chat 会保留输入框中已有的草稿，并可把多段带序号的文本及各自的可选批注汇总到同一个 annotation 胶囊中。
• Add to conversation 会捕获 Side Chat 中的用户/助手历史、保留主会话草稿；再次点击时会刷新已有引用，而不是重复添加。
• 输入框会随内容自动增高，达到最大高度后在内部滚动。
• 输入框只保留一个操作按钮：空闲时为 Send（发送），生成期间切换为 Stop（停止）。回复结束或停止后恢复为发送按钮，并保留追问草稿。等待发送结果时新输入的文字也会保留。
• Assistant 回复使用 DSH 原生 Markdown 渲染。
• hover N annotations 可以预览每一段所选文本及对应批注。
• 发送前可以 hover annotation 胶囊并点击 × 移除；发送后，同一个胶囊会显示在用户消息上方。
• Side Chat 的首条消息会把选区显示为一个 annotation，问题正文保持纯文本，不显示内部 XML。
• 主会话会一直保留在页面中，插件不会创建 child Session。

会话和数据如何处理

Ask in side chat 和 More details 直接通过 DSH 配置的 provider 发起流式模型调用。第一次发送时，插件读取主会话截至所选消息所在轮次结束的只读文本快照，不包含后续主会话问题。此后追问一直使用这份固定上下文。仅打开草稿不会调用模型。

Side Chat 只在内存中保留独立的临时讨论历史，不会 fork、复制、创建或归档 DSH Session，也不会启动 Agent 或写入 Session 事件日志。它没有工具调用、命令执行和文件修改能力。主会话的推理内容以及图片、文件附件的字节不会传入；过去的工具文本仅作为参考资料。初始模型优先使用已保存的 Side Chat 选择，否则使用所选父会话轮次的配置；之后切换模型只影响 Side Chat 的后续回复。

关闭面板、刷新或断开客户端、卸载插件时，会取消正在运行的请求并丢弃临时讨论。Host 记录闲置 30 分钟后也会过期。如果希望保留讨论，请点击 Add to conversation，然后发送主会话草稿，将引用存入主会话历史。只添加引用不会自动发送；已经添加到主会话草稿的引用独立于临时面板，不会随面板关闭而删除。

每次调用模型仍会发送文本快照和 Side Chat 历史，因此仍产生正常的 provider token 用量；不复制 Session 不代表不消耗上下文 token，也不保证缓存复用。旧版插件创建的归档 Session 不会自动删除。

当前限制

• 选区必须位于同一条已完成消息内。
• 这是纯文本只读讨论，不是另一个 Agent；不支持附件、工具、Steer 和 /side。
• 关闭或过期后不能重新打开，也没有“保留为普通 Session”操作。
• 父上下文上限为 2,097,152 个字符，超过时明确拒绝而不会静默截断。每条问题上限为 65,536 个字符，每次回复（含推理）上限为 262,144 个字符；每次讨论最多 64 条问题，问题、回复和推理合计最多 2,097,152 个字符。达到输出上限会明确报错，仅保留已经显示的部分回复。
• 单次模型请求两分钟后超时；provider 自身的上下文或输出限制可能更低。

升级或卸载

桌面端

将桌面应用升级到 DSH 0.2.0-rc.2 后，在应用内的插件管理功能中，使用以下确切包版本更新或重新安装 Side Chat，然后重启应用：

@ahggg/[email protected]

如果 DSH 0.2.0-rc.2 桌面端仍提示 @ahggg/[email protected] 要求 rc.1，说明它还在加载旧插件。请将桌面端插件更新到 1.0.2 并重启应用。桌面端和 Web profile 的插件安装相互独立，请更新实际使用的 profile，并保留 DSH 的兼容性检查。

如果桌面端已升级到 DSH 0.2.1-rc.2，在包含本次兼容更新的插件版本发布之前，已发布的 1.0.2 会被拒绝加载。在此期间请不要绕过 DSH 的兼容性检查。

卸载时，在桌面应用的插件管理功能中移除 Side Chat 即可。

Web 端

要将已有的 Web 安装升级到 Side Chat 1.0.2 + DSH 0.2.0-rc.2，先安装匹配版本的 CLI，再重新添加这个确切插件版本。add --save-exact 会替换已安装的包版本，并将依赖固定到该版本：

npm install --global @deepseek-ai/[email protected]
dsh plugin --profile web add @ahggg/[email protected] --save-exact

更新后重启 dsh web 并刷新浏览器。卸载 Web profile 中的插件：

dsh plugin --profile web remove @ahggg/dsh-side-chat

许可证

MIT

References

• https://www.v2ex.com
• https://linux.do
• https://linux.sb