前言¶
DeepSeek Harness（DSH）的 Web 客户端在侧栏、对话页顶部和浏览器标签页会展示默认品牌标识。若你在内网部署、做演示环境，或希望界面与自有产品名称一致，改源码再重新构建前端成本高，也不便于多人共用同一套配置。
下面介绍社区插件 dsh-plugin-brand-custom：在运行时替换侧栏与对话区的品牌位，并通过插件详情页上的设置卡片在线修改名称与图标，保存后无需重新构建、无需刷新页面即可生效。
这是什么¶
dsh-plugin-brand-custom 由维护者 lzpway-jpg 发布，在 SkillHub 社区目录中归类为「趣味换装」。插件面向 DSH Web 客户端（web profile），用自定义图标和名称占用官方 UI 中的品牌插槽，并同步替换浏览器 favicon。
项目采用 MIT 许可证，当前 package 版本为 0.1.0。主机需 dsh 0.1.7 或更新版本（该版本起主机才通过 Config schema 为插件提供 settings 能力；package.json 中 engines.dsh 亦声明了兼容的 dsh 版本区间）。
核心功能¶
经 README 说明，插件主要做以下几件事：
- 占用品牌插槽：向
sidebar.brand.mark、sidebar.brand.name、conversation.hero.brand.mark注入自定义图标与名称，并将浏览器 favicon 换为同一图标。 - 设置卡片：在 Plugins → dsh-plugin-brand-custom（点击卡片标题进入详情页）提供设置界面——编辑品牌名称、选择图标文件（PNG / JPEG / WebP / GIF / SVG，单文件上限 256KB，支持就地预览），保存或放弃更改；Reset 恢复插件内置默认资源。
- 即时更新：保存后侧栏、对话区 hero 与 favicon 立即更新，无需 reload。
- 持久化：配置写入当前 profile 的 settings 文档，换浏览器或重启 dsh 后仍保持一致。
- 与官方品牌互斥：禁用仅在
official构建中注册的ui-brand-official占用者；单一品牌插槽同一时刻只应有一个占用方。 - 默认资源：内置默认图标来自
src/client/assets/icon.png，由 tsdown 构建时内联为 base64 data URL。
安装与启用¶
在已安装且版本满足要求的 dsh 环境中，对 web profile 执行：
dsh plugin --profile web add dsh-plugin-brand-custom
也可在 dsh-market 插件市场的 GUI 中搜索 brand-custom 一键安装。
安装后重启 dsh web，打开 Plugins → dsh-plugin-brand-custom，进入设置卡片进行配置。
卸载命令：
dsh plugin --profile web remove dsh-plugin-brand-custom
典型用法¶
经过上面的安装与重启，可按下面步骤完成一次品牌替换：
- 在 Web UI 打开插件管理，进入
dsh-plugin-brand-custom详情页。 - 在设置卡片中填写品牌名称，通过图标选择器上传符合格式与大小限制的图标并确认预览。
- 点击保存；检查侧栏品牌区、对话页 hero 品牌位以及浏览器标签页图标是否已更新。
- 若需恢复插件自带默认，使用 Reset。
无需修改仓库源码或执行前端 rebuild；变更仅依赖插件 settings 与运行时插槽机制。
适用场景与注意¶
适合谁：需要在 DSH Web 界面统一展示自定义名称与 Logo 的部署者、演示环境维护者，以及希望轻量「白标」外观、又不想 fork 前端的同学。
生态说明：DSH 采用「一切皆插件」的扩展方式；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系，本文安装命令与能力描述以插件仓库 README 为准。
安全与权限：插件与当前 dsh 进程同权限运行。安装前建议在 GitHub 查阅源码与 MIT 许可证，确认图标上传与 settings 存储方式符合你的合规要求。上传图标时注意 256KB 与格式限制，避免误传过大或非支持格式文件。
开发构建（可选）：若需从源码打包，维护者在 README 中给出：
npm install --legacy-peer-deps
npm run bundle
产物 lib/client.js 为 closure-factory bundle，React、Cordis、ui-slots、ui-primitives 等由宿主 shell 在运行时提供；运行时 peer 依赖 @deepseek-ai/schemastery 由 host profile 供给。
结尾¶
dsh-plugin-brand-custom 把侧栏、对话 hero 与 favicon 的品牌展示集中到一个可在线编辑的设置卡片里，适合在 DSH Web 部署中快速换成自有标识。更多信息见社区目录页 skillhub.cn/plugins/lzpway-jpg/dsh-plugin-brand-custom 与源码仓库 github.com/lzpway-jpg/dsh-plugin-brand-custom。
