DeepSeek Harness 金融市场监控插件：dsh-market-watch

在 DeepSeek Harness (DSH) 的插件生态中，获取实时数据是扩展智能体能力的关键一环。对于需要处理金融场景的开发者或用户，dsh-market-watch 提供了首个专门针对金融市场数据的功能集。它不依赖昂贵的私有接口，而是利用免费公共数据源（如腾讯财经、CoinGecko）来提供行情、自选股管理和图表展示。

插件概览¶

dsh-market-watch 是一个金融监控工具包，主要解决在本地或 DSH 环境下实时追踪股票、指数和加密货币的需求。

核心价值：基于免费数据源提供实时报价、本地持久化自选股、阈值警报、定期轮询以及 ASCII/mermaid 图表。
维护者：JohnXu22786
开源协议：MIT

核心功能¶

插件通过 DSH 的工具系统和独立的命令行接口（CLI）提供以下能力：

实时报价：支持 A 股（上交所/深交所/北交所）、指数及加密货币。数据主要来自腾讯财经的免费接口和 CoinGecko 公共 API。
本地自选股：在本地持久化存储关注列表（代码/名称/市场/类型），插件与 CLI 共享同一数据源，无需重启即可生效。
阈值警报：支持设置价格或涨跌幅度的触发条件（gt/gte/lt/lte）。警报在每次轮询时触发，并支持冷却时间（cooldown）以防止频繁打扰。
定期轮询：内置定时器，自动刷新自选列表。轮询逻辑会丢弃重叠的请求，且对免费数据源友好。
图表渲染：支持在聊天中渲染 ASCII 柱状图、折线图以及 Mermaid xychart-beta 流程图。

安装与启用¶

在安装前，请确保环境满足以下依赖要求：

Node.js：版本需为 ^22.19 || >=24
DeepSeek Harness (dsh)：版本需为 >=0.1.0-rc.6
Profile：需使用 web 或 headless profile

安装过程如下：

确保已安装 Node.js 和 dsh。
将插件代码克隆或放置到本地目录。
在该目录下执行安装命令：

dsh plugin --profile web add .

安装成功后，插件会自动注册到 DSH 的配置中，并在重启后生效。可以通过 dsh config dump | grep market-watch 检查插件是否正确加载。

典型用法¶

插件提供了 6 个 DSH 工具和一套独立的 CLI 工具，它们操作相同的数据目录。

命令行工具 (CLI)¶

dsh-market-watch 是独立的命令行程序，适合在终端中手动执行：

查询行情：

    dsh-market-watch quote sh600000 bitcoin --days 5

这将输出浦发银行（600000）和比特币的最新报价，并附带最近 5 天的迷你走势图。

管理自选股：

    dsh-market-watch watch sh600000 bitcoin --name "BTC"

添加股票代码和币种到本地自选列表。

查看列表：

    dsh-market-watch list

管理警报：

    dsh-market-watch alert add bitcoin --field price --op gte --value 70000 --cooldown 600

设置比特币价格达到 70000 时触发警报，冷却时间为 600 秒。

绘制图表：

    dsh-market-watch chart sh600000 --days 30 --format mermaid

生成 30 天的 Mermaid 格式图表。

执行单次轮询：

    dsh-market-watch poll --once

DSH 工具¶

插件注册了以下工具，智能体在对话中可直接调用：

quote：查询最新报价。
list：列出当前自选股。
watch：添加关注对象。
unwatch：移除关注对象。
alert：管理警报规则。
chart：生成图表。

适用场景与注意事项¶

适用场景：
* 需要在 DSH 环境中实时追踪 A 股或加密货币的用户。
* 需要构建具备金融监控能力的智能体。
* 需要在本地持久化存储交易计划或关注列表的开发者。

重要注意事项：

数据延迟：由于使用免费公共数据源，行情数据可能存在几秒到几分钟的延迟，并不等同于交易所的实时撮合价格。
数据来源：
- A 股/指数：腾讯财经接口。
- 加密货币：CoinGecko 公共 API（注意免费 Tier 的速率限制）。
投资建议：本插件提供的所有数据均为免费公共数据，不构成任何投资建议。请勿仅基于延迟数据做出交易决策。

结语¶

dsh-market-watch 为 DSH 生态引入了金融数据能力，通过 CLI 和工具系统的双重入口，实现了从查询到可视化的完整闭环。对于需要处理金融场景的开发者，这是一个可以直接落地的工具。更多细节及源码，请参考插件目录或 GitHub 仓库。