dsh-pixel-skin · 红白机像素风皮肤

English README

给 DeepSeek Harness 换上红白机（Famicom）风格：米白机壳、卡带红、炭黑文字、墨蓝代码区、复古黄色交互态和掌机绿色成功态。Web（浏览器）与桌面端（Electron）均已适配。

特性

• 通过官方 ThemeService 覆盖浅色/深色语义 token，不修改 DSH 主仓库
• 中文与英文 UI 使用 Fusion Pixel 12px Proportional SC
• 代码与终端使用 Fusion Pixel 12px Monospaced SC
• 正文基准约 16px，代码与数字约 17px
• 直角、硬阴影、像素按下位移、方形滚动条和网格背景
• 墨蓝色代码/终端区域，黄色进行中和提示状态，绿色成功状态
• 可选 CRT 扫描线，默认关闭
• 与官方浅色、深色、跟随系统模式兼容
• 与其他主题插件共存时，本插件作为最后加载层优先覆盖冲突 token
• 八套可切换强调色 + 自定义色：红 / 蓝 / 绿 / 黄 / 紫 / 橙 / 青 / 粉，在「设置 → 像素皮肤」分区一键切换，或用取色器设自定义强调色，localStorage 持久化
• 像素缩放档位：1x / 1.5x / 2x，在设置分区切换，整数倍点阵最锐利
• HP 条式状态：上下文分解条改为方形血量段（系统绿 / 工具蓝 / 消息随主题色），运行中的工具卡片显示「战斗中」斜纹扫动
• GBA 式对话窗：弹窗 / 菜单 / 面板使用双层像素描边，选中项黄色高亮
• 像素球加载动画：圆形 spinner 替换为原创 8-bit 红白像素球（弹跳阶跃动画）
• 回合状态句：思考中的「Deep diving...」可独立替换为 待机… / 正在蓄力… / 正在出招… / 正在进化…（「像素皮肤」设置分区或控制台切换）
• 桌面端适配（2.1.0 新增，2.1.1 修订）：
  • Windows 自绘标题栏（Electron html[data-windows-titlebar]）：拖拽带铺米色侧栏底 + 2px 墨线，内容区 16px 圆角归零为像素直角；桌面 preload 注入的顶栏自动继承像素字体
  • 对 DSH 0.1.7 仅暴露 14 个主题 token 的现实对齐：所有旧 token 引用均带真实 token / 字面量兜底，桌面端不再出现「变透明 / 无边框」样式落空
  • 字体改为三级候选链：插件资源位 → 文档相对路径 → 固定 commit 远程兜底，加载失败自动降级
  • 2.1.1 修复三处桌面端过宽匹配：GBA 窗框不再命中主内容面板 / 顶栏菜单（改为 WAI-ARIA 浮层角色 + _popup 后缀，消除对话页 L 形黑线与横向滚动条）；侧栏行不再强制 padding（消除「技能中心 → 插件」行图标与文字重叠）；_primary 仅作用于按钮（防止任意元素被整体涂色）
  • 2.1.2：回合状态句匹配放宽——桌面端实际文本「深度求索中，用时1小时07分21秒」等带后缀变体也能替换，且保留用时后缀；像素球重绘为直角分层球（上红下白 + 墨带 + 白纽 + 墨线描边），替代 conic 渐变小尺寸下的红白噪点
  • 2.1.3：状态句替换改为文本节点级（不再整元素 textContent 改写——那会清空 React 子节点被立即重建，表现为替换不生效）；候选选择器扩展到 _turnStatus / _activity / _busy；__PIXELSKIN__.status() 热切换改为节点级短语替换并新增 version 字段便于核对已加载的 bundle 版本
  • 2.1.5：移除能力等级面板（自绘滑块）、滑块配色设置与 /pixel-declare 补全命令——受控滑块拖动时高频异步写入模型选择，与远端回写相互竞争，导致切换卡顿、需多次点击；推理等级切换回归官方模型菜单（模型档位由 cordis.patch.yml 对 llm-pi-ai providers 静态声明）
  • 2.2.0：适配 DSH 0.1.7-rc.2 并新增 4 项能力，且不删减任何既有功能（无 BREAKING）
    • 配色扩充到 8 套：红 / 蓝 / 绿 / 黄 / 紫 / 橙 / 青 / 粉，设置页一键切换
    • 自定义强调色：取色后由单色自动推导 hover / soft / tint 整套配色，切到「自定义」主题
    • 像素缩放档位：1x / 1.5x / 2x，用 CSS zoom 实现（会正确重排、同步滚动条与命中测试；transform 只做视觉缩放会留下错位的交互区）
    • 设置项完整化：自定义强调色 / CRT 扫描线 / 像素缩放 / 回合状态句 / 主题色全部进入「像素皮肤」设置分区；控制台 API 保留，并新增 accent() / scale() / scales()
    • 修复：字体候选链不再依赖第三方仓库。 此前最后一级兜底指向 ADAning/dsh-pixel-skin 的固定 commit（与本仓库 origin zhuifengqug/pixel-skin 不是同一个仓库，文件内容也与本地 assets/fonts 不一致），现改指本仓库 origin 的固定 commit
    • 修复：桌面端标题栏适配静默失效。 DSH 0.1.7-rc.2 的布局类名哈希已由 ZTP-Xa 变为 pI_x6G，2.1.5 写死的旧哈希已不命中；现同时匹配两代哈希，并在代码中标注该依赖的脆弱性
    • 新增 localStorage 键为纯附加（pixel-skin:accent、pixel-skin:scale），既有的 pixel-skin:enabled / pixel-skin:scanlines / pixel-skin:palette 值域未改动，旧值直接可用
  • 2.3.0：修复回合状态句静默失效 + DSH STORE 上架整改（无 BREAKING，纯增量修复）
    • 修复：回合状态句替换一直不生效。 根因不是措辞，而是替换对象——0.1.7-rc.2 的可见状态文案在 button[data-turn-process] 的 label span 里；[role="status"] 只命中 visuallyHidden 的 aria-live 播报节点（clip:rect(0 0 0 0)、1×1px，肉眼不可见），而 _turnStatus / _activity / _busy 三族类名在当前客户端包内根本不存在。替换每次都在成功执行，只是写进了看不见的节点。现主锚点改为稳定的 data 属性 button[data-turn-process]，旧类名分支保留兼容；CSS 同源修复（状态胶囊 + 像素光标）
    • DSH STORE 上架整改（issue #1199）：补 repository / homepage / bugs / LICENSE / engines / dsh.compatibility.dshReleases；权限、外部服务与失败边界在 README「权限、依赖与失败边界」一节如实声明
    • 能力等级面板（滑块）本轮搁置，未随 2.3.0 发布——按「之后再做」处理，开发期实现已在发版前整体摘除 577 行，代码留在 git 历史（1e59a14..d2170f8），避免发布一个打不开的面板和设置页里一句误导说明

像素球、HP 条与窗框均为原创 8-bit 图形，灵感来自 90 年代掌机游戏界面；未使用任天堂 / Pokémon 官方素材或商标名称。

截图

DSH Web 主页

设置页面

安装

DSH 安装（推荐）

只需要执行下面这一条命令。dsh plugin 会在对应 profile 中完成包安装、登记和激活：

dsh plugin --profile web add dsh-pixel-skin
# 桌面端：
dsh plugin --profile desktop add dsh-pixel-skin

桌面端安装后重启 DeepSeek Harness 桌面应用即可；Web 安装后重启 dsh web，然后在浏览器中硬刷新（Ctrl+F5）。

作为普通 npm 依赖使用（可选）

如果你想在其他 Node.js 项目中使用这个包，可以执行：

npm install dsh-pixel-skin
# 或
pnpm add dsh-pixel-skin

这一步不会自动把插件加入 DSH Web profile；DSH 用户不需要先执行它。

查看当前 npm 版本：

npm view dsh-pixel-skin version

GitHub 安装（当前可用）

dsh plugin --profile web add github:zhuifengqug/pixel-skin

本地安装

dsh plugin --profile web add D:/dsh/pixel-skin

安装后重启 dsh web，然后在浏览器中执行硬刷新（Ctrl+F5）。之后改 lib/client.js 需要重新构建客户端 bundle；若 DSH checkout 正在运行 pnpm run dev:web，客户端 HMR 可在重载后生效。

打包下载

如果不使用 npm，也可以在仓库目录生成 tarball：

npm pack
# 生成 dsh-pixel-skin-2.1.2.tgz

dsh plugin --profile web add ./dsh-pixel-skin-2.1.2.tgz

仓库地址：https://github.com/zhuifengqug/pixel-skin

控制台 API

在浏览器控制台执行：

__PIXELSKIN__.palette('red') // 切换主题色：red / blue / green / yellow / purple / orange / teal / pink / custom
__PIXELSKIN__.palettes() // ['red','blue','green','yellow','purple','orange','teal','pink','custom']
__PIXELSKIN__.accent('#8b5cd6') // 2.2.0 新增：设自定义强调色（6 位十六进制），自动切到 custom 主题
__PIXELSKIN__.scale('2') // 2.2.0 新增：像素缩放档位 '1' / '1.5' / '2'
__PIXELSKIN__.scales() // ['1','1.5','2']
__PIXELSKIN__.status('idle') // 状态句：idle / charge / move / evolve
__PIXELSKIN__.statuses() // ['idle','charge','move','evolve']
__PIXELSKIN__.scanlines(true) // 开启扫描线
__PIXELSKIN__.scanlines(false) // 关闭扫描线
__PIXELSKIN__.off() // 停用皮肤，刷新后恢复官方外观
__PIXELSKIN__.on() // 重新启用皮肤，刷新后生效

也可以通过 localStorage 控制：

pixel-skin:enabled = 0     # 整体停用
pixel-skin:scanlines = 1   # 开启扫描线
pixel-skin:accent = #8b5cd6  # 2.2.0 新增：自定义强调色
pixel-skin:scale = 2       # 2.2.0 新增：像素缩放档位 1 / 1.5 / 2

卸载

dsh plugin --profile web remove dsh-pixel-skin

卸载后重启 dsh web（桌面端重启应用）并刷新页面即可恢复官方外观。

字体与许可证

插件使用 Fusion Pixel 字体：

• Fusion Pixel 12px Proportional SC：中文/英文 UI
• Fusion Pixel 12px Monospaced SC：代码和终端
• Fusion Pixel Latin：拉丁字符补充

字体版权归 TakWolf 所有，字体部分使用 SIL Open Font License 1.1。完整许可证见 assets/fonts/LICENSE.fusion-pixel.txt，第三方声明见 THIRD_PARTY_NOTICES.md。

权限、依赖与失败边界

面向安装前审查，逐项如实声明。不声明「未发现」为「不访问」。

权限

| 类别 | 是否触及 | 说明 | |---|---|---| | 文件系统 | 否 | 插件不读写任何磁盘路径。index.js / lib/index.js 是 no-op 占位，Node 启动零副作用 | | 命令 / Shell / 子进程 | 否 | 无 child_process、无动态执行 | | 凭据 / Token / Cookie | 否 | 不读取、不存储、不转发任何凭据 | | 原生制品 | 否 | 纯 JS + CSS + WOFF2 字体，无 .node / 二进制可执行物 | | 受保护 DSH 行为 | 否 | 不禁用、不替换、不重复安装任何 @deepseek-ai/* 官方组件 | | 持久状态 | 是 | 浏览器 localStorage，仅插件私有偏好键（见下），不触碰 Profile / 会话文件 | | 网络 | 是 | 仅 @font-face 取字体，指向本仓库 origin 的固定 commit，见下 |

localStorage 键（全部为皮肤私有偏好，删除即回到默认值）：

pixel-skin:enabled          开关
pixel-skin:scanlines        CRT 扫描线
pixel-skin:palette          主题色
pixel-skin:accent           自定义强调色（2.2.0）
pixel-skin:scale            像素缩放档位（2.2.0）
pixel-skin:status           回合状态句

权限等级自评：medium。 依据 DSH STORE 口径——「仅有范围明确的只读、插件私有状态写入、 指定服务时可标为 medium」：本插件只有插件私有状态写入 + 指定单一服务，不触碰 Profile / 会话 持久状态，不访问任意网络，不承担插件生命周期管理。最终等级由商城判定，此处只是自评与依据。

外部服务

| 服务 | 用途 | 固定方式 | 失败时 | |---|---|---|---| | raw.githubusercontent.com/zhuifengqug/pixel-skin/<commit>/assets/fonts/*.woff2 | 像素字体三级候选链的远程兜底 | 钉死 commit SHA，非浮动分支 | 回退系统中文字体 |

没有其他外部服务：无遥测、无统计、无更新检查、无第三方 API。

运行依赖

• peer：@deepseek-ai/dsh、@deepseek-ai/cordis
• 宿主运行时提供：react（由 DSH ModuleLoader 注入，插件不自带）
• 不使用 react-dom：面板用原生 DOM 构建，因为 ModuleLoader 未注册 react-dom/client
• 无 dependencies，无 preinstall / install / postinstall / prepare 生命周期脚本； scripts.build 是 echo 空操作，安装时不会执行

失败边界

| 故障 | 表现 | 是否影响 DSH 功能 | |---|---|---| | 字体三级候选链全部 404 | 降级为系统中文字体 | 否 | | 官方 DOM 类名哈希改名 | 对应装饰（标题栏 / 状态胶囊）不再生效 | 否 | | localStorage 被禁用 | 每次刷新回到默认值 | 否 |

皮肤的定位是纯装饰：任何一处失效都只影响外观，不会改变 DSH 的行为、数据或权限。

已知边界

• 侧栏和工具栏图标是矢量图标，本皮肤主要调整颜色和表面，不重绘图标形状
• 字体使用三级候选链（/plugins/dsh-pixel-skin/assets/fonts/* → ./assets/fonts/* → 本仓库固定 commit 远程 URL）；当前 DSH 的 /plugins 路由不服务插件 assets，本地两级候选多数情况下 404，由远程兜底加载。2.2.0 起远程兜底只指向本仓库 origin（zhuifengqug/pixel-skin），不再引用任何第三方仓库；发布前必须先推送该 commit，否则远程候选也 404，字体会降级为系统中文字体（不影响 DSH 功能）。assets/fonts 保留作为离线构建来源
• 网络字体加载失败时会回退到系统中文字体，不影响 DSH 功能
• 桌面端 Windows 自绘标题栏样式基于 html[data-windows-titlebar] 与官方布局骨架类名哈希。该哈希是压缩产物，DSH 0.1.7-rc.2 实测为 pI_x6G，2.1.5 及之前写死的 .ZTP-Xa_* 已失效（因此桌面端标题栏适配曾静默失效）。现在同时匹配两代哈希，官方再次改名时仍会失效，届时只需在 lib/client.js 的桌面端段落补一个哈希前缀；这是纯装饰无法走官方 Slot 注册时的已知代价
• 1.5x 为半整数倍缩放，点阵可能略发虚；1x / 2x 为整数倍，最锐利
• GBA 窗框按 WAI-ARIA 浮层角色（dialog / menu / listbox / alertdialog / tooltip）与 _popup / _popover / _dropdown 类名后缀匹配；不使用这些角色/后缀的第三方插件浮层保持原生外观
• DSH 仍处于 developer preview，官方 token 名称变化时需要更新 lib/client.js 中的 TOKENS