前言¶
做像素畫或精靈動畫素材，常規流程是先裝一個 Aseprite，畫完導出 PNG，再上傳到項目裏。如果只是改幾個圖塊、做一版簡單動畫，來回切換工具的成本不低。
dsh-aseprite 把這件事搬進了 DeepSeek Harness（DSH）的網頁界面：編輯器內嵌在對話裏，用純 JavaScript 直接讀寫 .aseprite 工程文件，本機不需要安裝 Aseprite。它還提供了 ASK 局部調整和可視化藍圖工作流，可以把畫布內容交給當前對話裏的 AI 處理。下面介紹這個插件的定位、功能和用法。
這是什麼¶
dsh-aseprite 是一個適用於 DeepSeek Harness 的像素畫/精靈動畫編輯器插件，當前版本 0.3.0，MIT 許可證，代碼託管在 GitHub 的 Ratevoid 名下，分類爲 media。
它解決的問題很明確：
1、在 DSH 網頁端提供畫布、圖層、幀動畫、調色板等編輯能力；
2、直接讀寫 .aseprite 工程文件，與 Aseprite 保持文件兼容；
3、通過 ASK 和藍圖機制，把選中區域或整張圖發給當前對話的 AI 參與處理。
核心功能¶
入口與繪圖工具¶
插件安裝後會在對話頭部添加一個 🎨 按鈕，點擊即可在消息輸入框上方打開或關閉編輯器 dock。
繪圖工具包括鉛筆、橡皮、油漆桶填充、取色器、直線、矩形和矩形區域選擇，附帶撤銷/重做、滾輪縮放、網格、洋蔥皮顯示，筆刷和橡皮大小可調，上下面板的分隔條可以拖動調整。
ASK 局部調整¶
選中一塊區域後點擊 ASK，描述想要的局部調整，插件會把放大的 PNG 裁剪和選區座標發送到當前 DSH 對話。AI 的回覆在聊天中審閱，編輯器裏的像素不會被自動修改。
藍圖工作流¶
點擊工具欄的 🧩 按鈕會打開一個 ComfyUI 風格的可視化節點圖，拖拽節點、點擊輸入/輸出端口即可連線。藍圖分兩類：
1、被動藍圖：例如透明裁剪、像素描邊、裁剪+描邊，全部本地運行，一次創建可無限複用，從不調用 LLM；
2、主動藍圖：包含 LLM 節點，會把所選圖片和節點提示發送給當前對話的 AI。
此外還有 AI Create Blueprint 功能：描述一個完整任務後，助手生成的 dsh-blueprint JSON 會被自動解析、校驗並存入瀏覽器藍圖庫，不需要手動複製 JSON。藍圖庫支持 UI 導入/導出。
圖層、幀與調色板¶
1、圖層：創建、刪除、排序、切換可見性；
2、動畫幀：添加、複製、刪除、設置幀時長（毫秒）、預覽播放；
3、調色板：內置 DB16 和 PICO-8 風格 16 色調色板，支持自定義顏色、額外調色板和取色。
文件讀寫¶
插件用純 JavaScript 實現 .aseprite 工程文件的讀寫，無需安裝 Aseprite。讀取支持 RGBA、灰度、索引色和壓縮 cel 解碼，導出支持當前幀 PNG 和精靈表 PNG。
工作原理¶
插件由三部分組成，編輯器完全在瀏覽器中運行：
1、Host（lib/index.js）：最小加載入口，暴露 dsh.client 聲明；
2、Client（client/client.js）：遵循 window.__ModuleLoader__.load({ id, factory }) 契約，通過 ctx.slots 註冊到 conversation.session.header.actions 和 conversation.input.dock；
3、Codec（src/ase-codec.js）：實現 Aseprite 文件格式規範，寫入 32bpp RGBA、raw cel 和現代調色板 chunk，Aseprite 可以直接打開它寫出的文件。
依賴方面，peerDependencies 爲 @deepseek-ai/cordis ^4.0.1，client 注入 @deepseek-ai/dsh-client-connection、@deepseek-ai/dsh-client-runtime、@deepseek-ai/dsh-client-locale、@deepseek-ai/dsh-client-ui-slots、@deepseek-ai/dsh-client-ui-conversation，platform 爲 web，immediately 爲 true。
安裝與卸載¶
安裝使用 DSH 的插件命令：
dsh plugin --profile web add
資料中提供的安裝方式是本地文件安裝。如需手動重裝，命令如下（佔位符替換爲本地路徑，不需要時省略 --store-dir）：
dsh plugin --profile web add --store-dir "<your-pnpm-store>" "file:<path-to-dsh-aseprite>"
安裝完成後重啓 DeepSeek Harness 並刷新頁面，對話頭部出現 🎨 按鈕即說明插件已加載。資料中未提供從 GitHub 遠程安裝的命令。
卸載命令：
dsh plugin --profile web remove dsh-aseprite
如果配置中存在，還需刪除 cordis.patch.yml 裏手寫的 aseprite 條目，然後重啓應用。
典型用法¶
結合 README，幾個可復現的操作路徑：
1、打開編輯器：點擊對話頭部的 🎨 按鈕，在消息輸入框上方打開編輯器 dock；
2、局部調整：在畫布上選中區域，點擊 ASK 並描述調整需求，PNG 裁剪和選區座標會發到當前對話，回覆在聊天中查看；
3、手工連藍圖：點擊工具欄 🧩 打開節點圖，拖拽節點並點擊輸入/輸出端口連線；
4、AI 生成藍圖：點擊 AI Create Blueprint，描述完整任務，生成的 dsh-blueprint JSON 會自動解析並存入藍圖庫。
如果要參與開發，構建和測試命令是：
node scripts/build.mjs # 重新生成 client/client.js
pnpm test:blueprints # 運行藍圖引擎測試
適用場景與注意¶
適合的用戶：在 DSH 裏做遊戲原型、像素風素材或演示內容的開發者；想把畫圖和 AI 對話放在同一個界面裏、不願爲本地圖形工具單獨裝環境的人。
幾點注意：
1、編輯器完全在瀏覽器中運行，但插件本身以當前 dsh 進程的權限加載。安裝前建議先查看源碼和許可證，本項目爲 MIT 許可證；
2、.aseprite 文件的寫入格式經過設計，Aseprite 可直接打開，但建議在正式流程使用前先用自己的工程文件驗證一遍讀寫結果；
3、維護者信息來自 GitHub 倉庫地址，README 和 package.json 中未做明確署名。
結尾¶
dsh-aseprite 把像素畫編輯、幀動畫和 Aseprite 文件兼容裝進了 DSH 的網頁界面，再通過 ASK 和藍圖把畫布接到對話 AI 上。對需要在 DSH 裏處理像素素材的人來說，是一個可以直接上手的補充。
插件目錄頁：https://www.skillhub.cn/plugins/Ratevoid/dsh-aseprite
GitHub 倉庫：https://github.com/Ratevoid/dsh-aseprite
