前言¶
DeepSeek Harness（DSH）的 Web 会话界面功能完备，但在视觉上偏素净，对追求阅读舒适度或信息密度的用户来说，往往需要额外的自定义。本插件通过覆盖 DSH 的设计令牌，提供柔光、纸感、紧凑三套预设，在不改动功能、不依赖网络、不读写文件的前提下，只改配色、圆角与行高。
插件定位¶
dsh-chat-beautify 是一个为 DSH Web 会话界面提供视觉美化的插件，由 vi0let-dev 维护。它不注册工具、不修改 DOM 结构、不联网、不执行动态代码，只通过修改 CSS 设计令牌来调整会话区域的观感，默认预设为「柔光」。
核心功能¶
插件提供四套状态：关、柔光、纸感、紧凑。
| 预设 | 观感 |
|---|---|
| 柔光 | 暖白底色、更大的圆角与更柔和的边界，阅读更松弛 |
| 纸感 | 低对比度、细边框、更宽行距，接近纸张 |
| 紧凑 | 更紧的行高、更小的圆角、更高的信息密度 |
| 关 | 移除根节点属性，恢复 DSH 原始外观 |
每套预设分别定义了明亮模式与深色模式两套取值，跟随 DSH 主题切换。
切换入口在输入框下方的统计条区域（conversation.composer.dock），是一组很小的按钮：关 / 柔光 / 纸感 / 紧凑。
环境要求¶
- DSH
>=0.2.1-rc.2 <0.3.0 - Node.js
^22.19.0 || >=24.0.0 - 仅适用于 Web 界面（
dsh.client.platform = "web"）
安装与启用¶
方式一：界面安装（推荐）¶
- 侧边栏 → 插件 → 添加插件
- 输入
github:vi0let-dev/dsh-chat-beautify - 按提示启用，完全退出 DSH 并重启，然后硬刷新页面（Windows/Linux
Ctrl+F5，macOSCmd+Shift+R） - 会话输入框下方的统计条出现
关 / 柔光 / 纸感 / 紧凑四个小按钮，即安装成功
方式二：命令行安装¶
# 先确认自己的 profile 名，不要照抄别人的
$env:DSH_PROFILE
dsh plugin --profile <profile> add github:vi0let-dev/dsh-chat-beautify
锁定到已发布的 tag 安装（当前为 v0.1.0）：
dsh plugin --profile <profile> add github:vi0let-dev/dsh-chat-beautify#v0.1.0
方式三：本地开发调试¶
dsh plugin --profile <profile> add "C:\path\to\dsh-chat-beautify"
本地目录是链接安装，不要移动或删除原目录，否则插件随之失效。
升级与卸载¶
- GitHub 直装会在 profile 里放一份副本，本仓库更新后需要重新执行一次
dsh plugin ... add才会生效；本地链接安装改完刷新页面即可。 - 卸载 / 恢复原始外观：在插件页停用并卸载，重启 DSH 后刷新页面。插件卸载时会移除根节点属性，样式表由 DSH 客户端模块系统回收，残留的只有 localStorage 里的一个键。
配置¶
没有 Host 配置项，cordis.patch.yml 里的 config 保持空对象。
唯一持久化的数据是浏览器里的一项：
| 键 | 值 | 说明 |
|---|---|---|
dsh-chat-beautify:preset |
off / soft / paper / compact |
当前预设，仅存在本机浏览器 localStorage |
- 默认预设是
soft（柔光）。 - 存储不可用（隐私模式、禁用 storage、配额满）时会静默回退到默认预设，不会阻断界面渲染。
- 想清空选择：在浏览器控制台执行
localStorage.removeItem('dsh-chat-beautify:preset')后刷新。
适用场景与注意¶
适合谁： 追求更舒适阅读体验、希望在不同场景下切换视觉风格的 DSH 用户。
注意： 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。本插件未做运行时验证，三种预设的实际观感需要在真实 DSH 中确认。已知限制包括：作用范围依赖两个锚点（[data-conversation-scroll] 与 [data-composer-seat]），如果未来 DSH 改名，插件会安静地不生效；只影响会话区，侧边栏、设置页、终端等区域保持原样；不改字号，插件只覆盖行高与颜色；不做动画；不做逐条消息装饰。
总结¶
dsh-chat-beautify 通过覆盖 DSH 的设计令牌，为 Web 会话界面提供柔光、纸感、紧凑三套可切换的视觉预设，兼容深浅色模式，默认为柔光。安装简单，无运行时依赖，不改动功能与数据。
- 插件目录页：https://www.skillhub.cn/plugins/vi0let-dev/dsh-chat-beautify
- GitHub 仓库：https://github.com/vi0let-dev/dsh-chat-beautify
