MackDing

Zh Policy RAG — AI skill for Claude Code

AI community

Chinese policy/regulation document RAG system with multi-source retrieval, Corrective RAG, and OpenAI-compatible LLM integration.

How to install Zh Policy RAG

This entry records only its repository, not the path inside it, so there is no exact command to give. Open MackDing/zh-policy-rag and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Zh Policy RAG does

Chinese policy/regulation document RAG system with multi-source retrieval, Corrective RAG, and OpenAI-compatible LLM integration.

Alternatives in AI

Codex — openai-codex Adversarial code review, Codex CLI integration, cross-model analysis 9.6k ★
Hindsight — State-of-the-art long-term memory for AI agents by Vectorize 6.7k ★
WindsurfAPI — Turn Windsurf / Devin Desktop's 100+ AI models (Claude, GPT, Gemini, DeepSeek, Kimi, GLM, SWE) into OpenAI-, A 3k ★

README

zh-policy-rag — 中文政策制度智能问答系统

[English](#english) | 中文

一个面向企业内部知识库的中文政策/法规文档 RAG 系统。支持多路检索融合、Corrective RAG 质量门控和 SSE 流式输出，开箱即用地对接任何 OpenAI 兼容的大模型端点。

项目简介

zh-policy-rag 将企业内部的政策文件、管理办法、审批流程等非结构化文档转化为可对话的知识库。用户提问后，系统并发调用向量检索、BM25 关键词检索、知识图谱和页面索引四路召回源，通过 RRF 融合与交叉编码器重排后，由 CRAG 评估器决定是否直接生成答案、改写查询重试，还是向用户说明无结果。整个过程通过 SSE 实时推送到前端。

**适用场景：** 企业制度查询、法规合规问答、内部流程咨询

特性

**检索层**

四路并发检索：ChromaDB 向量 + BM25 关键词 + 知识图谱 (RAGAnything) + PageIndex
加权 RRF 融合（多源命中加分），Qwen3-Reranker / BGE-Reranker 交叉编码器重排
中文分词同义词扩展（jieba），HyDE 假设文档生成

**质量门控**

Corrective RAG (CRAG) 三色评估：绿色直接生成，琥珀色改写重试，红色告知用户
语义答案缓存（余弦相似度阈值 0.95，LRU 1 万条）

**文档解析**

MinerU（PDF/DOCX 高质量）、Excel（openpyxl/xlrd）、Legacy（旧版 doc/wps 降级）三套解析器
pdfplumber 二次兜底：MinerU 把流程图/架构图判为整页图像时自动切换，恢复 PDF 文本层里的文字（详见 docs/PDF_OCR_DIAGNOSIS.md）
解析错误分类：加密、损坏、扫描件、编码错误等，并给出具体修复建议
政策感知分块：尊重"第X条"、编号条目等中文文档边界

**生成与对话**

SSE 实时流式输出，逐 token 推送到前端
对话历史持久化（SQLModel + SQLite）
LLM 主备端点自动故障转移
支持任何 OpenAI 兼容端点（Qwen、Llama、OpenAI API 等）

**评估**

三框架评估：DeepEval + TruLens + Arize Phoenix
内置 CRAG 分布统计、引用率、检索/生成耗时指标

系统架构

用户浏览器 (React + Ant Design)
     │  POST /api/qa/ask → SSE 流式响应
     ▼
  Nginx :80
  ├─ /api/* ──────────────────────────────────┐
  └─ /*  → frontend :3000                     │
                                              ▼
                                   FastAPI 后端 :8000
                                        │
                           ┌────────────▼────────────┐
                           │       RAGEngine          │
                           │                          │
                           │  ┌─ QueryEnhancer ──┐   │
                           │  │  同义词扩展 + HyDE │   │
                           │  └──────────────