DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-side-chat

d

dsh-side-chat

Manifest valid

DSH Right Sidebar "Side Conversation": A temporary Q&A panel that uses the main conversation as a background, inspired by Codex's side conversation.

UI (client)hasBundlePatch

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.ymlbundle 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"}

调用方断开连接会中止模型请求。

背景从哪来

两级读取,缺一不可:

  1. 活会话:ctx.sessions.get(id).deriveMessages()。
  2. 历史会话:切回旧会话时它通常不在内存里,退回 ctx.sessionQuery.readSurface(id) 读持久化 surface。

两边都取不到就发空背景,并在 meta.contextChars 里如实报 0 —— 面板不显示这一行,避免噪音。

设计取舍

  • 只读主会话:绝不 append,侧边对话与主线互不影响。
  • 模型可选但默认跟随:不给 provider/model 就走会话当前模型。
  • 关闭即清空:状态放在模块级 Map,靠 sidebarRight.registerCloseHandler 在标签关闭时删除该会话条目。
  • 自带极简 Markdown 渲染:粗体、列表、行内代码、围栏代码。不引 ui-chat 的内部渲染器,避免绑死版本。
  • 可选能力降级:右侧栏、快捷键、斜杠命令缺失时只告警,不拖垮插件加载。

踩过的坑

这两条是实测踩出来的,写下来省得别人再踩:

  1. web:linux 不能声明常规快捷键。浏览器端 isWebBindingAllowed 只放行少数组合(如 Ctrl+/),一旦声明了不被允许的组合,shortcuts.register 会整条抛错,快捷键彻底消失。这里只声明 desktop 三平台和 web:macos/web:windows。
  2. assistant 历史消息必须带 source。适配器按 source.kind 判断能否重放原生状态,缺了会在序列化历史时直接抛错。

开发

两个半侧都能脱离 DSH 单测:

node test-harness.mjs   # 宿主半侧:路由、模型解析、上下文折叠
node test-client.mjs    # 浏览器半侧:注册约定(用假 ModuleLoader)

License

MIT

Comments

Loading…