Documents exist in both languages (`_en` / `_zh`) with matching section
structure so the two versions can be read side by side; docs marked
**EN only** are awaiting translation.
文档以英文与中文两个版本并存(`_en` / `_zh`),章节结构一一对应,可对照阅读;
标注 **EN only** 的文档中文版待补。
### `primers/` — Background primers 背景入门读物
Market-neutral educational material — no venture-specific analysis.
与具体业务无关的背景知识读物。
**`primers/grid/` — the grid & markets series 电网与市场系列** (read in order 按序阅读):
| # | EN | 中文 | Contents 内容 |
|---|---|---|---|
| 01 | [01_how_the_grid_works_en.md](primers/grid/01_how_the_grid_works_en.md) | [zh](primers/grid/01_how_the_grid_works_zh.md) | Grid physics, the balancing act, blackouts — from first principles. 电网物理原理、实时平衡与停电机理。 |
| 02 | [02_us_electricity_markets_en.md](primers/grid/02_us_electricity_markets_en.md) | [zh](primers/grid/02_us_electricity_markets_zh.md) | How US wholesale markets are organized. 美国批发电力市场结构。 |
| SCUC & SCED | [scuc_sced_en.md](primers/scuc_sced_en.md) | The two optimization problems that clear US wholesale markets; N-1 security, LMP as dual variables. 出清美国批发市场的两大优化问题。 |
| Newsvendor 报童模型 | [newsvendor_en.md](primers/newsvendor_en.md) | The newsvendor problem applied to electricity bidding — underpins the bid loop in `pjm/design_models_*`. 报童模型在电力竞价中的应用。 |
| Stochastic optimization 随机优化 | [stochastic_optimization_en.md](primers/stochastic_optimization_en.md) | Stochastic optimization in power systems — scenarios, recourse, hydro, offering under uncertainty. 电力系统中的随机优化。 |
### `us_market/` — US market reference 美国市场综述
| Doc 文档 | EN | 中文 | Contents 内容 |
|---|---|---|---|
| Field guide 实务指南 | [field_guide_en.md](us_market/field_guide_en.md) | EN only | Bidding, trading, and the impact of AI — consolidated working discussions, July 2026. 竞价、交易与 AI 影响综合笔记。 |
| Forecasting open ecosystem 预测开放生态 | [forecasting_open_ecosystem_en.md](us_market/forecasting_open_ecosystem_en.md) | EN only | Open US wholesale-market datasets, models, benchmarks, structural tools, and evaluation design for price, load, renewable, and capacity forecasting. 美国批发电力市场预测的开放数据、模型、基准、结构化工具与评估设计。 |
| Vendor due diligence 供应商尽调 | [vendor_dd_en.md](pjm/vendor_dd_en.md) | [vendor_dd_zh.md](pjm/vendor_dd_zh.md) | Six US autobidder/optimization vendors profiled (Fluence Mosaic, Ascend SmartBidder, Tyba, Gridmatic, Dexter, enspired), comparative matrix, whitespace synthesis. 六家美国竞价优化服务商档案、对比矩阵与空白研判。 |
### `china/` — China market 中国市场
| Doc 文档 | EN | 中文 | Contents 内容 |
|---|---|---|---|
| Market & vendor DD 市场与供应商尽调 | [market_vendor_dd_en.md](china/market_vendor_dd_en.md) | [market_vendor_dd_zh.md](china/market_vendor_dd_zh.md) | China market primer (Doc 136/394, mechanism price, MLT–spot deep dive §1.4–1.6, bargaining dynamics), six Chinese vendors (国能日新, 远景, 清能互联, 清鹏, 兰木达, 心知能源), synthesis, glossary. 中国市场入门(含中长期深度解析)、六家中国服务商、综合研判、术语表。 |
| Product design 产品设计 | [product_design_en.md](china/product_design_en.md) | [product_design_zh.md](china/product_design_zh.md) | Chinese adaptations of Models A–C and the full Model D spec (MLT position optimizer) with the hedge-ratio mathematics, build order, open questions. 模型 A–C 中国化调整与模型 D(中长期头寸优化器)完整规格及数学推导。 |