DSH Side Chat

<strong>简体中文</strong> · <a href="README_EN.md">English</a>

<strong>在 DeepSeek Harness 主对话旁边，打开一个真正独立、原生、理解上下文的并行对话。</strong>

<a href="#界面预览">界面预览</a> · <a href="#快速开始">快速开始</a> · <a href="#使用方式">使用方式</a> · <a href="#会话与数据">会话与数据</a> · <a href="#核心能力">核心能力</a> · <a href="#架构边界">架构边界</a>

[!NOTE] 侧聊不是浮在主对话上方的临时面板，也不是手写的聊天界面。它是一个真实 DSH Session，直接复用 DSH 原生会话组件，并通过有界工具按需理解主对话。

先看这里

• 想直接使用： 下载 release/dsh-side-chat-1.1.2.tgz，按下方命令安装。
• 想参与开发： 克隆仓库后运行 npm test，它会构建插件并执行全部回归测试。
• 它解决什么： 在不离开主会话的情况下，打开一个可以独立提问、调用工具和修改工作区的原生 DSH 会话。
• 最重要的边界： 主会话与侧聊共享工作区，但 transcript 相互独立；侧聊不会自动复制整段主对话。

界面预览

主对话与侧聊使用同一套 DSH 原生会话界面。中间分隔线可以拖动，两个输入框保持对齐，侧聊不会出现在左侧会话列表。

主对话选文入口	原生设置页

快速开始

直接安装正式包

要求：Node.js 22 或更高版本，以及能够加载 Web 插件的 DeepSeek Harness。

下载已经构建好的插件：优先从 GitHub Releases 获取最新包，也可以直接使用仓库内 release/ 目录；安装时不需要再次运行构建脚本：

# 从 GitHub Release 下载后：
dsh plugin --profile web add .\dsh-side-chat-1.1.2.tgz

# 或使用仓库内副本：
dsh plugin --profile web add .\release\dsh-side-chat-1.1.2.tgz

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

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

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

从源码构建

git clone https://github.com/KarlOfLaw/dsh-side-chat.git
cd dsh-side-chat
npm test

$DshSource = "D:\path\to\deepseek-harness"
$PluginSource = (Get-Location).Path
pnpm --dir $DshSource dsh plugin --profile web add $PluginSource
pnpm --dir $DshSource dsh web

已安装时：

npm test
pnpm --dir $DshSource dsh plugin --profile web update dsh-side-chat

npm test 会构建动态产物、正式本地包，并运行 core、host integration、client contract 与 smoke tests。

本地链接调试

从源码目录注册插件时，DSH 加载的是 dist/formal-host.mjs 和 dist/formal-client.cjs，而不是直接读取 src/。修改源码后请重新运行 npm test（或 npm run build），然后重启 dsh web；否则浏览器中仍可能是上一次的构建结果。

使用方式

1. 打开一个主会话，点击 header 中的消息气泡＋图标。
2. 侧聊会立即显示完整原生 header 和输入框；无需先发送第一条消息，隐藏与关闭按钮已经位于原生 header 右上角。
3. 在侧聊中像普通 DSH 会话一样选择模型、输入消息、使用附件、工具和审批流程。
4. 拖动中间分隔线调整比例；聚焦分隔线后可用方向键微调，按住 Shift 可加速调整。
5. 在主消息中选中文字，点击“在侧聊中对话”，选区会作为可删除的引用 chip 进入侧聊输入框。
6. 点击侧聊 header 的面板图标可隐藏；主 header 的消息气泡图标会恢复同一个侧聊。
7. 点击关闭按钮后选择“保留对话”或“删除并关闭”。

常用细节

• 每个主会话维护自己的侧聊状态，切换主会话不会串用另一条侧聊。
• “保留对话”会释放当前 Agent，但保留磁盘会话；下次以相同模式打开时会恢复最近保留的侧聊。
• “删除并关闭”只允许删除插件创建的侧聊，并要求当前存储后端支持安全的逐会话删除；不满足条件时会明确报错并保留会话。
• 打开设置、插件市场或其他 DSH 原生弹窗时，分隔条会让出指针交互，不会覆盖或拦截弹窗。
• 可在 DSH 设置的“侧边聊天”页面启用或停用插件，并选择新侧聊默认使用的原生 Agent 模式。

会话与数据

第一次打开时，插件创建一个带 parentSession 的真实 DSH Session，并立即将它归档，因此它不会出现在 workspace 左侧会话列表。保留过的同模式侧聊会在下次打开时恢复，而不是重新创建空会话。

插件不会把主 transcript 复制到侧聊。选中的文字只作为原生输入框引用加入草稿；当侧聊确实需要更多背景时，可以通过 side_chat_context 按需读取有界、相关且按时间排序的父会话片段。

主会话与侧聊共享同一个 workspace。侧聊中的文件修改、命令执行、审批和其他工具副作用都是真实的；隐藏、保留或关闭面板不会撤销这些操作。

核心能力

能力	实现方式
真实独立会话	通过 DSH agents.create/resume 创建或恢复带 parentSession 的 Session，不占用 subagent routing。
完整原生 UI	左右两栏都渲染完整 ConversationRoot；消息、工具、审批、附件、输入框、模型和权限控件继续由 DSH 提供。
发送前即完整可用	空白侧聊也显示原生 header、输入框以及隐藏/关闭控制，发送消息前后使用同一套原生界面。
按需理解主对话	不复制主 transcript；需要背景时，通过 side_chat_context 检索有界、相关的父会话片段。
真正并排	只增加最小 split shell；分隔条支持拖拽和方向键微调，侧聊占比限制在 25%–70%。
不污染会话列表	新侧聊立即归档，不出现在 workspace 左侧列表中。
选文即问	选中主消息文字后出现“在侧聊中对话”，引用以可删除 chip 进入原生输入框。
可隐藏、可恢复、可删除	隐藏只收起面板；保留后可以恢复，关闭时也可选择安全删除。
原生模式与模型	新侧聊默认标准模式，可选 PTC、极简或创造模式；模型选择器保持 DSH 原生行为。

当前限制与兼容性

…