前言¶
DeepSeek Harness（DSH）支持通过插件进行界面扩展。除了功能类插件，外观主题插件可以改变用户界面。dsh-pixel-skin 是一个为 DSH 设计的像素风格皮肤，灵感来自 Famicom（红白机）的硬件配色与界面设计。它通过覆盖官方语义 token 来实现视觉样式，不触碰布局与组件结构，确保对现有功能的兼容性。
核心功能¶
- 语义 Token 覆盖：仅覆盖
--dsw-alias-*/--dsw-specific-*等语义 token，不破坏 DSH 的布局逻辑与组件功能。 - 像素视觉风格：
- 使用直角、硬阴影、像素按下位移、方形滚动条和棋盘网格底。
- 可选 CRT 扫描线效果（默认关闭）。
- 像素球加载动画：替换为原创 8-bit 红白像素球（弹跳阶跃动画）。
- GBA 式对话窗：弹窗/菜单/面板使用双层像素描边，选中项黄色高亮。
- 配色与缩放：
- 浅色 / 深色两套完整配色。
- 8 套预设强调色（红 / 蓝 / 绿 / 黄 / 紫 / 橙 / 青 / 粉）+ 自定义强调色，支持 localStorage 持久化。
- 像素缩放档位：1x / 1.5x / 2x。整数倍点阵最锐利，1.5x 可能有轻微发虚。
- 状态与组件适配：
- HP 条式状态：上下文分解条改为方形血量段（系统绿 / 工具蓝 / 消息随主题色），运行中工具卡片显示斜纹扫动。
- 回合状态句：将思考中的 “Deep diving…” 替换为待机… / 正在蓄力… / 正在出招… / 正在进化…。
- 字体适配：中文与英文 UI 使用 Fusion Pixel 12px Proportional SC；代码/终端使用 Monospaced SC。正文基准约 16px，代码约 17px，防止像素字体过小。
- 桌面端适配：
- 适配 Windows 自绘标题栏，内容区圆角归零。
- 当前版本同时匹配
pI_x6G与旧版ZTP-Xa_*哈希，防止布局静默失效。
安装与启用¶
在终端中执行以下命令即可安装：
# Web 端
dsh plugin --profile web add dsh-pixel-skin
# 桌面端
dsh plugin --profile desktop add dsh-pixel-skin
安装完成后重启 DSH 应用即可生效。
典型用法¶
插件提供控制台 API 与设置界面两种配置方式。
控制台 API 示例：
// 切换主题色
__PIXELSKIN__.palette('red')
// 切换强调色（2.2.0 新增）
__PIXELSKIN__.accent('#8b5cd6')
// 切换缩放档位（2.2.0 新增）
__PIXELSKIN__.scale('2')
// 查看可选状态句
__PIXELSKIN__.statuses() // ['idle','charge','move','evolve']
// 设置状态句
__PIXELSKIN__.status('idle')
// 开关扫描线
__PIXELSKIN__.scanlines(true)
// 开关插件
__PIXELSKIN__.off()
设置界面：
在 Settings → Pixel skin 分区中，可以直接切换配色、缩放档位，或使用取色器设置自定义强调色。
LocalStorage 键值：
* pixel-skin:enabled：控制整体开关。
* pixel-skin:scanlines：控制扫描线。
* pixel-skin:accent：自定义强调色（2.2.0 新增）。
* pixel-skin:scale：像素缩放档位（2.2.0 新增）。
注意事项¶
- 字体加载：插件依赖远程字体资源兜底（指向本仓库 origin 的固定 commit）。若远程链接不可达，会自动回退到系统中文字体，不影响功能。
- 主题共存：与其他主题插件共存时，本插件默认最后加载，优先级最高。
- 桌面端哈希：桌面端样式匹配依赖官方布局类名哈希。当前已同步支持
pI_x6G与旧版哈希，若 DSH 官方再次修改哈希，可能需要手动更新插件源码中的哈希匹配逻辑。 - 图标限制：侧栏/工具栏图标基于 @iconify，本插件仅修改颜色，不改变图标形状。
- 版本兼容：插件已适配 DSH 0.1.7-rc.2。DSH 仍在开发者预览阶段，若官方 token 集变动，需在
lib/client.js的TOKENS中重新对齐。
