材质皮肤集 John-20260101/dsh-theme-atlas

dsh-theme-atlas

DeepSeek Harness 网页端的六套材质皮肤。一个 token 引擎，深浅双版，应用内切换——不含图片，也不注册宿主路由。

English · 主题文档 · 色板参考 · 图片尺寸

Atlas 材质皮肤总览

Atlas 不是一个换色的皮肤，而是一组皮肤。每套皮肤只声明六个输入色（每种外观各一组），引擎据此推导 Web 外壳读取的 119 个 --dsw- 别名 token，再对结果做对比度测量。六套 × 深浅两版 = 十二份色板，共用同一套语义：浅色下能看清的状态色，深色下同样成立。

每套皮肤都由 CSS 画出来：签名渐变、选区色与焦点环。包内不含任何位图，也不注册插件自有路由，所以有没有宿主 webServer 服务，行为完全一致。原先放在这里的乐山照片皮肤已独立为 dsh-theme-leshan。

六套皮肤

| 皮肤 | 材质 | 主色（浅 / 深） | 正文对比度 | 预览 |
| 墨玉 Ink Jade | 和田青玉 · 宣纸 | #2E6B57 / #74C3A2 | 15.6:1 / 16.0:1 | 浅色 |
| 赤陶 Terracotta | 未上釉的陶土 · 砂 | #AE5229 / #E08C5F | 14.9:1 / 15.0:1 | 浅色 |
| 极光 Aurora | 极地冰晶 · 夜光 | #16758F / #55D6D2 | 15.5:1 / 16.3:1 | 浅色 |
| 深海 Abyss | 深海蓝 · 微光 | #1B58B4 / #5B8DEF | 15.9:1 / 16.1:1 | 浅色 |
| 樱雾 Sakura Mist | 薄樱 · 雾面 | #B1436B / #E78BA8 | 15.1:1 / 15.8:1 | 浅色 |
| 素笺 Paper | 无涂布纸 · 墨 | #1F1F1F / #E8E8E8 | 17.9:1 / 16.9:1 | 浅色 |

深色示例：极光深色 · 素笺深色。完整色板、token 表与实测对比度见 docs/palettes.md。

安装

Web profile，直接从 GitHub 安装
dsh plugin --profile web add github:John-20260101/dsh-theme-atlas

或预构建 tarball，免构建
dsh plugin --profile web add https://github.com/John-20260101/dsh-theme-atlas/releases/latest/download/dsh-theme-atlas.tgz

Desktop：插件 → 添加插件，填入 github:John-20260101/dsh-theme-atlas，启用后按提示刷新窗口。

这是一个标准 bundle：package.json 声明了 dsh.bundle 与 cordis.patch.yml，dsh plugin add 可以直接加载；client.js 已预构建，不需要构建授权。

切换皮肤

- 点击窗口右下角的 Atlas 胶囊，或按 Alt+K 轮换。
- 选择保存在浏览器本地（localStorage: dsh.theme-atlas.skin），不同浏览器可以各用一套。
- 「隐藏此钮」隐藏胶囊（dsh.theme-atlas.rail）；快捷键仍然可用，清掉该键即可恢复。
- 深浅模式仍由外壳自己的「外观」设置决定——Atlas 两套色板都在，不覆盖你的偏好。

它做了什么

1. Token 层：加载时调用 ctx.theme.overrideTokens('dsh-theme-atlas', layer)，把每个 --dsw- 别名 token 映射为 { light, dark } 一对值。换肤即替换这一层；卸载插件即移除。外壳没有主题服务时，退化为同值的局部样式表。
2. 签名氛围：一张插件自有样式表，按 html[data-dsh-atlas] 加页面渐变、选区色与焦点环，不碰任何布局，也不加载任何图片。
3. 皮肤滑轨：Shadow DOM 面板，外壳样式进不来，可键盘操作，随插件卸载一起移除。

卸载时，插件会清掉自己加的所有属性、自定义属性、样式表、滑轨与 token 层——页面回到外壳自己的绘制。除此之外不写任何东西：不写宿主设置、不落盘、不联网。

仓库里的图片

| 组 | 尺寸 | 数量 | 位置 |
| 商店截图 | 1600×1000（16:10） | 8 | assets/screenshots/ |
| 总览海报 | 2400×1350（16:9） | 1 | assets/screenshots/ |
| 主视觉 | 1536×1024（3:2） | 6 | assets/keyart/ |
| 商店图标 | 1024 / 512 / 180 方形 | 3 | assets/ |

这些只是文档与商店图片，没有任何一套皮肤读取它们。尺寸、展示建议与重新生成命令见 docs/images.md；screenshots.json 把商店指向那八张界面截图。

兼容性

- DeepSeek Harness Web 0.2.0-rc.1 … 0.2.x（dsh.bundle + dsh.client）。
- 官方 Desktop 与 dsh web 均可用；需要支持 color-mix() 的浏览器（Chromium 111+、Safari 16.2+）。
- 不依赖任何宿主服务：bundle 行是空壳，有没有主题服务都能用（退化样式表仍会应用深浅两套色板）。

开发

npm install
npm run verify # 构建 + token 完整性 + WCAG 门槛
npm run shots # 按文档尺寸重渲染全部图片

源码：src/color.mjs（色彩运算）、src/tokens.mjs（119 个 token 名契约）、src/skins.mjs（六套皮肤，每种外观六个输入色）、src/derive.mjs（角色推导）、src/runtime.mjs（token、滑轨、卸载清理）、index.js（空壳 bundle 行）。client.js 是生成物——改 src/ 后跑 npm run build。

新增一套皮肤只需在 src/skins.mjs 加一行；npm run verify 会告诉你新色板是否过关。

许可

MIT。色板命名与文案为本仓库原创；--dsw-* token 名归 DeepSeek Harness 所有。乐山照片不属于本包——它们在 dsh-theme-leshan 里。