@oh-story/dsh 0.1.0

package/lib/drama/skills/short-drama/references/production-form-profiles.md

@@ -0,0 +1,126 @@
+# 把视觉方向翻译成制作形态
+
+视觉风格不是贴在提示词前面的标签。先把创作者已接受的 `visual_direction` 和
+`production_profile` 拆成可观察、可复核的选择，再让各负责人只投影本阶段需要的部分。
+同一故事事实可以有多种制作形态；这里给的是提问维度、构成差异和责任边界，不是固定风格套餐。
+逐形态的执行细节放在 `references/form-cards/` 的六张卡里，本文只负责怎么选、
+提示词构成随形态改变什么、以及各阶段拿走什么。
+
+## 目录
+
+- [形态卡的规则等级](#形态卡的规则等级)
+- [Production-form card](#先写一张-production-form-card)
+- [环境物理与身份形态](#先锁环境物理与身份形态)
+- [可执行词汇与形态卡](#按形态选择可执行词汇)
+- [提示词构成的形态差异](#提示词构成怎样随形态改变)
+- [跨阶段传递](#跨阶段传递同一意图)
+
+## 形态卡的规则等级
+
+形态卡与题材卡同级：**默认是 `craft_default`**，创作者说明理由即可覆盖，形态卡自己
+不产生 ID，也不能创造新的 `structural_invariant`。卡片里写作“硬规则/硬约束”的条目，
+指的是它在投影一条**已经登记**的身份或连续性不变式（见 [knowhow-index.md](knowhow-index.md)），
+按那条原规则的等级执行；比例、rig 能力、头身比一类是**本项目的制作约束**，由创作者
+在 `creator_authority` 中确认后生效，不是套件层规则。审查者不得单凭形态卡阻断交付。
+
+## 先写一张 production-form card
+
+对当前系列或一段局部变体，记录九项。形态卡里的每一项都要能落到某个阶段的可执行字段；
+落不到字段的条目是审美闲聊，先删掉再补：
+
+- **叙事职责**：这种形态要帮助观众更快看懂什么、感到什么，不能只写“高级”“电影感”。
+- **身份锚点载体**：靠什么让人物跨镜可辨认——轮廓、线条、比例、结构差异还是材质。
+- **连续性载体**：哪些字段必须逐镜传递，哪些可以省；不同形态的答案差别很大。
+- **层级拆分**：身份层、环境层、可动层、效果层各包含什么，谁负责同一事实。
+- **形与识别**：轮廓、比例、线条/表面、服装与道具的永久识别锚点；哪些可随镜头变化。
+- **材质与光色**：物理或绘制材料怎样响应光，色彩关系承担什么信息，不罗列质量词。
+- **运动预算**：哪些必须全动作，哪些可用 hold pose、局部循环、视差、特效层或剪辑完成。
+- **声音与文字**：表演、声源、旁白和画面文字各自承载什么；可读文字仍服从资产 text policy。
+- **变与不变**：跨集稳定项、单场可变项、创作者覆盖和需要先试验的未知项。
+
+风格名称、模型代码或供应商字段不能替代这张卡；风格代码同样不能。不同上游代码可能指向同一种
+呈现方向，同一个代码也可能被项目说明改写；若创作者只给了一个风格标签，负责人先提出最小的
+可观察澄清，或把未决项保留为候选，不擅自补成一套审美。
+
+判断一条形态描述有没有内容，只需要问：**它改变了哪一个字段的写法**。若把它删掉，
+提示词一字不变，那它就只是标签。
+
+## 先锁环境物理与身份形态
+
+有异质身体、身份互换、变形、水下、失重、微缩或非人角色时，先写不能被风格词覆盖的物理卡：
+
+- **身体拓扑**：当前有哪些肢体/形态、明确不存在什么、接触和发力点在哪里；
+- **身份占用**：谁的意识/人格占用哪种身体或外形，别人当前如何识别，何时允许变化；
+- **环境介质**：水流、浮力、重力、风、黏滞、尺度怎样改变静止、移动、服装/毛发和道具；
+- **运动语法**：为当前身体选择悬浮、摆尾、攀附、滑行等动作，删除与物理冲突的陆地动作词；
+- **连续性硬项**：身份形态、呼吸/受力状态、持物方式、语言锁与相邻边界怎样逐镜继承；
+- **软呈现项**：冷暖、笔触、景深、光效等可以变化，但不得冲掉上述硬项。
+
+这些约束先属于创作者/故事与资产事实，再由分镜和视频提示词投影；不要让提示词阶段
+临时发明身体规则。若当前只是普通人物的情绪或服装变化，不额外建立异质物理卡。
+
+## 按形态选择可执行词汇
+
+形态卡是选出来的，不是从题材或上游标签继承的。先按下表定位一张卡，再按该卡写字段；
+同一项目可以对不同段落使用不同卡，但每段必须只有一张生效。
+
+| 形态 | 形态卡 | 这种形态最先决定的事 | 最容易丢的东西 |
+|---|---|---|---|
+| 实拍 | [实拍](form-cards/实拍.md) | 可搭建空间、真实光源、可表演的动作与可收录声源 | 造型状态的逐镜可比较性 |
+| 二维动态漫（2D 动态漫 / 限动画） | [二维动态漫](form-cards/二维动态漫.md) | 形状语言、色块与阴影分区、每镜的可动层 | 剪影级身份锚点 |
+| 风格化三维（风格化 3D） | [风格化三维](form-cards/风格化三维.md) | 比例、rig 姿势边界、接触与摄影机空间 | 接触点与重量结果 |
+| 水墨笔触 | [水墨笔触](form-cards/水墨笔触.md) | 浓淡层级、留白方位、哪些边缘不可散 | 必要地理与手中物 |
+| Q 版表达（含 Q 版知识 / 教育短片） | [Q 版表达](form-cards/Q版表达.md) | 比例体系、一镜一因果、符号层与文字预留 | 因果精度与尺度关系 |
+| 国漫二次元 | [国漫二次元](form-cards/国漫二次元.md) | 角色间可枚举的结构差异、氛围色边界、口型策略 | 人物之间的区分度 |
+
+混合形态（例如三维角色配绘制背景、实拍加笔触后期）不新建第七张卡，而是取两张卡并
+**逐项声明谁负责身份、深度、边缘、光和运动**。两层同时决定同一事实是混合形态最贵的错误。
+
+## 提示词构成怎样随形态改变
+
+形态不改变提示词的段序，改变的是**哪些段必须展开、哪些段可以塌缩、以及某些段的默认值**。
+用同一份配方写不同形态时，按下面三条调整。
+
+**一、身份段的载体不同，写法就不同**。 实拍写造型状态而不是长相；二维写剪影与色块；
+三维写比例与 rig 边界；水墨写不可散的边缘；Q 版写头身比与放大记号；国漫二次元必须写出
+与同剧其他角色的结构差异——这是唯一一个要求“对比着写”的形态，因为精修画风会把角色拉平。
+
+**二、连续性段带走的字段不同**。 逐镜必带项按形态取舍，不是所有项目都携带同一串状态：
+
+| 形态 | 连续性必带 | 通常可省 |
+|---|---|---|
+| 实拍 | 造型层次与整洁度、湿污伤、手中物、光源时段与方向 | 不出画的内层、无从比较的陈设 |
+| 二维动态漫 | 轮廓色块、阴影分区、描边规则、本镜可动层清单 | 写实材质、精确布光角度 |
+| 风格化三维 | 比例剪影、材质分区、接触点、轴线与机位高度 | 次要形变、看不见的背面 |
+| 水墨笔触 | 不可散的轮廓、浓淡层级、手中物、必要地理、留白方位 | 精确光向、纹理细节 |
+| Q 版表达 | 头身比与相对尺度、主色块、放大记号、文字预留位 | 写实材质、背景细节 |
+| 国漫二次元 | 脸眼发结构、瞳色与高光形状、固定配件、氛围色与光源色温 | 背景纵深、不承重的装饰 |
+
+**三、运动段的默认值不同**。 实拍默认全动作，要写的是限制；三维默认可全动作，
+但摄影机是最贵的一层；二维动态漫与水墨默认 hold，要写的是**哪一层例外**；
+Q 版默认一镜一因果；国漫二次元把全动作预算集中给情绪转折镜，其余用循环加效果层撑住。
+省掉这一段的后果是可预测的：默认 hold 的形态会被写成全员飘动，默认全动作的形态会被写成
+一串没有接触点的动作词。
+
+不要用“加一句风格前缀”的方式处理形态差异。前缀改变的是检索标签，形态改变的是
+必须出现和可以省略的字段；只有后者会被下游执行，也只有后者能被审查。
+
+## 跨阶段传递同一意图
+
+| 阶段 | 本阶段新增 | 必须继承 | 不应越权 |
+|---|---|---|---|
+| develop / 编导简报 | 叙事职责、形态假设、运动预算与未决试验 | 创作者方向、题材与受众承诺 | 供应商字段、逐镜事实 |
+| assets | 轮廓、材料、层拆、稳定比例和版本差异 | 身份、地理、文字政策 | 镜头构图和动作终态 |
+| image-prompts | 单帧可见的形/材质/层次/光色投影 | 已接受资产与当前用途 | 有先后顺序的动作 |
+| storyboard / keyframe | 注意力、层次、遮挡、可动层与冻结边界 | 剧本信息权限、资产绑定 | 用风格词改写人物状态 |
+| video-prompts | 运动层、接触、节奏、声源与结果 | shot purpose、起止边界、形态预算 | 回写镜头或资产权威 |
+| review | 检查叙事职责是否真的落到可见字段 | 精确 artifact refs 与创作者覆盖 | 用个人偏好替代证据 |
+
+这张表对所有形态成立；每个阶段在本形态下额外要写的那一件事，写在对应形态卡的
+“跨阶段传递”小节，取用时只读当前形态那一张，不要把六张卡都装进上下文。
+
+检查时不问“有没有写风格名”，而问：叙事职责是否投影成了本形态可执行的形、层、材质、光、动作或声音；
+连续性必带项是否按本形态取舍而不是照抄别的形态；同一决定是否只由一个 owner 写入；
+换一个题材或项目时，agent 是否会重新选择而不是复制整套词汇。
+Reviewer 要分别引用来源事实、已选择的制作意图和目标 artifact 位置，再区分违约、实现偏差与个人 taste。
+若已选择的单镜/形态预算不可执行，回到对应 owner 请求批准，不把拆镜或换形态默认为已经授权的替代。

package/lib/drama/skills/short-drama/references/reference-roles.md

@@ -0,0 +1,142 @@
+# 一张参考图可以决定什么
+
+## 目录
+
+- [绑定前先回答四个问题](#绑定前先回答四个问题)
+- [绑定不等于看过](#绑定不等于看过)
+- [两种观察不能混成一条](#两种观察不能混成一条)
+- [每种用途允许借用什么](#每种用途允许借用什么)
+- [多图、联系表与首尾帧](#多图联系表与首尾帧)
+- [审查顺序](#审查顺序)
+
+绑定一张参考图，等于告诉下游"照着它写"。问题是"照着"到底指哪些内容——同一张人物定妆照，
+可以用来定脸，也可能被当成定构图、定服装、定表情，甚至把图里背景一起搬走。
+不说清楚，下游只能猜；猜错了不会报错，只会拍错。
+
+本文只回答两件事：一次绑定要写清什么，以及每种用途各自允许借用什么。
+观众何时能知道某件事见 [audience-reveal.md](audience-reveal.md)；
+一个缩小范围的版本是否仍算母版见 [pickup-and-alternate.md](pickup-and-alternate.md)。
+
+## 绑定前先回答四个问题
+
+1. **它是哪一条记录**：写准确的产物引用与记录 ID，不是"参考图二"。
+2. **这次参考它的什么**：身份、造型状态、地点方位、构图、尺度、效果还是起始帧。
+3. **哪些内容可以照着写**：在 `may_control` 里列出这次确实要参考的可见内容。
+4. **哪些内容不能跟着变**：在 `must_not_control` 里保护身份、文字、人数、道具和空间锚点。
+
+同一张图若要承担两个不同作用，拆成两条绑定分别审查，不写"全参考"。
+
+### 绑定不等于看过
+
+`artifact_ref` 只说明绑定了哪条文本记录，**不能证明智能体真的看过那张图**。所以每条绑定
+还要写清证据到了哪一步：
+
+| `admission_status` | 什么情况 | 可以下什么结论 |
+|---|---|---|
+| `creator_described` | 创作者或图片权利人给了可核对的画面说明 | 按说明内容判断 |
+| `visually_inspected` | 运行环境获授权检查输入参考图并完成检查 | 按检查记录判断 |
+| `unverified` | 只有 JSON 或文字描述，媒体不可见或没有授权 | **不得**声称像素、文字、水印或裁切已通过 |
+
+前两种都要绑定准确的 `reference_observation_ref`，记录所看的文件、检查区域、
+文字处理结论、检查方式与未决风险，格式见
+[reference-observation.example.jsonl](../assets/reference-observation.example.jsonl)。
+
+### 两种观察不能混成一条
+
+输入准入记录固定写 `observation_kind: input_reference`——它只支持"这张参考图上有什么"。
+
+若创作者另行提供某个准确提示词/规格版本下的授权**生产**观察，用独立的
+[production-observation.example.jsonl](../assets/production-observation.example.jsonl)，写
+`observation_kind: generated_result`、`evidence_state: active`，并绑定 prompt/spec、
+稳定参考槽位与制作配置。
+
+`evidence_state: active` 只表示这份证据仍可使用，**不表示产物通过或被接受**。
+
+两种观察不能混为一条：一条讲输入里有什么，另一条讲某次结果发生了什么，能支持的结论
+完全不同。任务成功、结果地址或文件存在，都不能代替其中任何一种。
+
+两条容易被绕过的边界：
+
+- **检查输入参考 ≠ 生成图片，也 ≠ 验收成片**。 三件事各自需要各自的证据。
+- **负面提示词擦不掉参考图上已有的像素**。 图里有水印就是有水印，写"不要文字"不会让它消失；
+  要么裁切、清理、遮罩、替换，要么退回参考图归属方决策。
+
+## 每种用途允许借用什么
+
+| 用途 | 可以借用 | 默认不可借用 |
+|---|---|---|
+| `identity` | 稳定脸型、体态、识别标记 | 临时服装、姿势、场景、画中文字 |
+| `look_state` | 已接受的造型，或伤损、湿污等状态 | 新身份、无来源道具、背景方位 |
+| `geography` | 入口、区域、固定锚点、方向关系 | 图中临时人物、光线以外的故事状态 |
+| `composition` | 占画比例、视线布局、镜头所在一侧、留白 | 图中人物是谁、穿什么、发生什么 |
+| `scale` | 主体之间或主体与环境的相对尺度 | 风格、身份、数量、动作结果 |
+| `effect` | 已接受效果的形态、范围或材质表现 | 非目标对象的消失、复制或变形 |
+| `start_frame` | 本镜已接受的起始构图与可见状态 | 尚未发生的动作、终态或下一镜事实 |
+| `end_frame` | 本镜 `end_boundary` 已接受的投影 | 新终点、未由镜头承担的动作结果 |
+| `style` | 色彩层级、材质处理、阴影边缘、景深倾向、画面密度 | 角色身份、固定地理、剧情状态、道具文字 |
+
+"只参考构图"是有效而且重要的边界：可以借用前景/背景占比和压迫关系，同时明确不导入图中
+角色、服装、道具、文字与事件。尺度也优先写成可比较的空间关系、遮挡和画面占比；
+具体比例只有被创作者或项目配置接受后才是约束，不能从案例总结成通用数字。
+
+### 合成示例
+
+一张剧照要用来定"谁站在画面哪一侧、占多大"，但图里那个人不是本镜的角色。
+
+这条绑定所在的文件在第一行声明它引用到的上游快照：
+
+```json
+{"record_type":"sources","schema_version":"1.0.0","sources":{"keyframes":{"owner":"short-drama-storyboard","artifact":"剧集/EP001/storyboard/keyframes.jsonl"}}}
+```
+
+之后每条绑定只写快照键、记录 ID 和这一条自己的 `authority`：
+
+```json
+{
+  "slot_id": "REF-COMPOSITION-01",
+  "order": 1,
+  "artifact_ref": {
+    "src": "keyframes",
+    "record_id": "KEY-012",
+    "authority": "candidate"
+  },
+  "role": "composition",
+  "may_control": ["主体占画比例", "镜头所在一侧", "留白位置"],
+  "must_not_control": ["角色身份", "服装", "道具文字", "故事状态"],
+  "admission_status": "unverified",
+  "reference_observation_ref": null,
+  "unresolved_risks": ["尚无对该图文字/水印的检查记录"]
+}
+```
+
+这条绑定的意思是：**照着它排版，不要照着它选人**。 若它同时还要负责这个角色的长相，
+就再写一条 `role: identity` 的绑定，而不是把 `may_control` 加长。
+
+## 多图、联系表与首尾帧
+
+多张图可能是三种完全不同的东西，不能因为排在一张版面里就混成一个资产：
+
+- **一组参考绑定**：各自有各自的用途；
+- **方便人工浏览的联系表**：只是交付包装，每格仍保留自己的 artifact、用途和文字政策；
+- **同一段运动的起止边界**：见下。
+
+每条绑定使用稳定 `slot_id` 和显式 `order`。数组重排、插入新参考或联系表换版时**不得改变
+已有槽位的语义**——重排不会报错，只会拍错。固定九宫格也不是叙事密度公式，格间顺序不能
+替代独立镜头的起止边界。
+
+首尾帧契约是"**默认 start，按需 end**"：关键帧默认 `boundary_role: start`。执行方式确实需要
+首尾帧时，storyboard owner 可以增加 `boundary_role: end` 的关键帧；它只投影同一镜头已接受的
+`end_boundary`，**不是第二个终点权威**，也不能从动作说明自行发明。视频提示词可按
+`role: end_frame` 只读绑定这条记录，终点报告仍然对照 shot 的 `end_boundary`。
+
+动作跨度过大、或关键动作只存在于首尾插值的空隙里时，先拆镜——不能让尾帧替镜头承担动作本身。
+
+## 审查顺序
+
+1. 引用与 `authority` 能否解析；
+2. 每条绑定的用途、可借用内容、不可照搬内容是否写清；
+3. 观察记录是否存在，没有证据是否老实保持 `unverified`；
+4. 最后才评价措辞与审美。
+
+不要用引用数量、固定裁切方式、关键词清单或提示词长度代替这些判断，也不要从文字规格声称身份或特效
+在真实成片里已经成功。

package/lib/drama/skills/short-drama/references/runtime-preflight.md

@@ -0,0 +1,27 @@
+# 项目定位与发布纪律
+
+core 只管理当前项目的目录、生命周期和交付。
+
+## 1. 读取项目状态
+
+定位 `short-drama.json` 后运行：
+
+```text
+python3 <core>/scripts/project_tool.py status <project>
+```
+
+使用 `status.layout.roots` 返回的项目目录。`mode=mixed` 表示中英文阶段目录并存，应先合并；
+空项目在第一次阶段发布时固定布局。只读取本次任务需要的直接输入。
+
+## 2. 通过公开命令写入
+
+- owner 用 `publish` 原子发布一项产物，并用可重复的 `--input <project-path>` 声明直接输入。
+- `accept` 只记录创作者对当前输出的接受或拒绝。
+- `review` 只记录当前输出的复核结论；reviewer 不直接改 owner 文件。
+- 输入或输出变化后，该产物显示 `update_needed`，重新发布即可；不递归改写下游状态。
+- `package` 只收录当前 `approved` 的文本/JSON，不能替代接受或复核。
+- 第一次发布由任意非空 owner 认领合法阶段路径，此后这条路径归该 owner。
+- 同一项目路径仍只能属于一个 artifact，输入、交付和机器状态目录仍受保护。
+
+完整参数见 [lifecycle-commands.md](lifecycle-commands.md)，权威边界见
+[contract-and-ownership.md](contract-and-ownership.md)。