Document Desensitization

---
name: document-desensitization
description: 法保文件脱敏技能 - 对用户上传的文档，完成文件脱敏，生成脱敏版文档。在用户需要对文件进行脱敏、去除隐私信息、加密用户信息时使用。
version: "1.0.0"
author: "法保网"
---

# 法保文件脱敏 Skill

## 可用工具

### file_desensitization - 文件脱敏

对给定 doc/docx 的文件URL实现一键脱敏，对敏感信息标星处理，返回脱敏后的文件下载链接。覆盖数值、日期、个人信息、企业信息、规格、源代码、系统名称、品牌名称等100余项敏感信息。

**参数说明：**

| 参数名 | 类型 | 必填 | 描述 |
| --- | --- | :---: | --- |
| file_url | string | 是 | 公网可访问的待脱敏文件URL，支持 .docx / .doc  格式。若未提供需反问获取 |
| file_name | string | 否 | 脱敏文件的真实名称（含扩展名，如"工会经费电话设计费.docx"）。若从对话或上传流程中获知文件名请务必传入；未知时可省略 |

**返回字段：**

| 字段名 | 类型 | 描述 |
| --- | --- | --- |
| status_code | number | 状态码，200 成功，422 参数缺失，500 服务异常 |
| msg | string | 状态说明 |
| data | string | 脱敏后文档下载链接（成功，markdown格式）、空字符串（失败） |

### create_upload_ticket - 获取一次性上传凭证

当用户需要上传本地文件获取公网URL时调用（服务端代为鉴权，无需用户提供 API Key）。返回 upload_url（一次性上传URL，5分钟内有效）和 usage（本地执行命令）。

**返回字段：**

| 字段名 | 类型 | 描述 |
| --- | --- | --- |
| upload_url | string | 一次性上传URL（需附 filename 查询参数） |
| usage | string | 在用户本地执行的完整 curl 命令 |
| expires_in | number | 凭证有效期（秒） |

## 文件脱敏步骤

### 第一步：获取待脱敏的文件URL

需要待脱敏文件的**公网可访问URL**（支持 .docx / .doc  格式）：
- 用户直接提供文件链接时，使用该链接
- **用户发送文件附件或提供本地文件路径时**（若附件本身提供可访问URL，直接使用该URL），按以下流程获取公网URL。禁止把本地路径直接作为 MCP 工具参数（工具在云端服务器执行，无法读取用户本地文件）：

**本地文件上传指引（服务端代为鉴权，无需用户提供 API Key）：**

1. **获取一次性上传凭证（首选）**：调用 `create_upload_ticket` 工具，返回 upload_url 与 usage 命令
2. **在用户本地执行上传**（优先脚本，本地无 Python 时执行 usage 中的 curl 命令）
   - 脚本：`python scripts/upload_ticket.py --url <upload_url> --file <本地文件路径>`（upload_url 原样传入即可，文件名自动URL编码）
   - 成功时输出一行公网URL，直接作为 file_url 使用
   - 失败时输出以「错误:」开头的提示，按提示处理后可重新调用 `create_upload_ticket` 获取新凭证；上传累计执行不超过 2 次，不得换参数反复重试
3. **无法在用户本地执行命令时**（无 shell 权限）：将 usage 命令提供给用户自行执行，取其输出URL；或引导用户直接以文件链接形式提供

**注意**：文件URL必须是当前会话中用户提供的（附件或链接），请勿自行访问本地文件系统获取。若用户未提供待脱敏文件，请反问获取。

### 第二步：完成文件脱敏

告知用户文件正在脱敏处理中，请稍后... 然后调用 `file_desensitization` 工具，传入 file_url（以及 file_name，已知文件名时务必传入），返回脱敏后的文件下载链接。

## 返回格式

- **脱敏成功**：告知用户《脱敏版文件》生成成功，提供下载链接
- **脱敏失败**：提示用户文件脱敏失败，请稍后重试

## 终止性错误（收到即停，禁止绕过）

以下三类工具报错是面向用户的处理指令，不是可重试故障。工具返回后必须立即停止调用，不得自行处理：

- 「未检测到 API Key，请前往法保网 API 开放平台获取」
- 「API Key 无效或已过期，请前往法保网 API 开放平台确认账户状态」
- 「积分余额不足，请前往法保网 API 开放平台进行充值」

收到上述报错后禁止以下行为：

- 重试当前工具或修改参数后重试
- 调用其他工具复核该错误
- 绕过 MCP 工具调用，直接向服务端点发送底层 HTTP 请求

正确行为：将报错原文转告用户，等待用户在法保网 API 开放平台处理完毕后重新发起请求。

## 注意事项

- **信息收集优先**：必填参数缺失时必须反问获取，请勿直接调用工具。全部参数收集完成后再触发工具调用
- **禁止本地路径**：所有文件类参数必须是公网可访问的URL，严禁传入 `C:\`、`/home/` 等本地路径——服务端部署在云端，无法访问用户本地文件，传入本地路径必定失败
- **文件格式**：file_url 必须是公网可访问的URL，且文档必须是 .docx / .doc  格式。不支持 .pdf/.txt / .jpg 等其他格式
- **脱敏耗时**：文件脱敏需要几分钟，调用前需告知用户耐心等待
- **结果处理**：若返回 data 为下载链接（markdown格式 `[!请点击下载](url)`），提取URL告知用户点击下载；若 data 为空，提示用户稍后重试
- **鉴权说明**：本工具采用自填 API Key 模式，首次使用需在连接配置中填写法保网 API Key（在法保网 API 开放平台 https://lawyer.fabao.law/pc/#/mcp 获取）。若返回 msg 包含"积分余额不足"，直接将 msg 内容展示给用户即可（msg 已附带法保网充值地址）。若提示 API Key 无效、已过期或未检测到，属于终止性错误——立即停止调用并将报错原文转告用户，禁止重试或绕过，规则见上方「终止性错误」段。