feat(monitor): 抖音 Web 接口客户端 —— 绕开爬虫子进程，直接发 HTTP

移植自 mac-agent-os 的 mediacrawler_adapter：不起子进程、不开页面，用浏览器里那份登录态直接调抖音 Web 接口。产物键名照抄 store/douyin，所以 ingest 那条链路一个字不用改。 **目前能用的（真环境实测，非推断）**： profile/other : 200, 7075 字节 —— 博主主页指标（粉丝/获赞/作品数/昵称） aweme/detail : 200, 45425 字节 —— 单条作品详情（含点赞/评论/收藏/分享） **目前不能用的：作品列表 `aweme/post`。** 两个互相独立的原因： 1. 这个接口被抖音单独升级成了真校验：不带 x-tt-argus 回 403「Uifid Not Found」，带上 dummy 值回 200 + **空 body**。也就是说「头在不在」骗得过，「真校验」过不了。同一套头打 profile/other 和 aweme/detail 都是通的 —— 抖音是挑着接口加保护的，挑中的恰好是「批量拉作品列表」这个最敏感的动作。 2. 改走页面截获也不行：CDP 浏览器打开博主主页会落到「验证码中间页」（当天大量探测的代价，过几小时要重测）。所以现在的边界是：**已知作品的指标刷新能做，自动发现新作品做不了**。 **排查中控住变量后得到的两条事实**（都写进注释了）： · `Accept` / `Accept-Language` / `Referer` 才是主页接口能返回真数据的原因 —— 只有 UA+client hints+Cookie 时是 200 但仅 121 字节的空壳，补上这三个头变 7074 字节。（我先前猜的 sec-ch-ua 不是关键。） · 因此 UA 与 client hints 必须**成套地取自同一个浏览器**，所以 BrowserIdentity 一次从 CDP 取齐 cookie + UA + hints，而不是各自写死。「200 + 空 body 必须当场报错」也是刻意写死的：放过去它会在下游变成「这个博主没作品」，把一次失败伪装成一条正常结果 —— 爬虫那条路正是这么栽的，还被翻译成「账号被封」。测试 +11：cookie 解析、请求头成套性（含 uifid 缺失/回退）、产物键名与 store 对齐、以及 _get 的三条失败路径（空 body / 403 带网关原话 / 正常返回）。
2026-10-10 17:12:25 +08:00
parent 21ff01b894
commit 2112c1a870
1601 changed files with 367425 additions and 0 deletions
@@ -0,0 +1,93 @@
+# 从输入到成片验收 / Complete filmmaking workflow
+
+这里把每一步的输入、交付和返回关系放在一张图中。可以从已有剧本、参考图、导演方案或镜头继续，不必每次从头运行；只有当前交付需要时才进入下一层。
+
+![从输入、剧本、导演、视觉资产、分镜提示词到视频验收的完整流程](assets/workflow-overview.svg)
+
+[下载完整 Mermaid 源图](assets/production-workflow.mmd) · [全部模块](../SKILL_CATALOG.md) · [当前源码安装](INSTALLATION.md#install-from-a-clone) · [21张用户接受视觉成果及证据](showcase/manifest.json)
+
+## 完整原图
+
+下图列出当前工作流的职责节点和返回线。它是职责和交接图，不表示所有步骤已自动执行，也不表示全部模块都在本仓库分发。
+
+```mermaid
+flowchart TB
+    U["用户输入<br/>点子·小说·大纲·剧本·参考图·已有镜头"] --> T["确定本次目标与已有材料<br/>交付物·时长·画幅·平台·制作限制"]
+    T --> W["剧本创作与编辑<br/>director-agent"]
+    T -. "需要市场判断时" .-> M["市场研究<br/>d-official-market-analysis"]
+    M -. "选题与改稿参考" .-> W
+    M -. "用户明确批准写入后" .-> K["市场知识审核与沉淀<br/>d-data-analysis-semantic-layer"]
+    W --> S["可读剧本<br/>人物·情节因果·对白·场景"]
+    S --> D["导演方案<br/>director-agent<br/>表演·视觉概念·声音·剪辑"]
+    S -. "明确需要时" .-> X["AI执行剧本编译<br/>director-agent 的条件模式"]
+    D --> V["按需选择视觉风格<br/>赛博朋克·史诗·奇幻·恐怖·黑色<br/>爱情·战争·武侠·仙侠·硬科幻·古风"]
+    V --> A["人物／场景／道具资产<br/>character-asset · scene-asset · prop-asset<br/>按请求交设计／提示词或参考图<br/>图片经用户审阅后锁定"]
+    A -. "需要调整时" .-> V
+    V --> B["分镜与摄影设计<br/>ai-storyboard-director 5.7.1"]
+    A --> B
+    X --> B
+    B <--> R["保存与恢复<br/>导演意图·已选镜头·场景状态"]
+    B -. "需要创意思路时" .-> C["创意镜头文字候选<br/>观看过程·作用·取舍<br/>不自动生成或写入主方案"]
+    C -. "用户明确采用后局部合并" .-> B
+    B --> P["按请求交分镜或提示词<br/>分镜可读设计·提示词六模块"]
+    P -. "明确要求实际白模预演时" .-> PRE["3D白模预演<br/>whitebox-previs-executor"]
+    PRE -. "修改机位或节奏" .-> B
+    PRE -. "已明确要求实际视频时" .-> G["实际视频生成<br/>produce-ai-video 统筹制作<br/>调用视频模型与生成工具"]
+    P -. "明确要求实际视频时" .-> G
+    G --> E["选片·剪辑·对白／音效／音乐"]
+    E --> Q["完整播放审查与修复"]
+    Q --> F["用户验收与成片交付"]
+    T -. "专项编排，尚未部署" .-> SHORT["短剧生产控制合同<br/>ai-short-drama-production<br/>按请求分镜或六模块提示词"]
+```
+
+## 每个阶段实际交付什么
+
+| 阶段 | 必要输入 | 可直接使用的交付 | 失败后返回 |
+|---|---|---|---|
+| 输入与范围 | 当前要求、已有材料、明确限制 | 本次结果、时长/画幅、成本和权限边界 | 决定结果的缺口 |
+| 编剧与导演 | 点子、小说、大纲或已有剧本 | 可读剧本；人物行动、表演、视觉、声音、剪辑决定 | 最早断裂的因果或导演判断 |
+| 视觉与资产 | 剧情和已有锁定 | 类型参数；人物/场景/道具提示词、实际参考图及审阅状态 | 不成立的构图、光影、材质、身份或空间 |
+| 创意镜头思路 | 当前剧情、主方案与锁定项 | 独立文字备选：观看过程、叙事作用、衔接、收益与代价；采用不等于生成授权 | 具体创意的作用或与锁定项的冲突 |
+| 分镜与提示词 | 可用剧本、导演决定和所需资产 | 分镜请求交可读设计，提示词请求才交六模块；数字10内部适用性覆盖 | 具体镜头、调度、时长或连续性问题 |
+| 可选白模 | 明确预演请求及已写好的镜头方案 | 可播放的3D机位与基础走位预演、编译合同、验证记录 | 编译解释或未通过的动作门 |
+| 生成与后期 | 明确实际视频请求、选定材料、可用工具和执行授权 | 真实素材、选片、剪辑、对白、音效和音乐 | 失败镜头或后期环节 |
+| 验收 | 最终渲染文件 | 完整播放检查、修复结果和用户决定 | 最早影响观看的实际缺陷 |
+
+分镜入口在明确作品目录内保存导演意图、已选镜头、进入/退出状态和来源哈希，并恢复当前场所需知识。保存与恢复、明确几何检查、设计语义审阅、用户审美和真实视频效果分别验证。程序不自动评判好不好看，也不能强制所有聊天入口执行。
+
+## 21项影视职责与1项网页辅助
+
+计数口径：本仓库分发 **18项常规＋3项实验＝21个模块**，其中20项用于影视、1项用于网页。工作流另列外部仙侠技能，因此是 **21项影视职责＋1项网页辅助**；外部仙侠不计入本仓库21个模块、42份双语指南或ZIP。
+
+| # | Skill | 职责与交付 | 分发/使用边界 |
+|---|---|---|---|
+| 1 | [director-agent](skills/zh-CN/director-agent.md) | 剧本创作、编辑、诊断；导演方案；明确需要时另编译AI执行剧本 | 常规；已有批准导演方案不重新导演 |
+| 2 | [ai-storyboard-director](skills/zh-CN/ai-storyboard-director.md) | 5.7.1分镜、观众体验与摄影、分阶段提示词、作品内保存与恢复 | 当前A5.7.1按明确用户指令采用；待修和审美状态另列，旧Release ZIP未更新 |
+| 3 | [character-asset](skills/zh-CN/character-asset.md) | 人物主参考、必要视图、身份和状态合同 | 按请求交提示词或实际图；用户审阅后锁定 |
+| 4 | [scene-asset](skills/zh-CN/scene-asset.md) | 场景结构、空间锚点、光源与必要参考图 | 不因换机位重建场景 |
+| 5 | [prop-asset](skills/zh-CN/prop-asset.md) | 道具结构、材质、比例和状态参考 | 单图不自动扩成多格；保留真实塑料、新物和设计发光 |
+| 6 | [cyberpunk-design](skills/zh-CN/cyberpunk-design.md) | 技术与人的关系、功能光、空间层级 | 不强制雨夜、霓虹或湿地 |
+| 7 | [epic-design](skills/zh-CN/epic-design.md) | 群体、地形、建筑和人物代价形成尺度 | 不只靠巨物和广角 |
+| 8 | [fantasy-design](skills/zh-CN/fantasy-design.md) | 世界规则、魔法目标与环境反馈 | 奇幻效果仍有具体作用 |
+| 9 | [horror-design](skills/zh-CN/horror-design.md) | 威胁、异常证据、显露与空间不安 | 不依靠死黑或血腥 |
+| 10 | [noir-design](skills/zh-CN/noir-design.md) | 秘密、犯罪、关系压力和明暗信息 | 不等于黑白滤镜 |
+| 11 | [romance-design](skills/zh-CN/romance-design.md) | 距离、视线、动作与关系变化 | 不强制粉色、暖光或拥抱 |
+| 12 | [war-design](skills/zh-CN/war-design.md) | 地形、协同、负荷、行动与后果 | 不用装饰爆炸替代战争处境 |
+| 13 | [wuxia-design](skills/zh-CN/wuxia-design.md) | 兵器、步法、支撑、接触与东方空间 | 静态交叉不证明动态攻防通过 |
+| 14 | [hard-sci-fi-visual-director](skills/zh-CN/hard-sci-fi-visual-director.md) | 物理、功能、制造、环境及原创硬科幻视觉 | 本仓库实验包；有用户接受图例，未证明所有任务稳定 |
+| 15 | [xianxia-visual-director](https://github.com/liyue-aigc/xianxia-visual-director) | 东方仙侠世界、天宫巨构与写实摄影 | 外部上游；无已核实再分发许可，不复制源码或打包 |
+| 16 | [whitebox-previs-executor](skills/zh-CN/whitebox-previs-executor.md) | 提示词到可播放3D基础预演 | 实验包；人形和已实现代理，打斗必须逐动作过门 |
+| 17 | [produce-ai-video](skills/zh-CN/produce-ai-video.md) | 统筹实际生成、选片、剪辑、声音、完整看片与修复 | 需要实际工具、模型与相应权限；不内置免费模型 |
+| 18 | [ai-short-drama-production](skills/zh-CN/ai-short-drama-production.md) | 短剧节拍、资产、调度、光线、动作与QC控制合同 | 独立合同按请求交分镜或提示词；未安装，实际视频待验证 |
+| 19 | [d-official-market-analysis](skills/zh-CN/d-official-market-analysis.md) | 选题与平台研究、来源、数据、结论与独立待批准记录 | 按需研究；报告不授权知识写入 |
+| 20 | [d-data-analysis-semantic-layer](skills/zh-CN/d-data-analysis-semantic-layer.md) | 用户批准后校验、版本化写入与回读 | 目标和批准来自当前任务；已存知识仍检查时效 |
+| 21 | [guofeng-visual-director](skills/zh-CN/guofeng-visual-director.md) | 古风文化、空间、人物器物、构图光色与完整图像提示词 | 候选实验包；不自动视为历史准确还原 |
+| 辅助 | [web-design-director](skills/zh-CN/web-design-director.md) | 作品站、资产库、工作台和网页展示 | 只用于明确网页或应用界面任务；仓库README维护不触发建站 |
+
+十一种视觉路线＝八项常规类型＋实验硬科幻＋外部仙侠＋古风候选。选择取决于作品，不要求一次加载十一项，也不把风格名变成统一色表或固定镜头。
+
+## 证据与当前边界
+
+本轮21张视觉成果均已由用户接受，其中19张为原创生成静帧，2张为原创网页原型的真实浏览器截图；原幅展示及逐文件状态见[展示清单](showcase/manifest.json)。这只证明这些具体结果已被接受；没有旧版同题A/B，也没有跨任务稳定性或真人可用性研究。完整视频仍须生成、完整播放、修复并单独验收。
+
+当前源码的分镜入口为A5.7.1，已按明确用户指令采用；首轮测试中的已知问题与审美接受状态分别保留。公开v1.3.0 Release是含5.4.4的旧快照；另行分发的5.6独立Preview有自己的标签和范围。更新源码、构建ZIP、推送Git和发布新Release是不同动作，见[安装说明](INSTALLATION.md)。
@@ -0,0 +1,126 @@
+# ai-storyboard-director｜剧本转分镜与提示词
+
+| 状态 | 源码A5.7.1已按明确用户指令采用；已知图像问题与审美验收分别保留；历史ZIP不变。 |
+|---|---|
+| 单独可交付 | 按当前阶段交创意镜头思路、可读分镜或可复制提示词；点名多种产物才分别交付。 |
+| 单独不能声称 | 不改写剧本、不直接生成视频，也不证明平台生成成功。 |
+
+[运行正文 `SKILL.md`](../../../skills/ai-storyboard-director/SKILL.md) · [v1.3.0 历史 ZIP](https://github.com/62656456/ai-film-skills/releases/download/v1.3.0/ai-storyboard-director.zip) · [安装说明](../../INSTALLATION.md) · [兼容说明](../../COMPATIBILITY.md) · [设计总则](../../SKILL_DESIGN_SYSTEM.md)
+
+v1.3.0旧ZIP包含5.4.4；当前源码为单独采用的A5.7.1。
+
+<!-- contract:purpose -->
+## 1. 设计目的
+
+设计观众观看顺序、调度、摄影、时长与连续性；按请求另供创意备选或编译已选镜头。
+
+<!-- contract:principles -->
+## 2. 设计理念
+
+- 剧情因果、人物目的、调度和空间行动先于镜头术语。
+- 人物调度与摄影机共同设计；复合运镜必须有可见起点、触发、阶段和终点。
+- 世界状态固定；每次换机位都重新计算当前画面的投影。
+- 设计观众体验与场所运行，保留已选环境活动，不强制运动、天气或空气颗粒。
+
+<!-- contract:standalone -->
+## 3. 适合单独使用的范围
+
+当点名结果落在以下边界内时，可以只拿这一个模块使用：
+
+按当前阶段交创意镜头思路、可读分镜或可复制提示词；点名多种产物才分别交付。
+
+**单独不能声称:** 不改写剧本、不直接生成视频，也不证明平台生成成功。
+
+<!-- contract:inputs -->
+## 4. 输入
+
+- 已批准的剧本或片段，包含完整剧情事实、台词和用户锁定的镜头决定。
+- 总时长、画幅、已知平台、批准资产和入场世界状态。
+- 尚未解决的导演判断必须明确，不能藏进镜头术语。
+
+<!-- contract:workflow -->
+## 5. 流程逻辑
+
+1. 先读因果、人物目标、关系、情绪、空间、动作和连续性。
+2. 先固定世界状态并设计调度，再选择摄影机投影。
+3. 在明确作品目录中实际恢复设计记录和所需知识，以版本与哈希检查保存意图、镜头和状态，再回读结果。
+4. 构建镜头句、丰富覆盖和分阶段摄影机事件，让剧情拍点可见。
+5. 用户要创意思路时，实际展示观看策略不同的候选；未采用内容不进入主镜序与提示词。
+6. 分镜请求交可读设计；提示词请求或已授权视频生成阶段才编译一条六模块母稿。
+7. 执行当前包完成门，反向核对提示词格式化是否保留已选摄影设计；只交付点名创作成果与真实边界。
+
+<!-- contract:returns -->
+## 6. 退回、重做与版本回滚
+
+- 故事或导演问题退回上游；空间、调度、摄影机、时长或提示词编译问题退回对应设计阶段。
+- 技能包维护不同于创作回炉；分享 ZIP 只包含当前独立运行内容，不含历史运行依赖。
+- 连续性失败从固定世界坐标修复，不能为了保持画面左右而移动房间。
+
+<!-- contract:review -->
+## 7. 审核门
+
+- [ ] 镜头保留剧本事实、人物目的、动作结果、台词和用户锁定顺序。
+- [ ] 摄影机、调度、纵深、焦点、运动与剪辑形成镜头句，而不是轮换术语。
+- [ ] 时长闭合；台词、世界投影、出框主体、光向、道具和尾帧状态连续。
+
+<!-- contract:pass -->
+## 8. 过关标准与状态
+
+- 当前包完成门通过，且人读分镜无需工程字段即可理解。
+- 适用信息在编译中保全；结构与文字检查不证明实际视频执行或审美接受。
+
+> 下方“通过”只表示本模块规定的审核门已通过；结构有效、真实任务证据和用户接受必须分开记录。
+
+<!-- contract:outputs -->
+## 9. 输出
+
+- 创意镜头以独立文字备选交付，说明故事作用、可见过程、前后衔接与取舍；采用只修改选中设计，不自动授权生成。
+- 可读分镜或用户既定镜头表；提示词请求才交六模块母稿，两者都要才分别交付。
+- 使用六模块外层和数字10信息内核的可复制正式提示词。
+
+<!-- contract:boundaries -->
+## 10. 边界、依赖与权限
+
+- 不改写锁定剧情事实或台词，不虚构平台能力或生成成功。
+- 分镜完成不等于成片，也不等于用户通过视觉结果。
+- 5.6程序检查已记录状态、时间与明确几何，不评审美、不证明图像/视频语义，也不能强制每个聊天入口执行；无作品目录的文字咨询不虚构持久化。
+- 创意镜头以独立文字备选交付，说明故事作用、可见过程、前后衔接与取舍；采用只修改选中设计，不自动授权生成。
+
+<!-- contract:agents -->
+## 11. 跨 Agent 使用
+
+- 标准包是完整 Skill 文件夹，不是只复制一段提示词。
+- `agents/openai.yaml` 只是 Codex 的可选界面元数据，不是其他宿主的运行依赖。
+- 文本分镜需完整文件夹；项目保存恢复另需授权文件能力和包内Python标准库程序；媒体执行另需模型工具权限。
+- Agent 能阅读指令不等于原生发现或原生执行；提示词回退不能写成原生兼容。
+
+<!-- contract:sources -->
+## 12. 原始文件与引用
+
+**运行正文与元数据**
+
+- [`agents/openai.yaml`](../../../skills/ai-storyboard-director/agents/openai.yaml)
+- [`SKILL.md`](../../../skills/ai-storyboard-director/SKILL.md)
+
+**引用资料**
+
+- [`references/camera-motion-diagnostics.md`](../../../skills/ai-storyboard-director/references/camera-motion-diagnostics.md)
+- [`references/cinematography-design-engine.md`](../../../skills/ai-storyboard-director/references/cinematography-design-engine.md)
+- [`references/creative-shot-ideas.md`](../../../skills/ai-storyboard-director/references/creative-shot-ideas.md)
+- [`references/delivery-mode-guard.md`](../../../skills/ai-storyboard-director/references/delivery-mode-guard.md)
+- [`references/design-memory-protocol.md`](../../../skills/ai-storyboard-director/references/design-memory-protocol.md)
+- [`references/fight-design.md`](../../../skills/ai-storyboard-director/references/fight-design.md)
+- [`references/fight-reference-case.md`](../../../skills/ai-storyboard-director/references/fight-reference-case.md)
+- [`references/framing-and-axis.md`](../../../skills/ai-storyboard-director/references/framing-and-axis.md)
+- [`references/production-contract.md`](../../../skills/ai-storyboard-director/references/production-contract.md)
+- [`references/shot-design-engine.md`](../../../skills/ai-storyboard-director/references/shot-design-engine.md)
+
+**确定性辅助脚本**
+
+- [`scripts/design_memory.py`](../../../skills/ai-storyboard-director/scripts/design_memory.py)
+
+**新构建 ZIP 的分发许可文件**
+
+新构建会将下列文件附在 ZIP 内的 Skill 目录，不修改运行源码；既有历史 Release 附件不变。
+
+- [`LICENSE`](../../../LICENSE)
@@ -0,0 +1,115 @@
+# character-asset｜人物身份资产合同
+
+| 状态 | 当前源码为隔离整改候选；既有安装记录与用户接受另列。 |
+|---|---|
+| 单独可交付 | 人物参考图任务、视图计划、锁定特征清单、负向约束和 JSON 合同。 |
+| 单独不能声称 | 没有生图工具和视觉审核时，不能声称人物图已存在或已批准。 |
+
+[运行正文 `SKILL.md`](../../../skills/character-asset/SKILL.md) · [v1.3.0 历史 ZIP](https://github.com/62656456/ai-film-skills/releases/download/v1.3.0/character-asset.zip) · [安装说明](../../INSTALLATION.md) · [兼容说明](../../COMPATIBILITY.md) · [设计总则](../../SKILL_DESIGN_SYSTEM.md)
+
+v1.3.0历史快照；已更新模块与当前源码不同。
+
+<!-- contract:purpose -->
+## 1. 设计目的
+
+定义人物稳定身份、多视角、表情、动作、服装、材质和允许状态变化，供下游连续性使用。
+
+<!-- contract:principles -->
+## 2. 设计理念
+
+- 先建立可审核、可版本化的资产身份，再进入分镜或视频生产。
+- 平台适配可以改变语法，但不能改变已批准的 `locked_features` 和状态历史。
+- 静态资产合同把身份、允许状态变化、材质、几何、布光和下游引用分开。
+- 联合推导注意力、主体分离、有来源光影、尺度与细节层次。单图不自动变多格；按设计保留新塑料和有依据的发光。
+- 局部修订复用未变原文与相关上下文；资产编号留内部，未审参考限制正式生成，不阻断候选文字设计。
+- 人物连续性优先锁定五官、体型、发型、服装层次、配饰、年龄和非人结构，不让装饰风格压过身份。
+
+<!-- contract:standalone -->
+## 3. 适合单独使用的范围
+
+当点名结果落在以下边界内时，可以只拿这一个模块使用：
+
+人物参考图任务、视图计划、锁定特征清单、负向约束和 JSON 合同。
+
+**单独不能声称:** 没有生图工具和视觉审核时，不能声称人物图已存在或已批准。
+
+<!-- contract:inputs -->
+## 4. 输入
+
+- 唯一资产编号、版本、用途、已知来源事实和仍未知字段。
+- 所需视图、状态、尺度参照、目标平台和已批准参考图。
+- 下游连续性所需的锁定特征、可变状态、朝向、持用关系或空间锚点。
+
+<!-- contract:workflow -->
+## 5. 流程逻辑
+
+1. 先选择仅提示词、实际图或局部诊断交付，以及摄影写实、三维动画或二维插画成像，再使用模板。
+2. 提取必填维度，缺失事实明确标记，不臆造。
+3. 锁定身份、几何、材质、物理行为、布光和状态规则。
+4. 选择必要视图或状态图，编译平台适配的生成任务。
+5. 执行模块质检并生成机读资产合同。
+6. 仅文本交付时像素检查保持not_evaluated；实际图失败才标rework，资产需明确人审才能批准。
+
+<!-- contract:returns -->
+## 6. 退回、重做与版本回滚
+
+- 身份或状态缺失退回输入；几何、材质、布光或交互失败退回对应合同字段。
+- 跨视图漂移退回锁定特征与主参考图，不能靠无关风格词修复。
+- 审核失败保持 `rework`，结构完成不能自动晋级。
+
+<!-- contract:review -->
+## 7. 审核门
+
+- [ ] 编号、版本、用途、必填维度、锁定特征和未知项明确。
+- [ ] 比例、透视、几何、材质、接触、重量、阴影和关键面物理自洽。
+- [ ] 无多余肢体、物件、文字、水印、漂移或抢主体的背景。
+- [ ] 五官、体型、发际线、服装、年龄、肢体数量、表情和所需视图保持同一身份。
+
+<!-- contract:pass -->
+## 8. 过关标准与状态
+
+- 资产任务和 JSON 合同通过模块检查，且没有未解决阻塞字段。
+- `assets_approved` 必须检查真实参考图；只有文本合同仍是待审状态。
+
+> 下方“通过”只表示本模块规定的审核门已通过；结构有效、真实任务证据和用户接受必须分开记录。
+
+<!-- contract:outputs -->
+## 9. 输出
+
+- 主参考图任务，以及确有必要的多视图或状态图任务。
+- 供分镜、提示词和质检使用的版本化 JSON 资产合同。
+
+<!-- contract:boundaries -->
+## 10. 边界、依赖与权限
+
+- 不臆造缺失事实、不覆盖批准特征，也不把视频动作和台词写进静态资产身份。
+- 没有生图工具和视觉审核时，本模块交付生成任务与合同，不能声称完成参考图。
+- 描述交互不新增图片任务；文字仍交文字，图片数量服从用户范围。
+
+<!-- contract:agents -->
+## 11. 跨 Agent 使用
+
+- 标准包是完整 Skill 文件夹，不是只复制一段提示词。
+- `agents/openai.yaml` 只是 Codex 的可选界面元数据，不是其他宿主的运行依赖。
+- 任何能读取文件夹的宿主都可输出文本合同；真实参考图还需要生图工具、文件能力和人类视觉审核。
+- Agent 能阅读指令不等于原生发现或原生执行；提示词回退不能写成原生兼容。
+
+<!-- contract:sources -->
+## 12. 原始文件与引用
+
+**运行正文与元数据**
+
+- [`agents/openai.yaml`](../../../skills/character-asset/agents/openai.yaml)
+- [`SKILL.md`](../../../skills/character-asset/SKILL.md)
+
+**引用资料**
+
+- [`references/cinematic-image-direction.md`](../../../skills/character-asset/references/cinematic-image-direction.md)
+- [`references/female-character-charm.md`](../../../skills/character-asset/references/female-character-charm.md)
+- [`references/NEGATIVE-CASE-BOOK.md`](../../../skills/character-asset/references/NEGATIVE-CASE-BOOK.md)
+
+**新构建 ZIP 的分发许可文件**
+
+新构建会将下列文件附在 ZIP 内的 Skill 目录，不修改运行源码；既有历史 Release 附件不变。
+
+- [`LICENSE`](../../../LICENSE)
@@ -0,0 +1,122 @@
+# director-agent｜剧本与导演设计
+
+| 状态 | 当前源码为隔离整改候选；既有安装记录与用户接受另列。 |
+|---|---|
+| 单独可交付 | 按请求交剧本、诊断、导演方案或分镜前设计；明确要完整分镜且导演判断未定时，用本包编译器独立交付可读分镜。 |
+| 单独不能声称 | 不把导演分析冒充完整分镜；已有获批导演方案直接继承。创意思路不授权媒体生成，也不证明用户接受。 |
+
+[运行正文 `SKILL.md`](../../../skills/director-agent/SKILL.md) · [v1.3.0 历史 ZIP](https://github.com/62656456/ai-film-skills/releases/download/v1.3.0/director-agent.zip) · [安装说明](../../INSTALLATION.md) · [兼容说明](../../COMPATIBILITY.md) · [设计总则](../../SKILL_DESIGN_SYSTEM.md)
+
+v1.3.0历史快照；已更新模块与当前源码不同。
+
+<!-- contract:purpose -->
+## 1. 设计目的
+
+创作、修改或诊断剧本，并完成进入完整分镜前必须成立的导演判断。
+
+<!-- contract:principles -->
+## 2. 设计理念
+
+- 先用人物行动和因果把故事讲清楚，再使用状态引擎、检查表和视觉润色。
+- 每个导演决定都必须落到观众效果、剧情功能、演员动作或物理画面。
+- 只有具备独立且获准的阅读环境时才记独立冷读；同上下文标SELF-AUDIT ONLY。两者都不替代写作或保证审美。
+
+<!-- contract:standalone -->
+## 3. 适合单独使用的范围
+
+当点名结果落在以下边界内时，可以只拿这一个模块使用：
+
+按请求交剧本、诊断、导演方案或分镜前设计；明确要完整分镜且导演判断未定时，用本包编译器独立交付可读分镜。
+
+**单独不能声称:** 不把导演分析冒充完整分镜；已有获批导演方案直接继承。创意思路不授权媒体生成，也不证明用户接受。
+
+<!-- contract:inputs -->
+## 4. 输入
+
+- 剧本、故事、梗概、纯对白、小说段落或抽象材料，以及点名的工作模式。
+- 已锁定事实、格式、长度、受众、生产约束，以及已批准或禁止的决定。
+- 未知故事事实保持为假设，不能静默补成设定。
+
+<!-- contract:workflow -->
+## 5. 流程逻辑
+
+1. 只加载与当前任务有关的写作和导演引用。
+2. 按故事、人物、导演三层读材料，核对刺激、目标、策略、状态变化和对白回应。
+3. 选择创作、诊断、导演方案、工作台或分镜前设计模式。
+4. 从因果判断生成视觉概念、表演动作、声音、时间、剪辑、主题和潜台词。
+5. 审核真实剧本并披露隔离等级，修复最早上游断裂，优先交付可读成品；仅明确需要时另编译AI执行层。
+
+<!-- contract:returns -->
+## 6. 退回、重做与版本回滚
+
+- 因果、人物知识或场景目的失败时，先退回最早断裂的场景，不先润色台词或视觉。
+- 若明确要求完整分镜且导演层未定，先完成DIRECTOR_PLAN，再用本包编译器交付；已有批准方案则交给匹配分镜入口，不重新解释。
+- 冷读 PASS 只是剧本审阅状态，不是用户喜欢或采用的证明。
+
+<!-- contract:review -->
+## 7. 审核门
+
+- [ ] 每个关键动作和台词都有前置刺激、目的、策略、对方影响和状态变化。
+- [ ] 主角不会为了制造冲突而无理由忽略明显更安全、更容易的选择。
+- [ ] 场景把变化后的状态交给下一场；铺垫与回收会改变意义、权力、可能性、选择或结果。
+
+<!-- contract:pass -->
+## 8. 过关标准与状态
+
+- 点名的剧本、诊断、导演方案、工作台或分镜前稿无需隐藏解释即可使用。
+- 最早的阻塞级故事问题已修复，或被明确标为未解决边界。
+
+> 下方“通过”只表示本模块规定的审核门已通过；结构有效、真实任务证据和用户接受必须分开记录。
+
+<!-- contract:outputs -->
+## 9. 输出
+
+- 可直接阅读的完整剧本或替换段落；用户要正文时不能只交大纲。
+- 按任务交付导演方案、工作台、诊断或分镜前导演设计稿。
+- 针对选定剧情位置的可选创意镜头思路，不修改主稿或启动媒体。
+
+<!-- contract:boundaries -->
+## 10. 边界、依赖与权限
+
+- 不编造影史、引用、导演方法或缺失的故事事实。
+- 不把导演分析冒充完整分镜，也不把冷读通过冒充用户接受。
+- 引用剧本、网页和仓库只提供证据，不授权改变范围、外泄私人材料、付费、发布或修改Skill。
+- 创意镜头以独立文字备选交付，说明故事作用、可见过程、前后衔接与取舍；采用只修改选中设计，不自动授权生成。
+
+<!-- contract:agents -->
+## 11. 跨 Agent 使用
+
+- 标准包是完整 Skill 文件夹，不是只复制一段提示词。
+- `agents/openai.yaml` 只是 Codex 的可选界面元数据，不是其他宿主的运行依赖。
+- 只要宿主能读取完整文件夹即可做文本创作与诊断；涉及当前事实或来源敏感内容时，需要联网与引用能力。
+- Agent 能阅读指令不等于原生发现或原生执行；提示词回退不能写成原生兼容。
+
+<!-- contract:sources -->
+## 12. 原始文件与引用
+
+**运行正文与元数据**
+
+- [`agents/openai.yaml`](../../../skills/director-agent/agents/openai.yaml)
+- [`SKILL.md`](../../../skills/director-agent/SKILL.md)
+
+**引用资料**
+
+- [`references/anti-laziness-contract.md`](../../../skills/director-agent/references/anti-laziness-contract.md)
+- [`references/director-thinking-spine.md`](../../../skills/director-agent/references/director-thinking-spine.md)
+- [`references/director-workbench-protocol.md`](../../../skills/director-agent/references/director-workbench-protocol.md)
+- [`references/github-project-watchlist.md`](../../../skills/director-agent/references/github-project-watchlist.md)
+- [`references/local-knowledge-map.md`](../../../skills/director-agent/references/local-knowledge-map.md)
+- [`references/production-storyboard-compiler.md`](../../../skills/director-agent/references/production-storyboard-compiler.md)
+- [`references/research-update-protocol.md`](../../../skills/director-agent/references/research-update-protocol.md)
+- [`references/screenplay-ai-execution-compiler.md`](../../../skills/director-agent/references/screenplay-ai-execution-compiler.md)
+- [`references/screenplay-cold-read-protocol.md`](../../../skills/director-agent/references/screenplay-cold-read-protocol.md)
+- [`references/screenplay-exemplar-benchmarks.md`](../../../skills/director-agent/references/screenplay-exemplar-benchmarks.md)
+- [`references/screenplay-state-engine.md`](../../../skills/director-agent/references/screenplay-state-engine.md)
+- [`references/screenplay-writing-core.md`](../../../skills/director-agent/references/screenplay-writing-core.md)
+- [`references/verified-director-logic.md`](../../../skills/director-agent/references/verified-director-logic.md)
+
+**新构建 ZIP 的分发许可文件**
+
+新构建会将下列文件附在 ZIP 内的 Skill 目录，不修改运行源码；既有历史 Release 附件不变。
+
+- [`LICENSE`](../../../LICENSE)
@@ -0,0 +1,114 @@
+# prop-asset｜道具身份与状态合同
+
+| 状态 | 当前源码为隔离整改候选；既有安装记录与用户接受另列。 |
+|---|---|
+| 单独可交付 | 道具参考图任务、交互/状态视图、锁定持用规则、负向约束和 JSON 合同。 |
+| 单独不能声称 | 不负责完整场面调度，也不能在真实参考图和镜头未审时证明持用正确。 |
+
+[运行正文 `SKILL.md`](../../../skills/prop-asset/SKILL.md) · [v1.3.0 历史 ZIP](https://github.com/62656456/ai-film-skills/releases/download/v1.3.0/prop-asset.zip) · [安装说明](../../INSTALLATION.md) · [兼容说明](../../COMPATIBILITY.md) · [设计总则](../../SKILL_DESIGN_SYSTEM.md)
+
+v1.3.0历史快照；已更新模块与当前源码不同。
+
+<!-- contract:purpose -->
+## 1. 设计目的
+
+定义道具身份、尺度、材质、可用面、接口、持有人、朝向、磨损、操作和状态变化。
+
+<!-- contract:principles -->
+## 2. 设计理念
+
+- 先建立可审核、可版本化的资产身份，再进入分镜或视频生产。
+- 平台适配可以改变语法，但不能改变已批准的 `locked_features` 和状态历史。
+- 静态资产合同把身份、允许状态变化、材质、几何、布光和下游引用分开。
+- 联合推导注意力、主体分离、有来源光影、尺度与细节层次。单图不自动变多格；按设计保留新塑料和有依据的发光。
+- 局部修订复用未变原文与相关上下文；资产编号留内部，未审参考限制正式生成，不阻断候选文字设计。
+- 道具通过可用面、持有人、朝向、开合/损伤状态和物理接触追踪，不能只靠名称。
+
+<!-- contract:standalone -->
+## 3. 适合单独使用的范围
+
+当点名结果落在以下边界内时，可以只拿这一个模块使用：
+
+道具参考图任务、交互/状态视图、锁定持用规则、负向约束和 JSON 合同。
+
+**单独不能声称:** 不负责完整场面调度，也不能在真实参考图和镜头未审时证明持用正确。
+
+<!-- contract:inputs -->
+## 4. 输入
+
+- 唯一资产编号、版本、用途、已知来源事实和仍未知字段。
+- 所需视图、状态、尺度参照、目标平台和已批准参考图。
+- 下游连续性所需的锁定特征、可变状态、朝向、持用关系或空间锚点。
+
+<!-- contract:workflow -->
+## 5. 流程逻辑
+
+1. 先选择仅提示词、实际图或局部诊断交付，以及摄影写实、三维动画或二维插画成像，再使用模板。
+2. 提取必填维度，缺失事实明确标记，不臆造。
+3. 锁定身份、几何、材质、物理行为、布光和状态规则。
+4. 选择必要视图或状态图，编译平台适配的生成任务。
+5. 执行模块质检并生成机读资产合同。
+6. 仅文本交付时像素检查保持not_evaluated；实际图失败才标rework，资产需明确人审才能批准。
+
+<!-- contract:returns -->
+## 6. 退回、重做与版本回滚
+
+- 身份或状态缺失退回输入；几何、材质、布光或交互失败退回对应合同字段。
+- 跨视图漂移退回锁定特征与主参考图，不能靠无关风格词修复。
+- 审核失败保持 `rework`，结构完成不能自动晋级。
+
+<!-- contract:review -->
+## 7. 审核门
+
+- [ ] 编号、版本、用途、必填维度、锁定特征和未知项明确。
+- [ ] 比例、透视、几何、材质、接触、重量、阴影和关键面物理自洽。
+- [ ] 无多余肢体、物件、文字、水印、漂移或抢主体的背景。
+- [ ] A/B 面、尺寸、持有人、朝向、接口、开合状态、材质、磨损和状态变化无歧义。
+
+<!-- contract:pass -->
+## 8. 过关标准与状态
+
+- 资产任务和 JSON 合同通过模块检查，且没有未解决阻塞字段。
+- `assets_approved` 必须检查真实参考图；只有文本合同仍是待审状态。
+
+> 下方“通过”只表示本模块规定的审核门已通过；结构有效、真实任务证据和用户接受必须分开记录。
+
+<!-- contract:outputs -->
+## 9. 输出
+
+- 主参考图任务，以及确有必要的多视图或状态图任务。
+- 供分镜、提示词和质检使用的版本化 JSON 资产合同。
+
+<!-- contract:boundaries -->
+## 10. 边界、依赖与权限
+
+- 不臆造缺失事实、不覆盖批准特征，也不把视频动作和台词写进静态资产身份。
+- 没有生图工具和视觉审核时，本模块交付生成任务与合同，不能声称完成参考图。
+- 描述交互不新增图片任务；文字仍交文字，图片数量服从用户范围。
+
+<!-- contract:agents -->
+## 11. 跨 Agent 使用
+
+- 标准包是完整 Skill 文件夹，不是只复制一段提示词。
+- `agents/openai.yaml` 只是 Codex 的可选界面元数据，不是其他宿主的运行依赖。
+- 任何能读取文件夹的宿主都可输出文本合同；真实参考图还需要生图工具、文件能力和人类视觉审核。
+- Agent 能阅读指令不等于原生发现或原生执行；提示词回退不能写成原生兼容。
+
+<!-- contract:sources -->
+## 12. 原始文件与引用
+
+**运行正文与元数据**
+
+- [`agents/openai.yaml`](../../../skills/prop-asset/agents/openai.yaml)
+- [`SKILL.md`](../../../skills/prop-asset/SKILL.md)
+
+**引用资料**
+
+- [`references/cinematic-image-direction.md`](../../../skills/prop-asset/references/cinematic-image-direction.md)
+- [`references/NEGATIVE-CASE-BOOK.md`](../../../skills/prop-asset/references/NEGATIVE-CASE-BOOK.md)
+
+**新构建 ZIP 的分发许可文件**
+
+新构建会将下列文件附在 ZIP 内的 Skill 目录，不修改运行源码；既有历史 Release 附件不变。
+
+- [`LICENSE`](../../../LICENSE)
@@ -0,0 +1,114 @@
+# scene-asset｜场景与空间资产合同
+
+| 状态 | 当前源码为隔离整改候选；既有安装记录与用户接受另列。 |
+|---|---|
+| 单独可交付 | 场景参考图任务、空间锚点与反向视图计划、光影材质规则和 JSON 合同。 |
+| 单独不能声称 | 不替代剧情调度，也不能在未检查真实图片时证明场景空间一致。 |
+
+[运行正文 `SKILL.md`](../../../skills/scene-asset/SKILL.md) · [v1.3.0 历史 ZIP](https://github.com/62656456/ai-film-skills/releases/download/v1.3.0/scene-asset.zip) · [安装说明](../../INSTALLATION.md) · [兼容说明](../../COMPATIBILITY.md) · [设计总则](../../SKILL_DESIGN_SYSTEM.md)
+
+v1.3.0历史快照；已更新模块与当前源码不同。
+
+<!-- contract:purpose -->
+## 1. 设计目的
+
+用布局、出入口、固定标志、尺度、光源、材质、摄影机可达区和连续状态定义可复用场景。
+
+<!-- contract:principles -->
+## 2. 设计理念
+
+- 先建立可审核、可版本化的资产身份，再进入分镜或视频生产。
+- 平台适配可以改变语法，但不能改变已批准的 `locked_features` 和状态历史。
+- 静态资产合同把身份、允许状态变化、材质、几何、布光和下游引用分开。
+- 联合推导注意力、主体分离、有来源光影、尺度与细节层次。单图不自动变多格；按设计保留新塑料和有依据的发光。
+- 局部修订复用未变原文与相关上下文；资产编号留内部，未审参考限制正式生成，不阻断候选文字设计。
+- 场景是可行走的世界模型，不是一张漂亮角度；反向视图必须来自同一布局。
+
+<!-- contract:standalone -->
+## 3. 适合单独使用的范围
+
+当点名结果落在以下边界内时，可以只拿这一个模块使用：
+
+场景参考图任务、空间锚点与反向视图计划、光影材质规则和 JSON 合同。
+
+**单独不能声称:** 不替代剧情调度，也不能在未检查真实图片时证明场景空间一致。
+
+<!-- contract:inputs -->
+## 4. 输入
+
+- 唯一资产编号、版本、用途、已知来源事实和仍未知字段。
+- 所需视图、状态、尺度参照、目标平台和已批准参考图。
+- 下游连续性所需的锁定特征、可变状态、朝向、持用关系或空间锚点。
+
+<!-- contract:workflow -->
+## 5. 流程逻辑
+
+1. 先选择仅提示词、实际图或局部诊断交付，以及摄影写实、三维动画或二维插画成像，再使用模板。
+2. 提取必填维度，缺失事实明确标记，不臆造。
+3. 锁定身份、几何、材质、物理行为、布光和状态规则。
+4. 选择必要视图或状态图，编译平台适配的生成任务。
+5. 执行模块质检并生成机读资产合同。
+6. 仅文本交付时像素检查保持not_evaluated；实际图失败才标rework，资产需明确人审才能批准。
+
+<!-- contract:returns -->
+## 6. 退回、重做与版本回滚
+
+- 身份或状态缺失退回输入；几何、材质、布光或交互失败退回对应合同字段。
+- 跨视图漂移退回锁定特征与主参考图，不能靠无关风格词修复。
+- 审核失败保持 `rework`，结构完成不能自动晋级。
+
+<!-- contract:review -->
+## 7. 审核门
+
+- [ ] 编号、版本、用途、必填维度、锁定特征和未知项明确。
+- [ ] 比例、透视、几何、材质、接触、重量、阴影和关键面物理自洽。
+- [ ] 无多余肢体、物件、文字、水印、漂移或抢主体的背景。
+- [ ] 出入口、固定标志、光源、尺度、可通行路径和反向视图在同一空间模型中一致。
+
+<!-- contract:pass -->
+## 8. 过关标准与状态
+
+- 资产任务和 JSON 合同通过模块检查，且没有未解决阻塞字段。
+- `assets_approved` 必须检查真实参考图；只有文本合同仍是待审状态。
+
+> 下方“通过”只表示本模块规定的审核门已通过；结构有效、真实任务证据和用户接受必须分开记录。
+
+<!-- contract:outputs -->
+## 9. 输出
+
+- 主参考图任务，以及确有必要的多视图或状态图任务。
+- 供分镜、提示词和质检使用的版本化 JSON 资产合同。
+
+<!-- contract:boundaries -->
+## 10. 边界、依赖与权限
+
+- 不臆造缺失事实、不覆盖批准特征，也不把视频动作和台词写进静态资产身份。
+- 没有生图工具和视觉审核时，本模块交付生成任务与合同，不能声称完成参考图。
+- 描述交互不新增图片任务；文字仍交文字，图片数量服从用户范围。
+
+<!-- contract:agents -->
+## 11. 跨 Agent 使用
+
+- 标准包是完整 Skill 文件夹，不是只复制一段提示词。
+- `agents/openai.yaml` 只是 Codex 的可选界面元数据，不是其他宿主的运行依赖。
+- 任何能读取文件夹的宿主都可输出文本合同；真实参考图还需要生图工具、文件能力和人类视觉审核。
+- Agent 能阅读指令不等于原生发现或原生执行；提示词回退不能写成原生兼容。
+
+<!-- contract:sources -->
+## 12. 原始文件与引用
+
+**运行正文与元数据**
+
+- [`agents/openai.yaml`](../../../skills/scene-asset/agents/openai.yaml)
+- [`SKILL.md`](../../../skills/scene-asset/SKILL.md)
+
+**引用资料**
+
+- [`references/cinematic-image-direction.md`](../../../skills/scene-asset/references/cinematic-image-direction.md)
+- [`references/NEGATIVE-CASE-BOOK.md`](../../../skills/scene-asset/references/NEGATIVE-CASE-BOOK.md)
+
+**新构建 ZIP 的分发许可文件**
+
+新构建会将下列文件附在 ZIP 内的 Skill 目录，不修改运行源码；既有历史 Release 附件不变。
+
+- [`LICENSE`](../../../LICENSE)