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