KongChengZhi/dsh-pixel-studio · dsh-cli-anything-aseprite

DSH Pixel Studio — CLI-Anything × Aseprite

把 Aseprite 像素画工作流做成 AI 可用的 CLI + DSH 插件： AI 像人类一样分步绘制像素画，每一步都实时渲染到终端与 GUI 监视器， 人类可以全程观看 AI 的每一笔。

基于 HKUDS/CLI-Anything 的 GUI→CLI harness 方法论构建。

✨ 功能

CLI harness（cli-anything-aseprite，纯 Python，无 GUI 依赖）

• 绘制原语：pixel / line / rect / ellipse / flood / erase
• 选区（Aseprite 语义）：fill / stroke / clear / copy / paste / move / get （剪贴板跨进程持久化）
• 图层：增删改查、显示/隐藏、透明度 0-255、复制、合并、参考层
• 动画帧：增删、时长、复制 + 帧标签（Frame Tags）
• 画布：任意尺寸 1..1024（自由画布）+ 7 个预设、resize（九宫格锚点）、 rescale（最近邻）
• 模式：对称绘制（h/v/both）、平铺模式（无缝纹理）
• 渐变：两点插值，支持 rgb16 4096 色（16×16×16 通道索引）
• 调色板：pico8 / db16 / sweetie16 / na16 + 最近色映射 + 量化
• 导出：PNG（最近邻放大）/ GIF / 原生 .aseprite 二进制（手写 ASE 格式） / 精灵表（含 JSON）/ PNG 序列
• 实时终端帧：ANSI 真彩半块字符渲染（含洋葱皮多帧幽灵）
• Undo/Redo 跨进程持久化（sidecar 快照栈）
• 并发安全：多进程写同一项目文件使用唯一临时文件 + flock 原子替换
• 49+ 单元 & E2E 测试（字节级验证 .aseprite 格式）

DSH 插件（实时监视器）

• 20 个 pixelart_* 模型工具
• 右下角实时监视器：终端画布（居中自适应 80% 宽）、预览缩放 1×~48×、 图层栏（眼睛/透明度滑条）、对称/平铺/洋葱皮开关、导出、切换/新建画板、 工作区目录管理
• 每次操作自动推送 ANSI 帧 + 画布网格 → 人类实时可见 AI 绘制过程

📦 安装

# 1) harness
cd agent-harness && pip install -e .

# 2) DSH 插件（开源注册）
dsh plugin --profile web add github:KongChengZhi/dsh-pixel-studio

🎨 快速上手

# 新建 32×32 精灵
cli-anything-aseprite --file hero.pxa project new hero --width 32 --height 32 --palette pico8

# 像人类一样分步绘制：打形 → 底色 → 阴影 → 高光
cli-anything-aseprite --file hero.pxa pixel rect 10 6 12 18 "#1d2b53"
cli-anything-aseprite --file hero.pxa pixel rect 11 7 10 16 "#ff004d" --fill
cli-anything-aseprite --file hero.pxa pixel symmetry h          # 对称绘制
cli-anything-aseprite --file hero.pxa pixel gradient 0 8 15 8 "rgb16:15,0,0" "rgb16:0,0,15"

# 实时终端帧（人类观看）
cli-anything-aseprite --file hero.pxa terminal --onion 1

# 导出
cli-anything-aseprite --file hero.pxa export png hero.png --scale 8
cli-anything-aseprite --file hero.pxa export aseprite hero.aseprite

🗂 项目结构

├── agent-harness/          # cli-anything-aseprite（Python，开发版）
│   └── cli_anything/aseprite/   # core / utils / tests / skills
├── dsh-cli-anything-aseprite/  # ★ 正式 DSH 插件包（npm + python 副本）
│   ├── src/index.js        # cordis 插件：20 个 pixelart_* 工具
│   ├── python/             # harness 打包副本
│   └── cordis.patch.yml    # 注册行（带 workdir 配置）
└── README.md

🧪 测试

cd agent-harness && python -m pytest cli_anything/aseprite/tests/ -q   # 73 passing

📄 许可

MIT — 见 LICENSE。