dsh-anim-pack
代码动画素材包：341 种风格提示词 / 193 张参考静帧 / 244 条像素特效（pixelfx）/ 远端美术参考图库 + 本地元素提取（把一张图拆成素材、配色与提示词），共 20 个 anim_* 工具。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Liaoyun666/dsh-art#5e9bc9941b907dc71c613a12fb5c03c011877148
Anim Pack 以 dsh-anim-pack 发布，当前版本为 0.4.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
公开仓：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` 现场渲染出来的接触表
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 看看有哪些系列」就该看到东西了。
node tools/install.mjs <profile名>（缺省 desktop，可写绝对路径）。node tools/install.mjs --uninstall。dependencies，npm install 都不用跑。| 工具 | 作用 |
|---|---|
anim_list_series | 列出 10 个系列与条目数，先看家底 |
anim_search | 按关键词 / 系列检索 341 条（多个词＝同时命中，支持直接填编号 B3） |
anim_show | 读某条的完整提示词（Markdown 原文）＋参考静帧路径 |
anim_still | 只取参考静帧图片路径，可直接交给看图工具 |
anim_export | 把提示词（可带静帧）复制到工作目录 anim-styles/<编号>_<名称>/ |
anim_random | 随便抽一条（可限定系列），找灵感用 |
anim_guide | 读出完整使用指南（选型、占位符、时间接口、验收清单） |
| 工具 | 作用 |
|---|---|
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），不在本仓库里。
| 工具 | 作用 |
|---|---|
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 引擎 |
| 工具 | 作用 |
|---|---|
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）。原图也在这个目录里，可以拿去自己跑一遍。
你：帮我做一个「霓虹雨夜，镜头推近，最后定格在招牌」的过场
→ 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 （对着验收清单自检：时间轴、字重、构图、循环）
你：给剑士做一套攻击特效，要能放进像素游戏
→ 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/ 镜像里：git clone https://github.com/patch-gg/pixelfx.git pixelfx # 放在本仓库根下即可被自动找到
node tools/build-fx.mjs --previews # 重建索引 + 预览
node tools/verify.mjs # 这次会多跑 6 项源码检查
你：这张截图感觉不错，照着它做一段
→ anim_extract C:\art\scene.png （拆元素、出 crops/ 与 brief.json）
→ 看一眼 contact.png （切得对不对，一目了然）
→ 要出图：把「生图提示词」交给图像模型
→ 要代码：把「特效提示词」(canvas + palette) 喂给 anim_fx_search，找相近特效改写
→ 要贴图：直接用 crops/NN-<role>.png（透明背景，可当精灵或底图）
它做的是按颜色与轮廓分割，不是物体识别：角色可能被拆成头／身／腿， 也可能和背景并成一块。角色标签是启发式的，报告里已如实写明。
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 慢是这个原因，不是代码。
写在 profile 的 cordis.patch.yml 里 dsh-anim-pack 那一行下面：
- 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/。
改完刷新页面生效。
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 跑一遍。
| 范围 | 许可 |
|---|---|
代码（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 张预览图里的字是渲染工具内置的点阵字体画的。
详细报告：docs/AUDIT.md。一句话版：
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。pixel-art-vfx，MIT）与其
"reference first → one line → render and look" 的做法。rehan-remade/hollow-crown，MIT）。lib/vendor/。dsh-art is an art asset pack plugin for DeepSeek Harness. It registers 20 anim_* tools over four
data sources: 341 code-animation style prompts (with 193 reference stills), an optional art-reference library
client, 244 pixel-art effects with source and rendered previews, and a local image extractor that turns one
picture into element crops, a palette and ready-to-paste prompts. Zero runtime dependencies.
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)
Code is MIT. The prompt library under assets/library/ keeps its own terms (free to use and share, not to be
resold as a course or paid skill pack). Effects are MIT via patch-gg/pixelfx. See NOTICE.md.