READMESource: master@1ceb475c
dsh-custom-skin
DeepSeek Harness Web UI 的模块化玻璃风皮肤。
将 plugins/client.js 放入 ~/.dsh/profiles/web/plugins/ 目录,重启 DSH 即可生效。皮肤通过 HMR 每 500ms 轮询热替换,不生效时 Ctrl+F5 强制刷新。
功能
- 极光背景:四辉光静态渐变,设置面板可调主色相(0-360)和浓度(0-160%),深浅色各一套
- 模块化玻璃卡片:侧栏三模块(logo 区 / 会话列表 / 底部动作区)+ 新会话按钮,统一 14px 圆角
- 鎏金 logo:鱼形图标 + 「探索未至之境」标题,金色渐变 + 呼吸闪烁
- 壁纸:URL / 本地图片 + 模糊(0-40px)/ 磨砂(0-100)/ 着色(0-100)三滑杆,localStorage 持久化
- 主题切换:侧栏底部浅 / 深色切换(跟随系统折叠为产品默认)
- 余额卡片:dsh-balance-monitor 插件适配,实时余额 + 剩余比例条 + 今日花费
- 对话流玻璃卡片:AI 回复 / 工具调用 / 过程节点各自独立玻璃卡,嵌套节点透明化
- 宽表格列内滚动:取消产品
.md-table-wide的「突破内容列」行为(否则表格被画到玻璃表面之外,露出裸壁纸并留下一条贯穿内容区的硬竖边),改为在内容列内横向滚动 - 内容区宽度:不自建控件——0.1.5+ 产品自带「会话内拖拽拉伸」(内容列两侧拖拽带,偏好存
localStorage["dsh.conversation.contentWidth"],默认clamp(680, 列宽×0.64, 920))。皮肤曾短暂提供设置滑杆,已于 v69 移除 - 深 / 浅色全适配:32 个主题 token × {light, dark},文字高对比度(~9:1+)
- 光影重平衡:浅色模式高光 / sheen / 阴影独立调校,深色模式低透明度原生和谐
- 滚动守护:对抗内容塌缩与原生锚定导致的阅读位置漂移(按顶锚点行补偿),跟底保持器防止跟底失效;
window.__scrollDiag为诊断入口 - 清单过期提示:产品「任务」面板的内容 = 最近一次
todo_write的整表,而工具是整表替换、没有节奏看护(实测同一会话里重写间隔中位数 ~10 分钟、最长 403 分钟),其间面板一直显示旧状态。皮肤在「清单静置 ≥ 阈值 且 对话仍在推进」时于面板头部标出「可能已过期」,悬停给出静置时长与期间新增条数;设置 → 通用 →「清单过期提示」可调阈值(默认 10 分钟,0 关闭)。只读 DOM 做提示,绝不改产品状态
技术要点
- 单文件
plugins/client.js,通过window.__ModuleLoader__.load()注册,零外部依赖 - 文件三段:常量(持久化键 / 配色源
TOKENS)→GLASS_CSS样式表 → 逻辑区块(存储读写 / 壁纸宿主 / 图片压缩 / 设置行 / 安装器 / 装配);字母分节只用于 CSS(A–Q,注释里可按字母引用),逻辑区用无字母横幅,apply()只做装配 - 量真实 DOM 的办法(GUI 带 token、Agent 拿不到;无头浏览器进不去):临时在
client.js里挂一段探针,HMR 进页面后把几何 / 计算样式 POST 到本地 sink(node起的 http 服务写 jsonl),改完即删。v72 的越界与配色就是这样定位的 - 样式表按职责分节(A–Q),每节注释职责;单一数据源,同选择器同一属性只声明一次
!important仅用于余额卡内联圆角反制(唯一例外)- 壁纸图层由插件
apply()作用域持有,设置面板关闭不销毁 backdrop-filter只用于 logo 区 / 会话列表(不含浮层的祖先),footArea 例外(内含设置弹窗)
已知问题与注意事项
backdrop-filter创建包含块会困住固定 / 绝对定位浮层(设置弹窗、头部后台任务面板两个案例)box-sizing不继承,button在 flex 中不自动拉伸- 拆除玻璃卡必须同步从 O 节 sheen 组移除(否则透明容器留方角残影)
- 插件插入的 DOM 会被 React 重渲染抹掉:过期标记按「每秒幂等补挂」实现,插入位置用「末位元素是否只有图标」判定,不依赖构建哈希类名;标记自身必须从内容签名里排除,否则计时自激
- 产品「环境自适应」装饰(如列表底部渐隐
.bhn1Oq_fade)换肤后最易显形 - 类名哈希按产品构建绑定,升级 DSH 后必须重跑「类名存亡核查」:抽出皮肤里全部产品类名 → 对已安装资产做全量字面量检索 → 未命中即失效。失效选择器不会报错,只是静默不生效;
apply()里用querySelector查产品类名(如统计行迁移)的失效更隐蔽,换版时要单独排查 - 皮肤样式表必须排在
<head>末尾:产品各 client 插件在皮肤之后注入自己的<style>时,同特异性规则按文档顺序由产品胜出 → 整页刷新后玻璃胶囊、卡片边界、设置行宽度会整体退回产品样式(HMR 热替换会把皮肤样式重新追加到末尾,所以只在刷新后复现,热替换状态下测不出来)。皮肤用 MutationObserver 把自己恒定保持在 head 最后一个元素,等效「皮肤最后加载」,不必给每条规则叠加特异性 data-chat-flow-kind在 0.1.5 落在布局包装层上(EvIC1a_flowItem),且产品折叠的「轮次过程成员」带hidden="until-found"(+data-turn-process-hidden="true")。Chromium 下hidden=until-found等价content-visibility:hidden:内容被压成 0 高,但元素自身的 padding 照常渲染 → 卡片规则的padding: 6px 10px会把每个折叠成员撑成正好 12px 的玻璃条,实测 157 条叠成一条横带。修法:规则加:not([hidden]):not([data-turn-process-hidden="true"])(:not()不影响其它节点,正常节点仍带卡片)- 0.1.1 → 0.1.5 类名迁移已完成(31 个旧哈希全部结清):核验手段是「全量字面量检索 + 源模块路径对齐 + 后缀逐一对应」,例如
.qDHVXG_*→.bhn1Oq_*(WorkspaceBrowser 28 个后缀全中)、.gdEzaW_bubble→Sixlwa_bubble、.Sxvs8a_body→hWmORq_body、.FJxK0a_root→.bOPqQW_root(JS 定位同步改)、.bqrRRG_card→mna1RW_card(ApprovalPanel 迁包)、._block_*→新哈希(按--dsl-*变量族配对)。无后继者的 3 个已删除并注明原因:ydkMvW_code/_Xvjua_body(组件被产品移除)、h8S2Va_menu(菜单已由[role="menu"]覆盖)、nL4_yW_sessionLogButton(会话日志入口并入 tabs 行) - 0.1.5 的插槽宿主是
div[style="display: contents"]包裹层:皮肤里父 > div[style] > div[style]这类依赖 DOM 层级的卡片选择器会随版本碎掉(余额卡当前恰好命中,但不稳健) - 0.1.5 有几处「故意比容器宽」的行,画成玻璃卡或被卡片
overflow:hidden裁切时会显形为「气泡宽了」:.VOzbGW_triggerRow是width:calc(100% + 4px); margin:4px -2px(侧栏设置行);.bhn1Oq_listArea/.list左右各有-4px/-12px负边距(为让滚动条贴栏缘,左侧那 4px 会被卡片圆角吃掉)。按需归零即可,注意右侧保留以维持滚轮槽贴栏缘 - 消息操作图标产品用三级灰 + 15px 细描边(
.xzv4MW_action、._8_XoUG_action),压在玻璃上偏弱;皮肤统一提到二级灰,不可用态的opacity:.4与悬停语义仍归产品 - 产品对宽表格有刻意的 breakout(
.md-table-wide用100cqw反算负 margin);玻璃表面画在「内容列」层级时,breakout 会让表格越出玻璃 → 必须把--dsh-table-lead/-spare归零收回列宽 - 定位此类「玻璃覆盖不全 / 硬竖边」问题用像素测量:截图按 DPR 换算成 CSS,沿 y 求每列平均亮度再找相邻列的跳变,可精确读出覆盖带边界(本例 570 CSS 处 −47 灰阶)
No comments yet. Be the first to write one.