# MoonHAR HTTP Archive 解析与性能分析库 项目申报书

## 基本信息

项目名称：MoonHAR HTTP Archive 解析与性能分析库<br>
参赛者：许博<br>
联系方式：2230679121@qq.com<br>
GitHub 仓库链接：https://github.com/k5111114s/xb123<br>
项目方向：MoonBit Web 性能分析基础库 / HTTP Archive 工具<br>
是否为移植项目：否

## 项目简介

MoonHAR 是一个 MoonBit 原生的 HAR（HTTP Archive）解析、校验与性能分析库，面向浏览器 DevTools、自动化测试和代理工具导出的 `.har` 数据，可用于前端性能排查、接口审计、CI 性能回归检查和 MoonBit Web 工具开发。仓库现已具备 JSON/HAR 类型化解析、结构校验、性能汇总、预算评估、瀑布流、脱敏、对比和多格式报告等能力，并配置外部文件 CLI、可运行示例、CI、Apache-2.0 许可证及 93 个行为测试。CLI 提供摘要、校验、报告、瀑布流、预算和 CSV 六个命令，使项目形成边界清晰、可复用、可持续维护的 MoonBit 基础库。

## 核心功能范围

提供 HAR 1.2 常用数据模型，覆盖 log、page、entry、request、response、timings、headers、cookies、queryString 和 postData；<br>
实现无第三方运行时依赖的 JSON/HAR 解析，支持标准转义、Unicode 与结构化错误路径，并通过 `JVal` 访问扩展字段；<br>
校验必填字段、HTTP 状态码、URL、请求方法、大小和 timing，输出带严重级别、错误码和路径的诊断；<br>
统计请求、失败、重定向、缓存、域名、资源类型、状态段、传输大小、慢请求和百分位耗时；<br>
提供性能预算、质量评分、瀑布流、时间线、URL 模式聚合、档案对比和隐私脱敏能力；<br>
输出文本、CSV 与紧凑 JSON 报告，并提供读取外部 HAR 文件的多命令 CLI；<br>
持续运行 `moon check --deny-warn`、`moon test --deny-warn`、格式和接口检查，测试覆盖正常与异常解析、校验、分析、预算、导出和 Unicode；<br>
完善 README、设计、测试、安全、来源说明及 mooncakes.io 发布文档。

## 移植或参考说明

本项目为原创 MoonBit 项目，不移植或复制其他开源项目代码。项目仅参考公开的 HAR 1.2 数据格式说明和浏览器 HAR 通用结构进行兼容设计，核心模型、解析逻辑、校验规则、分析算法、测试样例和文档均在本仓库中重新实现。项目开发使用 AI 工具辅助接口设计、测试与文档整理，所有成果均纳入可解释的 MoonBit 源码、自动化测试和许可证审查。项目许可证为 Apache License 2.0。