前言¶
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。
