dsh-skin-rotation

dsh-skin-rotation
DeepSeek Harness 智能皮肤轮换 —— 随机 / 顺序 / 加权 / 固定四种策略，可筛选候选池、可查轮换历史、配置写入崩溃安全。纯本地运行，不需要额外 AI API。

English | 中文

它做什么

你装了四个皮肤，四个都喜欢，但每次只用其中一个。

dsh-skin-rotation 会在每次启动 DeepSeek Harness 时按你选的轮换策略启用一个皮肤，控制项都在「设置 → 皮肤」页里：

它同时是可解释、可恢复的：哪些皮肤在候选池里、其余为什么被排除、什么时候换过什么、上一次成功的皮肤是哪一只（一键恢复）。

第 1 次启动 → 深海女仆工坊      第 2 次启动 → 虎鲸链路      第 3 次启动 → 鲸鱼娘昼夜工坊

不只是"随便抽一个"

• 真正的候选池：每个已安装皮肤都会被标为 compatible（参与）/ excluded（你排除的）/ incompatible（宿主不兼容）/ unavailable（读不到）。排除 ≠ 卸载，插件绝不碰你已安装的文件。
• 只抽宿主真能加载的皮肤：DSH 会拒绝 @deepseek-ai/dsh* peer 范围不含当前运行时的插件行（补丁写着启用、但行根本不启动），naive 的随机可能抽到"死皮肤"导致一个皮肤都没有。本插件复刻了这道准入判定，并读取 profile 的 compatibility.json 放行记录。
• 可读的轮换历史：时间、从哪只到哪只、触发原因（startup / manual / restore）、策略、结果。失败会如实记为失败，且不会进入"最近使用"集合。
• 恢复上一皮肤：一键回到最近一次成功、且当前仍在候选池里的皮肤。
• 崩溃安全的配置写入：轮换要改两层补丁文件，事务日志保证被中断的写入在下次启动时要么补完、要么回滚；对于"变了但不是它改的"文件，它拒绝覆盖并给出诊断。
• 带版本的状态文件：schemaVersion + 向前迁移，升级不丢偏好。

安装

从 GitHub 一行装：

dsh plugin --profile web add github:luoyuejun9/dsh-skin-rotation

从 npm 装：

dsh plugin --profile web add dsh-skin-rotation

或者用 最新 Release 上的预构建 tarball——不需要构建，也不会触发 allowBuilds 授权：

dsh plugin --profile web add https://github.com/luoyuejun9/dsh-skin-rotation/releases/latest/download/dsh-skin-rotation.tgz

重启一次，然后打开「设置 → 皮肤」，轮换卡片就在这个页面底部。

> 装进桌面端而不是 web profile？把 --profile web 换成 --profile desktop 即可，两边都能用。

设置卡片

设置 → 皮肤
├── 已安装皮肤                 ← 皮肤管理器自己的页面
└── 🎲 皮肤轮换                ← 本插件
├── [开关] 启动时自动轮换     轮换模式：[随机 ▾]   近期不重复：[避开最近 2 个 ▾]
├── 当前皮肤：虎鲸链路 · 候选池 2 个
├── ☑ 虎鲸链路        · 权重 [3]
├── ☐ 深海女仆工坊    （已排除）
├── ☐ 不兼容皮肤      （不兼容，已排除）
├── [立即换一个] [恢复上一皮肤] [重新读取]
├── 最近轮换
│     2026-10-11 21:04 · 启动 · 官方默认 → 虎鲸链路 · 成功
└── ▸ 高级设置   （权重说明、恢复默认配置）

在皮肤管理器里手动切换皮肤依然有效——直到下次启动，这正是这个插件的意义。

工作原理

flowchart LR
A[宿主启动] --> B{轮换开启?}
B -- 否 --> Z[保持当前皮肤]
B -- 是 --> C[发现已安装皮肤]
C --> D[排除宿主会拒绝的皮肤]
D --> E[随机抽一个，且不与上次相同]
E --> F[改写 profile patch + home patch 里的dsh-skin managed 区段]
F --> G[DSH 的 HMR 监听器重新组合插件树]
G --> H[页面打开时已经是抽中的皮肤]

• 轮换是宿主侧的决定，一次启动只做一次。 进程级 boot key 保证插件被热重载时不会重复抽签，真正重启才会重抽；浏览器刷新不会重掷骰子。
• 它改的是补丁层，不是皮肤。 插件改写的是皮肤管理器自己也在用的那段 # --- dsh-skin managed --- 互斥区段，profile patch 与优先级更高的 home patch 一起改。区段之外的一切——手写行、注释、DSH 自己追加的设置行——原样保留，写入走临时文件 + rename 的原子替换。
• 只抽宿主真能加载的皮肤。 DSH 会拒绝那些 @deepseek-ai/dsh* peer 范围不含当前运行时的插件行：补丁里写着 disabled: false，行却根本不会启动，结果是一个皮肤都没有。本插件用自己的语义化版本求值器复刻了这道准入判定，并读取 profile 的 compatibility.json 放行记录，因此随机结果不会落到死皮肤上。
• 浏览器半区只有一张卡片。 它监听 DOM，往皮肤管理器页面根节点追加一个容器，把卡片渲染进去；不注册自己的设置页、不留全局状态，卸载时清掉自己创建的 observer、定时器和样式。
• 不碰皮肤文件、skin.json，也不接管管理器自己的状态。

写入的文件

HTTP 接口：GET/POST /api/dsh/skin-rotation，仅同源，跨站请求直接拒绝。

环境要求

• DeepSeek Harness web profile，>=0.2.0-rc.2 <0.3.0-0（声明在 engines.dsh）。
• 至少装两个皮肤轮换才有意义。皮肤的判定沿用生态约定：包内带合法 skin.json（id、package、bodyAttr、wiring.id）。
• 卡片挂在皮肤管理器的皮肤页（settings.section id dsh-skins）里；没有管理器时轮换依然工作，只是改用路由开关。
• 不依赖任何 @deepseek-ai/* 运行时包：无需解析、无需构建、安装时不执行任何脚本。
• Windows 与 POSIX 都适用：写入用临时文件 + rename，恢复日志是纯 JSON。
• 已被 dsh.so 独立收录：安全审计通过（低风险），安装验证 L5（已在 dsh 0.2.0-rc.2 上实机跑通）。

开发

node --test                       # 29 个用例
npm pack --pack-destination dist  # 打包发布用的 tarball

端到端脚本是里面最有意思的一个：它不验证插件「自认为」做了什么，而是去取浏览器实际收到的 boot graph，确认里面只有一个皮肤模块。

FAQ

会和皮肤管理器打架吗？ 不会。两边用同一套规则写同一段区段；本插件只在启动时轮换，之后完全不插手。

浏览器刷新会重抽吗？ 不会——每个宿主进程只抽一次，否则每次刷新都换皮肤。

只装了一个皮肤呢？ 轮换等于不换，区段照样会被规范化。

能一直用我现在这个皮肤吗？ 关掉开关即可，启动不再改动皮肤，手动切换也不受影响。

项目边界

本插件只管在你已安装的皮肤之间轮换：候选池、策略、历史记录与配置写入的可靠性。它刻意不做皮肤的安装、下载、卸载和预览，也不取代皮肤管理器或插件市场——那些已经有成熟项目，本插件与它们并存。

路线图

• 轮换方案（Presets）已支持保存与一键切换；可视化的方案编辑器暂不在计划内。
• 状态文件里保留了随机种子（seed）字段，用于可复现的运行；暂未在 UI 暴露。
• 会话级主题（不同会话用不同皮肤）未实现：DSH 当前没有公开、稳定的会话级主题切换接口，因此它留在路线图里，而不是用不可靠的 DOM 手段假装做到。

License

MIT © luoyuejun9