dsh-better-panel

dsh-better-panel

> 给 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）用的 Codex 灵感来源的美化版模型选择器（附推理条）。

> *A beautiful Codex-style reasoning-effort slider and panel for DeepSeek Harness — continuous drag,

> per-level colors, particle effects that intensify with effort, light/dark aware.*

支持最新0107模型！只是不显示

浅色主题同样可读：[preview/value-color-light.png](preview/value-color-light.png)。

两张都是真机截图（在 DSH Desktop 里逐档截下来拼接），不是渲染稿。

目录

• [特性](#特性)
• [安装](#安装)
• [使用](#使用)
• [配置](#配置)
• [兼容性](#兼容性)
• [常见问题](#常见问题)
• [已知限制](#已知限制)
• [开发](#开发)
• [打包与发布](#打包与发布)
• [项目结构](#项目结构)
• [文档](#文档)
• [致谢与许可](#致谢与许可)

---

特性

• 一条连续的滑条，不是几个离散按钮：拖动即改档位，颜色与粒子由位置连续驱动，与模型有几档无关。
• 一档一色（适配多种数量档位）：填充层从蓝渐变到紫罗兰，右端是当前位置的颜色；官方那一行的数值文字也跟着变色

（Off 档保持官方灰）。

• 越往右越"通电"：高档位亮起紫色星云与星尘粒子，粒子数与横穿速度随位置变化。
• 接管官方模型席，不并排：输入区只有一颗 模型名 · 档位名 ⌄，点开是自建的两级面板

（provider 列表 → 模型列表 + 搜索），点模型不关面板、滑条立刻跟到新模型的档位。

• 换模型默认落在中间档：总档数为偶数时取"中间的下一个"（4 档 → 第 3 档）。
• 深浅主题自适应：面板用官方菜单那套毛玻璃材料（blur(40px) saturate(150%)）+ 半透明底 + 阴影；

星尘与旋钮是固定浅色（它们永远落在蓝紫填充层上）。

• 失败可读、fail-open：读不到目录、宿主没列 provider、加载失败 —— 面板都会写出原因原文

（含宿主逐 provider 的报错）；任何一步认不出就退回"什么都不做"，绝不把官方界面改坏。

• 零运行时依赖，离线断言 911 项。

---

安装

> 不想 clone：直接下载本仓库 [Releases](https://github.com/Bai-2008/dsh-better-panel/releases)

> 里打包好的 zip（dsh-better-panel-.zip）。

四种方式，按省事程度排序：

1. 叫DeepSeek Harness想办法安装（推荐）

DSH Desktop → 喂喂喂？帮我装个插件 → 甩个项目网址 or release里的zip包

2. 一键脚本

当你不想打开dsh时：

install.cmd                    # 装进 desktop profile
install.cmd -Profile tui       # 装进别的 profile
install.cmd -Uninstall         # 卸载

install-profile.ps1 做四件事：备份 profile 的 package.json → 加一条 link: 依赖 →

把包名追加进 dsh.profile.bundles → 在 profile 的 node_modules 下建链接（Windows 用 junction），

最后校验这三项都成立。已用假 profile 完整跑过安装与卸载，并确认卸载只删链接。

3. 命令行（只有非 desktop profile 能这么装）

dsh plugin --profile tui add link:"<插件的绝对路径>"
dsh plugin --profile tui add github:Bai-2008/dsh-better-panel

desktop 是 Electron 保留 profile，命令行会被直接拒绝：

error: profile "desktop" is managed exclusively by the Electron application

4. pnpm（自己管 profile 依赖）

profile 本身就是 pnpm 工程（~/.dsh/profiles/<名字>/ 下有 pnpm-lock.yaml），所以可以直接用 pnpm 装。

在线安装（从 GitHub 拉，装完就是完整的包，不需要构建）：

cd $env:USERPROFILE\.dsh\profiles\desktop     # tui 或别的 profile 同理
pnpm add github:Bai-2008/dsh-better-panel

实测 ~8 秒；node_modules/dsh-better-panel 里 lib/client.js、lib/client.picker.js、

cordis.patch.yml 都在（files 白名单保证了这一点），宿主拿到即可加载。

本地目录（已经 clone 过、想边改边看）：

pnpm add link:"<插件的绝对路径>"

⚠️ 两种方式 pnpm 都只写 dependencies，不会把它加进 dsh.profile.bundles —— 宿主靠那个数组