前言¶
DeepSeek Harness（DSH）的插件机制允许在 Web 端扩展前端行为。dsh-refined 是一个面向 DSH 前端的纯前端扩展，用于把 DeepSeek-Refined 的效果移植到 DSH，为 DSH 前端注入 Obsidian Border 风格的 Markdown 美化与多主题配色。
它主要解决 DSH Web 界面中的两类问题：一是整站配色统一，二是 Markdown 消息的标题、引用块、粗体、斜体、行内代码和公式等元素的视觉层次。维护者为 djh2203，许可证为 MIT。
这是什么¶
dsh-refined 是 DeepSeek-Refined 的 DeepSeek Harness 移植版。它不注入脚本，不改动 DSH 源码，属于纯前端扩展，安装后可随时卸载恢复原样。
该插件提供 5 套主题，并通过主题切换按钮让用户在 DSH 会话头部直接切换配色。对于已有 DSH Web 部署，它可以作为一个独立插件安装；对于只想临时体验的场景，也可以通过会话动态创建插件运行。
核心功能¶
5 套主题¶
支持以下主题：
Border：默认主题NordTwilightGitHubAtom One
深色模式和浅色模式自动跟随系统。
整站配色覆盖¶
插件通过 theme.overrideTokens() 覆盖 DSH 的 --dsw-alias-* CSS 变量，使整站配色统一生效。
Markdown 美化¶
插件对 DSH 前端中的 Markdown 元素做视觉增强：
- 各级标题左侧增加彩色圆角竖条
- 引用块使用
Border点阵图案背景，并附带品牌色圆角竖条 粗体斜体- 行内代码
KaTeX公式
以上元素使用独立配色。
主题切换¶
会话头部右侧会出现调色板按钮，用于一键切换主题。
主题选择保存在浏览器 localStorage 中，后端重启后仍会保持。
安装与启用¶
部署级安装¶
先确认本机可用 pnpm。dsh plugin 依赖 pnpm，如果提示找不到 pnpm，先全局安装：
npm i -g pnpm
然后安装插件并重启 DSH：
dsh plugin --profile web add github:djh2203/dsh-refined
dsh web --port 3080
安装完成后，可以在 DSH 的 Settings → 插件 页面查看部署级插件清单，并在任意会话头部右侧确认是否出现调色板按钮。
本地试装¶
如果要在本地路径试装，可以使用本地文件路径：
dsh plugin --profile web add file:/绝对路径/dsh-refined
更新¶
更新插件后需要重启 DSH：
dsh plugin --profile web update dsh-refined
dsh web --port 3080
卸载¶
卸载插件后同样需要重启 DSH：
dsh plugin --profile web remove dsh-refined
dsh web --port 3080
没有 pnpm 环境¶
如果没有 pnpm，也可以使用 install.sh 完成安装：
git clone https://github.com/djh2203/dsh-refined dsh-refined
cd dsh-refined
./install.sh web
dsh web --port 3080
动态会话体验¶
如果只是临时体验，可以复制 main.js 全文，在 DSH 中新建一个会话，把全文发送到输入框，让助手将其创建为动态 Cordis 插件并运行。
出现运行卡片后，点击「允许」授权。授权后主题即可生效，会话头部右侧会出现调色板按钮。
注意：动态插件属于会话级扩展，进程重启后会失效。重启 DSH 后如果没有效果，应改用部署级安装。
适用场景与注意¶
适合已经部署 DSH Web，并希望在不改动 DSH 源码的情况下统一前端主题和 Markdown 观感的场景。
使用前需要注意：
- 插件以当前
dsh进程权限运行。 - 安装前应检查源码与许可证。
- 动态插件为会话级，进程重启后需重装。
- 部署级插件常驻，后端重启不丢，所有会话生效。
Settings → 插件页面只显示部署级插件清单；动态粘贴版属于创建它的那个会话，只在聊天里的运行卡片可见。- 未移植原版中的以下功能：行内代码点击复制、消息宽度
75%与表格宽度70%。
package.json 中声明 dsh.bundle patch 为 ./cordis.patch.yml，client platform 为 web。
小结¶
dsh-refined 以纯前端方式给 DSH 前端增加 5 套主题和 Markdown 美化能力，适合用于统一 DSH Web 的界面观感。安装、更新和卸载都通过 dsh plugin 命令完成，动态粘贴版则适合作为临时体验方式。
GitHub：https://github.com/djh2203/dsh-refined
