dsh-panel-titlebar
Verifieddsh-panel-titlebar · v0.3.4 · MIT · Web UI
DeepSeek Harness Desktop chrome layout: the sidebar's global panel entries move into the Windows title bar after the Application/Edit menus, and the session stats move into the View tab row.
Install
dsh plugin add dsh-panel-titlebar Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
dsh-panel-titlebar
English | 简体中文
把侧边栏的一排全局面板挪到 Windows 应用通常放导航的地方:标题栏里,“应用 / 编辑”菜单之后。

解决的问题
装了若干面板(插件、插件市场、自动化任务、上下文洞察、记忆系统、更多)的 DeepSeek Harness profile,会把每一条都渲染成侧边栏顶部的整行。在笔记本上这就是常驻的约 240px 纵向空间,直接从会话列表里扣掉:

改造后
图标、文字、选中态、点击行为全部保留,只是变成与标题栏菜单同规格的紧凑条目横排在标题栏里;侧边栏直接从品牌行、新会话按钮和工作区列表开始:

输入框下方那排会话统计(轮/步数、解码速度、token 总量、缓存命中、上下文占用)也一并上移,落到视图标签行里「…」按钮的右侧。
实现方式
- 导航仍然是侧边栏插件自己的
sidebar.panellist注册,不复制、不包裹、不替换、不删除任何条目——所以「更多」入口、它的固定/取消固定菜单、当前面板高亮、官方条目埋点全部原样保留。 - 只有一份样式表把那个已有的
nav从侧边栏的 flex 流里取出(position: fixed),改成横排在标题栏带内。行规格对齐标题栏菜单:高 28px、字号 14px、圆角 6px、次要文字色,hover 与选中态取自主题变量。 - 样式表全部限定在
html[data-windows-titlebar]下——这个标记只有 Desktop 的 preload 会写,纯 Web 版界面保持原来的竖排不动。 - 左边距是测量出来的,不是写死的:插件读取 preload 注入的
[data-windows-menu]右边缘写入--dsh-panel-titlebar-left并保持更新,因此侧栏收起(菜单起点 48px → 84px)、切换语言、缩放窗口都不会错位。 - 条目是开关式的:再次点击当前已选中的条目会回到会话(
layout.selectPanel(null),与面板自带的“返回会话”同一去处),而不是把已经打开的面板再选一遍。这次点击会在原生处理器之前被拦下;「更多」入口不是面板条目,仍然照常打开它的菜单。 - 统计条目仍然由
conversation.composer.dock自己的注册渲染,弹层与数值更新都不变,只是换了个座位:停靠条按视图标签行「…」按钮的位置(--dsh-statbar-top/--dsh-statbar-left)定位并垂直居中。一旦找不到锚点(没有会话、在面板页、布局收起等),插件会移除data-dsh-statbar,停靠条自动回到输入框下方原位。 - 上移用的是
position: fixed,前提是这块固定盒相对视口解析。Harness0.2.2给粘性输入框座位加了will-change: transform(把它提成合成层),而这同时让该座位成为固定后代的包含块;插件在标记生效期间撤回这条提示,并在每次测量时核对停靠条是否真的落在锚点上。若将来某个版本用真实的transform/contain再次捕获固定盒,连续两次核对失败后插件会放弃上移,统计回到输入框下方,而不是压在输入框上。
环境要求
- DeepSeek Harness Desktop(Windows)——标题栏带只存在于桌面端;纯 Web 版没有这条带子,插件按设计不生效。
- Harness
>= 0.2.1-0(带sidebar.panellist行与「更多」入口的侧边栏)。 - 面板条目本身来自 profile 里安装的其他插件,本插件不创建任何面板。
安装
通过 Plugin Manager 指向本仓库目录:
plugin_manager install_bundle
target: <本仓库的绝对路径>
管理器会写入 profile 依赖、选中该 bundle 并挂载对应行。无需重启应用即可生效;若面板行没有立刻出现,刷新一次页面即可。
发布到 npm 之后,同一个调用可以直接用包名代替路径:
plugin_manager install_bundle
target: [email protected]
手工等价做法——在 profile 里加入对本目录的依赖,并在 profile 补丁中插入一行:
# cordis.patch.yml
- insert:
- id: panel-titlebar
name: dsh-panel-titlebar
卸载
在 Plugin Manager 中卸载 dsh-panel-titlebar bundle(或禁用 panel-titlebar 行)即可,侧边栏立刻恢复原本的竖排列表,不影响其他插件。
自定义
| 想要的效果 | 改法 |
|---|---|
| 离菜单更远一点 | 在 :root 上覆盖 --dsh-panel-titlebar-left(默认是测量出的菜单右边缘 + 10px) |
| 统计离标签更远一点 | 在 :root 上覆盖 --dsh-statbar-left(默认是测量出的「…」右边缘 + 18px) |
| 更紧凑的行 | 去掉行规则里的 padding / font-size,即回落到原生 36px 规格 |
| 面板与菜单之间加一点间隔 | 给第一行加 margin-left,例如 nav:has(> [class*="panelRow"]) > *:first-child |
这些全在 client.js 的 CSS 常量里,没有构建步骤。
兼容性与已知限制
- 规则依赖侧边栏的 CSS Modules 类名后缀(
panelRow、panelTitle、panelGlyph)以及承载面板行的nav。若未来某个 Harness 版本重写侧边栏,本插件可能需要同步更新;客户端模块因此声明在@deepseek-ai/dsh-client-ui-sidebar之后加载。 - 标题栏带高 40px 且不换行:窗口很窄时,末尾条目会省略并最终被裁掉,而不会挤走窗口控制按钮。
- 「更多」弹层沿用原生锚定(打开时按触发按钮的位置测量)。
- 统计上移依赖视图标签行暴露的「…」按钮(
button.viewsMore*)或viewTabs容器,并假定[data-composer-dock]里只有环境类统计条目。若某个 profile 往这个停靠条里塞了别的常驻面板,它会被一并带上去;找不到锚点时停靠条留在原位。 - 搬动停靠条依赖它的
position: fixed相对视口解析。Harness0.2.2用will-change: transform提升了输入框座位(对固定后代是包含块),样式表在停靠条上移期间撤回这条提示——代价是统计在标签行上时,该座位不单独合成。若将来某个版本用真实的transform/contain捕获固定盒,落位核对会在两次之后撤掉标记,统计回到输入框下方而不是压在输入框上。 - 已在 Windows 11 + DSH Desktop(harness
0.2.1-rc.5,150% 缩放)验证:放置位置、在线安装、侧边栏空间回收。hover 与「更多」弹层复用原生组件、为手动验证;CI 只覆盖静态契约。
开发
client.js 浏览器侧:作用域样式表 + 标题栏对齐
index.js 宿主侧:空实现(全部逻辑在浏览器)
cordis.patch.yml profile 加载时插入的 bundle 行
locale/en.json Plugin Manager 中的英文标题与描述
locale/zh.json Plugin Manager 中的中文标题与描述
icon.svg 插件清单使用的图标
test/bundle.test.mjs 静态契约测试(清单、补丁、语言资源、样式作用域)
npm run check # 对两个模块做 node --check
npm test # node --test test/
npm run pack:check # 本仓库会发布的 npm 内容
无依赖、无构建工具:浏览器模块是纯 ESM,由 Harness 的客户端模块加载器直接消费。
许可证
MIT © 2026 githublmk