交付物质检 xuhan242/deliverable-qa

deliverable-qa — 交付物质检

AI 生成的文档越来越多，没人审文档。这是输出侧的质检层：排版 / AI 腔 / 敏感内容，三条检查线，一份问题清单，复查归零才交付。

特性

- 纯 Python 标准库实现，零第三方依赖（zipfile + ElementTree 直接解析 OOXML）
- 支持 md / txt / docx（pptx 尽力而为），中文场景优先
- 规则与代码解耦：rules/*.json 加一条规则 = 加一行数据
- 高危敏感问题（密钥/凭证）不回显原文，避免终端/日志二次泄露
- 用户私有规则（人名映射、内部路径、内网域名）放仓库外本地配置

两种用法

| 形态 | 适合 | 安装方式 |
| CLI / Skill | 任意智能体（ZCode、Claude Code、DSH…）或命令行 | 把 SKILL.md、qa_check.py、rules/ 放到 ~/.agents/skills/deliverable-qa/ |
| DSH 插件 | DeepSeek Harness 用户：原生 qa_check 工具 + 交付前自动安检 | dsh plugin --profile <profile> add https://github.com/xuhan242/deliverable-qa/releases/download/v0.1.0/dsh-deliverable-qa-0.1.0.tgz（见 plugin/） |

插件形态多出来的能力：注册原生工具给模型直接调用；在 present 声明交付物之前自动质检，发现密钥/凭证类高危问题时拦截交付（可配置为只告警）。详见 plugin/README.md。

安装与使用

直接用
python qa_check.py 报告.docx

只跑某条线
python qa_check.py --only sensitive 报告.md

带本地规则(人名/内网路径等)
python qa_check.py --config ~/.qa_local.json 报告.md

退出码：存在高危问题返回 1，否则 0。

作为智能体技能安装（跨智能体通用）

把 SKILL.md、qa_check.py、rules/ 复制到 ~/.agents/skills/deliverable-qa/ 即可；对话里说「质检这份文档」触发。

规则总览（v1）

| 线 | 规则 | 严重度默认 |
| 排版 | T1 中文语境半角标点（代码/URL/表格豁免） | 中 |
| 排版 | T2 docx 字体不统一（run 级 eastAsia/ascii） | 中 |
| 排版 | T3 标题层级跳跃 | 中 |
| 排版 | T4 日期格式不统一 | 低 |
| 排版 | T5 数字风格（千分位/量词/单位空格，含 bp/亿/万 等金融单位） | 低 |
| 排版 | T6 中英文空格风格不统一 | 低 |
| AI腔 | A1 破折号密度超标（每千字 2 处，可调） | 中 |
| AI腔 | A2 套话与句式（值得注意的是/不仅…更/综上所述…） | 中 |
| AI腔 | A3 首先/其次/最后三段式（段首与句内两种形态） | 中 |
| AI腔 | A4 加粗标签列表化 | 中 |
| AI腔 | A5 三并列短句排比 | 低 |
| AI腔 | A6 空洞收尾（未来可期/值得期待/必将…） | 低 |
| 敏感 | S1 密钥/凭证（AKIA、sk-、私钥头、ghp_ 等；不回显） | 高 |
| 敏感 | S2 个人信息（手机号/身份证；显示打码） | 中 |
| 敏感 | S3 自定义（人名映射/内部路径/内网域名/敏感词，本地配置） | 中 |

开源红线声明

本仓库为 clean-room 项目：全部代码与示例从零编写；示例中的人名（张三/李四/王经理）、路径（D:\company\...）、域名均为合成数据；用户真实的人名与内部路径配置放在仓库外，通过 --config 传入，永远不进入本仓库。

路线图

- pptx 解析增强；更多排版规则（表格/图注编号）
- 规则包社区化（行业词表）
- DSH 插件封装（交付 present 钩子 = 交付即安检）

许可

MIT