dsh-limix-cover
一个 DSH 客户端插件：把「空白会话」封面和左侧边栏品牌都换成 LimiX。
封面： [ 小鱼图标 ] 探索未至之境 [预览版] → [ LimiX 三角标 ] LimiX 智能预测Agent [预览版]
侧边栏：[ 小鱼 ] deepseek HARNESS → [LimiX 官网原始完整标志]
它怎么做到的
封面（hero）
由 @deepseek-ai/dsh-client-ui-conversation 渲染，结构是：
<span className="…fishHitbox">
{renderSlot('conversation.hero.brand.mark', { size: 34, className },
{ fallback: <HeroFish /> })} // ← 图标：官方 slot（replaceRisk: none）
</span>
<span className="…titleGroup">
<span>{t('hero.headline')}</span> // ← 「探索未至之境」
<span className="…previewBadge">{t('hero.preview')}</span> // ← 「预览版」
</span>
- 图标：占
conversation.hero.brand.mark，画自己的标 + 标题 + 徽标。 - 文字：标题和徽标是语言词条、没有 slot，而
ctx.locale.register()对同一个 命名空间 + 语言重复注册会抛错，覆盖不了。所以插件注入一小段 CSS 把原.titleGroup隐藏（[class*="fishHitbox"] + [class*="titleGroup"]，不依赖构建 生成的 class 前缀 hash），文字由 occupant 自己画。
侧边栏
由 @deepseek-ai/dsh-client-ui-sidebar 渲染：
<span className="…brandMark">{renderSlot('sidebar.brand.mark', { size: 24 }, {…})}</span>
<span className="…brandName">{renderSlot('sidebar.brand.name', {}, {…})}</span>
两个都是 shadows-shipped-ui 的替换位。单槽位的规则是「按 priority 升序取第一个
entry」，priority 相同则保留注册顺序，所以这里用 priority: -1 抢在官方 occupant
前面，实现覆盖（官方那个是 priority 0、先注册）。
同一个标还会出现在折叠护栏（span.railMark）里，复用同一个 occupant。
宿主的 brandIdentity 和 brandName 固定为 24px 高。插件将包含
.limix-sidebar-name 的这两个容器改为自动高度，让 32px Logo 完整显示。
不修改原图，也不移除侧栏整体的溢出保护。
文案
文案走客户端 locale 服务：插件注册自己的命名空间 limix-cover（zh + en），
组件里用 ctx.locale.bind('limix-cover') 取词条，切换语言即时生效，且不碰任何
官方命名空间。
不改 app.asar，不碰签名和 ElectronAsarIntegrity，升级 DSH 不会被覆盖。
文件
| 路径 | 作用 |
|---|---|
src/client.js | 浏览器半边源码（文案字典、样式、三个 slot 占用），要改就改这里 |
src/index.js | 宿主半边（空的 apply，给 Loader 一个宿主行） |
locale/zh.json、locale/en.json | 插件页显示用的标题/描述（不是运行时文案） |
assets/limix-mark.png | 官网原始图标，构建时内联成 data URI |
assets/limix-logo.png | 官网原始完整标志，供展开侧栏使用 |
assets/SOURCES.md | 官方文件地址与 SHA-256 校验值 |
assets/limix-icon.png | 官网原始图标，供插件列表使用 |
build.mjs | 把 src/* 和标志图合成 lib/client.js / lib/index.js |
lib/ | 构建产物，插件实际加载的就是这里 |
smoke.mjs | 不装插件也能跑的自测（stub loader + 渲染成静态 HTML） |
cordis.patch.yml | bundle patch：安装时把插件行插进 profile 树 |
改文案 / 换图
-
文案在
src/client.js的MESSAGES：const MESSAGES = { zh: { 'hero.title': 'LimiX 智能预测Agent', 'hero.badge': '预览版', 'sidebar.name': 'LimiX' }, en: { 'hero.title': 'LimiX Prediction Agent', 'hero.badge': 'Preview', 'sidebar.name': 'LimiX' }, };hero.badge设成''就不显示徽标。插件页里显示的名字/描述在locale/*.json。 -
品牌图只使用官方原始文件，禁止 AI 重绘或去纹理。来源与校验值见
assets/SOURCES.md。图标为assets/limix-mark.png和assets/limix-icon.png；完整标志为assets/limix-logo.png。 -
重新构建并自测：
node build.mjs && node smoke.mjs -
完全退出并重新打开桌面应用，再核对原图纹理和边缘。当前桌面版的 Cmd+R 未重新加载品牌插件，不能据此判断构建已生效。
安装 / 卸载
安装走 plugin_manager（install_bundle，target 为这个包的绝对路径），或 GUI
「插件」页的安装入口；卸载用 remove_bundle，或在插件页把它关掉。
修好这个包之后如果要重新装一次同样的路径，install_bundle 会返回
already-installed——先 remove_bundle 再装，或者直接改文件靠 HMR 生效。
已知边界
- 隐藏原标题用的是结构性选择器（
fishHitbox+titleGroup这对相邻关系）。 DSH 若重构 hero 结构，这段 CSS 要跟着调；失效表现是标题重复出现，不会白屏。 - 侧边栏图形与字标均为透明底品牌蓝 PNG，字标保留官方字形。
- 英文词条是按中文意译的（
LimiX Prediction Agent/Preview），如需固定说法改MESSAGES.en即可。