前言¶

DeepSeek Harness（DSH）侧边栏左上角默认是鲸鱼图标和 deepseek HARNESS 字样。做自用环境、演示或社区二创时，很多人会希望这一块换成自己的图标和文案。改客户端核心或打包 app.asar 成本高，也不利于随时恢复官方样式。

下面介绍社区插件 dsh-custom-brand（大肥鱼品牌图标）：通过 DSH 的 sidebar.brand 插槽做影子覆盖，改一个 JSON、刷新页面即可生效，卸载后官方品牌会回来。

这是什么¶

dsh-custom-brand 由维护者 dyguests 发布，在 npm 与 dsh-plugin.org 收录。README 将其归类为 UI & Experience；在 SkillHub 等目录里也常归在「趣味换装」一类——本质都是改侧边栏品牌展示，不动会话与核心逻辑。

插件覆盖两个插槽：sidebar.brand.mark（图标）和 sidebar.brand.name（文字与徽标）。侧边栏折叠成约 56px 窄栏时，同一图标位仍生效。

核心功能¶

覆盖方式¶

以较低 priority 注册 single slot，不卸载官方包即可叠在上面；在「插件」页关掉开关或卸载插件后，默认鲸鱼品牌立即恢复。

图标模式¶

1. glyph：按图片形状做剪影，用 currentColor 上色，背景透明，行为接近原版鲸鱼（浅色主题近黑、深色主题变浅）。
2. image：保留图片原配色，适合头像等彩色素材；可配 markRadius（如 50% 圆形）。

可配置项¶

图标路径、尺寸（12–48px）、主文字、小标签（badge）、字号、徽标配色等，均可在 JSON 中调整。图标支持绝对路径、~/、相对 $DSH_HOME、以及 http(s)://、data: 等形式。

配置变更后读本地 JSON；图标按文件 mtime 换版本号，无需重新打包，刷新页面即可。

本地 API¶

除编辑 $DSH_HOME/dsh-custom-brand.json 外，可通过本机 Harness HTTP 接口读写配置（端口以你当前 DSH 为准）。

权限与隐私¶

图标由本机 Harness 读取并经本地路由提供，不上传外网；插件只注册 UI 插槽与少量本地路由，README 写明不发起外部请求、不读取会话内容。安装前仍建议自行查看 源码 与 MIT 许可。

安装与启用¶

Web 版 profile 一般为 web，桌面版为 desktop。从 npm 安装到对应 profile：

dsh plugin --profile web add dsh-custom-brand

也可从 GitHub 源码安装：

dsh plugin --profile web add github:dyguests/dsh-custom-brand

安装后在 DSH「插件」页确认 大肥鱼品牌图标 已开启，刷新页面即可看到默认示例（包内自带大肥鱼相关剪影素材）。

要求：DSH >= 0.2.0，支持 Web 与 Electron 桌面；仅依赖上述品牌插槽，不改核心文件。

停用：在「插件」页关闭该插件开关。卸载：

dsh plugin --profile web remove dsh-custom-brand

典型用法¶

配置文件¶

配置有两个来源，后者覆盖前者：

1. 插件行上的 config:（位于 profile 的 cordis.patch.yml）
2. $DSH_HOME/dsh-custom-brand.json —— 首次运行自动生成，日常改这个即可

字段说明（摘自 README）：

示例 ~/.dsh/dsh-custom-brand.json：

{
  "mark": "",
  "markMode": "glyph",
  "markColor": "currentColor",
  "markSize": 24,
  "markRadius": "50%",
  "name": "大肥鱼",
  "badge": "DSH",
  "showName": true,
  "nameSize": "17px",
  "badgeBg": "#1b1f27",
  "badgeFg": "#ffffff"
}

换自己的图：把 mark 指到本地图片；若用彩色头像，可设 markMode 为 image。包内 assets/ 提供多版备选剪影（如 head-oval.png 默认、head-eyes.png 等），可按需选用。

用 curl 改配置¶

curl -s http://127.0.0.1:<port>/api/dsh-custom-brand/config
curl -s -X PUT -H 'content-type: application/json' \
  -d '{"name":"我的品牌","badge":"BETA","markMode":"image","mark":"~/Pictures/avatar.png"}' \
  http://127.0.0.1:<port>/api/dsh-custom-brand/config

将 <port> 换成你本机 DSH 监听端口。

适用场景与注意¶

适合：希望侧边栏品牌与个人或社区身份一致、又不想动客户端核心的 DSH 用户；需要快速试图标/文案、随时恢复官方样式的环境。

注意：

• 社区插件与 DeepSeek 官方无关；插件以当前 DSH 进程权限运行，安装前请核对仓库与许可证。
• 示例素材中的大肥鱼剪影来自社区同人立绘（dsh-pet-dafeiyu / codex-deepseek-pet 系列），二次分发或商用需自行确认原作者授权并署名；角色为社区二创，与官方无关。
• 若从旧版 dsh-brand-slot 升级，旧的 ~/.dsh/dsh-brand-slot.json 会被自动读取，接口仍保留旧路由别名。

结尾¶

dsh-custom-brand 把 Harness 左上角品牌位收成一份 JSON：图标、文字、徽标可配，刷新即生效，关掉或卸载即可回到默认鲸鱼。DSH 生态强调「一切皆插件」；社区目录（如 SkillHub 插件页）独立于 DeepSeek / 幻方，并非官方应用商店。

• 目录页：https://www.skillhub.cn/plugins/dyguests/dsh-custom-brand
• 源码与文档：https://github.com/dyguests/dsh-custom-brand