MINEGRID STUDIO / 启动说明
你现在双击打开的是静态文件。MineGrid Studio 的界面、计算 API、导入导出和自动保存需要
Node 服务，不能直接使用 file:// 打开 public/index.html。
start.command
http://127.0.0.1:4310/
如果 4310 端口尚未启动，请先双击项目根目录的 start.command，或在终端运行
npm start。
MINEGRID / ENGINE STARTUP
8760 HOUR ENERGY MODELAPPLICATION INITIALISATION
连接计算服务，并载入当前场景与模型边界。
正在计算典型年逐时能量平衡与运行边界。
三条曲线按各自年度峰值归一化，用于观察季节节奏，不用于横向比较绝对电量。
连线宽度与电量成正比，来源、储能、弃光与负荷使用同一套服务端结果。
先看影响方案判断的核心数字，专业模式可展开完整八项。
MONTHLY ENERGY LEDGER
SCENARIO ECONOMICS
SUPPLY STRUCTURE
SHARE & CURTAILMENT
ENERGY BALANCE
逐月核对负荷、光伏潜在出力、直接自用、储能吞吐、柴油补充和弃光。
FULL LEDGER
SUPPLY STRUCTURE
UTILISATION
MAINTENANCE CALENDAR
HOURLY DISPATCH
查看任一典型日的逐时调度曲线，或筛选、检查和导出完整小时模型。
DAILY OPERATION
HOURLY REGISTER
SCENARIO EXPLORER
用容量敏感性地图快速观察光伏、储能与光储占比、弃光、LCOE 的关系，再点击单元格应用。
PV × STORAGE
进入方案探索后，将按当前场景生成自适应容量组合。
服务端会按当前场景选择光伏与储能组合，并比较光储占比、弃光率、未供电量与 LCOE。
CURRENT VS BASELINE
TRADE-OFF NOTE
横向增加光伏通常会提升光储占比，但若储能功率和能量不足，弃光会同步上升。
纵向增加储能主要回收午间余电，边际效果取决于充电功率、SOC 窗口和典型日负荷形状。
LCOE 使用的是本页可编辑的成本假设，只适合比较同一口径下的方案，不应视为正式报价。
INTEGRITY & TRACEABILITY
把数值守恒、SOC、功率上限、月度汇总、输入调整和数据来源拆开核验。 “核算通过”不等于“现场数据已验证”，两类结论分别展示。
AUDIT REGISTER
REPRODUCIBILITY
SOURCE REGISTER
NORMALIZATION LEDGER
MODEL WARNINGS
MODEL SPECIFICATION
这里同时展示计算顺序、关键公式、数据来源状态、已知边界和服务 API。
主生产与季节/辅助负荷分别输入年用电量，再乘以昼夜形状、对应检修系数和季节倍率，并按各自全年权重归一。因此修改形状、检修或季节规则不会改变输入的年用电量。
loadₜ = 主生产负荷ₜ + 季节/辅助负荷ₜ
用逐时 GHI、DNI、DHI、太阳天顶角和方位角，按组件倾角、方位角、地表反射率和固定 PR 计算潜在交流出力。
Pₚᵥ = Gₜᵢₗₜ / 1000 · PR · Cₚᵥ
光伏先满足负荷；剩余光伏只给储能充电；储能不足时放电；剩余负荷由柴油机组补足；如果机组容量仍不足，则记录未供电量。只有当年光伏余电充入的电量才计入光储占比。
load = PV直接自用 + 光电经储能放电 + 柴油 + 未供电
充放电功率、SOC 上下限和两侧效率同时约束调度。充电和放电不会在同一小时发生；期初与期末 SOC 都按给定边界独立计算，不强制年末回到初始值，库存变化会单独提示。
SOCₜ₊₁ = SOCₜ + ηc·Pc − Pd/ηd
用满负荷油耗率、空载油耗比例和实时负荷率估算柴油消耗，再根据柴油碳因子计算范围一 CO₂。
fuel = Cgen · ffull · (idle + (1−idle)·loadfactor)
将光伏、储能和机组投资按项目年限、折现率年化，加上年度 O&M 与柴油成本，再除以已供电负荷，得到同一口径下的简化平准化成本；存在未供电负荷时不展示 LCOE。
LCOE = (年化CAPEX + O&M + 燃料成本) / 已供电负荷
DATA PROVENANCE
SERVICE API
GET /api/health健康检查与模型版本GET /api/defaults默认场景与数据元信息POST /api/simulate提交场景并返回平衡结果POST /api/export/csv导出逐时 CSVGET /api/openapi.jsonOpenAPI 3.1 描述前端与 API 共用同一个计算模块，避免展示值与接口值出现两套口径。
MODEL LIMITS
不模拟单台柴油机的启停、最小负荷、旋转备用与 N+1 可靠性。
不模拟电池衰减、温度、寿命、爬坡和辅助用电。
不模拟逆变器直流超配削顶、集电线路和并网/离网切换。
不包含税费、融资、设备更换、土地、运输和全生命周期碳排。
不能替代现场负荷测量、正式可研、设备询价或调度控制策略。
上线前应替换所有演示假设，并由第三方复核关键结论。