前言¶
在 DeepSeek Harness（DSH）里跑智能体时，主对话往往已经很长：工具调用、终端输出、文件 diff 都堆在同一条线程里。若只想就某段结论追问一句，再开一个新会话会丢上下文；在主对话里插一句又怕打断当前任务节奏。社区插件 dsh-sidechat 把问答放到右侧栏独立标签页：与文件、终端、浏览器共用入口，需要时再打开，并自动带上当前会话的上下文；主界面划选文字还可一键引用到侧边输入框。下面介绍它是什么、能做什么，以及如何安装与日常使用。
这是什么¶
dsh-sidechat 是面向 DeepSeek Harness 0.2.1 Web GUI 的侧边聊天插件，由维护者 JiaskyNo1 在 GitHub 发布（JiaskyNo1/dsh-sidechat），在 DSH 社区目录中归类为客户端插件。仓库 package.json 当前版本为 0.3.4，协议 MIT；实现致谢上游 kittsai/dsh-sidechat（同为 MIT）。
目标运行时为 DeepSeek Harness 0.2.1-rc.2（Desktop / Web）。侧边聊天以右侧栏停靠标签页（kind: sidechat）存在，不悬浮、不遮挡主对话；只有主动打开时才出现。面板是独立问答面：不写入主会话历史，也不会调用工具。
核心功能¶
| 能力 | 说明 |
|---|---|
| 右侧栏停靠 | 与内置的文件、终端、浏览器标签并列注册 |
| 快捷键 | Desktop：Ctrl+J；Web：Ctrl+Alt+J |
| 会话上下文 | 自动注入当前会话最近 40 条消息（含工具调用与结果，按字符预算截断）、项目根目录、Git 分支与工作区 AGENTS.md 指令 |
| 与主对话一致 | 使用与主对话相同的模型与推理等级、路由默认采样参数；思考过程采用主界面「思考 / 已思考」折叠样式 |
| 划选引用 | 划选主对话文本后点「添加到侧边聊天」，引用以草稿插入输入框；补充问题并发送后才回答 |
| 流式输出 | 逐字流式显示，可中途停止 |
| Markdown | 支持标题、代码块、列表、引用、链接、表格 |
| 模型选择 | 标签页内可切换模型与推理等级 |
| 会话隔离 | 每个 DSH 会话维护独立的侧边聊天历史 |
| 清空 | 头部「清空」需二次确认 |
回答侧不覆盖 temperature / maxTokens，沿用路由默认值。若模型输出工具调用标记，会被过滤并按需重试，不会在界面露出原始标记。
安装与启用¶
本仓库为可直接导入的 bundle：lib/ 已含构建产物，安装器会处理依赖与配置注册，无需本地构建、无需手改配置。
- 打开 DSH 侧边栏 → 插件（Plugins） → 添加插件。
- 在 Git 地址栏粘贴（须与 README 一致）：
github:JiaskyNo1/dsh-sidechat
- 安装完成后启用插件。页面通常会热加载；若侧边栏未出现新入口，重启 DSH 即可。
插件在 DSH 进程内运行，权限与当前 DSH 一致。安装前建议浏览仓库源码与 LICENSE，确认符合你的合规要求。
典型用法¶
| 操作 | 方式 |
|---|---|
| 打开 | 右侧栏「打开右侧边栏」→ 指南页「侧边聊天」卡片；或按 Ctrl+J（Web 为 Ctrl+Alt+J） |
| 关闭 | 标签页上的关闭按钮 |
| 划选引用 | 选中主对话文字 →「添加到侧边聊天」→ 在输入框补充问题 → Enter 或「发送」 |
| 切换模型 | 标签页底部下拉框选择模型与推理等级 |
| 停止生成 | 生成中点击「停止」 |
| 清空 | 标签页头部「清空」，二次确认 |
经过上面的步骤，你可以在主对话继续让智能体改代码、跑工具，同时在侧边栏用同一套模型设置做短问短答，且引用来自主界面的原文。
架构要点（便于排查问题）¶
浏览器半（lib/client.js）通过 Typert Remote（JSON over /api）调用宿主半的 SidechatService：拉取上下文、枚举模型、以 llm.stream 启动任务并通过 poll / stop 管理流式生成。标签正文挂在 session-scoped 的 sidebar.right.pane.tab（key：dsh-sidechat），因此多会话互不串历史。
宿主运行时仅依赖 zod；@deepseek-ai/* 在宿主侧为类型导入。浏览器半使用 Web 平台共享模块表中的 react、react/jsx-runtime、zod。跨 DSH 大版本升级时，需对照 package.json 的 peerDependencies 与构建配置中的共享模块表。
若你自行从源码构建（非安装 bundle），README 要求 Node.js 24 与已安装依赖的 DSH 0.2.1 运行时，常用命令为 pnpm install、pnpm run typecheck、pnpm run build；一般用户走插件管理器导入即可。
适用场景与注意¶
适合需要在不污染主会话的前提下，基于当前工作区与会话上下文做追问、对照划选片段写说明的场景。不适合指望侧边栏代你执行工具或改写主线程——设计上已明确隔离。
兼容性以 0.2.1-rc.2 为准，依赖 client-modules bundle、ui-sidebar-right 标签注册、client-shortcuts、typert Remote 等契约；升级 DSH 后若插件无法加载，先核对目标版本与 peer 依赖是否匹配。
结尾¶
dsh-sidechat 把「副线问答」收进右侧栏：共享会话上下文与模型设置，划选即可引用，流式回复可停可清。社区目录页：skillhub.cn/plugins/JiaskyNo1/dsh-sidechat；源码与完整说明：github.com/JiaskyNo1/dsh-sidechat。DSH 插件生态由社区目录聚合，与 DeepSeek / 幻方无官方从属关系，安装与启用以你本机 DSH 版本与仓库 README 为准。
