引擎注册表
引擎与工作流解耦：stub → 正式实现的换绑只发生在这里（registry.py）， input/output schema 即插槽契约。
admission.verifyv1.0.0正式引擎
挂牌/磋商前六维确定性核验：上传机构真实性、资料齐备、地理安全、财务模型健康、买家联络有效、担保承诺金；每维三态结论。
接口契约（JSON Schema）
{
"inputs": {
"type": "object",
"properties": {
"uploader": {
"type": [
"object",
"null"
]
},
"materials": {
"type": [
"object",
"null"
]
},
"hazard": {
"type": [
"object",
"null"
]
},
"finance": {
"type": [
"object",
"null"
]
},
"buyer": {
"type": [
"object",
"null"
]
}
}
},
"outputs": {
"type": "object",
"properties": {
"dimensions": {
"type": "array"
},
"overall": {
"type": "object"
}
}
}
}data.jp_marketv1.0.0正式引擎
日本电力交易数据获取：JEPX 现货/日内（区域价格·成交量·入札）、需給調整力 7 商品、電源種別別落札（蓄電池/VPP）、競争係数·落札率、OCCTO 机组别发电、連系線，及气象补充数据（气温/辐射/风/降水，47 站→9 电力区域）。DuckDB 只读，无网络依赖。
接口契约（JSON Schema）
{
"inputs": {
"type": "object",
"properties": {
"board": {
"type": "string",
"enum": [
"jepx",
"adjust",
"genmix",
"derived",
"weather",
"unit_gen",
"tieline"
],
"default": "jepx"
},
"market": {
"type": "string",
"default": "DAM"
},
"areas": {
"type": "array",
"items": {
"type": "string"
},
"default": [
"東京",
"関西"
]
},
"products": {
"type": "array",
"items": {
"type": "string"
},
"default": []
},
"metrics": {
"type": "array",
"items": {
"type": "string"
},
"default": []
},
"fields": {
"type": "array",
"items": {
"type": "string"
},
"default": []
},
"fuels": {
"type": "array",
"items": {
"type": "string"
},
"default": []
},
"variables": {
"type": "array",
"items": {
"type": "string"
},
"default": []
},
"date_from": {
"type": "string",
"default": ""
},
"date_to": {
"type": "string",
"default": ""
},
"granularity": {
"type": "string",
"enum": [
"block",
"hour",
"day"
],
"default": "day"
}
}
},
"outputs": {
"type": "object",
"properties": {
"board": {
"type": "string"
},
"coverage": {
"type": "object"
},
"series": {
"type": "array"
},
"row_count": {
"type": "integer"
}
}
}
}finance.cashflowv0.1.0stub 占位
现金流与指标（正式版：封装 Codex 财务引擎 V1，与 5002 对拍差异=0）
接口契约（JSON Schema）
{
"inputs": {
"type": "object",
"properties": {
"project_id": {
"type": "string"
},
"revenue_decomposition": {
"type": "object"
},
"scenario_overrides": {
"type": "object",
"default": {}
}
},
"required": [
"project_id",
"revenue_decomposition"
]
},
"outputs": {
"type": "object",
"properties": {
"irr_project": {
"type": "number"
},
"irr_equity": {
"type": "number"
},
"npv_jpy": {
"type": "number"
},
"payback_years": {
"type": "number"
},
"dscr_min": {
"type": "number"
}
}
}
}finance.excel_modelv1.0.0正式引擎
基线工作簿 5002：Parameters→14 表全量重算，输出投资概算/项目 IRR/Net IRR/买方 IRR（JPY/RMB/USD）。引擎为独立子进程服务。
接口契约（JSON Schema）
{
"inputs": {
"type": "object",
"properties": {
"c_kw": {
"type": "number",
"title": "契约电力 kW"
},
"c_pcskw": {
"type": "number",
"title": "PCS 出力 kW"
},
"c_kwh": {
"type": "number",
"title": "蓄电池容量 kWh"
},
"c_area": {
"type": "string",
"title": "地区电网（日文）"
}
}
},
"outputs": {
"type": "object",
"properties": {
"kpis": {
"type": "object"
},
"model": {
"type": "object"
},
"ms": {
"type": "number"
},
"workbook": {
"type": "string"
}
}
}
}finance.scenario_bandv1.0.0正式引擎
围绕 finance.excel_model 内核按 PCS 出力 ±band（缺省 10%）做悲观/中性/乐观三档真实重算，输出各档 IRR/KPI 矩阵，全部留痕，可审计复现。
接口契约（JSON Schema）
{
"inputs": {
"type": "object",
"properties": {
"c_kw": {
"type": "number",
"title": "契约电力 kW"
},
"c_pcskw": {
"type": "number",
"title": "PCS 出力 kW（情景基准）"
},
"c_kwh": {
"type": "number",
"title": "蓄电池容量 kWh"
},
"c_area": {
"type": "string",
"title": "地区电网（日文）"
},
"band": {
"type": "number",
"title": "出力波动带（缺省 0.10）"
}
},
"required": [
"c_kw",
"c_pcskw",
"c_kwh",
"c_area"
]
},
"outputs": {
"type": "object",
"properties": {
"matrix": {
"type": "object"
},
"band": {
"type": "number"
},
"kernel": {
"type": "string"
},
"ms": {
"type": "number"
}
}
}
}forecast.pricev0.1.0stub 占位
现货价 p50 + p10/p90 置信区间（正式版：LightGBM，30min block 滚动预测）
接口契约（JSON Schema）
{
"inputs": {
"type": "object",
"properties": {
"area": {
"type": "string",
"description": "现货区域，如 中部60Hz"
},
"start_date": {
"type": "string",
"format": "date"
},
"days": {
"type": "integer",
"default": 1
}
},
"required": [
"area",
"start_date"
]
},
"outputs": {
"type": "object",
"properties": {
"forecast_path": {
"type": "string",
"description": "parquet 路径，48 block × [p10,p50,p90]"
},
"mape_backtest": {
"type": "number",
"description": "回测 MAPE（验收阈值见 v0.1 M2）"
}
}
}
}governance.checklistv0.1.0stub 占位
土地/许可/并网/环保/消防 五类核验；缺失与过期自动亮红标（PDF 硬要求）
接口契约（JSON Schema）
{
"inputs": {
"type": "object",
"properties": {
"project_id": {
"type": "string"
},
"category": {
"type": "string",
"enum": [
"全部",
"土地权利",
"许可",
"并网",
"环保",
"消防"
]
}
},
"required": [
"project_id"
]
},
"outputs": {
"type": "object",
"properties": {
"verified_ratio": {
"type": "number"
},
"blocking_gaps": {
"type": "array",
"description": "阻断准入的缺失项"
}
}
}
}governance.decisionv0.1.0stub 占位
按核验结果与关键项出具准入结论（人工复核后生效）
接口契约（JSON Schema）
{
"inputs": {
"type": "object",
"properties": {
"verified_ratio": {
"type": "number"
},
"blocking_gaps": {
"type": "array"
}
},
"required": [
"verified_ratio",
"blocking_gaps"
]
},
"outputs": {
"type": "object",
"properties": {
"decision": {
"type": "string",
"enum": [
"admitted",
"conditional",
"rejected"
]
}
}
}
}hazard.screeningv0.1.0正式引擎
将 geo 网关取得的官方灾害图层观测（洪水/津波/高潮/土石流/急傾斜地/地すべり/雪崩 + 标高/起伏/海岸线距离）汇总为项目级风险摘要。
接口契约（JSON Schema）
{
"inputs": {
"type": "object",
"properties": {
"address": {
"type": "string"
},
"lat": {
"type": "number"
},
"lon": {
"type": "number"
},
"elevation_m": {
"type": "number"
},
"terrain": {
"type": "string"
},
"coast_distance_km": {
"type": [
"number",
"null"
]
},
"layers": {
"type": "object"
}
},
"required": [
"address",
"lat",
"lon"
]
},
"outputs": {
"type": "object",
"properties": {
"summary_grade": {
"type": "string"
},
"checks": {
"type": "object"
},
"notes": {
"type": "array"
}
}
}
}layout.estimatev0.1.0正式引擎
按 20 尺 5MWh 液冷舱 + 规划间距，由用地面积估算可布置单元数、装机 MW/MWh 与占地校验；估算值可人工修正（引擎不裁决）。
接口契约（JSON Schema）
{
"inputs": {
"type": "object",
"properties": {
"land_area_m2": {
"type": "number"
},
"target_capacity_mwh": {
"type": [
"number",
"null"
]
}
},
"required": [
"land_area_m2"
]
},
"outputs": {
"type": "object",
"properties": {
"modules": {
"type": "integer"
},
"capacity_mwh": {
"type": "number"
},
"power_mw": {
"type": "number"
},
"usable_area_m2": {
"type": "number"
},
"area_per_module_m2": {
"type": "number"
},
"fits_target": {
"type": [
"boolean",
"null"
]
},
"assumptions": {
"type": "object"
}
}
}
}ops.attributionv0.1.0stub 占位
价格错/优化错/执行错/衰减错 量化分解，占比和=100%（P1 闭环 B）
接口契约（JSON Schema）
{
"inputs": {
"type": "object",
"properties": {
"project_id": {
"type": "string"
},
"period": {
"type": "string",
"description": "如 2026-09"
}
},
"required": [
"project_id",
"period"
]
},
"outputs": {
"type": "object",
"properties": {
"deviation_total_jpy": {
"type": "number"
},
"shares": {
"type": "object"
}
}
}
}optimize.milpv0.1.0stub 占位
调频/套利/AIDC保供 联合分配（正式版：Pyomo+HiGHS，48×30min，SOC 守恒容差<1e-6）
接口契约（JSON Schema）
{
"inputs": {
"type": "object",
"properties": {
"forecast_path": {
"type": "string"
},
"project_id": {
"type": "string"
}
},
"required": [
"forecast_path",
"project_id"
]
},
"outputs": {
"type": "object",
"properties": {
"schedule_path": {
"type": "string",
"description": "96点充放计划 parquet"
},
"revenue_decomposition": {
"type": "object",
"description": "调频/套利/保供机会成本三分解"
}
}
}
}report.renderv0.1.0stub 占位
Jinja2 模板 → HTML/PDF（资产卡片/投资报告/月报，M7）
接口契约（JSON Schema）
{
"inputs": {
"type": "object",
"properties": {
"template": {
"type": "string",
"enum": [
"asset_card",
"investment",
"monthly",
"daily_plan"
]
},
"payload": {
"type": "object",
"description": "上游全部输出的汇总"
}
},
"required": [
"template",
"payload"
]
},
"outputs": {
"type": "object",
"properties": {
"report_path": {
"type": "string"
},
"format": {
"type": "string"
}
}
}
}scenario.matrixv0.1.0stub 占位
悲观/中性/乐观 × AIDC 负载三情景矩阵 + 单因素敏感性（龙卷风图数据）
接口契约（JSON Schema）
{
"inputs": {
"type": "object",
"properties": {
"base_kpis": {
"type": "object"
}
},
"required": [
"base_kpis"
]
},
"outputs": {
"type": "object",
"properties": {
"matrix": {
"type": "object"
},
"tornado": {
"type": "array"
}
}
}
}schedule.resource_planv1.0.0正式引擎
解析出让方项目管理计划表（Schedule 周列粒度）：任务条 + 里程碑 + 付款节点（映射财务模型 BOM 科目），双口径如实披露。
接口契约（JSON Schema）
{
"inputs": {
"type": "object",
"properties": {
"folder": {
"type": "string",
"title": "授权资料夹绝对路径",
"description": "出让方授权后平台可读取的资料目录"
},
"project_code": {
"type": "string",
"title": "项目编号（可选，用于解析匹配）"
}
},
"required": [
"folder"
]
},
"outputs": {
"type": "object",
"properties": {
"found": {
"type": "boolean"
},
"source": {
"type": "string"
},
"unit": {
"type": "string"
},
"project_code": {
"type": "string"
},
"total_funding_need": {
"type": [
"number",
"null"
]
},
"window": {
"type": "object"
},
"tasks": {
"type": "array"
},
"payments": {
"type": "array"
}
}
}
}strategy.bid_simv1.0.0正式引擎
日本电力市场投标策略模拟：三腿顺序投标方案（DAM→調頻→時間前，48 槽计划 + 调频腿满额/期望/事后收益三口径）按项目规格线性折算；Day Ahead 报价建议（中标率×竞争系数分档）、Intraday 价差建议、調頻商品主攻判定、结论先行 headline 按项目电力区域实算。复用 Codex 侧 state_machine 方案快照与策略统计，不重跑、无网络。
接口契约（JSON Schema）
{
"inputs": {
"type": "object",
"properties": {
"date": {
"type": "string",
"default": ""
},
"area": {
"type": "string",
"enum": [
"北海道",
"東北",
"東京",
"中部",
"北陸",
"関西",
"中国",
"四国",
"九州"
],
"default": "中部"
},
"p_mw": {
"type": "number",
"default": 24.4
},
"e_mwh": {
"type": "number",
"default": 48
},
"days": {
"type": "integer",
"default": 14
},
"slot_grain": {
"type": "integer",
"enum": [
8,
24,
48
],
"default": 8
},
"slot": {
"type": "integer",
"default": 2
}
}
},
"outputs": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"date": {
"type": "string"
},
"available_days": {
"type": "array"
},
"plant": {
"type": "object"
},
"plan": {
"type": [
"object",
"null"
]
},
"strategy": {
"type": "object"
},
"basis": {
"type": "array"
},
"ms": {
"type": "number"
}
}
}
}