在 DeepSeek Harness(DSH)的 Web GUI 开发中,将矢量 SVG 图标转换为像素风格通常需要手动重绘或复杂的 CSS 处理。dsh-pixel-icons 插件通过运行时修改,解决了这一痛点,能将界面图标统一转换为 1px 像素块风格。
插件定位¶
dsh-pixel-icons 是由 TableRogue 维护的趣味换装类插件。它不依赖构建步骤,通过运行时修改 DOM 节点实现图标风格转换,同时保留 React 节点的 identity,不破坏界面交互逻辑。
核心功能¶
- 图标光栅化:运行时将所有
fill="currentColor"的 SVG 图标重建为 1px 像素块。 - 高质量处理:采用 3× 超采样配合块平均算法,确保细线连续、粗细均匀。
- 智能过滤:自动跳过功能性 SVG 元素(如进度环),不影响 UI 逻辑。
- 无侵入修改:原地修改 DOM,保留 React 节点 identity,侧栏折叠等交互正常。
安装与启用¶
安装后插件会自动追加进 profile 的 dsh.profile.bundles,启动 dsh --profile web 即生效。
dsh plugin --profile web add github:TableRogue/dsh-pixel-icons
配置与调参¶
插件支持通过配置项微调像素化效果。修改配置后需刷新页面重新光栅化。
- SCALE:超采样倍数(默认 3)。数值越小,像素颗粒越大;数值越大,线条越精细。
- 0.35:块平均覆盖率阈值。调整此值可改变细线跨块的判定逻辑。
使用示例¶
安装后,可以通过以下命令验证插件是否生效:
dsh --profile web --dump-config
在输出配置中查找 # == dsh-pixel-icons 层即可确认。
临时使用方式¶
若需临时测试或单次进程使用,可将 src/client.js 文件头注释中的内容提取出来,填入 cordis_define 的 code.client 中执行 cordis_run。
结尾¶
dsh-pixel-icons 体现了 DSH “一切皆插件” 的理念。安装前建议检查源码与许可证(MIT)。