dsh-sidechat
yuhhhong/dsh-sidechat
在右侧栏基于主会话最近完成轮次的背景快照开展临时讨论,按需启动托管子代理,支持附件、技能及运行中的模型和权限切换,不自动向主会话回传回复。
安装
dsh plugin --profile web add github:yuhhhong/dsh-sidechatREADME
dsh-sidechat
中文 | English
DeepSeek Harness(DSH)的侧边聊天插件。在主会话右侧栏打开带有当前背景快照的临时侧聊,用于调研问题、澄清细节或讨论支线,避免把临时讨论过程写入主会话上下文。
核心特点
- 背景快照与上下文隔离:打开侧聊时截取主会话最近一个已完成轮次的背景快照;主会话后续推进不会自动同步。侧聊界面只展示新增对话,讨论过程和完成通知不自动回传主会话。
- 按需激活的托管子代理:由 DSH 托管的可续聊子代理承载侧聊。新建空白标签只保存背景与配置,发送第一个问题后才启动子代理;收起右侧栏或切换主会话不会中断运行。
- 原生风格的统一输入区:首问与续聊共用同一输入框,支持上传文件、粘贴图片、输入
/搜索并调用技能(Skill),以及选择宿主权限预设、模型和思考强度。 - 运行中切换权限与模型:首次提问前和回答过程中均可切换权限预设、模型与思考强度。权限变更作用于当前侧聊后续的工具调用,模型与思考强度在下一次模型执行步读取,不中断已开始的操作。
- 提示词边界约束:通过边界提示词将继承历史限定为参考背景,不续做主会话中的未完成任务;默认执行不修改状态的探索,禁止自行操作其他子代理,修改文件或向主会话发消息需用户在侧聊中明确要求。
- 生命周期清理与目录过滤:在单次 DSH 运行期间刷新页面可恢复已发送消息和未关闭的侧聊,退出重启 DSH 后不恢复旧侧聊界面。点击标签
×关闭后,插件停止后续执行、释放子代理资源,并从顶部「子智能体」目录中隐藏已结束的条目。
安装
方式1. 在 DSH 的 Web profile 中执行一条命令即可从 GitHub 安装:
dsh plugin --profile web add github:yuhhhong/dsh-sidechat
方式2. 在 DSH 的插件页中,点击添加插件,填入项目仓库地址:https://github.com/yuhhhong/dsh-sidechat
安装后重启 DSH 并刷新页面。
如需卸载:
dsh plugin --profile web remove dsh-sidechat
当前插件版本为 0.1.13,支持的 DSH 版本范围为 >=0.2.2-rc.2 <0.3.0-0。
使用方式
- 在主会话中打开右侧栏的「开始」页,点击「新建侧边聊天」。
- 在输入区提问、上传文件或粘贴图片、输入
/选择技能,或调整权限、模型与思考强度。空白标签在发送首条消息时才启动托管子代理。 - 回答期间可继续排队发送消息、停止本轮回答,或切换权限、模型与思考强度。
- 讨论结束后,点击侧聊标签上的
×关闭标签并释放子代理资源;若清理失败,标签会重新打开并显示错误原因。
子代理占用与交互规则
侧聊会占用子代理名额,用完请及时关闭。
- 数量上限:每个主会话最多保留 3 个未关闭侧聊(含创建中和正在关闭的侧聊)。输入区下方常驻显示提示及当前主会话的侧聊计数(如
侧聊 2/3)。 - 共享名额:侧聊与同一子代理树中的其他任务共享宿主子代理名额。即使侧聊不足 3 个,宿主名额也可能已被其他子代理任务占满。
- 驻留与释放:为避免子代理自然结束后自动向主会话投递完成通知,已激活的侧聊在打开期间会保持托管实例驻留。收起侧栏、切换标签、切换主会话或仅停止本轮回答,都不会释放子代理名额;用完请点击标签
×关闭。 - 标签命名:标签固定显示创建时的「侧边聊天 n」(
n为创建时当前主会话未关闭侧聊数量加 1),已有标签不重新编号,发送消息或子会话标题变化均不改写标签名。 - 草稿与恢复:页面刷新可恢复本次 DSH 运行中的侧聊身份与已发送消息;未发送的文字和附件草稿仅在当前页面运行期间保留,切换标签不丢失。
- 日志与目录:顶部「子智能体」目录仅显示未关闭的侧聊,关闭清理成功后自动隐藏并同步数量。宿主底层会话日志继续保留,默认历史搜索仍可命中侧聊记录。
本地开发
运行语法检查与测试:
npm run check
npm test
修改 Host 或客户端代码后,需退出并重启 DSH 以重新发布并加载插件;重启会结束当次运行中的临时侧聊。
| 文件 | 用途 |
|---|---|
| index.js | 宿主插件入口,注册子代理提供方、Remote 接口与 sidechat_manage 工具 |
| client.js | Web 客户端入口,负责右侧栏标签、历史边界裁切、统一输入区与子智能体目录过滤 |
| src/host/controller.js | 侧聊状态管理、托管子代理生命周期、模型与权限切换及上下文租约 |
| src/host/background.js | 主会话背景快照截取与侧聊边界提示词生成 |
| src/host/input.js | 模型配置校验、文件与图片附件暂存及续聊内容转换 |
| src/host/remote.js | Typert Remote 接口定义与请求参数校验 |
| cordis.patch.yml | DSH 插件加载补丁配置 |
持续集成与发布
分支推送和 PR 会触发 CI 工作流,使用 Node.js 24 运行语法检查和测试。检查使用 Node.js 内置模块,无需安装依赖;需要 Electron 与 DSH 安装目录的宿主集成测试在普通 Node.js 环境中跳过。
发布流程参考 dsh-skill-status:推送 v 前缀标签后,发布工作流 核对标签与 package.json 的版本,从 更新日志 提取说明,并运行语法检查和测试。全部通过后自动创建 GitHub Release,不附带压缩包。
发布前同步更新包版本、中英文 README 中的当前版本,并在更新日志中写入对应版本的说明,提交后再创建标签。标签与包版本不一致,或更新日志对应段落缺失、为空时,发布会失败。
git tag -a v0.1.13 -m "发布 v0.1.13"
git push origin main
git push origin v0.1.13
以上以当前版本为例,发布后续版本时替换版本号。可在发布前预览 Release 正文:
node scripts/release-notes.mjs
许可证
本项目采用 MIT 许可证,Copyright (c) 2026 yu。