# VoltWeave（伏织）项目申报书

## 基本信息

- 项目名称：VoltWeave（伏织）——家庭用能调度与停电韧性仿真器
- 参赛者：苏琴茜
- GitHub 仓库地址：https://github.com/suqinxi/suqinxi
- 项目方向：家庭能源管理、约束优化、离线 WebAssembly 应用
- 项目性质：原创项目

## 项目简介

VoltWeave 面向实行分时电价、安装光伏或储能设备的家庭及小型场所，解决电器何时运行、电池怎样充放电、停电时优先保障哪些负载难以直观判断的问题。用户提供电价、碳强度、光伏预测、基础负载、电池参数、电器任务及停电事件后，系统在本地生成满足时间窗、连续运行、配电功率和电池安全边界的计划，并比较费用、碳排、舒适度和保供韧性。项目以 MoonBit 实现核心模型、求解器、仿真器、审计器和报告模块，提供命令行、JSON 与浏览器 Wasm-GC 演示，不依赖云服务。现有基础已完成领域模型、确定性调度、储能能源流、风险仿真、独立结果审计和三组场景；本次开发补齐 46 项测试、CI、文档、Web 示例与 mooncakes.io 发布配置。

## 核心功能范围

- 统一建模分时电价、碳强度、光伏、固定/可移峰/可中断负载、电池及停电事件，支持 JSON 序列化与稳定校验码；
- 采用确定性有界搜索完成任务排程和电池充放电，支持费用、碳排、舒适度、韧性与电池损耗权重以及 Pareto 方案比较；
- 以固定随机种子扰动光伏、基础负载和停电时段，输出可行概率、费用与缺供分位数、风险等级及敏感性分析；
- 独立审计供需平衡、配电上限、停电约束、电池边界和任务时间窗，输出 Markdown、CSV、ASCII、JSON 报告；
- 提供可运行 CLI、浏览器 Wasm-GC 演示、完整 README、架构和测试文档、GitHub Actions、更新日志及 Mooncakes 发布说明。

## 移植或参考说明

本项目为原创项目，不移植其他开源项目，也不复用其他参赛项目代码。算法仅参考公开的分时电价、储能状态方程和经典约束优化思想，数据结构、搜索流程、解释机制、仿真与交互均使用 MoonBit 独立实现。项目无第三方运行时包依赖，演示数据与界面素材均为自行编制，采用 Apache License 2.0 发布。