dsh-pixel-studio (dsh-cli-anything-aseprite)

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-03），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# DSH Pixel Studio — CLI-Anything × Aseprite

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

> 基于 [HKUDS/CLI-Anything](https://github.com/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 绘制过程

## 📦 安装

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

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

## 🎨 快速上手

```bash
# 新建 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
```

## 🧪 测试

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

## 📄 许可

MIT — 见 [LICENSE](LICENSE)。