本地账户头像插件：覆盖 DSH 侧栏与设置里的头像

前言¶

DeepSeek Harness（DSH）在 Web UI 里会展示当前账户的头像，位置包括侧栏底部和「设置 → 账号与余额」。默认头像跟随 DeepSeek 账户资料，无法自定义。对于只希望在本机保留个人风格头像的用户，需要一个不修改云端资料、仅本地生效的覆盖方案。

插件定位¶

本地账户头像插件（@local/local-avatar）是给 DeepSeek Harness Web UI 用的本地头像覆盖方案。由 Yoimiya-Lover-0621-01 维护，分类为趣味换装。它允许用一张本地图片覆盖侧栏和设置里的账户头像，只保存在这台电脑上，不修改 DeepSeek 账户资料，也不读取、不上传任何凭据。

核心功能¶

本地图片覆盖：上传一张本地图片后，侧栏底部的账户头像和「设置 → 账号与余额」里的头像都会显示这张图。
自动裁剪：插件会自动将图片居中裁剪为 256×256。
恢复默认：支持一键恢复到 DeepSeek 账户资料的头像。

安装与启用¶

从 GitHub 安装（推荐）：

dsh plugin add https://github.com/Yoimiya-Lover-0621-01/dsh-local-avatar

或从本地目录安装：

dsh plugin add "D:\path\to\dsh-local-avatar"

安装后重启或刷新 Web UI，即可在 设置 → 通用设置 里看到「账户头像」一行。

典型用法¶

打开 设置 → 通用设置。
在「账户头像」一行点击 选择图片，从本地选择一张图片。
插件会自动居中裁剪为 256×256 并保存；侧栏和账号页的头像立即换成这张图。
如需还原，点击 恢复默认 即可。

实现原理¶

插件在客户端注册两个位置：

settings.general.item（id local-avatar）：通用设置里的头像选择行。
shell.overlay（id local-avatar-style）：覆盖头像的样式表。

账户头像的包装元素带有 data-avatar-status；样式把本地图片铺到该元素上并隐藏原来的 <img>，因此不触碰账户状态、资料数据和 Platform 请求。

图片保存在应用本地存储的 dsh-local-avatar:v1 键中。桌面端页面是 file:// 源，选择后重启应用仍保留；如果改用浏览器打开 Web GUI（127.0.0.1 随机端口），本地存储按源隔离，换端口后需要重新选择一次。

注意事项¶

覆盖依赖 DSH 当前账户头像组件的结构（data-avatar-status 和组件类名哈希）。DSH 大版本更新后如果覆盖失效，按新组件的结构更新 client.js 里的选择器即可。
建议使用正方形图片；非正方形图片会按短边居中裁剪。

适用场景¶

适合只希望在本机保留个人头像风格、不希望修改 DeepSeek 账户资料的用户。插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。

结尾¶

这个插件在不触碰云端资料的前提下，实现了本地头像覆盖，适合希望保持个性化头像但不希望更改账户配置的开发者。更多细节可访问插件目录页或 GitHub 仓库。