前言¶
在构建 DeepSeek Harness 代理时，让它们具备访问实时金融数据的能力是一项常见需求。通常这需要开发者手动接入第三方 API。dsh-stock-lookup 插件通过封装两个工具，直接解决了“从公司名称/代码到实时行情”这一链路的问题。
是什么¶
这是一个由 minyang-chen 维护的 DeepSeek Harness 插件。它为代理提供两个核心工具：stock_resolve 和 stock_profile。前者用于解析公司名称或部分代码为股票符号，后者用于获取实时报价和公司概况。
安装与启用¶
安装插件需要执行以下命令：
dsh plugin --profile web add github:minyang-chen/dsh-stock-lookup
安装或更新后，必须重启 DSH 才能生效：
dsh web
核心功能¶
stock_resolve¶
该工具用于将公司名称、部分名称或代码解析为标准股票符号。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
query |
string | 是 | 公司名称、部分名称或代码，例如 "Apple"、"nvidia"、"TSLA" |
limit |
number | 否 | 最大返回结果数（1-10），默认为 5 |
返回信息：股票代码（ticker）、CIK、官方公司名称、以及直接指向 SEC EDGAR 文件的链接。
stock_profile¶
该工具通过 Yahoo Finance 获取指定股票代码的实时报价和详细资料。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
ticker |
string | 是 | 股票代码，例如 "AAPL"、"NVDA"、"BRK-B" |
返回信息：包括当前价格、涨跌幅、市盈率（P/E）、市值、板块、行业、公司描述等。
典型用法¶
代理会自动选择合适的工具。以下是可以直接使用的示例：
- 直接查询价格：
What is Apple's current stock price?
代理会直接调用 stock_profile。
- 公司名 -> 代码 -> 概况：
What sector is Nvidia in?
代理会先调用 stock_resolve 找到 NVDA，再调用 stock_profile 获取板块信息。
- 模糊名称查询：
Look up Amazon stock
代理会解析出 AMZN 并提供后续操作。
- 获取 SEC 文件链接：
Give me the SEC EDGAR filing link for Microsoft
代理会调用 stock_resolve 并返回 SEC EDGAR 的直接链接。
- 批量查找：
Find all companies with "apple" in the name
返回最多 10 个匹配结果，包含代码、CIK 和 EDGAR 链接。
配置与注意事项¶
配置项¶
插件提供以下配置：
| 配置项 | 默认值 | 说明 |
|---|---|---|
enabled |
true |
是否注册工具 |
quoteTtlMs |
15000 |
行情缓存有效期（毫秒） |
数据源与依赖¶
- 无 API 密钥：使用该插件不需要申请任何 API 密钥。
- 外部服务：仅依赖 Yahoo Finance 获取实时数据。
- SEC 数据：解析功能使用捆绑的 SEC EDGAR 公司索引（约 10,000 家美国上市公司）。数据会在 DSH 启动时检查，如果超过 7 天会自动从 SEC 官网刷新；若刷新失败，则使用本地缓存。
总结¶
dsh-stock-lookup 通过封装 stock_resolve 和 stock_profile，让代理能够直接执行股票研究任务。它无需额外配置，依赖开源数据源，适合需要在对话中集成金融数据的 DeepSeek Harness 代理开发场景。
