前言¶

长期在 DeepSeek Harness（DSH）里写提示、跑对话，界面配色和背景往往只有宿主默认那一套；想换成自己的强调色，或在聊天区后面放渐变、图片甚至本地视频，通常要改主题源码或靠浏览器扩展，和 DSH 的插件加载方式对不上。皮肤与壁纸（dsh-plugin-skin-studio）是面向 Web profile 的界面插件：在同一套 DSH 里切换预设或自定义皮肤，给聊天区加壁纸，改动即时生效，选择落在当前浏览器本机。下面按「是什么 → 能做什么 → 怎么装 → 怎么用 → 注意点」说明。

这是什么¶

皮肤与壁纸由维护者 ghostmss86-afk 发布，仓库为 ghostmss86-afk/dsh-skin-studio，npm 包名 dsh-plugin-skin-studio，当前版本 1.0.30，许可证 MIT。在 SkillHub 等社区目录中归类为「趣味换装」。

插件不做远程上报：当前选择与选项在 localStorage 的 dsh.skin-studio.v1，自定义皮肤、图片与视频在 IndexedDB dsh-skin-studio（version 2）。清站点数据会一并清掉自定义内容。

核心功能¶

皮肤¶

1. 预设皮肤：8 套整套配色，同时覆盖浅色与深色，点选即切换。
2. 自定义皮肤：自选强调色与背景，保存后进入「我的皮肤」，最多 12 套。

配色通过 DSH 的 theme 服务注入 token，设置页带当前皮肤缩略预览。

壁纸（渐变与图片）¶

1. 渐变壁纸：内置 9 套，随浅色 / 深色主题变化。
2. 图片壁纸：本地上传或粘贴图片链接（填链接时由浏览器按 URL 加载），上限各 10000 条量级（资料写明图片最多 10000 张）。
3. 收藏与筛选：「全部 / 收藏 / 我的照片 / 渐变」四个筛选；缩略图旁星标收藏。
4. 显示选项：「柔化壁纸」0–50%（默认 12%），保证文字可读；「半透明面板」让聊天卡片与侧栏透出壁纸；设置页可实时预览当前皮肤与壁纸。

视频壁纸¶

本地视频铺满聊天区，播放器支持暂停、静音、音量、循环；进度条下方 ‹ n / N › 切换上一个 / 下一个。单条上限与图片同级（最多 10000 个）。非 AAC 音轨需本机 ffmpeg 与 ffprobe 在 PATH 中，否则画面正常、可能无声。

视频卡片展示封面、精简剧名与集号（例如长文件名 Billions.S06E01.1080p.WEBRip… 显示为 Billions.S06E01），默认按季、集升序。同一目录不少于 2 集时收成文件夹卡片（如 S06E01 – S06E12 与总集数），点卡片从第 1 集顺序播完一季，上一集 / 下一集不跑出该文件夹（导入时需拿到真实路径）。

批量导入支持多选、整目录导入、文件与文件夹拖拽；导入落真实路径并记住所属文件夹。全屏：双击页面顶部空白条或播放器控制条进入，再双击或 Esc 退出。

仅视频背景时，聊天卡片等会切到「影院色板」（深色半透明底 + 白字），避免日间模式白底深字；图片壁纸与无背景不变。

显示模式与沉浸¶

设置页「显示模式」可各录一个快捷键（须含 Ctrl / ⌘ / Alt）：一个进纯净模式（隐藏整个界面只留壁纸），一个回正常界面；首次按键锁定、再按解除。光标在输入框内时不抢画面，进入纯净模式时底部约 3.2 秒退出提示。可选「界面自动隐藏」：播视频且 23 秒无操作淡出界面（输入框聚焦时不触发），默认关闭。

F7 / F8 / F9 对应上一集、播放暂停、下一集（亦认系统媒体键）；时间显示在输入框右侧胶囊。

宿主侧能力简述¶

index.js 在宿主注册 /api/skin-studio/media/* 等路由，用于本地文件流式读取、AAC 侧车、封面与选文件等；视频壁纸经本机路由 /api/skin-studio/media 读盘，不经外网。旧宿主无法注册精确路由时会降级为纯皮肤模式。

安装与启用¶

前置条件：DeepSeek Harness 0.2.2-rc.1（README 写明在本机 macOS 验证）。视频音频兜底需要 ffmpeg 与 ffprobe。

插件市场条目已按规范提交（docs/market-entry.yml），收录审核中；上架前用下列方式安装。

从 GitHub 安装（资料原文命令）：

dsh plugin --profile web add github:ghostmss86-afk/dsh-skin-studio

安装后重启 DeepSeek Harness；升级可在同命令后加 @<commit> 或重装。

npm（发布后可用）：

dsh plugin --profile web add dsh-plugin-skin-studio

也可将包以 link 或放入 profile 的 node_modules/dsh-plugin-skin-studio 并在 package.json 的 dsh.profile.bundles 中加入 dsh-plugin-skin-studio（依赖键、bundles 与包名须一致）。具体 JSON 示例见仓库 README。

典型用法¶

1. 打开入口：左下角侧栏「皮肤与壁纸」，或 设置 → 皮肤与壁纸。
2. 换肤：点选 8 套预设之一；或在「自定义皮肤」里配色后保存（最多 12 套）。
3. 壁纸：选渐变；或上传图片 / 粘贴图片链接；点星标收藏。
4. 视频：在设置页或左下角快捷面板添加本地视频；用 ‹ n / N › 或 F7/F8/F9 控制；同一文件夹多集时从文件夹卡片一键连播。
5. 无声或加载异常：设置页「自检」行会列出原文件、音轨、画面静音、声音来源、源、网络、就绪等，可一键复制；必要时用卡片左下角重新关联原文件。控制台可运行 window.__skinStudioDiag()；近期媒体事件记在 localStorage debugLog。
6. 恢复：「恢复默认」只重置皮肤、壁纸与选项，自定义内容保留。

适用场景与注意¶

适合：希望在同一 DSH Web 环境里快速试配色、用图片或本地剧集当聊天背景、且接受数据只存在本机浏览器的用户。

权限与审核：插件以当前 DSH 进程权限读本地媒体并调用 ffmpeg；安装前应阅读仓库源码与 MIT 许可证，自行判断是否可信。DSH 社区目录（如 SkillHub）为独立站点，与 DeepSeek / 幻方无官方从属关系。

已知限制（摘自 README）：

• HEVC / H.265 在 Electron Chromium 中可能不流畅；插件可后台转 H.264 代理再播。
• E-AC-3、DTS、TrueHD 等需 ffmpeg 生成 AAC 侧车。
• macOS 上「选择视频文件 / 选择文件夹」走 osascript；其他系统用设置面板里的文件选择入口。
• 清空浏览器站点数据会删除全部自定义皮肤与壁纸。

结尾¶

dsh-skin-studio 把 DSH 界面的配色与聊天区背景收到一个插件里：预设与自定义皮肤、渐变 / 图片 / 视频壁纸、收藏与实时预览，数据不上传。需要条目说明时可见目录页 SkillHub：dsh-skin-studio；问题与版本变更见 GitHub 仓库 ghostmss86-afk/dsh-skin-studio 与 Issues。