# 发布到 mooncakes.io

## 发布前检查

1. 确认 `moon.mod` 的模块名为 `sujy123456/voltweave`，版本号、仓库、许可证和 README 正确。
2. 执行 `moon fmt --check`、`moon check --deny-warn` 和根包测试。
3. 构建 CLI 与 Wasm-GC 演示，并更新 `web/app/voltweave.wasm`。
4. 执行 `moon info` 生成公开接口文件，再检查 Git 差异。
5. 执行 `moon publish --dry-run`，确认打包内容不含日志、凭据和构建缓存。
6. 更新 `CHANGELOG.md`，提交并创建与 `moon.mod` 版本一致的 Git 标签。

## 登录与发布

发布者本人在本地运行：

```bash
moon register   # 首次使用；已有账号可跳过
moon login
moon publish --dry-run
moon publish
```

登录令牌由 MoonBit 工具链保存在用户凭据目录，不能提交到仓库。发布属于不可自动撤回的外部操作，应在 GitHub CI 全绿并核对包内容后由仓库所有者执行。

## 发布后验证

- 在 mooncakes.io 打开 `sujy123456/voltweave` 包页面；
- 从一个空项目添加该版本依赖并执行最小示例；
- 创建 GitHub Release，附上变更日志和 Wasm 校验值；
- 把包页面和 Release 链接补充到 README；
- 保留发布命令输出作为验收记录。