Momojie-S/dsh-right-dock

dsh-right-dock

⚠️ 已废弃（2026-09-11）：DSH 0.1.5 重构侧栏体系为 sidebar | rightbar 三列布局，官方提供 rightbar 槽位与内置右侧面板/文件预览 tab（ui-sidebar-* 系列），本插件的推挤式右坞被官方方案取代。本插件不再维护；0.1.5+ 面板类插件请改用官方 rightbar/侧栏槽位体系。

DeepSeek Harness Web UI 的右侧栏平台：右缘常驻图标 rail（容器级入口，VS Code activity-bar 形态）+ 从右侧推挤对话区的多标签 dock——面板不遮挡对话，而是像左侧栏一样压缩主区宽度；窄屏（= 0.1.0-rc.6（web profile；已验证至 0.1.1-rc.2）
- Node.js >= 20（构建期；构建零 npm 依赖，离线可跑）

用法（插件作者）

挂一个标签页：

// 你的插件 client 半部
const inject = ['slots']
function apply(ctx) {
const slots = ctx.get('slots')
slots.inject('rightdock.tab', () => {
// rail 图标走 rightdock 服务声明（slot options 被 ledger 白名单化，带不了自定义字段）；
// 挂载回调触发时 dock 服务必然已就绪（坐席的父条目就是 dock 的 apply）
ctx.get('rightdock')?.setTabIcon('my-tab', MyIcon16)
return slots.register(
{ name: 'rightdock.tab', id: 'my-tab', order: 10, label: '我的标签' },
(props) => {
// props.activeTabId: 当前激活的 tab id —— 非激活时建议 display:none 保活状态
// props.dockWidth: 宽屏模式下面板宽度（px）；窄屏浮层模式为 undefined
// 标准全局 hooks（useSessions / useWorkspaces 等）照常可用（root 作用域）
return React.createElement('div', { style: { display: props.activeTabId === 'my-tab' ? 'flex' : 'none', height: '100%' } }, '...')
},
)
})
}

打开/切换/关闭（任意插件的 client 半部）：

const dock = ctx.get('rightdock')   // 可选服务，dock 未安装时为 undefined
dock?.openTab('my-tab')

入口模型

- 容器级：右缘图标 rail 常驻（有 tab 就显示），点图标直达对应 tab；点当前激活图标收起 dock。dock 关闭后 rail 仍在——重开永远有入口。
- tab 级（可选）：各 tab 插件自己放的快捷按钮（如 workspace-files 的会话标题栏「文件」按钮），语义是 toggleTab(id)——快捷方式而非唯一入口。
- rail 是布局（非浮层）：宽屏下对话区始终为 rail 让出 40px，dock 打开时再让出面板宽度，两者一起推挤主区。

安装

dsh plugin --profile web add ./plugins/dsh-right-dock
dsh web

配置

无。

验证

浏览器端：右缘出现图标 rail（挂了 workspace-files 时是文件夹图标）；点图标打开右侧栏并定位到对应 tab——对话区被推挤变窄而非被遮挡；面板左缘可拖宽（280–900px）；再点同一图标收起面板，rail 仍在。窗口缩到 <1024px 后面板转为浮层抽屉（rail 暂隐），点击背景关闭。

机制与设计取舍见 docs/design/overview.md。