dsh-liang-skin

One-Line Description

Provides a custom skin called "Sliding Ancestor" for the DeepSeek Harness Web client, replacing the segmented model reasoning level buttons with a continuous slider that, when dragged, links character illustrations, background videos, and interface colors based on intensity levels 0–30.

Core Features

• Injects a continuous slider on the right side of the model input box, with positions directly reading the current model's official reasoning.efforts, where any N positions are evenly distributed on the 0–30 intensity axis
• During dragging, only performs local visual preview; when released, keyboard operation completed, or focus lost, it snaps to the nearest position and submits that position's original ID via official ModelDirectory.select
• Synchronously switches character illustrations, background videos, and interface colors based on intensity (segments 0–23 retain Harness's native light shell, segment 24 and above switches to charcoal gray + antique gold dark shell)
• Provides 24 reviewed character anchor points and an 8-second interpolated video as visual assets, no additional downloads needed
• Adds "Sliding Ancestor" option in "Settings → General Settings → Appearance Skin", alongside Light / Dark / System options, with toggle state saved in browser local storage
• Additionally provides a sub-toggle for "whether slider links thinking level"; when disabled, slider only controls skin progress and no longer modifies model reasoning level

Technical Implementation

• Languages: Server-side Node.js ESM (src/index.js) + Client-side TypeScript / React (src/client/index.tsx), CSS using modular style files
• Key Dependencies: @deepseek-ai/dsh-client-runtime/client (injects host runtime), @deepseek-ai/dsh-client-ui-conversation, @deepseek-ai/dsh-client-ui-theme (skin and theme bridging), @deepseek-ai/dsh-client-locale (i18n registration); client bundled as IIFE compatible format via esbuild
• Architecture Pattern: Dual-end plugin. Server-side follows Cordis plugin model (inject = ["webServer"]), uses ctx.webServer.register to mount 27 assets under assets/ as HTTP exact routes with Range request support; client-side follows DSH client injection model (inject = ["slots","Sessions","modelDirectories","locale","theme"]), registers slider component via slots.inject("conversation.input.right") and extends native appearance selection row via MutationObserver
• Entry Files: src/index.js (server-side Cordis plugin) + src/client/index.tsx (client-side React component + injection logic), built by scripts/build-client.mjs using esbuild to output lib/client.js

Use Cases

Players and creators who want to replace the scattered buttons for model reasoning level switching in the DSH Web client with a "drag-to-end" style slider, and want the slider to link to a set of stylized visual effects; if you only want to change the skin without caring about the slider itself, you can also use its color scheme and character backgrounds independently.

Prerequisites & Compatibility

Installation

dsh plugin --profile web add github:kingOfSoySauce/dsh-liang-skin

Configuration

This plugin requires no additional configuration. You can toggle the following preferences in "Settings → General Settings → Appearance Skin" (saved in browser localStorage):

FAQ

Q: What does this plugin do?

A: It applies a "Sliding Ancestor" appearance skin to the DSH Web client and replaces the model reasoning level selector from segmented buttons to a continuous slider. When sliding, character illustrations, background videos, and interface colors change together; the selected position is only submitted when released.

Q: Do I need additional configuration after installation?

A: No. All assets and the slider are built into the plugin package; after installation, you'll see the new option in "Appearance Skin"; preferences are saved in browser local storage, no changes to model configuration or disk.

Q: Will the slider show for models that don't support reasoning or only have one level?

A: No. The client logic checks whether the current model has reasoning levels; if there are fewer than two levels or unrecognized, the slider simply won't render, and the skin background layer continues to work based on the current selection.

Q: Will the slider show for sessions addressed by subagent?

A: No. The code specifically checks subagentAddress; subagent sessions that are addressed will neither show nor submit slider changes, avoiding interference with the parent session's state.

Q: Do I need to restart the browser or refresh after installation?

A: No refresh needed; after restarting the DSH Web process, the browser automatically loads the new client plugin; the current session is interrupted, but DSH has disk persistence and can continue after restart.

Q: Will slider misoperations pollute my conversation?

A: During dragging, only local visual preview is updated, no position is submitted; only when released, keyboard confirmed, or focus lost will it snap and trigger a model reasoning level switch. Pressing Esc rolls back to the pre-drag position.

Q: Will it crash if video or images fail to load?

A: No. The client has three layers of fallback: character frame failure falls back to background video, video failure falls back to poster image, poster failure falls back to pure color mode; skin state is always preserved.

Q: How to completely disable the skin?

A: In "Settings → General Settings → Appearance Skin", select any of "Native", "Light", "Dark", or "System"; the skin layer, slider, and custom color variables will all be removed; to completely remove the plugin, run dsh plugin --profile web remove dsh-client-liang-intensity-skin.

Difficulty Level

Beginner — Plug and play, all visual assets built-in, preference toggles in native settings, no documentation reading or config writing needed.

Known Issues & Limitations

• Client relies on MutationObserver to match DSH native appearance selection row CSS class names ([class*="_8HJdBW_group"] / [class*="_8HJdBW_cubeRow"] / [class*="_8HJdBW_themeCube"]); if DSH upstream refactors appearance component class hashes, the "Sliding Ancestor" button may no longer be injected into the native appearance row; preferences as separate toggle items are not affected
• 24 character anchor points cover intensity points 0, 1, 3, 4, 6, 7, 9, 10, 12, 13, 14, 15, 16, 17, 18, 19, 21, 22, 24, 25, 27, 28, 29, 30 — middle positions switch via nearest-neighbor snapping, no image crossfading
• Installation depends on pnpm in PATH; pnpm ≥ 10 does not execute third-party dependency prepare scripts by default, this plugin has no prepare script, so normally won't trigger; if installation fails with prompts, follow DSH output to add corresponding key in ~/.dsh/profiles/web/pnpm-workspace.yaml's allowBuilds and retry
• Installation / uninstallation modifies ~/.dsh/profiles/web/package.json's dsh.profile.bundles, but remove is "detach + restart", does not automatically roll back local preferences already written to disk; preferences exist only in browser localStorage

方式一：原版安装

复制给你的 DSH，一键安装：

帮我安装这个仓库的皮肤到我的 DSH，地址：https://github.com/kingOfSoySauce/dsh-liang-skin

方式二：插件市场一键安装（推荐）

打开 DSH 的「设置 → 皮肤市场」，搜索“滑动变祖”，点击“一键安装”，按提示重启 DSH Web 即可。尚未安装皮肤市场？请先按安装说明完成安装。

更多 DSH 皮肤

想发现更多社区皮肤，欢迎前往 DSH 皮肤市场浏览和一键安装。

安装皮肤市场或提交皮肤

效果展示

把 Harness 的推理等级改为紧凑滑块，并用滑动变祖原项目的 0–30 强度映射同步人物、背景与界面配色。

交互规则

• 档位直接读取当前模型的 reasoning.efforts，不写死数量或名称。
• 任意 N 个档位均匀落在 0–30：两档为 0 / 30，三档为 0 / 15 / 30，五档为 0 / 7.5 / 15 / 22.5 / 30。
• 拖动期间只做连续视觉预览；指针松开、键盘操作完成或控件失焦时，才吸附到最近档位并通过官方 ModelDirectory 提交该档位原始 ID。
• 不支持推理或只有一个可选档位的模型不显示滑块。
• addressed subagent 不显示也不提交滑块。

外观开关

入口位于 设置 → 通用设置 → 外观皮肤：

• 滑动变祖：显示滑块并启用人物、背景和自适应配色。
• 原生：移除背景层、皮肤变量和滑块，恢复 Harness 原生界面。

选择保存在当前浏览器本地，不会改动模型配置。

安装

需要先安装 DeepSeek Harness CLI；当前版本已在 0.1.0-rc.6 上验证。安装本身可以在 DSH 运行时执行（只改动磁盘配置），重启后生效。三种方式任选其一：

方式一：从 GitHub 安装（固定 release tag）

dsh plugin --profile web add 'github:kingOfSoySauce/dsh-liang-skin#v0.1.4'
dsh --profile web --dump-config | grep -B1 -A2 liang-intensity

版本号固定为已验证的 release tag，之后推送到 main 的改动不会静默改变已安装代码。

方式二：从 GitHub Release tarball 安装

从本仓库 Releases 页面下载 dsh-client-liang-intensity-skin-0.1.4.tgz（包内已包含构建好的 lib/client.js，安装时不需要执行任何 prepare 脚本），然后：

dsh plugin --profile web add ./dsh-client-liang-intensity-skin-0.1.4.tgz

适合不方便走 git 的环境；相对路径按你运行命令的目录解析。

方式三：克隆后从本地路径安装（开发迭代）

git clone https://github.com/kingOfSoySauce/dsh-liang-skin.git
cd dsh-liang-skin
dsh plugin --profile web add .

dsh plugin 会把相对路径锚定到你运行命令的目录（而不是 profile 目录），所以在克隆目录里执行 add . 装的是指向克隆目录的 link 依赖：改完源码运行 npm run build，重启 DSH 即生效，无需重新安装。

验证与重启

安装成功后 dsh plugin 会自动把插件注册进 profile 的 dsh.profile.bundles（见 ~/.dsh/profiles/web/package.json），无需手动改配置；--dump-config 的输出中应出现 dsh-client-liang-intensity-skin 配置层（上面命令里的 grep 就是为此准备的）。

如果正式 DSH 正在运行，让执行安装的 agent 给用户两个选择：

• a. agent 自行重启：agent 终止旧进程后重新运行 dsh web；
• b. 用户手动重启（推荐）：在运行 DSH 的终端按 Ctrl+C，再运行 dsh web。

重启后浏览器会自动加载新的客户端插件，无需强制刷新。当前会话会中断，但 DSH 会话有磁盘持久化，重启后可以恢复。

卸载

dsh plugin --profile web remove dsh-client-liang-intensity-skin

remove 会自动把插件从 dsh.profile.bundles 中摘除；重启后设置入口完全移除。

常见问题

• pnpm 阻止构建脚本：pnpm ≥ 10 默认不执行第三方依赖的 build/prepare 脚本。当前皮肤没有 prepare 脚本，正常不会触发；若 pnpm 安装失败并给出提示，按 dsh 打印的说明在 ~/.dsh/profiles/web/pnpm-workspace.yaml 的 allowBuilds 下加入对应 key 后重试。
• 网络：方式一需要能访问 github.com（pnpm 经 codeload 拉取）；方式二只需能下载 GitHub Release 附件。
• pnpm 缺失：dsh plugin 依赖 PATH 里的 pnpm，缺失时会明确提示。
• 端口占用：dsh web 默认监听 3080（可用 --port 修改），重启前确认旧进程已退出。

本地开发

npm install
npm test
npm run build

修改 client 源码后需要运行 npm run build，并一起提交更新后的 lib/client.js 和 source map。

灵感与素材来源

本插件的“滑动变祖”视觉概念、人物图片与插帧视频素材源自 Lichtspektrum/liang-intensity-calibrator。插件在原项目 0–30 强度轴的基础上，将视觉变化接入 DeepSeek Harness 的推理等级选择。

运行时素材已包含在插件中，安装后不需要额外下载。当前接入 24 张经过审核的人像锚点，滑动时直接切换最近锚点，不做图片交叉渐变。