PRTS · DSH UI 皮肤

罗德岛终端风格 · 直角切角 · 黑色发丝线 · 黄黑警示条 · DIN 技术字

按 dsh.ecosystem.ui-skin-loader/v1 公约实现的 DSH 皮肤包。装好后出现在 设置 → 皮肤 的卡片墙里，与其它皮肤并列，一键切换。

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

场景	行为
装了皮肤控制台	登记托管：出现在 设置 → 皮肤管理 卡片墙里，由控制台负责互斥切换 / 持久化 / 故障隔离
没装控制台	等待 3 秒宽限后进入自立模式：自动应用外观，并在「设置 → PRTS」里给出开关与全部调节项

不会误判：皮肤用运行时提供的 ctx.inject(["uiSkinLoader"], cb) 显式等待控制台服务出现， 而不是在加载瞬间"看一眼有没有"。所以即使控制台比皮肤晚一步就绪，也仍然会正常登记（这是上一版踩过的坑）。

对控制台 / 脚本的接口

无论哪种模式，皮肤都暴露一个统一入口：

window.__dshSkins["skins.prts"]
// { 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-prts
美化包	从 Releases 下 PRTS-UI-*.zip，双击 安装PRTS皮肤.cmd
本地源码	见下方「安装 → B. 从源码装」

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

外观

项	选项	默认
外观	跟随应用 / 纸面（亮）/ 终端（暗）	跟随应用
强调色	警示黄 / 工程橙 / 信号青	警示黄
圆角	直角 0px / 工作台 6px / 圆润 12px	直角
纹理	全屏细网格 + 扫描线 + 四角登记标记	开
硬投影	浮窗错位实心影 + 按钮按压位移	开
DIN 技术字	拉丁文用 Bahnschrift（中文回落雅黑）	开

3 × 3 × 3 × 2 × 2 × 2 = 216 种组合，改档即时生效并跨重启保留 （皮肤自治：localStorage，键 dsh.skin.prts.preferences.v1）。

跟随应用：读 ctx.theme.getTheme().preference，为 system 时用 prefers-color-scheme 判定；1s 轮询 + matchMedia 监听，应用换主题时自动重算。

两套底

	纸面（Paper · 亮）	终端（Terminal · 暗）
底 / 面板 / 卡片	#f4f5f7 / #ffffff / #ffffff	#0d1012 / #121618 / #171c1f
发丝线	黑 18–60%	冷白 15–60%
实心块（徽标 / 主按钮 / DONE 章）	黑底白字	反相：冷白底深字
代码 token	#1d3f63 #7a4b12 #b5342a	#8ab7ea #e0a45c #ff9a8a
警示黄	#ffd100	#ffd100

安装

A. 用打包好的美化包（推荐给最终用户）

下载 release 里的 PRTS-UI-*.zip，解压后双击 安装PRTS皮肤.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-prts

装完必须重启 DSH（新增插件包只在启动时进启动图）。切换皮肤也可以直接在 设置 → 皮肤 里点，不必手改配置。

设计语言

1. 纸面/终端，不是"深色科幻" —— 层级只靠 1px 线与明度差，零阴影、零光晕、零圆角。
2. 切角而非圆角 —— border-radius: 0；面板头是黑底白字条 + 黄色 ▶；浮窗用错位实心影。
3. 警示黄只给四处 —— 当前 / 可点 / 运行中 / 焦点；其余全部黑白灰。
4. DIN 技术字 + 字距 —— 拉丁文 Bahnschrift 大写标签；中文雅黑托底；数字等宽。

实现要点

• 观感承载：theme.overrideTokens() 覆盖宿主公开 token —— --dsw-alias-*(107)、 --dsw-specific-*(11)、--dsw-menu-*、--dsw-linear-*、--dsw-radius-*（直角 0）、 --dsw-static-neutral(-bluish)-* 中性灰阶、--dsw-font-family / --ds-font-family-code。
• 驱动宿主亮暗开关：body[data-ds-dark-theme] 由皮肤按有效底置位 / 摘除 —— 否则 --dsw-specific-* 这类"只在 scheme 分支里有定义"的表面会落在错误的一档（实测过： 纸面模式下输入框仍是深色）。
• 浮层实色兜底：[role="dialog"] / [aria-modal] / [role="menu|listbox|tooltip"] 强制实色 + 直角（PRTS 的表面本就是实心的，弹窗天然不透出正文）。
• 装饰层：注入 7 个自有节点（网格、扫描线、左缘警示条、四角登记标记）， pointer-events:none + z-index:1（低于菜单 100 / 弹窗 1000），退出时整体移除。
• 生命周期（公约 §4.3 / R8）：activate 的每项副作用都登记 disposer，teardown 幂等； deactivate / skinCtx.signal abort / fiber 意外 dispose 三路汇合，退出后 token 与节点全部还原。
• 主题注册兜底：重复 id 时改用带序号的 id，皮肤重载后不会整次回滚成默认。
• 设置面板：经 settings.section 席位注册 React 组件，只在皮肤激活时出现。

自测

脚本	覆盖	断言
tests/browser-smoke.mjs	控制台路径：登记载荷 / 激活副作用 / 真实 CSS 层叠 / teardown	32
tests/console-wait.mjs	控制台迟到 1 秒（不许误判自立）/ 始终不出现（自立 + 能回原生）	18
tests/skin-selector.mjs	「皮肤」选择器：控制台模式走 switchTo / 自立模式走开关自己	9
tests/contrast.mjs	每个强调色 × 每种底：文字/标签对比度 ≥4.5:1，亮底派生深档	25
tests/dependency-check.mjs	宿主半依赖自检	6

合计 90 项断言。

目录

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。