dsh-rimlight

dsh plugin --profile web add dsh-rimlight

<h1 align="center">Rimlight</h1>

<p align="center"><img src="docs/icon-256.png" width="112" alt="Rimlight icon"></p>

<p align="center">为 DeepSeek Harness 提供「思考时沿窗口边缘流动的流星光带」的轻量美化插件。</p>

<p align="center">

<strong>简体中文</strong> ·

<a href="README.en.md">English</a>

</p>

<p align="center">

<a href="https://xn--de-gj5f71e.luxe">预览效果</a> ·

<a href="#安装">安装</a> ·

<a href="#设置">设置</a> ·

<a href="#许可证">许可证</a>

</p>

效果

调试台右上角可切换黑暗 / 明亮两套配色，默认黑暗。

_{截图为调试台渲染结果（复刻的客户端窗口，深色主题）。}

工作方式

会话进入思考状态后，客户端窗口的圆角边框上会出现一条流星式光带，沿边框环绕运行。同时处于思考状态的会话各自拥有一条光带，最多 4 条，按所属会话使用的模型取色，并在同一圈内等距分布。会话结束时，光带飞向与之对应的界面位置，绕行一圈后淡出。

特性

行为 · 说明

思考时流动 · 会话运行期间，光带沿窗口圆角边框顺时针环绕：头部最亮，尾部向后拖出渐变，经过圆角时随轨道弯折。

多会话并行 · 最多 4 条，每条对应一个会话。新光带加入后，所有光带在 4 秒内同步加减速，平滑收敛到等距位置。

等待回复反向 · 会话进入等待用户输入的状态时改为逆时针；用户回复后恢复顺时针，方向切换带缓动过渡。

按模型配色 · 每条光带按所属会话所用的模型取色，预设 12 套（见下表），可在插件设置中固定全局使用配色。

边缘泛光 · 在光带两侧叠加白色高光与柔光，可在插件设置中关闭。

结束回程 · 会话结束时，光带飞向对应目标并绕行一圈后淡出：当前对话 → 输入框；后台会话 → 侧边栏中对应行；该行不在可视区域 → 工作区；侧边栏折叠 → 展开按钮。

渲染隔离 · 绘制在独立覆盖层上，不修改宿主代码，不接收指针事件；DOM 与几何访问均有异常兜底，插件自身异常不会中断客户端渲染。

多条光带等距分布 · 等待回复时反向

 · 

配色

渐变方向为尾部 → 头部，下表列出各 stop 的实色（尾部起止为同色低透明度，故从首个不透明 stop 起列）：

key · 名称 · 渐变（尾 → 头） · 特征

deepseek · DeepSeek · #2f6bff → #5b8dff → #eaf2ff · —

kimi · Kimi · #8f97a8 → #e6eaf2 → #ffffff · 尾部漂浮粒子

openai · OpenAI · #6f9b8b → #cfe6dd → #f4fffa · —

claude · Claude · #e07a4f → #b64f28 → #ffeada · —

zhipu · GLM · #7285ab → #bccce8 → #f4f8ff · —

gemini · Gemini · #34a853 → #fbbc05 → #ea4335 → #ffffff · Google 四色

qwen · Qwen · #1d3fd6 → #3f6bff → #dbe6ff · —

grok · Grok · #141518 → #c9ccd4 → #ffffff · 黑→白

minimax · MiniMax · #ff5fc0 → #ff2d63 → #ffdcec · —

meta · Meta · #2f7bff → #0866ff → #e2eeff · —

nvidia · NVIDIA · #76b900 → #a4e01f → #f4ffd9 · —

unknown · Prism · 半透明白多层叠加 · 液态玻璃：色散、边缘形变

模型识别以模型 id 与名称为主、供应商为辅；无法识别时使用 Prism，可在设置中改为其它配色。

安装

要求：DeepSeek Harness。插件是标准的 DSH bundle 包（cordis.patch.yml + 客户端模块），装进任一 profile 即可。

方式一：插件页安装（推荐）

1. 获取本目录（dsh-rimlight/）。

2. 打开「插件」页，选择安装本地插件，目标指向该目录。

3. 安装成功后返回 application: applied，插件立即生效；若界面未更新，重启一次客户端。

方式二：命令行安装

dsh 是客户端自带的命令（位于 DeepSeek Harness.exe 同级的 runtime/cli/bin/dsh.cmd，安装时通常已加入 PATH；未加入时用完整路径调用）。它把参数转发给 profile 所在的 pnpm：

# 把插件目录链接进 profile（示例为 desktop，按实际 profile 名替换）
dsh plugin --profile desktop add "link:/绝对路径/dsh-rimlight"

link: 前缀表示直接链接本地目录，而不是从注册表拉取。命令执行后，客户端会把包写入 profile 的 dependencies，并按包内声明的 dsh.bundle.patch 自动并入 dsh.profile.bundles；重启客户端后插件生效。

方式三：从 npm 安装

发布到 npm 之后，标准安装命令就是包名本身：

dsh plugin --profile desktop add dsh-rimlight

pnpm 从注册表拉取预构建产物，插件没有安装期构建步骤，因此不需要 allowBuilds 授权。

方式四：从 GitHub 安装

也可以直接从远端安装：

dsh plugin --profile desktop add "github:<owner>/<repo>"

<owner>/<repo> 替换为仓库地址，例如 github:someone/dsh-rimlight；其他分支或 tag 可写成 github:<owner>/<repo>#<ref>。

卸载

dsh plugin --profile desktop remove dsh-rimlight

该命令会同时从 dependencies 与 dsh.profile.bundles 中移除条目。也可在「插件」页移除 Rimlight。

设置

位于「插件 → Rimlight → 设置」。

设置项 · 默认 · 范围 · 说明

拖尾长度 trailLength · 320 · 40–1200 · 尾部可见长度（px）

粗细 thickness · 6 · 2–24 · 光带宽度（px）

速度倍率 speed · 1.6 · 0.3–3 · 环绕一圈的快慢

扫掠幅度 sweep · 0.62 · 0–0.95 · 一圈内的速度呼吸：0 为匀速，取值越大则拐角越慢、直边越快；改动在 200 ms 内平滑生效

泛光开关 edgeGlow · 开 · — · 光带边缘的白色高光与柔光

根据对话使用模型自动选择配色 modelColor · 开 · — · 关闭后使用「全局配色」

全局配色 theme · — · 12 套 · 仅在关闭自动配色后显示

无法识别时使用的配色 unknownTheme · Prism · 12 套 · 模型名无法识别时使用

调试台

lab/rimlight-lab.html 与 lab/rimlight-lab.js 构成一个独立的交互式调试台：它直接加载本插件的 client.js，复用同一份轨道几何与动画代码，在复刻的客户端窗口中渲染效果，可实时调整参数、切换配色，并模拟多会话、等待回复、输出完成与手动中断等状态。

本地运行（自仓库根目录）：

python -m http.server 8733 --bind 127.0.0.1
# 浏览器访问 http://127.0.0.1:8733/lab/rimlight-lab.html

常用 URL 参数（用于脚本化截图或分享特定状态）：

参数 · 说明

mode=thinking \ · streaming \ · done \ · stop · 初始状态

n=1..4 · 并发光带数

trail=320 / t=6 · 拖尾长度 / 粗细

theme=kimi · 强制指定配色

multi=1 · 每条光带各自配色

reply=1 · 等待回复（反向流动）

sweep=0 · 扫掠幅度（0 为匀速）

warm=1600 · 预跑 N 毫秒，便于单帧截取指定阶段

click=reset,think&after=900 · 依次点击面板按钮后再预跑

项目结构

dsh-rimlight/
├── client.js          # 客户端半：覆盖层渲染、轨道几何、动画、设置面板、双语
├── index.js           # 宿主半：配置 schema（schemastery）
├── cordis.patch.yml   # bundle patch：将插件插入 profile
├── package.json
├── icon.svg
├── locale/
│   ├── zh.json
│   └── en.json
├── lab/               # 独立调试台
│   ├── rimlight-lab.html
│   └── rimlight-lab.js
├── docs/              # README 配图
├── screenshots.json   # 插件市场详情页截图清单
└── LICENSE

兼容性

• 运行在 DSH 的客户端渲染层，装进 profile 后随客户端加载。
• 右上角原生窗控条会遮住绘制内容，插件据此挖掉那块并留羽化；1.0.1 起改为运行时判断，没有原生窗控条时（例如普通浏览器标签页）不再挖洞。
• 依赖宿主提供的公开模块（react、@deepseek-ai/dsh-client-ui-*、@deepseek-ai/schemastery），不打包、不重分发这些模块。
• 光带绘制在独立覆盖层，不参与布局，不接收指针事件。
• 「最终输出」的判定依赖宿主界面的 DOM 结构；宿主版本升级后若内部类名变化，该判定可能失效，此时插件会退化为始终沿边框运行，不影响客户端稳定性。

许可证

本项目采用 [Mozilla Public License 2.0](LICENSE)（MPL-2.0）。