阿拉丁 · AI短剧服化道租赁比价与管理工坊

短剧「物」的资源环：剧本拆完、场地定完，戏里的西装婚纱警服、钻戒红酒蛋糕去哪租、租还是买、押金给多少、谁保管谁归还——本工坊一次算清。上游消费拆本产物（逐场道具/服装明细），下游把成本回灌预算科目、把领用清单回灌拍摄通告。

何时使用（触发）

"这部短剧的道具和戏服去哪租？帮我比比价" —— 供应商 Top3 比价
"婚纱是租一天划算还是直接买？" —— 租 vs 买 break-even 决策
"服化道整体要花多少钱？押金占用多少？" —— 成本汇总 + 预算门禁
"开机前给我一份道具领用/归还检查单" —— 跨日保管人 + 归还核验手册
"剧里有警服和道具枪，有没有合规风险？" —— 管制/制式道具资质体检

何时不使用

拆解剧本得到逐场道具清单 —— 用拆本工序（本款消费其产物 _shoot_ir.json）
拍摄场地选址比价 —— 用勘景工序（管"场"，本款管"物"）
演员片酬与劳务结算 —— 用劳务结算工序（管"人"的钱）
全片制作预算总控 —— 用预算工序（本款只产"服化道"科目喂给它）
线上采买下单/爬电商价格 —— 本款不联网，报价由用户提供

能力边界

能做：九类服化道自动分类（婚纱/正装/制式/古装/日常/妆材/消耗/手持/陈设）；需求天数按场次工时自动估算；供应商报价中文表头别名归一 + ¥/万金额清洗；四维评分（价格0.35/成色0.20/起租匹配0.20/库存0.25）Top3 比价；易损/消耗强制买断判定与租满期成本 ≥ 买断价 70% 的租买切换；PR1-PR8 风险规则与 100 分门禁；押金资金占用单列。

不能做：不联网抓价、不代下单；不做服装设计与妆造方案；不识别图片实物成色；不处理运输物流排程；报价单之外的市场行情不臆测。

使用流程（三步）

# 1) 归集：拆本需求 × 供应商报价 → _props_ir.json
python scripts/props_ingest.py --shoot-ir _shoot_ir.json --suppliers suppliers.csv --out _props_ir.json

# 2) 决策：比价 + 租买 + 风险体检 → _props.json（--budget 可选预算上限，元）
python scripts/props_plan.py --ir _props_ir.json --budget 20000 --out _props.json

# 3) 报告：HTML 看板 + MD 手册 + CSV 台账
python scripts/props_report.py --plan _props.json --html props_board.html --md props_handbook.md --csv props_ledger.csv

试跑样例：assets/sample_shoot_ir.json + assets/sample_suppliers.csv（埋有 PR1-PR8 全部风险，预算 2000 元时门禁 BLOCK，可直接观察规则命中效果）。

输入与输出

| 输入 | 格式 | 说明 | |---|---|---| | --shoot-ir | _shoot_ir.json | 拆本产物（首选），逐场 props/wardrobe/characters/special | | --shoot | _shoot.json | 通告产物（兜底），master_lists 汇总 | | --suppliers | JSON / CSV | 供应商报价单；中文表头：供应商/品名/日租金/押金/买断价/成色/起租天数/库存/资质/城市 | | --budget | 数字（元） | 服化道预算上限，0=不设限 |

| 输出 | 内容 | |---|---| | _props_ir.json | 需求台账（分类/场次/复用天数/易损/管制）+ 报价台账 | | _props.json | 租买决策 + Top3 比价 + PR 风险 + 评分门禁 + feedback 回灌契约 | | props_board.html | 自包含决策看板（评分环 + 成本构成 + 决策表 + 比价表 + 风险表） | | props_handbook.md | 领用管理手册（租买清单/整改/保管归还检查单/缺供待补） | | props_ledger.csv | utf-8-sig 台账，Excel 直开 |

重要约束（TRACE）

T 可追溯：每条风险给出规则号 PR1-PR8 + 具体物品 + 量化依据；比价评分四维权重公开可复算
R 可复现：纯 stdlib 零依赖，同输入字节级一致（已验证 md5 双跑一致）
A 可审计：押金与租金分列（押金可退不计成本），预算超支比例精确到 0.1%
C 合规：管制/制式道具（道具枪/警服/军装/管制刀具等）内置知识库，供应商无资质即 P0 拦截
E 出错即停：任何输入缺失/解析失败 exit=2 并给中文原因，不产出半成品

feedback 回灌（流程闭环）

_props.json.feedback 供下游消费：to_shoot（跨日保管项 + 领用检查单就绪位）/ to_budget（服化道科目四项金额）/ to_location（陈设大件随场地打包建议）/ to_payroll（服装师最长复用天数）/ unresolved（缺供物品清单）/ blocking_rules（P0 规则号）。

深入阅读（按需展开）

| 文档 | 何时读 | |---|---| | references/decision-rules.md | 想了解 PR1-PR8 判定阈值、四维评分公式、租买 break-even 推导 | | references/data-contracts.md | 想对接上下游 JSON 契约字段、供应商表头别名全表 | | references/usage-examples.md | 想看埋雷样例逐条讲解与三条典型工作流 |