dsh-ui-personalization

dsh-ui-personalization

给 DeepSeek Harness（dsh）客户端的个性化插件：把侧栏底部那行账号换成你自己的头像、昵称与账户余额，另外可以隐藏侧栏顶部的品牌标识。dsh 自身不提供这些，本插件以客户端 cordis bundle 的形式挂在它预留的插槽上。

A client-side plugin for DeepSeek Harness: your own avatar, nickname and account balance in the sidebar, plus a switch that hides the top brand mark.

针对 dsh 0.2.0-rc.2（客户端构建版本相同）开发，未在其他版本上测试。

安装

dsh plugin --profile  add github:Mgeeeeee/dsh-ui-personalization

装完刷新页面；没生效就重启一次 profile。dsh plugin 是 pnpm 的直通，所以目标也可以是本地目录的绝对路径：

dsh plugin --profile 
 add /绝对路径/dsh-ui-personalization

本插件只从 GitHub 分发，没有发到 npm。设置面板的「添加插件」对话框里照样可以装，填上面那串完整地址即可；只填 dsh-ui-personalization 会报「不在 npm 注册表里」——这个失败是有意的，npm 上的旧名 dsh-personalization 属于另一位作者的插件，按名字装会装错东西。

dsh 里的 agent 也可以直接装：让它执行 plugin_manager install_bundle 。

用法

1. 侧栏底部的头像行显示你的头像、昵称，右端是该账户的余额；点它打开设置面板。
2. 设置 → 个性化：面板左侧导航里的一页，排在「Agent 预设」之后。页面按功能分两张卡片，每张以它自己的开关开头：
   • 身份行：自定义身份（开关）→ 头像（点头像即选图；鼠标悬停或键盘聚焦时，头像上浮出铅笔图标、右上角浮出叉号，点叉号恢复默认）→ 昵称
   • 界面元素：隐藏顶部品牌标识（开关）

头像在本地缩放到 128px 方图后存进 localStorage；昵称即时生效。侧栏折叠成图标栏时，昵称与余额不显示（那一行只剩头像）。

挂了哪些座位

位置	插槽	说明
侧栏底部	settings.launcher（single）	以 priority: -1 压过系统自带的账号行；「自定义身份」关掉即注销注册，原样恢复
侧栏顶部品牌	sidebar.brand.mark、sidebar.brand.name（single）	「隐藏顶部品牌标识」打开时顶上、渲染空；关掉即让回
设置面板导航	settings.section（list，id ui-personalization，order 25）	一页一条导航项；label 是随语言变化的 thunk

三处都通过 ctx.slots.inject 挂载：插槽声明出现时装上，声明消失时自动拆掉。开关控制的注册在状态变化时动态装上或注销。

品牌行的高度由壳写死（60px，且没有走 token），只清空上面两个座位会留下一块空白。插件为此额外注入一条规则，且只在开关打开时挂到文档上：

[class*="_logoRow"]:not(:has(button)){height:0;min-height:0;margin:0;padding:0;overflow:hidden}

这是整个插件唯一一处伸到自己组件之外的地方。它按壳的 CSS-modules 局部名片段匹配，并拒绝含按钮的行——Windows 上折叠按钮就在那一行里，这条守卫让那边保持原样。壳若改了局部名，规则自动失效，结果是退回"内容空了但留着空行"。

设置分页打不开指定页：壳没有对外提供"打开某个分页"的接口，所以点头像只能打开设置面板，落在哪一页由壳自己的选中状态决定。

余额

侧栏那一行右端的数字来自账户 Remote，和官方账号页同一条路径：

ctx.remote.account.getBalance({ version, locale, timezoneOffsetSeconds })

• 口径：充值余额 + 赠金余额，同一币种求和；沿用官方账号页的两位小数与不足一分显示规则（` remove dsh-ui-personalization

dsh 里的 agent 则可以执行 `plugin_manager remove_bundle dsh-ui-personalization`。

卸载后侧栏恢复系统账号行，设置导航里的一页随之消失；localStorage 里那条记录不会被清除，想清干净就删掉那个键。

一处坑：用 `link:` 装的时候，卸载不会删掉 profile 的 `node_modules/` 下那条软链，它会变成悬空链，卸载后顺手删掉。

## 开发

| 文件 | 作用 |
|---|---|
| `client.js` | 浏览器半边，全部逻辑 |
| `index.js` | 宿主半边，目前为空 |
| `cordis.patch.yml` | 往 cordis 里插入本插件的行 |
| `locale/en.json`、`locale/zh.json` | 插件卡片与详情页的标题、说明 |
| `icon.svg` | 插件卡片图标 |
| `THIRD-PARTY.md` | 抄自 dsh 自带组件的样式与标记清单 |

客户端半边按 `window.__ModuleLoader__.load({ id, factory })` 注册，`id` 必须等于包名；`react` 从页面的模块表里取，不需要自备。样式类名一律用 `dshprf_` 前缀，颜色与间距用 dsh 的主题 token（`--dsw-*`）。写死的颜色只有两类：头像的字母底色（按昵称算出来的图案色），以及覆盖层上的黑底白字——遮罩 `#00000073`、叉号角标 `#000000b3` 和它们的白图标。后者是刻意不跟主题走的：遮罩压在照片上，两种主题下都要是深底浅字。

用 `link:` 装的，改完刷新页面即可；装的是 GitHub 那份实体副本的话，工场里的改动不会进去，升级要卸了再装。新代码没生效就重启 dsh。

本插件自己的版本号写在 `client.js` 顶部的 `PLUGIN_VERSION`，设置页脚注会显示它，两边必须与 `package.json` 的 `version` 一致——结构检查会拦下不一致的发布。别把它和同文件里的 `CLIENT_VERSION` 搞混：后者是壳的构建版本，只用于余额请求的头。

## 致谢

这个插件能长得像 dsh 的一部分，是因为 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 本身是开源的：插槽机制、cordis bundle、plugin_manager 全部来自它；界面上的样式、标记与余额显示口径也都参照了它自带的组件（逐条见 [THIRD-PARTY.md](https://github.com/Mgeeeeee/dsh-ui-personalization/blob/fa73b387384753b70d477e8a4fd3c37732baf083/THIRD-PARTY.md)）。谢谢 DeepSeek 把这个项目开放出来。

## 许可

[MIT](https://github.com/Mgeeeeee/dsh-ui-personalization/blob/fa73b387384753b70d477e8a4fd3c37732baf083/LICENSE)。样式与标记的部分来源见 [THIRD-PARTY.md](https://github.com/Mgeeeeee/dsh-ui-personalization/blob/fa73b387384753b70d477e8a4fd3c37732baf083/THIRD-PARTY.md)。