dsh-client-ui-solarized-grid：Solarized 配色与网格纸背景主题插件

前言¶

DeepSeek Harness（DSH）采用「一切皆插件」的架构。在长时间开发或调试过程中，默认的 UI 界面可能难以满足视觉舒适度的需求。dsh-client-ui-solarized-grid 是一个为 DSH 桌面端 / Web 客户端设计的主题插件，旨在通过 Solarized 配色方案和网格纸背景，提升长时间阅读和交互的视觉体验。

插件简介¶

这是一个客户端主题插件，由开发者 EYEjunnnn 维护。它将 Solarized Light 和 Solarized Dark 两套配色引入 DSH，并为对话区域添加了模拟网格纸的背景，同时重新设计了对话气泡的样式。

核心功能¶

Solarized 配色：支持 Light 和 Dark 两种模式，将主题表里声明的全部 --dsw-* 令牌（别名层、静态色阶、Shiki 语法色）进行重映射。
网格纸背景：在对话滚动区（[data-conversation-scroll]）绘制背景，包含 75px 主线和 15px 细线，使用 background-attachment: local 实现随内容滚动。
已调优的对话气泡：
- 浅色模式：淡青卡片（#bfe3e0）+ 墨色左边条（#002b36）。
- 深色模式：象牙卡片（#e8dfc9）+ 朱橙左边条（#ff5900）。
- 深色模式下，卡片内文字会单独压深，防止浅字浅底导致的可读性问题。
令牌重映射：涉及 201 项 --dsw-* 令牌的覆盖。
兼容性：支持 DSH 桌面端 / Web 客户端。

安装与启用¶

桌面端目前没有 dsh CLI，推荐使用拷贝式安装（零依赖）。

将仓库解包或克隆到任意目录。
关闭 DSH 桌面端（确保补丁在启动时被读取）。
运行安装脚本。脚本会自动将文件拷贝到 <你的 profile>\plugins\dsh-client-ui-solarized-grid\，并处理挂载配置。

powershell -File .\install.ps1

启动 DSH。

典型用法¶

安装完成后，主题会在启动时生效。若要确认配置正确，需检查 profile 目录下的 cordis.patch.yml 文件，确保其中包含 ui-solarized-grid 的挂载行。

卸载¶

使用提供的卸载脚本移除挂载行（并可选删除插件目录）：

powershell -File .\uninstall.ps1            # 移除挂载行
powershell -File .\uninstall.ps1 -Remove   # 连插件目录一起删

若通过包管理器安装，则需从 dsh.profile.bundles 中移除包名，并执行 pnpm remove。

设计说明与注意事项¶

首次加载行为：首次加载时，若系统偏好解析为深色，主题会一次性 pin 成浅色模式。之后可在设置 → 外观中切换。
语义色保留：非正文的语义色（如代码块注释、警告色）保留了 Solarized 原色，未刻意压深对比度。这是为了保持 Solarized 本身的低对比度阅读性格，避免破坏语法的可辨识度。
网格绘制：网格必须画在滚动区上，不能使用 body 背景，且必须设置 background-attachment: local。
气泡边条：气泡边条只能使用 inset box-shadow，以配合圆角自然收窄，若使用 background-image 渐变会导致方角。
深色模式文字：深色气泡内文字必须使用 scoped 深色墨规则覆盖，否则会与背景色冲突。

结语¶

该插件通过重映射 201 项令牌和定制 CSS，为 DSH 提供了一套视觉上更清晰、长时间阅读更舒适的界面。其设计在可读性与原色风格之间做了取舍，适合需要在深色或浅色环境下长时间使用 DSH 的开发者。

目录页: https://www.skillhub.cn/plugins/EYEjunnnn/dsh-client-ui-solarized-grid
源码: https://github.com/EYEjunnnn/dsh-client-ui-solarized-grid