dsh-caption-bar:把视图标签搬进 Windows 标题栏,收回一行纵向空间

前言

在 DeepSeek Harness 桌面端里,会话导航和头部工具栏往往会单独占一行。笔记本或矮屏上,对话区域被挤得更紧。常见做法是接受默认顶栏布局,或靠缩小窗口、隐藏侧边栏来换空间——都不改「导航与工具各占一行」这一结构。

下面介绍社区插件 dsh-caption-bar(维护者 FAVKTOXIC,分类:客户端)。它把 对话 / 轨迹 / 上下文 / 编队 等视图标签挪到 Windows 标题栏(caption row),紧挨原生 应用 / 编辑 / ⋯ 菜单;其余头部工具收进右侧约 42px 的紧凑栏。对话区在右侧精确让出 --dsh-capbar-rail,消息不会被栏遮挡。

这是什么

dsh-caption-bar 是面向 DSH 桌面布局的客户端插件:不新增业务功能,只重组窗口 chrome 与头部控件的落位。README 写明在 Codex UI 1.1.49 与 DSH desktop 0.2.1-rc.3+ 上验证过;package.json 中 engines.dsh 为 >=0.2.1-rc.3 <0.3.0,插件版本 0.2.0,许可证 MIT。

无 Codex UI 的主机会走最小单列回退布局。

核心功能

标题栏与对话区布局

最终布局可概括为:

区域 内容
Caption row 应用菜单 → 视图标签 / 更多视图 → 居中会话标题 → 全屏 → 原生最小化 / 最大化 / 关闭
右侧栏 Agent 预设、子智能体状态/数量/菜单、后台任务状态/数量/菜单、文件管理器分栏、工具菜单、右侧边栏控制
对话区 右侧留出 --dsh-capbar-rail 宽度,栏不盖住消息

视图标签沿用预加载菜单栏的尺寸与 token:28px 控件、10px 水平内边距、6px 圆角、2px 间距、14px 文字,悬停使用 --dsw-alias-interactive-bg-hover;Codex UI 的 [data-dcu-tab-slider] 仍作为选中指示,插件保留其定位包含块。

紧凑右侧栏(默认开启)

默认在 body 上生效:

--dsh-capbar-compact: 1;

紧凑栏宽 42px,控件目标 30px(两侧各 6px)。Agent 预设、子智能体、后台任务等保留图标与动态计数,文字标签在紧凑模式下隐藏;工具与右侧边栏图标控件不变。

需要完整文字标签与 104px 栏宽时,可设为:

--dsh-capbar-compact: 0;

布局扫描会在约两秒内识别;关闭紧凑模式或卸载插件后,插件添加的紧凑标记、替换计数与 title 会一并移除。

状态气泡

后台任务与子智能体的状态变化不参与栏宽计算:

  • 最新一条在栏左侧固定气泡中显示约三秒;
  • 新状态覆盖旧状态;
  • 点击气泡打开原控件;
  • 样式仅使用应用已有的背景、边框、圆角与文字 token,无自定义色、阴影、模糊或动画。

插件通过语义 DOM(aria-label、状态点、稳定 data-*)读取信息,不依赖私有 jobs-store API。

视觉与兼容约定

插件以布局为主:不引入自定义色、字体、图标、模糊、透明度、阴影或动画。明确例外包括:去掉 stock header 的 border-bottom 细线;视图标签镜像预加载 menubar 的按钮尺寸与 hover;紧凑模式下隐藏部分标签;状态气泡仅用现有 token。

与 Codex UI 协作时会设置 body[data-dsh-title-bar-compat] 与 --dsh-title-bar-strip;卸载时 apply() 返回的 disposer 会 retract 注入样式、observer、监听器、内联覆盖等(smoke 测试覆盖该契约)。

安装与启用

在 PowerShell 中执行官方 README 给出的命令:

dsh plugin --profile desktop add dsh-caption-bar

首次安装后需重启 DSH 桌面应用一次。

卸载:

dsh plugin --profile desktop remove dsh-caption-bar

典型用法:调参

除紧凑模式外,README「Tuning」表列出可在 CSS 中覆盖的变量(节选):

变量 默认 含义
--dsh-capbar-compact 1 1:42px 紧凑栏;0:104px 全标签栏
--dsh-capbar-rail 104px 全标签栏宽;紧凑模式会覆盖为 42px
--dsh-capbar-rail-gap 6px 栏内控件垂直间距
--dsh-capbar-button 28px 全屏按钮盒尺寸
--dsh-capbar-gap 10px 与原生标题按钮前的间距

将上述变量写在作用于 body 的样式中即可;具体测量项(如 --dsh-capbar-lead、--dsh-capbar-title-*)由插件在运行时测量。

适用场景与注意

适合谁: 长期在 DSH 桌面端对话、希望多出一行给消息区,且使用带 Codex UI 的 Windows 布局的用户。

权限与安全: 插件随当前 DSH 进程与用户配置加载,以客户端注入方式改 DOM 与样式。安装前应在 GitHub 仓库 阅读源码与 MIT 许可证,确认与本地 DSH 版本满足 >=0.2.1-rc.3 <0.3.0。

生态说明: DeepSeek Harness 采用「一切皆插件」思路;SkillHub 目录页 为社区站点,与 DeepSeek / 幻方无官方从属关系,并非官方应用商店。

结尾

dsh-caption-bar 把会话视图搬进 Windows 标题栏、工具收成右侧窄栏,在不大改视觉语言的前提下收回一整行纵向空间,对矮屏更友好。

  • 目录页:https://www.skillhub.cn/plugins/FAVKTOXIC/dsh-caption-bar
  • 源码与文档:https://github.com/FAVKTOXIC/dsh-caption-bar
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye