legal-doc-redactor
法律文件脱敏/还原工具 - 智能识别敏感 信息,支持批量处理
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
Its scripts were only partly scanned.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/moyupeng0422/legal-doc-redactor with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/moyupeng0422/legal-doc-redactor'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/moyupeng0422--legal-doc-redactor)HTML
<a href="/listings/moyupeng0422--legal-doc-redactor"><img src="/api/listings/moyupeng0422--legal-doc-redactor/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 149 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- name: 法律文件脱敏处理
- description: |
- 法律文件脱敏/还原工具 - 将法律文档中的敏感信息进行智能替换和脱敏处理,或将脱敏稿还原为原文
- <examples>
- - 帮我把这份合同脱敏处理
- - 我需要脱敏这个法律文件
- - 生成脱敏版本的合同文档
- - 将这份法律文书中的敏感信息替换掉
- - 创建合同的脱敏版本
- - 帮我把脱敏稿还原成原文
- - 使用比对词还原审核稿
- </examples>
- ---
- # 法律文件脱敏处理
- 将法律文档中的敏感信息进行智能替换和脱敏处理,生成可对外分享的脱敏版本。支持将脱敏稿交由外部审核后,使用比对词还原为原文。
- ## 核心功能
- ### 脱敏功能
- - **多种脱敏类型**:名称、日期、价格、文件名、项目名、银行账号、案号等
- - **自定义脱敏类型**:创建自定义类型(如"合同名称"、"产品型号"),批量输入精准匹配内容
- - **批量模式**:多文件上传自动进入批量模式,统一编号确保跨文件一致性
- - **规则设置**:可自主开启/关闭16种内置脱敏类别,灵活控制识别范围
- - **智能替换**:根据上下文识别角色(买方/卖方公司)
- - **实时预览**:黄色高亮显示脱敏内容
- - **格式保留**:完整保留原文格式(段落、表格、字体)
- - **白名单/黑名单管理**:精确控制特定内容的脱敏行为;黑名单支持记录项目类型
- - **优先级机制**:黑名单 > 白名单 > 脱敏类别(内置+自定义)
- - **冲突检测**:添加到列表时自动检测是否已存在于其他列表
- - **调试模式**:详细日志输出,便于排查问题
- ### 还原功能
- - **自动化还原**:根据比对词自动将【X】标记还原为原文
- - **批量还原**:支持多文件同时还原,自动匹配文件配对,ZIP打包下载
- - **保留审核痕迹**:还原时保留文档中的修订、批注等审核痕迹
- - **runs级别替换**:精确替换,不影响其他内容的格式
- ## 使用方式
- ### HTML离线工具(推荐)
- #### 脱敏模式
- **单文件脱敏:**
- 1. 打开 `assets/index.html`,选择"脱敏模式"
- 2. 拖拽或选择单个 docx 文件上传
- 3. 自动识别并预览脱敏效果
- 4. 手动编辑脱敏项
- 5. 导出脱敏文件和比对.md文档
- **批量脱敏:**
- 1. 上传多个 docx 文件,自动进入批量模式
- 2. 统一识别:相同内容使用相同替换文本
- 3. 文件切换:通过列表栏切换查看各文件
- 4. 同步编辑:删除/添加脱敏项会同步到所有文件
- 5. 导出结果:每个文件生成独立的 `{文件名}_比对.md`
- #### 还原模式
- **单文件还原:**
- 1. 打开 `assets/index.html`,选择"还原模式"
- 2. 上传脱敏稿(带审核痕迹的docx)
- 3. 上传对应的比对.md文件
- 4. 点击"执行还原",自动下载还原后的文件
- **批量还原(4步流程):**
- 1. **上传文件**:上传多个脱敏稿 + 多个比对.md文件
- 2. **确认配对**:系统自动匹配文件名,支持手动调整
- 3. **执行还原**:批量处理,显示进度条
- 4. **下载结果**:ZIP打包下载
- ### Python脚本
- ```bash
- # 安装依赖
- pip install python-docx
- # 执行脱敏
- python scripts/redact.py input.docx data/rules.json -o output.docx
- # 执行还原(保留修订、批注)
- python scripts/restore.py redacted.docx mapping.md -o restored.docx
- ```
- ## 详细文档
- - **工作流程**: [references/workflow.md](references/workflow.md)
- - **规则模式库**: [references/patterns.md](references/patterns.md)
- - **数据格式**: [references/data-formats.md](references/data-formats.md)
- - **脚本使用**: [scripts/README.md](scripts/README.md)
- - **HTML使用**: [assets/README.md](assets/README.md)
- ## 版本历史
- - **v1.5.0(2026-03-29)右键菜单集成 + Python/HTML识别统一**:
- - **Windows 右键菜单**:右键 .docx 文件可直接"用脱敏工具打开"、"一键脱敏"或"一键还原",通过注册表集成,无需管理员权限
- - **macOS 右键菜单**:通过 Automator Quick Action 实现,Finder 快速操作中调用 Python 脚本
- - **一键还原**:自动查找比对文件(`_比对.md`/`_mapping.md`),复刻 HTML `restoreSingleFile()` 还原逻辑,每次替换后重建 runInfo
- - **识别逻辑统一**:Python 一键脱敏与 HTML 应用识别结果完全一致(基于 `original` 去重/子串判断)
- - **organization 边界检查**:防止"2025年上海XX有限公司"中年份后公司名被误识别
- - **安装脚本优化**:Windows bat 使用 GBK 编码,修复路径引号嵌套和 `%%1` 延迟展开
- - **v1.4.0(2026-03-11)批量模式优化**:
- - **独立比对文件**:批量导出时每个文件生成独立的 `{文件名}_比对.md`,存放在 `比对文件/` 文件夹中
- - **批量模式一致性**:相同内容在不同文件中使用相同替换文本
- - **v1.3.1(2026-03-02)规则开关控制**:
- - 新增"规则设置"功能:可自主开启/关闭内置脱敏类别
- - 16种内置类别可独立控制
- - 代码类分组联动:4个代码子类任一启用,"代码"按钮就可用
- - 设置持久化保存,刷新页面后保持
- - 类型选择器联动:禁用的类别在手动添加时变灰不可选
- - **v1.3.0(2026-02-28)导入导出词库**:
- - 导入敏感词库:从Excel批量导入(格式:敏感词 | 类型),自动识别内置类型和自定义类型
- - 导入白名单:从Excel批量导入(格式:内容),支持预览和冲突检测
- - 导入弹窗整合:敏感词库和白名单通过标签页切换
- - 导出白名单:导出为Excel文件,文件名包含日期(如:白名单_2026-02-28.xlsx)
- - 导出敏感词库:导出黑名单+自定义类型为Excel,类型显示中文,文件名包含日期
- - 界面优化:移除重置按钮,简化界面
- - 示例词库更新:覆盖全部16种系统默认识别类型
- - **v1.2.0(2026-02-13)优先级机制与自定义类型**:
- - 自定义脱敏类型:创建/编辑/删除自定义类型(如"合同名称"、"产品型号"),批量输入精准匹配内容
- - 优先级机制:黑名单(最高)> 白名单 > 脱敏类别(内置+自定义)
- - 白名单覆盖检查:白名单中的内容会阻止包含该内容的脱敏识别(如白名单有"计划",则"股权激励计划"不被识别)
- - 黑名单优先:黑名单强制脱敏,不受白名单限制
- - 冲突检测机制:添加到列表时自动检测是否已存在于其他列表,显示冲突提示
- - 防冲突机制:删除脱敏项时检查来源,黑名单/自定义类型内容需手动删除后才能加入白名单
- - **v1.1.0(2026-02-07)黑名单增强**:
- - 黑名单数据结构升级:从字符串数组升级为对象数组 `{ original, type }`
- - 黑名单类型记录:添加黑名单时一并记录项目类型
- - 智能脱敏:黑名单自动脱敏时使用记录的类型(如【人名1】、【日期1】),而非统一显示【敏感信息】
- - 类型标签显示:黑名单界面显示原文和对应的类型标签
- - 兼容性:自动兼容旧版黑名单数据(字符串格式)
- - **v1.0.0(2026-02-06)初始版本**:
- - **脱敏功能**:支持名称、日期、价格、文件名、项目名、银行账号、案号等多种脱敏类型;根据上下文智能识别角色(买方/卖方公司);黄色高亮实时预览脱敏效果;完整保留原文格式(段落、表格、字体)
- - **白名单/黑名单管理**:精确控制特定内容的脱敏行为;黑名单支持记录项目类型,自动使用对应类型进行脱敏;localStorage持久化存储;跨文件共享设置
- - **调试模式**:详细日志输出;调试面板实时显示;日志导出功能
- - **还原功能**:根据比对.md自动将【X】标记还原为原文;还原时保留文档中的修订、批注等审核痕迹;runs级别精确替换
- - **导出功能**:导出保留原格式的脱敏docx文件;导出替换比对.md(用于还原);导出调试日志文件
- - **文件上传**:支持拖拽上传脱敏稿docx和比对.md文件;比对.md文件名自动使用docx文件名前缀
- - **规则库**:内置默认脱敏规则,支持自定义规则;支持上下文敏感替换(合同方识别、金额类型识别)
README.md · README · 236 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # 法律文件脱敏处理工具
- 
- 一款完全离线的法律文档脱敏工具,支持脱敏和还原两大核心功能,数据不上传,安全可控。
- > **⚠️ Mac用户注意**:Safari 浏览器下载 zip 包可能会出错,建议使用 Chrome 或其他浏览器下载。
- ## 核心功能
- ### 脱敏功能
- 
- 将法律文档中的敏感信息智能识别并替换为脱敏标记,生成可对外分享的脱敏版本。
- **支持的脱敏类型:**
- - organization(组织机构)
- - id_card(身份证号)
- - date(日期)
- - price(金额)
- - person_name(人名)
- - phone(联系电话)
- - email(联系邮箱)
- - credit_code(统一社会信用代码)
- - bank_account(账号)
- - org_code(组织机构代码)
- - patent_code(专利申请号)
- - file_code(文件编号)
- - case_number(案号)
- - project_name(项目名称)
- - address(地址)
- **功能特点:**
- - **智能识别**:基于正则表达式自动识别15类敏感信息
- - **批量模式**:上传多个文件自动进入批量模式,统一编号确保相同内容使用相同替换文本
- - **独立比对文件**:批量导出时每个文件生成独立的 `{文件名}_比对.md`
- - **自定义类型**:创建自定义脱敏类型(如"合同名称"、"产品型号"),批量输入精准匹配内容
- - **导入词库**:从Excel批量导入敏感词库和白名单,支持团队共享词库
- - **导出词库**:导出白名单和敏感词库为Excel,文件名包含日期,方便版本管理
- - **手动编辑**:支持手动添加、删除、修改脱敏项
- - **实时预览**:黄色高亮显示脱敏内容,实时查看效果
- - **白名单/黑名单**:精确控制哪些内容不脱敏或强制脱敏
- - **优先级机制**:黑名单(最高)> 白名单 > 脱敏类别(内置+自定义)
- - **冲突检测**:添加到列表时自动检测是否已存在于其他列表
- - **调试模式**:详细日志记录和导出,便于问题排查
- - **规则设置**:可自主开启/关闭内置脱敏类别,灵活控制识别范围
- - **格式保留**:完整保留原文档格式
- - **右键菜单集成**:Windows/macOS 右键 .docx 文件可直接脱敏
- ### 还原功能
- 
- 使用脱敏时生成的"替换比对.md"文件,将脱敏文档还原为原始状态。
- **核心特点:保留修订和批注**
- - **外部审核工作流**:脱敏稿可发送给外部审核,审核人员添加的修订和批注会被完整保留
- - **精确还原**:还原后可查看外部审核的所有修改意见和批注
- - **格式保留**:还原后的文档保持原有格式和审核痕迹
- ## 使用方式
- ### 脱敏流程
- **单文件脱敏:**
- 1. **打开工具**:双击 `assets/index.html`
- 2. **上传文件**:点击上传区域或拖拽单个 docx 文件
- 3. **查看识别结果**:自动识别敏感信息,黄色高亮显示
- 4. **编辑脱敏项**(可选):手动添加/删除/修改脱敏项
- 5. **管理列表**(可选):白名单/黑名单/自定义类型管理
- 6. **规则设置**(可选):开启/关闭内置脱敏类别
- 7. **导出结果**:导出脱敏文件.docx 和 替换比对.md
- **批量脱敏(上传多个文件自动触发):**
- 1. **上传多个文件**:拖拽或选择多个 docx 文件
- 2. **统一识别**:相同内容在不同文件中使用相同替换文本(如"张三"在所有文件中都替换为"人名1")
- 3. **文件切换**:通过顶部文件标签栏切换查看各文件的识别结果
- 4. **同步编辑**:在任一文件中删除/添加脱敏项,会同步到其他文件
- 5. **导出结果**:
- - ZIP打包下载
- - 每个文件生成独立的 `{文件名}_比对.md`
- - 比对文件存放在 `比对文件/` 文件夹中
- 
- **白名单/黑名单/自定义类型管理**(可选):
- - 点击对应按钮打开管理面板
- - **白名单**:添加不希望脱敏的内容(如公开公司名),会阻止包含该内容的识别
- - **黑名单**:添加强制脱敏的内容,优先级最高
- - **自定义类型**:创建新的脱敏类型(如"合同名称"),批量添加匹配内容
- - **优先级规则**:黑名单 > 白名单 > 脱敏类别
- 
- **规则设置**(可选):
- - 点击"⚙️ 规则设置"按钮打开设置面板
- - **开启/关闭类别**:勾选或取消勾选内置脱敏类别
- - **代码类分组联动**:4个代码子类(统一社会信用代码、组织机构代码、专利申请号、文件编号)任一启用,"代码"按钮就可用
- - **快捷操作**:提供"全选"/"全不选"按钮
- - **设置持久化**:保存在浏览器本地,刷新页面后保持
- - **类型选择器联动**:禁用的类别在手动添加脱敏项时变灰不可选
- **导入词库**(可选):
- - 点击"导入词库"按钮
- - **导入敏感词库**:Excel格式(敏感词 | 类型),自动识别内置类型和自定义类型
- - **导入白名单**:Excel格式(内容),批量添加白名单
- - 支持团队共享词库,方便统一管理
- **启用调试模式**(可选):
- - 勾选"启用调试模式"
- - 查看详细的识别和处理日志
- - 点击"导出日志"下载调试日志
- ### 还原流程
- **典型场景:外部审核**
- 1. 脱敏原始文档 → 发送外部审核
- 2. 外部审核人员在脱敏稿上添加修订和批注
- 3. 还原功能保留所有审核痕迹,还原为原始内容
- 4. 内部人员可查看外部审核意见
- **单文件还原:**
- 1. **切换到还原模式**:点击顶部"切换到还原模式"链接
- 2. **上传文件**:上传脱敏后的 docx 文件 + 对应的"替换比对.md"文件
- 3. **执行还原**:点击"执行还原"
- 4. **导出文件**:点击"导出还原后的docx"
- **批量还原(4步流程):**
- 1. **上传文件**:
- - 上传多个脱敏稿 docx 文件
- - 上传多个对应的比对.md 文件
- 2. **确认配对**:
- - 系统自动匹配文件名(如 `合同A【脱敏】.docx` ↔ `合同A_比对.md`)
- - 支持手动调整配对关系
- 3. **执行还原**:
- - 点击"确认并执行还原"
- - 显示进度条
- 4. **下载结果**:
- - ZIP打包下载所有还原后的文件
- ## 项目结构
- ```
- 法律文件脱敏处理/
- ├── SKILL.md # 技能定义
- ├── README.md # 项目说明(本文件)
- ├── LICENSE # MIT License
- ├── references/ # 详细参考文档
- │ ├── workflow.md # 工作流程
- │ ├── patterns.md # 规则模式库
- │ └── data-formats.md # 数据格式说明
- ├── scripts/ # Python脚本
- │ ├── README.md # 脚本使用说明
- │ ├── requirements.txt # 依赖列表
- │ ├── redact.py # 脱敏脚本
- │ ├── restore.py # 还原脚本
- │ ├── context_menu_server.py # 右键菜单 HTTP 服务器
- │ ├── quick_redact.py # 右键菜单一键脱敏
- │ ├── quick_restore.py # 右键菜单一键还原
- │ ├── install_context_menu.bat # Windows 右键菜单安装
- │ ├── uninstall_context_menu.bat # Windows 右键菜单卸载
- │ ├── install_context_menu_mac.sh # macOS 右键菜单安装
- │ └── uninstall_context_menu_mac.sh # macOS 右键菜单卸载
- └── assets/ # HTML离线工具(主要)
- ├── README.md # HTML使用说明
- └── index.html # 主程序(完全离线)
- ```
- ## 导出文件说明
- ### 1. 脱敏文件.docx
- 保留原格式的脱敏文档,可直接对外分享。
- ### 2. 替换比对.md
- 记录所有脱敏操作的明细,用于还原脱敏文档。
- - **批量模式**:每个文件生成独立的 `{文件名}_比对.md`
- - **一致性保证**:相同内容在不同文件中使用相同替换文本
- ### 3. 白名单.xlsx
- 导出白名单内容,文件名包含日期(如:白名单_2026-02-28.xlsx),可导入到其他电脑使用。
- ### 4. 敏感词库.xlsx
- 导出黑名单+自定义类型,类型显示中文,文件名包含日期,可导入到其他电脑使用。
- ## 技术栈
- - **前端**:HTML + CSS + JavaScript(mammoth.js、JSZip)
- - **后端**:Python 3.7+(可选,用于高级功能)
- ## 注意事项
- 1. **完全离线**:所有功能在浏览器本地执行,数据不上传
- 2. **备份文件**:处理前建议备份原始文件
- 3. **保存比对文件**:替换比对.md是还原的必要条件,请妥善保存
- 4. **浏览器兼容**:推荐使用 Chrome、Edge 等现代浏览器
- ### 右键菜单快速脱敏(Windows / macOS)
- 无需打开工具,直接右键 .docx 文件即可脱敏或还原:
- - **用脱敏工具打开** — 在浏览器中打开完整脱敏工具
- - **一键脱敏** — 后台直接处理,生成脱敏文件
- - **一键还原** — 自动查找比对文件,将脱敏稿还原为原文
- **Windows 安装:**
- 1. 解压分发包
- 2. 双击 `scripts/install_context_menu.bat`
- 3. 右键 .docx 文件即可使用
- **macOS 安装:**
- 1. 解压分发包
- 2. 终端运行 `chmod +x scripts/install_context_menu_mac.sh && ./scripts/install_context_menu_mac.sh`
- 3. Finder 中右键 .docx 文件 → 快速操作
- > ⚠️ macOS 右键菜单功能未经测试,可能无法正常工作。如不生效,可打开"自动操作"(Automator)手动创建 Quick Action:新建"快速操作" → 添加"运行 Shell 脚本" → 输入 `python3 "脚本路径" "$@"` → 存储
- **卸载:** 运行对应的 `uninstall` 脚本
- ## 许可证
- MIT License - 详见 [LICENSE](LICENSE)
- ## 版本历史
- - **v1.5.0** 右键菜单集成:Windows/macOS 右键快速脱敏、Python/HTML识别统一
- - **v1.4.0** 批量模式优化:独立比对文件、修复多项批量模式bug
- - **v1.3.1** 规则开关控制:可自主关闭某些内置脱敏类别
- - **v1.3.0** 导入导出词库:导入敏感词库、导入白名单、导出白名单、导出敏感词库
- - **v1.2.0** 优先级机制与自定义类型
- - **v1.1.0** 黑名单增强
- - **v1.0.0** 初始版本
- 详细版本历史见 [SKILL.md](SKILL.md)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.