前言¶
DeepSeek Harness (DSH) 的設計原則之一是移除模型可見的 Shell 進程中的憑證型環境變量。這意味着將 WIND_API_KEY 放置在宿主機環境變量中,無法直接被智能體的 Bash 工具調用;而將其複製到工作區又會破壞 DSH 的邊界隔離。
xiamu-ssr/snowmountain-market 插件通過在受信任的宿主進程中解析憑證,解決了這一問題。它將 Wind AIFin 的 MCP 工具和 Alice 工作流接入 DSH,同時保證密鑰不會暴露給模型或普通命令。
插件簡介¶
該插件提供了一套憑證安全的 Wind AIFin MCP 集成方案。它通過 DSH 原生的 MCP 客戶端連接 Wind 的官方流式 HTTP 端點,並將 Alice 的專業金融分析工作流暴露爲工具。
- 插件倉庫:
xiamu-ssr/snowmountain-market - 維護者:Xiamu-ssr
- 許可證:MIT
核心功能¶
插件主要包含以下三個層面的能力:
- 7 個原生 MCP 工具:將 Wind 的 7 個官方流式 HTTP MCP 域名直接註冊爲 DSH 的原生工具,包括股票、基金、指數、債券、文檔、宏觀經濟和跨資產分析。
- Alice 工作流集成:通過
wind_alice工具調用 Wind Alice 的專業金融分析工作流(如財報審查、同業對比、信用分析等)。 - 運行時 Skills:內置兩個運行時 Skills,用於指導智能體進行請求路由,而不需要將 API 密鑰或 Shell 命令寫入提示詞中。
安裝與配置¶
插件依賴 DSH 0.1.0-rc.8 或更新版本。
安裝¶
在 DSH 的目標 profile(如 web)中執行以下命令:
dsh plugin --profile web add github:Xiamu-ssr/snowmountain-market
安裝完成後需重啓該 profile。
配置憑證¶
- 在 Wind 開發者門戶創建 AIFin API Key。
- 在 DSH 的 Credentials 頁面將此 Key 存儲爲引用
WIND_API_KEY。 - (可選)在可信的 DSH 啓動環境中直接設置
WIND_API_KEY。
安全警告:切勿將 WIND_API_KEY 放入工作區文件、Skill 文件、提示詞、cordis.patch.yml 中的 MCP 頭部配置,或模型可見的 Shell 配置文件中。
工具與用法¶
MCP 工具命名¶
MCP 工具遵循 DSH 的標準限定命名約定,前綴爲 mcp__wind_ 後跟具體領域:
| 領域 | 工具前綴 |
|---|---|
| 股票 | mcp__wind_stock__ |
| 基金與 ETF | mcp__wind_fund__ |
| 指數與行業 | mcp__wind_index__ |
| 債券 | mcp__wind_bond__ |
| 公告與資訊 | mcp__wind_docs__ |
| 宏觀指標 | mcp__wind_economic__ |
| 跨資產分析 | mcp__wind_analytics__ |
Alice 工具調用¶
wind_alice 工具接受一個文本提示和一個可選的專業工作流名稱。例如,調用公司一頁紙分析工作流:
tool: wind_alice
prompt: 分析騰訊控股的最新財報情況
workflow: company_one_pager
安全與注意事項¶
- 網絡隔離:憑證適配器僅監聽
127.0.0.1,並使用不可猜測的進程內路由。適配器僅接受 7 個固定的 Wind 端點,不會變成通用的認證代理。 - 憑證處理:憑證僅在每次請求時解析,不會緩存在文件中,也不會返回給模型。
- 文件處理:Alice 生成的可下載文件不會自動複製到 DSH 工作區,僅在 Agent 上下文中返回最終文本或數據。
- 生態說明:該插件無安裝腳本,且不捆綁或分發 Wind 的官方 Skills 倉庫。它是社區維護的適配器,非 Wind 官方產品。