360 Secure SkillHub
360 安全技能中心

文档问答助手

该技能通过 Python 脚本读取本地 PDF、Word、Markdown、TXT 等文档,根据用户问题检索相关内容并生成带来源的答案,可用于知识库问答、跨文档验证和文档摘要。SKILL.md 还引用了批量索引脚本,但当前文件列表未包含该脚本。

xuyongliang-eccom
xuyongliang-eccom
热度 48.18
最近更新 2026-05-18 12:36:08
分类:知识依赖:代码执行 / 读写文件应用场景:研究 / 摘要总结

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add document-qa-assistant
Metadata
name
document-qa-assistant
description
文档问答助手。基于本地文档(PDF/Word/Markdown/TXT)回答问题,支持知识库检索和多文档交叉验证。当用户需要:从文档中查找答案、基于文档回答问题、跨多个文档综合查询、验证信息一致性、生成文档摘要时使用此技能。

Document QA Assistant

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

核心能力

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

快速开始

问答

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

批量索引文档

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

脚本说明

scripts/doc_qa.py

基于文档回答问题。

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

参数:

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

scripts/index_docs.py

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

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

典型场景

从知识库中查找答案

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

生成文档摘要

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

跨文档验证信息

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

输出格式

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