# 选题与语义查重记录

检索日期：2026-11-21。依据本地 moonbit-hackathon-builder 及 osc2026-guide 的 Project Research Guide：扩词、MoonCakes、GitHub、官方清单、永久注册表、实际源码/测试/接口比较，再以核心行为反向检索。此文是有范围的工程记录，不是赛事裁决或绝对唯一性证明。

## 需求与完成标准

选题来自已有 man 手册的三个成熟工作流：CLI 维护者把手写源生成网页预览；文档站发布器从同一源生成 Markdown/纯文本及目录；包文档工具在不执行外部请求的情况下获得诊断、引用和链接清单。证据是 GNU groff man 宏文档及长期存在的手册发布格式，而非虚构访谈。

基线为 GNU groff 的 man(7) 宏行为。独立库的完整核心限定为有界语义解析、常用宏/转义、三输出、导航和检查；交付须由三个运行示例、异常输入/资源测试、原创 groff 对照夹具和四后端验证兑现。复杂排版和通用解释器明确排除。相比各应用自行写正则，状态机可处理跨行字体、待定 term、嵌套缩进、原样模式和链接边界。

## 三个不同问题域候选

|候选|用户/输入/输出|核心与接口|实际比较与决策|
|---|---|---|---|
|MoonMan：文档语言|CLI/文档站/包工具，已有 man 源 -> AST/HTML/Markdown/纯文本/诊断|宏状态机、转义解释、parse/render/outline|相邻 AsciiDoc 输出器与 CommonMark 输入器不消费 man；在所查范围未发现成熟直接替代，选择|
|WARC 归档工具：网络存档|抓取/研究/存档服务，WARC 字节流 -> record/长度/错误|流式 framing、Content-Length、截断恢复|xiaojing012/moon-warc@0.1.0 已直接覆盖；decoder.mbt 和 decoder_test.mbt 有真实边界/截断测试，淘汰|
|Avro 消息格式：数据交换|数据管道/消息系统，schema 和二进制 -> 值/OCF|二进制 codec、容器与 schema API|yugonlian/moon-avro@0.3.0 已有实际 binary/OCF 代码与测试，淘汰；复核另发现 ppyj663/MoonAvro|

附加排除：Matrix Profile 候选有 GitHub 2973181701/moonmatrixprofile 直接替代，即使 MoonCakes 关键词未命中也不能选。

按生态广度、用户多样性、复用、重合风险（高分为低风险）、实现深度、可验证性、工期可控、维护可控各 1..5 评分：MoonMan = 4/4/5/4/4/5/4/4，总34；WARC = 4/4/5/1/4/5/4/4，总31；Avro = 5/5/5/1/5/5/3/3，总32。WARC/Avro 的直接重合是硬失败，分数不能抵消。MoonMan 的广度指可复用文档流程，不代表已有使用量。

## 检索范围与限制

MoonCakes 使用官方 CLI search，limit100，扩展词 roff/troff/nroff/mandoc/manpage/man2html/manual page/groff/reStructuredText。roff/nroff/mandoc/man2html/reStructuredText 无模块；troff 26、groff 1，相关项为 bobzhang/asciidoctor 的 manpage converter；manual page 7 为相邻/偶然命中；manpage 返回100达到上限，**不视为穷尽**。候选 WARC/Avro 结合模块详情、GitHub 源码和测试判断，不依赖关键词零结果。

GitHub 搜索 per_page100：roff/manpage/troff/mandoc/groff/man2html + moonbit 均无直接仓库；manpage language:MoonBit 为0。反向 man2html/mandoc + moonbit in:readme 为0，roff moonbit in:readme 为11个语言清单/收藏等偶然项。检查官方 [awesome-moonbit](https://github.com/moonbitlang/awesome-moonbit) 的文档/解析相邻分类。再次检索 roff moonbit、manpage language:MoonBit 均0，incomplete_results=false；warc language:MoonBit 找到 xiaojing012/moon-warc，avro language:MoonBit 找到 yugonlian/moon-avro 与 ppyj663/MoonAvro。

永久注册表按 man/manpage/roff/troff/mandoc 及每一候选核心行为搜索，检查完整匹配指纹。WARC/Avro 等已登记外部实现不可换名重做。2026-11-21 在共享排他锁内重新读取注册表并原子预留 MoonMan 后才开始实现。

结果随时间变动；未把关键词零命中、无同名包或未列某格式当成源码级“不存在”证明。没有承诺下载量/搜索排序代表维护质量，也未做全生态源码穷举。原始网络响应保存在仓库外，不包含在发布包中。

## 实际源码矩阵

|项目/检查对象|输入 -> 输出、核心行为|测试/接口证据|关系与独立建设理由|
|---|---|---|---|
|[bobzhang/asciidoctor.mbt](https://github.com/bobzhang/asciidoctor.mbt)；MoonCakes 0.3.5|AsciiDoc AST -> roff man 源；document converter 拼 TH/段落请求|converter/manpage/document.mbt 对象 73f5c3104e71f020d5c57b81ce03154c17493bfa；manpage_test.mbt bed01d58de67051258f0733d396e35405b3be96c 的输入为 AsciiDoc，断言输出 .sp；manpage.mbt d31c85c25b8297ff970442bc0a465c597e76594b|高度相邻但方向相反。MoonMan 消费已有 roff；新增 source parser 不是扩展 AsciiDoc AST 输出器即可得到。详情快照含0.3.5及多个历史版本、376 downloads；仅作当时元数据，不推断活跃程度|
|[moonbit-community/cmark.mbt](https://github.com/moonbit-community/cmark.mbt)；0.4.13|CommonMark 源 -> Markdown AST|cmark/src/cmark/parser.mbt 57094ccfd0f579167d32a6dca460270dafc5b616；block_test.mbt 943c36bb84cb263365ee696e2cbc8e8ad3f195d8；接口 5fad6c567c76f3a738b052e81e3d7df956031a87|同属文档解析、语言不同；不存在 man 控制行/字体/寄存器解释模型。把 roff 状态塞入 CommonMark 语法器会混淆语言边界|
|[ZSeanYves/markitdown](https://github.com/ZSeanYves/markitdown)|多文档输入 -> Markdown 的广泛转换入口|README 7d1d527f0cedc5f9facc25f62741335ac7823211 格式清单未列 man/roff|只作方向相邻信息；仅读 README，没有以此证明全部源码不存在 man 功能|
|[xiaojing012/moon-warc](https://github.com/xiaojing012/moon-warc)；0.1.0|WARC byte stream -> records、length/limit errors|decoder.mbt 3aafbfe4124a8b063f2081f4fd040d45b4527791；decoder_test.mbt bd9fbd348920375034cc0b5e7c47cc1c3004e847|WARC 候选直接重合，淘汰，不包装成文档工具重新进入|
|[yugonlian/moon-avro](https://github.com/yugonlian/moon-avro)；0.3.0|Avro binary/OCF 编解码|codec/binary.mbt 85b361d13a3293389516d6ad584a108f51e88dc4 及实际 codec_test.mbt 已检查|Avro 候选直接重合，淘汰|

上述 SHA 是检查文件的 Git 对象标识，不冒充仓库 commit SHA。远端详情及源码可变，比较限于注明版本/对象和访问日期。库与测试不复制到 MoonMan。

## 验收落地

核心功能见根目录生产 .mbt 与公开接口；三个用户流程在 examples/preview、examples/publish、examples/audit。7 份原创 man 夹具对照独立 groff 的有序正文词，43 项命名测试含300组异常组合、明确资源边界和输出攻击用例。解析/render 的行为边界见 docs/semantics.md；尚未以复杂任意 man 手册证明无损转换，也不声称完整 troff 兼容。
