# VoltWeave（伏织）项目申报书

## 基本信息

- 项目名称：VoltWeave（伏织）：家庭用能调度与停电韧性仿真器
- 参赛者：苏琴茜
- 联系方式：jiangtian_69@qq.com
- GitHub 仓库链接：https://github.com/suqinxi/suqinxi
- Mooncakes 包地址：https://mooncakes.io/docs/suqinxi/voltweave
- 项目方向：MoonBit 家庭能源调度基础库 / 离线能源分析基础设施
- 是否为移植项目：否，原创项目

## 项目简介

VoltWeave 面向实行分时电价、安装屋顶光伏或家庭储能设备的家庭及小型场所，解决电器何时运行、电池怎样充放电、停电时优先保障哪些负载难以直观判断的问题。项目以 MoonBit 实现可离线运行的家庭用能调度、停电韧性仿真和结果审计能力，为家庭能源管理应用、光储方案比较工具、低碳用电分析平台和应急保供规划工具提供可复用的计算内核。用户输入电价、碳强度、光伏预测、基础负载、电池参数、电器任务和停电事件后，系统生成满足时间窗、配电功率及电池安全边界的计划，并输出费用、碳排、峰值、缺供、保供覆盖率和决策解释。项目提供 MoonBit API、命令行、JSON 接口、文本报告及浏览器 Wasm-GC 演示，不依赖云服务。

## 核心功能范围

- 提供统一家庭用能模型，支持分时电价、碳强度、光伏、基础负载、电器任务、电池、配电上限和停电事件；
- 支持固定、可移峰、可中断和可放弃任务，以及关键、高、普通、低四级保供优先级；
- 提供统一调度入口 `solve(...)`，通过确定性有界搜索完成任务排程和光伏、电网、电池能源分派；
- 支持费用、碳排、舒适度、停电韧性和电池损耗权重配置，并提供五种内置策略及 Pareto 方案比较；
- 使用固定随机种子模拟光伏偏差、临时用电尖峰和停电时间变化，输出可行概率、费用与缺供分位数、风险等级和敏感性分析；
- 提供独立结果审计，检查供需平衡、配电上限、停电约束、电池安全边界、任务窗口及结果数组完整性；
- 支持规划输入和结果的 JSON 导入导出，并提供 Markdown、CSV、ASCII 曲线和机器可读原因码；
- 提供晴天家庭、紧凑公寓和风暴停电三组可运行示例，以及 CLI 和浏览器 Wasm-GC 仪表盘；
- 配置 GitHub Actions，持续执行格式检查、静态检查、46 项自动化测试、CLI/Wasm 构建、发布包校验和产物归档；
- 提供完整 README、架构说明、使用文档、测试记录、更新日志、许可证审查和 Mooncakes 发布记录。

## 移植或参考说明

- 本项目为原创项目，不移植现有开源项目，也不复用其他参赛项目代码；
- 项目仅参考公开的分时电价、储能状态方程、多目标优化和约束调度基本思想；
- 数据模型、确定性搜索流程、电池能源分派、解释机制、风险仿真、独立审计、CLI 和浏览器交互均使用 MoonBit 独立实现；
- 项目没有第三方 MoonBit 运行时包依赖，示例数据、界面样式和文档均由本项目自行编制；
- 项目采用 Apache License 2.0 发布，第三方工具与材料来源已在开源审查文档中登记。