dsh-pixel-art
一个 skill 型 DSH（DeepSeek Harness）插件：不规定"能画什么"，而是教 agent 怎么手写像素画出用户要的任何图 —— 写脚本逐像素算颜色，想要什么画什么，不联网、不依赖绘图库、同参数必然复现。
技能名：handwritten-pixel-art
它解决什么
把画图能力做成"固定词表的程序化渲染器"时，用户一说"蓝色的鲸鱼"就露馅——词表里没有的东西一律画不出来。而实际能把任意需求画出来的是手写像素：写脚本逐像素算颜色。
这个技能把两次实战（按参考图复刻壁纸、从零画星空风景）的经验沉淀成可复用的流程与配方，并带上交付纪律：改到自己满意才能交付。
安装
方式一：从 GitHub 装
# 在 DSH 主程序目录（含 dsh.cmd）执行
dsh plugin --profile web add github:Alkaid4521/dsh-pixel-art
国内直连 github / codeload 常超时，可让 git 走镜像传输（写进 package.json 的仍是官方地址）：
$env:GIT_CONFIG_COUNT=1
$env:GIT_CONFIG_KEY_0='url.https://ghfast.top/https://github.com/.insteadOf'
$env:GIT_CONFIG_VALUE_0='https://github.com/'
dsh plugin --profile web add github:Alkaid4521/dsh-pixel-art
备用镜像：gh-proxy.com、ghproxy.net（把上面 URL 里的域名换掉即可）。
方式二：本地源码 link
git clone https://github.com/Alkaid4521/dsh-pixel-art
cd dsh-pixel-art
dsh plugin --profile web add link:.
或把源码放到固定的插件源目录再 link（勿放 Downloads，防止被清理后链接失效）：
# %DSH_HOME%\plugin-src\dsh-pixel-art → dsh plugin --profile web add link:<该绝对路径>
方式三：离线分发包
下载 Releases 里的 zip 解压，进目录执行：
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 # 只想看会做什么：加 -DryRun
powershell -NoProfile -ExecutionPolicy Bypass -File .\verify.ps1 # 出厂校验：哈希 / 语法 / 清单一致性 / 资源 / 体量
装完必须重启 DSH（dsh web），技能才会进会话目录；dsh --profile web --dump-config 能确认配置树里出现 dsh-pixel-art。
用法
装完直接说人话，不需要斜杠命令；agent 按技能描述自动加载，也可显式 skill(name="handwritten-pixel-art")。
| 你说 | 会发生什么 |
|---|
| 画一幅山水画 | 加载技能 → 写脚本逐像素作画 → 出 PNG → 自己看图、按指标挑毛病 → 改 → 重渲，直到满意才交 |
| 复刻这张图（附图） | 走技能 §10 复刻流程：读原图像素 → 降采样到目标网格 → 量化 → NEAREST 放大 |
| 画成像素风 / 平滑风 | 像素风 = 网格 = 输出 ÷ 4，32 级量化 + Bayer 抖动；平滑风 = 网格 = 输出 ÷ 2，盒式降采样 |
画图需要什么环境
两条路任选一条，都不联网：
| 路线 | 需要 | 适用 |
|---|
| 首选 | Python 3 + Pillow | 画布 / 噪声 / 色标 / 量化抖动 / 自评指标一站齐全 |
| 兜底 | Node（零依赖，自写 PNG 编码器） | 机器上没有 Python + Pillow 时 |
两个已知坑：
- PATH 上的
python 若是 WindowsApps 别名，运行会报 Python was not found。用完整解释器路径，例 %LOCALAPPDATA%\Python\bin\python.exe。
- Pillow 要在：
pip install pillow。
仓库结构
skills/handwritten-pixel-art/
├── SKILL.md 唯一会被整篇读进上下文的文件：铁律 / 工作流 / 图层顺序 /
│ 逐层配方 / 立体感四件事 / 出图前处理 / 自评六指标 /
│ 交付闸 / 失败症状索引 / 复刻流程 / 维护纪律（含体量预算）
└── assets/
├── pixel_kit.py 起手工具包（Python + Pillow）：画布 / 噪声 / 色标 /
│ 自评指标 / 存 PNG，可直接改
└── png_node.mjs 纯 Node 零依赖版：自写 PNG 编码器 + 画布 + 噪声 + 量化
tools/check-size.mjs 技能体量守门：SKILL.md 超预算即报错
分层原则：判据进 SKILL.md，代码进 assets/（按需读，不读不花 token）。技能不提供案例库 / 模板库 / 成品图——给样例会把后续发挥锚定在照抄上；可复用的只有判据与工具。
版本
- v0.1.1（2026-09-29）：修
pixel_kit.py 取整缺陷 —— Python round() 是银行家舍入，坐标落在 x.5 时会漏掉整列（圆、光晕只写到隔一列上，出成片的 2px 竖条伪影）；Canvas.put/mix/add/get 改用 floor(v+0.5)，并在 SKILL.md 症状索引补一条。
- v0.1.0（2026-09-28）：首版。
许可证
MIT
