Morandi · 纸与墨:DSH 莫兰迪语义 token 主题

前言

DeepSeek Harness(DSH)的 Web 界面默认配色偏通用;若希望长时间盯屏时界面更克制、正文与链接对比度仍可读,单靠改 CSS 往往与 DSH 的 token 体系脱节。下面介绍维护者 xwtaidev 发布的第三方 bundle xwtaidev/dsh-morandi-theme:把 Obsidian 侧莫兰迪色板改写成 DSH 可消费的语义 token 覆盖层,浅色像纸白与深褐字,深色像暖墨底与雾白字,不新增一套独立「主题菜单项」,而是叠在 DSH 原有的浅色 / 深色 / 跟随系统之上。

这是什么

Morandi · 纸与墨(发布包名 @xwtaidev/dsh-theme-morandi)是面向 Web 客户端的主题 bundle,色彩设计改编自 obsidian-morandi-theme(MIT,Copyright © 2026 xwtaidev)。工程参考 DSH 官方 decoration 模板的 bundle 结构,不包含原主题的 Obsidian CSS 或字体文件;图标为本项目原创。

核心功能

  1. 明暗两套 token:浅色为纸白背景、深褐正文、冷陶棕辅助;深色为暖墨背景、雾白正文、冷雾蓝强调。明度按正文、链接、主按钮与状态提示用途调整,兼顾可读性。
  2. 语义覆盖而非新主题项:通过 ctx.theme.overrideTokens 注册颜色与标题字体 token;在 DSH 外观里仍选浅色、深色或跟随系统,跟随系统时由 DSH 监听系统明暗并选用对应色值。正文、代码、终端字号与字体仍由 DSH 设置控制。
  3. 标题字体策略:Markdown 一至三级标题默认用系统衬线;用户设置了正文字体时,标题优先使用该字体;标题字号与行高随 DSH 正文字号变化。
  4. 边界清晰:不注入样式表、不读写其他包 DOM、不下载字体;主题客户端仅注册 token,宿主入口为空,不主动读文件、访问凭据或发起网络请求(安装插件与 DSH 本身可能涉及网络或 profile 修改,属宿主行为)。

多主题同时启用时,DSH 按覆盖层注册顺序逐 token 合成,后注册的同名 token 获胜;要稳定外观建议只启用一个主题 bundle。

安装与启用

这是独立工程,不会自行写入 DSH 配置或目标目录。在支持 theme.overrideTokens 的 DeepSeek Harness 中操作:

  1. 打开 插件 → 添加插件 → 安装第三方插件。
  2. 输入本仓库的绝对路径,或公开地址:
https://github.com/xwtaidev/dsh-morandi-theme
  1. 确认安装后在插件管理器中启用该 bundle;生效状态与警告以安装器返回为准。更新已安装包后可能需要重启以加载新模块。无需构建或安装运行时依赖。

复现特定版本时,安装前请核对并固定 Git 完整提交 SHA。npm 包名 @xwtaidev/dsh-theme-morandi 仅在发布到 npm 后可用于 npm 安装;公开 GitHub 仓库不等于已发布 npm 包。第三方索引源需单独收录并由用户添加,公开仓库或 GitHub Release 不会自动上架。

从旧本地开发版迁移: 原包名为 @local/dsh-morandi-theme,与现包名是不同插件身份。更新前备份 DSH profile,先禁用并卸载旧包,再安装新包,确认旧条目已移除并重新测试;不要假设更名会自动升级。

典型用法

安装并启用后,在 DSH 外观设置中选择浅色、深色或跟随系统即可看到对应莫兰迪 token。禁用或卸载 bundle 会释放其注册的 token 层,恢复先前的主题或覆盖层。

维护者在仓库内用 Node 自带测试验证注册与切换逻辑(不等同于 GUI 目视验收)。需要支持 node:test 的 Node.js(建议 Node 18 或更新),无第三方依赖:

cd dsh-morandi-theme
npm test

适用场景与注意

适合需要在 DSH Web 端使用低饱和、纸墨感配色、且宿主已提供 theme.overrideTokens 与 @deepseek-ai/dsh-client-ui-theme 注入能力的用户。作者报告曾手动测试本地开发版,更改包名后仍应重新安装并验证;README 尚未声明完整验收的 DSH、Node 或操作系统版本范围。

插件以当前 DSH 进程权限运行;安装前应阅读源码与 LICENSE,确认许可与行为符合你的环境。截图与包内对比度检查不构成完整安全或无障碍认证。

结尾

Morandi · 纸与墨把 Obsidian 莫兰迪色板收敛为 DSH 语义 token 层,在保留 DSH 明暗与字体设置的前提下统一界面气质。目录与详情可在社区插件页查看,源码与说明见 GitHub:

  • 目录页:https://www.skillhub.cn/plugins/xwtaidev/dsh-morandi-theme
  • 仓库:https://github.com/xwtaidev/dsh-morandi-theme
羽毛球分组比赛记分
小程序二维码

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

小夜