Saltar al contenido principal
Y

dsh-side-chat

yeah9right/dsh-side-chat

Temporary side chats in the right sidebar: fork the current conversation as read-only background, ask in parallel with its own native composer, open several at once, and release everything when the tab closes. The side chat lives in memory only — no JSONL, no session list, no search hits. Adapted from Lone-Jade/dsh-side-chat (MIT) for DSH 0.2.2.

Instalar

dsh plugin --profile web add github:yeah9right/dsh-side-chat

README

侧聊 · Side Chat

在 DeepSeek Harness Web GUI 里开临时侧聊:交互对齐 Codex 桌面版的临时 Side chat——从当前对话分叉出一支独立提问,不打断主聊,不写会话日志,关掉就没了。

来源:本项目改造自 Lone-Jade/dsh-side-chat(npm dsh-sidebar-chat@2.0.2,MIT)。上游面向 DSH 0.2.1,这里适配到 DSH 0.2.2,并把唯一的断裂接口 agentLoop.setupAndPublish 换成 agentLoop.initializeAgent。改动细节见 NOTICE。

怎么用

  • 主聊输入 /side,或标题栏“更多操作”菜单里选“新建侧聊”。
  • 右侧栏的“新建标签”页也有“新建侧聊”入口。
  • 每次新建都是独立侧聊,可同时开多个,标题按“侧聊”“侧聊 2”编号。
  • 侧聊用原生输入框,支持模型选择、图片、文件、@ 引用、原生队列和停止。
  • 快捷键:macOS ⌘⌥S,Windows Ctrl+Alt+S。

侧聊继承创建那一刻主聊的历史、工作目录、模型、推理等级和权限。继承来的历史只当背景,不出现在侧聊聊天区。之后主聊的新消息不会同步过来,侧聊的答案也不会回传主聊。侧聊里不能再开侧聊。

临时性

侧聊只活在内存里:没有持久化写句柄,不产生 JSONL,不进会话列表、搜索结果或归档列表。关掉标签或退出应用就停止并释放,找不回来。收起侧栏、切标签、切主聊都不会丢。

有内容时关闭会弹确认,可以勾“不再询问”。后端停干净才关标签,失败会保标签并显示错误,可重试。创建中的标签可取消,取消后不留后台残留。

侧聊默认只做问答和轻量检查。改工作区必须由用户在侧聊里明确要求;禁止创建或操作子智能体,禁止为侧聊建 worktree 或排长期任务。聊天分叉不隔离文件,主聊和侧聊共用同一个工作目录。

实现要点

  • runtime.js 复用 DSH 原生 fork,保留图片、工具调用/结果、有效压缩历史。
  • 用 AgentLoop 内部方法 initializeAgent(ctx, { session, agentOptions, source: 'startup', setup }) 建 Agent,不传 stored,所以不申请持久化句柄。宿主没有“先落盘再删除”或“关闭后归档”的等价路径,这是唯一可行的内存态做法。
  • 侧聊的导航摘要伪造宿主已有的隐藏标记 origin: 'subagent' 并省略 parentSessionId;列表、查询、搜索结果排除这些临时 id。真实 Session header 和原生输入路由不变。
  • 客户端从认证身份直接建立作用域(retainAgentScope + retain),不依赖普通会话列表。
  • 一个浏览器窗口共享一条生命周期长连接(hold 端点);连接断了,该窗口的侧聊全部标记过期。
  • 主聊规则仍由 DSH 加载;prompts/AGENTS.md 是插件单独装进侧聊的规则,不改项目规则。

依赖的内部接口(升级需重验)

agentLoop.initializeAgent、SessionStore.prepare/fork 的 Proxy 绕过、sessionController.listState.summaryFor、sessionQuery._corpus.listSessions、右侧栏 openTabIn/closeIn/registerCloseHandler、data-chat-turn。

这些是宿主内部接口,不是公开 API。DSH 升级到大版本后如果侧聊打不开,先查这里。

安装

三种方式,任选一种。

1. 插件市场(推荐)

装好 dshmarket 后打开 插件 页 → 插件市场,搜“侧聊”或 side-chat,一键安装。

2. 从 GitHub Release 装预构建包

gh release download --repo yeah9right/dsh-side-chat --pattern '*.tgz'

然后在插件管理器里指向下载到的 dsh-side-chat.tgz。

把本目录链进 profile 的 dependencies,并在 dsh.profile.bundles 里列出 @yeah9right/dsh-side-chat:

{"dependencies": {"@yeah9right/dsh-side-chat": "link:D:/path/to/dsh-side-chat"}}

改完 Host 半(index.js/runtime.js)需要重启 DSH;只改 Client 半(client.js)刷新页面即可,HMR 会按文件 mtime 重新发版并把新 bundle 推给浏览器。

兼容性

  • engines.dsh: >=0.2.2-rc.1 <0.3.0-0。宿主 0.2.2 之前没有 initializeAgent,装不上。
  • Node.js >=22.19.0。

文件

文件作用
index.jsHost 半:侧聊生命周期、/side-chat 私有 HTTP 通道、工具守卫
runtime.js版本适配层:内存态 fork、不落盘发布、历史隐藏
client.jsClient 半:右侧栏标签、资源提供者、命令、快捷键、关闭确认
prompts/AGENTS.md装进侧聊的独立行为规则
cordis.patch.ymlbundle 插入声明
locale/{zh,en}.json插件管理器显示的标题和说明

许可

MIT。上游版权归 Lone-Jade,本改造版版权归 yeah9right;见 LICENSE 与 NOTICE。

Plugins relacionados