court-sms skill

法院短信识别与文书下载

功能概述

处理法院短信的完整流程：粘贴短信 → 解析内容 → 匹配案件 → 下载文书 → 归档保存。

支持两种触发方式：

方式一：粘贴短信原文

收到法院短信，内容如下：
【xx市人民法院】张三，您好！您有（2025）苏0981民初1234号案件文书送达，请点击链接查收：https://zxfw.court.gov.cn/zxfw/#/pagesAjkj/app/wssd/index?qdbh=DEMO1&sdbh=DEMO2&sdsin=DEMO3

方式二：直接发送送达链接

用户可能直接粘贴送达链接（非完整短信文本），此时跳过短信文本解析，直接从 URL 中提取 qdbh、sdbh、sdsin 参数，进入第三步下载流程。

https://zxfw.court.gov.cn/zxfw/#/pagesAjkj/app/wssd/index?qdbh=xxx&sdbh=xxx&sdsin=xxx

短信类型分类

支持的送达平台：zxfw.court.gov.cn（全国）、sd.gdems.com（广东）、jysd.10102368.com（集约送达）、dzsd.hbfy.gov.cn（湖北）、sfpt.cdfy12368.gov.cn（司法送达网）。同一平台可能使用不同域名（同构异域名），通过 URL 路径特征识别平台。详见 references/sms-patterns.json。

工作流（四步）

第一步：输入解析

1. 读取 references/sms-patterns.json 作为解析参考
2. 判断输入类型：

• 完整短信：包含法院签名（如 【xx法院】）+ 正文 + 链接 → 完整解析流程
• 纯链接：用户直接发送送达 URL（如 https://zxfw.court.gov.cn/...?qdbh=xxx&sdbh=xxx&sdsin=xxx）→ 跳过短信文本解析，直接从 URL 提取参数，进入第三步下载。案号、当事人等信息在下载文书后从文书内容中提取。

1. 对用户粘贴的短信文本进行分析（纯链接输入跳过此步）：

a) 短信分类：根据关键词判断类型

• 文书送达：包含 zxfw.court.gov.cn 链接
• 立案通知：包含"已立案"、"立案通知"等
• 信息通知：其他

b) 案号提取：使用正则 [（(〔[]\d{4}[）)〕]] 匹配标准案号格式

标准案号格式示例：

• （2025）苏0981民初1234号
• (2024)粤0604执保5678号
• 〔2025〕京0105民初901号

c) 当事人提取：从短信文本初步识别，最终以文书内容为准

• 注意：短信中的称呼（如"张三，您好"）仅为短信接收人，不作为案件当事人
• 公司名称：xx有限责任公司、xx有限公司、xx股份有限公司
• 诉讼对峙：A与B、A诉B、原告A 被告B
• 角色前缀：原告：xxx、被告：xxx 等
• 下载文书后，以起诉状、传票中的当事人信息为准，覆盖短信阶段的初步判断

d) 下载链接提取：识别短信中的送达平台链接并提取参数

e) 发送时间提取（P0）：从送达平台 API 响应中提取发送时间，用于后续上诉期限计算

• 优先来源：zxfw API 响应中的 dt_cjsj 字段（送达记录创建时间，ISO 8601 格式）
• 短信网关时间：部分手机短信会显示发送时间，匹配 发送：YYYY-MM-DD HH:mm 格式
• 如果无法提取送达时间，展示"送达时间待确认"，不阻塞后续流程
• 记录到归档 JSON 的 document.sent_at 字段

排除列表：法院名称、法官姓名、地名、法律术语等不应作为当事人提取。详见 sms-patterns.json → partyextraction.excludekeywords。

输出格式（向用户展示）：

📋 短信解析结果：
- 类型：文书送达
- 案号：（2025）苏0981民初1234号
- 当事人：张三、xx有限公司
- 下载链接：已提取（zxfw.court.gov.cn）

第二步：确定归档目录

1. 扫描当前工作目录：识别目录结构，找到与短信案号或当事人匹配的案件目录
2. 查找归档子目录：在匹配到的案件目录下，查找法院文书相关的子目录（如 08*、法院送达、court 等）
3. 如未找到匹配案件，自动在当前工作目录（项目根目录）下新建 {案号} {当事人与案由}/，不询问用户

第三步：文书下载

平台判断：根据第一步识别的链接域名，选择下载策略。

- zxfw.court.gov.cn → 方案一（API 直连）→ 方案二 → 方案三

- sd.gdems.com 或 jysd.10102368.com → 跳过方案一，直接方案二 → 方案三

- dzsd.hbfy.gov.cn → 湖北专属流程（见下方）

- sfpt.cdfy12368.gov.cn（含广西实例 171.106.48.55:28083）→ SFDW 专属流程（见下方）

- 未知域名但 URL 路径匹配已知平台特征 → 按路径识别平台（同构异域名支持）

- 完全无法识别 → 提示用户提供链接信息

⛔ 降级铁律：严格串行，禁止并行。当前方案成功即停止，绝不降级。禁止"双保险"并行尝试多个方案。

依赖

Playwright 安装指引（仅方案二/三需要）：

# 方案二: Playwright CLI
npm install -g playwright
npx playwright install chromium

# 方案三: Playwright MCP（需在 Claude Code 设置中配置）
# 在 settings.json 的 mcpServers 中添加：
# "playwright": { "command": "npx", "args": ["@anthropic-ai/mcp-playwright"] }

⛔ 大多数情况下不需要 Playwright：zxfw 平台方案一直接 curl 调用 API，无需浏览器。仅 gdems/jysd 平台或方案一失败后才需要方案二/三。禁止在方案一执行期间同时打开浏览器。

方案一 — API 直连（优先）

完全无头，无需浏览器。直接调用 zxfw 后端 API 获取文书下载链接，再用 curl 下载 PDF。

API 信息：

• 端点：POST https://zxfw.court.gov.cn/yzw/yzw-zxfw-sdfw/api/v1/sdfw/getWsListBySdbhNew
• Content-Type：application/json
• 请求体：{ "qdbh": "xxx", "sdbh": "xxx", "sdsin": "xxx" }（从短信 URL 提取）
• 响应字段：data[].cwsmc（文书名称）、data[].wjlj（OSS 签名下载链接）、data[].cfymc（法院名称）
• 无需认证、无需浏览器

# 1. 从短信 URL 提取参数（示例）
qdbh="DEMO_qdbh_value"
sdbh="DEMO_sdbh_value"
sdsin="DEMO_sdsin_value"

# 2. 调用 API 获取文书列表
mkdir -p /tmp/court-sms-staging/
resp=$(curl -s -X POST "https://zxfw.court.gov.cn/yzw/yzw-zxfw-sdfw/api/v1/sdfw/getWsListBySdbhNew" \
  -H "Content-Type: application/json" \
  -d "{\"qdbh\":\"$qdbh\",\"sdbh\":\"$sdbh\",\"sdsin\":\"$sdsin\"}")

# 3. 解析文书列表，逐个下载 PDF
echo "$resp" | jq -r '.data[] | "\(.c_wsmc)\t\(.wjlj)"' | while IFS=$'\t' read -r name url; do
  curl -sL -o "/tmp/court-sms-staging/${name}.pdf" "$url"
done

# 4. 验证下载结果
ls -lh /tmp/court-sms-staging/*.pdf

方案二 — 无头浏览器（Playwright CLI）

当方案一 API 不可用或链接过期时，用 Playwright CLI 无头模式打开页面，拦截网络请求获取下载链接。

# 需要先安装 playwright
npx playwright install chromium 2>/dev/null

# 无头模式运行（脚本需自行编写，拦截 getWsListBySdbhNew API 响应）
node scripts/download_court_docs.mjs --url "{短信链接}" --output /tmp/court-sms-staging/

方案三 — 交互式浏览器（Playwright MCP）

当方案二不可用时（需要已配置 Playwright MCP）：

1. browser_navigate → 打开短信中的 zxfw URL
2. 等待页面加载
3. browser_evaluate → 直接调用 fetch API 获取文书列表
4. browser_run_code → 下载 PDF 文件到 /tmp/court-sms-staging/

如 API 调用未成功，改用页面交互：

1. browser_snapshot → 查看当前页面结构
2. 找到文书列表或 PDF 预览区域
3. 定位下载按钮（可能在 iframe 内）
4. browser_click → 点击下载
5. 等待下载完成，保存到临时目录

湖北平台下载流程（dzsd.hbfy.gov.cn）

湖北电子送达平台有两种链路，根据 URL 格式自动选择：

链路一：免账号模式（URL 含 /hb/msg=xxx）