dsh-refined

dsh-refined

DeepSeek-Refined 的 DeepSeek Harness 移植版

为 DeepSeek Harness（DSH）前端注入 Obsidian Border 风格的 Markdown 美化与多主题配色。

原版是一个 Tampermonkey 用户脚本（见 DeepSeek-Refined），作用于网页版 DeepSeek Chat。本仓库把它移植到 DSH，提供两种安装形态：

形态	持久性	适用场景
部署级插件（bundle 包，推荐）	常驻，后端重启不丢，所有会话生效，一条命令安装	自己/团队的部署
动态插件（main.js 粘贴版）	会话级，进程重启后需重装	快速体验、无法改部署的场合

不注入脚本、不改动 DSH 源码，纯前端扩展，随时可卸载恢复原样。

功能

功能	说明
5 套主题	Border（默认）/ Nord / Twilight / GitHub / Atom One，深色/浅色自动跟随系统
设计令牌覆盖	通过 theme.overrideTokens() 覆盖 DSH 的 --dsw-alias-* CSS 变量（与网页版同一套变量名），整站配色统一生效
Markdown 美化	各级标题左侧彩色圆角竖条；引用块 Border 点阵图案背景 + 品牌色圆角竖条；粗体/斜体/行内代码/KaTeX 公式独立配色
主题切换	会话头部右侧调色板按钮，一键切换；选择存在浏览器 localStorage（后端重启也保持）

安装方法

方式一：一条命令（推荐，部署级）

npm i -g pnpm                                  # 一次性：dsh plugin 是 pnpm 转发器
dsh plugin --profile web add github:djh2203/dsh-refined
dsh web --port 3080                            # 重启 DSH

无需改任何配置：本包声明了 dsh.bundle，dsh plugin add 安装后会自动把 dsh-refined 加入 profile 的 dsh.profile.bundles，重启即生效。

• 发布前/本地试装：把 github 地址换成本地路径 → dsh plugin --profile web add file:/绝对路径/dsh-refined
• profile 名：web 换成你自己的（dsh --profile ... 用的那个）
• 验证：Settings → 插件 出现 dsh-refined；任意会话头部右侧出现调色板按钮
• 更新：dsh plugin --profile web update dsh-refined → 重启
• 卸载：dsh plugin --profile web remove dsh-refined → 重启

方式二：install.sh（没有 pnpm 的环境）

git clone  dsh-refined
cd dsh-refined
./install.sh web                  # web 换成 profile 名
dsh web --port 3080               # 重启

脚本把包链接进 ~/.dsh/profiles/web/node_modules/，并在 cordis.patch.yml 追加条目（幂等，可重复执行）。卸载：删除条目与链接后重启。

方式三：动态粘贴（临时体验）

1. 打开 main.js，全选复制全文（GitHub 仓库页点 Raw 再复制更干净）
2. 打开你的 DSH Web，新建一个会话
3. 把全文粘贴到输入框发送，附上一句话：

   请把上面的内容创建为动态 Cordis 插件并运行：HOST 段 → code.host，CLIENT 段 → code.client

4. 助手定义并运行插件后，聊天里会出现运行卡片，点「允许」授权
5. 主题立即生效：会话头部右侧出现调色板按钮，可切换 5 套主题

常见疑问

• Settings → 插件 页面里没有它？ 正常——那是部署级插件的清单。动态粘贴版属于创建它的那个会话，只在聊天里的运行卡片可见。
• 重启 DSH 后没效果了？ 动态粘贴版是会话级临时扩展，重启即失，请改用方式一部署级安装。
• dsh plugin 报 pnpm 找不到？ 先 npm i -g pnpm（方式一第一步）。

与原版的差异

• 选择器适配：DSH 的 Markdown 容器是 CSS Modules 哈希类名（如 _markdown_1nba0_5），使用 [class*="_markdown_"] 前缀匹配，避免依赖具体哈希值
• 深色模式钩子相同：DSH 与网页版一样使用 body[data-ds-dark-theme]
• 持久化：原版用 localStorage；部署版同样用 localStorage（后端重启保持）
• 未移植：行内代码点击复制、消息宽度 75% 与表格宽度 70%（DSH 布局为固定列宽 + 表格自适应滚动，强行收窄会破坏版面）

自定义

所有配色集中在 lib/client.js（部署版）与 main.js（动态版）顶部的 THEMES 对象中，两处保持一致即可。字段含义：strong = 粗体、em = 斜体、math = 公式、heading = 标题竖条颜色数组 [h1..h6]、blockquoteDot = 引用块点阵颜色等。新增主题：复制任意一个主题对象改名即可，切换菜单会自动出现。