---
name: court-sms
homepage: https://github.com/cat-xierluo/legal-skills
author: 杨卫薪律师（微信ywxlaw）
version: "1.6.2"
license: MIT
description: 本技能应在用户收到法院短信（文书送达、立案通知、开庭提醒等）时使用，解析链接、处理手机号或证件后四位核验、下载文书并归档。先尝试API直连，成功不读取或询问手机号；确需核验才使用本机私有配置，核验拒绝后询问实际接收手机号后四位并接续。会落盘敏感诉讼数据，请使用私密位置。
---

# 法院短信识别与文书下载

## 隐私、所需权限与安全说明（透明告知，不阻挡执行）

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

- 下载的文书与归档记录会**落到本地文件系统**（案件目录 + skill 内部 `archive/`）。案件目录位置由 `config/workspace.json` 的 `case_root` 决定（未配置时用当前工作目录），请把它指向仅你本人可访问的私密路径，且勿提交到公开仓库或同步到第三方服务。
- 处理 zxfw 链接会向短信中对应的法院送达平台发起 HTTPS 请求，并把返回文书下载到本机暂存目录；本 Skill 不向其他第三方发送案件数据。
- zxfw 的签收确认会向法院写入查收记录。仅在用户已明确授权签收时使用 `--confirm-receipt`；一般下载请求先取列表，若页面要求签收再针对该操作取得授权。已有授权直接复用。
- 默认先进行只读API探测，成功时不读取或询问手机号。确需核验才读取本机律师配置 `config/lawyers.json`（0600，已被 `.gitignore` 排除）；缺资料时询问保存，以后复用。客户短信所需后四位默认只用于本次核验，不覆盖律师配置；用户明确要求才长期保存。发往法院的仅是后四位，不收集完整身份证号。
- 核验凭据应匹配该条链接在法院的登记，短信称呼不能单独证明绑定的是客户还是律师号码。API明确要求核验后，客户短信缺凭据或本机号码被拒绝时，按 [身份核验与失败问答](references/lawyer-identity.md) 询问实际接收手机号后四位。
- 涉及登录凭证（账号、密码、验证码）的步骤，在你粘贴含相关信息的短信后默认自动代入，以实现无感下载。
- 新建案件目录、写入内部归档记录均按流程自动执行，无需逐步确认。

## 功能概述

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

支持两种触发方式：

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

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

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

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

```text
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}[）)〕]]` 匹配标准案号格式

标准案号格式示例：
- `（YYYY）苏XXXX民初XXXX号`
- `(YYYY)粤XXXX执保XXXX号`
- `〔YYYY〕京XXXX民初XXXX号`

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

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

| 平台 | 域名 | 下载方式 | 提取参数 |
|------|------|----------|----------|
| 全国法院统一送达平台 | `zxfw.court.gov.cn` | API匿名探测优先；确需核验才读配置/问答，已授权才签收并正式取列表下载 | qdbh, sdbh, sdsin；可选 mm |
| 广东法院电子送达 | `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`。

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

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

### 第二步：确定归档目录

**0. 先读归档根目录配置** `config/workspace.json` 的 `case_root`，按下列优先级确定「归档基准目录」，不要一上来就扫当前工作区：

| 优先级 | 条件 | 归档基准 | 说明 |
| --- | --- | --- | --- |
| 1 | 当前工作目录本身就是一个案件目录（目录名含案号，或目录内有 `案件信息.md` / `case.yaml`） | 当前工作目录 | 保留「一案一工作区」习惯，就地归档 |
| 2 | `case_root` 非空 | `case_root` | 在根目录下按 `search_depth`（默认 3 层）**递归**查找命中的案件目录 |
| 3 | `case_root` 为 `null` 或配置文件不存在 | 当前工作目录 | 旧行为，向后兼容 |

命中 `case_root` 模式时，**只在该根目录树内匹配与新建，不得把文书落进当前工作区**。必须递归匹配，否则「案件目录已存在于根目录的子文件夹里」会被漏掉，从而在根目录重建一份重复目录——这是最容易出的错。

1. **在基准目录内匹配案件目录**：案号优先（兼容全角 `（）`／半角 `()`／`〔〕`），其次当事人组合；命中多个同案号目录时取最近修改者，并在归档报告中说明
2. **查找归档子目录**：在匹配到的案件目录下，查找法院文书相关的子目录（如 `08*`、`法院送达`、`court` 等）
3. 如未找到匹配案件，**自动在基准目录下按 `new_case_dir_template` 新建** `{案号} {当事人与案由}/`，不询问用户

#### 2.1 上下文核验（避免遗漏跨法院/多程序并行的关键事实）

命中已有案件目录后，**先读该案件目录根下的 `案件信息.md`**（或对应叙事文档）和 `case.yaml` 的程序历程，再继续第四步。这一步专门应对以下情形——错过任何一项都会产出错误归档：

- **跨法院并行**：同一对当事人、同一标的，已有 A 法院案号在办，新送达来自 B 法院且案号不同——必须用 B 法院案号归到现有项目目录，并标注二者关系；不得默默写入 A 法院案号路径导致日后翻案底找不到对应文书。
- **重复立案/管辖回流**：该项目历史上曾被某法院退回"不属于本院管辖"，现在同一法院又出现新案号——属异常事件，必须在报告里点出，由用户决定是否走管辖异议或撤诉协调。
- **当事人同名陷阱**：两个独立项目共享相同原告/被告姓名，目录短码不同——核 `case.yaml` 的律所案号/法院案号双重校验，避免把新文书归档到错误的同名项目。

读取到的关键背景写进 `archive.archive.context_notes`，归档报告里也单独列「与现有项目的关系」一节，避免用户只看短信原文时漏掉案号冲突。

### 第三步：文书下载

zxfw 先按 [API优先与按需核验](references/lawyer-identity.md) 执行：

1. **先直接运行下载器**：只提供原始链接和暂存目录；不要先读手机号配置、运行配置列表、询问手机号或用 `--identity-only` 探路。上下文已匹配的 `--lawyer-id` 可沿用，但配置只在确需核验时读取。
2. **API可读就下载**：匿名列表成功时不查询网页核验开关、不提交后四位。默认不签收；已有签收授权时，匿名探测后发送一次签收，再正式取列表下载。
3. **确需核验才补资料**：只有下载API明确要求身份核验，才查询核验开关并读取匹配的本机配置。配置已有就复用；缺失时才问询保存。已知登记客户手机号且无凭据时，只询问实际接收手机号后四位。网页开关为true本身不代表API不可读；网络、空列表或普通业务错误不触发收集手机号。
4. **拒绝后必须问答**：`identity.next_action=ask_recipient_mobile_last4` 时停止后续请求，询问「请提供该短信实际接收手机号的后四位（4位数字）」并等待真实回答。使用可用的自由文本问答工具；工具不适用时普通提问并等待。
5. **回答后接续**：核验拒绝后用 `--identity-stdin` 传入答案，带 `--retry-identity-from "{该清单路径}"` 先核验再接续；仅缺配置且尚未提交凭据时可改带已匹配的 `--lawyer-id`。均不重新匿名试探，沿用原签收授权和清单状态；此前已发签收（包括未知回执）不重发。客户输入不覆盖本机手机号，两次核验用尽后停止。

> **平台判断**：根据第一步识别的链接域名，选择下载策略。
> - `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 路径匹配已知平台特征 → 按路径识别平台类别；zxfw 下载器调用固定官方后端，不能仅凭路径认定任意别名实例与其数据互通
> - 完全无法识别 → 提示用户提供链接信息
>
> **⛔ 降级铁律**：严格串行，禁止并行。当前方案成功即停止，绝不降级。禁止"双保险"并行尝试多个方案。

#### 依赖

| 依赖 | 用途 | 适用方案 | 安装方式 |
|------|------|----------|----------|
| Python 3.8+ | zxfw 下载与送达证据检查（标准库，无需 pip） | 方案一及期限核对前 | 使用已有 `python3` |
| `curl` | 其他平台 API 与诊断 | 多平台 | macOS/Linux 预装 |
| `jq` | JSON 解析（可选） | 其他平台手工诊断 | `brew install jq` |
| Playwright 或宿主已有浏览器工具 | 页面、网络监听和下载 | 方案二/三 | 优先复用当前环境已配置的能力 |

**浏览器依赖**：API 失败后先发现宿主实际提供的浏览器/MCP/CLI 能力；缺少时说明具体缺口，按用户环境已有授权处理安装，不假定某个固定 MCP 名称或全局安装已存在。

> **zxfw 先走 API**：瞬态失败按下述策略重试；非 JSON、参数/业务错误、空列表等按实际原因处理，必要时再串行进入浏览器。不要在 API 下载尚未结束时同时打开同一送达页面。

#### 方案一 — API 直连（优先）

使用 [标准库下载器](scripts/download_zxfw.py)，从 SPA fragment query 中提取参数，先只读探测列表；可读时直接进入下载，确需核验时才在同一HTTP会话中读取配置并提交后四位，再处理已授权签收与下载。每次在 `--output` 下创建独立私密目录，结果的 `manifest_path` 指向本次清单。

**当前上游流程**（2026-11-04 核对，固定来源见 [归属声明](references/ATTRIBUTION.md)）：

- 同一基址 `https://zxfw.court.gov.cn/yzw/yzw-zxfw-sdfw/api/v1/sdfw/` 下，上游先调用 `updateSdxxBySdzt` 签收，再调用 `getWsListBySdbhNew` 取列表；两个接口仍用 `POST application/json` 及 `{qdbh,sdbh,sdsin}`。这不是列表接口改名。
- 官网已新增 `getSfhyKg` 开关与 `checkSdryxx` 后四位核验，法穿当前下载器尚未包含这段。核验请求保留链接可选 `mm`，加 `jylx=sjhm/zjhm`、`jyz=后四位`；**本下载器先尝试匿名列表，只有API明确要求身份核验才进入核验流程**。进入核验后，开关未知、资料缺失或核验拒绝时停止后续请求，不再匿名试探。完整字段、配置录入与浏览器操作见上述参考。
- API先进行无签收副作用的匿名列表探测。已有签收授权时，仍在正式列表/下载前发送一次签收；需要核验则先核验。未授权默认省略签收；官网页面在核验并取得列表后自动签收，未授权时不能用网页兜底。接口回执不自动确定法律送达日。
- 每次运行只提交一个凭据；号码明确被拒绝即交回用户问答，不自动换人或换证件方式。失败清单续跑累计最多2次核验，同一失败记录及其副本只能接续一次；网络或未知响应不当作号码错误。
- API确需核验后，用户指定或当前业务已确认由本机律师接收时可复用其号码；短信称呼为客户也可能登记代理律师手机号，不能仅凭称呼排除。已知登记客户号码时才询问客户后四位。
- 本下载器只在显式 `--confirm-receipt` 时写入签收；匿名探测本身不签收。签收只发送一次，响应丢失或无法解析记 `receipt.status=unknown`，明确非200业务码记 `unconfirmed`，均不自动重发，继续尝试取列表。业务成功记 `receipt.status=confirmed`，也不能直接填入法律送达日期或起算期限。
- 列表仍返回 `c_wsmc`（名称）、`wjlj`（签名下载地址）、`c_fymc`（法院名称）等；不要求 `dt_cjsj`。上游报告新生成送达首次列表请求可能超过30秒：默认网络超时30秒，最多尝试3次，间隔3秒/8秒。超时是网络操作的超时设置，不是整次任务的硬性时限。
- 网络/超时、HTTP 408/425/429/5xx 可重试；JSON 中 `code != 200` 或非 JSON 响应不机械重试。不据业务错误单独认定链接永久失效。
- 获取 `wjlj` 后立即下载，不假定固定有效期。签名地址403等失败时保留成功文件，先刷新列表获取该文书的新地址，仍失败再进入浏览器，避免整批重复下载。
- 下载器拒绝空文件、HTML错误页、已支持格式头不符及已知长度不符的响应，中断片段会清理。支持PDF、ZIP/OOXML/OFD、旧Office与常见图片的基础格式检查；JSON文书无法与通用错误响应可靠区分，记 `unverified_json_document`，未知格式记 `unsupported_file_format`，均交浏览器或人工核验。基础检查不替代后续打开文书、页数及完整性核验。

```bash
# 默认只取列表并下载，不写签收记录
python3 scripts/download_zxfw.py \
  --url "{短信中的 zxfw 链接}" \
  --output /tmp/court-sms-staging/

# 用户已经明确授权签收时，在同一命令中加 --confirm-receipt
```

读取输出：`identity.status=not_requested` 且 `direct_api.status=accessible` 表示API可读、未使用手机号；`needs_config` 时先匹配已有本机资料，缺失才按本人/客户场景补资料；`identity.next_action=ask_recipient_mobile_last4` 时必须问答并等待；`check_delivery_registration` 时停止重试，其他 `unknown` 检查服务状态；`downloaded` 才表示全部文件通过基础检查，`partial` 仅补失败项，`empty/error` 不算成功。`identity`、`receipt` 与下载状态分别处理；`manifest_path` 不固定在暂存根目录。身份核验、签收响应或下载成功均不自动确定法律送达日期。

#### 方案二 — 浏览器网络监听

列表瞬态失败耗尽（`reason=list_attempts_exhausted`）、非JSON或空列表时，先确认浏览器页面/会话实际可用，再**在导航前**注册 `getWsListBySdbhNew` 响应监听，打开原始链接并读取当前页面。只有 JSON `code=200` 且列表非空才提取文书。本 Skill 未附带通用浏览器下载脚本；使用已发现的实际工具，缺少时记录具体缺口。

浏览器打开送达页可能触发同一签收写入；进入会自动签收的页面或操作前沿用签收授权边界。遇到新路由、身份验证或验证码时按真实页面处理，保留经脱敏的端点/错误信息；不要猜测新的参数，也不要只因一次慢响应判断“法院改版后不可下载”。

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

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

```text
1. 查看真实页面和文书列表，必要时进入 iframe
2. 逐份触发下载，等待实际下载事件完成并保存文件
3. 核对文件数、非空及格式；只补 API 阶段失败的文书
```

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

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

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

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

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

1. 从 URL 提取 `msg` 参数值
2. 尝试 HTTP API 直连：

```bash
msg="从URL提取的msg值"
mkdir -p /tmp/court-sms-staging/

# 查询文书信息
resp=$(curl -s -X POST "http://dzsd.hbfy.gov.cn/delimobile/tDeliSms/findSmsInfo?t=$(date +%s%3N)" \
  -H "Content-Type: application/json" \
  -H "Referer: http://dzsd.hbfy.gov.cn/deli-mobile-ui/" \
  -d "{\"msg\":\"$msg\"}")

# 检查是否需要验证码（data.isNeedCaptcha == "Y"）
# 如需验证码或无可下载文书，降级到 Playwright MCP

# 逐个下载文书
echo "$resp" | jq -r '.data.docList[] | "\(.docName)\t\(.downloadPath)"' | while IFS=$'\t' read -r name path; do
  if [ -n "$path" ]; then
    curl -sL -o "/tmp/court-sms-staging/${name}.pdf" "http://dzsd.hbfy.gov.cn/delimobile${path}"
  fi
done
```

3. 如需验证码或 HTTP 失败，降级到 Playwright MCP（方案三）

**链路二：账号模式**（URL 含 `/sfsddz`）

1. 从短信正文提取凭证：
   - 账号：匹配 `账号\s*(\d{15,20})`
   - 默认密码：匹配 `默认密码[：:]\s*([0-9A-Za-z]+)`
2. 需要浏览器自动化（Playwright MCP），登录页包含验证码
3. 登录后遍历待签收/已签收/已过期文书列表，逐个下载

> **提示**：湖北平台两种模式都可能遇到验证码。免账号模式优先尝试 HTTP API，账号模式建议引导用户手动打开链接或使用 Playwright MCP。

#### 司法送达网下载流程（SFDW - `sfpt.cdfy12368.gov.cn`）

司法送达网所有 POST 请求使用 TDHCryptoUtil 加密，无法通过 HTTP API 下载，只能使用纯 Playwright 流程。

**广西实例**：`171.106.48.55:28083` 域名下的链接路由到同一 SFDW 平台，下载流程相同。

**验证码获取**（两种方式，按优先级尝试）：

1. **手机尾号后6位**（优先）：从案件分配信息中获取律师手机号，取后6位作为验证码输入
2. **短信验证码**：从短信正文中提取，匹配 `验证码[：:]\s*(\w{4,6})`

**Playwright MCP 流程**：

```text
1. browser_navigate → 打开短信中的 SFDW 链接
2. 等待页面自动重定向到 pc.html?tdhParams=xxx
3. browser_snapshot → 查看验证码输入页面（input#checkCode）
4. 输入验证码（优先手机尾号后6位，其次短信验证码）
5. browser_evaluate → 调用 Vue app.checkYzm() 触发验证
6. 验证通过后 browser_evaluate → 获取 app.$data.wsList（文书列表）
7. 遍历 wsList，逐个调用 downloadFile(app, ws) 下载文书
8. 保存到 /tmp/court-sms-staging/
```

> **提示**：如手机尾号验证失败，提示用户查看短信中的验证码并手动输入。wsList 每项包含 wjmc（文件名）、wjgs（格式）。

#### 失败兜底

当三级均失败时：

仅在手动访问符合用户当前授权时给出下面的兜底；若已知打开链接会自动签收，而用户要求暂不签收，不打开、不引导其打开，保留待处理状态，等待已下载文件或不触发签收的合法获取方式。

```text
⚠️ 自动下载失败，请手动访问以下链接下载：
{原始链接}

下载后请将文件放到对应案件目录中。

我将为您创建待处理记录。
```

### 第四步：归档保存

1. **确定目标目录**：直接沿用第二步得出的「归档基准目录 + 案件目录」，不再按当前工作区重新判断，不询问用户
   - 基准目录按第二步的三级优先级确定（案件工作区 > `config/workspace.json` 的 `case_root` > 当前工作区）
   - 如找到匹配案件目录，优先查找法院文书子目录（如 `08*`、`法院送达`、`court` 等）；如无子目录则直接归档到案件根目录
   - **如未找到匹配案件，自动在基准目录下新建**：`{案号} {当事人与案由}/`
   - 如目标目录不存在，自动创建
   - **纯链接输入时案号未知**：先只落暂存目录并完成文书解析，从文书或短信中取得案号与当事人后再建案件目录；不要用「未知案号」建目录，也不要先把文书丢进当前工作区
2. **获取当前日期**：`date "+%Y%m%d"`
3. **确定文书标题**：
   - 优先使用 API 返回的标题
   - 否则根据 `sms-patterns.json` 中的 `document_titles` 映射推断
   - 最后回退到原始文件名（去除扩展名），如仍无法确定则使用 `未知文书`
4. **构建文件名**：`{title}（{case_name}）_{YYYYMMDD}收.pdf`
   - 示例：`受理通知书（张三与李四合同纠纷）_20260404收.pdf`
   - 清理非法字符：`< > : " | ? * \ /`
   - 如同名文件已存在，追加 `_2` 后缀
   - **跨法院/多程序场景**：短信案号与项目目录短码不一致时，文书名以短信案号为准（`{短信案号} {title}-{接收人}_{YYYYMMDD}收.pdf`），不使用项目旧案号，避免后续翻案底时找不到对应文书。
5. **移入目标目录**
   - **不要顺手改 `案件信息.md`、`case.yaml`、时间线等叙事/任务文件**——遇到跨法院、案号冲突、管辖异常等需要人工判断的事项，归档仅落 PDF，叙事更新由用户确认后再单独处理。
6. **写入内部记录**：保存本次处理的完整信息到 **本 Skill 目录下的 `archive/`**，不是案件文件夹。路径按实际安装位置解析（Codex 为 `~/.codex/skills/court-sms/archive/` 或插件缓存目录，Claude Code 为 `~/.claude/skills/court-sms/archive/`），以当前 Skill 目录为准，不要写死某一家客户端的路径。格式详见 [`references/archive-format.md`](references/archive-format.md)

   > 目录不可写时（如只读安装或权限受限），先向用户说明该缺口并给出可写的替代位置征得同意，不要静默跳过归档记录，也不要退回到把记录写进案件文件夹。

   > **透明告知**：`archive/` 会留存短信原文（`sms_raw`）、案号、当事人、法院编号、下载参数与 API 响应等敏感诉讼信息。该目录默认不纳入版本库（已加入 `.gitignore`），请勿将其同步到公开仓库、第三方网盘或共享目录。
7. **基础文书解析**：法院 PDF 通常带文字层，提取首页文本，快速识别文书类型和关键信息
   - **传票**：提取开庭时间、地点、法庭、案号，向用户高亮提醒
   - **通知书/告知书**：提取缴费期限、举证期限等关键日期
   - **起诉状/答辩状**：提取案由、当事人、诉讼请求概要
   - **判决书/裁定书**：读取正文及末尾救济告知，核对审级、程序和可上诉性；不能仅凭标题认定一审或可上诉
   - **其他文书**：展示文书标题和法院名称
   - 如一次下载多份文书，逐一解析，汇总为一份报告

   > 深度分析（如判决书解读、合同审查）不在此技能范围内，请使用专用分析技能处理。

8. **上诉期限核对（P1）**：按 [送达与期限规则](references/service-and-deadlines.md) 执行，不按标题直接计算
   - 先通过送达证据检查，再阅读该份文书的救济告知，核对适用期间、当事人及例外。普通民事15/10日等仅是候选规则；保全、终审、小额诉讼、境内无住所等须分别判断。
   - 核对当年官方放假调休日历及适用程序法；按日通常不计起算当日，期间内节假日照计，仅末日按规则顺延，调休上班日不按普通周末处理。
   - 送达、可上诉性、期间规则或日历任一未确认，`deadline_status=pending`，`appeal_deadline=null`、`appeal_days_remaining=null`，报告明确待核验项。确认无该项上诉权时用 `not_applicable`。
   - 只有全部核对完成才记录 `deadline_status=confirmed`，附 `deadline_basis` 和对应 `service` 证据。多文书、多受送达人分别计算；历史 `sent_at` 不能直接迁移为已确认送达日期。
   - 缴费、举证等期限单独读取原通知的起算事件与义务，禁止复用上诉期限表。

9. **向用户汇报**：按 [`references/report-format.md`](references/report-format.md) 输出结构化报告
   - 先确认归档完成（案号、法院、当事人、案由、文件数、位置）
   - 列出所有已归档的文书清单
   - 如含传票，⚠️ 高亮提醒开庭时间、地点、审理程序
   - 如含判决书/裁定书，⏰ 展示已核实期限或待核验原因，不省略未知状态
   - 如部分失败，列出失败文书和原始链接

### 第五步：PDF 后处理（可选）

> **不默认启用**。仅在检测到文件拆分时主动提示用户。

归档完成后，扫描目标目录中的 PDF 文件，检测是否有同一文书被拆分为多个文件的情况。

#### 读取用户偏好

读取 `config/user-preferences.json` 获取用户的合并和重命名偏好。如文件不存在，使用默认值（参考 `config/user-preferences.example.json`）。

关键偏好项：

| 偏好 | 默认值 | 说明 |
|------|--------|------|
| `merge_strategy` | `per_evidence` | 合并策略：`per_evidence`（按编号分别合并）或 `unified`（统一合并） |
| `merge_options.unified.bookmarks.enabled` | `true` | 统一合并时是否添加 PDF 书签 |
| `rename.enabled` | `true` | 是否精简文件名 |

#### 触发检测

读取 `references/sms-patterns.json` → `post_processing.trigger` 配置，按以下规则分组：

```text
分组规则：
1. 证据类：文件名以"证据"开头 → 按编号分组（证据1、证据2、证据3…）
2. 其他文书：按文书类型分组（传票、起诉状、应诉通知书…）
3. 如任一组内文件数 > 3（threshold），触发提示
```

**示例**：证据3 下有 10 个 PDF → 触发。

#### 用户确认

使用 AskUserQuestion 提示用户，列出检测到的拆分情况：

```text
检测到以下文书被拆分为多个 PDF：
- 证据3：10 个文件
- 证据5：4 个文件

是否执行 PDF 后处理（合并 + 重命名）？
  → 是，合并所有
  → 让我选择（逐个确认）
  → 跳过
```

#### 执行后处理

用户确认后，根据 `user-preferences.json` 中的 `merge_strategy` 执行：

**策略一：per_evidence（默认）**

按单个证据编号分别合并，每个证据独立保留：

```text
- 证据3 有 10 个拆分文件 → 合并为「证据3：打印截图.pdf」
- 证据5 有 4 个拆分文件 → 合并为「证据5：电脑截图.pdf」
- 未被拆分的证据（如证据1 只有 1 个文件）保持不动
```

**策略二：unified**

将证据目录 + 所有证据合并为一个「原告证据.pdf」，并添加 PDF 书签：

```text
合并顺序：证据目录 → 证据1 → 证据2 → … → 证据N
书签格式：
  📑 证据目录
  📑 证据1：仲裁申请书、不予受理通知书
  📑 证据2：劳动合同、保密协议
  📑 证据3：被告工资表
  📑 证据4：泄露账号密码的电脑截图
  📑 证据5：打印及拷贝资料的电脑截图
  📑 证据6：删除电脑操作痕迹的截图
```

书签名称使用简洁版：证据编号 + 冒号 + 证据标题（去除当事人和日期后缀）。使用 pypdf 的 `add_outline_item` 添加书签。

> 用户可随时修改 `user-preferences.json` 切换策略，无需改动 skill 本身。

#### 页面尺寸标准化

合并过程中同时标准化页面尺寸为 A4（210×297mm）。使用 pypdf 逐页处理：

```python
from pypdf import PdfReader, PdfWriter, Transformation

A4_W = 595.27  # 210mm in points
A4_H = 841.89  # 297mm in points

for page in reader.pages:
    pw, ph = float(page.mediabox.width), float(page.mediabox.height)
    is_landscape = pw > ph

    # 保持原始方向：纵向→A4纵向，横向→A4横向
    target_w = A4_H if is_landscape else A4_W
    target_h = A4_W if is_landscape else A4_H

    # 等比缩放并居中
    scale = min(target_w / pw, target_h / ph)
    offset_x = (target_w - pw * scale) / 2
    offset_y = (target_h - ph * scale) / 2

    new_page = writer.add_blank_page(width=target_w, height=target_h)
    page.add_transformation(Transformation().scale(scale).translate(offset_x, offset_y))
    new_page.merge_page(page)
```

**规则**：
- 纵向页面 → A4 纵向（210×297mm）
- 横向页面 → A4 横向（297×210mm），不强制旋转为纵向
- 等比缩放、居中放置，不裁剪、不拉伸

#### 精简文件名

根据 `user-preferences.json` → `rename` 配置对所有文件统一重命名：

```text
去除规则（strip_patterns）：
- 去掉括号内的当事人信息：（张三与李四合同纠纷）
- 去掉日期后缀：_20260405收
- 去掉平台标记：（合并）、（自贸法庭）、（素）-

特殊映射（special_mappings）：
- 起诉状（素）… → 起诉状（要素式）.pdf
- 开庭传票 → 传票.pdf
```

**重命名示例**：

| 原始 | 重命名后 |
|------|----------|
| `传票（张三与李四合同纠纷）_20260405收.pdf` | `传票.pdf` |
| `起诉状（合并）.pdf` | `起诉状.pdf` |
| `起诉状（素）-要素式起诉状（合并）.pdf` | `起诉状（要素式）.pdf` |
| `应诉通知书（自贸法庭）.pdf` | `应诉通知书.pdf` |
| `E法桥平台使用告知书（xxx）_20260405收.pdf` | `E法桥平台使用告知书.pdf` |

---

## 内部归档格式

每次处理完成后在 `archive/` 下创建 JSON 记录，格式详见 [`references/archive-format.md`](references/archive-format.md)。

---

## 常见法院短信格式参考

### 文书送达短信

```text
【xx市人民法院】张三，您好！您有（YYYY）苏XXXX民初XXXX号案件文书送达，
请点击链接查收：
https://zxfw.court.gov.cn/zxfw/#/pagesAjkj/app/wssd/index?qdbh=DEMO1&sdbh=DEMO2&sdsin=DEMO3
如非本人操作请联系法院。
```

### 立案通知短信

```text
【xx市xx区人民法院】您好，您提交的立案材料已审核通过。
案号：（YYYY）京XXXX民初XXXX号
请及时缴纳诉讼费用。
```

### 开庭提醒短信

```text
【xx市xx区人民法院】提醒：您有（YYYY）苏XXXX民初XXXX号案件，
定于2025年3月15日上午9:30在第3法庭开庭，请准时到庭。
```

### 湖北电子送达短信（免账号）

```text
【xx人民法院】您有案件文书待查收，请点击链接查收：
http://dzsd.hbfy.gov.cn/hb/msg=XXXXXXX
如有疑问请联系法院。
```

### 湖北电子送达短信（账号模式）

```text
【xx人民法院】您有（2025）鄂xxxx民初xxxx号案件文书送达。
账号 420xxxxxxxxxxxxx
默认密码：xxxxxx
请登录 http://dzsd.hbfy.gov.cn/sfsddz 查收。
```

### 司法送达网短信

```text
【xx人民法院】您有（2025）川xxxx民初xxxx号案件文书送达。
验证码：A1B2C3
请点击链接查收：https://sfpt.cdfy12368.gov.cn/sfsdw//r/xxxxxxxxxxxx
```

---

## 故障排除

| 问题 | 解决方案 |
| --- | --- |
| 短信无法识别类型 | 展示原文，请用户确认类型后继续 |
| 案号提取失败 | 手动输入案号 |
| 当事人识别不准 | 提示用户确认/修正当事人列表 |
| 无匹配案件 | 提供三个选项：选已有/新建/暂存 |
| Playwright 下载超时 | 检查网络连接，尝试刷新页面重试 |
| 页面需要验证码 | 通知用户，暂停等待手动处理 |
| 下载文件损坏 | 清理临时目录，重新尝试下载 |
| 目标目录不存在 | 自动创建对应目录 |
| SFDW 验证码验证失败 | 尝试手机尾号后6位和短信验证码两种方式，均失败时提示用户联系法院 |

---

## 配置

配置改完即在下次执行生效：

首次使用可把 `config/workspace.example.json` 复制为 `config/workspace.json`；不创建该文件时按当前工作目录回退。

| 文件 | 管什么 | 关键字段 |
| --- | --- | --- |
| `config/workspace.json` | **文书归档到哪里** | `case_root`（归档根目录，`null`=用当前工作目录）、`search_depth`（递归匹配层数，默认 3）、`new_case_dir_template`（新案件目录命名） |
| `config/lawyers.json` | **本机律师的私有手机号配置** | `lawyers.{lawyer_id}.name/mobile`；按需 `id_last4`，明确要求长期保存的后四位用 `mobile_last4`。仅API确需核验才读取，首次缺资料时询问保存、以后复用；真实配置/锁/临时文件被 `.gitignore` 排除，详见 [身份核验](references/lawyer-identity.md) |
| `config/user-preferences.json` | PDF 后处理的合并与重命名 | `merge_strategy`、`rename` |
| `references/sms-patterns.json` | 短信解析规则 | 平台域名、案号正则、文书标题映射 |

**换归档根目录**：只改 `config/workspace.json` 的 `case_root` 这一行，例如

```json
{ "case_root": "<your-private-case-root>", "search_depth": 3, "new_case_dir_template": "{案号} {当事人与案由}" }
```

改完无需重启，下次处理短信即在新区匹配或新建案件目录。若只想让某个案件单独就地归档，把该案件目录直接作为工作区触发即可（第二步优先级 1 会优先认工作区）。

如需修改解析规则（添加新文书标题、调整正则等），编辑 `references/sms-patterns.json` 即可。

---

## 🔄 变更历史

完整变更日志见 [CHANGELOG.md](CHANGELOG.md)。归属声明见 [references/ATTRIBUTION.md](references/ATTRIBUTION.md)。
