聊天头像 ANM-Yukang/dsh-avatar

dsh-avatar — DSH 聊天头像插件

给 DeepSeek Harness 的聊天界面加上自定义头像：你的消息右侧显示你的头像，智能体每次发言左侧显示智能体头像，就像微信 / QQ 一样。

- 圆角矩形头像，上传图片后可拖动、缩放裁剪，右侧实时预览最终效果
- 用户与智能体都支持「全局」与「本会话」，本会话优先于全局
- 新会话默认使用 DSH 官方黑色鲸鱼图标
- 点击头像即可设置
- 支持 GIF / APNG / 动态 WebP 动图（保留动画）
- 不替换官方界面：官方气泡、Markdown、附件、操作按钮全部原样保留

安装方法

方式 0：让智能体帮你装（最简单）

把下面这段话连同仓库地址一起发给你的 DSH 智能体：

请帮我安装这个 DSH 插件：<仓库地址> 用 plugin_manager 的 install_bundle，target 指向本地仓库目录的绝对路径。
安装后确认 application 是 applied，并告诉我需要刷新页面。

智能体会自己完成克隆与安装。装完按 Ctrl+R 刷新页面即可。

方式 1：插件管理器

1. 把仓库克隆或下载到任意位置（不要放进 $DSH_HOME 里面）。
2. Harness → 设置 → 插件 → 安装本地插件，选择仓库根目录（含 package.json 那一层）的绝对路径。
3. 看到 application: applied 即成功，然后刷新页面。

方式 2：手动链接（进阶）

Windows（管理员或开启开发者模式） mklink /D "%USERPROFILE%\.dsh\profiles\desktop\node_modules\dsh-avatar" "C:\path\to\repo" macOS / Linux ln -s /path/to/repo ~/.dsh/profiles/desktop/node_modules/dsh-avatar

再把 "dsh-avatar" 加入 ~/.dsh/profiles/desktop/package.json 的 dsh.profile.bundles，重启 Harness。

推荐用方式 0 或 1，它们会自动处理清单与链接。

使用方法

| 想做什么 | 怎么做 |
| 设置自己的头像 | 点击自己消息右侧的头像 |
| 设置智能体头像 | 点击智能体发言左侧的头像 |
| 设为全局 | 弹窗里选「全局」 |
| 设为仅本会话 | 弹窗里选「本会话」 |
| 新会话开局就设置 | 会话还没有消息时，输入框上方会出现入口 |
| 恢复默认 | 弹窗里点「清除此范围」 |

裁剪时拖动移动、滚轮或滑块缩放，右侧实时显示最终效果。

优先级：本会话设置 → 全局设置 → 默认图（智能体为官方鲸鱼）。

格式：PNG / JPEG / WebP / GIF / BMP / AVIF / SVG；动图保留动画。

数据位置

全部存在浏览器 localStorage，不写入会话日志：

dsh-avatar:v2:user:g 你的头像（全局） dsh-avatar:v2:user:s:<会话ID> 你的头像（本会话） dsh-avatar:v2:agent:g 智能体头像（全局） dsh-avatar:v2:agent:s:<会话ID> 智能体头像（本会话）

静态图压缩到 256×256（≤192 KB）；动图保留原图以维持动画（≤1.2 MB）。

卸载

设置 → 插件 → 禁用或移除 dsh-avatar。

不要手动编辑配置档的 package.json 或 cordis.yml。

开发

node test/marks.test.js # 20 passed —— 头像显示判定 / 作用域优先级 / 动图识别
node test/css.test.js # 28 passed —— 生成样式与源码断言

测试直接从 client.js 提取被测纯函数执行，测的就是实际发布的实现。

实现要点

- 头像作为聊天行自身的伪元素绝对定位，用 padding 预留空间，不改动宿主行的子元素布局 → 随行滚动不漂移。
- 「每次发言只显示一次」由纯函数 computeAvatarMarks 按 data-chat-turn 分组计算，每回合每侧只标注第一行。
- 不注册 conversation.chat.node 的任何键，因此不替换官方渲染器。
- 官方鲸鱼路径内嵌为常量，不 require 任何 @deepseek-ai/dsh-client- 包。

许可

MIT

dsh-avatar — Custom Chat Avatars for DeepSeek Harness

Adds custom avatars to the DeepSeek Harness chat: your avatar on the right of your messages, the agent's avatar on the left of every agent reply — just like WeChat or QQ.
- 圆角矩形头像：上传图片后拖动、缩放裁剪，右侧实时预览最终效果
- 你的头像显示在你消息的右侧，智能体头像显示在其回复的左侧
- 头像跟随各自的消息行滚动，不会漂移
- 每条智能体回复只配一个头像，工具调用绝不额外添加头像
- 你的头像和智能体头像都支持 Global 和 This session，会话范围优先
- 新会话默认使用官方 DSH 黑鲸图标
- 点击头像即可更换，界面上没有多余的常驻按钮
- 支持 GIF / APNG / animated WebP（保留动画）
- 不替换官方 UI：气泡、Markdown、附件和操作按钮均不受影响

安装

方式 0：让智能体帮你安装（最省事）

把下面这段连同仓库 URL 一起发给你的 DSH 智能体：

Please install this DSH plugin: <repo URL>
Use plugin_manager install_bundle with target set to the absolute path of the local repo directory.
Afterwards confirm application is "applied" and tell me to reload the page.

智能体会完成克隆和安装。然后按 Ctrl+R 刷新页面。

方式 1：插件管理器

1. 把仓库克隆或下载到任意位置（不要放在 $DSH_HOME 里面）。
2. Harness → Settings → Plugins → 安装本地插件，选择仓库根目录（含 package.json 的文件夹）。
3. 等状态变为 application: applied，然后刷新页面。

方式 2：手动软链接（进阶）

Windows (administrator or developer mode)
mklink /D "%USERPROFILE%\.dsh\profiles\desktop\node_modules\dsh-avatar" "C:\path\to\repo"
macOS / Linux
ln -s /path/to/repo ~/.dsh/profiles/desktop/node_modules/dsh-avatar

然后把 "dsh-avatar" 加到 ~/.dsh/profiles/desktop/package.json 的 dsh.profile.bundles 里，重启 Harness。

方式 0 和方式 1 会自动处理清单和链接。

使用

| 目标 | 操作 |
| 设置你的头像 | 点击你自己消息右侧的头像 |
| 设置智能体头像 | 点击智能体回复左侧的头像 |
| 设为全局 | 在对话框里选「Global」 |
| 仅对当前会话生效 | 在对话框里选「This session」 |
| 一开始就设置两者 | 还没有消息时，输入框上方会出现入口 |
| 恢复默认 | 在对话框里点「Clear this scope」 |

裁剪时拖动移动画面，用滚轮或滑块缩放，右侧实时预览最终效果。

优先级：会话设置 → 全局设置 → 默认图片（智能体用官方鲸鱼图标）。

格式：PNG / JPEG / WebP / GIF / BMP / AVIF / SVG；动画会继续播放。

数据存储位置

所有数据都保存在浏览器 localStorage 里，绝不写入会话日志：

dsh-avatar:v2:user:g your avatar (global)
dsh-avatar:v2:user:s:<id> 你的头像（本会话） dsh-avatar:v2:agent:g 智能体头像（全局） dsh-avatar:v2:agent:s:<id> 智能体头像（本会话）

静态图片会缩到 256×256（≤192 KB）；动图保留原始字节，以保住动画（≤1.2 MB）。

卸载

设置 → 插件 → 停用或移除 dsh-avatar。

不要手动改配置档里的 package.json 或 cordis.yml。

开发

node test/marks.test.js # 20 passed — avatar marking / scope priority / animation detection
node test/css.test.js # 28 passed — generated stylesheet and source assertions

测试直接从 client.js 里抽出纯函数，跑的就是实际发布的代码。

实现说明

- 头像是聊天行自身的伪元素，绝对定位，用 padding 预留空间，宿主行的子元素布局不受影响 → 头像随行滚动，永不漂移。
- 「每条回复一个头像」由纯函数 computeAvatarMarks 算出：按 data-chat-turn 分组，每轮每侧只标第一行。
- 插件不注册 conversation.chat.node 键，所以绝不会替换已发布的渲染器。
- 官方鲸鱼路径以常量内嵌，无需 @deepseek-ai/dsh-client- 包。

许可证

MIT