/court-sms

name: court-sms
homepage: https://github.com/cat-xierluo/legal-skills
author: 杨卫薪律师（微信ywxlaw）
version: "1.5.3"
license: MIT
description: 本技能应在用户收到法院短信（文书送达、立案通知、开庭提醒等）时使用，自动提取案号、当事人、下载链接，下载文书并归档到对应案件目录。会落盘敏感诉讼数据到本地，请确认目标位置私密。

法院短信识别与文书下载

隐私与合规说明（透明告知，不阻挡执行）

本技能处理的是**法院诉讼文书与送达短信**，内容含案号、当事人、法院信息、送达时间等敏感诉讼数据，部分还可能涉及客户机密与个人隐私。使用即表示你授权本技能按以下方式处理：

• 下载的文书与归档记录会**落到本地文件系统**（案件目录 + skill 内部 `archive/`），请确认目标位置仅你本人可访问，且勿提交到公开仓库或同步到第三方服务。
• 涉及登录凭证（账号、密码、验证码）的步骤，在你粘贴含相关信息的短信后默认自动代入，以实现无感下载。
• 新建案件目录、写入内部归档记录均按流程自动执行，无需逐步确认。

功能概述

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

支持两种触发方式：

**方式一：粘贴短信原文**

收到法院短信，内容如下：
【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 提取参数，进入第三步下载。案号、当事人等信息在下载文书后从文书内容中提取。

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

**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) 下载链接提取**：识别短信中的送达平台链接并提取参数

| 平台 | 域名 | 下载方式 | 提取参数 | |------|------|----------|----------| | 全国法院统一送达平台 | `zxfw.court.gov.cn` | curl API 直连 | qdbh, sdbh, sdsin | | 广东法院电子送达 | `sd.gdems.com` | 浏览器自动化 | 路径中的送达标识码 | | 集约送达平台 | `jysd.10102368.com` | 浏览器自动化 | key | | 湖北电子送达 | `dzsd.hbfy.gov.cn` | HTTP API（免账号）/ 浏览器自动化（账号模式） | 免账号：msg；账号模式：账号+密码从正文提取 | | 司法送达网 | `sfpt.cdfy12368.gov.cn` | 纯 Playwright（无 API） | 验证码（手机尾号后6位 / 短信验证码） |

**e) 送达证据核对（P0）**：读取 [送达与期限规则](references/service-and-deadlines.md)，区分发送、收到、生成和法律上的送达。

• zxfw 的 `getWsListBySdbhNew` 在已测响应中不含 `dt_cjsj`，不得臆造该字段；即使其他接口有创建时间，也不能自动当送达时间。
• 按“文书 + 受送达人”核对适用基础、送达回证或系统发送成功/到达证据。二维码生成、文书落款、普通短信时间仅记为线索，不能借同批另一份文书的日期起算。
• 按参考格式整理证据，执行 `python3 scripts/check_service_evidence.py /private/path/service-evidence.json`；仅输出 `confirmed` 时进入期限规则核对。检查器只检查结构和一致性，不替代原始证据核验。
• 未知、冲突或检查失败时，`service.served_on=null`，展示“送达时间待确认”及缺口，继续下载与归档；不得输出确定期限或倒计时。

**f) 下载期避免 python heredoc**：优先写临时 `.py` 文件或改用 `execute_code`，避免 `python3 <<'PY'` 写法——它命中危险命令规则（pattern key `script execution via heredoc`），逐次触发审批弹窗。`python3 -c`（key `script execution via -e/-c flag`）同理。

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

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

📋 短信解析结果：
- 类型：文书送达
- 案号：（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 路径匹配已知平台特征 → 按路径识别平台（同构异域名支持） > - 完全无法识别 → 提示用户提供链接信息 > > **⛔ 降级铁律**：严格串行，禁止并行。当前方案成功即停止，绝不降级。禁止"双保险"并行尝试多个方案。

依赖

| 依赖 | 用途 | 适用方案 | 安装方式 | |------|------|----------|----------| | Python 3.8+ | 送达证据检查（标准库，无需 pip） | 期限核对前 | macOS/Linux 使用已有 `python3`；缺少时提示安装后重试期限核对 | | `curl` | API 下载 | 方案一 | macOS/Linux 预装 | | `jq` | JSON 解析（可选） | 方案一 | `brew install jq` | | Playwright | 浏览器自动化 | 方案二/三 | 见下方 |

**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[].c_wsmc`（文书名称）、`data[].wjlj`（OSS 签名下载链接）、`data[].c_fymc`（法院名称）
• 无需认证、无需浏览器

# 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/

方案三 — 交互