前言¶
DeepSeek Harness（DSH）的 Web 端默认界面够用，但长时间对话时，配色、字体对齐、思考块与工具链的展示密度，以及官方 API 峰谷计费时段，往往要靠自己改样式或查文档。社区里也有零散的主题或脚本，多半不能在一个设置页里即时开关，改完还要刷新或重启。
下面介绍 dsh-uxexo：由维护者 jiangnanquan（江南泉） 个人开发并免费开源的 DSH Web UI 增强插件。它在设置面板里单独提供「界面增强」一页，各项功能改完即时生效；包含 25 套终端美学配色、中文优先的 0.5 窄体等宽字体、文字墨色档位、紧凑布局、思考/工具链折叠胶囊，以及账户余额、本轮成本、近 30 天用量与官方峰谷提醒。插件在 DSH 社区目录 归类为「趣味换装」，GitHub 仓库当前约 9 stars。
这是什么¶
dsh-uxexo 通过 DSH 的 bundle patch 与 client 注入，在 web profile 下增强官方 Web UI，不替代 DSH 本体。package.json 中版本为 2.0.0，许可证 MIT。
能力集中在 设置 → 界面增强：总开关与各子项写在 <html> 的 data-dsh-ux-* 属性上，并同步 cookie，宿主在首帧前恢复状态，避免先闪官方主题再跳转。插件本体更新后需 重启 DeepSeek Harness（客户端半可热重载，宿主半的 /enh/* 接口与首帧脚本在进程启动时加载）；设置页会比对两半构建号并提示。
核心功能¶
设置页与即时开关¶
打开 设置 → 界面增强 即可管理全部选项。关掉「启用 dsh-uxexo 界面增强」会整层撤下增强并回到官方外观，分项选择会保留。除插件升级外，不需要重启。
| 开关 | 作用概要 |
|---|---|
| 启用 dsh-uxexo 界面增强 | 总开关 |
| 配色主题 | 25 套或「Official · 官方配色」；默认 Solarized |
| 新会话按钮弱化 | 默认「新会话」跟随主题 accent；打开后仅略深于侧栏 |
| 字体方案 / 字重 | 中文优先等宽方案；字重标准 / 半粗（默认半粗） |
| 文字墨色 | 深墨（默认）/ 跟随配色 / 纯黑；仅浅色主题 |
| 紧凑布局微调 | 消息列宽、间距、输入卡片与菜单对齐等 |
| 折叠胶囊 | 思考块与工具链摘要胶囊；0.2.x 与官方过程分组联动 |
| 账户余额与用量 | 输入框下方余额、本轮成本、图表与峰谷徽标 |
25 套配色主题¶
主题取自江南泉《终端美学》三部曲，在 外观 → 配色主题 下拉中按分组切换：官方、经典 CRT、纸面浅色、现代双生、AI 品牌等共 25 套。命名格式为 English · 中文（如 P1 Green Phosphor · 绿磷光、Tokyo Night · 东京夜）。
每套只声明底色、正文、强调、状态色四个锚点，其余 surface / border / hover 由同一套规则推导；深色主题自动设置 color-scheme: dark。0.2.x 起还接管官方公共菜单玻璃材质及相关 token（文档称共 49 个），避免深色页面上菜单仍呈浅色玻璃块。主题第三个锚点 accent 统一用于发送/停止按钮与侧栏「新会话」（可弱化）。
文字墨色¶
针对浅色主题下部分配色（如 Solarized）正文对比度不足，插件只改文字 token，不动背景与品牌色：
- 深墨（默认，推荐）：如暖青黑
#002b36，提升浅色面上的可读性。 - 跟随配色：继承主题自带墨色。
- 纯黑：
#000000，对比度最高，大段正文可能偏硬。
深色主题各自定义 ink，此项不覆盖；按钮反白字不受影响。
中文优先与 0.5 窄体字体¶
依据「汉字 1.0 正方、西文收窄到 0.5 以实现 2 个西文字符与 1 个汉字等宽」的思路，设置页提供：
- 自动（推荐）：依次尝试更纱黑体 Mono → Term → Noto Mono CJK → Maple Mono，未安装则回官方字体栈。
- Sarasa Mono SC / Sarasa Term SC / Noto Mono CJK / Maple Mono / 关闭。
本机已装字体会在页面上探测标注；字重可选标准或半粗（默认半粗），并关闭 font-synthesis 避免伪粗。页面底部有对齐自检块，用于目视确认 2:1 列宽是否成立。详细选型见仓库内 docs/字体方案-中文优先与0.5窄体.md。
布局与折叠胶囊¶
紧凑布局包括加宽消息列、收紧对话间距、对齐新对话输入卡片与 /、@ 候选菜单、禁用橡皮筋滚动等。
折叠胶囊在 0.1.x 将思考块聚合为 Think ×N、工具调用聚合为 A → B → C 链路；0.2.0 起官方过程分组接管显隐，插件把摘要挂在「已完成，用时 X」行下方，点击与官方展开/收起联动，长链路按消息列宽度换行且每行保持独立胶囊轮廓。
账户用量与峰谷提醒¶
输入框下方可显示官方账户余额、本轮 token 成本与近 30 天用量图表。当最近一次请求使用的 provider 为 deepseek-official 或 deepseek-account 时，在本轮成本后显示 峰 或 谷 徽标：
- 峰：工作日（不含法定节假日）09:00–12:00、14:00–18:00（北京时间），按峰时价计费。
- 谷：其余时段（含周末与法定节假日全天），空闲价为峰时价一半。
判据来自会话日志的 request/header.config.provider，而非「能否查到余额」。节假日数据通过 host 拉取 holiday-cn 并缓存于 ~/.dsh/dsh-uxexo/calendar-<年份>.json；断网时用内置 2026 表兜底。点击徽标可查看规则、下一次切换时间与出处链接。
安装与启用¶
前置条件：已按 DSH 的 profile 机制运行（dsh web）。
dsh plugin --profile web add github:jiangnanquan/dsh-uxexo#main
dsh plugin add 会根据包内 dsh.bundle.patch 与 dsh.client 自动加入 profile 的 bundles。重启 dsh 后生效；重复执行命令幂等。升级使用：
dsh plugin --profile web update dsh-uxexo
注意：desktop profile 由 Electron 桌面版独占，dsh plugin --profile desktop … 会被拒绝；桌面安装步骤见仓库 INSTALL.md。
推荐为本机安装 更纱黑体（Sarasa Mono/Term SC 或 SuperTTC），以完整体验字体方案。
典型用法¶
- 安装并重启 DSH 后，打开 Web UI，进入 设置 → 界面增强，打开总开关。
- 在 外观 → 配色主题 选择一套主题（例如
Kanagawa Wave · 神奈川·浪），观察是否即时生效。 - 若使用浅色主题且觉得正文发灰，将 文字墨色 保持在「深墨」或改为「纯黑」对比。
- 在 字体方案 选「自动」或指定 Sarasa，查看底部对齐自检块，确认方框为矩形。
- 使用官方 API 或官方账号对话时，查看输入框下方本轮成本旁的峰/谷徽标；工作日高峰前后可点击徽标核对下一次切换时间。
- 长工具链对话中，在「已完成，用时 X」下方点击胶囊摘要，验证与官方过程分组的展开联动。
若希望由 AI 代理按文档安装，可将 README 中「交给你的 AI」段落（指向 INSTALL.md 与健康检查）粘贴给本地 agent 执行。
适用场景与注意¶
适合谁：主要在 web profile 下长期使用 DSH 对话、希望统一终端美学主题、改善中英文混排对齐、压缩思考/工具链视觉噪音，并在官方计费模式下关注峰谷时段的开发者。
安全与权限：插件以当前 dsh 进程权限 运行，会注入客户端脚本并提供宿主侧增强接口；安装前应在 GitHub 阅读源码与 MIT 许可证，并只从可信来源执行 dsh plugin add。
生态说明：DSH 奉行「一切皆插件」；skillhub.cn 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系，本文介绍的是社区插件而非官方应用商店条目。
结尾¶
dsh-uxexo 把配色、字体、布局、过程展示与用量/峰谷信息收进一页设置，改完即生效，适合把 DSH Web 当成日常工作台的用户。若插件对你有帮助，维护者在设置页顶部提供了 GitHub Star 入口。
- 目录页：https://www.skillhub.cn/plugins/jiangnanquan/dsh-uxexo
- 源码与文档：https://github.com/jiangnanquan/dsh-uxexo
