# 税务知识库 · 总说明

> 本知识库系统收录全国税务相关法律、法规、规章、规范性文件、政策文件及司法案例，按「国家 → 省 → 市」三级分层组织，并提供面向 AI 的标准化子目录。
> 数据截至：2026-08（国家级经国家税务总局政策法规库实时抓取，每日增量更新）

---

## 一、目录结构

```
知识库/
├── README.md              ← 本说明（总索引）
├── 国家级/                 ← 原始明文文件（md / pdf / docx 并存，按 8 类分好）
│   ├── 法律/               全国人大及其常委会制定
│   ├── 行政法规/           国务院制定（含实施条例）
│   ├── 国务院文件/         国务院批复、通知
│   ├── 部门规章/           财政部、税务总局令
│   ├── 财税文件/           财政部、税务总局公告/通知
│   ├── 规范性文件/         税务总局征管口径
│   ├── 其他文件/           目录、名单、清单
│   └── 工作通知/           征管执行要求
├── 省级/                  34 个省级行政区政策文件
├── 市级/                  地级市税务政策文件
├── 司法案例/              偷税逃税、虚开、骗税、税案通报等
│
├── md/                    【AI 子目录①】全量 Markdown（镜像上方分类，每文件一份）
├── json/                  【AI 子目录②】全量结构化 JSON（每文件一个条目 + all.json 聚合）
├── skills/                【AI 子目录③】按税种/主题生成的 Skills（SKILL.md）
├── manifest.json          全量条目索引（5669 条，机器可读）
└── 省市抓取框架.md         省市抓取路线图
```

## 二、AI 调用方式（三选一）

| 方式 | 入口 | 说明 |
|---|---|---|
| **Skills** | `skills/<主题>/SKILL.md` | 按主题（增值税/企业所得税/个人所得税/征管/发票/出口退税等 14 类）加载即用 |
| **MCP** | `https://www.box00.cn/shuiwu/ai/mcp` | 8 个工具：`search_kb`/`get_doc`/`search_laws` 等，一行配置接入 |
| **llms.txt** | `https://www.box00.cn/shuiwu/ai/llms.txt` | 一行 curl 自动学习全库索引 |

## 三、数据规范

- **明文优先**：所有文件以 Markdown 保存正文；PDF 自动转换（555 份），扫描件（43 份）仅保留索引
- **结构化**：每份文档对应 `json/<类别>/<标题>.json`，含 title/category/path/doc_no/effective_date/status/source_url
- **分类**：国家级 8 类 + 省级 + 市级 + 司法案例，与原始目录一一对应
- **增量**：国家/省市发布新文件后，运行 `../build_kb.py` 自动增量构建，全站同步

## 四、统计（2026-08-29 构建）

| 项目 | 数量 |
|---|---|
| 总条目 | 5669（含同名去重） |
| 原文 Markdown | 5143 |
| PDF 自动转换 | 483（入库）+ 转换文件 555 |
| 扫描件（仅索引） | 43 |
| Skills 主题 | 14 |
| 总量 | 约 54 MB（md/ 5698 份）+ json/ 5670 份 |

## 五、维护

- 增量构建：`python3 ../build_kb.py`（幂等，只处理新增/变更）
- 全量重建：`python3 ../build_kb.py --full`
- 同步服务器：`bash ../sync_ai_ready.sh`（含 md/json/skills 全量）
- 新 PDF 请放入对应类别目录，构建时自动转 MD 并生成 JSON/SKILL