前言¶
在 DeepSeek Harness（DSH）桌面壳里，窗口最上方约 40px 的标题栏由系统绘制：侧边栏开关、原生「应用 / 编辑」菜单以及最小化、最大化、关闭按钮占满这一行。若想在同一区域放上自己的标识或短文案，改壳层源码或换皮肤成本高，且容易与后续升级冲突。
dsh-app-row-brand 以插件方式向 shell.overlay 注册一条贴顶条带，内容落在 [data-windows-titlebar] 所划定的标题栏区域内；不替换各列内部布局，侧边栏自带的 brand 行保持原样。下面介绍它做什么、如何安装，以及在设置页里如何配置。
这是什么¶
- 名称：
dsh-app-row-brand（npm 包名与仓库名一致） - 维护者：CHNAQW
- 版本：0.3.0（见仓库
package.json） - 许可证：MIT
- 定位：在 DSH 桌面窗口标题栏内显示可轮播的自定义文字与图片，支持本机字体、流光效果、手动切换与固定；通过 Settings → 标题栏 / Title bar 编辑内容。
仓库与社区目录：
- GitHub：https://github.com/CHNAQW/dsh-app-row-brand
- 目录页：https://www.skillhub.cn/plugins/CHNAQW/dsh-app-row-brand
核心功能¶
渲染范围¶
- 向框架级
shell.overlay插槽注册一项，条带固定在视口顶部、位于壳层为标题栏预留的区域。 - 在非 Windows 桌面壳环境下条带不渲染，普通网页不受影响。
条目与轮播¶
- 最多 12 条；多于一条时按顺序轮播，每条有独立的停留时间（内部以
durationMs存储，设置页以秒为单位）。 - 可 Previous / Pin / Next 手动切换；Pin 后当前条固定显示并暂停轮播，取消 Pin 后恢复。
- 任一条可标记为 暂时隐藏：轮播与前后切换会跳过；设置列表中显示 hidden 标记；取消隐藏后立即回到轮播（若此前 Pin 过则 Pin 再次生效）。
单条内容¶
每条可配置：
- 文字（最多 60 字符）、颜色（色块与 R/G/B）、字体族与字号（9–40px）、粗体、下划线
- 图片：上传、外链或清除；高度锁定为标题栏 40px，宽度 8–240px 可调；上传图按栏高缩放后以 data URL 存入
localStorage - 条内在栏中的对齐：居中 / 右 / 左
- Shimmer（流光）：文字填充水平重复渐变，高亮块每周期平移一格；可设周期（秒）、高亮色、扫掠方向（默认左→右，可右→左）
字体列表来自本机：壳层授权时使用 Local Font Access API，否则通过 canvas 探测候选列表，设置页只列出实际已安装的字体族。
实现结构（供对照源码）¶
| 文件 | 作用 |
|---|---|
cordis.patch.yml |
Profile 层：插入 dsh-app-row-brand 行 |
index.js |
宿主侧：apply() 为空 |
client.js |
浏览器侧：overlay 条带、轮播与设置页 |
locale/*.json |
插件页标题与描述 |
package.json 声明 dsh.bundle.patch 与 dsh.client.inject，扩展 @deepseek-ai/dsh-client-ui-layout（框架与 shell.overlay）和 @deepseek-ai/dsh-client-ui-settings。
安装与启用¶
插件以当前 DSH 进程权限运行；安装前建议在 GitHub 查看源码与 MIT 许可证。
从 npm 安装¶
dsh plugin --profile <profile> add dsh-app-row-brand
从本地 checkout 安装¶
dsh plugin --profile <profile> add <path-to-this-folder>
在 DSH Desktop 中也可用插件管理器代替命令行。全新安装客户端模块后需 重启应用 一次；此后若链到本地 checkout，修改可热重载。
典型用法¶
- 按上文命令为指定
<profile>添加插件并（首次）重启 DSH Desktop。 - 打开 Settings → 标题栏 / Title bar。
- 在 Items 中选择、新增或删除条目；用 Order 调整顺序（轮播顺序随之改变）。
- 填写 Text、Color、Font / size、Bold / underline；按需设置 Image / width 或图片链接。
- 设置 Alignment、Shimmer 与 Display time（每条停留秒数）。
- 用 Display control 的 Previous / Pin / Next 预览；需要时用 Visibility 暂时隐藏某条。
限制与注意¶
- 配置与上传图数据保存在浏览器 profile 对应的
localStorage，不在 profile 的插件配置文件中。 - 上传图会重编码为 PNG（约为栏高的 4 倍）；过大图片可能超出本地存储配额并被拒绝。
- 条带属于拖拽区域，不拦截指针事件。
- 轮播仅在条带已挂载（桌面窗口存在）时推进。
结尾¶
dsh-app-row-brand 把品牌或提示信息放进 DSH 桌面标题栏空白区，用设置页即可完成图文、字体、流光与轮播管理，无需改壳层代码。进一步说明见仓库 README（含 README.zh.md）；安装与索引可参考社区目录 skillhub 条目 与 GitHub 仓库。
