Document QA Assistant#

文档问答助手。基于本地文档回答问题，支持多文档检索和交叉验证。

核心能力#

1. 文档解析 — 支持 PDF、Word、Markdown、TXT、CHM
2. 语义检索 — 基于内容理解回答问题，不依赖关键词匹配
3. 多文档交叉 — 跨多个文档综合答案
4. 答案溯源 — 指出答案来自哪个文档的第几部分

快速开始#

问答#

bash

python3 scripts/doc_qa.py --docs "./docs/" --question "这个产品的价格是多少"

批量索引文档#

bash

python3 scripts/index_docs.py --dir "./knowledge-base/" --output ./index.json

脚本说明#

scripts/doc_qa.py#

基于文档回答问题。

bash

python3 scripts/doc_qa.py --docs <文档路径> --question "<问题>" [--context-len <行数>]

参数：

• --docs: 文档文件或目录路径
• --question: 要回答的问题
• --context-len: 参考上下文行数（默认 20）

scripts/index_docs.py#

批量索引文档供后续检索。

bash

python3 scripts/index_docs.py --dir <目录> --output <输出索引文件>

典型场景#

从知识库中查找答案#

bash

python3 scripts/doc_qa.py \
  --docs "./knowledge-base/metaworks/" \
  --question "微应用开发需要哪些前置条件"

生成文档摘要#

bash

python3 scripts/doc_qa.py \
  --docs "./docs/product-guide.pdf" \
  --question "请用100字总结这份文档的核心内容"

跨文档验证信息#

bash

python3 scripts/doc_qa.py \
  --docs "./docs/v1/,./docs/v2/" \
  --question "两个版本的配置方式有什么不同"

输出格式#

json

{
  "answer": "答案内容...",
  "sources": [
    {
      "file": "文档路径",
      "relevance": 0.95,
      "excerpt": "相关段落..."
    }
  ],
  "confidence": "high|medium|low"
}