前言¶
本地跑 DeepSeek Harness(DSH)时,Web 客户端侧边栏与会话页标题往往显示 Harness 自带的「DSH 本地构建」与构建版本徽章,和你在 DeepSeek 官网产品上的视觉习惯不一致。改 Harness 源码做主题成本高,也不利于跟上游同步。下面介绍社区插件 dsh-brand-deepseek:它通过 Harness 已公开的插槽系统替换侧边栏品牌与会话页标题,不改 Harness 源码,随时可在设置里关回默认外观。
这是什么¶
@linbin-mk/dsh-brand-deepseek(仓库 linbin-mk/dsh-brand-deepseek)是由维护者 linbin-mk 发布的纯第三方、自包含 DSH 客户端插件,分类为「趣味换装」。它只面向 Web profile,占用 sidebar.brand.mark、sidebar.brand.name 与 conversation.hero.brand.mark 三个公开插槽,把侧边栏换成 DeepSeek 鲸鱼标志与 deepseek 字标,并可选改空白会话页聊天框上方的标题行。
插件在 npm 上以 @linbin-mk/dsh-brand-deepseek 发布(资料中当前版本 0.5.1)。社区目录页:SkillHub - dsh-brand-deepseek。
核心功能¶
侧边栏品牌¶
启用后侧边栏显示官方风格的鲸鱼标志与 deepseek 字标,默认填充官方 DeepSeek 蓝(#4176e6)。设置页提供 十种品牌颜色,选择后立即生效并写回 Host 配置,刷新后仍保留。
会话页标题行¶
开启「会话页标题」后,空白会话页聊天框上方标题行改为「鲸鱼标志 + 想从哪里开始?」,并隐藏 Harness 默认的「探索未至之境」与预览版徽章;关闭后恢复官方默认标题。
品牌样式设置页¶
左下角 设置 → 品牌样式 集中控制:
- 自定义样式 —— 总开关。关闭后品牌插槽注销,侧边栏回到
DSH 本地构建(或DSH Local Build)与构建版本徽章。 - 会话页标题 —— 独立开关标题行 DeepSeek 样式(默认开启)。
- 轨迹页签、更多操作按钮 —— 独立显示或隐藏会话页头部这两处 UI(默认均开启);纯 DOM 层操作,不影响轨迹数据与导出(「下载 Session 日志」仍在「更多操作」菜单中)。
- 实时预览 —— 预览区随开关与颜色变化;关闭自定义样式时展示当前外壳回退品牌。
兼容性与清单展示¶
- 要求 Node.js
^22.19或>=24;DeepSeek Harness0.2.1-rc.2或兼容的0.2.1预发布版本,且为提供ctx.slots、ctx.configForms、ctx.locale的 Web profile。 package.json中engines.dsh = ^0.2.1-rc.2:Harness 插件兼容性预检在不加载插件代码的情况下读取该字段,版本不符会给出明确提示。- 包内自带
icon.svg与locale/en.json、locale/zh.json的meta.title/meta.description,插件管理器与 设置 → 插件 在未激活插件时也能显示带图标的中英文名称与说明。
安装与启用¶
把已发布包安装进自定义 Web profile。包内声明了 dsh.bundle,因此 dsh plugin add 会自动补上 brand-deepseek 配置行。
先基于默认 Web profile 导出配置,再添加插件并启动:
dsh --profile web-brand --from-default-profile web --dump-config
dsh plugin --profile web-brand add @linbin-mk/dsh-brand-deepseek
dsh --profile web-brand
从同一 profile 移除:
dsh plugin --profile web-brand remove @linbin-mk/dsh-brand-deepseek
若使用本地构建的 tarball(需自行在插件仓库内 pnpm install、pnpm build、pnpm test、npm pack),安装示例为:
dsh plugin --profile web-brand add ./linbin-mk-dsh-brand-deepseek-0.5.1.tgz
典型用法¶
- 按上一节命令安装并启动
web-brandprofile,在浏览器打开 Harness Web 客户端。 - 打开左下角 设置 → 品牌样式,确认 自定义样式 为开启(默认
enabled: true),侧边栏应显示鲸鱼与deepseek字标。 - 新建空白会话,确认标题行为「想从哪里开始?」;若不需要,关闭 会话页标题 即可恢复官方标题。
- 在十种颜色中选一种品牌色;若需完全退回 Harness 默认品牌,关闭 自定义样式 即可,无需卸载插件。
Host 侧配置命名空间为 Cordis loader 行 id brand-deepseek(与 npm 包名 @linbin-mk/dsh-brand-deepseek 故意不同,改包名不会使已有设置失效)。五个字段均为可在运行时改写的 volatile 配置:
| 设置 | 默认值 | 作用 |
|---|---|---|
enabled |
true |
自定义品牌样式总开关 |
hero |
true |
空白会话页标题行是否使用 DeepSeek 品牌标题 |
trajectoryTab |
true |
会话页「轨迹」页签是否可见 |
sessionLogButton |
true |
会话页「更多操作」按钮是否可见 |
color |
#4176e6 |
品牌颜色(十选一) |
适用场景与注意¶
适合谁: 在本地或自建环境使用 DSH Web 客户端、希望界面更接近 DeepSeek 官方品牌、又不想 fork Harness 的开发者或自用部署者。
权限与安全: 插件随当前 DSH 进程与 Host 配置域运行;安装前应阅读 GitHub 仓库 源码与 LICENSE,确认许可证与行为符合你的环境策略。本插件不修改 Harness 源码,产物也不含指向 Harness checkout 的路径依赖。
生态说明: DSH 采用「一切皆插件」思路;SkillHub 等社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系,本文介绍的插件为第三方维护(GitHub 星标数在资料抓取时为 0)。
机制要点(便于排错): 内置 @deepseek-ai/dsh-client-ui-brand-official 在 official 构建上以默认优先级占用品牌插槽;本插件以 priority: -1 注册,开启自定义样式时压过内置占位,关闭时注销并交还内置占位。客户端 bundle 的 window.__ModuleLoader__.load 的 id 必须等于包名,否则 GUI 可能无法启动。
结尾¶
dsh-brand-deepseek 用公开插槽与 Host 可持久化设置,把 DSH Web 客户端的侧边栏与会话页标题换成 DeepSeek 风格,并保留一键回退官方品牌的能力。需要细节、效果截图与构建验证说明时,以仓库 README 为准。