lehhair/dsh-split-panes 预览 preview

lehhair/dsh-split-panes

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness (DSH) that adds split-pane conversation functionality, following DSH’s officially supported native PiUI design system. It lets users split the main conversation view into multiple independently operated panes, each bound to its own separate conversation session. It does not patch or modify the DSH core code, instead it vendors the core’s slot renderer byte-for-byte, and constructs a pane-scoped host for each pane so all UI elements including headers, message flows and input components are rendered with original native DSH core code.

Users can trigger splits via the split button in the conversation header or keyboard shortcuts, including mod+shift+arrow keys for horizontal and vertical splits, and mod+shift+w to close an existing pane. Split dividers can be dragged directly or adjusted via keyboard to set pane proportions between 0.1 and 0.9 of the total available space. Clicking a pane sets it as the active focus, and any conversation selected from the sidebar is automatically bound to the focused pane, matching DSH’s existing global selection model.

The plugin is licensed under BSD-3-Clause, matching the license of the vendored DSH core renderer code. To install it, users first clone the repository to a local path, then run dsh plugin --profile web add link:/path/to/dsh-split-panes via the DSH CLI, then restart the DSH web client to see the new split button. The development and test baseline is DSH core version 0.1.5-alpha.2, it is also compatible with 0.1.2-rc.1, and a scheduled GitHub workflow checks for core updates every 6 hours and opens an upgrade PR only when relevant interface changes are detected.

这是一款专为 DeepSeek Harness(DSH)开发的原生对话分屏插件,采用 PiUI 风格实现,支持将对话信息流拆分为多个可独立操作的窗格,每个窗格绑定独立会话。插件支持分屏/层叠布局、四向拖拽调整窗格大小,还支持将侧边栏会话拖入指定窗格。它不需要修改或重打包 DSH 核心,而是逐字节复用核心渲染器代码,为每个窗格构造独立的作用域主机。

用户可以通过会话头部的分屏按钮、快捷键 mod+shift+方向键 快速分屏,用拖拽分隔条或键盘调整窗格比例,支持窗格全屏(保留分屏树结构,退出后恢复原布局)。点击窗格即可切换焦点,侧边栏选中的会话会自动绑定到当前焦点窗格,拖动侧边栏会话到窗格中心可替换内容,拖到边缘即可在对应方向新建分屏。适合需要同时对比多个会话、多任务并行处理对话的用户。

这个插件遵循 BSD-3-Clause 许可证,和 DSH 核心渲染器许可一致。安装需要先克隆仓库到本地,再通过 DSH CLI 命令添加本地插件路径,重启 DSH Web 后即可使用。开发测试基于 DSH 核心 0.1.5-alpha.2 版本,兼容 0.1.2-rc.1,上游每 6 小时检测核心更新,仅在接口变化时自动发起升级 PR。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 7 stars - very few users, little community feedback星标只有 7,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:lehhair/dsh-split-panes

把 lehhair/dsh-split-panes 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dshfind

dsh-split-panes

DSH 对话分屏插件(PiUI 风格):把信息流分成多个可独立操作的窗格,每个窗格绑定自己的会话——分屏/层叠、四向拖拽分配、侧边栏会话拖入。每个窗格都跑核心自己的渲染器,插件只提供容器、焦点路由与交互。

免补丁:不修改、不重打包核心。插件把核心的 slot 渲染器(createSlotRenderer)逐字节 vendor 进仓库,给每个 pane 构造一个 pane 作用域的 host(SlotRendererHost 是公开接口),于是核心的 outlet 用这个 pane 的 session binding 渲染——header / 消息流 / composer / hero 全部是核心代码。

功能

  • 分屏组合:header 分屏按钮 + mod+shift+方向键(左右/上下),mod+shift+w 关闭窗格;分隔条可拖拽、可键盘调节(比例 0.1–0.9)
  • 窗格全屏:pane header 的全屏按钮把该窗格铺满整列,分屏树原样保留;再点一次或按 Esc 退出,精确回到分屏状态
  • 每窗格独立会话:每个 pane 绑定各自的会话;分屏是纯视图操作——新窗格是"新建对话"占位(不创建 host 会话),在占位里选工作区才真正创建会话并绑定到该 pane
  • 焦点即全局选中(OpenCode 模型):点 pane → 它成为焦点并让全局选中跟随(侧边栏高亮同步);点侧边栏会话 → 改的是焦点 pane 的内容,其余 pane 保持 pinned
  • 侧边栏拖拽分配:拖会话到 pane 中心=替换,四条边缘=向该侧分屏(拖拽通道完全插件化:capture 阶段反查行 DOM)
  • 原生视觉:单窗格时逐字节等同原生(无边框无 chrome);分屏后焦点 pane 带品牌蓝边框

效果预览

dsh-split-panes 分屏效果

为什么需要 vendor 核心渲染器

核心没有"按任意 session id 渲染"的扩展点(详见 docs/ARCHITECTURE.md §2:ScopeProvider 硬编码 adapter.current,binding context 私有、installScope 一次性、renderSlot() 只允许 'root'、SlotScope 是封闭联合)。

但核心公开了渲染器的输入契约 SlotRendererHost:

renderRoot(host)
 ├─ HostContext.Provider(host)
 ├─ RootStandardProvider        ← 读 host.root
 ├─ ScopeProvider               ← 读 host.scope('session').current   ★ 决定 binding
 └─ RootOutlet                  ← 读 host.entriesOfSlot('root')

host 由调用方提供。所以每个 pane 用一个合成 host(scope('session') 指向本 pane 的 binding、entriesOfSlot('root') 返回一个只有一行 renderSlot('conversation') 的合成 root、entriesOfSlot('conversation') 过滤掉插件自己的影子),核心渲染器就把原生会话渲染进这个 pane 了。

createSlotRenderer 没有从已发布的 @deepseek-ai/dsh-client-ui-renderer 导出(npm 包只带 lib/),所以渲染器源码 vendor 进 src/client/vendor/renderer/,由 scripts/sync-renderer-vendor.mjs 同步、tests/renderer-vendor.spec.ts 逐字节守门。

安装

git clone https://github.com/lehhair/dsh-split-panes.git
dsh plugin --profile web add link:/path/to/dsh-split-panes

重启 dsh web 即可使用(会话 header 出现分屏按钮)。

版本:开发与测试基线是核心 0.1.5-alpha.2(vendor 的渲染器副本来自该版本;alpha.2 引入的 main 面板模型已适配)。0.1.2-rc.1 也实测可用(分屏 / 双 pane 各自会话 / 焦点路由 / 拖拽),0.1.5 才有的东西(右侧栏等)在该版本上不存在,插件优雅降级。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev deepseek-harness-box 下一个 Next dsh-plugin-merge-tool-calls →