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/dsh0.1.0-rc.7、dshmarket1.15.0、Web UI 聚合0.2.3、兼容 rc.7 的 Codex Connect 与dsh-live-stats0.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
踩坑提醒
安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。
— 来源:通用规则