dsh-pixel-skin

dsh plugin --profile web add dsh-pixel-skin

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

[English README](README.md)

给 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](assets/fonts/LICENSE.f

…(truncated)