内部归档格式
每次处理一条短信后，在 archive/ 下创建一条 JSON 记录，不保存文书本身（文书归档到案件目录）。
文件路径
archive/YYYYMMDD_HHMMSS_{案号后4位}.json
JSON 结构
{
"id": "20260404_143025_1234",
"timestamp": "2026-04-04T14:30:25+08:00",
"sms_raw": "【xx市人民法院】张三，您好！您有（2025）苏0981民初1234号案件文书送达，请点击链接查收：https://zxfw.court.gov.cn/...",
"parsed": {
"type": "document_delivery",
"case_number": "（2025）苏0981民初1234号",
"parties": ["张三", "xx有限公司"],
"court": "xx市人民法院"
},
"download": {
"source_url": "https://zxfw.court.gov.cn/zxfw/#/pagesAjkj/app/wssd/index?qdbh=XX&sdbh=XX&sdsin=XX",
"params": { "qdbh": "XX", "sdbh": "XX", "sdsin": "XX" },
"method": "curl",
"status": "success",
"document_title": "受理通知书",
"api_response": {
"c_fymc": "苏州工业园区人民法院",
"c_fybh": "1275",
"documents": [
{
"c_wsmc": "传票（东沙湖法庭）",
"c_wsbh": "ecb8fe64e4834804b50ea0f9257327e0"
}
]
}
},
"document": {
"type": "一审判决书",
"sent_at": "2026-04-08T10:00:00+08:00",
"sent_at_source": "短信网关时间",
"received_at": "2026-04-08T14:30:00+08:00",
"appeal_deadline": "2026-04-23T23:59:59+08:00",
"appeal_days_remaining": 15
},
"archive": {
"matched_case": "260101 张三与李四合同纠纷",
"target_path": "260101 张三与李四合同纠纷/受理通知书（张三与李四合同纠纷）_20260404收.pdf",
"summary": "传票：2025年4月15日 14:30 第3法庭开庭"
}
}字段说明
| 字段 | 必需 | 说明 |
|---|---|---|
id |
是 | 归档唯一标识，即文件名（不含扩展名） |
timestamp |
是 | ISO 8601 格式的处理时间 |
sms_raw |
是 | 短信原文，完整保留 |
parsed.type |
是 | 短信类型：document_delivery / filing_notification / info_notification |
parsed.case_number |
否 | 提取到的案号，未提取到时为 null |
parsed.parties |
否 | 提取到的当事人列表 |
parsed.court |
否 | 提取到的法院名称 |
parsed.sent_at |
否 | 法院发送时间，从短信或送达平台提取 |
parsed.received_at |
否 | 用户收到时间（如有） |
download.source_url |
否 | 原始下载链接 |
download.params |
否 | 从 URL 提取的参数（如 qdbh/sdbh/sdsin） |
download.method |
否 | 实际使用的下载方式：curl / cli / mcp / manual / null（无下载链接） |
download.status |
是 | 下载状态：success / failed / manual / skipped |
download.api_response |
否 | API 完整响应，包含 c_fymc（法院名称）、c_fybh（法院编号）、documents 数组（每份文书详情）。实测 zxfw getWsListBySdbhNew 响应不含 dt_cjsj，送达时间须另寻来源（见 document.sent_at_source） |
download.api_response.c_fymc |
否 | 法院名称（来自 API） |
download.api_response.c_fybh |
否 | 法院编号 |
download.api_response.documents[].c_wsmc |
否 | 文书名称 |
download.api_response.documents[].c_wsbh |
否 | 文书编号（UUID） |
document.type |
否 | 文书类型：判决书/裁定书/调解书等（从 PDF 解析） |
document.sent_at |
否 | 法院发送时间（送达平台记录） |
document.sent_at_source |
否 | sent_at 的实际来源标识（例：开庭公告缴费通知 PDF 内二维码生成时间、短信网关时间）。zxfw 送达 API 不返回送达时间字段，此字段用于让时间可追溯，避免用文书落款日冒充送达日 |
document.received_at |
否 | 用户收到时间（手机短信网关时间） |
document.appeal_deadline |
否 | 上诉截止日期（根据案件类型计算） |
document.appeal_days_remaining |
否 | 剩余上诉天数 |
archive.matched_case |
否 | 匹配到的案件目录名 |
archive.target_path |
否 | 文书最终归档的相对路径 |