跳到主内容

dsh-skins 使用指南

一个 npm 包内置 11 款 DSH Web 主题皮肤与皮肤中心卡片,支持一键试穿与切换,全程无需重启服务。

本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。

快速上手

deepseek-harness-desktop

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @linxin666/dsh-skins

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • 可靠 Windows 启动:移除 PowerShell 5.1 -WindowStyle Hidden 与 Electron Node 模式的冲突,隐藏窗口仍由 spawn 的 windowsHide 处理;空旧补丁、状态订阅竞态和 IPC 错误不会再把启动页永久留在 8%。
  • 验证过的 Runtime 组合:内置 @deepseek-ai/dsh 0.1.0-rc.7、dshmarket 1.15.0、Web UI 聚合 0.2.3、兼容 rc.7 的 Codex Connect 与 dsh-live-stats 0.1.20,Stable 继续精确锁定而非追随 latest。
  • 托盘与后台自动化需显式选择:默认关闭仍会退出。选择“最小化到托盘并启用后台自动化”后,关闭主窗口才保留 Runtime 和到期任务;显式退出、更新、安全模式和崩溃路径一律完整停止。
  • Host 持久任务调度:Task Board 保存时区、cron 槽位、租约、misfire/running 策略和确定性运行键;启用后台自动化时通过真实 DSH Session 执行并回写 Task Run,Host 不可用时仍回退浏览器调度。
  • 可审计的扩展边界:扩展坞校验 dsh.compatibility 的版本、Desktop API、能力、Surface 与运行时证据,并在 profile 写入 desktop-plugins.lock.json。browser-safe SDK 不导入 Electron 或私有 DSH 模块;预览的外部打开仅传工作区根和相对路径,Host 验证后才交给系统。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

切换皮肤后需要重启 dsh web 服务吗?

不需要。点击「应用」后皮肤中心会写 patch 文件,宿主配置监听器在几秒内热加载,浏览器自动刷新就能看到新皮肤。

能不能同时启用两款皮肤?

不能。皮肤启用是互斥的,皮肤中心通过 ~/.dsh/profiles/<profile>/cordis.patch.yml 的 dsh-skin managed 区段强制只有一个激活,其它皮肤被标 disabled: true。

切换皮肤会不会影响模型请求或对话内容?

不会。皮肤只改浏览器 DOM(CSS、标题、状态栏、背景图等),不拦截、不修改任何发送给模型的请求。

装完之后皮肤列表是空的,或者少了几款怎么办?

检查当前 profile 下的 skins 目录:皮肤中心会扫描 packages/skins/<id> 或 node_modules/@linxin666/dsh-skins/skins/<id>,每个皮肤目录里必须同时有 skin.json 和 lib/client.js,缺一会被跳过。

Windows 上切换时报符号链接权限不足怎么办?

切换逻辑在符号链接失败时会自动回退到目录联结(junction),不需要开发者模式;如果还是失败,请用管理员身份运行 dsh,或把皮肤包手动放到 profile 的 node_modules 下。

怎么加一款自己的皮肤?

在 packages/skins/<your-id>/ 下放 skin.json(含 id、name、tagline、bodyAttr、wiring.id 等字段)和构建后的 lib/client.js / lib/index.js,然后跑 pnpm --filter @linxin666/dsh-skins build,重装聚合包即可在皮肤中心看到。

怎么卸掉某款皮肤换回官方默认?

皮肤中心卡片里有「官方默认」入口,点击即可一键应用;想完全卸载插件则用 dsh plugin --profile web remove @linxin666/dsh-skins。

背景遮挡滑块对所有皮肤都有效吗?

仅对带背景图的皮肤生效(目前是 blue-fantasy 和 whale-song),官方默认和其它纯色调皮肤的背景透明滑块不会改变外观。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 0.1.0-rc.7+
  • Node: >=22.19.0
  • Platforms: Web

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则