# AI投标灵标书审核 Skill

由 **AI投标灵** 发布和维护的免费公共标书审核 Skill。目标是在不同 Agent / Harness 生态中复用同一套审核方法，让更多用户能够直接审核非扫描版 PDF、DOCX 招标与投标文件。

> 当前状态：`v0.1.0` 已通过 GitHub 与 `dsh-plugin` 主题向 DeepSeek Harness 用户公开发布，并完成全新临时 Profile 的公共地址安装验证。WorkBuddy 已完成 ZIP 安装、问题样例、正常样例和扫描件降级验证，但 SkillHub 公共上架仍待登录/认证；Windows 仍需真机补测。

## 核心能力

- 对照招标文件审核商务标、技术标和投标附件；
- 检查资格与实质性响应、报价与工期、人员与业绩、技术参数、实施方案、服务承诺、偏离与一致性等风险；
- 从 DOCX/PDF 抽取原生文本，按需渲染指定页面或提取内嵌图片；
- 模型支持视觉输入时，复核签章、签字、表格版式和指定页面；
- 对扫描件、证据不足、转换失败和不稳定检查明确跳过，不编造结论。

## 产品边界

- 只支持具有可用原生文本层的 PDF 和 DOCX；全扫描件、纯图片型 Word 暂不审核。
- 默认不做 OCR、不联网、不上传文件、不自动安装依赖，也不启动常驻 Python 服务。
- Agent 负责理解、检索和判断；Python 只做确定性的文件探测、文本抽取、页面渲染和图片提取。
- 只有投标文件、没有招标文件时，只能做内部一致性和文档风险检查，不能声称符合招标要求。
- 输出为证据可追溯的 Markdown 风险报告，不代替正式评标、法律意见或人工终审。

## 公共发行架构

```text
skills/aitoubiaoling-bid-review/   唯一的核心 Skill 与 Python 工具
            │
            ├── DeepSeek Harness   根目录 package.json / index.js 适配
            ├── WorkBuddy          标准 ZIP，经 SkillHub 公共分发
            └── 未来平台           只新增适配器，不复制审核规则
```

技术目录名固定为 `aitoubiaoling-bid-review`，对外展示名固定为“AI投标灵标书审核”。平台适配器不得改变扫描件边界、证据标准或跳过策略。

## 安装

### DeepSeek Harness

可通过公共 GitHub 仓库安装：

```bash
dsh plugin --profile headless add github:zslzxy/aitoubiaoling-bid-review
dsh plugin --profile web add github:zslzxy/aitoubiaoling-bid-review
```

安装或更新后重启对应 Profile。显式调用示例：

```bash
dsh --profile headless "/aitoubiaoling-bid-review 审核当前目录中的招标文件和投标文件，先说明实际覆盖范围。"
```

### WorkBuddy / SkillHub

公共发布完成后，在 WorkBuddy 的 SkillHub 市场搜索“AI投标灵标书审核”并安装。仓库源码中的本地上传仅用于开发验收，不等同于公共发布。

开发者可生成标准安装包：

```bash
python3 scripts/build_skill_zip.py
```

产物为 `dist/aitoubiaoling-bid-review.zip`，ZIP 根目录直接包含 `SKILL.md`、`agents`、`references` 和 `scripts`。

## Python 工具

```bash
python3 skills/aitoubiaoling-bid-review/scripts/document_tool.py capabilities
python3 skills/aitoubiaoling-bid-review/scripts/document_tool.py inspect <document.pdf|document.docx>
python3 skills/aitoubiaoling-bid-review/scripts/document_tool.py prepare <document> --output-dir <dir>
```

Windows 可将 `python3` 替换为 `py -3` 或 `python`。DOCX 原生文本与图片提取只使用 Python 标准库；PDF 文本与图片能力按可用性使用 PyMuPDF 或 pypdf，PDF 页面渲染按可用性使用 PyMuPDF 或 pdftoppm；DOCX 页面渲染按需调用本机 LibreOffice。详细降级规则见 [tooling.md](skills/aitoubiaoling-bid-review/references/tooling.md)。

## 发布与质量

- [公共发布规则](docs/publication.md)
- [兼容性与验证记录](docs/verification.md)
- [安全边界](SECURITY.md)

## 开源声明

本项目采用 MIT License，免费使用。默认审核报告保留“AI投标灵标书审核 Skill”来源标识；用户或平台要求无品牌输出时可以省略。