sai-chang-guan-jia-moonbit

    参赛管家:多比赛并行管理工具——比赛台账、冲突检测(首次发布/原创条款)、投稿包生成与全链路预检

    Download zip
    Version
    0.1.1
    License
    Apache-2.0
    Last updated
    6 hours ago
    Downloads
    9

    No dependencies

    #参赛管家 · MoonBit 版

    一个帮参赛者同时管多个比赛的命令行工具:19 个比赛的规则、截止、材料放进一个台账, 一件作品投不同比赛时自动检测规则冲突、生成投稿包。

    参加 2026 MoonBit 黑客松 11 月赛季的作品。原创 MoonBit 实现, 没有复制任何其他项目的代码。

    #这是什么

    对标 Lexmount 一等奖作品 Auto-Lexmount(一键全自动参赛流水线),但比它多三样东西:

    1. 多比赛并行管理——Auto-Lexmount 一次只做一个比赛;这里 19 个比赛的规则、 截止、材料、奖金放在一个台账里统一管理(12 个在途 + 7 个关注)。
    2. 游戏作品投稿支持——Auto-Lexmount 只会读 1–3 个公开网页做小报告, 做不了游戏;这里能打包游戏链接、演示视频、投稿文案。
    3. 冲突检测——同一件作品投不同比赛,规则撞了就报警。核心卖点: 魔搭要求“活动期间首次公开发布”,《第零次黎明》11-02 前已公开且已投 Qoder / AI PLAY,工具直接报 P0,而不是悄悄交上去等取消资格。

    #采用(自用)

    本工具正在管理 AI 工具定价核验的参赛:该作品已登记为台账里的 第 4 件作品(1000 条 AI 工具官网定价 + 5 步证据链 + 14 项验证规则, 2026-11-16 首次公开,未投过任何比赛),冲突检测与投稿包生成均已 覆盖——2026-11-16 实测 3 个冲突:魔搭 P0(首次发布)、知乎 S3 P1 (须新做)、造化 P1(须新做);软件创新大赛无冲突(原创条款只看 是否投过其他比赛)。

    诚实标注:这是作者自用——参赛管家与定价核验是同一作者的两个 MoonBit 参赛作品,目前没有外部用户。定价核验的 MoonBit 报名表 尚未填。

    #安装即用

    # 在自己的 MoonBit 项目里把参赛管家装成依赖(已发 Mooncakes v0.1.0) moon add jayjay9191/sai-chang-guan-jia-moonbit

    想先看效果不用装:克隆仓库后,三条命令验证核心价值(作品名、 比赛名写全名,含空格与符号的加引号;以下输出均为 2026-11-16 当场实测):

    moon run cmd/main list moon run cmd/main conflicts 第零次黎明 moon run cmd/main pack 第零次黎明 "松江·创世纪 AI 游戏大赛"

    • list:打印 19 个比赛台账(12 个在途 + 7 个关注,按截止排序)。
    • conflicts 第零次黎明:发现 4 个冲突——魔搭 P0(首次发布)、 知乎 S3 P1(须新做)、造化 P1(须新做)、软件创新大赛 P0(原创条款)。
    • pack 第零次黎明 "松江·创世纪 AI 游戏大赛":材料缺口 1 项 (爱玩 AI 创作者工作台提交),作品链接已就绪。

    #怎么跑

    需要 MoonBit 工具链(moon,0.1.20261104 或更新)。

    # 1. 跑测试(219 个:MoonBit 183 个 + Python 36 个,全部通过才算数) moon test python3 -m unittest discover -s tests_py # 2. 跑 CLI:无参数跑整条流水线 # 打印 19 个比赛台账 → 冲突检测 → 截止撞期提醒 → 投稿包 moon run cmd/main # 3. 子命令:只做一件事(作品名、比赛名含空格时加引号) moon run cmd/main list moon run cmd/main conflicts 第零次黎明 moon run cmd/main pack 第零次黎明 "松江·创世纪 AI 游戏大赛" moon run cmd/main collisions moon run cmd/main benchmark moon run cmd/main validate moon run cmd/main preflight moon run cmd/main help

    不需要联网、不需要 API Key、不读写任何外部服务,纯本地运行。 只有 scripts/sync_data.py 需要联网(抓五个公开官网核对数据)。

    #提交前检查(pre-commit 钩子)

    bash scripts/setup-hooks.sh # 只需跑一次:把本地仓库的钩子指向 .githooks

    此后每次 git commit 都会先跑 moon test,失败则阻止提交。 钩子放在 .githooks/pre-commit 里随仓库走——git 默认不提交 .git/hooks 下的钩子,所以不能直接放那里;core.hooksPath 是 本地仓库配置,不进 git,换电脑或重克隆后要重跑一次启用脚本。 钩子只跑 moon test(保持提交前检查够快);完整检查是上面 的三条(moon test + Python 测试 + preflight)。

    #不用读代码,先跑这两条

    复制粘贴就能验证核心价值。作品名、比赛名必须写全名 (简称查不到;比赛名含空格与符号,加引号):

    moon run cmd/main conflicts 第零次黎明 moon run cmd/main pack 第零次黎明 "魔搭 AI+∞ 第三期「AI 造游戏」"

    第一条应看到 4 个冲突(2026-11-15 实测输出,按截止顺序):

    《第零次黎明》:发现 4 个冲突 [P0] 魔搭 AI+∞ 第三期「AI 造游戏」:首次发布冲突:活动开始前已公开(2026-11-02 之前),已投 Qoder、AI PLAY,违反“活动期间首次公开发布、不得使用已参加其他比赛的作品” [P1] 知乎黑客松 S3:须新做:作品已有公开版本(2026-11-02 之前),不能直接交 [P1] 造化首届体素游戏创作大赛:须新做:作品已有公开版本(2026-11-02 之前),不能直接交 [P0] 第二十届全国大学生软件创新大赛:原创条款冲突:已投 Qoder、AI PLAY,违反“参赛作品必须为原创且未参加过其他国家级公开比赛”

    第二条应看到投稿包被 P0 挡住、材料缺口 3 项(2026-11-15 实测输出):

    作品:第零次黎明 → 比赛:魔搭 AI+∞ 第三期「AI 造游戏」 标题:[第零次黎明] Roguelike 动作构筑游戏:死亡重启、遗物抽取、R 键共鸣爆发 一句话介绍:Roguelike 动作构筑游戏:死亡重启、遗物抽取、R 键共鸣爆发 材料(共 3 项):小红书构想帖(5 个指定话题 + @魔搭ModelScope社区 @Qoder);魔搭创空间可试玩链接;创作手记 + 演示视频 已就绪(0 项): 缺口(3 项):小红书构想帖(5 个指定话题 + @魔搭ModelScope社区 @Qoder);魔搭创空间可试玩链接;创作手记 + 演示视频 状态:⛔ 存在 P0 冲突,提交前必须先解决(见冲突检测)

    #数据怎么改(JSON 是唯一数据源)

    比赛数据不在 .mbt 代码里,全部在 data/competitions.json:

    # 1. 改 JSON(只改这个文件) # 2. 重新生成数据代码 python3 scripts/generate_data.py # 3. 格式化 + 校验 + 测试(生成器输出必须先过 moon fmt 再提交) moon fmt && moon run cmd/main -- validate && moon test

    生成器是确定性的:同一份 JSON 每次生成字节一致;生成内容已验证 与外置前的 competition.mbt 数据逐字一致(135 个字符串 + 36 个布尔值)。 CI 里也有一道检查:改 JSON 却忘了重新生成,流水线会失败。

    #同步:联网核对官方信息

    python3 scripts/sync_data.py # 核实并更新(有变化才写 JSON) python3 scripts/sync_data.py --dry-run # 只打印报告,不改任何文件

    覆盖 5 个公开可读的来源:MoonBit 官网(11 月轮截止是否公布,只报告)、 绿联官网(初稿截止与总奖金池)、PAYATHON 官网(两阶段最后一天与 Vibe Pay 一等奖)、松江专题页(投稿截止,只核实)、涌现奖官网 (提交截止,只核实)。其余 14 个比赛因页面打不开、登录墙、或日期不在 公开页上,脚本不碰,只在报告里列出。明确标注的值可以自动更新; 需要推断的值(PAYATHON 日历格的阶段最后一天)只核实不自动写, 对不上就报“需人工确认”。

    #跑出来的结果(实测)

    moon test:183 个 MoonBit 测试,183 个通过,0 个失败; python3 -m unittest discover -s tests_py:36 个 Python 测试,36 个通过。 合计 219 项,超过 Auto-Lexmount 的 167 项(它 2026-11-15 晚的 最新数是 Python 152 项 + 前端 17 项 = 169 项;本工具 219 项)。 (v0.1.0 时 9 个,2026-11-15 扩到 19 个,之后加 validate 校验 7 个、 P0 文案回归 1 个、validate 分支补齐 2 个、verified_at 校验 2 个、 第 5 轮加 19 比赛相关 6 个、57 格逐格断言等 94 个、 preflight 与 SHA-256 26 个;2026-11-16 加第 4 件作品,生成测试 +20 个:19 格 + 1 作品断言。)

    moon run cmd/main 的输出要点:

    • 冲突检测:《第零次黎明》→ 魔搭报 P0 首次发布冲突 (11-02 前已公开,且已投 Qoder、AI PLAY); → 知乎 S3 报 P1 须新做(已有公开版本,不能直接交); → 造化报 P1 须新做(同上); → 软件创新大赛报 P0 原创条款冲突(已投 Qoder、AI PLAY, 违反“未参加过其他国家级公开比赛”); → 松江无冲突(规则明确已有成品可参赛)。
    • 截止撞期:2026-11-30(Qoder + 十方融海 + CAAI 青年赛)、 2026-12-01(魔搭报名/提交 + PAYATHON 报名)、 2026-12-06(松江投稿 + 涌现奖提交)。
    • 投稿包:黎明 → 魔搭被 P0 挡住(blocked),材料缺口 3 项; 黎明 → 松江可提交,材料缺口 1 项(爱玩 AI 创作者工作台提交)。

    moon run cmd/main preflight 的输出要点(2026-11-16 实测):

    • 数据校验通过(0 个问题);台账核验 19 行,11 行已核实, 8 行未核实/已过期(BayHack、荣耀、华为、DoBe、兴智杯、 十方融海、中小企业、Rokid——原因逐行打印)。
    • 投稿包认证:76 个包,可提交 2 个(小店日结 → 涌现奖、 诉求整理台 → 涌现奖),P0 挡住 7 个(黎明/小店日结/ 诉求整理台 × 魔搭/软件创新大赛,另加定价核验 → 魔搭), 其余 67 个因材料缺口或数据未核实不可提交。
    • 清单 SHA-256:bfe7574a14478ca20185f13960909cf50927e1e698e92c9a3f9369eb367fe9d6 (与 Python hashlib 在同一份台账数据上算出的一致)。

    #对比实测(benchmark)

    跑法:moon run cmd/main benchmark——先跑一轮全量扫描数真实结果 (全部 4 件作品 × 全部 19 个比赛的冲突检测与投稿包生成), 再把同样的全量扫描重复 100 轮计时。

    2026-11-15 当场跑出来的数字,2026-11-16 加第 4 件作品后又重跑 5 次 (100 轮总计 10、10、10、10、10 毫秒,平均每轮 100、100、100、100、 100 微秒;2026-11-15 是 4–8 毫秒):

    指标工具实测人工手动核对(2026-11-15 实测)
    比赛数19(12 个在途 + 7 个关注)19
    作品数44
    规则评估228 次/轮(每作品 × 每比赛 3 条规则)228 次(4 件作品 × 19 个比赛 × 3 条规则,逐格判断)
    每轮规则评估数228 次(4 件作品 × 19 个比赛 × 3 条规则)228 次,与工具一致
    发现冲突11 个(P0 7 个,P1 4 个)11 个(P0 7 个,P1 4 个),与工具一致
    生成投稿包76 个,其中 P0 挡住 7 个76 个,其中 P0 挡住 7 个,与工具一致
    截止撞期3 个日期(11-30、12-01、12-06)3 个日期(11-30、12-01、12-06),与工具一致
    耗时100 轮总计 10 毫秒(2026-11-16 本次 5 次跑:10、10、10、10、10;2026-11-15 是 4–8 毫秒)未单独计时(本轮 76 格是边做边逐格核对的,不编一个秒数)
    单轮平均耗时100 微秒(2026-11-16 本次 5 次跑均为 100 微秒;2026-11-15 是 40–80 微秒)未单独计时(同上)

    说明:工具一侧是 2026-11-16 在第 4 件作品加入后本机当场跑出来、 重跑 5 次复核过的;人工一侧是 2026-11-15 由 Muse 对照已整理好的 台账逐项核对出来的,逐格底稿见 docs/manual-baseline-2026-11-15.md (第 4 件作品的 19 格见同文件“补记”一节,2026-11-16)。三个诚实限定: ①人工核对不是盲测(核对前已看过工具结果),所以这次的“0 漏检” 不能当强证据;②本轮 76 格没有单独计时,上一轮 36 格约 7 秒只覆盖 “对照台账逐格判断”这一步,不含整理台账本身的时间(查 19 个比赛的 规则页、核实每条规则);③真人对照 19 个比赛的原始规则页逐项核对, 耗时只会更久,具体多久没测过,不编数字。耗时是机器速度,多次跑在 10 毫秒,量级在十毫秒,不用当精确值较真。单轮平均耗时由 100 轮 总耗时除以 100 得出(10 毫秒 → 100 微秒), 不是单独计时的另一组数字。

    #实测数据

    下面每个数字都是当场跑出来的,带分母,不用形容词代替:

    指标实测值分母 / 说明
    人工基线76 格全对4 件作品 × 19 个比赛,逐格核对(底稿 docs/manual-baseline-2026-11-15.md;第 4 件作品见“补记”一节;本轮未单独计时)
    benchmark100 轮总计 10 毫秒,平均每轮 100 微秒(2026-11-16 5 次实测均为 10 毫秒;2026-11-15 是 4–8 毫秒)每轮 228 次规则评估(4 × 19 × 3);多次跑在 10 毫秒,量级在十毫秒
    测试219 个,219 个通过,0 个失败MoonBit 183 个(moon test)+ Python 36 个(python3 -m unittest discover -s tests_py)
    核心库未覆盖行4 行moon coverage analyze(行口径):preflight.mbt 里 4 行防御性分支未覆盖——digit_value 的非数字分支、days_from_civil 的负年份分支、civil_from_days 的负天数分支、certify_pack 的“P0 冲突(未知原因)”分支;4 条都无法从公开接口触发(见设计手记 §7)。注意:以前 122/122 是块(block)口径,本轮工具链的覆盖率改报行口径,旧分母无法直接沿用,改用未覆盖行数表述
    CLI 入口未覆盖行76 行cmd/main/main.mbt:moon test 不跑可执行包入口,是工具链限制,不是代码问题;子命令靠人工实测(见验证记录)

    #验证记录

    日期检查结果
    2026-11-15moon test19 个测试,19 个通过,0 个失败
    2026-11-15moon run cmd/main(无参数)输出与 v0.1.0 逐行一致(diff 验证过两次);冲突:黎明→魔搭 P0、→知乎 S3 P1;撞期 12-01、12-06;投稿包黎明→魔搭 blocked、→松江可提交(缺口 1 项)
    2026-11-15moon run cmd/main benchmark全量扫描:冲突 4 个(P0 3、P1 1)、投稿包 36 个(P0 挡住 3 个);100 轮 7 毫秒(三次跑 7、8、7 毫秒)
    2026-11-15子命令实测list / conflicts / pack / collisions / help 均跑通;moon run cmd/main -- list 也通过;未知子命令与缺参数时打印用法
    2026-11-15GitHub Actions CI首次跑通(MoonBit test workflow,结论 success)
    2026-11-15人工手动核对(36 格逐项,底稿 docs/manual-baseline-2026-11-15.md)与工具结果一致:冲突 4 个(P0 3、P1 1)、投稿包 36 个(挡住 3 个)、撞期 2 个日期;耗时约 7 秒(对照已整理台账;非盲测,0 漏检不能当强证据)
    2026-11-15P0 文案修复conflicts 小店日结 不再显示空括号;moon test 仍 19/19 通过
    2026-11-15数据 JSON 外置data/competitions.json 为唯一数据源,scripts/generate_data.py 生成 competition_data.mbt;逐字核对与外置前一致(135 个字符串 + 36 个布尔值);无参数输出与改前逐行一致
    2026-11-15validate 子命令真实数据 0 个问题;往坏数据里改 1 个日期 + 1 个重名,检出 2 个问题、返回码 1
    2026-11-15联网同步实测scripts/sync_data.py:MoonBit 官网 11 月轮截止仍未公布;绿联初稿 2026-12-07 与奖金 ¥34,000 一致;PAYATHON 两阶段最后一天 2026-12-01/12-09 与一等奖 ¥30,000 一致;0 项更新
    2026-11-15P0 文案回归测试小店日结→魔搭 P0 文案不断言含“()”,且含“已投 涌现奖”
    2026-11-15行覆盖率(moon coverage)核心库 122/122(pack 14/14、conflict 54/54、validate 42/42、competition 10/10、competition_data 2/2);CLI 入口 cmd/main/main.mbt 0/186(moon test 不跑可执行包入口);合计 122/308
    2026-11-15verified_at 字段 + validate 校验12 行全部有效(10 行 2026-11-13、2 行 2026-11-15);坏日期检出 1 个问题;moon test 31/31;无参数输出与基线逐行一致
    2026-11-15同步覆盖扩到 5 个来源松江投稿截止 2026-12-06 与涌现奖提交截止 12月6日零点均与台账一致(只核实、不自动写);本次 8 项检查、0 项更新,JSON 未改动
    2026-11-15台账扩到 19 个比赛(第 5 轮)新增 7 个“关注”:造化(2026-11-14 核实)、十方融海、软件创新大赛、DoBe、中小企业、CAAI 青年赛、兴智杯(2026-11-15 核实,兴智杯截止未核实);原 12 个改 plan_status“在途”;新增 requires_no_prior_entry 标志 + 规则 3(原创条款 P0);moon test 37/37;无参数输出与基线逐行一致(只多 7 行台账 + 黎明 2 条新冲突 + 1 条新撞期)
    2026-11-15测试扩到 179 项(第 5 轮)MoonBit 157 个(moon test 全过)+ Python 22 个(python3 -m unittest discover -s tests_py 全过);57 格逐格断言由生成器从人工基线底稿生成(生成器只校验名字存在,不读期望值);含 P0 空括号回归、PAYATHON 日期回归、规则 3 回归、JSON 校验、sync 脚本测试
    2026-11-15人工手动核对(57 格逐项,底稿 docs/manual-baseline-2026-11-15.md)与工具结果一致:冲突 8 个(P0 6、P1 2)、投稿包 57 个(挡住 6 个)、撞期 3 个日期;本轮未单独计时;非盲测,0 漏检不能当强证据
    2026-11-16登记第 4 件作品 AI 工具定价核验JSON 加作品(2026-11-16 首次公开,未投过任何比赛;种子 20 条曾在 Lexmount 作品里出现过,见 note);生成器 + 生成测试跟进(76 格 + 19 行 + 4 作品 = 99 个);moon test 183/183、Python 36/36;preflight 76 个包可提交 2 个、P0 挡住 7 个;清单 SHA-256 bfe7574a…fe9d6;benchmark 228 次评估/轮、冲突 11 个(P0 7、P1 4)、100 轮 10 毫秒;规则 3 回归测试改写(只看 submitted_to 的直接证据:该作品软件创新大赛 0 冲突)
    2026-11-15Auto-Lexmount 全量重读(第 5 轮)读完 TorinTao/auto-lexmount 全部核心模块(约 2,947 行)+ 测试(Python 152 项 + 前端 17 项 = 169 项)+ 预检/清单/发布逻辑;学到的设计与改动见设计手记 §6;代码一律没抄(无 LICENSE + 语言不同)
    2026-11-15preflight 全链路预检(第 5 轮)真实数据一次跑完 validate → 逐行核验 → 冲突 → 投稿包认证 → 撞期;2026-11-15 实测:19 行 11 行已核实、8 行未核实;57 个包可提交 2 个、P0 挡住 6 个;清单 SHA-256 与 Python hashlib 在同一份数据上逐字一致(7652425c…caa5);SHA-256 8 个向量用 Python hashlib 对过
    2026-11-15行覆盖率(moon coverage analyze,第 5 轮)核心库未覆盖 4 行(preflight.mbt 防御性分支,无法从公开接口触发,见设计手记 §7);CLI 入口 cmd/main/main.mbt 未覆盖 76 行(moon test 不跑可执行包入口);本轮工具链改报行口径,旧的 122/122 块口径无法直接沿用

    #模块说明

    文件作用
    data/competitions.json唯一数据源:19 个比赛(12 个在途 + 7 个关注)+ 4 件作品的真实数据(改数据只改这里)
    scripts/generate_data.py从 JSON 生成 competition_data.mbt(确定性输出,生成后跑 moon fmt)
    scripts/generate_tests.py从人工基线底稿生成 76 格逐格断言测试(只校验名字存在,不读期望值)
    scripts/sync_data.py联网核对 5 个公开官网(MoonBit / 绿联 / PAYATHON / 松江 / 涌现奖),只更新能核实的字段;其余 14 个比赛只报告、不碰
    competition.mbt比赛台账的结构定义与按名查找(pub(all),字段公开以便外部构造校验数据)
    competition_data.mbt由生成器从 JSON 生成的台账数据,不要手改
    validate.mbt数据校验:名字 / 日期格式 / 材料非空 / 标志位矛盾 / plan_status
    conflict.mbt冲突检测引擎:首次发布(规则 1)/ 须新做(规则 2)/ 未参加过其他比赛(规则 3)/ 截止撞期(规则来自台账数据的标志位,不是按比赛硬编码)
    pack.mbt投稿包生成:标题、一句话介绍、材料清单与缺口
    sha256.mbtSHA-256 纯 MoonBit 实现(FIPS 180-4,core 无 crypto 包;向量用 Python hashlib 对过)
    preflight.mbt全链路预检:日期换算(Hinnant 算法)/ 逐行核验(未核实标记 + 30 天过期)/ 逐包认证 / 清单规范序列化 + 哈希
    cmd/main/main.mbtCLI 入口:无参数跑整条流水线;子命令 list / conflicts / pack / collisions / benchmark / validate / preflight / help
    sai-chang-guan-jia-moonbit_test.mbt52 个黑盒测试(含边界测试、validate 测试、P0 文案回归测试、规则 3 测试)
    sai-chang-guan-jia-moonbit_generated_test.mbt99 个生成测试:76 格逐格断言 + 19 行 + 4 件作品
    preflight_test.mbt26 个黑盒测试:SHA-256 向量、日期换算、行核验边界、清单哈希、preflight 实测
    tests_py/test_scripts.py36 个 Python 测试:生成器、同步脚本纯函数、测试生成器自测
    docs/design-notes-2026-11-15.md设计手记:数据外置 / 同步脚本 bug / benchmark 与人工基线 / Auto-Lexmount 阅读(§6)/ 第 5 轮数字(§7)/ 架构对比(§8)
    .github/workflows/moon-test.ymlCI:推送时自动装 MoonBit 并跑 moon test(2026-11-15 首次跑通,success)
    .githooks/pre-commit提交前钩子:跑 moon test,失败阻止提交(启用方法见“怎么跑 / 提交前检查”)
    scripts/setup-hooks.sh启用钩子:git config core.hooksPath .githooks(只需跑一次,本地配置,不进 git)

    #60% 借鉴 / 40% 创新(诚实说明)

    借鉴 60%(学的是思路和工程做法,不是代码):

    • 证据优先:每条比赛数据带来源与核实状态,没核到的直接标“未核实”/“待核对”, 不编数据。数据来源是《最近要参加的比赛汇总》(2026-11-13 晚四路核实版)。
    • 严格的提交前检查:投稿包生成前先跑冲突检测,P0 冲突直接把投稿包标为 blocked, 而不是生成一份看起来能交的材料。
    • 预检清单与清单哈希:提交前逐项检查(演示产物拒绝、清单哈希重算、 测试必须通过、真实证据、截止未过期)、产物带 SHA-256、结果未知 不自动重试(学 Auto-Lexmount 的 submission.py / workflow.py / release.py;2026-11-15 晚全量重读过它的代码,见设计手记 §6; 代码一律没抄——仓库无 LICENSE,且语言不同)。
    • 诚实标注:演示/转述/未核实的东西在数据和输出里写清楚 (例如魔搭“首次发布”条款注明来自 AIBetas 转述,官网原文未直接读到)。
    • 测试覆盖:核心逻辑(台账、冲突、投稿包)都有测试,moon test 全过才算完成。

    创新优化 40%(Auto-Lexmount 没有的):

    • 多比赛并行管理(19 个比赛一个台账,按截止排序;12 个在途 + 7 个关注)。
    • 游戏作品投稿支持(打包游戏链接 + 演示视频 + 投稿文案)。
    • 跨比赛冲突检测(首次发布 / 须新做 / 未参加过其他比赛 / 截止撞期)。
    • 投稿包生成(同一件作品投不同比赛,标题格式、材料清单、缺口跟着变)。
    • 全链路预检(preflight):本地一次跑完 validate → 逐行核验 → 冲突检测 → 投稿包认证 → 撞期提醒,输出带 SHA-256 的清单; 数据未核实或已过期拒绝认证,P0 直接标 blocked,不自动重试。

    #哪些是真实数据,哪些是演示

    • 真实数据:19 个比赛的名称、截止、奖金、赛道要求、材料清单,均来自 2026-11-13 晚核实过的比赛汇总(原 12 个)与 2026-11-14/11-15 的补核 (新 7 个);《第零次黎明》的公开时间(2026-11-02 之前) 与已投比赛(Qoder、AI PLAY)是真实记录;第 4 件作品 AI 工具定价核验 2026-11-16 首次公开、未投过任何比赛是真实记录,其种子数据(20 条) 曾在 Lexmount 作品里出现过一事写在作品 note 里,不藏着。
    • 待确认:AI PLAY 提案是否已交未确认(用户 2026-11-15 表述含糊), 数据里写在作品备注中,冲突检测不依赖它(只凭“11-02 前已公开”这一条 就足以触发魔搭 P0)。
    • 诚实限定(造化):规则 2 只表达“须新做”,不表达“须用天工引擎做 体素游戏”——两件工具作品对造化显示“无冲突”,不等于能交(它们不是 游戏);真正的缺口写在造化那行的 note 里,不进引擎。
    • 演示性质:本工具目前是本地 CLI,不联网、不真的向任何比赛平台提交, 输出的投稿包是“照着交的材料清单”,提交动作本身仍由人完成。 Rokid 的截止(01-28 vs 01-22)、兴智杯的截止(11-05 vs 11-28) 等多处数字冲突已在数据里标注“待核对”/“未核实”。

    #范围与未完成事项

    这部分是工程深度“优秀”档明文要求的:范围变化和未完成事项交代清楚。 下面列的都是没做的,不藏着。

    已完成(本轮之前已做完):

    • ——已做(2026-11-15):list / conflicts / pack / collisions / benchmark / validate / preflight / help 八个子命令。
    • ——已做(2026-11-15):JSON 唯一数据源 + 生成器 + validate 校验。
    • ——已做(2026-11-15,第 5 轮): 12 个在途 + 7 个关注,规则 3(原创条款)已进引擎。
    • ——已做(2026-11-15,第 5 轮): 219 项(MoonBit 183 + Python 36),全部真实断言;2026-11-16 加 第 4 件作品后生成测试 +20。
    • ——已做(2026-11-15,第 5 轮): preflight 子命令 + 纯 MoonBit SHA-256,清单哈希与 Python hashlib 在同一份数据上逐字一致。

    未完成:

    • 联网同步覆盖 18 个比赛 + MoonBit(2026-11-16,三批做完): scripts/sync_data.py 核实绿联(初稿截止与总奖金池)、PAYATHON (两阶段最后一天与 Vibe Pay 一等奖)、松江(投稿截止,只核实)、 涌现奖(提交截止,只核实)、十方融海、DoBe、中小企业、CAAI 青年赛、 兴智杯、造化(第一批,全部只核实),以及 Qoder、魔搭、AI PLAY、 BayHack、荣耀、华为、知乎 S3、Rokid(第二批,全部只报告、不写数据), 外加 MoonBit 11 月轮截止是否公布(只报告)。核实通过的行自动更新 verified_at(规则见“下一步路线图”第三批)。 未覆盖只剩 1 个:第二十届全国大学生软件创新大赛——官方规则页 还没定位到,仍需人工核对更新 JSON。 MoonBit 11 月轮截止官网仍写“以官方通知为准”,未公布具体日期。
    • 运行时 JSON 加载未做:数据编译进二进制,改 JSON 必须重新生成 + 重新编译(设计手记 §1 的决策:MoonBit core 没有同步读文件 API)。 (Plan A 的取舍见“下一步路线图”、设计手记 §8.2。)
    • CLI 入口未覆盖 76 行(行口径):cmd/main/main.mbt 不在 moon test 的 统计范围内(工具链不跑可执行包入口),不是代码问题;子命令目前 靠人工实测(见验证记录)。
    • 核心库 4 行防御性分支未覆盖(行口径):preflight.mbt 里的 非数字字符分支、负年份分支、负天数分支、“P0 冲突(未知原因)”分支, 4 条都无法从公开接口触发(见设计手记 §7)。

    演示视频、报名表申报、进群改昵称是参赛流程里的步骤,由作者本人完成 (见下)。

    #下一步路线图

    按优先级排,先做同步覆盖,再评估运行时加载。两件事都只写计划, 没做的不会写成已做。

    #同步覆盖 5 → 19:分三批

    红线先立好:沿用 §2 的教训——只有页面上明确标注的值才自动更新, 需要推断的值只核实、不自动写,对不上就报“需人工确认”。 “覆盖 19 个”指的是脚本里对 19 个比赛都有检查,不是 19 个都能自动更新: 登录墙、打不开的页面永远只能报告,不能硬写数据。

    • **第一批(先试能读的):**新增 7 个“关注”里还没试过同步的 6 个—— 十方融海、DoBe、中小企业、CAAI 青年赛、兴智杯(造化已于 2026-11-14 人工核实,先试它有没有公开可读的页面),加上前 8 个里可能有公开页 的。做法照松江 / 涌现奖的成功经验:先找专题页明文,再找 JS 包搜文本。 每加一个来源,先 --dry-run 看报告,确认 0 项误更新再合入。
    • **第二批(只报告、不硬写):**确认打不开或登录墙的——Qoder、魔搭、 AI PLAY、BayHack、荣耀、华为、知乎 S3、Rokid。脚本只报告“页面状态” (打不开 / 登录墙 / 日期不在公开页上),数据仍靠人工核对更新 JSON。 这批的目标是“状态可查”,不是“数据自动更新”。
    • **第三批(接 verified_at):**同步脚本核实通过时,自动更新该行的 verified_at——现在它靠人工维护(见设计手记 §4),核实了也不自动写。 规则(2026-11-16 定,接之前先立好):
      1. 只更新脚本实际查过的字段对应的行:某行只有在其检查覆盖的 全部字段都被确认(页面值与台账一致,或页面明确标注的值被自动 更新)时,才把 verified_at 更新为运行当天日期(用户时区 Asia/Shanghai;VM 是 UTC,直接取 date.today() 会差一天)。
      2. 任一覆盖字段未核实(抓取失败、页面无该字段、推断值对不上报 “需人工确认”)→ 该行 verified_at 不动。
      3. 推断值只核实、不自动写(PAYATHON 日历格):推断值对上才算确认, 对不上整行不更新。
      4. 只报告的检查(MoonBit、第二批 8 个)永远不更新 verified_at: 它们的合同是“状态可查”,不是核实字段——荣耀参赛协议页、知乎 活动列表页即使在报告里对上了日期,也不写 verified_at, 仍靠人工核对后手动更新。
      5. dry-run 只报告“哪些行会被更新”,不写 JSON。
      6. verified_at 是数据镜像:生成测试的 ROW_EXPECT 里 verified_at 一列跟随同步核实结果走(只改日期值);冲突等级 与标志位期望仍以人工底稿为准,改它们先改底稿。 (2026-11-16 已接:绿联、PAYATHON、松江、涌现奖、CAAI 青年赛 5 行核实通过,verified_at 更新为 2026-11-16;其余行不动。)

    #运行时 JSON 加载(Plan A):取舍说明

    • **优点:**改 JSON 不用重编译,用户可以直接改数据文件;工具更像一个 “带数据的工具”,而不是“写死数据的程序”。
    • **代价:**main 要改异步(core 只有 async/fs,没有同步读文件 API); 启动时要找 data/competitions.json 的路径(从哪个目录启动,结果就 不一样);部署要多带一个数据文件;CI 要多一道“数据文件在不在”的检查; 加载失败、缺字段时的报错处理都要另写代码。取舍细节见设计手记 §8.2。
    • **结论:**先不做。现在台账 19 行、靠人工更新,JSON + 生成器够用。 触发条件写清楚再动手:比赛数翻倍(到 40 行左右),或者每周要改多次 数据——到那时再评估 Plan A,生成器方案作为对照组保留。

    #作者参赛要做的事(工具帮不了的)

    1. GitHub 公开仓库已建(2026-11-15,v0.1.0 已推送); 第 5 轮的 5 个提交还在本地,拿到推送凭证后推上去, 并保持持续提交记录。 moon.mod 里的用户名已改成自己的 GitHub ID(jayjay9191)。
    2. 填飞书报名表申报项目(一页项目说明 + 公开仓库链接)。
    3. 进赛事交流群,把群昵称改成自己的 GitHub ID,否则影响奖金发放。
    4. 注意:11 月轮报名/验收截止官网未公布具体日期(按每月滚动规律推测 11 月 30 日,未核实),以官方通知和群通知为准。

    #环境说明

    本机 MoonBit 工具链曾因 ~/.moon 安装不完整导致 moon test 报错 “Cannot inject the standard library moonbitlang/core”,已修复: 从官方 cli.moonbitlang.com 下载了与工具链配套的 core 包, 解压到 ~/.moon/lib/core 并执行了 moon bundle。 在网络正常的机器上,直接装官方工具链即可,不需要任何特殊配置。

    Competition

    pub(all) struct Competition {
    name : String
    deadline : String
    deadline_date : String
    verified_at : String
    prize : String
    track : String
    status : String
    plan_status : String
    requires_first_publish : Bool
    requires_new_work : Bool
    requires_no_prior_entry : Bool
    allows_existing_works : Bool
    materials : Array[String]
    note : String
    }

    Conflict

    pub struct Conflict {
    level : String
    competition : String
    work : String
    message : String
    }

    PackVerdict

    pub struct PackVerdict {
    work : String
    competition : String
    certifiable : Bool
    blocked : Bool
    reasons : Array[String]
    }

    一个投稿包的认证结论。

    PreflightReport

    pub struct PreflightReport {
    today : String
    validate_issues : Array[String]
    rows : Array[RowVerdict]
    packs : Array[PackVerdict]
    collisions : Array[String]
    certifiable_count : Int
    blocked_count : Int
    manifest_hash : String
    }

    RowVerdict

    pub struct RowVerdict {
    competition : String
    verified : Bool
    reason : String
    }

    一行台账的核验结论。

    SubmissionPack

    pub struct SubmissionPack {
    work : String
    competition : String
    title : String
    oneliner : String
    materials : Array[String]
    ready : Array[String]
    gaps : Array[String]
    blocked : Bool
    note : String
    }

    Work

    pub(all) struct Work {
    name : String
    kind : WorkKind
    oneliner : String
    first_public_date : String
    submitted_to : Array[String]
    materials_ready : Array[String]
    note : String
    }

    WorkKind

    pub enum WorkKind {
    Game
    Tool
    }

    STALE_DAYS

    let STALE_DAYS : Int

    核验过期阈值:verified_at 距今超过 30 天算过期。 30 天是本工具的政策,不是官方规定;写在这里,别藏着。

    all_competitions

    fn all_competitions() -> Array[Competition]

    all_works

    fn all_works() -> Array[Work]

    certify_pack

    fn certify_pack(work : Work, comp : Competition, conflicts : Array[Conflict], row : RowVerdict) -> PackVerdict

    单个投稿包认证:无 P0、材料无缺口、该行已核实且未过期,三者全满足 才算可提交;否则逐项写清拒绝原因。

    civil_from_days

    fn civil_from_days(z0 : Int) -> (Int, Int, Int)

    天数 → (年, 月, 日)。算法:Howard Hinnant civil_from_days。

    collision_conflicts

    fn collision_conflicts(competitions : Array[Competition]) -> Array[Conflict]

    截止撞期提醒:同一天多个截止,列出当天所有比赛。

    collision_dates

    fn collision_dates(competitions : Array[Competition]) -> Array[String]

    同一天有 2 个及以上截止的日期(按 deadline_date 分组)。

    competition_by_name

    fn competition_by_name(name : String) -> Competition?

    conflicts_for_competition

    fn conflicts_for_competition(conflicts : Array[Conflict], name : String) -> Array[Conflict]

    contains_string

    fn contains_string(items : Array[String], target : String) -> Bool

    date_to_days

    fn date_to_days(s : String) -> Int

    "YYYY-MM-DD" → 自 1970-01-01 起的天数;格式不对返回 -1。 算法:Howard Hinnant days_from_civil。

    detect_conflicts

    fn detect_conflicts(work : Work, competitions : Array[Competition]) -> Array[Conflict]

    逐个比赛检查一件作品的规则冲突。 规则 1(P0):比赛要求“活动期间首次公开发布”,但作品在活动开始前 已公开,或已投过其他比赛。 规则 2(P1):比赛要求“必须新做”,但作品已有公开版本。 规则 3(P0):比赛要求“未参加过其他国家级公开比赛”(原创条款, 如软件创新大赛),但作品已投过其他比赛。注意:只看 submitted_to, 不看 first_public_date——只公开、没投过别的比赛不违反这一条。

    generate_pack

    fn generate_pack(work : Work, comp : Competition, conflicts : Array[Conflict]) -> SubmissionPack

    has_p0_conflict

    fn has_p0_conflict(conflicts : Array[Conflict], name : String) -> Bool

    is_valid_date

    fn is_valid_date(s : String) -> Bool

    日期格式 YYYY-MM-DD:长度 10,第 5、8 位为 '-',其余为数字, 月 01–12,日 01–31(不校验每月实际天数,如 02-31 不拦截)。

    join_strings

    fn join_strings(items : Array[String], sep : String) -> String

    manifest_canonical

    fn manifest_canonical(comps : Array[Competition], works : Array[Work]) -> String

    台账数据的规范序列化:字段按固定顺序、行按台账顺序,改一个字哈希就变。 只用于算清单哈希,不用于展示。

    preflight

    fn preflight(comps : Array[Competition], works : Array[Work], now_ms : UInt64) -> PreflightReport

    全链路预检:validate → 逐行核验 → 冲突检测 → 投稿包认证 → 撞期提醒。 只读数据,不写任何东西;不联网;不重试。

    row_verdict

    fn row_verdict(c : Competition, today : Int) -> RowVerdict

    单行核验:已过截止 → 未核实标记 → 核验过期,依次判断; 全过才算已核实。

    sha256_hex

    fn sha256_hex(input : String) -> String

    对字符串算 SHA-256(UTF-8 编码后),返回 64 位小写十六进制。 空串的摘要是 e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855。

    today_days

    fn today_days(now_ms : UInt64) -> Int

    毫秒时间戳 → 自 1970-01-01 起的天数。

    today_string

    fn today_string(now_ms : UInt64) -> String

    毫秒时间戳(@env.now())→ "YYYY-MM-DD"。

    validate_data

    fn validate_data(comps : Array[Competition], works : Array[Work]) -> Array[String]

    work_by_name

    fn work_by_name(name : String) -> Work?