前言¶

在使用 DeepSeek Harness Web 进行调试或开发时，默认的发送按钮图标较为通用。若希望将主发送按钮替换为 DeepSeek 官方鲸鱼 Logo，可以使用此插件。

核心功能¶

1. 图标替换：将对话输入栏的主发送按钮图标替换为鲸鱼 Logo。
2. 行为保持：不改变发送、停止等按钮的实际交互逻辑，仅修改外观。
3. 样式实现：利用 CSS mask 叠加官方鲸鱼图形，颜色跟随按钮文字色（currentColor）。
4. 主题适配：支持亮色和暗色主题，图标颜色会自动切换。
5. 精准覆盖：纯浏览器端样式覆盖，零依赖，不误伤停止按钮、队列按钮等其他图标。

安装与启用¶

本插件通过本地包安装，本质是执行 pnpm add，会将插件写入 dsh.profile.bundles。

# 在 web profile 下安装
dsh plugin --profile web add <路径>/dsh-external-ds-whale-send-button-0.1.0.tgz

# 验证配置是否写入
dsh --profile web --dump-config

# 重启服务使配置生效

动态用法（临时）¶

在「创造模式」会话中，可以通过定义 lib/client.js 的插件对象并调用 cordis_run 来临时加载此插件。注意，这种方式重启服务后插件会丢失。

卸载¶

dsh plugin --profile web remove @dsh-external/ds-whale-send-button

工作原理¶

插件注册为 browser roster 的 client 包。初始化时会向 document.head 注入一段带 data-plugin-css 标签的 <style>。

1. 定位：使用 [data-composer-card] 选择器配合发送箭头 path 的唯一 d 前缀精确定位主发送按钮。
2. 隐藏：隐藏原上传箭头的 SVG 元素。
3. 叠加：使用 CSS mask 叠加 DeepSeek 官方鲸鱼图形（路径来自 dsh 自带的 favicon.svg）。
4. 颜色：设置 background-color: currentColor，使鲸鱼颜色随按钮文字色变化。

自定义¶

若需调整图标样式，修改 lib/client.js 中的参数：
- width/height：设置图标大小（默认 16px）。
- background-color：设置固定颜色（如 DeepSeek 蓝）。
- mask：调整图标缩放方式。

修改后重新打包并使用 dsh plugin --profile web add 更新。

注意事项¶

• 仅支持 web profile。
• 本地包安装方式需要重启服务才能生效。
• 动态插件方式重启即丢失。

结语¶

此插件通过纯 CSS 方式实现了 UI 定制，适合需要在 DSH Web 界面中强化 DeepSeek 品牌感知的开发者。