前言¶
DeepSeek Harness (DSH) 通過將憑證與模型可見的 Shell 進程解耦來構建信任邊界。將 Wind CLI 的 API 密鑰放入環境變量不會讓 Agent 獲得訪問權限,直接將密鑰複製到工作區也會破壞邊界。本插件將憑證注入受信任的主機進程,並將 Wind AIFin 的官方服務接入 DSH。
插件定位¶
這是 xiamu-ssr/dsh-wind-aifin,一個用於 DeepSeek Harness 的插件。它將 Wind AIFin 的官方 Streamable HTTP MCP 域名和 Alice 工作流連接爲原生工具,同時保持 API 密鑰對模型不可見。插件屬於 admin-security 類別,許可證爲 MIT。
核心功能¶
該插件提供以下能力:
- MCP 工具接入:通過 DSH 的
@deepseek-ai/dsh-mcp-client連接 7 個 Wind Streamable HTTP MCP 域名,並將它們暴露爲原生工具:wind_stock、wind_fund、wind_index、wind_bond、wind_docs、wind_economic和wind_analytics。 - Alice 工作流調用:提供
wind_alice工具,用於調用 Wind Alice 的專業金融分析工作流,包括事實覈查、公司簡報、財報回顧等。 - 運行時 Skills:包含運行時 Skills,用於根據請求類型路由工具調用,Agent 不需要在提示詞中輸入 API 密鑰或 Shell 命令。
- 憑證管理:在 Settings 命名空間中聲明
WIND_API_KEY爲 DSH 憑證引用。
安裝與啓用¶
安裝前請確保 DSH 版本爲 0.1.0-rc.8 或更新。
dsh plugin --profile web add github:Xiamu-ssr/snowmountain-market
安裝後重啓 profile。如需安裝到其他 profile,請將命令中的 web 替換爲對應 profile 的名稱。
典型用法¶
在 Agent 中使用時,MCP 工具遵循 DSH 的標準命名約定。例如,調用股票數據工具爲 mcp__wind_stock__。調用 Alice 工作流時使用 wind_alice 工具,傳入提示詞和可選的工作流名稱。
憑證 WIND_API_KEY 需要通過 Credentials 頁面設置,或在受信任的 DSH 啓動環境中提供。請勿將密鑰寫入工作區文件、Skill 文件或模型可見的 Shell 配置中。
適用場景與注意事項¶
此插件適合需要在 DSH 環境中安全訪問 Wind AIFin 數據與服務的場景。
安裝前應檢查源碼與許可證。使用時需注意以下安全與運行機制:
- 網絡限制:適配器僅監聽
127.0.0.1,並使用不可猜測的 per-process 路由。它僅接受 7 個固定的 Wind 端點,不可用作通用認證代理。 - 憑證處理:憑證按請求解析,不會緩存在文件中。
- 無安裝腳本:插件沒有安裝腳本,也不捆綁或分發 Wind 官方的 Skills 倉庫。
- 文件處理:Alice 的最終文本/數據 artifact 會返回給 Agent,但 Alice 生成的可下載文件不會自動複製到 DSH 工作區。
- 合規性:在發送敏感信息前,請務必審查 Wind 的服務條款。