Skip to content

dsh-panel-titlebar

Verified

dsh-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

CI npm License: MIT DeepSeek Harness

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,前提是这块固定盒相对视口解析。Harness 0.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 相对视口解析。Harness 0.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