前言¶
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 的服务条款。