聊天双侧头像 MissZQM/dsh-feiyu-avatar

dsh-feiyu-avatar

给 DeepSeek Harness（dsh）的 Web 聊天界面加上微信那样的双侧头像：你的每条消息右侧一个，AI 的回复左侧一个，两侧各自配置、各自可换。

功能

- 你的头像：贴在你的每条消息右侧（包括运行途中追加的追问）
- AI 的头像：贴在 AI 回复左侧
- 各自可配：显示 / 隐藏、上传图片、头像大小 24–64 px
- 两种来源：直接上传一张图；或者填一个图片的绝对路径 —— 填路径的好处是以后覆盖那个文件，头像会自动跟着变
- 不预设任何图片：没设置就不显示，不会给你一个空圆圈
- 设置入口：设置 → 聊天头像
- 改完立刻生效，不用重启，不用刷新
- 客户端只用 slots，宿主只用 webServer，不依赖任何 @deepseek-ai/ 包

关于图片

这个插件不附带任何头像图片。 装好之后两侧都是空的，头像全部由你自己上传（或指定你自己机器上的图片路径）。

上传的图片和配置只存在你本机的 $DSH_HOME/dsh-feiyu-avatar/ 下，不会上传到任何服务器，也不会进代码仓库。

安装

从 GitHub 直接装：

dsh plugin add git+https://github.com/MissZQM/dsh-feiyu-avatar.git
或者简写
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

装好后刷新一次页面。设置里的「聊天头像」就在侧边栏里。

配置

| 项 | 说明 |
| 在聊天里显示头像 | 总开关。关掉之后聊天恢复原样，图不会被删 |
| 头像大小 | 24–64 px，默认 36 |
| 你的头像 | 上传一张，自动裁成圆形 |
| AI 的头像 | 上传一张，或者填图片的绝对路径（留空 = 不用文件） |

图片和配置默认存在 $DSH_HOME/dsh-feiyu-avatar/ 下（config.json + user. / assistant.）。

它是怎么做的

DSH 的聊天区没有给头像留插槽，所以这个插件不去动 React 的消息组件，而是加一层 CSS：聊天里每条消息的外层容器自带 data-chat-flow-kind（user / assistant-step），插件只给这两类行留出内边距，再用 ::before / ::after 把头像画成绝对定位的圆。消息内容一个像素都不动。

兼容性

这层是贴着 DSH 现有聊天结构做的，属于半官方做法。如果 DSH 大改聊天区（换掉 data-chat-flow-kind 之类的属性），头像会失效 —— 最坏情况是头像不显示，不会弄坏别的功能。失效了欢迎提 issue。

已知限制

- 头像挂在每个 assistant-step 行上。工具调用过程通常会被折叠进「思考过程」，所以一轮里一般只看得到一个头像；如果一轮里有多个可见步骤，就会看到多个。
- 只在 Web 界面生效，终端界面没有聊天行，自然也没有头像。

开发

目录结构 index.js 宿主半边：路由、读写配置、存图 client.js 浏览器半边：一层 CSS + 设置页 cordis.patch.yml 往 profile 里插一行 locale/.json 插件列表里的标题和说明 icon.svg 插件图标

宿主路由在 /dsh-feiyu-avatar/ 下：config（GET/POST）、upload（POST）、user（GET 图片）、assistant（GET 图片）。

License

MIT