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字總結這份文件的核心內容"

跨文件驗證資訊

小蔥技能7w4.net有完整的技能分類。

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

輸出格式

{
  "answer": "答案內容...",
  "sources": [
    {
      "file": "文件路徑",
      "relevance": 0.95,
      "excerpt": "相關段落..."
    }
  ],
  "confidence": "high|medium|low"
}

這個 Skill 的文件看起來很專業，但實際功能比較基礎。文件描述的"智慧語義檢索"實際上是簡單的關鍵詞匹配，檢索能力有限。另外文件提到的批次索引功能實際上缺失，無法使用。安裝配置時可能還需要手動安裝依賴。總的來說質量一般，適合對準確性要求不高的簡單文件查詢場景使用。