前言¶

DSH 的侧边栏左下角是账号行，显示当前账号的昵称和头像。很多时候我们只是想让这台机器上看起来是自己——比如演示、录屏、或者多人共用同一账号时区分不同机器——但账号行跟着账号走，改起来要么改账号资料，要么干脆不去动它。

dsh-plugin-custom-profile 就是把这一行改成本地值：只改本机显示，不动账号，也不上传任何东西。下面是对这个插件的说明。

这是什么¶

dsh-plugin-custom-profile 是一个 DSH 客户端插件，维护者是 JonyFang，分类属于「趣味换装」。它的定位很窄：把侧边栏账号行的昵称和头像替换成本地、按设备保存的值。

包名是 dsh-plugin-custom-profile，插件 id 是 plugin-custom-profile，当前版本 0.2.2-rc.1，许可证 MIT。写成的客户端基线是 0.2.2-rc.1；如果账号行的 DOM 结构变了，插件会停止绘制而不是把页面搞坏。

需要注意的是，这个插件做的是纯本机显示替换：账号本身没有被编辑，值也不会上传。因此它换的是「你在自己机器上看到的名字和头像」，不是账号资料。

在 Settings → Profile 里设置昵称和头像，保存后账号行同步显示。
支持的图片格式：PNG、JPG、WebP、GIF、AVIF，单张上限 10 MB；会被裁成正方形，转成 128×128 的 WebP（失败时退回 PNG），GIF 只保留第一帧。
昵称最多 32 个字符；留空则继续显示账号名。
Reset 后保存，可以把账号名和头像还原；Cancel 丢弃未保存的编辑。
值跟着设备走，不跟账号走：清站点数据或换设备后自定义会消失。
未登录时不动账号行；侧边栏折叠时只显示头像。

一句话概括：它是在不碰账号的前提下，给当前设备加一层显示覆盖。

推荐的两种方式都来自官方 README。

方式一，直接在应用内操作。打开 Settings → Plugins → Install → Local directory，选择这个仓库的 checkout 目录。等包发布后，也可以直接搜索 dsh-plugin-custom-profile 安装。

方式二，停掉应用后用命令行：

dsh plugin --profile desktop add /absolute/path/to/dsh-plugin-custom-profile

换成其他 profile 用 dsh plugin --profile <profile> add dsh-plugin-custom-profile，或用 github:<your-account>/dsh-plugin-custom-profile。这个插件不需要构建。

想手工接线，就把目录软链到该 profile 的 node_modules，并在 cordis.patch.yml 末尾追加：

- insert:
    - id: plugin-custom-profile
      name: dsh-plugin-custom-profile

如果 Profile 没有出现，重启应用。

安装完后打开 Settings → Profile，填一个昵称，选一张头像，点 Save。账号行左下角就会显示同样的值。想恢复原样，点 Reset 再 Save；中途不想改，点 Cancel。

一个实际场景：同一账号在多台机器上跑 DSH，用这个插件给每台机器设不同昵称，只在本地生效，不影响账号在别的机器和别的端的显示。

适合想让本机账号行显示个性化昵称或头像、又不愿改动账号资料的开发者，尤其适合演示、录屏和多人共用账号的场合。它只改显示，不涉及账号数据上传。

几点需要注意：

插件以当前 dsh 进程的权限运行，安装前应先读一遍源码，确认行为符合预期。许可证是 MIT。
如果已经装了另一个绘制同一账号行的插件，二者会冲突；这个插件不会导入对方保存的值。
客户端版本变化是主要风险点。README 写明基线是 0.2.2-rc.1，客户端结构变更时插件会停止绘制；仓库里有每日 GitHub Action 盯着 Harness 页面，客户端更新后会为 dsh-compat agent 开 issue。
运行环境要求 Node ^22.19.0 || >=24.0.0，DSH 客户端 >=0.2.1-rc.5。仓库当前 57 个测试，用 npm test 运行。

这个插件的价值在于把「改账号行」拆成了「改本机显示」：不碰账号、不上传、随设备生效，需要还原时一键重置。如果只是想让手边这台机器的侧边栏看起来像自己，它是很小但够用的一个选择。

目录页：https://www.skillhub.cn/plugins/JonyFang/dsh-plugin-custom-profile

GitHub：https://github.com/JonyFang/dsh-plugin-custom-profile