前言¶
DeepSeek Harness（DSH）采用插件化架构，允许开发者扩展官方客户端的功能。在开发智能体或调试长对话时，常需要在主对话流之外进行辅助思考、代码分析或检查推理步骤，同时不希望中断当前上下文或切换到新标签页。
dsh-sidechat 是一个独立的 DeepSeek Harness Web 插件，它模仿 Codex 的分屏设计，将主对话与侧边栏对话分为两个可调整大小的面板，并提供了独立控制模型和推理强度的能力。
核心功能¶
该插件主要解决多会话并行处理的需求，核心能力如下：
- 分屏布局：将主对话与侧边栏对话并排显示，支持拖拽调整两个面板的宽度。
- 独立会话管理：从当前主对话中创建子会话。支持选中特定文本进行引用创建，且引用不会自动发送，允许用户先编辑再提交。
- 模型与推理配置：侧边栏会话拥有独立的模型选择和推理强度设置。新建会话时默认继承主对话的配置。
- Codex 风格导航：提供紧凑的历史回合导航（Turn rails）。在空闲状态下显示静音刻度，悬停时支持鱼眼效果和预览卡片，便于在两个会话中快速定位。
- 元数据展示：侧边栏展示父会话标题、短会话 ID、摘要以及一个“实时”指示器。
- 命令支持：
/sidechat：打开当前或最近更新的侧边栏会话。/sidechat content：将内容填充到侧边栏会话的草稿区。
- 通用渲染：渲染用户消息、Markdown、推理过程、工具活动、审批请求、斜杠命令生命周期及未知事件。
安装与启用¶
插件以本地 link: 包形式分发。请确保插件目录与 DeepSeek Harness 源码目录相邻，以便相对路径解析。
1. 构建插件¶
在插件目录下执行以下命令：
cd path\to\dsh-sidechat
$env:HTTP_PROXY='http://127.0.0.1:7890'
$env:HTTPS_PROXY='http://127.0.0.1:7890'
pnpm install
pnpm run build
2. 安装到 Harness Web 个人资料¶
构建完成后，切换回 Harness 目录并添加插件：
cd ..\deepseek-harness-proxy
pnpm dsh plugin --profile web add link:..\dsh-sidechat
3. 启动 Web 个人资料¶
启动 Web 服务以加载插件：
pnpm dsh web --host 127.0.0.1 --port 3080
注意：插件使用 lib/client.js 作为入口，修改 src/ 源码后需重新运行 pnpm run build 并重启 Web 个人资料。
典型用法¶
- 创建侧边栏会话：在主对话中选中一段代码或上下文文本，通过插件提供的操作（通常在头部或选中动作中）创建侧边栏会话。此时引用内容会进入草稿，需手动确认发送。
- 切换模型推理：在侧边栏会话中，可以单独为该会话选择不同的模型（如 R1 或 V3）和推理强度，用于对比不同模型的输出。
- 快捷命令：在输入框输入
/sidechat或/sidechat content即可快速唤起或填充侧边栏内容。
注意事项¶
- 依赖范围：插件使用 peer 依赖，必须与当前 Harness 检出的版本范围匹配。建议在部署前进行测试。
- 连接边界：侧边栏 RPC 调用被限制在本地 Web 连接边界内，不涉及跨域或远程 RPC。
- 数据存储：图片和消息草稿通过子会话发送，不会写入插件的关系表。
- 日志保留：删除侧边栏关系记录不会删除或取消归档底层的会话日志。
结语¶
dsh-sidechat 通过提供分屏和独立控制，让 DSH 用户能够在同一界面内高效地进行主对话与辅助对话的并行处理。它不仅保留了官方侧边栏的日志完整性，还提供了 Codex 风格的紧凑交互体验。
