前言¶
在 DeepSeek Harness（DSH）里跑智能体时，主会话 transcript 往往承载完整任务脉络。若想在同一份工作区里「旁开一局」做小实验、改文件或追问细节，又不想把侧对话写进主历史，需要一套与主会话隔离、又能共用 agent、工具和 cwd 的机制。上游 @flyer103/dsh-side-chat 已在右侧栏提供侧聊能力；dsh-side-chat-slash 在其 0.7.0 基础上 fork，补上从输入框用 /side 打开侧栏标签页，并处理审批策略与打开流程，便于在 Web / Desktop 界面里快速拉起侧对话。
这是什么¶
dsh-side-chat-slash 是 DSH 客户端插件（维护者 lucyVan），面向 DeepSeek Harness Web GUI。它在当前会话旁 fork 出子对话：同一 agent、同一套工具、同一 workspace，可真实 write / edit / bash；关闭侧栏标签后销毁侧会话，不改动主 transcript。
代码主体来自 MIT 授权的 flyer103/dsh-side-chat；本仓库仅包含 README 所列增量，并保留原 LICENSE。包版本 0.1.0，许可证 MIT。
与上游的差异¶
| 变更 | 说明 |
|---|---|
Host 级 /side 斜杠命令 |
上游主要靠右侧栏引导卡片。本插件在 composer 输入 /side 并回车即可打开侧聊标签；通过 ctx.commands.register 注册为 host 命令，避免依赖 session summary 与 client locale 的 commandUi 贡献项静默失效。 |
| Open-request 桥接 | /side 不直接创建侧会话，而是置位「请打开标签」；客户端轮询 /side-chat/api/pending（约每 2s），再调用 sidebarRight.openTab('side-chat')，仍由标签页持有会话，保留上游「一标签一会话、关闭即 dispose」的生命周期。 |
审批固定为 never |
上游继承父会话审批策略，但侧聊标签不渲染审批 UI；父会话若为 ask，侧 agent 会一直等待。侧聊侧将父级 ask 降级为 never。 |
上游右侧栏引导页里的「Side chat」入口仍可使用。
核心行为¶
- Fork 时刻继承主会话完整历史、preset、cwd、provider/model、sandbox 模式。
- 隔离：侧聊轮次不进入主 transcript、会话列表或 subagent 目录。
- 独立：fork 之后主会话新消息不会流入该侧聊；每个侧聊自带上下文。
- 真改文件：工具作用在同一 workspace，主会话下次读取可见变更。
- 关闭即销毁：侧会话持久化日志会移除（best effort）。
继承自上游的限制包括：侧聊标签不显示审批提示（已由 never 缓解）、关闭后无法恢复、首个侧聊请求体积大致与父会话下一次请求相当且多开侧聊会放大、GUI 重启会丢失所有侧会话、仅 Web 平台（含 Desktop 窗口），无 CLI/TUI。
安装与启用¶
--profile 须与实跑进程一致：desktop 对应 Desktop 应用，web 对应 dsh web。
# 从 GitHub 安装
dsh plugin --profile desktop add github:lucyVan/dsh-side-chat-slash
# 本地目录（绝对路径）
dsh plugin --profile desktop add /absolute/path/to/dsh-side-chat-slash
安装后重启 DSH：Desktop 用 ⌘Q 退出再打开；dsh web 进程需重启。
兼容性（资料原文）
| 项 | 说明 |
|---|---|
| DSH | 在 0.2.2-rc.1 验证；engines.dsh 为 >=0.2.2-rc.1 <0.3.0-0，不匹配时安装阶段即拒绝。 |
| 平台 | macOS 测试；Windows/Linux 未测（无平台专用代码，预期可用）。 |
| Node | >=22（由 DSH 捆绑运行时满足）。 |
| 并存 | 不能与上游 @flyer103/dsh-side-chat 同时安装（路由与 tab 类型冲突）。 |
DSH 升级后若因 engines.dsh 拒绝安装，可按 README 使用 dsh plugin --profile <name> allow-version ... --accept-risk（须先备份 workspace）。卸载示例：
dsh plugin --profile desktop remove dsh-side-chat-slash
然后同样重启 DSH。
典型用法¶
- 打开至少有一条消息的主会话。
- 在 composer 输入
/side并回车——右侧栏出现 side-chat 标签。 - 在侧聊标签里发送第一条消息后才会 fork；空标签无额外成本。
- 关闭标签销毁该侧聊；需要新开时再执行
/side。
适用场景与注意¶
适合：想在主任务不断档的前提下，用同一工作区做短平快分支（试 patch、核对命令、单独追问），且不希望侧对话污染主历史或会话列表的 DSH Web / Desktop 用户。
安装前建议：插件以当前 DSH 进程权限运行，具备与主 agent 相同的工具面；安装前应阅读 仓库源码 与 MIT 许可证，确认不与已装的 dsh-side-chat 重复。
生态说明：DSH 采用「一切皆插件」；SkillHub 目录页 为社区站点，与 DeepSeek / 幻方无官方从属关系。
