#MoonPost

• Creator：面向自媒体、口播、短视频和 AI 字幕清洗，默认温和提示，关注文本规范、标点、错别字/术语提示、阅读体验和平台化字幕习惯。
• Delivery：面向影视、OTT、广播和字幕交付 QC，默认严格验收，关注时间轴合法性、帧网格、CPL/CPS、最小间隔、JSON 报告和自动化失败退出码。

#仓库与赛事状态

#功能

• 解析和写出 SRT / WebVTT / ASS 字幕文件，并支持多种格式相互转换。
• 解析和格式化 SMPTE 风格时间码，支持时间码、帧数、时长和常用帧率之间的精确换算。
• 支持常用帧率：23.976、24、25、29.97、29.97df、30、 50、59.94、59.94df。
• 支持按整体偏移、帧率转换或帧吸附重定时字幕。
• 在库 API 中提供双语字幕合并和拆分能力。
• 提供浏览器本地 Wasm demo，不上传字幕文件即可运行核心 QC。

• 面向抖音、B 站、YouTube、双语字幕等 profile 做发布前检查。
• 默认以 Warning / Info 的温和方式提示文本问题。
• 可显式开启中英双语文本规范检查：混用标点、重复标点、括号/引号配对、 超长连续字符块、孤立单字行和小型术语词库。
• 支持字幕标点半角/全角规范化转换，适合 AI 字幕和口播字幕清洗。
• 提供 creator check 与 creator clean，用于发布前检查和安全格式清理。

• 面向影视、OTT、影院和广播字幕交付 profile 做严格 QC。
• 检查时间重叠、非法时长、空字幕、时长上下限、单行字符数、行数、阅读速度、 帧网格对齐和最小 cue 间隔。
• 支持 JSON report 和 --fail-on-error，适合自动化交付检查。
• 提供 delivery check 目录级交付预检和 delivery subtitle-check 单字幕文件 QC，可检查交付包资产、manifest、metadata、SHA-256 checksum 和字幕问题。

#两条生产线

#使用场景

• AI 字幕、口播字幕和短视频字幕发布前清洗。
• 检查中英混排、标点风格、重复标点、括号/引号配对、孤立单字行。
• 在不改变语义的前提下做半角/全角标点规范化。
• 按平台习惯检查字幕行长、阅读速度和视觉密度。

• 交付前检查 SRT/WebVTT/ASS 字幕的重叠、时长、行长、行数和阅读速度问题。
• 检查帧率假设、帧网格对齐和 cue 最小间隔。
• 在剪辑或版本变更后平移字幕、转换帧率或吸附到目标帧网格。
• 输出 JSON report，并用 --fail-on-error 接入自动化交付流程。

• 在创作者和本地化流程中完成 SRT/WebVTT/ASS 转换与基础质检。
• 通过浏览器本地 Wasm demo 运行核心 QC，字幕文本不上传服务器。

#适用人群

#环境要求

• MoonBit 工具链。
• 可运行 moon 命令的 shell 环境。
• 如果要用示例命令启动本地 Wasm demo，需要 Python 3。

moon 0.1.20260512
moonc v0.9.2

#安装

moon add MaoDingA/moonpost

// 字幕解析与写出
let track = parse_srt(input)
// 时间码与帧率
let tc = parse_timecode("01:00:00:00", FrameRate::fps_25())
// QC 校验
let issues = check_cues(track.cues, default_profile())

#快速开始

moon test --target native
moon test --target wasm-gc

moon run cmd/main --target native -- --help

moon run cmd/main --target native --

#5 分钟用户体验路径

moon build cmd/main --target native
./scripts/e2e-acceptance.sh
_build/native/debug/build/cmd/main/main.exe subtitle convert examples/good.srt --to ass
_build/native/debug/build/cmd/main/main.exe creator clean examples/creator/ai-clean-bad.srt --verbose
_build/native/debug/build/cmd/main/main.exe delivery subtitle-check examples/bad.srt --profile nrta --fail-on-warning

#Creator / Delivery 示例

moon run cmd/main --target native -- creator check examples/bilingual.srt --profile bilingual
moon run cmd/main --target native -- creator clean examples/good.srt --profile douyin -o fixed.srt
moon run cmd/main --target native -- delivery check examples/delivery-package/good --json
moon run cmd/main --target native -- delivery subtitle-check examples/bad.srt --profile ott-zh --fps 25
moon run cmd/main --target native -- delivery subtitle-check examples/delivery/dcp-source-srt-bad.srt --profile dcp-source-srt --fail-on-warning
moon run cmd/main --target native -- delivery subtitle-check examples/delivery/dcp-source-srt-bad.srt --profile dcp-frame-strict --fail-on-warning

#Creator AI 字幕清洗示例

moon run cmd/main --target native -- creator check examples/creator/ai-clean-bad.srt --profile douyin

examples/creator/ai-clean-bad.srt
summary: 0 errors, 15 warnings

WARN C601 cue#1 | repeated word: '然后'
WARN C601 cue#2 | repeated word: '就是'
WARN C602 cue#3 | ASR marker: ASR music marker '[Music]'
WARN C401 cue#3 | possible confusion: '认真的做' should be '认真地做'
WARN C402 | inconsistent term: 'moonpost' vs canonical 'MoonPost'
WARN C402 | inconsistent term: 'webvtt' vs canonical 'WebVTT'

#explain 和 profile

moon run cmd/main --target native -- explain C601
moon run cmd/main --target native -- explain E101

moon run cmd/main --target native -- profile list
moon run cmd/main --target native -- profile show creator --name douyin
moon run cmd/main --target native -- profile show delivery --name ott-zh

#Delivery 第一阶段目标

moon run cmd/main --target native -- delivery check examples/delivery-package/good --json
moon run cmd/main --target native -- delivery check examples/delivery-package/checksum-bad --fail-on-error
moon run cmd/main --target native -- delivery check examples/delivery-package/bad --profile distribution --subtitle-profile ott-zh --fps 25
moon run cmd/main --target native -- delivery check examples/delivery-package/srt-source-bad --profile distribution --subtitle-profile dcp-source-srt --fail-on-warning
moon run cmd/main --target native -- delivery check examples/delivery-package/srt-source-bad --profile distribution --subtitle-profile dcp-frame-strict --fail-on-warning

moon run cmd/main --target native -- delivery subtitle-check examples/delivery/ott-good.srt --profile ott-zh --json
moon run cmd/main --target native -- delivery subtitle-check examples/delivery/srt-basic-good.srt --profile srt-basic --fail-on-error
moon run cmd/main --target native -- delivery subtitle-check examples/delivery/dcp-source-srt-bad.srt --profile dcp-source-srt --fail-on-warning
moon run cmd/main --target native -- delivery subtitle-check examples/delivery/dcp-source-srt-bad.srt --profile dcp-frame-strict --fail-on-warning
moon build cmd/main --target native
_build/native/debug/build/cmd/main/main.exe delivery subtitle-check examples/delivery/ott-bad.srt --profile ott-zh --fps 25 --fail-on-error

#CLI 概览

MoonPost - subtitle, timecode and post-production QC toolkit

Usage:
  moonpost <command> [options]

Commands:
  creator     Check and clean creator-platform subtitle files with gentle hints
  delivery    Run strict delivery-profile subtitle checks
  subtitle    Convert subtitle formats
  timecode    Convert SMPTE-style timecode and frame counts
  retime      Shift, speed-convert, or snap subtitle timing
  merge       Merge two subtitle tracks into bilingual cues
  split-bilingual
              Split bilingual cues into two subtitle tracks
  qc          Compatibility alias for subtitle delivery QC
  explain     Explain a QC diagnostic code
  profile     List or show profile configurations

#字幕 QC

moon run cmd/main --target native -- qc examples/bad.srt --fps 25 --profile streaming

moon run cmd/main --target native -- qc examples/good.srt --json

moon run cmd/main --target native -- qc examples/good.srt --text-style bilingual

moon build cmd/main --target native
_build/native/debug/build/cmd/main/main.exe qc examples/bad.srt --fail-on-error

examples/bad.srt
summary: 3 errors, 8 warnings

WARN W201 cue#1 | duration 377ms below minimum 800ms
WARN W310 cue#1 | 225 cps exceeds max 20
WARN W311 cue#1 | 34 wps exceeds max 3
WARN W203 cue#1 | line 1: 85 chars, max 42
WARN W401 cue#1 | cue timing is not aligned to 40ms frame grid
WARN W202 cue#2 | duration 7600ms above maximum 7000ms
WARN W203 cue#2 | line 1: 49 chars, max 42
ERROR E102 cue#3 | end time must be after start time
ERROR E201 cue#3 | empty cue text
WARN W401 cue#3 | cue timing is not aligned to 40ms frame grid
ERROR E101 cue#1 | overlaps cue#2 by 100ms

#QC Profiles

#QC 规则代码

#时间码

moon run cmd/main --target native -- timecode to-frames 01:00:00:00 --fps 25

01:00:00:00 @25fps = 90000 frames

moon run cmd/main --target native -- timecode from-frames 90000 --fps 25

90000 frames @25fps = 01:00:00:00

moon run cmd/main --target native -- timecode convert 01:00:00:00 --from 23.976 --to 25

01:00:00:00 @23.976fps = 01:00:03:15 @25fps

moon run cmd/main --target native -- timecode imf-from '01:00:00;00' --fps 29.97df

01:00:00;00 @29.97df = editRate 30000/1001 timecodeRate 30 dropFrame true startAddress 01:00:00:00

moon run cmd/main --target native -- timecode edl-event '001 AX V C 01:00:00:00 01:00:10:00 00:00:00:00 00:00:10:00' --fps 25

001 AX V C 01:00:00:00 01:00:10:00 00:00:00:00 00:00:10:00

#字幕转换

moon run cmd/main --target native -- subtitle convert examples/good.srt --to webvtt

moon run cmd/main --target native -- subtitle convert examples/good.srt --to ass -o output.ass

moon run cmd/main --target native -- subtitle convert examples/anime.ass --to srt -o output.srt

moon run cmd/main --target native -- subtitle convert examples/good.srt --to webvtt -o output.vtt

moon run cmd/main --target native -- subtitle convert examples/good.vtt --to srt -o output.srt

moon run cmd/main --target native -- subtitle normalize examples/good.srt --punctuation bilingual -o fixed.srt

• SRT cue 可以包含数字序号。
• SRT cue 没有数字序号时也可解析。
• WebVTT 文件必须包含 WEBVTT header。
• WebVTT cue identifier 会被保留。
• 写出 WebVTT 时会保留 cue settings。
• WebVTT NOTE、STYLE、REGION metadata block 会被 parser 跳过。
• 可处理文件开头的 UTF-8 BOM。
• 可处理 CRLF 行尾。

#Retime

moon run cmd/main --target native -- retime examples/good.srt --offset +1200ms

1
00:00:02,200 --> 00:00:04,400
Hello, welcome to MoonBit.

2
00:00:05,200 --> 00:00:06,700
This subtitle is ready for QC.

moon run cmd/main --target native -- retime examples/good.srt --offset -500ms -o shifted.srt

moon run cmd/main --target native -- retime examples/good.srt --from-fps 23.976 --to-fps 25 -o converted.srt

moon run cmd/main --target native -- retime examples/good.srt --snap-fps 25 -o snapped.srt

#浏览器 Wasm Demo（本地运行）

需要支持 WebAssembly GC 的浏览器（Chrome 119+ / Firefox 120+ / Edge 119+）

./wasm-demo/build.sh

python3 -m http.server 8765 --directory wasm-demo/public

http://localhost:8765

#Library Packages

#核心公开 API

parse_timecode(String, FrameRate) -> Timecode?
parse_timecode_result(String, FrameRate) -> Result[Timecode, TimecodeParseError]
parse_timecode_with_policy(String, FrameRate, TimecodeParsePolicy) -> Result[Timecode, TimecodeParseError]
Timecode::to_frames() -> Int
Timecode::format() -> String
Timecode::add_frames(Int) -> Timecode
Timecode::sub_frames(Int) -> Timecode
Timecode::add_duration(Duration) -> Timecode?
Timecode::sub_duration(Duration) -> Timecode?
Timecode::frame_distance(Timecode) -> Int?
Timecode::is_before(Timecode) -> Bool?
Timecode::is_after(Timecode) -> Bool?
FrameRate::frames_to_timecode(Int) -> Timecode
FrameRate::frames_to_timecode_with_wrap(Int, TimecodeWrapMode) -> Timecode
FrameRate::parse(String) -> FrameRate?
FrameRate::label() -> String
FrameRate::nominal_fps() -> Int
FrameRate::fps_numerator() -> Int
FrameRate::fps_denominator() -> Int
convert_timecode(Timecode, FrameRate) -> Timecode
rescale_ms_between_rates(Int, FrameRate, FrameRate) -> Int
Duration::from_frames(Int, FrameRate) -> Duration
Duration::from_ms(Int, FrameRate) -> Duration
Duration::to_frames() -> Int
Duration::to_ms() -> Int
Duration::format() -> String
Duration::add(Duration) -> Duration?
Duration::sub(Duration) -> Duration?
Duration::scale(Int) -> Duration
TimecodeRange::new(Timecode, Timecode) -> TimecodeRange?
TimecodeRange::duration() -> Duration?
TimecodeRange::contains(Timecode) -> Bool?
TimecodeRange::overlaps(TimecodeRange) -> Bool?
TimecodeRange::shift(Duration) -> TimecodeRange?
RationalSeconds::parse(String) -> RationalSeconds?
RationalSeconds::format() -> String
RationalSeconds::to_frames(FrameRate) -> Int
RationalSeconds::from_frames(Int, FrameRate) -> RationalSeconds
FcpXmlTimecodeAttrs::to_timecode() -> Result[Timecode, TimecodeInteropError]
FcpXmlTimecodeAttrs::from_timecode(Timecode) -> FcpXmlTimecodeAttrs
ImfTimecode::to_timecode() -> Result[Timecode, TimecodeInteropError]
ImfTimecode::from_timecode(Timecode) -> ImfTimecode
ImfEditRate::from_frame_rate(FrameRate) -> ImfEditRate
ImfEditRate::to_frame_rate(Bool) -> Result[FrameRate, TimecodeInteropError]
ImfCompositionTimecode::to_timecode() -> Result[Timecode, TimecodeInteropError]
ImfCompositionTimecode::from_timecode(Timecode) -> ImfCompositionTimecode
SmpteUserBits::from_hex(String) -> Result[SmpteUserBits, TimecodeInteropError]
SmpteUserBits::format_hex() -> String
SmpteTimecodeWord::from_timecode(Timecode) -> SmpteTimecodeWord
SmpteTimecodeWord::to_timecode() -> Result[Timecode, TimecodeInteropError]
SmpteTimecodeWord::pack_ltc_bytes() -> Result[Bytes, TimecodeInteropError]
SmpteTimecodeWord::unpack_ltc_bytes(Bytes, FrameRate) -> Result[SmpteTimecodeWord, TimecodeInteropError]
EdlEvent::parse(String, FrameRate) -> Result[EdlEvent, TimecodeInteropError]
EdlEvent::format() -> String
AppleDeliveryTimecodeFormat::parse(String) -> FrameRate?
AppleDeliveryTimecodeFormat::format(FrameRate) -> String?
AppleDeliveryTimecodeFormat::supported_rates() -> Array[FrameRate]
AppleDeliveryTimecodeFormat::is_supported(FrameRate) -> Bool

parse_srt(String) -> SubtitleTrack?
parse_srt_detailed(String) -> Result[SubtitleTrack, ParseError]
parse_webvtt(String) -> SubtitleTrack?
parse_webvtt_detailed(String) -> Result[SubtitleTrack, ParseError]
write_srt(SubtitleTrack) -> String
write_webvtt(SubtitleTrack) -> String
parse_timestamp_ms(String) -> Int?
format_srt_timestamp(Int) -> String
format_vtt_timestamp(Int) -> String

default_profile() -> QcProfile
streaming_profile() -> QcProfile
cinema_profile() -> QcProfile
social_video_profile() -> QcProfile
profile_by_name(String) -> QcProfile?
check_cues(Array[Cue], QcProfile) -> Array[QcIssue]
check_srt_source_track(SubtitleTrack, SrtSourcePolicy) -> Array[QcIssue]
srt_basic_source_policy() -> SrtSourcePolicy
dcp_source_srt_policy() -> SrtSourcePolicy
format_report(String, Array[QcIssue]) -> Array[String]
format_json_report(String, Array[QcIssue]) -> String
has_errors(Array[QcIssue]) -> Bool

offset_cues(Array[Cue], Int) -> Array[Cue]
convert_fps_cues(Array[Cue], FrameRate, FrameRate) -> Array[Cue]
snap_cues_to_frames(Array[Cue], FrameRate) -> Array[Cue]

merge_bilingual(Array[Cue], Array[Cue], tolerance_ms~ : Int) -> Array[Cue]
split_bilingual(Array[Cue]) -> BilingualSplit

parse_asset_map(String) -> Result[Array[DcpAsset], DcpParseError]
parse_packing_list(String) -> Result[Array[DcpAsset], DcpParseError]
parse_composition_playlist(String) -> Result[DcpComposition, DcpParseError]
check_dcp_package(DcpPackage) -> Array[DcpIssue]
has_dcp_errors(Array[DcpIssue]) -> Bool
classify_dcp_path(String) -> DcpAssetKind

qc_subtitle(String, String) -> String

#仓库结构

moonpost/
├── timecode/        SMPTE 风格时间码和帧率 helpers
├── subtitle/        SRT/WebVTT/ASS parser、timestamp 和 writer
├── qc/              字幕 QC、报告、双语文本规范和标点规范化
├── retime/          整体偏移、帧率转换和帧吸附
├── align/           双语字幕 merge/split helpers
├── delivery/        单集交付预检模型和 manifest 解析
├── dcp/             DCP AssetMap、PKL、CPL 轻量解析和一致性检查
├── cli/             CLI 参数模型和命令解析
├── cmd/main/        Native CLI 入口和文件系统 I/O
├── wasm_demo/core/  MoonBit Wasm 导出包
├── wasm-demo/       浏览器 demo shell、构建脚本和静态资源
├── examples/        示例字幕文件
├── docs/            项目结构、设计文档和实施计划
└── .github/         CI workflow

#CI

• 大赛预验收严格入口：./scripts/competition-check.sh。
• 当前 MoonBit CLI 不支持裸 moon fmt --deny-warn 和 moon info --deny-warn；CI 使用 moon fmt --check、 moon check --fmt --deny-warn、moon info 加 git diff --exit-code -- . 作为兼容严格检查。
• moon check --target native --deny-warn 和 moon check --target wasm-gc --deny-warn。
• moon build --target native 和 moon build --target wasm-gc。
• moon test --target native --deny-warn 和 moon test --target wasm-gc --deny-warn。
• Wasm demo release 构建和 wasm-demo/public/moonpost_qc.wasm 产物检查。
• CLI 冒烟测试：timecode、subtitle convert、QC report。

#开发

./scripts/competition-check.sh

moon test --target native

moon test --target wasm-gc

moon check --target native
moon check --target wasm-gc

moon fmt --check
moon check --fmt --deny-warn

moon info
git diff --exit-code -- .

moon build wasm_demo/core --target wasm-gc --release

#许可证