novel-art
|
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
Not yet listed on ClawHub or SkillsMP
// README
novel-art
给 AI 短剧出美术设定集:场景 + 叙事道具。前提刻在骨子里:这是 AI 生成,不是实拍——没有堪景、搭景、置景采买,环境和道具都是要被生成几十次还得长一样的资产。交付物不是置景清单,是一致性方案。
场景层:
- 设计意图 — 这个空间为哪场戏存在,不是户型说明
- 一致性锚点(每景 3–5 个) — 每次生成必现的可辨识特征(补丁船篷、断裂的第七块桥板)。观众靠它认场景,QC 靠它核对生成镜头有没有漂
- 光照时段变体 — AI 换时段是重新生成不是重新打灯,每个状态落成完整英文提示词
- 变体机制 —
variantOf+changes把衍生场景挂在母场景上,提示词里写明出图时要拿母场景成图当参考
道具层(只收叙事道具:有特写、跨集、承载剧情,通常 3–8 件):
- 戏剧功能 — 皮箱是全剧悬念、旧砚是爆点实体——先说它在剧里干什么
- 状态变体 — 合上/打开、藏着/摊开:道具有状态弧,每个状态一张参考图
- 尺度参照 — 手持级/桌面级/家具级,英文短语写死进提示词——AI 把手持道具画成家具尺寸是高频事故
- 白底无手 — 道具图要被贴进各种镜头,必须纯白可抠;拿着道具的手是最常见污染
场景陈设归场景锚点、一次性手部道具镜头级提示词解决——都不单独建资产。
产出 art.json + Markdown + 一个双击就能开的 art-report.html。报告界面默认中文;render 加 --lang en 输出全英文界面(或在 art.json 顶层写 "lang": "en",--lang 优先): 英文界面下质量门标签同样翻译(阈值原样),门的失败详情与数据内容保持原文。

质量门:10 道,全是代码
与仓库里另外两个 skill 同一主张:checklist 交给模型自觉是靠不住的。
| 门 | 规则 |
|---|---|
| 一致性锚点 | 3–5 个(场景与道具同规) |
| 光照状态 | 每景 ≥1 且落成英文提示词 |
| 无人 | 反向提示词禁人(场景与道具都查) |
| 提示词语言 | 全部英文 |
| 提示词不含角色名 | validate --cast cast.json 才查;不给就明说跳过 |
| 变体引用完整 | variantOf 指向存在的场景且带 changes |
| 道具状态 | ≥1 且落成英文提示词 |
| 道具尺度 | scale 枚举对应的英文短语必须出现在提示词里 |
| 道具无手 | 反向提示词禁 hands/fingers |
| 道具白底 | 设定图必须 pure white background |
自测里每道门都有击穿用例——证明它真的会拦。
跟另外两个 skill 的接力
novel-outline → outline.json (什么:结构与分集)
novel-characters → cast.json (谁:角色资产)
novel-art → art.json (哪里 + 手里拿的:美术资产)
seed <outline.json>确定性预填场景与道具两张清单,连出现集、承载爽点一起搬;大纲没有props时道具留空,模型按prop-pass.md从原文提取validate --cast <cast.json>用角色表查提示词里有没有混进角色名
命令行直接用
node scripts/novel-art.mjs seed outline.json > art.json # 从大纲预填场景骨架
node scripts/novel-art.mjs validate art.json --cast cast.json
node scripts/novel-art.mjs checkup art.json # 只跑质量门
node scripts/novel-art.mjs render art.json --html # 出报告(界面默认中文)
node scripts/novel-art.mjs render art.json --html --lang en # 英文界面报告
设定图的版面规格
本 skill 不出图,交付的是 image.sheet——一段给出图模型的完整版面指令。出图在下游,
那里要选模型、画风、画幅,这三件事在这一层一个都答不了。
场景和道具各一条,版面都是主视角大图 + 底部和右侧的 L 形细节边框:场景细节格放锚点特写,
道具细节格放锚点特写 + 其他状态 + 侧面。场景无人;道具另加无手、纯白背景。
变体场景的指令里写明要拿母场景成图当参考。完整规格见 references/sheet.md。
文件
SKILL.md 给 agent 读的工作流
scripts/
novel-art.mjs seed / validate / checkup / render / slug
selftest.mjs 151 项断言,不调模型
references/
schema.md art.json 结构 + 硬规则
scene-pass.md 怎么填场景设定(AI 短剧的思路)
prop-pass.md 怎么选、怎么填叙事道具
sheet.md 设定图的版面规格
report-style.md 报告的设计约定
examples/
渡口-art.json 《渡口》三场景 + 两件道具样例,全部质量门通过
assets/
report.webp 报告截图
自测
node scripts/selftest.mjs
151 项断言,覆盖 seed / 10 道门逐项击穿 / 渲染(中英界面)/ 导出。不调模型、不花额度、1 秒跑完。改完脚本先跑这个。
只在 macOS + Node 24 上实测过。 代码没有平台相关调用,Linux 和更低版本 Node 理论上没问题,但没验过。
// HOW IT'S BUILT
// FILES
15 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.
skills/novel-art/SKILL.md8.1 KBe2ab3fafb98aupstream ↗
--- name: novel-art version: 2.0.0 description: | 给 AI 短剧出美术设定集(场景 + 叙事道具):场景的设计意图、一致性锚点、光照时段变体、 空景提示词;道具的戏剧功能、状态变体、尺度参照、白底无手提示词。 产出 art.json + Markdown + 单页评审报告(含导出 JSON)。 为 AI 生成而设计,不是实拍——环境和道具都是生成资产,交付的是让它们跨集长一样的一致性方案; 10 道质量门全部由脚本确定性检查(锚点 3–5、无人无手、白底可抠、尺度短语、提示词英文……)。 有 novel-outline 的 outline.json 就用 seed 预填场景清单与出现集。 零依赖、零 API key、不出图——交付的是提示词,出图在下游。 Use when asked to 场景设定、出场景、环境设定集、场景一致性、scene bibles for AI short drama。 allowed-tools: - Read - Write - Bash - Task - Glob triggers: - novel-art - 美术设定 - 场景设定 - 场景道具 - 出场景 - 道具设定 - 环境设定 - scene bible - prop sheet metadata: license: Apache-2.0 requires: bins: - node # >= 18,只用标准库,无 npm 依赖 runtimes: - claude-code - codex --- ## novel-art 给 AI 短剧出**美术设定集**:场景 + 叙事道具。**前提刻在骨子里:这是 AI 生成,不是实拍**——没有堪景搭景置景采买,环境和道具都是要被生成几十次还得长一样的资产,所以交付物全部围绕一致性: | 交付 | 解决什么 | | --- | --- | | 一致性锚点(每景 3–5 个) | 观众靠它认场景,QC 靠它核对生成镜头有没有漂 | | 光照时段变体 | AI 换时段是重新生成不是重新打灯,每个状态落成完整提示词 | | 空景出图提示词 | 环境和角色是两层资产,参考图里混进人,一致性全毁 | | 变体机制(variantOf) | 生成新景便宜,但变体复用母场景资产更一致 | | 道具状态变体 | 皮箱的合上与打开是两张参考图——道具有状态弧,场景没有 | | 道具尺度参照 | AI 经常把手持道具画成家具尺寸,提示词必须带尺度短语 | | 道具白底无手 | 道具图要被贴进各种镜头,必须可抠;拿着道具的手是最常见污染 | `{baseDir}` = 本文件所在目录。脚本 `{baseDir}/scripts/novel-art.mjs`,零依赖,`node` 直接跑。 **边界(不做的事)**:不做分镜、不写剧本、不管角色(`novel-characters` 的活)、不排大纲(`novel-outline` 的活)。**道具只收叙事道具**(有特写、跨集、承载剧情的,通常 3–8 件)——场景陈设归场景锚点,一次性手部道具镜头级提示词解决,都不单独建资产。 --- ### Step 0 — 定输入 三种输入,优先级从高到低: 1. **outline.json**(novel-outline 的产出)——最优,场景清单、出现集、承载爽点、复用方案都是现成的 2. 小说原文——自己归纳场景清单(主舞台优先,参考 novel-outline 的主场景上限思路:别贪多) 3. 用户手写的场景清单 有 cast.json(novel-characters 的产出)也带上——校验「提示词不含角色名」要用。 ### Step 1 — seed 骨架(有 outline.json 才有这步) ```bash node {baseDir}/scripts/novel-art.mjs seed <outline.json> > <workdir>/art.json ``` 确定性搬运:场景 id/名称/主场景标记/出现集/承载爽点,带复用方案的场景会有 `seedNote` 提示做成变体。**这些事实不要让模型重新想一遍。** 没有 outline.json 就自己按 `references/schema.md` 建清单。 ### Step 2 — 逐场景填设定 + 提取叙事道具 每个场景一份,能并发就并发。每份任务拿到: - `{baseDir}/references/scene-pass.md` 和 `{baseDir}/references/schema.md`(读它们,照着做) - 该场景的骨架 + 原文/大纲里关于这个空间的全部信息 - **同批其他场景的名字**(空间气质要区分开,别都写成同一种破旧) 核心要求都在 scene-pass.md 里,最重的三条:锚点要**可画可认可核对**(「补丁船篷」是锚点,「陈旧的氛围」是形容词);光照状态**从分集反推**,不写用不上的全家桶;**能做变体就别开新景**。 **叙事道具优先吃大纲**:`outline.json` 从 1.1.0 起带 `props`,`seed` 会把道具表连同「承载什么」「托起哪几个爽点」「哪几集出现」一起搬过来,这一层只填设计字段(尺度、锚点、状态变体、白底提示词)。**大纲没有 props 就从原文提取**,那时这步是模型的活:只收**有特写、跨集出现、承载剧情**的,通常 3–8 件,跟主角数量一个量级。每件按 `references/prop-pass.md` 填:戏剧功能、锚点、状态变体、尺度、白底无手提示词。皮箱这种「跟人走的道具」就该在这——塞进场景锚点和角色画像都不对。 ### Step 3 — 校验 ⛔ 不能跳 ```bash node {baseDir}/scripts/novel-art.mjs validate <art.json> --cast <cast.json> ``` 10 道质量门全是代码。场景 + 共用 6 道:锚点 3–5、光照状态 ≥1、**无人**、提示词全英文、不含角色名(给了 --cast 才查)、变体引用完整。道具专属 4 道:**状态 ≥1**、**尺度短语写进提示词**、**反向词禁手**、**设定图纯白背景**。 **有违规逐条修,改完重跑,直到通过。** ### Step 4 — 输出与汇报 ```bash cd <输出目录> node {baseDir}/scripts/novel-art.mjs render <剧名>-art.json --md > <剧名>-art.md node {baseDir}/scripts/novel-art.mjs render <剧名>-art.json --html > art-report.html ``` 报告界面默认中文;用户要英文界面就加 `--lang en`(或在 art.json 顶层写 `"lang": "en"`,`--lang` 优先)。`render` 默认去 art.json 同级的 `images/<slug>-sheet.png` 找图(场景和道具都找),图在别处就用 `--images <目录>` 指过去——**本 skill 不产生这些文件**,下游出完图重跑一次 render 就能嵌进报告。报告含:KPI 带、场景清单、场景设定卡、道具清单、道具设定卡(锚点核对表 / 状态变体 / 提示词包全带复制按钮)、质量门面板、导出 JSON(下载的就是 art.json 原样)。 汇报一句话说清:几个场景(主场景/变体各几)、几件道具、锚点总数、报告路径;没过的门明说。 **不要说「已出图」**——这一步不存在了,交付的是提示词。 最终落地: ``` <输出目录>/ ├── <剧名>-art.json ├── <剧名>-art.md ├── art-report.html ← 双击就能开 └── images/ ← 本 skill 不写这个目录 └── <slug>-sheet.png ← 下游出完图放这儿,render 会捡起来 ``` --- ## 三个 skill 的接力 ``` novel-outline → outline.json (什么:结构与分集) novel-characters → cast.json (谁:角色资产) novel-art → art.json (哪里 + 手里拿的:美术资产) ``` seed 吃 outline.json 的场景与道具两块(大纲没有 `props` 时道具留空,模型从原文提取),`--cast` 吃 cast.json。三份 JSON 各自的报告都带导出按钮,改完都能喂回各自的 render/validate。 ## 边界 - 报告界面内置中英(`--lang`,默认中文、或跟 art.json 的 `lang` 字段);出图提示词永远英文 - **本 skill 不出图。**`image.sheet` 是给下游的版面指令,版面规格见 `references/sheet.md` - 场景数量不设硬上限——上限在 novel-outline 的主场景门那里管;这里管的是每个资产的质量 - 道具只收叙事道具,3–8 件为宜——每多一件就多一份跨集一致性维护 ## 自测 ```bash node {baseDir}/scripts/selftest.mjs ``` 151 项断言,不调模型、不花额度。10 道质量门每一道都有击穿用例。改完脚本先跑这个。 ## 自带样例 `{baseDir}/examples/渡口-art.json`:《渡口》三场景 + 两件叙事道具(旧皮箱、县衙旧砚)的完整设定,全部质量门通过(含对着 novel-characters 样例 cast 的角色名检查)。当质量基准,也是自测夹具。skills/novel-art/README.md5.6 KB27d29a5bbd67upstream ↗
[](README.md) [](README.en.md) [](https://x.com/eternityspring) # novel-art 给 AI 短剧出**美术设定集**:场景 + 叙事道具。前提刻在骨子里:**这是 AI 生成,不是实拍**——没有堪景、搭景、置景采买,环境和道具都是要被生成几十次还得长一样的资产。交付物不是置景清单,是一致性方案。 **场景层**: - **设计意图** — 这个空间为哪场戏存在,不是户型说明 - **一致性锚点**(每景 3–5 个) — 每次生成必现的可辨识特征(补丁船篷、断裂的第七块桥板)。观众靠它认场景,QC 靠它核对生成镜头有没有漂 - **光照时段变体** — AI 换时段是**重新生成不是重新打灯**,每个状态落成完整英文提示词 - **变体机制** — `variantOf` + `changes` 把衍生场景挂在母场景上,提示词里写明出图时要拿母场景成图当参考 **道具层**(只收**叙事道具**:有特写、跨集、承载剧情,通常 3–8 件): - **戏剧功能** — 皮箱是全剧悬念、旧砚是爆点实体——先说它在剧里干什么 - **状态变体** — 合上/打开、藏着/摊开:道具有状态弧,每个状态一张参考图 - **尺度参照** — 手持级/桌面级/家具级,英文短语写死进提示词——AI 把手持道具画成家具尺寸是高频事故 - **白底无手** — 道具图要被贴进各种镜头,必须纯白可抠;拿着道具的手是最常见污染 场景陈设归场景锚点、一次性手部道具镜头级提示词解决——都不单独建资产。 产出 `art.json` + Markdown + 一个双击就能开的 `art-report.html`。报告界面默认中文;render 加 `--lang en` 输出全英文界面(或在 art.json 顶层写 `"lang": "en"`,`--lang` 优先): 英文界面下质量门标签同样翻译(阈值原样),门的失败详情与数据内容保持原文。  ## 质量门:10 道,全是代码 与仓库里另外两个 skill 同一主张:**checklist 交给模型自觉是靠不住的**。 | 门 | 规则 | | --- | --- | | 一致性锚点 | 3–5 个(场景与道具同规) | | 光照状态 | 每景 ≥1 且落成英文提示词 | | **无人** | 反向提示词禁人(场景与道具都查) | | 提示词语言 | 全部英文 | | 提示词不含角色名 | `validate --cast cast.json` 才查;不给就**明说跳过** | | 变体引用完整 | `variantOf` 指向存在的场景且带 `changes` | | **道具状态** | ≥1 且落成英文提示词 | | **道具尺度** | scale 枚举对应的英文短语必须出现在提示词里 | | **道具无手** | 反向提示词禁 hands/fingers | | **道具白底** | 设定图必须 pure white background | 自测里每道门都有**击穿用例**——证明它真的会拦。 ## 跟另外两个 skill 的接力 ``` novel-outline → outline.json (什么:结构与分集) novel-characters → cast.json (谁:角色资产) novel-art → art.json (哪里 + 手里拿的:美术资产) ``` - `seed <outline.json>` 确定性预填场景与道具两张清单,连出现集、承载爽点一起搬;大纲没有 `props` 时道具留空,模型按 `prop-pass.md` 从原文提取 - `validate --cast <cast.json>` 用角色表查提示词里有没有混进角色名 ## 命令行直接用 ```bash node scripts/novel-art.mjs seed outline.json > art.json # 从大纲预填场景骨架 node scripts/novel-art.mjs validate art.json --cast cast.json node scripts/novel-art.mjs checkup art.json # 只跑质量门 node scripts/novel-art.mjs render art.json --html # 出报告(界面默认中文) node scripts/novel-art.mjs render art.json --html --lang en # 英文界面报告 ``` ## 设定图的版面规格 **本 skill 不出图**,交付的是 `image.sheet`——一段给出图模型的完整版面指令。出图在下游, 那里要选模型、画风、画幅,这三件事在这一层一个都答不了。 场景和道具各一条,版面都是**主视角大图 + 底部和右侧的 L 形细节边框**:场景细节格放锚点特写, 道具细节格放锚点特写 + 其他状态 + 侧面。场景**无人**;道具另加**无手、纯白背景**。 变体场景的指令里写明要拿母场景成图当参考。完整规格见 `references/sheet.md`。 ## 文件 ``` SKILL.md 给 agent 读的工作流 scripts/ novel-art.mjs seed / validate / checkup / render / slug selftest.mjs 151 项断言,不调模型 references/ schema.md art.json 结构 + 硬规则 scene-pass.md 怎么填场景设定(AI 短剧的思路) prop-pass.md 怎么选、怎么填叙事道具 sheet.md 设定图的版面规格 report-style.md 报告的设计约定 examples/ 渡口-art.json 《渡口》三场景 + 两件道具样例,全部质量门通过 assets/ report.webp 报告截图 ``` ## 自测 ```bash node scripts/selftest.mjs ``` 151 项断言,覆盖 seed / 10 道门逐项击穿 / 渲染(中英界面)/ 导出。不调模型、不花额度、1 秒跑完。改完脚本先跑这个。 **只在 macOS + Node 24 上实测过。** 代码没有平台相关调用,Linux 和更低版本 Node 理论上没问题,但**没验过**。skills/novel-art/references/test-fixtures/upstream/README.md481 B85238323304eupstream ↗
# 上游产物夹具 这几份 JSON 是上游 skill 样例的**拷贝**,只给 `scripts/selftest.mjs` 当输入使用,让本 skill 单独拷走也能跑自测。 - `渡口-cast.json` ← `novel-characters/examples/渡口-cast.json` - `渡口-outline.json` ← `novel-outline/examples/渡口-outline.json` - 它们不是本 skill 的样例,不要在文档里当样例引用 - 上游样例改了字段,这里不会自动跟上。需要时整份重新拷贝,再跑自测skills/novel-art/scripts/novel-art.mjs49 KB8d16b2b1cc5fupstream ↗
Contents are not inlined in the catalog. Open the upstream file.
skills/novel-art/scripts/selftest.mjs19 KB20082b6c2cbcupstream ↗
#!/usr/bin/env node // 自测:覆盖 novel-art.mjs 里所有确定性逻辑(场景 + 道具)。 // 不调用任何模型,不花额度,跑一次 < 1 秒。 // node scripts/selftest.mjs import assert from 'node:assert/strict'; import { readFileSync } from 'node:fs'; import { dirname, join } from 'node:path'; import { fileURLToPath } from 'node:url'; import { ANCHOR_RANGE, castNamesOf, gateReport, renderHtml, renderMarkdown, seedFromOutline, slug, PROP_SCALES, validateArt, } from './novel-art.mjs'; const here = dirname(fileURLToPath(import.meta.url)); const FIXTURE = JSON.parse(readFileSync(join(here, '..', 'examples', '渡口-art.json'), 'utf8')); const OUTLINE = JSON.parse( readFileSync(join(here, '..', 'references', 'test-fixtures', 'upstream', '渡口-outline.json'), 'utf8'), ); const CAST = JSON.parse( readFileSync(join(here, '..', 'references', 'test-fixtures', 'upstream', '渡口-cast.json'), 'utf8'), ); let passed = 0; function ok(cond, msg) { assert.ok(cond, msg); passed++; } function eq(actual, expected, msg) { assert.strictEqual(actual, expected, `${msg} — 期望 ${expected},实际 ${actual}`); passed++; } const clone = () => JSON.parse(JSON.stringify(FIXTURE)); const gate = (d, id, names = null) => gateReport(d, names).find((g) => g.id === id); /* ---------------- 画风 ---------------- */ // 画风是出图那一刻才定的,整批共用一段风格指令由调用方附加。写进单条提示词, // 换风格就要逐条改,而且跟当时选的那一档正面打架。 { const assets = [...FIXTURE.scenes, ...FIXTURE.props]; for (const k of [/semi-?realistic/i, /painterly/i, /concept art/i, /\bphotoreal/i]) { ok( assets.every((a) => !k.test(`${a.image.sheet} ${a.image.tags.join(' ')}`)), `提示词里不写画风:${k.source}`, ); } // 反向提示词禁的是「假」,不是某一档画风——出图时选的可能正是它 ok( assets.every((a) => !/photorealistic|3d render|\banime\b/i.test(a.image.negativePrompt)), 'negativePrompt 不禁画风词', ); // 表面处理留着,但是两档二选一:它讲的是这个空间被谁在用、保养到什么程度, // 是关于这个对象的事实,不是一句对谁都成立的常量。原来这里钉死了 A 档,于是 // 金銮殿也拿到「漆面剥落、水渍」——跟「每条提示词必须逐字包含同一句画风」 // 是同一个错误,只是换了个词。 ok( assets.every((a) => /Weathered, lived-in materials|Well-kept, actively maintained materials/ .test(a.image.sheet)), '表面处理句整段保留(日常使用 / 持续维护 二选一)', ); } /* ---------------- slug ---------------- */ eq(slug('渡船船舱'), '渡船船舱', '中文场景名保留'); eq(slug('军区总院·中医独立诊室'), '军区总院-中医独立诊室', '间隔号替换'); eq(slug('a/b:c'), 'a-b-c', '危险字符替换'); /* ---------------- seed ---------------- */ const seeded = seedFromOutline(OUTLINE); eq(seeded.source, '渡口', 'seed 带书名'); eq(seeded.scenes.length, 3, 'seed 搬全部场景'); { const s01 = seeded.scenes.find((s) => s.id === 'S01'); eq(s01.usage.episodes.join(','), '1,2,3,4,5,6', 'seed 算出出现集'); eq(s01.usage.beats.join(','), '悬念钩,身份揭破,反转,收束', 'seed 算出承载爽点'); eq(s01.summary, '', '设计字段留给模型填'); const s03 = seeded.scenes.find((s) => s.id === 'S03'); ok(s03.seedNote?.includes('复用方案'), 'outline 的 reusePlan 变成 seedNote 提示做变体'); ok(!seeded.scenes.find((s) => s.id === 'S01').seedNote, '没有复用方案的场景不带 seedNote'); } { // 道具:大纲从 1.1.0 起带 props,seed 要吃到 eq(seeded.props.length, OUTLINE.props.length, 'seed 搬全部道具'); const p01 = seeded.props.find((pr) => pr.id === 'P01'); const src = OUTLINE.props.find((pr) => pr.id === 'P01'); eq(p01.name, src.name, '道具名从大纲搬过来'); // 两边指的是同一件事:这件物件在戏里干什么,不是材质描述 eq(p01.summary, src.function, '大纲的 function 落成这里的 summary'); const epsWithP01 = OUTLINE.episodes.filter((e) => (e.propIds ?? []).includes('P01')).map((e) => e.ep); eq(p01.usage.episodes.join(','), epsWithP01.join(','), 'seed 算出道具的出现集'); // beatIds 是 id,art 这边要的是爽点类型,seed 负责翻译 eq(p01.usage.beats.join(','), src.beatIds.map((id) => OUTLINE.beats.find((b) => b.id === id).type).join(','), 'beatIds 翻译成爽点类型'); // 设计字段留给模型 eq(p01.scale, '', '尺度留空——那是美术层的活'); eq(p01.states.length, 0, '状态变体留空'); eq(p01.image.prompt, '', '出图提示词留空'); eq(p01.carriedBy.length, 0, '跟谁走留空'); } // 旧大纲没有 props 字段:返回空数组,模型照 prop-pass.md 从原文提取,跟以前一样 { const noProps = JSON.parse(JSON.stringify(OUTLINE)); delete noProps.props; const r = seedFromOutline(noProps); eq(r.props.length, 0, '旧大纲 seed 出空道具表,不是 undefined'); ok(Array.isArray(r.props), '空道具表仍然是数组,调用方不用判空'); } ok(seedFromOutline({}).scenes.length === 0, '空大纲不炸'); ok(seedFromOutline({}).props.length === 0, '空大纲的道具表也是空数组'); /* ---------------- castNamesOf ---------------- */ const NAMES = castNamesOf(CAST); ok(NAMES.includes('沈知微') && NAMES.includes('老周'), 'cast 名字提出来了'); ok(NAMES.includes('老伯'), '别名也提出来了'); ok(castNamesOf({ characters: [] }).length === 0, '空 cast 不炸'); /* ---------------- 夹具本身 ---------------- */ eq(validateArt(FIXTURE, NAMES).length, 0, '自带样例通过校验(含角色名检查)'); ok(gateReport(FIXTURE, NAMES).every((g) => g.ok), '样例全部质量门通过'); eq(gateReport(FIXTURE).length, 10, '质量门共 10 道(场景 6 + 道具 4)'); /* ---------------- 质量门逐项击穿 ---------------- */ // 每一道门都要证明它真的会拦——不然就是永远为真的假测试 // G1 锚点 3–5 eq(ANCHOR_RANGE.join('-'), '3-5', '锚点范围 3–5'); { const d = clone(); d.scenes[0].anchors = d.scenes[0].anchors.slice(0, 2); ok(!gate(d, 'anchors').ok, '锚点只有 2 个被拦'); ok(gate(d, 'anchors').detail.includes('渡船船舱'), '报错点名场景'); } { const d = clone(); d.scenes[0].anchors = Array.from({ length: 6 }, (_, i) => ({ name: `锚${i}`, desc: 'x' })); ok(!gate(d, 'anchors').ok, '锚点 6 个也被拦——QC 核对不过来'); } // G3 光照状态 { const d = clone(); d.scenes[2].lighting = []; ok(!gate(d, 'lighting').ok, '没有光照状态被拦——换时段是重新生成不是重新打灯'); } // G4 空景 { const d = clone(); d.scenes[0].image.negativePrompt = 'plastic CG look, text, watermark'; ok(!gate(d, 'no-people').ok, '反向提示词没禁人被拦——环境参考图必须空景'); } // G5 提示词英文 { const d = clone(); d.scenes[0].image.prompt = '一条老木船的客舱'; ok(!gate(d, 'english').ok, '主提示词写中文被拦'); } { const d = clone(); d.scenes[0].lighting[0].prompt = '浓雾平光'; ok(!gate(d, 'english').ok, '光照提示词写中文也被拦'); } // G6 提示词不含角色名 { const d = clone(); d.scenes[0].image.prompt += ' where 老周 stands'; ok(!gate(d, 'no-names', NAMES).ok, '提示词里出现角色名被拦'); ok(gate(d, 'no-names', NAMES).detail.includes('老周'), '报错点名是谁'); ok(gate(d, 'no-names').ok, '没给 cast 时这道门跳过(视为通过)'); ok(gate(d, 'no-names').detail.includes('跳过'), '跳过时明说,不装作查过'); } { const d = clone(); d.scenes[1].lighting[0].prompt += ' with 老伯 in frame'; ok(!gate(d, 'no-names', NAMES).ok, '别名也拦(光照提示词同样查)'); } // G7 变体引用 { const d = clone(); d.scenes[2].variantOf = 'S99'; ok(!gate(d, 'variants').ok, '指向不存在的母场景被拦'); } { const d = clone(); d.scenes[2].variantOf = 'S03'; ok(!gate(d, 'variants').ok, '自己指自己被拦'); } { const d = clone(); delete d.scenes[2].changes; ok(!gate(d, 'variants').ok, '变体缺 changes 被拦——不说改了什么等于没说'); } /* ---------------- validate 结构检查 ---------------- */ ok(validateArt(null).length === 1, 'null 直接报'); ok(validateArt({}).some((x) => x.includes('source')), '缺书名被拦'); { const d = clone(); d.scenes[0].id = 'X1'; ok(validateArt(d).some((x) => x.includes('S01 这种格式')), '场景 id 格式被拦'); } { const d = clone(); d.scenes[1].id = 'S01'; ok(validateArt(d).some((x) => x.includes('重复')), '场景 id 重复被拦'); } { const d = clone(); d.scenes[0].summary = ' '; ok(validateArt(d).some((x) => x.includes('summary')), '缺设计意图被拦'); } { const d = clone(); delete d.scenes[0].primary; ok(validateArt(d).some((x) => x.includes('primary')), '缺主场景标记被拦'); } { const d = clone(); d.scenes[0].anchors[0] = { name: '只有名字' }; ok(validateArt(d).some((x) => x.includes('锚点缺')), '锚点缺描述被拦'); } { const d = clone(); d.scenes[0].lighting[0] = { state: '夜戏' }; ok(validateArt(d).some((x) => x.includes('夜戏')), '光照缺提示词被拦且点名状态'); } { const d = clone(); delete d.scenes[0].image.sheet; ok(validateArt(d).some((x) => x.includes('image.sheet')), '缺设定图提示词被拦'); } { const d = clone(); d.scenes[0].usage = { episodes: 'not-array', beats: [] }; ok(validateArt(d).some((x) => x.includes('usage.episodes')), 'usage 结构错被拦'); } /* ---------------- render markdown ---------------- */ const md = renderMarkdown(FIXTURE); ok(md.startsWith('# 渡口 · 美术设定集'), 'MD 标题'); ok(md.includes('## 场景清单'), 'MD 有场景清单'); ok(md.includes('变体 ← S02'), 'MD 清单标出变体来源'); ok(md.includes('## S01 渡船船舱'), 'MD 每场景一节'); ok(md.includes('一致性锚点'), 'MD 有锚点'); ok(md.includes('**补丁船篷**'), 'MD 锚点带名字'); ok(!md.includes('定机位'), 'MD 不再有定机位库——AI 生产的空间锚在参考图不在文字'); ok(md.includes('光照与时段'), 'MD 有光照状态'); ok(md.includes('```text'), 'MD 提示词进代码块'); /* ---------------- render html ---------------- */ const html = renderHtml(FIXTURE); ok(html.startsWith('<!doctype html>'), 'HTML 完整文档'); ok(!/<script\s+src=/.test(html), '不引外部脚本'); ok(!/<link\s/.test(html), '不引外部样式'); ok(!/@import|url\(https?:/.test(html), 'CSS 不拉外部资源'); ok(/<script\s+src=/.test('<script src="x.js">'), '外部脚本检测正则有效'); eq((html.match(/class="kpi[ "]/g) || []).length, 4, 'KPI 带 4 张卡(场景/道具/锚点/光照)'); ok(html.includes('主场景 2 · 变体 1'), 'KPI 场景卡带分类'); ok(html.includes('叙事道具'), 'KPI 有叙事道具卡'); eq((html.match(/class="scene" /g) || []).length, 5, '5 张设定卡(3 场景 + 2 道具)'); ok(html.includes('>场景清单<') && html.includes('>场景设定卡<') && html.includes('>道具清单<') && html.includes('>道具设定卡<') && html.includes('>质量门<'), '五个区块都在'); ok(html.indexOf('>场景设定卡<') < html.indexOf('>道具清单<') && html.indexOf('>道具设定卡<') < html.indexOf('>质量门<'), '道具在场景后、质量门前'); ok(html.indexOf('>场景清单<') < html.indexOf('>场景设定卡<'), '清单在卡片前'); eq((html.match(/class="anchors"/g) || []).length, 5, '每张卡有锚点列表(3 场景 + 2 道具)'); ok(html.includes('变体来源:<b>S02</b>'), '变体卡标母场景'); ok(html.includes('plate-empty'), '没出图时有占位'); ok(html.includes('class="cards"'), '设定卡一排两张的网格'); ok(/\.cards\{[^}]*grid-template-columns:1fr 1fr/.test(html), '两列布局'); // 点图弹层 ok(html.includes('class="lightbox"'), '有图片弹层'); ok(/closeLb\(\)/.test(html), '弹层能关闭'); ok(/e\.key === 'Escape'/.test(html), 'Esc 关闭弹层'); { const d = clone(); d.scenes[0].sheetImage = 'images/x-sheet.png'; const withImg = renderHtml(d); ok(withImg.includes('class="zoom" data-src="images/x-sheet.png"'), '出图后图片可点,弹层拿到地址'); ok(withImg.includes('cursor:zoom-in'), '鼠标提示可放大'); } eq((html.match(/<li class="ok">/g) || []).length, 10, '10 道质量门全 ✓'); ok(html.includes('gatepill pass'), '页眉徽章通过态'); ok(html.includes('未提供 cast.json'), '报告如实标注角色名检查被跳过'); // 质量门失败也要渲染 { const d = clone(); d.scenes[0].anchors = []; const bad = renderHtml(d); ok(bad.includes('gatepill fail'), '失败时页眉徽章变红'); ok(bad.includes('class="galert"'), '失败时弹病灶横幅'); ok(bad.includes('<li class="bad">'), '未过的门标 ✗'); } // 导出:内嵌的就是 art.json 原样 ok(html.includes('<script type="application/json" id="art-data">'), '数据内嵌'); ok(html.includes('data-name="渡口-art.json"'), '下载文件名跟书名(art.json)'); { const embedded = html.match(/<script type="application\/json" id="art-data">([\s\S]*?)<\/script>/)[1]; const round = JSON.parse(embedded.replace(/\</g, '<')); eq(JSON.stringify(round), JSON.stringify(FIXTURE), '导出数据与 art.json 逐字节一致'); eq(validateArt(round, NAMES).length, 0, '导出数据能直接喂回 validate'); } ok(html.includes('revokeObjectURL(url), 10000'), 'blob 延后回收——Safari 抢跑会存出空文件'); // XSS:数据是模型生成的,一律转义 { const d = clone(); d.scenes[0].name = '<img src=x onerror=alert(1)>'; d.scenes[0].anchors[0].desc = '<b>粗体</b>'; const evil = renderHtml(d); ok(!evil.includes('<img src=x'), '场景名里的 HTML 被转义'); ok(!evil.includes('<b>粗体</b>'), '锚点描述里的 HTML 被转义'); } // </script 会截断内嵌数据块 { const d = clone(); d.scenes[0].summary = '他说</script><script>alert(1)</script>了吗'; const x = renderHtml(d).match(/id="art-data">([\s\S]*?)<\/script>/)[1]; ok(!x.includes('</script'), '数据块里的 </script 被转义'); eq(JSON.parse(x.replace(/\</g, '<')).scenes[0].summary, d.scenes[0].summary, '转义了但内容没丢'); } ok(html.includes('@media print'), '可打印'); ok(html.includes('prefers-reduced-motion'), '尊重减少动效'); ok(/@media print\{[\s\S]*\.pr p\{display:block!important/.test(html), '打印时提示词全展开'); ok(html.includes('参考图一律无人'), '页脚写明无人原则(道具另加无手白底)'); /* ---------------- 道具(叙事道具层)---------------- */ eq(Object.keys(PROP_SCALES).join(','), '手持级,桌面级,家具级', '尺度三档'); eq(FIXTURE.props.length, 2, '样例带两件叙事道具'); // 道具四道门逐项击穿 { const d = clone(); d.props[0].states = []; ok(!gate(d, 'prop-states').ok, '道具没有状态被拦——合上和打开是两张参考'); } { const d = clone(); d.props[0].scale = '巨型'; ok(!gate(d, 'prop-scale').ok, '未知尺度被拦'); } { const d = clone(); d.props[0].image.prompt = d.props[0].image.prompt.replace('handheld scale', 'nice size'); ok(!gate(d, 'prop-scale').ok, '提示词缺尺度短语被拦——AI 会把手持道具画成家具'); ok(gate(d, 'prop-scale').detail.includes('handheld scale'), '报错点名缺哪个短语'); } { const d = clone(); d.props[1].image.negativePrompt = 'people, plastic CG look, text'; ok(!gate(d, 'prop-hands').ok, '反向提示词没禁手被拦——拿着道具的手是最常见污染'); } { const d = clone(); d.props[0].image.sheet = d.props[0].image.sheet.replace(/pure white background/gi, 'soft grey backdrop'); ok(!gate(d, 'prop-white').ok, '设定图不是白底被拦——道具图要能抠'); } // 共用门也覆盖道具 { const d = clone(); d.props[0].anchors = d.props[0].anchors.slice(0, 1); ok(!gate(d, 'anchors').ok, '道具锚点不足也被锚点门拦'); } { const d = clone(); d.props[0].states[0].prompt = '合上的皮箱'; ok(!gate(d, 'english').ok, '道具状态提示词写中文被英文门拦'); } { const d = clone(); d.props[0].image.prompt += ' carried by 沈知微'; ok(!gate(d, 'no-names', NAMES).ok, '道具提示词出现角色名被拦'); } // 道具没有光照门的义务 { const d = clone(); ok(gate(d, 'lighting').ok, '道具不查光照——那是场景的门'); } // 结构检查 { const d = clone(); d.props[0].id = 'X1'; ok(validateArt(d).some((x) => x.includes('P01 这种格式')), '道具 id 格式被拦'); } { const d = clone(); d.props[1].id = 'P01'; ok(validateArt(d).some((x) => x.includes('道具 id P01 重复')), '道具 id 重复被拦'); } { const d = clone(); d.props[0].relatedScenes = ['S99']; ok(validateArt(d).some((x) => x.includes('S99 不存在')), '道具关联不存在的场景被拦'); } { const d = clone(); d.props[0].states[0] = { state: '合上' }; ok(validateArt(d).some((x) => x.includes('合上')), '状态缺提示词被拦且点名'); } // 无道具的文档:道具门放行、报告不渲染道具区块 { const d = clone(); delete d.props; eq(validateArt(d, NAMES).length, 0, '没有道具块也合法——道具是可选层'); ok(gateReport(d).filter((g) => g.id.startsWith('prop-')).every((g) => g.ok), '无道具时四道道具门放行'); ok(!renderHtml(d).includes('>道具清单<'), '无道具时报告不渲染道具区块'); } // 渲染 { ok(md.includes('## 道具清单'), 'MD 有道具清单'); ok(md.includes('## P01 旧皮箱'), 'MD 每件道具一节'); ok(md.includes('状态变体'), 'MD 有状态变体'); ok(html.includes('>P01<') || html.includes('P01'), 'HTML 道具卡有 ID'); ok(html.includes('手持级'), 'HTML 道具卡带尺度徽章'); ok(html.includes('关联场景:<b>S01</b>'), 'HTML 道具卡带关联场景'); } /* ---------------- render 英文界面(--lang en)---------------- */ { const en = renderHtml(FIXTURE, 'en'); ok(en.includes('lang="en"'), '英文报告 <html lang="en">'); ok(en.includes('Export JSON'), '英文报告有 Export JSON'); ok(en.includes('>Scene list<'), '英文报告有 Scene list'); ok(en.includes('>Quality gates<'), '英文报告有 Quality gates 区块'); ok(en.includes('Consistency anchors'), '英文报告有 Consistency anchors'); ok(!en.includes('导出 JSON'), '英文报告不含「导出 JSON」'); ok(!en.includes('场景清单'), '英文报告不含「场景清单」'); ok(!en.includes('质量门'), '英文报告不含「质量门」(门的中文 label 属于质量门层,不在界面表里)'); ok(html.includes('lang="zh"'), '默认报告仍是 <html lang="zh">'); ok(renderMarkdown(FIXTURE, 'en').includes('## Scene list'), 'MD 英文界面有 Scene list'); } { const d = clone(); d.lang = 'en'; ok(renderHtml(d).includes('lang="en"'), 'art.json 顶层 lang 字段生效'); ok(renderHtml(d, 'zh').includes('lang="zh"'), '--lang 优先于 lang 字段'); } { let threw = false; try { renderHtml(FIXTURE, 'jp'); } catch { threw = true; } ok(threw, '非内置语言直接抛错(目前内置 zh / en)'); } // 质量门面板是报告的一部分:英文界面下门标签也要翻译(阈值由门自己算,原样保留) { const gateEn = renderHtml(FIXTURE, 'en'); ok(gateEn.includes('Consistency anchors, 3–5'), 'EN 报告的质量门标签翻译且阈值原样保留'); ok(!gateEn.includes('一致性锚点 3–5 个'), 'EN 报告不再出现中文门标签'); } console.log(`✓ ${passed} 项自测全部通过`);skills/novel-art/references/prop-pass.md3.4 KBf38e93afd0e9upstream ↗
# 道具设定 · 怎么填 给你原文/大纲里与道具相关的全部信息,先**选**再**填**。**只输出 JSON,不要解释、不要围栏。**结构见 `schema.md` 的 props 段。 ## 先选:什么配当叙事道具 三个条件**同时满足**才入选:**有特写、跨集出现、承载剧情**。一部剧通常 3–8 件,跟主角数量一个量级。 | 类型 | 归属 | 例子 | | --- | --- | --- | | **叙事道具** | 入选,单独建资产 | 皮箱(全剧悬念)、旧砚(爆点实体) | | 场景陈设 | 场景锚点已覆盖,不入选 | 铜铃、纸灯笼、系缆石桩 | | 一次性手部道具 | 镜头级提示词解决,不入选 | 一碗茶、一份报纸 | 拿不准就问一句:这件东西被镜头怼着拍过吗?观众记得住它吗?剧情少了它转不动吗?三个都不是就不入选。 ## 硬规则 1. **道具的形制按本剧朝代写。**`art.json` 顶层的 `dynasty` 已经定好了,直接沿用——器型、材质、工艺、纹样、装裱方式都有朝代差别,一件道具漂一个世纪,跟它同框的场景就穿帮了。**不许写「古代」这类含糊词**(理由见 `scene-pass.md` 第 1 条)。还没有 `dynasty` 时,从现有场景里推断一个具体的。 2. **`summary` 写戏剧功能,不写商品描述。**「谁碰翻谁的脸的悬念核心」是戏剧功能;「棕色牛皮材质」只是材质。先说它在剧里干什么。 3. **锚点要经得起特写。**道具的锚点比场景的更小更细:绿锈铜扣上的一道新划痕、墨池边的月牙磨痕。特写镜头会把这些放大到全屏,**缺了立刻穿帮,多了核对不过来**——照旧 3–5 个。 4. **状态变体从剧情反推。**皮箱有合上/打开,状纸有藏着/摊开——道具的状态弧跟着剧情走,每个状态一条英文提示词,会各生成一张参考。没有状态变化的道具写一个主状态即可。 5. **尺度必须写死。**`scale` 三档(手持级/桌面级/家具级),`image.prompt` 和 `image.sheet` 里**必须出现对应英文短语**(handheld scale / tabletop scale / furniture scale)——AI 把手持道具画成家具尺寸是高频事故,validate 会对着查。 6. **白底、无人、无手。**道具参考图要被贴进各种镜头,必须纯白背景可抠;**拿着道具的手是最常见的污染**,反向提示词必须禁 hands/fingers。validate 三样都查。 7. **关联要挂上。**`relatedScenes` 挂它主要出现的场景(id 必须存在),`carriedBy` 写谁带着它(自由文本)。这两样进报告,是排生成任务时查「这场戏桌上该有什么」的索引。 8. **提示词永远英文,绝不出现角色名**——图像模型会把它认识的名字画进去。表面处理句跟场景是同一套两档,照抄 `scene-pass.md` 里「要整段带上的是表面处理」那两段之一——按这件东西的保养水平选,御赐的印信和船家的竹篙不是同一档;画风同样不写进提示词。 ## 输入格式 ``` 候选道具线索(从原文/大纲摘出): - 沈知微始终抱着一只旧皮箱,指节发白(第 1–6 集,开箱是收束爆点) - 陆行远口袋里的硬东西,第 3 集掏出是一方旧砚,砚底刻着县衙的印 - 胡二爷的两箱货(挑着走,无特写) 已有场景:S01 渡船船舱、S02 渡口栈桥、S03 对岸芦苇滩 ``` 上面第三条就该落选——有出场无特写,不承载剧情转折。skills/novel-art/references/report-style.md2.5 KBe45d57778bc6upstream ↗
# 美术报告的设计约定 报告由 `scripts/novel-art.mjs render --html` 生成,样式全部内联在 `renderHtml()` 里。**改样式只改那一处。** 与另外两份报告同一套视觉语言:冷灰印张 + 铁锈红印记,1600 宽,全部平铺可 Cmd+F,零外部依赖,离线双击能开。 ## 结构 ``` 页眉 剧名 · 场景设定集 · 画风 · 质量门徽章 · 导出 JSON KPI 带 场景数(主场景 + 变体)/ 一致性锚点 / 光照状态 / 复用变体 (病灶横幅)质量门有未过项才出现 01 场景清单 一张总表:ID/类型/出现集/锚点数/光照/变体改动 03 道具清单 04 道具设定卡 有 props 才渲染;道具卡与场景卡同构(状态变体替代光照,徽章显示尺度) 02 场景设定卡 每场景一张大卡(报告的主体) 03 质量门 完整 ✓/✗ 清单 ``` ## 场景设定卡 **一排两张**(1100px 以下降一列),卡内纵排——这个排法是给截图宣传定的:设定图占满卡宽、位置靠上,两张卡并排截出来就是一张能发的图。 卡内从上到下:卡头(ID + 名称 + 徽章 + 出现集)→ 设计意图(宋体,它是叙事不是参数)→ **环境设定图**(可点,弹层看大图,Esc 或点背景关闭;没出图就占位)→ 变体来源标注(铁锈红底)→ **一致性锚点**(编号列表,`01 02 03` 等宽序号——它是核对表,编号是给 QC 念的)→ **光照与时段**(状态名 + 提示词,每行带复制按钮) → 提示词包(折叠 + 复制,主视角/设定图/反向 + 整卡 JSON)。 ## 质量门 11 道(场景与共用 7 + 道具 4),`gateReport()` 渲染时算好烘进页面。无道具的文档四道道具门直接放行并照常显示。特殊处理一条:「提示词不含角色名」在没给 cast.json 时**明说跳过**(面板上写「未提供 cast.json,本门跳过」),不装作查过——静默通过和撒谎只差一步。 ## 导出 JSON 与另外两个 skill 同一套:`<script type="application/json" id="scenes-data">` 内嵌原样数据 + 页眉按钮下载。两个坑照旧:`<` 转 `<` 防 `</script` 截断;`revokeObjectURL` 延后调防 Safari 存出空文件。 ## 质量底线 - 模型生成的数据一律 `esc()` 转义 - `@media print`:隐藏按钮、提示词全展开、卡片不跨页断 - `prefers-reduced-motion` 关动效 - 中文文案不用单字词(复制/展开/主场景,不写单字)skills/novel-art/references/scene-pass.md6.6 KB2bcce8830536upstream ↗
# 场景设定 · 怎么填 给你一个场景的骨架(seed 预填了 id/名称/主场景标记/出现集/承载爽点)+ 原文或大纲里关于这个空间的全部信息,产出完整的场景设定。**只输出 JSON,不要解释、不要围栏。**结构见 `schema.md`。 ## 先想清楚:这是 AI 短剧,不是实拍 场景不是「找个地方拍」,是**要被生成几十次还得长一样的环境资产**。你写的每个字段都在为一致性服务: | 字段 | 它在解决什么 | | --- | --- | | 锚点 | 观众靠什么认出「又回到这里了」;QC 靠什么判断生成的镜头没漂 | | 光照状态 | 换时段 = 换提示词重新生成,不是现场重新打灯 | | 空景 | 人是另一层资产(novel-characters 管),环境参考图里有人,一致性全毁 | | 朝代 | 建筑形制、家具、器物、纹样共用的那个基准;不定它,每个场景各挑一个世纪 | ## 硬规则 1. **先定朝代,再写场景。**整部剧**一个**具体的真实朝代或年代,写进文档级的 `dynasty`:`明`、`北宋`、`民国`、`唐`。 **不许写「古代」「古装」「某朝」「架空」这类词。**它们在画面上没有任何对应物——模型读到「古代府邸」只能自己挑一个,于是庭院出成宋、书房出成明、道具出成清,摆在一起不像同一部戏。这跟不许写「架空」是同一条:关于设定的话进不了画面,设定本身才进。 原文没明说就按线索推断,**推断出一个具体的,不要因为不确定就写含糊的**:官职名、服制、器物、货币、称谓、建筑形制、节令风俗、度量衡都是线索。原著是架空设定时,写它**像**哪个朝代——`明代风格`——而不是写它是架空的。 定好之后,`image.prompt`、`image.sheet`、锚点描述、光照状态全部按这个朝代写:斗拱样式、家具腿型、窗棂纹样、灯具形制、地面铺装,都有朝代差别。 2. **`summary` 写设计意图,不写户型说明。**「小到人与人躲不开视线的审讯室」是设计意图;「约十平米,六排坐板」只是测量数据。空间要为戏服务,先说它为哪场戏存在。 3. **锚点要「可画、可认、可核对」。**好锚点:补丁船篷、断裂的第七块桥板、绿锈铜铃——生成图里一眼找得到,缺了立刻发现。坏锚点:「陈旧的氛围」「岁月的痕迹」——没法核对的不是锚点是形容词。每个锚点 `name` 短到能进核对表,`desc` 写清位置和特征。 4. **光照状态从分集反推。**这个场景在出现的那些集里经历了什么时段和天气,就写哪些状态。别凭空写一套「白天/夜晚/黄昏」全家桶——用不上的状态是维护负担。 5. **提示词永远英文,永远空景。**`image.prompt` 里明写 empty scene / no people,`negativePrompt` 必须禁人。**绝不出现角色名、作者名、作品名**——图像模型会把它认识的东西画进去。 6. **提示词里不写渲染风格,只写这个地方的状态。**不要出现 `Semi-realistic environment concept art` / `painterly rendering` 这类句子,也不要给 `image.tags` 打 `semi-realistic`、`painterly` 这种风格标。画风是出图那一刻才定的,整批共用一段风格指令由调用方附加——写进每条提示词只会跟当时选的风格打架,而且换风格要逐条改。 要整段带上的是**表面处理**,它讲的是这个空间被谁在用、用了多久,换任何画风都成立。 **两档二选一,按这个空间的实际保养水平选**——不是两种画风,是两种事实: **A · 日常使用**(民居、客栈、码头、作坊、久无人修的宅子): ``` Weathered, lived-in materials: chipped paint, water stains, patina on metal, worn wood grain, dust in corners and light shafts; fabric and paper props show creases and age; nothing looks factory-new. Atmospheric depth with haze or volumetric light where the space allows ``` **B · 持续维护**(宫殿、官署、显贵府邸的前厅、新建或刚整修的空间): ``` Well-kept, actively maintained materials: sound lacquer with an even sheen, swept stone and timber, polished metal fittings, tight joinery, no peeling paint and no water staining; wear confined to the traffic a space like this really takes — thresholds, handrails, the stone directly inside a doorway. Atmospheric depth with haze or volumetric light where the space allows ``` **别把 A 当默认。**一整部戏全上 A,金銮殿会出成漏雨的废殿——实测《状元是买的》里 S06 金銮殿拿到了「漆面剥落」和「门框下部有浅淡水渍」,那是全国维护最勤的一栋建筑。这跟「每条提示词必须逐字包含同一句画风」是同一个错误:把一个该按对象决定的事实,写成了一句对谁都成立的常量。 选了 B 仍然要写磨损,只是**磨在该磨的地方**:门槛正中、栏杆扶手、台阶踏面——人走出来的,不是年久失修出来的。 反向提示词打底(按场景再补): ``` people, human figures, characters, crowds, silhouettes of people, oversaturated colours, sterile showroom cleanliness, warped perspective, melted geometry, floating objects, text, watermark, signature ``` `image.tags` 打底:`environment sheet`、`weathered materials`、`cinematic`——描述这是什么图、什么状态,不描述它用什么笔法画。 **反向提示词里绝不能禁画风词**(`photorealistic`、`3d render`、`anime` 这些)——出图时选的就可能正是它,禁掉等于自己跟自己打架。 7. **能做变体就别开新景。**AI 生成一个新环境很便宜,但**每多一个独立环境就多一份一致性维护**。outline 里带复用方案的场景(seedNote 会提示),用 `variantOf` + `changes` 挂到母场景上:改时段、换天气、换前景、删道具,桥板细节这类资产直接复用。 8. **不要把角色 skill 的表面处理带进来。**毛孔、皮下散射是皮肤的事;环境的可信度来自**用旧的材质**——掉漆、水渍、包浆、磨白的木纹。「要整段带上的是表面处理」那两档已经写好了,按这个空间的保养水平选一档照抄。 ## 输入格式 ``` Scene: S01 渡船船舱(主场景) 出现集:1–6 承载爽点:悬念钩、身份揭破、反转、收束 原文/大纲里关于这个空间的信息: - …… - …… 同批其他场景:S02 渡口栈桥、S03 对岸芦苇滩 ``` 同批其他场景要知道名字——空间气质要能区分开,别把每个景都写成同一种「破旧」。skills/novel-art/references/schema.md5.5 KB1a7a67b458caupstream ↗
# art.json 结构 美术设定集(场景 + 叙事道具)的载体。`dynasty` 是文档级的——整部剧一个具体的真实朝代或年代(`明` / `北宋` / `民国`),场景、道具的形制与纹样都按它写;不许填「古代」「架空」这类含糊词,理由见 `scene-pass.md` 第 1 条。**模型只填设计字段**,场景与道具的出现集、承载爽点都由 `seed` 从 outline.json 搬运;大纲没有 `props` 时道具表留空,由模型按 `prop-pass.md` 从原文提取。Markdown 和报告由 `render` 渲染。 ```json { "source": "渡口", "dynasty": "民国", "scenes": [{ "id": "S01", "name": "渡船船舱", "primary": true, "summary": "设计意图:这个空间讲什么故事……", "anchors": [{ "name": "补丁船篷", "desc": "……" }], "lighting": [{ "state": "晨雾", "prompt": "dense white morning fog ..." }], "image": { "prompt": "…", "negativePrompt": "…", "sheet": "…", "tags": [] }, "variantOf": "S02", "changes": "换背板 + 芦苇前景", "usage": { "episodes": [1, 6], "beats": ["悬念钩"] } }], "props": [{ "id": "P01", "name": "旧皮箱", "scale": "手持级", "summary": "戏剧功能:全剧悬念核心……", "anchors": [{ "name": "绿锈铜扣", "desc": "……" }], "states": [{ "state": "合上", "prompt": "the suitcase closed ..." }], "relatedScenes": ["S01"], "carriedBy": ["沈知微"], "image": { "prompt": "…", "negativePrompt": "…", "sheet": "…", "tags": [] }, "usage": { "episodes": [1, 6], "beats": ["悬念钩"] } }] } ``` ## 顶层 | 字段 | 必填 | 说明 | | --- | --- | --- | | `source` | 是 | 剧名/书名 | | `scenes` | 是 | 场景数组 | | `props` | 否 | **叙事道具**数组——只收有特写、跨集、承载剧情的(3–8 件为宜),场景陈设归场景锚点。选法见 `prop-pass.md` | ## 单个场景(以校验器为准) | 字段 | 必填 | 语言 | 说明 | | --- | --- | --- | --- | | `id` | 是 | — | `S01` 格式,全局唯一。用 seed 时沿用 outline 的场景 id | | `name` | 是 | 中文 | 场景名 | | `primary` | 是 | — | 是不是主场景 | | `summary` | 是 | 中文 | **设计意图**:这个空间讲什么故事、要什么感觉,不是户型说明 | | `anchors` | 3–5 个 | 中文 | **一致性锚点** `{name, desc}`:每次生成都必须出现的可辨识特征。认场景靠它,QC 生成镜头也靠它 | | `lighting` | ≥1 个 | state 中文 / prompt 英文 | **光照状态**:AI 换时段是重新生成不是重新打灯,每个状态必须落成完整提示词 | | `image.prompt` | 是 | **英文** | 主视角单图提示词,**必须写明空景无人** | | `image.negativePrompt` | 是 | **英文** | **必须禁人**(people/figure/…),这是空景的硬保证 | | `image.sheet` | 是 | **英文** | 环境设定图完整版面指令(见 `sheet.md`),必须整段包含 `scene-pass.md` 两档表面处理句之一 | | `image.tags` | 是 | 英文 | 标签数组:题材、材质、光照、色板。不打画风标,见 `scene-pass.md` | | `variantOf` | 否 | — | 变体的母场景 id。AI 生成一个新景很便宜,但**变体复用母场景资产更一致**——outline 里带 reusePlan 的场景优先做成变体 | | `changes` | variantOf 时必填 | 中文 | 相对母场景改了什么(换时段/换天气/换前景/删道具) | | `usage` | 否 | — | `{episodes, beats}`,seed 自动填,手写也行 | ## 单件道具(以校验器为准) | 字段 | 必填 | 语言 | 说明 | | --- | --- | --- | --- | | `id` | 是 | — | `P01` 格式,全局唯一 | | `name` | 是 | 中文 | 道具名 | | `scale` | 是 | 枚举 | `手持级` / `桌面级` / `家具级`,对应英文短语必须出现在提示词里 | | `summary` | 是 | 中文 | **戏剧功能**:这件道具承载什么剧情 | | `anchors` | 3–5 个 | 中文 | 经得起特写的细节特征(铜扣的新划痕、墨池的月牙磨痕) | | `states` | ≥1 个 | state 中文 / prompt 英文 | **状态变体**:合上/打开、藏着/摊开——每个状态一张参考 | | `relatedScenes` | 否 | — | 主要出现的场景 id,必须存在 | | `carriedBy` | 否 | 中文 | 谁带着它,自由文本 | | `image.prompt` | 是 | **英文** | 白底主视角,**必须带尺度短语、无人无手** | | `image.negativePrompt` | 是 | **英文** | **必须禁人且禁手**(hands/fingers) | | `image.sheet` | 是 | **英文** | 设定图版面指令,**必须写明 pure white background** + 同一套两档表面处理句之一 | | `usage` | 否 | — | `{episodes, beats}` | ## 硬规则(10 道质量门,全是代码) 1. 锚点 3–5 个——少了认不出,多了核对不过来 2. 光照状态 ≥1 且都有英文提示词 3. **空景**:反向提示词必须禁人。环境和角色是两层资产,混在一张图里一致性全毁 4. 出图提示词(主图/反向/设定图/光照)全部英文 5. 提示词不含角色名(`validate --cast cast.json` 才查,不给就明说跳过) 6. 变体引用完整:`variantOf` 指向存在的场景且带 `changes` 道具专属四道: 7. 状态 ≥1 且都有英文提示词 8. 尺度参照写进提示词(scale 枚举对应的英文短语) 9. 反向提示词禁手——拿着道具的手是最常见污染 10. 设定图纯白背景可抠 ## 校验 ```bash node scripts/novel-art.mjs validate art.json --cast cast.json node scripts/novel-art.mjs checkup art.json # 只打印 10 道门 ✓/✗ ```skills/novel-art/references/sheet.md3.8 KB8277b707000aupstream ↗
# 设定图的版面规格(场景 + 道具) `image.sheet` 是**给出图模型的完整版面指令**,本 skill 只负责把它写对,**不负责出图**。 出图在下游(要选模型、画风、画幅,这三件事在这一层一个都答不了)。 下面这些约束必须逐条写进 `image.sheet` 的英文正文。 ## 每个场景、每件道具各一张图 ### 场景 一张 16:9 横构图,主视角大图 + **底部和右侧的 L 形细节边框**,细线分隔: ``` ┌─────────────────────────────┬───────┐ │ │ 细节 1 │ │ 主视角(标准取景) ├───────┤ │ 场景的标准长相 │ 细节 2 │ │ ~72% 宽 × 70% 高 │ │ ├─────────┬─────────┬─────────┼───────┤ │ 细节 3 │ 细节 4 │ 细节 5 │ │ └─────────┴─────────┴─────────┴───────┘ ``` - **主区(左上,约 72% 宽 × 70% 高)**:主视角 = 这个场景的标准取景 + 第一个光照状态,这就是「这个场景长什么样」的唯一标准答案 - **右列 + 底行**:全部是**细节特写**——一致性锚点和关键材质的近景,右列 2 格、底行 3 格左右 - 每个细节格都必须是主视角那个空间的裁切放大,**不许出现主视角里没有的东西**——提示词里写死 `nothing invented that is not present in the master view` ### 道具 同一套 L 形版面,差别三处:**纯白背景**(每个面板都是,要抠图)、主视角是主状态的四分之三角度、底行放**其他状态 + 侧面正交视图**。全图**无人且无手**——拿着道具的手是最常见污染,出现就重生成。尺度短语(handheld scale 等)必须在提示词里,否则皮箱会被画成衣柜。 提示词字段 `image.sheet`。`render` 默认去 art.json 同级的 `images/<slug>-sheet.png` 找图(`slug` 命令生成安全文件名), 图在别处就用 `--images <目录>` 指过去。本 skill 不产生这些文件,下游出完图重跑 `render` 就能捡起来。 ## 三条硬要求 1. **全图空景无人。**提示词里 `Absolutely no people anywhere` 必须在,反向提示词禁人必须在。生成图里出现一个人影就重生成——环境资产里的人洗不掉。 2. **一张图里只能有一个空间。**角色设定图最容易出「一张图两个长相」,环境图的对应崩法是**面板之间空间对不上**(左边六排坐板、右上变成四排)。提示词里写死 `THE SPACE MUST BE IDENTICAL ACROSS ALL PANELS`。拿到图先核对锚点:每个锚点在主视角里找得到吗? 3. **透视要稳。**环境图最常见的废图是几何融化、透视歪斜。反向提示词里 `warped perspective, melted geometry` 必须在(预设自带)。 ## 变体场景:提示词里要挂住母场景 `variantOf` 的场景,`image.sheet` 写的是**母场景主视角 + `changes` 的改动描述**,外加一句 `keep the structure, materials and wear identical to the reference image`——那句是写给下游的: 出这张图时要把母场景的成图当参考图挂上去。**变体机制的意义就在这**,从零生成一致不了。 ## 画风不在这里 同一部剧的所有场景应该像同一个美术组画的。这靠两件事,**两件都不写进单条提示词**: 表面处理句是写死的一套(见 `scene-pass.md` 里「要整段带上的是表面处理」那一条), 画风则由下游在出图时整批附加同一段指令。写进这里只会跟当时选的那一档打架, 而且换风格要逐条改。skills/novel-art/references/test-fixtures/upstream/渡口-cast.json42 KBe87892f0cf72upstream ↗
Contents are not inlined in the catalog. Open the upstream file.
skills/novel-art/references/test-fixtures/upstream/渡口-outline.json9.4 KB3d8b67e46fc9upstream ↗
{ "source": "渡口", "lang": "zh", "params": { "episodes": 6, "minutesPerEpisode": 2, "genre": "民国情感悬疑", "adaptMode": "抽核", "preferences": [ "保留浓雾开船的意象", "老周不能改成反派" ] }, "adaptation": { "core": "浓雾渡口的一船陌生人,各自揣着说不出口的来路,雾散之前每个人都得亮一次底。", "keep": [ { "what": "浓雾渡口的封闭空间", "why": "天然的单场景悬疑舞台,省景又聚戏", "evidence": "雾一厚,连自己的手都看不清。" }, { "what": "沈知微怀里的旧皮箱", "why": "全剧最强的悬念道具,每集都能给一眼", "evidence": "她把一只旧皮箱抱在怀里,指节因为用力而发白。" } ], "cut": [ { "what": "县城当铺的支线", "why": "空间跳出渡口,两分钟一集装不下第二个舞台" } ], "merge": [ { "what": "岸边问路的路人甲乙并入胡二爷", "why": "同一个功能(打探消息)不需要三张脸" } ], "risks": [ { "what": "全剧困在船上,节奏容易闷", "plan": "每集固定一次外部威胁打进来:汽笛、巡查、涨水" } ], "cutNote": "这意味着:全剧困在渡口一夜之内,当铺、县城全部场外处理,终点是开箱翻案,不是进城打官司。", "mergeNote": "主角组定的是沈知微与陆行远——全篇只有这两个人有完整的转变弧。" }, "characters": [ { "id": "C01", "name": "沈知微", "role": "女主", "arc": "从抱箱防备到当着全船开箱,把最怕被看见的东西变成翻盘的底牌", "from": [ "原著沈知微" ], "tier": "lead" }, { "id": "C02", "name": "陆行远", "role": "男主", "arc": "大衣口袋里的硬东西从威胁翻成守护,最后一集摊开手心", "from": [ "原著陆行远" ], "tier": "lead" }, { "id": "C03", "name": "老周", "role": "关键配角", "arc": "静止的锚,四十年不问客人来路,最后用一句话掀翻全船的谎", "from": [ "原著老周", "合并:岸边艄公的台词功能" ], "tier": "support" }, { "id": "C04", "name": "胡二爷", "role": "搅局配角", "arc": "自来熟的货郎,每集戳一个人的痛处,自己反而是藏得最深的", "from": [ "原著胡二爷", "合并:岸边问路的路人甲乙" ], "tier": "support" }, { "id": "C05", "name": "岸上挑灯的更夫", "tier": "functional", "role": "渡口的报时人,雾里只闻梆子声", "from": [ "原创:把原著里「岸上远远的灯火」拟人化成可拍的角色" ] } ], "scenes": [ { "id": "S01", "name": "渡船船舱", "primary": true }, { "id": "S02", "name": "渡口栈桥", "primary": true }, { "id": "S03", "name": "对岸芦苇滩", "primary": false, "reusePlan": "栈桥同一机位换背板,芦苇前景遮挡" } ], "props": [ { "id": "P01", "name": "旧皮箱", "function": "沈知微的底牌与软肋:里面是一摞状纸和一块灵位。从「谁都不许碰」到当众打开,开箱即翻案——全剧最重的一件物证", "beatIds": [ "B01", "B04" ] }, { "id": "P02", "name": "县衙旧砚", "function": "陆行远的身份物证:砚底刻着县衙的印。掏出即揭破他不是揣枪的人,压到状纸上即与皮箱合成同一桩冤案", "beatIds": [ "B02", "B04" ] } ], "beats": [ { "id": "B01", "type": "悬念钩", "weight": "minor", "episode": 1, "setup": "皮箱谁都不许碰", "payoff": "胡二爷伸手要帮忙拎箱,被沈知微一把按住,全船瞬间安静" }, { "id": "B02", "type": "身份揭破", "weight": "major", "episode": 3, "setup": "陆行远的右手始终揣在大衣口袋里", "payoff": "胡二爷一句玩笑逼得他当众掏出口袋——是一方旧砚,不是枪,可砚底刻着县衙的印" }, { "id": "B03", "type": "反转", "weight": "major", "episode": 5, "setup": "老周四十年不问客人来路", "payoff": "老周头一次开口,点破沈知微要去的县城根本没有接应她的人" }, { "id": "B04", "type": "收束", "weight": "minor", "episode": 6, "setup": "雾开始散", "payoff": "皮箱当众打开,船上每个人的谎都落了地,船也到了岸" } ], "episodes": [ { "ep": 1, "synopsis": "浓雾清晨,老周照常开船。沈知微抱着旧皮箱最后一个踏上跳板,找了个离所有人最远的位置坐下。胡二爷自来熟地凑过去搭话,顺势伸手要帮她安置箱子,被她死死按住,船舱里的闲谈声戛然而止。", "hook": "皮箱里到底装了什么,值得她指节发白", "suspense": "陆行远的右手从上船起就没离开过大衣口袋", "sceneIds": [ "S01", "S02" ], "characterIds": [ "C01", "C02", "C03", "C04" ], "propIds": [ "P01" ], "crowdPlan": "四人同船拆成三个机位区:船头老周单切、舱内沈胡对手戏、船尾陆行远远景", "warnings": [] }, { "ep": 2, "synopsis": "船离岸,雾更浓。胡二爷讲起县城集市的见闻探各人口风,说到县衙最近在查一桩旧案,眼睛却始终瞟着沈知微的皮箱。沈知微低头不接话,陆行远却突然接了一句,说那案子查错了人。", "hook": "陆行远为什么替一桩旧案说话", "suspense": "胡二爷讲见闻时,指名道姓提了沈家", "sceneIds": [ "S01" ], "characterIds": [ "C01", "C02", "C04" ], "propIds": [ "P01" ], "crowdPlan": "三人对话拆成两两正反打,胡二爷居中转场", "warnings": [ "人群" ] }, { "ep": 3, "synopsis": "汽笛声从雾里传来,像是巡查船。胡二爷故意高声打趣,说船上要是有人揣着硬家伙可就说不清了。全船的目光落到陆行远的口袋上。他沉默片刻,当众掏出——一方旧砚,砚底刻着县衙的印。", "hook": "县衙的砚台为什么在他身上", "suspense": "巡查船的汽笛越来越近,老周却把船往雾更深处撑", "sceneIds": [ "S01" ], "characterIds": [ "C01", "C02", "C03", "C04" ], "propIds": [ "P02" ], "crowdPlan": "全员反应戏拆成逐人特写接力,不拍四人同框全景", "warnings": [] }, { "ep": 4, "synopsis": "巡查的汽笛擦着船尾远去。陆行远压低声音说明来意:他是替人送还这方砚,物归原主,了一桩冤案的首尾。沈知微听到冤案两个字,抱箱的手臂收得更紧。胡二爷笑着圆场,眼里的算计却淡了下去。", "hook": "冤案两个字为什么让她瞬间失态", "suspense": "老周在船头咳了一声,像是提醒,又像是警告", "sceneIds": [ "S01" ], "characterIds": [ "C01", "C02", "C04" ], "propIds": [ "P01", "P02" ], "crowdPlan": "三人戏收进舱内长凳一条轴线,避免多机位穿帮", "warnings": [] }, { "ep": 5, "synopsis": "船过河心,对岸芦苇滩隐约可见。四十年不问客人来路的老周头一次开口,只对沈知微说了一句话:县城北门外早就没有姓沈的接应了。沈知微如遭雷击——她此行投奔的门路,原来是空的。", "hook": "老周怎么会知道她要投奔谁", "suspense": "胡二爷听到沈姓接应四个字,笑容第一次挂不住", "sceneIds": [ "S01", "S03" ], "characterIds": [ "C01", "C03", "C04" ], "propIds": [], "crowdPlan": "老周与沈知微一对一定机位,胡二爷反应用前景虚化带过", "warnings": [] }, { "ep": 6, "synopsis": "雾散,岸近。沈知微当着全船打开皮箱:里面是一摞状纸和一块灵位。她不是去投亲,是去翻案。陆行远把旧砚放到状纸上,砚与状纸原属同一桩冤案。胡二爷长叹一声,报出自己在县衙当差的真身份,愿意领他们走侧门。船靠岸,三个人先后踏上跳板,老周撑篙调头,渡口又只剩雾散后的空栈桥。", "hook": "状纸和旧砚拼出的到底是谁的冤案", "suspense": "胡二爷这个身份是真交底,还是又一层伪装", "sceneIds": [ "S01", "S02" ], "characterIds": [ "C01", "C02", "C03", "C04", "C05" ], "propIds": [ "P01", "P02" ], "crowdPlan": "开箱主戏沈知微单人特写扛住,其余三人用过肩与背影分摊", "warnings": [] } ] }skills/novel-art/assets/report.webp151 KB1bff80eda53aupstream ↗
Contents are not inlined in the catalog. Open the upstream file.
skills/novel-art/examples/渡口-art.json16 KB36ff8426ce44upstream ↗
{ "source": "渡口", "scenes": [ { "id": "S01", "name": "渡船船舱", "primary": true, "summary": "全剧的主舞台:一条老木船的敞篷客舱,六排坐板,篷布漏光。空间要小到人与人躲不开视线,又要有足够的前后景层次给正反打留位置。所有秘密都在这里被逼出来,舱体本身要像个沉默的审讯室。", "anchors": [ { "name": "补丁船篷", "desc": "篷布右后角一块颜色更深的方形补丁,漏下一道光缝" }, { "name": "磨白的坐板", "desc": "第二排坐板中段被四十年乘客磨出浅色包浆,木纹发亮" }, { "name": "船头铜铃", "desc": "拳头大的旧铜铃挂在篷杆前端,绿锈斑驳,缆绳打着水手结" }, { "name": "舱底积水线", "desc": "舱板接缝处一条深色水渍线,随戏可见微微反光" } ], "lighting": [ { "state": "晨雾", "prompt": "dense white morning fog outside the canopy, soft diffuse light with no shadows, cool grey palette, visibility beyond the gunwale fading to white" }, { "state": "雾散近岸", "prompt": "fog thinning to warm haze, low golden sunlight entering through the canopy seam, long soft shadows across the benches, mood lifting" } ], "image": { "prompt": "Interior of an old wooden ferry passenger cabin under a canvas canopy, Republican-era China, six worn bench rows, patched canopy corner leaking a seam of light, verdigris bronze bell at the bow, morning fog beyond the gunwale, empty scene with no people", "negativePrompt": "people, human figures, characters, crowds, silhouettes of people, plastic CG look, oversaturated colours, sterile showroom cleanliness, warped perspective, melted geometry, floating objects, text, watermark, signature", "sheet": "Environment reference sheet on ONE 16:9 landscape canvas, panels separated by thin hairline rules. MAIN ZONE, top-left, about 72% of the canvas width and 70% of its height: the master establishing view: wide shot of the old wooden ferry passenger cabin from the bow looking aft, six worn bench rows under the canvas canopy, dense white morning fog beyond the gunwale — the canonical look of this location. RIGHT COLUMN, full height along the right edge, stacked small panels: close-up detail studies of the patched canopy corner leaking a seam of light and the verdigris bronze bell with its rope knot. BOTTOM ROW, spanning beneath the main zone: close-up detail studies of the polished pale mid-section of the second bench, the dark waterline stain along the deck seam, worn wood grain and joinery of the bench legs. Every detail panel is a close-up crop of the SAME space shown in the master view — same geometry, same materials, same wear marks; nothing invented that is not present in the master view. Absolutely no people anywhere on the sheet. Weathered, lived-in materials: chipped paint, water stains, patina on metal, worn wood grain, dust in corners and light shafts; fabric and paper props show creases and age; nothing looks factory-new. Atmospheric depth with haze or volumetric light where the space allows", "tags": [ "environment sheet", "weathered materials", "ferry cabin interior" ] }, "usage": { "episodes": [ 1, 2, 3, 4, 5, 6 ], "beats": [ "悬念钩", "身份揭破", "反转", "收束" ] } }, { "id": "S02", "name": "渡口栈桥", "primary": true, "summary": "开场与收尾的门面景:一条探进雾里的旧木栈桥,岸端连着土坡,水端消失在白雾里。它承担「进入故事」和「离开故事」两个仪式性时刻,构图要有明确的纵深引导——栈桥就是一条通往未知的走廊。", "anchors": [ { "name": "断裂的第七块桥板", "desc": "从岸边数第七块桥板断了一角,用麻绳捆着一截圆木补上" }, { "name": "系缆石桩", "desc": "岸端一只矮石桩,缆绳勒出深槽,顶面被磨得发亮" }, { "name": "挑灯木杆", "desc": "栈桥中段一根歪斜的木杆,铁钩上挂一盏熄着的纸灯笼" } ], "lighting": [ { "state": "浓雾清晨", "prompt": "thick white fog swallowing the far end of the pier, flat shadowless light, wet plank surfaces with faint sheen, cold desaturated palette" } ], "image": { "prompt": "An old wooden ferry pier reaching into dense white fog, Republican-era southern China riverside, broken seventh plank patched with a rope-bound log, worn mooring stone, tilted lantern pole with an unlit paper lantern, wet planks, empty scene with no people", "negativePrompt": "people, human figures, characters, crowds, silhouettes of people, plastic CG look, oversaturated colours, sterile showroom cleanliness, warped perspective, melted geometry, floating objects, text, watermark, signature", "sheet": "Environment reference sheet on ONE 16:9 landscape canvas, panels separated by thin hairline rules. MAIN ZONE, top-left, about 72% of the canvas width and 70% of its height: the master establishing view: low wide shot from the bank end of the old wooden ferry pier, planks leading straight into white fog, tilted lantern pole midway — the canonical look of this location. RIGHT COLUMN, full height along the right edge, stacked small panels: close-up detail studies of the rope-bound log patching the broken seventh plank and the unlit paper lantern on its iron hook. BOTTOM ROW, spanning beneath the main zone: close-up detail studies of the grooved mooring stone worn shiny on top, wet plank surfaces with faint sheen, rope fibres and knots on the mooring line. Every detail panel is a close-up crop of the SAME space shown in the master view — same geometry, same materials, same wear marks; nothing invented that is not present in the master view. Absolutely no people anywhere on the sheet. Weathered, lived-in materials: chipped paint, water stains, patina on metal, worn wood grain, dust in corners and light shafts; fabric and paper props show creases and age; nothing looks factory-new. Atmospheric depth with haze or volumetric light where the space allows", "tags": [ "environment sheet", "foggy riverside", "wooden pier" ] }, "usage": { "episodes": [ 1, 6 ], "beats": [ "悬念钩", "收束" ] } }, { "id": "S03", "name": "对岸芦苇滩", "primary": false, "variantOf": "S02", "changes": "栈桥同一机位换背板:水端方向替换成大片芦苇荡前景,去掉挑灯木杆,雾更薄、色温更暖,桥板细节复用 S02 的资产", "summary": "第 5 集反转戏的远景背板:船过河心时隐约可见的对岸。它只需要「存在感」不需要细节——一片被雾泡软的芦苇剪影,暗示彼岸并不比此岸更可靠。作为 S02 的变体生成,省一套环境资产。", "anchors": [ { "name": "芦苇浪线", "desc": "芦苇顶端在雾中连成一条起伏的灰线,是画面唯一的轮廓" }, { "name": "半沉的旧船骨", "desc": "滩涂近水处露出一截朽烂的船肋骨,黑色,挂着水草" }, { "name": "一线滩涂反光", "desc": "退潮泥滩在薄雾下泛一条冷光,分开水面与苇丛" } ], "lighting": [ { "state": "薄雾午前", "prompt": "thin warm haze, diffuse pale gold light, reed silhouettes soft-edged, mudflat sheen catching the brightest value in frame" } ], "image": { "prompt": "A desolate reed marsh riverbank seen across the water, Republican-era southern China, soft grey band of reeds in thinning warm haze, rotten wooden boat ribs half-buried in the mudflat, cold glint on wet mud, empty scene with no people", "negativePrompt": "people, human figures, characters, crowds, silhouettes of people, plastic CG look, oversaturated colours, sterile showroom cleanliness, warped perspective, melted geometry, floating objects, text, watermark, signature", "sheet": "Environment reference sheet on ONE 16:9 landscape canvas, panels separated by thin hairline rules. MAIN ZONE, top-left, about 72% of the canvas width and 70% of its height: the master establishing view: the reed marsh bank seen across the water from mid-river, soft grey reed band in thinning warm haze, mudflat glint separating water and reeds — the canonical look of this location. RIGHT COLUMN, full height along the right edge, stacked small panels: close-up detail studies of the rotten boat rib skeleton draped with waterweed and the undulating reed skyline dissolving into haze. BOTTOM ROW, spanning beneath the main zone: close-up detail studies of the cold glint line on the wet mudflat, reed stems and seed heads at close range, dark silt texture with shallow tide pools. Every detail panel is a close-up crop of the SAME space shown in the master view — same geometry, same materials, same wear marks; nothing invented that is not present in the master view. Absolutely no people anywhere on the sheet. Weathered, lived-in materials: chipped paint, water stains, patina on metal, worn wood grain, dust in corners and light shafts; fabric and paper props show creases and age; nothing looks factory-new. Atmospheric depth with haze or volumetric light where the space allows", "tags": [ "environment sheet", "reed marsh", "foggy river" ] }, "usage": { "episodes": [ 5 ], "beats": [ "反转" ] } } ], "props": [ { "id": "P01", "name": "旧皮箱", "scale": "手持级", "summary": "全剧最强的悬念道具:沈知微从第 1 集抱到第 6 集,谁碰翻谁的脸。观众要在六集里反复看到它的每个细节,最后开箱那一刻它就是主角——一致性崩了整部剧的底牌就穿帮。", "anchors": [ { "name": "绿锈铜扣", "desc": "两只方形铜搭扣,绿锈从缝里渗出来,右边那只有一道新划痕" }, { "name": "磨白的边角", "desc": "四个包角的牛皮磨得发白起毛,右下角最重" }, { "name": "提手缠布", "desc": "皮质提手断过,用靛蓝土布缠了两圈,布头塞在内侧" } ], "states": [ { "state": "合上", "prompt": "the suitcase closed and latched, resting upright, brass clasps fastened, worn leather surfaces catching soft light" }, { "state": "打开", "prompt": "the suitcase lying open, lid at full angle, revealing a stack of folded petition papers and a small wooden memorial tablet inside, dark fabric lining creased" } ], "relatedScenes": [ "S01" ], "carriedBy": [ "沈知微" ], "image": { "prompt": "A weathered Republican-era Chinese leather suitcase at handheld scale, worn brown cowhide with whitened corners, two square verdigris brass clasps, broken handle wrapped in indigo cloth, isolated on a pure white background, no people, no hands", "negativePrompt": "people, human figures, characters, crowds, silhouettes of people, hands, fingers, plastic CG look, oversaturated colours, warped perspective, melted geometry, floating objects, text, watermark, signature", "sheet": "Prop reference sheet on ONE 16:9 landscape canvas on a pure white background, panels separated by thin hairline rules. MAIN ZONE, top-left, about 72% of the canvas width and 70% of its height: the suitcase closed, three-quarter hero view at handheld scale — the canonical look of this prop. RIGHT COLUMN, stacked small panels: close-up detail studies of the verdigris brass clasps with the fresh scratch and the whitened worn corner. BOTTOM ROW beneath the main zone: the suitcase in its open state showing petition papers and the memorial tablet inside, a straight-on side profile, and a close-up of the indigo cloth-wrapped handle. Every panel shows the SAME suitcase — same wear, same scratches, same proportions. Absolutely no people and no hands anywhere. Pure white background in every panel for clean cut-out. Weathered, lived-in materials: chipped paint, water stains, patina on metal, worn wood grain, dust in corners and light shafts; fabric and paper props show creases and age; nothing looks factory-new. Atmospheric depth with haze or volumetric light where the space allows", "tags": [ "prop sheet", "leather suitcase", "white background" ] }, "usage": { "episodes": [ 1, 2, 3, 4, 5, 6 ], "beats": [ "悬念钩", "收束" ] } }, { "id": "P02", "name": "县衙旧砚", "scale": "手持级", "summary": "第 3 集大爆点的实体:陆行远口袋里的「硬东西」。掏出来之前它是威胁,掏出来之后它是冤案的钥匙——砚底的县衙刻印是全剧最重要的一个特写镜头。", "anchors": [ { "name": "砚底县衙刻印", "desc": "底面阴刻两行小字官印,笔画里积着旧墨" }, { "name": "缺角", "desc": "右上角磕掉指甲盖大小一块,断面颜色更深" }, { "name": "墨池月痕", "desc": "墨池边缘磨出一圈月牙形浅痕,用了几十年的证据" } ], "states": [ { "state": "正面", "prompt": "the inkstone face up, moon-shaped wear ring around the ink pool visible, chipped corner facing camera" }, { "state": "底面刻印", "prompt": "the inkstone flipped bottom up, two lines of carved official seal characters filled with dried ink, raking light making the carving legible" } ], "relatedScenes": [ "S01" ], "carriedBy": [ "陆行远" ], "image": { "prompt": "An old Chinese ink stone at handheld scale, dark grey duan stone with a chipped upper corner, moon-shaped wear ring around the ink pool, two lines of carved official seal characters on its underside, isolated on a pure white background, no people, no hands", "negativePrompt": "people, human figures, characters, crowds, silhouettes of people, hands, fingers, plastic CG look, oversaturated colours, warped perspective, melted geometry, floating objects, text, watermark, signature", "sheet": "Prop reference sheet on ONE 16:9 landscape canvas on a pure white background, panels separated by thin hairline rules. MAIN ZONE, top-left, about 72% of the canvas width and 70% of its height: the ink stone face up in three-quarter hero view at handheld scale — the canonical look of this prop. RIGHT COLUMN, stacked small panels: close-up detail studies of the chipped corner with its darker fracture face and the moon-shaped wear ring around the ink pool. BOTTOM ROW beneath the main zone: the inkstone flipped to show the carved official seal characters on the underside under raking light, a straight-on side profile showing its thickness, and a macro close-up of dried ink caught in the carved strokes. Every panel shows the SAME ink stone — same chip, same wear, same proportions. Absolutely no people and no hands anywhere. Pure white background in every panel for clean cut-out. Weathered, lived-in materials: chipped paint, water stains, patina on metal, worn wood grain, dust in corners and light shafts; fabric and paper props show creases and age; nothing looks factory-new. Atmospheric depth with haze or volumetric light where the space allows", "tags": [ "prop sheet", "ink stone", "white background" ] }, "usage": { "episodes": [ 3, 4, 6 ], "beats": [ "身份揭破" ] } } ] }skills/novel-art/README.en.md4.6 KBf09de68ef0c9upstream ↗
[](README.md) [](README.en.md) [](https://x.com/eternityspring) # novel-art Art bibles for **AI short-drama production**: scenes + narrative props. The premise is baked in: **generated, not filmed** — no location scouting, no set building, no prop sourcing. Environments and props are assets that must be regenerated dozens of times and still look like the same thing, so the deliverable is a consistency plan. **Scenes**: design intent, consistency anchors (3–5 per scene — viewers recognize the place by them, QC checks shots against them), lighting states (a time-of-day change is a **regeneration, not a relight**), and a variant mechanism (`variantOf` + `changes`, generating against the parent's sheet). **Props** (narrative props only — close-ups, cross-episode, plot-bearing; typically 3–8 per show): dramatic function first, **state variants** (a suitcase closed and open are two references), a **scale reference** written into every prompt (AI loves rendering a handheld prop at furniture size), and **white-background, no-hands plates** — prop references get composited into shots, and a hand holding the prop is the classic contamination. Set dressing stays in scene anchors; one-off hand props are handled at shot level — neither gets its own asset. Outputs `art.json`, a Markdown report, and a self-contained `art-report.html`. Reports render with a Chinese UI by default; pass `--lang en` for a fully English report (or set a top-level `"lang": "en"` in art.json — `--lang` wins). Image prompts are always English either way: In English mode the quality-gate labels are translated too (thresholds kept as computed); failing-gate details and all data stay as authored.  ## The quality gates are code Same stance as the other two skills: **a checklist the model grades itself on is worthless.** Ten deterministic gates — anchors 3–5 (scenes and props alike), lighting states ≥1 per scene, people banned in negatives everywhere, all prompts English, no character names (checked with `--cast`, explicitly reported as skipped without it), variant references complete, plus four prop-specific gates: **states ≥1**, **scale phrase present in prompts**, **hands banned in negatives**, **pure white background in the sheet**. The selftest defeats every gate on purpose. ## The three-skill relay ``` novel-outline → outline.json (what: structure & episodes) novel-characters → cast.json (who: character assets) novel-art → art.json (where & what they hold: art assets) ``` `seed <outline.json>` prefills both the scene list and the prop list deterministically, carrying over the episodes each one appears in and the beats it serves; if the outline has no `props`, the prop list is left empty and the model extracts it from the text per `prop-pass.md`. `validate --cast` cross-checks prompts against the character roster. Surface wording is environment-flavoured rather than the character skill's skin detail. The rendering style is not written into prompts at all — the caller prepends it at generation time. ## CLI ```bash node scripts/novel-art.mjs seed outline.json > art.json node scripts/novel-art.mjs validate art.json --cast cast.json node scripts/novel-art.mjs checkup art.json node scripts/novel-art.mjs render art.json --html # Chinese report UI (default) node scripts/novel-art.mjs render art.json --html --lang en # English report UI ``` ## Sheet layout spec **This skill does not generate images.** The deliverable is `image.sheet` — a complete layout instruction for whatever generates the image downstream, where the model, the style and the aspect get chosen. None of those three can be answered at this layer. One per scene and per prop, both using the **master-view + L-shaped detail border** layout (bottom and right edges). Scene details = anchor close-ups; prop details = anchor close-ups + other states + a side profile. Scenes are empty of people; props additionally ban hands and sit on pure white for clean cut-out. A variant's instruction says to reference the parent's sheet. Full spec in `references/sheet.md`. ## Selftest ```bash node scripts/selftest.mjs ``` 151 assertions — seeding, gate-defeating cases for all 10 gates, rendering (zh/en report UI), export. No model calls, runs in about a second. **Only tested on macOS + Node 24.**
Plain-text copy, no login: /skill-bundles/eternityspring-shuohao-skills-skills-novel-art.md