跳到主内容

dsh-skin

19Star7Fork5Issue0Watching

为 DSH Web 提供 7 套精选皮肤、自定义背景壁纸与奶龙桌面宠物,所有偏好保存到本地浏览器。

机审证据5/5方法论数据来源安装命令持续维护DSH 版本风险扫描
机审证据安装命令仓库已核验dsh-plugin Topic许可证READMEAI 百科
语言
JavaScript
License
MIT
分支
main
deepseek-harnessdshdsh-pluginpluginskinthemewallpaper

安装

命令web profile
$ dsh plugin --profile web add dsh-skin

在终端中运行以上命令,通过 dsh CLI 安装此插件。可在右上角切换 Profile。 第一次用 dsh?看这篇新手教程

对话式安装

帮我安装 DeepSeek Harness 插件 KinGao294/dsh-skin:先查看仓库 https://github.com/KinGao294/dsh-skin 确认安全性,然后执行安装命令并验证插件加载成功。

把这段指令粘贴给 DSH Web GUI 里的助手,由它代你完成安装与验证。

一句话定位

为 DeepSeek Harness 的 Web 界面提供「换肤」能力:内置 7 套精选配色、可上传本地图片或视频作为半透明背景,再附带一只会跟着对话状态换表情的奶龙桌面宠物。所有偏好都保存在当前浏览器,刷新后自动还原。

核心能力

  • 提供 7 套预设配色(深海蓝、石墨灰、森林绿、落日紫、午夜黑、纸感暖、樱花粉),覆盖浅色与深色两种模式
  • 允许上传本地图片(自动压缩到约 1.8MB 以下)或粘贴 http(s)/data 视频地址作为半透明背景,支持遮罩浓度、模糊强度、铺满/完整/拉伸/平铺四种显示方式
  • 提供一只可拖动、可调大小(64–180px)的奶龙桌宠,含 8 种表情;自动跟随会话状态切换(思考→干活→完成→睡觉),也可点击或打开 🎨 表情包手动指定
  • 在「设置 → 通用」新增 3 行配置:皮肤 / 壁纸 / 桌宠,与官方主题并列
  • 选择持久化到本地浏览器(localStorage),刷新和重启浏览器后自动还原

技术实现

  • 语言: JavaScript(浏览器端 CJS 风格,无构建步骤)
  • 关键依赖: @deepseek-ai/dsh-client-runtime(inject/theme/locale/slots)、@deepseek-ai/dsh-client-ui-theme(主题注册与 token 覆盖层)、@deepseek-ai/dsh-client-locale(中英文案)、react(行内渲染设置行 UI)
  • 架构模式: 双面插件,Host 半(lib/index.js)仅做 cordis patch 注册(插入 id: skin 加载项),业务全部在 Client 半(lib/client.js);通过 cordis ctx.theme.register() 注册皮肤、ctx.theme.overrideTokens() 注入半透明遮罩 token、ctx.slots.inject("settings.general.item", ...) 挂载设置行
  • 入口文件: lib/index.js(Host)/ lib/client.js(Client, 2091 行)

适用场景

DSH 用户希望把默认界面换成自己喜欢的色调、添加一张个性化背景图,或在工作台放一只陪伴型小宠物。常见于长时间使用 Web 客户端、需要定制视觉体验、又不想深入修改源码的场景。设置项均在「设置 → 通用」面板内,鼠标点选即可使用,无需命令行。

前置依赖与兼容性

依赖最低版本说明
DeepSeek Harness>=0.1.0-rc.6由 peerDependencies 中各 @deepseek-ai/dsh-client-* 包声明
@deepseek-ai/cordis^4.0.1插件运行时框架
react^18.2.0设置行渲染依赖
Node.js未声明插件运行在浏览器侧,源码未读取 engines
平台跨平台manifest platform: web,跟随 DSH Web 客户端
原生模块无纯前端实现,不依赖 node-pty、node:sqlite 等原生模块

安装方式

dsh plugin --profile web add dsh-skin

安装完成后需重启 dsh web,新插入的 patch layer 才能被加载。

配置项

本插件在「设置 → 通用」面板暴露 3 行可视化配置,不需要写代码或编辑配置文件。

配置类型说明默认值
皮肤 / Skins选择7 套预设配色(深海蓝 / 石墨灰 / 森林绿 / 落日紫 / 午夜黑 / 纸感暖 / 樱花粉),或「默认」跟随系统外观默认(跟随系统)
背景图片 / Wallpaper图片 + 网址 + 滑块 + 移除选择本地图片(自动压缩到约 1.8MB)或粘贴 http(s)/data 视频地址;可调节界面遮罩浓度、模糊强度、显示方式(铺满 / 完整显示 / 拉伸 / 平铺)未设置
奶龙桌宠 / Pet开关 + 滑块 + 按钮开关显示桌宠;滑块调整大小(64–180px);按钮重置拖动位置关闭,大小 120px

常见问题

Q: 安装后界面没有变化怎么办?

A: 插件是以 cordis patch 形式新增 loader entry,正在运行的 web 进程并不会自动加载。运行 dsh web 重启即可看到「设置 → 通用」面板下新增的皮肤、背景图片、奶龙桌宠三行。

Q: 皮肤、壁纸、宠物这些选择保存在哪里?

A: 全部存在当前浏览器域名的 localStorage 里(键名 dsh-skin:skin、dsh-skin:wallpaper 等)。这是因为 DSH 的 Host settings 接口只对官方 namespace 开放,第三方偏好落到 wire 上会返回 settings-not-exposed,所以选择本插件只跟随当前浏览器,不跨设备同步。

Q: 填入的 blob: 链接为什么无效?

A: blob: 是浏览器为当前会话临时分配的 URL,刷新页面后即失效。插件会主动拒绝 blob: 并提示用 http(s) 或 data 地址、本地图片。

Q: 能导入自己的配色吗?

A: 当前版本没有提供可视化自定义皮肤入口。7 套配色以对象字面量写在 lib/client.js 内,要新增需要修改源码、重新打包再安装。

Q: 桌宠的表情和会话状态怎么对应?

A: 桌宠通过 ctx.get("sessions").list() 每 500ms 轮询一次会话,把状态映射到表情:思考中→thinking、运行中→working、完成后→done(带星星)、空闲超过 45 秒→sleeping。点宠物或打开 🎨 表情包可手动指定一个表情,4 秒后回到自动模式。

Q: 能用在桌面端或手机 App 里吗?

A: 插件 manifest 声明 platform: web,只跟随 DSH 的 Web 客户端加载;DSH 桌面应用、原生移动端不消费此插件。

Q: 怎么卸载?

A: 在 ~/.dsh/profiles/web 内运行 dsh plugin --profile web remove dsh-skin,然后重启 dsh web。localStorage 中的偏好键不会被自动删除,下次重新安装会继续生效;如需彻底清理,可在浏览器开发者工具里删除 dsh-skin:* 键。

上手难度

入门 — 不需要修改任何源码或配置文件,在「设置 → 通用」面板用鼠标点选即可完成所有操作;安装完成后只需重启一次 Web 服务。

已知问题与限制

  • 图片被压缩到 data URL 后存进 localStorage,超过约 1.8MB 会被丢弃并提示「图片太大,存不下」(来源 lib/client.js:50, 728-730)
  • blob: 地址会在刷新后失效,已保存的 blob 壁纸下次启动会被自动清除并提示「壁纸地址已失效,已清除」(来源 lib/client.js:483, 449)
  • localStorage 配额打满时保存会失败,提示「存盘失败(空间不够或浏览器限制了)」(来源 lib/client.js:414-421)
  • 第三方 settings namespace 未被 Host 开放,皮肤/壁纸/宠物状态不能跨设备或跨浏览器同步(来源 lib/index.js:6-12、README.md:104-109)
  • 安装或更新插件后必须手动重启 dsh web,正在运行的实例不会自动加载新 bundle(来源 README.md:125-130)
  • 桌宠每 500ms 轮询一次会话状态以切换表情(来源 lib/client.js:1314)

查看使用指南 →

该插件的安装步骤、关键要点、FAQ 与兼容性说明(基于已收录字段派生)。

收录徽章

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/KinGao294/dsh-skin)

把这段 markdown 粘贴到你的 GitHub README,链接回本插件详情页。徽章只声明已被本站收录,不代表安全认证。

返回插件目录