前言¶
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中重新對齊。
