透過腳本探索文件
概述
以腳本為核心的文件探索,遵循 llms.txt 標準。
自動執行腳本處理完整工作流程,無需手動建構網址。
主要工作流程
請一律依此順序執行腳本:
# 1. 偵測查詢類型(特定主題 vs 一般)
node scripts/detect-topic.js "<使用者查詢>"
# 2. 使用腳本輸出擷取文件
node scripts/fetch-docs.js "<使用者查詢>"
# 3. 分析結果(若回傳多個網址)
cat llms.txt | node scripts/analyze-llms-txt.js -
腳本會自動處理網址建構、備援鏈與錯誤處理。
腳本
detect-topic.js - 分類查詢類型
- 識別特定主題 vs 一般查詢
- 擷取程式庫名稱 + 主題關鍵字
- 回傳 JSON:
{topic, library, isTopicSpecific} - 零 token 執行
fetch-docs.js - 檢索文件
- 自動建構 context7.com 網址
- 處理備援:主題 → 一般 → 錯誤
- 輸出 llms.txt 內容或錯誤訊息
- 零 token 執行
analyze-llms-txt.js - 處理 llms.txt
- 分類網址(重要/次要/補充)
- 建議代理分佈(1 個代理、3 個代理、7 個代理、分階段)
- 回傳包含策略的 JSON
- 零 token 執行
工作流程參考
特定主題搜尋 - 最快路徑(10-15 秒)
一般程式庫搜尋 - 全面覆蓋(30-60 秒)
儲存庫分析 - 備援策略
參考資料
context7-patterns.md - 網址模式、已知儲存庫
errors.md - 錯誤處理、備援策略
advanced.md - 邊緣情境、版本管理、多語言
執行原則
- 腳本優先 - 執行腳本而非手動建構網址
- 零 token 負擔 - 腳本執行無需載入上下文
- 自動備援 - 腳本處理主題 → 一般 → 錯誤鏈
- 漸進式揭露 - 僅在需要時載入工作流程/參考資料
- 代理分佈 - 腳本建議並行代理策略
快速開始
主題查詢:「How do I use date picker in shadcn?」
node scripts/detect-topic.js "<查詢>" # → {topic, library, isTopicSpecific}
node scripts/fetch-docs.js "<查詢>" # → 2-3 個網址
# 使用 WebFetch 讀取網址
一般查詢:「Documentation for Next.js」
node scripts/detect-topic.js "<查詢>" # → {isTopicSpecific: false}
node scripts/fetch-docs.js "<查詢>" # → 8+ 個網址
cat llms.txt | node scripts/analyze-llms-txt.js - # → {totalUrls, distribution}
# 按建議部署代理
環境設定
腳本會載入 .env:process.env > .opencode/skills/docs-seeker/.env > .opencode/skills/.env > .opencode/.env
請參閱 .env.example 了解設定選項。