美术素材库 Liaoyun666/dsh-art

dsh-art

公开仓：<https://github.com/Liaoyun666/dsh-art>（代码 MIT；assets/ 下素材另按 NOTICE.md）

给 DeepSeek Harness（DSH）用的美术素材包插件。20 个工具、四个数据源： 341 种「代码动画」风格提示词（193 张参考静帧）、一个可选的参考图库客户端、 244 条带源码与预览的像素特效，外加把你自己那张图拆成元素块、配色和提示词的本地提取器。
零运行时依赖，装完直接在会话里用。

| | 内容 | 工具 |
| ① 本地素材库 | 341 条风格提示词 / 193 张静帧 / 10 个系列 / 3 个示例视频 | anim_list_series anim_search anim_show anim_still anim_export anim_random anim_guide |
| ② 参考图库（可选） | 8,496 张参考图（自建的只读 JSON API，地址自己配） | anim_ref_sources anim_ref_search anim_ref_show anim_ref_pick |
| ③ pixelfx 特效 | 244 条像素特效 / 21 个分类 / 244 张预览 / 源码可导出 | anim_fx_stats anim_fx_search anim_fx_show anim_fx_preview anim_fx_export anim_fx_random anim_fx_guide |
| ④ 元素提取（本机跑） | 你手里那一张图 → 元素块 / 调色板 / 构图 / 两段提示词 | anim_extract anim_extract_guide |

像素特效：史莱姆像素特效：暴雨像素特效：冰霜新星

上：critters/slime（112×80，1.8s 循环）／weather/storm（320×180 全屏）／ice/frost-nova（288×192，3.4s 单次，带角色表演）——三张都是 anim_fx_preview 现场渲染出来的接触表

1. 一分钟装进 DSH

~~~bash
git clone https://github.com/Liaoyun666/dsh-art.git
cd dsh-art

node tools/install.mjs # 建 junction + 把补丁层登记进 desktop profile
node tools/install.mjs --status # 自检：模块能不能加载、四个数据源各有多少条
node tools/verify.mjs # 150 项检查（纯离线，不用联网）

装完刷新 DSH 页面（profile 是 patchReload: live，新工具立刻出现），在会话里说一句「用 anim_list_series 看看有哪些系列」就该看到东西了。

- 换 profile：node tools/install.mjs <profile名>（缺省 desktop，可写绝对路径）。
- 卸载：node tools/install.mjs --uninstall。
- 要求 Node ≥ 22；DSH 桌面端自带的 node 也能跑。
- 插件本体零依赖 —— 没有 dependencies，npm install 都不用跑。

2. 二十个工具

本地素材库（7）

| 工具 | 作用 |
| anim_list_series | 列出 10 个系列与条目数，先看家底 |
| anim_search | 按关键词 / 系列检索 341 条（多个词＝同时命中，支持直接填编号 B3） |
| anim_show | 读某条的完整提示词（Markdown 原文）＋参考静帧路径 |
| anim_still | 只取参考静帧图片路径，可直接交给看图工具 |
| anim_export | 把提示词（可带静帧）复制到工作目录 anim-styles/<编号>_<名称>/ |
| anim_random | 随便抽一条（可限定系列），找灵感用 |
| anim_guide | 读出完整使用指南（选型、占位符、时间接口、验收清单） |

参考图库（4，需要自己有一台）

| 工具 | 作用 |
| anim_ref_sources | 看库的家底：多少张图 / 来源 / 分类 / 配色聚类 / 授权 |
| anim_ref_search | 按中英文关键词、分类、来源、聚类检索，可顺手下载到本地 |
| anim_ref_show | 看某一张的元信息、授权、各尺寸地址，默认下载到本地 |
| anim_ref_pick | 随机抽几张参考图，带回本地路径 |

地址按 config.refBase → 环境变量 DSH_REF_BASE → 占位地址 http://127.0.0.1:8080 取，代码里不写死。
没有自建库时这四条会如实说「没连上」，不影响其余 14 个工具。 参考图库本身是另一个项目（纯静态站 + 一个只读 JSON API），不在本仓库里。

pixelfx 像素特效（7）

| 工具 | 作用 |
| anim_fx_stats | 244 条的家底：分类分布、多少带角色、多少循环、像素尺寸区间 |
| anim_fx_search | 按关键词 / 分类 / 循环 / 角色检索（fire、爆炸、界面 都认） |
| anim_fx_show | 一条的完整说明：尺寸、时长、可调色带、act 表演时间轴、接入代码，source: true 再附源码 |
| anim_fx_preview | 给出接触表 PNG 的本地绝对路径（一次最多 12 条），直接看 |
| anim_fx_export | 把那几条（或某分类前 N 条）连同 src/core 与渲染工具复制成能直接跑的小项目 |
| anim_fx_random | 随机抽一条（可限定分类 / 循环 / 角色） |
| anim_fx_guide | 完整指南：七条工具怎么串、导出目录树、游戏里怎么接、精灵表怎么给非 JS 引擎 |

元素提取（2，纯本地 CPU）

| 工具 | 作用 |
| anim_extract | 把一张图拆开：crops/ 元素块、palette.png、contact.png 接触表、brief.json、report.md，并在会话里给一张卡片（类型、构图、地平线、元素表、两段提示词） |
| anim_extract_guide | 完整说明：到底量了什么、四类图（场景 / 装裱 / 无缝贴图 / 精灵表）怎么用、八个参数、输出树、「别当真的事」 |

支持 PNG / JPEG / GIF / BMP / TGA；WebP / HEIC 不解码，要用户先另存 PNG。
像素画会先认出倍率（4×/8×…）再按真实尺寸分析，裁剪块按整数倍放大，不会糊。

元素提取：一张图 → 元素块 / 调色板 / 构图 / 提示词

上面这张是按同一次提取结果排版的设计图（不是终端截图）：左图上的 5 个元素框与地平线、右上的类型／前景背景／地平线／元素数、右上 7 色调色板、右下的 crops/ 裁剪块、底部的 fxPrompt，全部来自 anim_extract 对 assets/extract/scene.png 的真实输出（800×450，349 ms）。原图也在这个目录里，可以拿去自己跑一遍。

3. 四条典型流程

流程一：一句话 → 一段过场动画

~~~text
你：帮我做一个「霓虹雨夜，镜头推近，最后定格在招牌」的过场 → anim_search "霓虹 雨夜" （找到 R1_霓虹雨夜·电影感 这类条目） → anim_show R1 （读完整提示词 + 静帧路径） → anim_still R1 （看一眼参考静帧，确认调性对得上） → anim_export R1 （落到 ./anim-styles/R1_霓虹雨夜·电影感/） → 照 docs/rendering.md 用 window.renderAt(t) + playwright/ffmpeg 导 MP4 → anim_guide （对着验收清单自检：时间轴、字重、构图、循环）

流程二：游戏里要一套攻击特效

~~~text
你：给剑士做一套攻击特效，要能放进像素游戏 → anim_fx_stats （244 条 / 21 分类，先看有哪些） → anim_fx_search "slash 劈砍" （或直接 category: melee） → anim_fx_preview ids=[…] （接触表 PNG，挑 2~3 条） → anim_fx_show melee/sword-slash （136×104、0.75s 单次、8 个姿态关键帧、7 档色带） → anim_fx_export ids=["melee/sword-slash"] （→ ./pixelfx-fx/，23 个文件）
cd pixelfx-fx
node tools/render.mjs melee/sword-slash --zoom 2 # 接触表
node tools/render.mjs melee/sword-slash --sheet # 精灵表 PNG + JSON

精灵表的 JSON 里带 meta.pixelfx.act：蓄力时长、每个打击点的时间/顿帧/震屏/击退/换皮时刻——非 JS 引擎（Unity / Godot / 自研）照着这个时间轴接就行，不用读 JS。

流程三：自己扩库

- 加风格：在 assets/library/风格提示词/<系列>/ 下放一对文件（X9_名称.md + X9_名称.jpg），同步 assets/library/_统计.json，然后 node tools/verify.mjs 会把对不上的地方指出来。
- 加特效：特效源码不在本仓库，在 pixelfx/ 镜像里：

~~~bash
git clone https://github.com/patch-gg/pixelfx.git pixelfx # 放在本仓库根下即可被自动找到
node tools/build-fx.mjs --previews # 重建索引 + 预览
node tools/verify.mjs # 这次会多跑 6 项源码检查

流程四：手里只有一张图

~~~text
你：这张截图感觉不错，照着它做一段 → anim_extract C:\art\scene.png （拆元素、出 crops/ 与 brief.json） → 看一眼 contact.png （切得对不对，一目了然） → 要出图：把「生图提示词」交给图像模型 → 要代码：把「特效提示词」(canvas + palette) 喂给 anim_fx_search，找相近特效改写 → 要贴图：直接用 crops/NN-<role>.png（透明背景，可当精灵或底图）

它做的是按颜色与轮廓分割，不是物体识别：角色可能被拆成头／身／腿，也可能和背景并成一块。角色标签是启发式的，报告里已如实写明。

4. 目录结构

~~~text
dsh-art/
├── package.json # DSH bundle 声明（dsh.bundle.patch） ├── cordis.patch.yml # 补丁层片段：- insert: [{id: anim-pack, name: dsh-anim-pack}] ├── lib/ │ ├── index.js # 插件入口：20 个工具注册、配置规范化、渲染成文本卡片（1,071 行） │ ├── catalog.js # 本地素材库：索引加载 / 检索 / 抽读 / 导出（164 行） │ ├── refs.js # 参考图库客户端：搜索 / 详情 / 下载（289 行） │ ├── fx.js # 特效库：索引加载 / 检索 / 源码 / 导出小项目（403 行） │ ├── image.js # 图片解码 / 编码：PNG / GIF / BMP / TGA 自写，JPEG 用 vendored jpeg-js（716 行） │ ├── vision.js # 分割与测量：像素画倍率、调色板、背景、元素、构图（1,579 行） │ ├── prompt.js # 把测量结果写成生图提示词 / 特效提示词 / 检索建议（229 行） │ ├── extract.js # 裁剪、接触表、色板图、report.md 与 brief.json（375 行） │ └── vendor/ # jpeg-js 解码器（BSD-3 / Apache-2.0）+ 两份许可原文 ├── assets/ │ ├── catalog.json # 341 条风格索引（脚本生成，别手改） │ ├── library/ # 341 条提示词 md + 193 张静帧 + 示例 + 第三方许可 │ │ ├── 风格提示词/ # A-G / H / K / L / M / O / R / V / X / Z 十个系列 │ │ ├── 示例/ # B6、X7 两组：提示词 + 两个模型的成片 MP4 + 截图 │ │ ├── 第三方许可/ # 三份 MIT 原文 │ │ ├── 许可与来源.md # 素材包本身的使用条款（重要，见第 7 节） │ │ └── 风格挑选.html # 一页看全 341 条的小工具 │ └── fx/ │ ├── catalog.json # 244 条特效索引（tools/build-fx.mjs 生成） │ └── previews/ # 244 张接触表 PNG（每条一张） │ └── extract/ │ ├── preview.png # README 里那张预览图（1600×1000） │ └── scene.png # 预览图用的演示原图，可自己重跑一遍 ├── tools/ │ ├── install.mjs # 装 / 卸 / 自检（junction + 托管补丁块） │ ├── verify.mjs # 自检（有镜像 153 项，无镜像 147 项；--refs 再加 12 项联网） │ ├── build-fx.mjs # 从 pixelfx 镜像重建特效索引与预览 │ └── extract.mjs # 命令行版提取器：node tools/extract.mjs <图片> [--json] ├── docs/ │ ├── fx.md # 特效库指南（导出后怎么用、怎么给非 JS 引擎） │ ├── extract.md # 元素提取指南（量了什么、四类图、参数、局限） │ ├── SKILL.md # 给 Claude Code / Codex 一类 agent 的技能描述 │ ├── attribution.md # 素材与第三方致谢明细 │ ├── rendering.md # 代码动画的时间接口与录 MP4 │ └── AUDIT.md # 本项目的审查报告（优点、风险、已知限制） └── .github/workflows/verify.yml

仓库现实：831 个文件 / 99.1 MB（三个示例 MP4 就占 59.9 MB，244 张预览 23.9 MB，193 张静帧 12.2 MB）。
clone 慢是这个原因，不是代码。

5. 配置（七个键）

写在 profile 的 cordis.patch.yml 里 dsh-anim-pack 那一行下面：

~~~yaml
- insert:
- id: anim-pack
name: dsh-anim-pack
config:
libraryPath: <换成别的素材库> exportDir: <默认 <cwd>/anim-styles> refBase: <参考图库地址> refCacheDir: <参考图缓存目录> refTimeoutMs: 20000 fxPath: <pixelfx 镜像位置> fxExportDir: <默认 <cwd>/pixelfx-fx>

七个键全部可选，不填走缺省。fxPath 的解析顺序是：配置值 → 索引里记的相对路径 → 插件根下的 pixelfx/。
改完刷新页面生效。

6. 自检

~~~bash
node tools/verify.mjs # 离线：有镜像 153 项 / 无镜像 147 项
DSH_REF_BASE=http://你的库 node tools/verify.mjs --refs # 再加 12 项联网

覆盖：20 个工具是否都注册、每个工具是否真能跑、341/193/10 与 244/21/244 的计数与磁盘文件是否一致、索引里的 id 是否都能查到源文件、检索排序、导出是否拒绝写进库内、特效能否在临时目录里真的渲出图，以及「镜像不在时」的降级路径（要给人话，不能崩）。CI（.github/workflows/verify.yml）每次 push 跑一遍。

7. 许可（三种，别混）

| 范围 | 许可 |
| 代码（lib/ tools/ docs/ package.json cordis.patch.yml） | MIT，见 LICENSE |
| 素材（assets/library/：341 条提示词与 193 张静帧） | 原条款：可免费使用、可免费转发；禁止包装成课程 / 付费 skills 或其他收费物出售；来自开源项目的部分保留原许可与署名 |
| pixelfx（assets/fx/，上游 patch-gg/pixelfx） | MIT；其中 sim.js 与约 180 个特效改编自 Sprite Fusion（© 2026 Hugo Duprez），act.js 改编自 Hollow Crown —— 署名见 NOTICE.md |
| 图片解码器（lib/vendor/） | jpeg-js 的 BSD-3-Clause（© 2014 Eugene Ware）＋ 其解码核心的 Apache-2.0（© 2011 notmasteryet）；原文在 lib/vendor/LICENSE-jpeg-js.txt、lib/vendor/LICENSE-apache-2.0.txt |

注意：pixelfx 上游 gallery/ 里那个 PatchPixel 网页字体不是 MIT（© Patch，保留所有权利）；本仓库不包含该字体文件，244 张预览图里的字是渲染工具内置的点阵字体画的。

8. 审查结论

详细报告：docs/AUDIT.md。一句话版：

- 能用、可维护：模块边界清楚（catalog / refs / fx 各管一个数据源）、零依赖、错误信息是人话、导出有防呆（拒绝往库内写）、服务地址不写死。
- 测试是真的：153 项自检里包含「在临时目录里真导出一个小项目并渲出一张图」，也包含「现场画一张合成图 → 编码 → 解码 → 分割 → 裁剪 → 写报告」的整条提取链路，不只是断言文件存在。
- 元素提取是本机算的：一张 720p 图约 0.2–1.1 s，纯 CPU、不联网、零依赖；像素画会先认倍率再分析，裁剪按整数倍放大。
- 风险：① lib/index.js 1,071 行、lib/vision.js 1,579 行，单文件偏大；② 没有 lint / 类型检查； ③ 仓库约 100 MB（三个示例 MP4 占 59.9 MB）；④ 特效索引依赖外部 pixelfx 镜像； ⑤ 特效按 24×38 的人物尺度画，放大会糊；⑥ 元素提取是分割不是识别，角色可能被拆开或与背景合并，标签只是启发式；⑦ JPEG 解码是 vendored 的第三方代码（BSD-3 / Apache-2.0），得跟着它的许可走； ⑧ 不支持 WebP / HEIC / AVIF，要用户先另存 PNG。
- 改进建议与验收记录都在 AUDIT 里。

9. 致谢

- 像素特效与创作方法论：Sprite Fusion / Hugo Duprez（pixel-art-vfx，MIT）与其 "reference first → one line → render and look" 的做法。
- 角色表演层：Hollow Crown（rehan-remade/hollow-crown，MIT）。
- 风格提示词里来自开源项目的部分：code-video（© 2026 Bae-ChangHyun）、 Lemo-Opuscar（© 2026 LemoLab）、mg-styles-15（© 2026 Vincentwei1021），均 MIT。
- JPEG 解码：jpeg-js（© 2014 Eugene Ware，BSD-3-Clause）与其解码核心 notmasteryet JPEGDecoder （© 2011 notmasteryet，Apache-2.0），vendored 在 lib/vendor/。
- 宿主平台：DeepSeek Harness。

dsh-art 是 DeepSeek Harness 的素材包插件。它注册 20 个 anim_* 工具，覆盖四个数据源：341 条代码动画风格提示词（含 193 张参考静帧）、可选的素材参考库客户端、244 个像素特效（含源文件与渲染预览），以及本地图片提取器，把一张图变成元素裁剪、调色板和可直接粘贴的提示词。运行时零依赖。

~~~bash
git clone https://github.com/Liaoyun666/dsh-art.git && cd dsh-art
node tools/install.mjs # junction into the DSH profile + patch entry
node tools/verify.mjs # 153 offline checks (147 without the pixelfx mirror)

代码是 MIT。assets/library/ 下的提示词库保留自己的条款（可免费使用和分享，不得作为课程或付费技能包转售）。特效经 patch-gg/pixelfx 以 MIT 提供。见 NOTICE.md。