前言¶

DeepSeek Harness（DSH）桌面端长期开着时，界面观感往往只能跟着宿主默认主题走；想换一套统一、可调的暗色风格，要么改宿主配置，要么自己写 CSS，维护和切换都不方便。社区里按 dsh.ecosystem.ui-skin-loader/v1 公约做的皮肤包，可以进 设置 → 皮肤 卡片墙与其它皮肤并列，一键切换。深渊 ABYSSAL（仓库 tenebris173/dsh-skin-abyssal，维护者 tenebris173）就是这一类：近黑深海底、单一生物荧光光源、只透光不加厚边的玻璃面板，并在设置里提供底色、强调色等调节项。

这是什么¶

深渊 ABYSSAL 是 DSH 的 UI 皮肤插件，不是独立应用。它通过宿主公开的皮肤加载约定登记为 skins.abyssal，装好后出现在 设置 → 皮肤 的卡片墙里。视觉定位是「深海底 + 单光源极光 + 玻璃拟态」；功能上解决的是「在 DSH 内可切换、可持久化、可还原原生观感」的整套 UI 换肤。

运行模式：有控制台托管，没控制台自立¶

皮肤控制台是可选的第三方插件，不随本包分发。两种场景行为如下：

README 说明：皮肤用运行时 ctx.inject(["uiSkinLoader"], cb) 显式等待控制台服务，而不是加载瞬间「看一眼有没有」，避免控制台晚于皮肤就绪时被误判为自立模式。

无论哪种模式，统一脚本入口为：

window.__dshSkins["skins.abyssal"]
// { mode: "console" | "standalone", skinId, version,
//   isActive(), activate(), deactivate(), getSettings(), setSettings(patch) }

核心功能与外观选项¶

设计语言（README 摘要）¶

1. 单光源 —— 整屏一组极光（左下强调色、右上靛紫、右下冷青），面板半透明透出，层级靠表面亮度而非阴影。
2. 发丝线分层 —— 1px 描边 + 3% 白表面，不加厚边。
3. 强调色纪律 —— 强调色只用于「当前 / 可点 / 运行中」；成功 / 警告 / 危险保持独立语义色。
4. 仪表感 —— 元数据等宽、数字 tabular。

可在设置里调的项¶

README 给出组合数：4 × 5 × 3 × 3 × 2 = 360 种；改档即时生效，跨重启保留（localStorage，键 dsh.skin.abyssal.preferences.v1）。

还原「原生」观感¶

设置面板 「皮肤」下拉 第一项为 原生（默认观感），选中即还原默认皮肤：

• 有控制台时：调用控制台 switchTo("default")，持久化由控制台负责；
• 自立模式：关闭自身（enabled=false），立即卸下并长期保持原生，可随时再从下拉选回本皮肤。

安装与启用¶

装完必须重启 DSH（插件包只在启动时进入启动图），随后在 设置 → 皮肤 里切换。

方式一：CLI（git 源，无需单独下 zip）¶

dsh plugin --profile desktop add https://github.com/tenebris173/dsh-skin-abyssal

方式二：Release 美化包（README 推荐给最终用户）¶

从 Releases 下载 ABYSSAL-UI-*.zip，解压后双击 安装深渊皮肤.cmd。脚本会定位本机 DSH（优先正在运行的实例），用官方途径装进 desktop profile，并把 activeSkin 切到本皮肤。

方式三：本地源码（开发，Windows 示例）¶

README 以软链方式安装，便于改代码刷新即生效；路径需按本机 DSH 安装位置调整：

$app = "$env:LOCALAPPDATA\Programs\DeepSeek Harness"
$cli = "$app\resources\app.asar\dsh\node_modules\@deepseek-ai\dsh-desktop-host\lib\cli.js"

& "$app\DeepSeek Harness.exe" $cli plugin --profile desktop add "<本仓库绝对路径>"

卸载示例：

& "$app\DeepSeek Harness.exe" $cli plugin --profile desktop remove dsh-skin-abyssal

版本与依赖（package.json）¶

• 包名 dsh-skin-abyssal，当前资料中版本 1.0.12。
• peerDependencies：@deepseek-ai/dsh 与 engines.dsh 均为 >=0.2.0-rc.2 <0.3.0-0；node 需 >=24。

从 1.0.2 及更早升级时，皮肤 id 已统一为 skins.abyssal，旧 id 不会自动继承，需按 README「从 1.0.2 及更早升级」一节重装并 patch cordis.patch.yml（或直接用美化包里的安装脚本）。

典型用法¶

1. 按上文任选一种方式安装，完全退出并重启 DSH。
2. 打开 设置 → 皮肤（有控制台时也可在 设置 → 皮肤管理 卡片墙），选择「深渊」并激活。
3. 在皮肤专属设置区（自立模式下为 设置 → 深渊）调整底色、强调色、圆角、极光、颗粒；需要默认 UI 时在 皮肤 下拉选 原生。
4. 若需在控制台或脚本里切换，可通过 window.__dshSkins["skins.abyssal"] 的 activate() / deactivate() / getSettings() / setSettings(patch) 操作。

适用场景与注意¶

适合谁：长时间使用 DSH 桌面端、偏好暗色与玻璃拟态、又希望在设置里微调而不是手改 CSS 的用户；分类上属于社区目录里的「趣味换装」类皮肤。

实现侧要点（便于评估兼容性）：皮肤通过 theme.overrideTokens() 覆盖宿主公开 token（含 --dsw-alias-* 等），激活时设置 body[data-ds-dark-theme] 以走宿主暗色分支；弹层用语义选择器做实色兜底；背景极光与颗粒画在 body 上，不新增浮层。仓库自述含 browser-smoke、对比度等测试，合计 95 项断言。

安全与权限：DSH 插件在当前 DSH 进程权限下运行。安装前应阅读仓库源码与 MIT 许可，确认来源与行为符合你的环境策略。社区插件目录（如 SkillHub）与 DeepSeek / 幻方无官方从属关系，安装命令以仓库 README 为准，不要凭插件名自行拼接未文档化的 CLI。

链接¶

• 社区目录页：https://www.skillhub.cn/plugins/tenebris173/dsh-skin-abyssal
• 源码与完整说明：https://github.com/tenebris173/dsh-skin-abyssal

深渊 ABYSSAL 把「深海底单光源 + 玻璃面板 + 360 种外观组合」收进 DSH 官方皮肤公约里：有控制台则走托管切换，没有也能自立运行；随时用 原生 回到默认观感。