# MoonRobots Gate 项目申报书

## 基本信息

| 项目名称 | MoonRobots Gate | 类型 | 原创 MoonBit 开源库与工具 |
|----------|----------------|------|--------------------------|
| **参赛者** | 石子硕 | **联系方式** | 已通过官方报名问卷提交 |
| **许可证** | Apache-2.0 | | |
| **GitHub** | github.com/2111950632/moonrobots-gate | **Mooncakes** | 2111950632/robots-gate |

## 项目背景

MoonRobots Gate 是面向 robots.txt 的可解释策略工程工具，将文本规则转换为可审计的数据模型，为爬虫、搜索索引器和 AI 智能体提供确定性的访问判断、风险诊断、站点地图校验与抓取规划能力。

## 最终交付（v0.2.2）

| 维度 | 内容 |
|------|------|
| **源码** | 26 个 MoonBit 源文件，共 5,846 行，其中可复用核心 4,310 行 |
| **测试** | 107 项在 wasm、wasm-gc、JavaScript、native 四个目标全部通过 |
| **核心功能** | robots.txt 防御式解析；用户代理选择与最长路径匹配；语义 lint（含 strict 模式、LNT020 fragment 检测、LNT021 无效 URL 诊断）；三种渲染格式（Canonical/Compact/Annotated）；访问矩阵与策略差异对比；站点地图校验；预算抓取规划；百分比编码归一化 |
| **CLI** | 九组命令：decide / lint [strict] / normalize [canonical\|compact\|annotated] / matrix / sitemap / plan / diff / audit / stats |
| **CI** | GitHub Actions 四目标严格检查 |
| **发布** | Mooncakes 正式版本 |

## 本次活动完成内容与范围调整

- 将原型扩展为模块化 Robots 协议策略工程工具，完成防御式解析、可解释决策、语义检查、策略差异、站点地图校验和预算抓取规划。
- 完成 Markdown、JSON 和 CSV 输出能力、九组 CLI 命令、四个可运行示例及 107 项自动化测试。
- 补充 RFC 9309 语义、资源上限、异常输入和稳定诊断码测试，并配置四目标 CI。
- 经实现阶段评估，将网络获取层调整为后续独立包；核心库保持无网络副作用，调用方负责 HTTP、重定向、缓存、DNS 和持久化。

## 技术路线

项目采用“纯策略核心＋调用方传输层”的分层结构。文本经限额解析和源位置诊断后进入匹配层，上层复用决策结果完成审计、差异、站点地图检查和抓取规划。核心保持确定性和跨目标可移植性，网络状态由调用方或未来独立传输包负责。

## 预计交付

可发布的 MoonBit 库；完整 CLI 与四个示例；107 项四目标测试；GitHub Actions CI；README、架构文档、开发复盘、更新日志；Mooncakes 正式版本。