前言¶
在 DeepSeek Harness（DSH）裏做量化或加密方向的智能體，常見痛點不是「找不到數據網站」，而是引用時混用二手說法、把修訂後序列當 PIT、把同域名的深層鏈接歸因錯源。口頭經驗與官方文檔往往差一線，而 agent 循環裏又很難邊寫邊逐條覈實。
下面介紹維護者 hanwang-ai 在 SkillHub「聯網工具」分類下的插件 quantitativeTrading-source-reliable：把 119 條人工覈定的信源打成可本地查詢的註冊表，並暴露兩個面向模型的工具，用於查源與審計草稿中的 URL 引用。註冊表與工具調用均不發起外網請求，查詢快且無寫副作用。
這是什麼¶
quantitativeTrading-source-reliable 是面向 DSH 的獨立插件（與 cs-source-reliable 無依賴關係，可單獨安裝）。它以數據包形式內置信源元數據：權威分級、驗證狀態、PIT 五態、修訂風險、數據集標籤等；模型通過 qt_source_find、qt_source_audit 在本地查表，而不是把「可靠性」交給一次性的網頁搜索。
插件當前版本爲 0.1.6（MIT），要求 Node.js 20+，DSH 版本 >=0.2.1-rc.1 <0.3.0-0。
核心功能¶
註冊表規模與字段¶
插件內置 119 個 agent 可採集信源：
- 73 條
quant：監管申報、宏觀、基本面、A 股/港股、執行接口、全球官方統計等。 - 46 條
crypto：交易所、衍生品、鏈上、歸檔、SDK、新聞、ETF 資金流等。
每條源記錄包括但不限於：域與類別、權威級（A 監管/交易所/官方文檔，B 機構/同行評審，C 可靠二手，D 僅線索）、verification 五檔（從 discovered 到 production_approved）、pit 五態、revision_risk、data_types（87 個受控標籤，定義於 data/datasets.yaml）、redistribution、刷新建議與探測日期等。構建腳本 tools/build-data.cjs 會校驗未知 tag、錯誤枚舉與懸空 fallback_id。
另有 22 條 api_hosts 映射：把真實 API 主機（例如 fapi.binance.com）歸到文檔所在的源 ID，避免「文檔站與 API 不同域」時引用無法對齊。
人工覈驗層 data/enrichment.yaml（version 2）記錄探測之後確認的 PIT 修正、驗證狀態與數據集標籤；產物 data/sources.json 帶 meta.data_version: 2 與構建元信息。
兩個本地工具¶
qt_source_find：按 URL、關鍵詞、domain（quant/crypto）、layer（breadth/depth）檢索信源，默認最多 5 條、上限 20 條。輸出含權威級、驗證狀態、PIT、修訂風險、數據集標籤與源 URL 等一行摘要。qt_source_audit：從草稿文本抽取 URL，逐條給出匹配置信度（exact_url/canonical_page/api_host/same_host_ambiguous/unknown），統計 known/unknown，並對疑似憑據參數做脫敏。
插件還通過 order 241 的短 system prompt 說明何時調用上述工具、如何書寫 [source-id] URL 式引用；它不攔截請求，由模型按引導自選調用。
與「常見說法」的差異¶
註冊表在 2026-11-06 對官方頁面或 API 做過探測，並在矩陣中保留 verified_on。README 用對照表說明若干易錯點，例如：宏觀 PIT 應用 ALFRED 而非僅用修訂後的 FRED；Alpha Vantage 免費層爲 25 請求/天；Binance 合約公開行情 WebSocket 路徑爲 wss://fstream.binance.com/ws/<stream>，不存在 /public 或 /market；單連接最長 24 小時 等。未覈實定價會標 free_tier: unverified，不硬抄數字。
安裝與啓用¶
安裝前請自行審閱 GitHub 倉庫 源碼與 MIT 許可證。插件隨當前 dsh 進程權限運行，與社區目錄 SkillHub 插件頁 一樣，並非 DeepSeek / 幻方官方應用商店。
官方 README 給出的安裝方式如下（以資料原文爲準）。
從 Release tarball 安裝（推薦，無需構建）：
dsh plugin --profile web add https://github.com/uhygyuf/quantitativeTrading-source-reliable/releases/latest/download/quantitativeTrading-source-reliable.tgz
從源碼倉庫安裝：
dsh plugin --profile web add github:uhygyuf/quantitativeTrading-source-reliable
本地開發目錄安裝：
dsh plugin --profile web add /absolute/path/to/quantitativeTrading-source-reliable
安裝後重啓或重載 profile。在「設置 → 插件」中可見名稱爲 量化交易信源可靠性 的條目。
典型用法¶
查交易所或監管文檔源¶
在陳述端點、費率、限流或 PIT 事實之前，可先調用 qt_source_find。示例參數與 README 中展示的形態一致：
query:"binance funding rate"或"sec xbrl"domain:crypto或quanturl: 已知文檔頁 URL 時優先用 URL 匹配
返回示例形態（節選）：
- [binance-ws-futures] Binance USD-M Futures WebSocket Streams — crypto/exchange; A/spec; verify=semantic_verified; ...
note: 公開行情 wss://fstream.binance.com/ws/<stream>（或 /stream?streams=）；私有用戶流 /private/ws/<listenKey>。不存在 /public 或 /market 路徑。
審計草稿引用¶
草稿含 URL 時調用 qt_source_audit。工具會彙總 known/unknown、權威級分佈，並對 same_host_ambiguous 明確提示「需固定到具體頁面」。README 中的輸出示例包括：Binance 文檔與帶 api_key 參數的 API URL（脫敏後）被標爲 canonical_page；同 host 無路徑關係的 PDF 鏈接觸發 ambiguous；未註冊域名爲 unknown。
觸發規則要點（與資料一致）：
- 優先 A/B 源；C 作二手；D 僅線索，不能單獨支撐結論。
verification=discovered須重新確認；reachable僅表示探測時 HTTP 200。- 新聞與事件類事實引用首次發佈時間。
- 話題超出量化金融與加密時，兩工具均可跳過。
實測開銷（README 記錄 2026-11-07）：註冊表加載約 2.3 ms；qt_source_find 平均延遲約 0.136 ms（5000 次）；每請求 schema 與引導合計約 712 tokens（按 4 字符/token 估算）。
適用場景與注意¶
適合：在 DSH 中編寫研報草稿、策略說明、數據管線設計文檔的智能體或開發者，需要統一信源 ID、權威級與引用審計，又不想在每次對話裏重複爬定價頁或交易所文檔。
不適合當作：數據網關、行情抓取器或交易系統。工具只讀註冊表，不抓頁面、不調 API、不驗證句子語義是否與源一致；不存儲 API key，不提供合規法律意見。交易風控須在模型與交易所之間另建確定性層。
維護邊界：qt_source_audit 對 same_host_ambiguous 一律不算 known；api_host 只歸因主機，不證明路徑與參數正確。未入庫 URL 一律 unknown。費用、限額與端點會變更，依賴數字前應結合 refresh_days、last_checked 與重新探測。
結尾¶
經過上面的步驟可知，quantitativeTrading-source-reliable 把量化與加密場景下「去哪取數、怎麼引用、常見誤區是什麼」收斂成 119 條帶日期的結構化元數據，並用兩個毫秒級本地工具輔助查源與 citation 審計，適合作爲 DSH 智能體寫結論前的信源層，而不是替代各數據商 API 本身。
