前言¶
在 DeepSeek Harness Desktop 里同时跑多个会话时,常见做法是在侧边栏来回切换标签,或开多个窗口。会话一多,对比子智能体输出、并排改 prompt 时,上下文切换成本会明显上升。dsh-plugin-ade 面向同一套 DSH 进程内的对话区,把单块会话视图改成可拖拽分屏的二叉树多窗格工作区,且分屏、重排、缩放时不卸载正在运行的 React 树,也不丢 composer 里的未发送输入。下面介绍它是什么、能做什么,以及如何安装与日常使用。
这是什么¶
dsh-plugin-ade(npm 包名 @community/dsh-plugin-ade)由维护者 JessenReinhart 发布,归类为 DSH 客户端插件。一句话定位:为 DeepSeek Harness Desktop 提供 Hyprland 风格「拖到边缘即分屏」的多窗格对话布局。它通过 Cordis patch 注入客户端 UI(布局、会话、工作区等模块),在 Web 端立即生效。
核心功能¶
以下能力均来自项目 README 与 package.json 中的说明。
边缘拖拽分屏与窗格操作¶
- 边缘投放分屏:从左侧边栏拖动任意会话行到对话视图,靠近 左 / 右 边缘为水平分屏,靠近 上 / 下 边缘为垂直分屏,投放前会显示实时 drop zone 预览。
- 拖拽重排与交换:拖动窗格标题栏到另一窗格 中心 可交换位置;拖到边缘可重新分屏,并有视觉指示。
- 局部切换分屏方向:窗格标题上的
⇄/⇅只切换 当前这一层 父子分屏的横竖方向,不会重置兄弟窗格。 - 扁平布局引擎:窗格以扁平兄弟节点渲染(
computeTreeGeometry),分屏、重排、调整分隔条大小时 不卸载 活跃 React 树与 composer。 - 关闭窗格:标题栏
✕关闭该分屏槽位,剩余树形空间由其它窗格占用。
布局预设与持久化¶
侧边栏在 Workspaces 上方新增 Layouts 区域:可一键套用 Side by Side、Stacked、Master + Stack、Quad Grid 等预设,将当前分屏树保存为自定义名称,或删除已保存布局;重启后自动恢复活动树。此处还可开关 Auto-split Subagents。
子智能体与状态展示¶
- Subagent Stack Pane:首个子智能体对父窗格分屏一次;后续子智能体进入同一右侧窗格内的 可滑动 chip 条,运行中的子智能体可自动跟随,点击 chip 即时切换且不 remount;chip 可弹出为独立窗格(总数上限 4);已完成的子智能体保留直至手动 dismiss。
- Live Agent Status Pills:窗格标题显示 RUNNING 计时、待输入时的 attention 脉冲,以及回复就绪时的 READY pill。
谱系图与侧边栏层级(README 标注 NEW)¶
- Lineage Graph & Layout Scoping:Blueprint 风格的会话与子智能体关系图画布;从当前分屏或已保存布局打开时,可 Layout Only 限定为布局内窗格及其传递闭包子智能体,并在保存布局组与
All之间过滤。 - Sidebar Subagent Hierarchy:侧边栏父会话带 chevron,可展开查看内联的子智能体会话列表。
其它¶
- 与 Glassmorphism & Motion Lab 类主题兼容,composer 与 slash 菜单仍可做 backdrop-filter 采样。
- 仓库附带 DSH Cookie 维护脚本:
npm run check-cookies、npm run clean-cookies,用于缓解 DSH 临时端口 header 过大导致的HTTP 431(「Web authentication failed」)。
安装与启用¶
插件在 DSH 配置里以 @community/dsh-plugin-ade 启用;package.json 要求 DSH 引擎 >=0.1.1-rc.1,许可证为 MIT。安装前建议浏览 GitHub 源码与许可证;插件与 DSH 客户端同进程运行,权限等同于当前 DSH 进程。
官方 CLI 安装命令如下:
dsh plugin add github:JessenReinhart/dsh-plugin-ade
若从本地检出开发构建,README 给出:git clone 后 pnpm install、pnpm run build,再在 DeepSeek Harness profile 中安装或启用 @community/dsh-plugin-ade(本文不展开 clone 流程)。
典型用法¶
README 中的可复现步骤如下。
- 创建分屏:从左侧边栏拖动会话行到对话视图,在 左 / 右 / 上 / 下 边缘悬停预览分屏区,松手完成投放。
- 调整大小:拖动任意两个分屏窗格之间的分隔条。
- 切换分屏轴:点击窗格标题的
⇄或⇅,翻转该层 immediate split 的横竖方向。 - 重排 / 交换:拖动窗格标题到另一窗格中心交换,或拖到边缘重新 dock。
- 关闭分屏:点击标题栏
✕。
布局预设与 Auto-split Subagents 在 Layouts 侧边栏区操作;子智能体 stack、谱系图等进阶能力见 README Overview 各条说明。
适用场景与注意¶
适合:需要在单窗口内并排或多格对比多个 DSH 会话、主会话与子智能体输出,并希望布局可保存、重启恢复的智能体开发者。
注意:
- 社区目录(如 SkillHub 上的插件页)为独立生态站点,与 DeepSeek / 幻方无官方从属关系;安装来源以 GitHub 与
dsh plugin add为准。 - 不要编造未在资料中出现的配置项;除 README 与
package.json外,本文未列出额外环境变量或 secret。 - Cookie 脚本是仓库内 npm script,仅在本地 checkout 且需排查 431 时使用,与 CLI 插件安装路径可能不同,按你实际部署方式执行。
结尾¶
dsh-plugin-ade 把 DSH 对话区变成可拖拽、可持久化的多窗格工作区,并在子智能体与谱系可视化上做了 stack 与 Layout 范围隔离,适合多会话并行开发。进一步了解可访问社区目录页与 GitHub 仓库:
- 目录页:https://www.skillhub.cn/plugins/JessenReinhart/dsh-plugin-ade
- GitHub:https://github.com/JessenReinhart/dsh-plugin-ade