前言¶
DeepSeek Harness（DSH）的设计理念是「一切皆插件」。在智能体开发或长对话管理场景下，开发者往往需要同时监控或处理多个会话。此时，频繁在会话列表中切换标签页会打断工作流。dsh-split-view 插件借鉴了终端分屏的交互逻辑，直接将 DSH 主窗口改造为多分屏容器，使你能在同一界面并排查看多个会话的状态。
核心功能¶
该插件将 DSH 主窗口转化为一个可拖拽的布局容器。每个分屏面板运行一个完整的 DSH 客户端实例，具备以下能力：
- 分屏与布局：支持向右分屏、向下分屏。分屏区域支持拖动分割条调整大小，支持横竖任意嵌套布局。
- 面板操作：双击面板标题栏可放大/还原；点击面板聚焦；通过标题栏按钮或快捷键关闭面板。
- 标题栏功能：每个面板带有标题栏，实时显示会话标题，并提供向右分屏、向下分屏、放大、刷新、关闭等操作按钮。
- 会话管理：点击标题可直接重命名会话；双击放大；支持一键复制「会话 ID + 会话标题」。
- 插件集成：插件将分屏能力暴露为 Cordis 服务，其他插件可通过 API 调用面板操作或会话交互。
安装与启用¶
安装插件需要使用 DSH 的命令行工具。
- 安装插件：
dsh plugin --profile web add dsh-split-view
- 重启生效：
安装完成后，需要重启 Web 进程才能加载插件：
dsh web
- 本地开发安装：
如果需要从源码开发或调试，使用-w参数指定本地路径：
dsh plugin --profile web add -w /path/to/dsh-split-view
- 卸载：
若需要恢复单窗口模式或紧急恢复（插件出错时会停止 Boot 进程，不会静默白屏）：
dsh plugin --profile web remove dsh-split-view
快捷键与设置¶
在任意分屏面板内，打开设置，左侧导航找到「分屏」选项即可配置。
默认快捷键¶
默认提供以下组合键，支持在设置中自定义修改。注意：自定义快捷键必须包含 ⌘（Mac）或 Ctrl（Windows/Linux）。
⇧⌘D：向右分屏⇧⌘V：向下分屏⇧⌘X：关闭聚焦面板⇧⌘Enter：最大化 / 还原聚焦面板
设置项¶
- 快捷键自定义：点击动作组合键进入录制模式，按新组合键修改绑键，Esc 取消。浏览器或系统占用的组合键也可以绑定，系统会给出提示。
- 选中高亮色：聚焦面板的边框描边和标题栏染色。提供预设色板、自定义取色器，以及「跟随主题」选项。开启跟随主题后，更换皮肤会自动适配。
- 标题栏：提供一个开关，用于隐藏所有面板的标题栏。注意：标题栏上集成了复制信息、重命名、最大化、关闭等按钮，隐藏后这些操作只能通过快捷键触发。
- 恢复默认：一键将上述设置还原。
注意事项¶
- 运行机制：插件以当前 dsh 进程的权限运行。安装前建议检查源码与许可证（MIT）。
- 错误处理：如果插件代码出错，Boot 进程会报错并停止，不会出现静默白屏。此时卸载插件是恢复系统运行的紧急手段。
- 快捷键限制：自定义快捷键组合必须包含 ⌘ 或 Ctrl，这是硬性要求。
总结¶
dsh-split-view 通过将 DSH 主窗口重构为分屏容器，解决了多会话并行查看时的切换痛点。无论是横屏并排还是竖屏嵌套，它都能提供类似终端的多任务体验。插件本身基于 MIT 协议开源，并提供了 Cordis 服务接口供生态内的其他插件调用。
