冰川玻璃主题 BAOXIAOPAI/dsh-glacier

dsh-glacier

给 DeepSeek Harness（dsh）web 端用的玻璃质感 UI 层：Antigravity 风格的蓝调画布、磨砂玻璃面板、扁平控件。以标准 dsh 插件形态分发，不改宿主一行代码。

状态：v0.2.0 — 画布 + 语义色 + 侧栏/输入容器 + 对话区已实现，冒烟 7 项全通过。剩余：空态 hero 细节、浮层（模型菜单/设置）。
设计定稿：design-prototype/（可交互原型，含 11 张验收截图）。

它做什么

| 层 | 内容 | 手段 |
| L0 画布 | 蓝调渐变 + 三个缓慢漂移的色团 + 三条斜向光带 + 颗粒 | 自建 .dsg-canvas 固定层 |
| L1 语义色 | 文字 / 强调 / 边框 / 面板底色 | 覆盖 --dsw-alias-（组件自动跟随） |
| L2 玻璃 | 侧栏、输入容器、气泡、代码块的磨砂质感 | CSS（低白度 + 高饱和 + 定向边缘高光 + 内部颗粒 + 投影） |
| L3 对话区 | 用户气泡、Markdown、代码块、工具卡与思考块、轮次尾巴 | CSS，锚点全部来自真实 DOM（[data-chat-flow-kind]、[data-code-block-]、[data-slot="tool.call.toolview"]） |

原则：只动视觉。不改组件树、不重写交互、不注册 slot 组件（v0.1）。

安装

dsh plugin --profile web add dsh-glacier

本地开发时用路径安装：

dsh plugin --profile web add /path/to/dsh-glacier

装完刷新页面即可（前端半热生效）；卸载会恢复原样——插件的样式与画布层都在 apply 里可回收。

开发

npm run check # 语法 + 选择器守卫 + 构建
npm run smoke # 在真实 Chrome 里加载产物，验证注入/幂等/销毁（需本机 Chrome）
node tools/inspect-dsh.mjs "http://127.0.0.1:3080/?token=..." # 抓宿主真实 DOM

零运行时依赖、零打包器：

client/index.js ← 前端半（自包含，构建时注入 CSS） client/.css ← tokens / canvas / theme / chat 四层（顺序即层叠顺序）内部类前缀 dgl-（dsh-glacier layer），属性 data-dsh-glacier src/index.js ← 宿主半（占位，避免 boot 期副作用） scripts/build.mjs ← 拼 CSS → 包成 window.__ModuleLoader__.load(...)

产物：

- client/client.js — window.__ModuleLoader__.load({ id, factory })
- lib/index.js — 宿主半

两者都不入库（见 .gitignore），npm publish 前由 prepack 生成。

三条硬约束（来自真实 DOM 实测）

1. 不新增全宽顶栏。dsh 是三列布局（sidebar / center / rightbar）+ 拖拽把手，顶栏会打断它。窗口按钮走 shell.leading。
2. 不删空态 hero。「探索未至之境 / 预览版 / 选择工作区 / 标准模式」是真实功能入口，只能改配色。
3. 选择器只用 [data-slot] / [data-] / 组件名子串（[class*="_newSession"]），绝不写包哈希前缀（hHd-Xa_）。scripts/check-selectors.mjs 会在 CI 里拦。

详见 docs/structure-map.md。

版本策略

- 语义化版本；0.x 期间次版本号可能包含选择器调整（跟随 DSH 升级），补丁号只修样式与 bug。
- 每个版本必须写 CHANGELOG.md，分类 Added / Changed / Fixed / Removed。
- 发布前 npm run check 必须全绿；npm run smoke 建议在本地跑一遍。
- 新增 CSS 文件要登记进 scripts/build.mjs 的 CSS_FILES（顺序即层叠顺序）。

文档

| 文档 | 内容 |
| docs/structure-map.md | 实现前必读：真实 DOM 骨架、191 个插槽、选择器策略、原型→真实映射、3 条必须避开的坑 |
| docs/design-system.md | 设计系统：画布配方、玻璃六件套、对比度实测、组件规格 |
| docs/prototype-review.md | 原型验收：截图、V01–V13、已知问题 |
| docs/2026-10-21-dsh-web与插件市场调研.md | 基础调研：插件契约、主题 API、市场机制与「兼容模式」 |
| design-prototype/ | 可交互原型（npm run dev） |

许可

MIT