前言¶

在使用 DeepSeek Harness（DSH）进行开发或调试时，经常需要在主线任务运行的同时，向模型询问细节或排查问题。如果直接在主对话中插入问题，会污染主线的模型上下文；如果 fork 一个新的会话，操作步骤又略显繁琐。需要一个既能随时提问、又不干扰主进程的工具。

是什么¶

这是一个针对 DeepSeek Harness Web GUI 的客户端插件，由开发者 zclDragon 维护。它实现了 Codex 风格的 /side 命令，允许在运行中的主对话旁边打开一个临时分叉对话。该侧边对话继承主线已完成的历史上下文，进行“边跑边问”，且不会打断主任务。

核心功能¶

• /side 命令：通过命令快速开启或管理侧边对话。
• 浮动侧边面板：在界面右下角提供开关与操作入口，支持新建、切换和关闭。
• 实时问答：侧边对话继承主线截至最后一个 turn/end 的上下文，支持流式渲染与停止。
• Markdown 渲染：回复内容支持 Markdown 格式（标题、代码块、表格等），流式跟随滚动。
• 并发不中断：侧聊 agent 与主 agent 同进程并发运行，主任务不会被阻塞。
• 关闭即移除：关闭侧边面板时，agent 会被 dispose 并归档，从界面消失。
• 不污染主线：/side 命令仅在主线程日志中留下一条记录，不会进入模型上下文。

安装与启用¶

1. 执行安装命令：

    dsh plugin --profile web add @zhuchenglong/dsh-side-chat

2. 重启 dsh web 或刷新浏览器后生效。

典型用法¶

1. 在浏览器中打开 GUI（默认 http://127.0.0.1:3080）。
2. 在主对话界面中，点击右下角的「💬 侧聊」按钮，或直接输入 /side 命令。
3. 在弹出的侧边面板中，点击「＋ 新建」创建一个侧边对话。
4. 在输入框中输入问题，模型将流式返回结果。

适用场景与注意¶

• 适用场景：适合在主任务运行过程中进行实时交互，比如询问代码细节、解释报错或进行多轮调试，而不需要建立独立的对话窗口。
• 已知限制：
  • 进程重启后，侧聊的“分组关系”不会自动恢复（会话本身是持久化的），需手动重新关联。
  • 侧聊的上下文继承截止于主线上的最后一个 turn/end，正在进行中的 turn 无法继承。
  • 新建的侧聊在面板列表中最长需等待 3 秒轮询刷新后出现。
• 注意事项：该插件为社区维护项目，遵循 MIT 许可证。安装前建议查看源码与许可证，确保符合您的使用规范。

结尾¶

该插件通过轻量级的侧边交互解决了 DeepSeek Harness 中的上下文污染问题。更多详情与源码可访问 GitHub。