dsh-side-chat
Manifest validDSH Right Sidebar "Side Conversation": A temporary Q&A panel that uses the main conversation as a background, inspired by Codex's side conversation.
dsh-side-chat
DSH 右侧栏的「侧边对话」:以当前主对话为背景的临时问答面板,照 Codex 的 side conversation 做的。

为什么需要它
主对话推进到一半,你突然想问一句「这个概念到底什么意思」「这两个方案哪个更稳」。 新开一个会话得把前情再讲一遍,而且在主对话里追问又会把主线上下文撑长、打断节奏。
侧边对话是第三条路:继承当前对话的背景,只回答这一问,不写回主线。
| 侧边对话 | 直接新开会话 | 在主对话里追问 | |
|---|---|---|---|
| 背景 | 自动继承最近内容 | 从零开始 | 完整继承 |
| 写回主线日志 | 不会 | 不会(是另一条线) | 会,主线变长 |
| 能干活、改文件 | 不能,只回答 | 能 | 能 |
| 生命周期 | 关标签即消失 | 长期保留 | 跟着主线 |
它做什么
- 在右侧栏注册标签页 侧边对话,三种入口:对话头部的「侧边对话」按钮、指南页卡片、斜杠命令
/sidechat。 - 快捷键 Ctrl/Cmd + Shift + I 直接打开(可在 设置 → 通用设置 → 编辑快捷键 里改绑)。
- 顶部下拉框可选模型:默认「跟随会话」,也可以按 provider × model 精确指定。
- 发送时读取当前主会话的模型可见消息,压成背景(默认最多 24000 字)附在问题前面,再走
ctx.llm流式生成。 - 回复只留在面板里:不写入主会话日志,不产生工具调用,不污染主线上下文。
- 关闭标签即清空:该会话的这段侧边对话随标签一起丢弃。
安装
需要 DSH >= 0.2.0-rc.1。插件由两半组成:宿主半侧注册 HTTP 路由,浏览器半侧注册右侧栏标签页。
方式一:从 GitHub 安装
在 $DSH_HOME/profiles/desktop/package.json 里加依赖和 bundle:
{
"dependencies": {
"dsh-side-chat": "github:Aaron-lmh/dsh-side-chat"
},
"dsh": {
"profile": {
"bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-side-chat"]
}
}
}
然后在 profile 目录执行:
cd "$DSH_HOME/profiles/desktop"
pnpm install
方式二:本地开发(link)
改源码后重启即生效,不必重装:
"dsh-side-chat": "link:D:/path/to/dsh-side-chat"
方式三:离线包
git clone https://github.com/Aaron-lmh/dsh-side-chat.git
cd dsh-side-chat && pnpm pack
# 然后把生成的 dsh-side-chat-0.1.0.tgz 作为 file: 依赖装进 profile
必须重启宿主:新增 bundle 要重新组合配置树,热重载不覆盖 bundle 列表的变更。 装好后右侧栏指南页会出现「侧边对话」卡片。
组成
| 文件 | 作用 |
|---|---|
lib/index.js | 宿主半侧:Cordis 插件,注册前缀路由 /dsh-side-chat |
lib/client.js | 浏览器半侧:标签类型、面板、指南卡片、头部入口、快捷键、/sidechat |
cordis.patch.yml | bundle patch:把插件行插进配置树 |
接口
| 方法 | 路径 | 作用 |
|---|---|---|
| GET | /dsh-side-chat/info | 当前会话模型 |
| GET | /dsh-side-chat/models | 模型目录(?refresh=1 跳过 60s 缓存) |
| GET | /dsh-side-chat/sessions | 宿主当前活着的会话(诊断用) |
| POST | /dsh-side-chat/ask | 流式生成 |
POST /ask 请求体:
{
"sessionId": "session-...",
"question": "这里为什么要加锁?",
"context": true,
"provider": "deepseek-official",
"model": "deepseek-v4-pro",
"history": [{ "role": "user", "text": "..." }, { "role": "assistant", "text": "..." }]
}
provider + model 省略时跟随会话当前模型;都没有则返回 409,让面板显示明确原因,不伪造回复。
响应是 application/x-ndjson 的逐行帧:
{"t":"meta","provider":"...","model":"...","contextChars":1234,"truncated":false}
{"t":"d","x":"增量文本"}
{"t":"usage","usage":{}}
{"t":"finish","reason":{"kind":"stop"}}
{"t":"end"}
调用方断开连接会中止模型请求。
背景从哪来
两级读取,缺一不可:
- 活会话:
ctx.sessions.get(id).deriveMessages()。 - 历史会话:切回旧会话时它通常不在内存里,退回
ctx.sessionQuery.readSurface(id)读持久化 surface。
两边都取不到就发空背景,并在 meta.contextChars 里如实报 0 —— 面板不显示这一行,避免噪音。
设计取舍
- 只读主会话:绝不 append,侧边对话与主线互不影响。
- 模型可选但默认跟随:不给 provider/model 就走会话当前模型。
- 关闭即清空:状态放在模块级 Map,靠
sidebarRight.registerCloseHandler在标签关闭时删除该会话条目。 - 自带极简 Markdown 渲染:粗体、列表、行内代码、围栏代码。不引 ui-chat 的内部渲染器,避免绑死版本。
- 可选能力降级:右侧栏、快捷键、斜杠命令缺失时只告警,不拖垮插件加载。
踩过的坑
这两条是实测踩出来的,写下来省得别人再踩:
web:linux不能声明常规快捷键。浏览器端isWebBindingAllowed只放行少数组合(如Ctrl+/),一旦声明了不被允许的组合,shortcuts.register会整条抛错,快捷键彻底消失。这里只声明 desktop 三平台和 web:macos/web:windows。- assistant 历史消息必须带
source。适配器按source.kind判断能否重放原生状态,缺了会在序列化历史时直接抛错。
开发
两个半侧都能脱离 DSH 单测:
node test-harness.mjs # 宿主半侧:路由、模型解析、上下文折叠
node test-client.mjs # 浏览器半侧:注册约定(用假 ModuleLoader)
License
MIT
Comments
Loading…