前言¶
DeepSeek Harness（dsh）的 Web 聊天界面默认没有头像，消息左侧是 AI 回复、右侧是用户输入，视觉上是一整块文本流。很多开发者希望在对话里区分“谁在说话”，但又不想改动 React 组件本身。misszqm/dsh-feiyu-avatar 就是在这个需求下给出的一个轻量方案：不侵入原有组件，而是通过 CSS 在现有消息容器上叠加头像，让每条消息各自显示自己的头像，像微信那样。
它是什么¶
这是一个为 DeepSeek Harness Web 界面增加头像显示的插件，分类属于“趣味换装”。维护者为 MissZQM。插件通过一层 CSS 覆盖在 DSH 现有的聊天结构上，给用户消息和 AI 回复分别添加圆形头像，支持上传或指定本地图片路径，头像大小可在 24–64 px 之间调整，设置修改后立即生效。
核心功能¶
- 用户头像：贴在每条用户消息的右侧，包括运行途中追加的追问。
- AI 头像：贴在 AI 回复的左侧。
- 各自配置：每侧可以独立控制是否显示、上传图片或指定本地图片路径、调整头像大小（24–64 px，默认 36）。
- 两种图片来源：
- 直接上传一张图片，插件会自动裁剪成圆形。
- 填写图片的绝对路径，插件直接读取该文件，修改文件后头像自动更新。
- 不预设任何图片：未配置时两侧都不显示头像，不会出现空圆圈。
- 设置入口：DSH 设置 → 聊天头像。
- 即时生效：修改配置后无需重启或刷新页面。
- 权限与存储：图片和配置仅保存在本机
$DSH_HOME/dsh-feiyu-avatar/下，不上传到任何服务器，也不会进入代码仓库。
安装与启用¶
从 GitHub 安装：
dsh plugin add github:MissZQM/dsh-feiyu-avatar
如果使用命名 profile（例如桌面端），带上 --profile：
dsh plugin --profile desktop add git+https://github.com/MissZQM/dsh-feiyu-avatar.git
或者从本地目录安装（开发时用）：
dsh plugin add link:/path/to/dsh-feiyu-avatar
安装完成后刷新一次页面，设置中的“聊天头像”入口就会出现在侧边栏里。
典型用法¶
- 打开 DSH 的设置界面，找到“聊天头像”选项。
- 在“在聊天里显示头像”总开关中选择开启。
- 在“头像大小”中调整到需要的尺寸（例如 40 px）。
- 点击“你的头像”上传一张图片，或直接填写本地图片的绝对路径。
- 同样方式配置“AI 的头像”。
- 保存设置后，在 Web 聊天界面查看效果。
适用场景与注意¶
- 适合需要在 Web 聊天界面中快速区分用户与 AI 回复的开发者。
- 适合希望自定义头像风格、统一或区分多轮对话场景的用户。
- 注意：插件以当前 DSH 进程的权限运行，安装前建议查看源码与许可证（MIT）。
- 已知限制：头像挂在每个
assistant-step行上，工具调用过程通常被折叠进“思考过程”，一轮里一般只能看到一个 AI 头像；如果一轮中有多个可见步骤，会显示多个头像。仅在 Web 界面生效，终端界面没有聊天行，自然没有头像。
短结尾¶
misszqm/dsh-feiyu-avatar 通过 CSS 覆盖的方式，为 DSH Web 聊天添加了微信式的双侧头像，配置简单、即时生效，适合希望在聊天界面中增加视觉区分的开发者。
- 目录页：https://www.skillhub.cn/plugins/MissZQM/dsh-feiyu-avatar
- GitHub：https://github.com/MissZQM/dsh-feiyu-avatar
