# MoonCalGuard 验收自查记录

日期：2026-08-20

## 总体判断

MoonCalGuard 当前已经满足八月黑客松本地可验证的核心工程要求：有效 MoonBit 代码规模超过 4k，项目可格式化检查、可构建、可测试、可运行 demo，README、申报书、设计说明、调研记录、许可证和 CI 配置完整。

## 本地证据

- MoonBit 包名：`WYT-ai-nb/mooncalguard`；
- GitHub 仓库地址：`https://github.com/WYT-ai-nb/mooncalguard`；
- 主要实现语言：MoonBit；
- 有效 MoonBit 代码：约 5245 行；
- 测试数量：43 个；
- 许可证：MIT；
- CI 文件：`.github/workflows/ci.yml`；
- 可运行示例：`moon run src/cmd/demo`。
- API 接口面：`moon info` 已生成 `pkg.generated.mbti`，用于审查公开 API。

## 已通过命令

```bash
moon fmt --check
moon check --deny-warn
moon build
moon test --deny-warn
moon info
moon run src/cmd/demo
```

补充检查：`moon check --target all --deny-warn`、JS/Wasm/Wasm-GC 三个目标的 `moon test` 均通过 43/43；当前 Windows 环境没有 `cl`、`cc`、`gcc` 或 `clang`，因此 native 目标只能留给 Ubuntu CI 验证。CI 已配置 `check/test --target all`。

## 功能完成度

- ICS 解析：已完成；
- 嵌套组件树：已完成；
- 常见 RFC5545 校验：已完成；
- RRULE 解析和诊断：已完成；
- DURATION / TRIGGER 解析：已完成；
- VALARM 校验：已完成；
- 属性目录：已完成；
- 规范化导出：已完成；
- 事件 diff：已完成；
- Markdown / JSON 风格报告：已完成；
- 议程查询：已完成；
- 自制 fixture 和测试：已完成。

## 合规说明

项目为原创 MoonBit 实现，不移植第三方源码，不包含来源不明素材或私有代码。测试 fixture 为项目内自制 ICS 文本。项目依据公开 iCalendar / RFC5545 格式规则设计解析、校验和导出流程。

## 待远程确认

以下事项需要等浏览器、GitHub Desktop 或命令行凭据切回正确账号后再做：

- 推送本地提交到 GitHub；
- 确认 GitHub 仓库公开可访问；
- 确认远程默认分支包含最新工作；
- 等待 GitHub Actions 在线 CI 通过；
- 执行 Mooncakes 登录、dry-run 和发布；
- 在报名问卷提交公开仓库链接和申报材料。

## 推送前建议

推送前先确认 `git status --short --branch` 显示本地分支只领先远程、没有未提交改动；确认 `git log --format="%h %an <%ae> %s" -n 8` 中提交作者一致；确认当前系统 GitHub 凭据属于 `WYT-ai-nb`。