80835138e9
- README: orientation, doc map, target package layout (pointers only, no duplicated architecture content) - CLAUDE.md: agent operating manual — invariants as code-review rules, conventions, do-not list, task reading order - ROADMAP: M1-M5 with verifiable acceptance criteria, phase-2 fence - GLOSSARY: canonical Chinese-term → code-name mapping - docs/adr/: eight ADRs recording settled decisions and rejected alternatives - docs/open-questions.md: consolidated TODO(业务) tracker by owner and blocking milestone - .gitignore; untrack .DS_Store Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019u5SLNweVio6ozJX7yfxQr 🔮 View transcript: https://logs.lojong.info/s/e8u90k3t33w590r7b5y7yzqh
4.6 KiB
4.6 KiB
GLOSSARY — 术语 → canonical code names
Docs are Chinese, code is English. Use these exact names; do not coin alternatives. Columns: term, code name (type/identifier), meaning, defining doc.
Core business objects
| 中文 | Code name | Meaning | Doc |
|---|---|---|---|
| 建议 | Proposal |
Any action the AI wants taken; carries digest + lineage | 03 |
| 运行包络（授权） | Envelope |
Pre-approved autonomy bounds (authority, downward) | 03 |
| 灵活性包络（能力） | FlexibilityEnvelope |
Adjustable capability report (capability, upward; federation artifact) | 04/10 |
| 执行许可 | ExecutionPermit |
Short-lived revocable execution credential | 03 |
| 审批 | Approval |
Human decision bound to a proposal digest + validity window | 03 |
| 持仓账本 | PositionLedger / PositionUpdate |
Shared per-timescale position & constraint cascade | 00/04 |
| 运营工单 | DecisionCase |
Operator's unit of accountability (one objective/owner/deadline) | 02 |
| 政策包 | PolicyPack |
Versioned, tested, executable rule bundle | 05 |
| 态势报告 | SituationReport |
Analysis agent output: state, anomalies, risk | 02 |
| 资源画像 | ResourceProfile |
Capacity, constraints, reliability score | 02 |
| 预测集 | ForecastBundle |
Curves + quantile intervals + model version | 05 |
| 承诺 | Commitment |
User or inter-province delivery commitment | 10 |
| 执行回执 / 执行报告 | ExecutionReceipt / ExecutionReport |
Idempotent effect receipt / execution outcome | 04 |
| 复盘结论 | ReviewFinding |
Structured lesson from review, written back to memory | 02 |
| 调度指令 | DispatchOrder |
Post-permit decomposed instruction | 04 |
| 结算 | Settlement |
Settlement facts from metering | 06 |
Processes & components
| 中文 | Code name | Meaning | Doc |
|---|---|---|---|
| 可信执行链 | safety chain, proposal-lifecycle workflow |
Rule check → simulation → gate → permit → release | 03 |
| 规则校核 | rule check, PolicyEnginePort |
Deterministic compliance/constraint validation | 03/11 |
| 仿真验证 | simulation, SimulationPort |
Revenue backtest (bids) / power-balance (control) | 03 |
| 现势复核 | fresh-state check, FRESH_CHECK |
Pre-release re-verification; failure → STALE |
03 |
| 包络检查 | envelope gate, EnvelopePort.match |
Within-bounds → auto-approve | 03 |
| 授权 | AuthorityPort.authorize |
Issues ExecutionPermit | 11 |
| 复盘 | review (not "replay", not "retrospective" in code) | D+1 deviation attribution loop | 02 |
| 血缘 | lineage | Tool-call provenance attached to proposals | 03/09 |
| 事件信封 | EventEnvelope |
Typed event wrapper with schemaVersion/causation | 11 |
| 认知平面 / 控制平面 | cognitive plane / control plane | Slow LLM loop / fast deterministic loop | 00 |
| 聚合单元 | AggregationUnit |
VPP aggregation layer between province and sites | 04 |
| 边缘控制终端 | edge terminal | Second-level local closed loop | 04 |
| 熔断 | circuit breaker / kill switch (L0–L4) | Graduated shutdown hierarchy | 13 |
| 影子运行 | shadow run/mode | Full loop, simulated external effects | 08 |
Market & domain terms
| 中文 | Code name / abbrev | Meaning |
|---|---|---|
| 虚拟电厂 | VPP | Virtual power plant |
| 现货市场 | spot market | Hubei electricity spot market |
| 日前 / 日内 / 实时 | DAY_AHEAD / INTRADAY / REALTIME |
Timescale enum values (also ANNUAL, MONTHLY) |
| 申报 | bid (submission: declaration) | Market bid/declaration; Proposal{type: BID} |
| 出清 / 中标 | clearing / award | Market clearing result |
| 96 点 | 96 intervals | 15-min intervals per day; {date, interval_index} |
| 需求响应 | DR, demand response | |
| 辅助服务 / 调频 | ancillary services / frequency regulation | |
| 可调资源 / 可调负荷 | flexible resource / flexible load | Adjustable capacity |
| 可中断负荷 | interruptible load | Contracted curtailable load |
| 邀约 / 履约 | invitation / fulfillment | User solicitation; commitment delivery |
| 基线 | baseline | DR measurement baseline |
| 偏差考核 | deviation assessment | Penalty regime for plan-vs-actual gaps |
| 代理购电 | proxy purchase / retail agency | Buying on behalf of contracted users |
| 源网荷储 | source-grid-load-storage | Coordinated optimization scope |
| 光明电力大模型 | GuangMing power LLM (guangming adapter id) |
State Grid's foundation model |
| 等保 | MLPS | Multi-Level Protection Scheme (security compliance) |
| 电科院 | EPRI (Hubei) | State Grid Hubei Electric Power Research Institute |
| 3060 平台 | legacy 3060 platform |
Existing platform being overlaid (docs/06 §4) |