深渊 ABYSSAL · DSH UI 皮肤
近黑深海底 · 单一生物荧光光源 · 只透光不加厚边的玻璃
按 dsh.ecosystem.ui-skin-loader/v1 公约实现的 DSH 皮肤包。装好后出现在
设置 → 皮肤 的卡片墙里，与其它皮肤并列，一键切换。
外观矩阵
运行模式：有控制台托管，没控制台自立
| 场景 | 行为 |
|---|
| 装了皮肤控制台 | 登记托管：出现在 设置 → 皮肤管理 卡片墙里，由控制台负责互斥切换 / 持久化 / 故障隔离 |
| 没装控制台 | 等待 3 秒宽限后进入自立模式：自动应用外观，并在「设置 → 深渊」里给出开关与全部调节项 |
不会误判：皮肤用运行时提供的 ctx.inject(["uiSkinLoader"], cb) 显式等待控制台服务出现，
而不是在加载瞬间"看一眼有没有"。所以即使控制台比皮肤晚一步就绪，也仍然会正常登记（这是上一版踩过的坑）。
对控制台 / 脚本的接口
无论哪种模式，皮肤都暴露一个统一入口：
window.__dshSkins["skins.abyssal"]
// { mode: "console" | "standalone", skinId, version,
// isActive(), activate(), deactivate(), getSettings(), setSettings(patch) }
「原生」选项
设置面板里的 「皮肤」下拉 第一项是 原生（默认观感） —— 选中即还原默认皮肤：
- 有控制台时：调用控制台的
switchTo("default")（与控制台自己的"还原默认观感"同一路径），持久化归控制台；
- 自立模式时：直接关掉自己（
enabled=false），立即卸下并长期保持原生，随时可再从下拉里选回本皮肤。
控制台是可选的第三方插件，不随本包分发。
这是一个 DSH 插件
本仓库是 DeepSeek Harness 的插件（皮肤类）。
按官方 README「Community and support」一节的要求，仓库已打上
dsh-plugin topic，便于在
github.com/topics/dsh-plugin 被发现；
package.json 的 keywords 与 dsh.skin.tags 里同样带 dsh-plugin。
三种安装方式，任选其一：
| 方式 | 命令 / 操作 |
|---|
| git（无需下载包） | dsh plugin --profile desktop add https://github.com/tenebris173/dsh-skin-abyssal |
| 美化包 | 从 Releases 下 ABYSSAL-UI-*.zip，双击 安装深渊皮肤.cmd |
| 本地源码 | 见下方「安装 → B. 从源码装」 |
装完必须重启 DSH（插件包只在启动时进启动图），随后在 设置 → 皮肤 里一键切换。
外观
| 项 | 选项 | 默认 |
|---|
| 底色 | 深海 / 午夜 / 墨黑 / 极地 | 深海 |
| 强调色 | 薄荷绿 / 冷青 / 靛紫 / 琥珀 / 珊瑚 | 薄荷绿 |
| 圆角密度 | 柔（14px）/ 均衡（原生）/ 紧（9px） | 柔 |
| 背景极光 | 强 / 柔 / 关 | 柔 |
| 胶片颗粒 | 开 / 关 | 开 |
4 × 5 × 3 × 3 × 2 = 360 种组合，改档即时生效并跨重启保留
（皮肤自治：localStorage，键 dsh.skin.abyssal.preferences.v1）。
安装
A. 用打包好的美化包（推荐给最终用户）
下载 release 里的 ABYSSAL-UI-*.zip，解压后双击 安装深渊皮肤.cmd。脚本会找到本机 DSH
（优先用你正在运行的那个），用官方途径装进 desktop profile，并把 activeSkin 切到本皮肤。
B. 从源码装（开发）
# 应用目录（默认装在当前用户的 LocalAppData 下；装在 Program Files 时改成对应路径）
$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
装完必须重启 DSH（新增插件包只在启动时进启动图）。切换皮肤也可以直接在
设置 → 皮肤 里点，不必手改配置。
C. 从 1.0.2 及更早升级
1.0.3 换了命名空间：皮肤 id 统一为 skins.abyssal，包名统一为 dsh-skin-abyssal
（旧值带个人标识，见 1.0.2 的 package.json）。旧 id 不会自动继承，需重装一次：
# 1) 完全退出 DSH —— 运行中 pnpm 会报 ERR_PNPM_EPERM（node_modules 被占用）
# 2) 查出旧包名并卸掉（这里不重复写出旧值）
& "$app\DeepSeek Harness.exe" $cli plugin --profile desktop list | Select-String 'skin-abyssal'
& "$app\DeepSeek Harness.exe" $cli plugin --profile desktop remove <上面查到的旧包名>
# 3) 装新包
& "$app\DeepSeek Harness.exe" $cli plugin --profile desktop add "<本仓库绝对路径>"
# 4) 把 profile patch 里任何 *.skin.abyssal 形式的旧 id 换成新 id（改前先备份）
$patch = "$env:USERPROFILE\.dsh\profiles\desktop\cordis.patch.yml"
Copy-Item $patch "$patch.bak"
(Get-Content $patch -Raw) -replace '[\w.-]+\.skin\.abyssal', 'skins.abyssal' |
Set-Content $patch -Encoding UTF8 -NoNewline
也可以直接双击美化包里的 安装深渊皮肤.cmd —— 它会把新包装上并把 activeSkin 切过来。
设计语言
- 单光源 —— 整屏只有一组极光（左下强调色、右上靛紫、右下冷青），面板用半透明表面透出它，
层级靠表面亮度而非阴影。
- 发丝线分层 ——
rgba(158,196,255,.10) 1px 描边 + 3% 白表面；永不加厚边。
- 强调色纪律 —— 强调色只给「当前 / 可点 / 运行中」；成功 / 警告 / 危险保持独立语义色。
- 仪表感 —— 元数据用等宽字体，数字 tabular。
实现要点
- 观感承载：
theme.overrideTokens() 覆盖宿主公开 token ——
--dsw-alias-*(107)、--dsw-specific-*(11)、--dsw-menu-*、--dsw-linear-*、
--dsw-radius-*、--dsw-static-neutral(-bluish)-* 中性灰阶。覆盖一律带 !important
（宿主有内联 token）。
- 驱动宿主的亮暗开关：宿主的亮暗分支是
body[data-ds-dark-theme]，而
--dsw-specific-input-major 这类表面 token 只在暗色分支里有定义。皮肤是纯暗色，
所以激活时置位该属性、退出时还原 —— 否则未覆盖的表面会落进 light 分支。
- 浮层实色兜底：
[role="dialog"] / [aria-modal] / [role="menu|listbox|tooltip"]
强制实色 + 直角，保证弹窗永远不透出正文（用标准语义属性，不碰宿主私有类名）。
- 背景：极光与颗粒画在
body 背景上（多层 radial-gradient + 内联 SVG 噪声），
不新增浮层，因此没有 z-index / 层叠上下文风险。
- 自有节点：只有一个
<style data-skn-abyssal-style> 与 body[data-skn-abyssal] 标记。
- 生命周期（公约 §4.3 / R8）：activate 的每项副作用都登记 disposer，teardown 幂等；
deactivate / skinCtx.signal abort / fiber 意外 dispose 三路汇合，退出后 token 与节点全部还原。
- 设置面板：经
settings.section 席位注册 React 组件，只在皮肤激活时出现。
自测
| 脚本 | 覆盖 | 断言 |
|---|
tests/browser-smoke.mjs | 控制台路径：登记载荷 / 激活副作用 / 真实 CSS 层叠 / teardown | 31 |
tests/console-wait.mjs | 控制台迟到 1 秒（不许误判自立）/ 始终不出现（自立 + 能回原生） | 18 |
tests/skin-selector.mjs | 「皮肤」选择器：控制台模式走 switchTo / 自立模式走开关自己 | 9 |
tests/contrast.mjs | 每个强调色 × 每种底：文字/标签对比度 ≥4.5:1，亮底派生深档 | 31 |
tests/dependency-check.mjs | 宿主半依赖自检 | 6 |
合计 95 项断言。
目录
lib/index.js 宿主半（空 apply：观感全在 client 半）
lib/client.js 皮肤本体（登记 / token 表 / 外观面板 / 生命周期）
cordis.patch.yml bundle patch（row id = 设置命名空间）
install/ 一键安装 / 卸载脚本（美化包同款）
preview/ 外观矩阵图 + 卡片预览 SVG
tests/browser-smoke.mjs
更新记录
见 CHANGELOG.md。
许可
MIT。
