前言¶
項目裏堆着 Word、PDF、Markdown 和 TXT，用關鍵詞搜往往漏掉「意思相近、措辭不同」的段落。自己接 embedding、向量庫和檢索鏈路，開發和維護成本都不低。下面介紹 SkillHub 上的社區 Skill「文檔向量檢索」，把文檔向量化、存儲和語義檢索收進 Agent 可調用的能力裏；簡介中說明在 v3.0 側增加了查詢緩存與 BM25 加向量的混合檢索，且標註 requires_api_key=false，不依賴外部 API Key。
這是什麼¶
「文檔向量檢索」是 SkillHub 分類 knowledge-management 下的社區 Skill，座標爲 @user_af28adda/chromadb-document-vectorizer，SkillHub 頁面版本爲 1.0.0，來源 community，發佈者爲 user_af28adda（頁面展示作者爲 Captain）。定位是：處理文檔向量化、存儲和語義檢索；當用戶需要向量化文檔、查找相似內容或對文檔集合做語義查詢時，由 Agent 按需 Invoke。
核心功能¶
以下能力均來自 SkillHub 官方簡介與詳情頁，未在資料中出現的實現細節不寫。
- 多格式文檔：支持 Word、Markdown、PDF、TXT 等格式的處理與檢索。
- 向量化與存儲：完成文檔向量化並持久化，供後續檢索使用。
- 語義檢索：按語義相似度在文檔集合中查找內容，而不只依賴字面匹配。
- v3.0 能力（簡介所述）：查詢緩存（簡介稱速度提升約 70 倍）；混合檢索，結合 BM25 與向量檢索。
- 觸發場景（英文 Invoke 說明）：用戶需要向量化文檔、搜索相似內容，或對文檔集合執行語義查詢時使用。
安裝與啓用¶
Skill 基於通用 SKILL.md 格式。在 SkillHub 安裝時，需把技能裝到當前 Agent 能識別的 skills 目錄，否則默認落在 ./skills/ 可能不會被加載。
方式一：SkillHub CLI¶
先確認是否已安裝 CLI：
command -v skillhub && skillhub --version
未安裝時可按 SkillHub 安裝文檔執行完整安裝或僅 CLI（限網環境需允許聯網）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝本 Skill 時指定目標目錄（將 <skills 目錄> 換成當前環境路徑）：
skillhub install user_af28adda/chromadb-document-vectorizer --dir <skills 目錄>
常用目錄示例（以 SkillHub 安裝文檔爲準）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
方式二：讓 AI 按官方指引安裝¶
SkillHub 詳情頁提供的提示爲：根據 https://skillhub.cn/install/skillhub.md 安裝 @user_af28adda/chromadb-document-vectorizer。
資料中未單獨列出 Cursor、Codex CLI、Claude Code 的安裝差異，除 skills 目錄路徑外，安裝步驟與上述 CLI 或 AI 指引一致。
典型用法¶
公開頁面未給出可複製的一步步命令示例（例如具體腳本名或配置文件字段）。可復現的用法邊界如下：
- 按上一節完成安裝並確保 Skill 位於當前 Agent 的 skills 目錄。
- 在對話中提出與官方 Invoke 說明一致的需求，例如：將某批 PDF/Markdown 納入檢索、用自然語言問題在文檔庫中找相似段落、對已有文檔集合做語義查詢。
- Agent 加載該 Skill 後，按 SKILL.md 中的流程執行向量化、存儲與檢索；混合檢索與查詢緩存行爲以 Skill 內文檔與 v3.0 說明爲準。
若需覈對安裝包內容與具體工具調用，可在安裝後閱讀技能目錄內的 SKILL.md（資料未截斷其正文，本文不展開未覈實項）。
適用場景與注意¶
適合誰：需要在 Agent 工作流裏做本地或項目內文檔語義搜索、相似內容查找的團隊或個人；希望減少自研向量管線時，可先評估該 Skill 是否覆蓋自己的格式與檢索方式。
社區與版本：來源爲 community，SkillHub 展示版本爲 1.0.0，簡介中的 v3.0 指 Skill 自述的功能代際，與商店包版本號可能不一致，以實際安裝包爲準。
數據與合規：處理 Word/PDF 等文件時注意版權與敏感信息；向量與索引的落盤位置以 Skill 實現爲準，生產環境部署前應在本地核對。
商店數據（截至頁面展示）：評分 100000，下載 1113，安裝 12；標籤含 requires_api_key=false。
結尾¶
「文檔向量檢索」把多格式文檔向量化、存儲與語義檢索（含簡介中的混合檢索與查詢緩存）封裝爲 Agent Skill，適合在知識管理類任務中按需 Invoke。官方入口：
