DeepSeek Harness (DSH) 的核心设计理念之一是“一切皆插件”。对于需要监控 A 股行情的开发者或用户,在 Web GUI 中直接嵌入一个轻量级的盯盘组件往往比打开外部网站更高效。dsh-stock-ticker 正是为此场景设计的插件,它提供了一套完整的 A 股自选股监控方案,无需构建过程,开箱即用。
插件简介¶
dsh-stock-ticker 是一个为 DeepSeek Harness Web GUI 提供的实时股票盯盘插件。它由用户 f1426912008 维护,采用 MIT 许可证开源。
该插件在 DSH 的 shell.overlay 扩展位中渲染一个可拖拽、可折叠的迷你窗口,并在 settings.section 扩展位提供一个专门的“股票盯盘”设置页面。它不依赖任何运行时库,纯 JavaScript 实现,解决了在本地进程内读取东财行情数据并实时展示的需求。
核心功能¶
插件主要提供以下能力:
-
迷你窗口与交互
- 可拖拽与折叠:窗口位于主界面的叠加层,支持拖拽移动位置,也支持折叠隐藏。
- 钉住定位:窗口右上角有“钉住”按钮。点击后,窗口会被锁定在当前位置,标题栏不再响应拖拽。再次点击或通过设置页可取消钉住。
- 防误触与自适应:位置保存机制确保刷新后位置不丢失;窗口大小改变时,位置会自动校准,防止面板被拖出屏幕外。
-
行情可视化
- 分时曲线:支持配置最多 24 行股票,每行显示分时走势图。
- 红涨绿跌:遵循 A 股市场惯例,上涨显示红色,下跌显示绿色。
-
详情展示
- 悬停详情卡:鼠标悬停在任意行上时,会显示详细的数据卡片,包括开盘价、最高价、最低价、昨收、成交量、成交额、换手率、振幅、量比、市盈率、市净率以及涨跌停价等,且不会导致下方列表重排。
-
管理功能
- 设置页面:提供统一的配置入口,用于管理自选股列表、设置分时曲线数量 (
maxCurves)、刷新间隔 (refreshMs)、面板透明度 (opacity)、显示开关 (visible) 以及固定位置 (pinned)。
- 设置页面:提供统一的配置入口,用于管理自选股列表、设置分时曲线数量 (
安装与启用¶
在安装之前,请确保你的 DSH 环境满足以下要求:
- DeepSeek Harness:需为支持插件扩展的桌面端构建版本。
- Node.js:版本需大于等于
20.3。 - 网络权限:主机进程需要能够出站访问 HTTPS 到
push2.eastmoney.com、push2his.eastmoney.com和searchapi.eastmoney.com。
执行以下命令即可安装插件:
dsh plugin --profile <profile> add ./dsh-stock-ticker
安装完成后,在 DSH 的设置菜单中寻找“股票盯盘”入口,或通过配置确保 visible 为 true,即可在界面中看到迷你窗口。
配置与 API¶
设置字段¶
插件支持通过设置页面或 HTTP API 进行配置。主要配置项包括:
watchlist:自选股列表,最多支持 24 只。maxCurves:显示分时曲线的最大行数(1-24)。refreshMs:刷新间隔(5000-300000 毫秒,默认 15000)。opacity:面板透明度(0.35-1)。pinned:固定位置{ left, top }。
HTTP 接口¶
插件提供了同源 HTTP API 供外部调用:
GET /api/stock-ticker/config:获取当前配置。POST /api/stock-ticker/quotes:获取行情数据(可指定secids,默认为自选股)。POST /api/stock-ticker/trends:获取指定股票的走势数据。POST /api/stock-ticker/search:搜索股票。
适用场景与注意¶
- A 股专用:该插件仅针对中国大陆 A 股市场(上交所、深交所、北交所)设计,不支持其他交易所的行情。
- 无依赖:插件本身无运行时依赖,所有数据处理逻辑在宿主进程中完成。
- 数据源:数据来源于东财的公开推送接口,通过宿主进程发起请求,页面无法直接设置 Referer,因此通过页面直接调用接口可能受限。
结语¶
dsh-stock-ticker 提供了一种极简的方案,让用户能够在 DSH 的 Web 界面中直接监控 A 股行情。通过拖拽、折叠和详情卡等交互设计,它在不干扰主界面的前提下,提供了完整的盯盘体验。
插件目录:https://www.skillhub.cn/plugins/f1426912008/dsh-stock-ticker
GitHub 仓库:https://github.com/f1426912008/dsh-stock-ticker