dsh-brand · 一键品牌替换
面向 DSH Web GUI 二次开发的一键品牌插件。无需修改或重新构建 Web Shell，在 设置 → 品牌 Branding 中填写配置即可即时替换产品品牌。
当前主要兼容基线：DSH v0.1.5-rc.1。已核对 DSH v0.1.5-rc.2：品牌 Slot、设置 Slot、插件加载接口及本插件使用的会话/侧栏结构未发生不兼容变化，当前版本可直接使用。
使用体验
下图来自实际运行界面，会话标题、正文、路径和任务内容已经脱敏。
dsh-brand 使用体验（已脱敏）
插件配置页
配置值中的 Data URL、SVG 和产品信息已经脱敏。
dsh-brand 配置页（已脱敏）
特性
- 商标 Logo：侧栏与新会话 Hero，支持文字、Emoji、图片 URL、Data URL 和原始 SVG
- 产品名称与版本徽标：支持普通文字或艺术字图片
- Hero 主标题、徽标与一句话简介
- 浏览器标签页标题与 favicon
- 思考状态文字自定义：同时替换
Think 行标题与 Deep diving... 运行状态
- 发送、停止按钮支持独立自定义图标
- 品牌主色支持手动取色或从商标自动提取主色
- 可隐藏 DSH 内测声明弹窗
- 配置保存在独立 JSON 文件，便于不同厂商分发二改版本
- 停止或卸载插件后恢复系统界面
品牌主色作用范围
“启用品牌主色”默认开启。颜色留空时，插件会从商标图片中采样，选取非透明、非近白区域中占比最高的颜色；手动填写颜色时，以手动颜色为准。
设置页提供品牌色作用范围多选列表，默认全部勾选，也可以按需要只保留部分 UI：
- 侧边栏操作图标
- 工作区“项目”文件夹图标
- Think / 深度思考图标与标题
Deep diving... 运行状态文字- 发送按钮与停止按钮
每项可以独立勾选或取消，并提供“全选 / 全部取消”。关闭“启用品牌主色”总开关后，上述 UI 全部恢复系统原配色，但不会清除已填写颜色和作用范围选择。旧配置没有 colorTargets 字段时自动按全选处理。
换肤兼容说明： 商标、产品名称、版本徽标、浏览器标签页标题和 favicon 属于稳定品牌项，通常不会被 UI 换肤插件覆盖。品牌主色属于样式层增强；如果其他换肤插件使用了更高优先级规则，部分图标或文字颜色可能被覆盖，最终效果取决于样式加载顺序与选择器优先级。
安装
git clone https://github.com/advance-lion/dsh-brand.git
dsh plugin --profile web add <克隆下来的 dsh-brand 目录>
如果当前 CLI 支持 github: 规格，也可以直接安装：
dsh plugin --profile web add github:advance-lion/dsh-brand
本包为纯手写 ESM、零依赖、免构建，lib/ 即产物，无需运行 npm install 或 build。
安装后访问 http://127.0.0.1:3080。若插件未出现，重启一次 dsh web，然后使用 Ctrl+F5 硬刷新。
使用
- 打开 设置 → 品牌 Branding。
- 填写需要替换的品牌字段。
- 点击“保存并应用”。
- 使用“恢复默认”可一键清空品牌配置。
Host 字段发生变化或插件首次升级后，需要重启一次 dsh web；普通配置修改保存后即时生效。
配置字段
| 字段 | 作用位置 |
|---|
name | 侧栏产品名，支持文字、图片 URL、Data URL、SVG |
version | 产品名称旁的自定义版本徽标；非空时优先于 DSH 构建版本 |
useDshVersion | 自定义版本留空时显示当前 DSH 构建 Hash/包版本，默认 true |
headline | 新会话 Hero 主标题 |
badge | Hero 徽标 |
intro | Hero 简介 |
logoText | 旧版兼容字段：文字或 Emoji 商标 |
logoUrl | 主商标，优先于 logoText；也是自动取色来源 |
title | 浏览器标签页标题 |
favicon | 浏览器标签页图标 |
sendIcon | 发送状态图标；留空使用系统箭头 |
stopIcon | 停止状态图标；留空使用系统方块 |
thinkText | 同时替换 Think 行标题与 Deep diving... 运行状态文字 |
colorEnabled | 品牌主色总开关，默认 true |
colorTargets | 品牌主色作用范围，默认 sidebar,project,think,diving,composer |
color | 品牌主色；留空时自动从 logoUrl 提取 |
hideNotice | 是否隐藏 DSH 内测声明弹窗 |
配置保存在 $DSH_HOME/dsh-brand.json，默认位置为：
C:\Users\<用户>\.dsh\dsh-brand.json
示例：
{
"name": "Acme Harness",
"version": "",
"useDshVersion": "true",
"headline": "探索未至之境",
"badge": "预览版",
"intro": "面向内部的智能体工作台",
"logoUrl": "https://example.com/logo.svg",
"title": "Acme Harness",
"favicon": "https://example.com/favicon.svg",
"sendIcon": "",
"stopIcon": "",
"thinkText": "深度思考",
"colorEnabled": "true",
"colorTargets": "sidebar,project,think,diving,composer",
"color": "",
"hideNotice": "true"
}
实现说明
- 使用官方品牌 Slot：
sidebar.brand.mark、sidebar.brand.name、conversation.hero.brand.mark。
- Host 提供同源
GET/PUT /api/dsh-brand/config 接口读写配置。
- Host 在 HTML 首屏注入品牌配置，减少刷新时默认商标、标题与 favicon 闪现。
- Hero 接管和部分精确配色使用受限作用域选择器，不修改整个应用的全局主题变量。
- Think 标题、发送/停止状态均保留原生交互语义，仅替换显示层。
