前言¶
DeepSeek Harness（DSH）把对话、工具和插件收在同一块工作区里。要做像素草图、小图标或配色试验时，若每次都切换到独立图像软件，再把文件拖回会话目录，路径和版本都容易乱。下面介绍的 dsh-pixel-studio（npm 包名 @muxiuesd/dsh-pixel-studio，仓库 Muxiuesd/dsh-pixel）由维护者 Muxiuesd 发布，归类为社区目录中的「趣味换装」类插件；当前在 GitHub 上星标为 0。它在 会话页签 内提供三栏编辑器（工具 / 画布 / 调色板），支持滚轮缩放、图层、调色板编辑，并把 PNG 导出到本机会话相关目录，数据默认不上传、不联网。
这是什么¶
一句话：在 DSH 里嵌入的像素画工作室，布局和操作贴近常见像素编辑器，但入口就在对话工作流旁边。
- 维护者：Muxiuesd
- 许可证：MIT（© 2026 Muxiuesd）
- 当前包版本（资料中的
package.json）：0.5.0 - 社区目录页：https://www.skillhub.cn/plugins/Muxiuesd/dsh-pixel
- 源码与反馈：主仓库在 Gitee（README 所列），GitHub 为镜像
插件通过 Cordis patch 注册客户端能力，在 Web / Desktop 的 DSH 0.2.x 下使用；客户端经 window.__ModuleLoader__ 加载，React 由宿主提供，不随包打包。
核心功能¶
界面与画布¶
装好后刷新页面，会话页签行会出现 「像素画」 入口。编辑器为三栏：左侧工具、中间画布、右侧调色板。
画布支持整数倍缩放 1× 至 64×，滚轮以光标为锚点缩放；空格或中键拖动平移，F 适应窗口。缩放 4× 及以上 可显示格线（可用 H 开关）。
工具与选区¶
- 铅笔、橡皮、油漆桶、吸管（快捷键
B/E/G/I）；方形笔刷 1–8 像素（[/]调节）。 - 油漆桶按 合成后的颜色 判断连通，视觉上同色可一次填满。
- 矩形选区（
M）：拖框；拖框内仅移动选框，Shift + 拖动连带像素移动；镜像 / 填充 / 删除默认作用当前图层，「多层」或Alt可作用全部可见层；方向键微调，Ctrl/Cmd+A全选，Esc取消。
图层与调色板¶
最多 8 个图层：新建、复制、合并、上/下移、删除、改名、显隐，均可撤销。
调色板最多 36 色，内置 PICO-8 等预设。修改某一槽位颜色 不会改变已画好的像素（画布上旧颜色会由空闲槽位接手）；也可使用系统取色器。
作品、导入与尺寸¶
新建作品时填写名称和尺寸（1–256），另有 11 个常用尺寸预设，并 自动保存。
可打开 PNG / JPEG / GIF / WebP / BMP：自动缩放到 256 以内，可按需提取配色或沿用当前调色板 / PICO-8，可选抖动后生成新作品继续编辑。
在「尺寸」中改宽高（1–256），9 宫格锚点决定裁切或扩边方向，改完可撤销。
导出与数据¶
- 导出：首次选择保存位置（默认从当前会话目录起）；之后导出覆盖同一文件；「另存为」可换路径并选 1×–16× 导出倍率（记住上次选择）。快捷键
Ctrl/Cmd+S保存，Ctrl/Cmd+Shift+S另存为 PNG。 - 作品索引：profile 目录下的
../pixel-studio/works.json（默认~/.dsh/pixel-studio/works.json）。 - 插件注册 Host 路由
/dsh-pixel-studio，同源fetch读写作品与写 PNG；不执行命令、不访问网络。PNG 由插件自行编码（IHDR + zlib + IEND），不依赖外部图像库。
更完整的快捷键见仓库 README 中的表格（工具、选区、缩放、撤销等）。
安装与启用¶
任选一种方式安装，完成后 刷新 DSH 页面，即可在会话页签行看到「像素画」。命令须与 README 一致：
# 1) 官方插件管理页 / 插件市场里搜索 @muxiuesd/dsh-pixel-studio
# 2) DSH CLI（npm）
dsh plugin --profile web add @muxiuesd/dsh-pixel-studio
# 3) 直接从 GitHub 仓库装（仓库根就是插件包）
dsh plugin --profile web add github:Muxiuesd/dsh-pixel
# 4) 本地开发
dsh plugin --profile web add /绝对路径/dsh-pixel
环境要求：Node.js ≥ 20，DSH 0.2.x（Web / Desktop 均可）。
典型用法¶
- 安装并刷新后，在会话页签行打开「像素画」。
- 新建作品：设名称与画布尺寸（或选预设），在调色板选色，用铅笔等工具在画布上绘制；需要时分层、用选区做局部编辑。
- 若要基于照片起稿：导入 PNG 等格式，按提示缩放与取色，再在原作品上继续改像素。
- 满意后
Ctrl/Cmd+S或导出 / 另存为 PNG，文件落在所选路径（常与当前会话目录相关），便于在同一会话里引用或备份。
适用场景与注意¶
适合谁：在 DSH 里做对话边栏草图、小尺寸 UI 像素稿、配色试笔，且希望文件留在本机 profile / 会话一侧的开发者。
权限与安全：插件以 当前 DSH 进程权限 读写本机 works.json 与用户选择的 PNG 路径；安装前建议阅读仓库源码与 MIT 许可证，确认路径与导出行为符合你的环境策略。插件自述不联网、不执行 shell 命令，但仍会写本地文件。
生态说明：DSH 社区插件目录（如 skillhub.cn）为独立站点，与 DeepSeek / 幻方无官方从属关系；安装来源以 README 与目录页为准。
结尾¶
dsh-pixel-studio 把三栏像素编辑器放进 DSH 会话页签，缩放、图层、调色板与 PNG 导出在一处完成，作品默认存在本地 pixel-studio 数据文件中。目录与源码链接：https://www.skillhub.cn/plugins/Muxiuesd/dsh-pixel、https://github.com/Muxiuesd/dsh-pixel。
