dsh-theme-leshan: Three Leshan Photography Skins for the DeepSeek Harness Web Interface

前言

DeepSeek Harness(DSH)的 Web 壳默认用一套语义化设计令牌(--dsw-*)驱动浅色与深色外观。若只想换视觉气质、又不想改布局或写 host 配置,常见做法是手调 CSS 或零散覆盖变量,维护成本高,且很难保证对话区、侧栏在两种外观下仍可读。

下面介绍的 dsh-theme-leshan 由维护者 John-20260101 发布,归类为社区目录中的「趣味换装」。它把三张乐山题材摄影当作整页背景,用同一套令牌引擎从每套皮肤的六个输入色推导出壳层所需的 119 个 --dsw-* 别名,并分别提供浅色与深色调色板;在应用内切换皮肤即可,明暗仍由壳自身的 Appearance 决定。

这是什么

dsh-theme-leshan 是一个面向 DeepSeek Harness Web GUI 的小型主题包:三张摄影皮肤 三江夜(River Night)、凌云晚照(Lingyun Dusk)、峨眉夜雾(Emei Mist),对应岷江·青衣江·大渡河蓝调、凌云崖壁晚钟、峨眉冷雾月色等画面。每张照片即页面底图;插件不写入 host 设置文档、不新增网络请求(壁纸通过插件白名单路由提供,无 webServer 时回退为 wash,界面仍可用)。

当前 package 版本为 0.1.2,许可证 MIT;与 DeepSeek Harness Web 0.2.0-rc.1 … 0.2.x 对齐(dsh.bundle + dsh.client)。浏览器需支持 color-mix()(Chromium 111+、Safari 16.2+)。

三套皮肤与可读性

每套皮肤为每种外观声明六个输入色,引擎按统一语义规则推导令牌并做对比度测量。README 中给出的正文对比度示例如下(完整表见仓库 docs/palettes.md):

皮肤 强调色(浅 / 深) 正文对比度(浅 / 深)
三江夜 River Night #A9552F / #C97A50 15.4:1 / 15.9:1
凌云晚照 Lingyun Dusk #8A6320 / #D3A961 15.4:1 / 16.5:1
峨眉夜雾 Emei Mist #25618F / #7FB2E8 16.1:1 / 15.7:1

壁纸以原生分辨率经壳层 cover 裁剪;文件名为 leshan-sanjiang-1448x1086.jpg、leshan-lingyun-1536x1024.jpg、leshan-emei-1536x1024.jpg,由 /dsh-theme-leshan/wallpapers/<file> 提供(精确文件白名单、不可变缓存与 HEAD/304 行为见 README)。

核心功能

经过上面的定位,插件实际做三件事:

  1. 令牌层。 加载时调用 ctx.theme.overrideTokens('dsh-theme-leshan', layer),将每个 --dsw-* 映射为 { light, dark };换肤替换该层,卸载插件则移除。无 theme 服务时回退为带相同取值的 scoped 样式表。
  2. 壁纸层。 插件样式表在 <body> 与对话列 [data-conversation-region="chat"] 上绘制当前照片,并用与外观绑定的 scrim(浅色约 0.86→0.90、深色约 0.74→0.82)保证面板呈磨砂 plate 效果,不改动布局。
  3. 皮肤切换条。 Shadow DOM 面板(右下角 Leshan 药丸),键盘可达;随插件卸载而移除。

安装与启用

官方 README 给出三种添加方式;预构建 tarball 无需本地 build,推荐第一种。

# prebuilt tarball, no build step (recommended)
dsh plugin --profile desktop add https://github.com/John-20260101/dsh-theme-leshan/releases/latest/download/dsh-theme-leshan.tgz

# or straight from the GitHub source
dsh plugin --profile desktop add github:John-20260101/dsh-theme-leshan

# local development: this folder is already a loadable bundle
dsh plugin --profile desktop add /path/to/dsh-theme-leshan

桌面端也可在 插件 → 添加插件 中粘贴上述地址或本地目录,启用后若壳提示则重载窗口。包体为常规 bundle(package.json 声明 dsh.bundle 与 cordis.patch.yml),client.js 已预构建,无需额外编译步骤。

插件以当前 DSH 进程权限运行;安装前请自行查看仓库源码与 MIT 许可证,确认可接受其仅覆盖主题与壁纸、不读写 host 配置的行为。

典型用法

  1. 安装并启用插件后,点击窗口右下角的 Leshan 药丸,或按 Alt+K 在三套皮肤间循环切换。
  2. 当前皮肤保存在浏览器本地:localStorage 键 dsh.theme.leshan.skin;不同浏览器可各自选择。
  3. 界面中的「隐藏此钮」会隐藏药丸(键 dsh.theme.leshan.rail);Alt+K 仍可用,清除该键可恢复按钮。
  4. 浅色/深色仍在壳的 Appearance 中切换;Leshan 提供两套调色板,不会覆盖你的明暗偏好。

适用场景与注意

  • 适合:长期在官方 Desktop 或 dsh web 中使用 DSH、希望用摄影背景统一侧栏与对话区气质、又依赖壳原生令牌体系的开发者或日常用户。
  • 注意:依赖 DSH 0.2.x 与 Web 平台;无 theme 服务时仍有 fallback,但壁纸路由依赖插件 host 能力。社区目录页(SkillHub)与 GitHub 为独立信息源,与 DeepSeek / 幻方无官方从属关系。

链接

  • 社区目录:https://www.skillhub.cn/plugins/John-20260101/dsh-theme-leshan
  • 源码与文档:https://github.com/John-20260101/dsh-theme-leshan(含中文说明 README.zh.md、主题文档 docs/themes.md、调色板 docs/palettes.md)

若你已在用 DSH 的插件生态,把 dsh-theme-leshan 当作「照片即页面、一套引擎六套调色板」的换装包即可:安装、启用、用 Leshan 或 Alt+K 切换,明暗仍交给壳本身。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye