前言¶
做像素画或精灵动画素材，常规流程是先装一个 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
