前言¶

在 DeepSeek Harness（DSH）里做智能体时，常见需求是「对话里能答行情、界面上能盯自选」。自己接东方财富等公开接口、再写一套侧边栏 UI，工作量大，且要和 Harness 的插件加载、工具注册对齐。社区插件 dsh-stock-quotes（维护者 AhaCrazy，SkillHub 分类：联网工具）把这两件事做成一个 bundle：浏览器半在侧边栏提供可配置的数据面板，Host 半注册 stock_quote，让 Agent 批量查询 A 股、港股、美股及板块行情。下面介绍它的定位、能力与安装用法。

这是什么¶

dsh-stock-quotes 是面向 DeepSeek Harness 的插件（当前仓库版本 2.0.1，MIT 许可证）。一句话定位：中性外观的侧边栏自选股实时行情表 + 对话工具 stock_quote。

面板默认侧栏名称是「数据」、图标为普通表格样式，显示名称可在设置里改，意图看起来像通用数据视图而非专用行情软件。行情来自公开接口的延时/快照数据，README 明确仅供查看，不构成投资建议，不用于交易决策。

环境要求（来自 README）：

• DeepSeek Harness 0.2.x，且需要 plugin_manager 工具
• 无需 API key，无需额外依赖；Host 半不 import 包外任何模块

核心功能¶

侧边栏数据面板¶

自选股在一张表里展示，支持 A 股、港股、美股及东财板块（BKxxxx 或面板内按板块名匹配）。列包括最新价、涨跌额、涨跌幅、今开/最高/最低、成交额等；报价默认约 15 秒自动刷新（可在设置里改为 5/10/15/30/60 秒，失败时会退避，最长 2 分钟）。

交互方面：顶部输入代码或名称添加；行首拖拽或右键「上移/下移/置顶/置底」排序；复选框多选后可用操作条批量删除或置顶/置底；右键删除、复制代码等。自选股顺序保存在浏览器 localStorage（键 dsh-stock-quotes/watchlist），与行情按代码映射，避免拖动后报价错位。

工具栏「曲线」可开关每行当日分时迷你折线（默认开启，偏好存 dsh-stock-quotes/prefs）。分时数据约 60 秒刷新一次，与 15 秒报价刷新分开；关闭曲线后不再请求分时接口。点击行可展开大图，支持 1 日/5 日切换、十字线读数等（细节见仓库 README「曲线图」一节）。

stock_quote 工具¶

Host 半注册工具名 stock_quote：一次可批量取一只或多只标的行情；不带参数时使用配置里的默认自选股（见下文 defaultSymbols）。板块名称解析主要在面板里做；工具侧请直接传代码，例如 BK1036。

代码与板块¶

README 列出了多市场写法：6 位代码、sh/sz/hk/us 前缀、.SH/.HK 等后缀，以及原始 secid（如 1.600519）。裸 6 位有歧义时会按文档规则解析（例如 000001 默认深市个股；上证指数需 sh000001 或 000001.SH）。

板块走东财同一套接口；同花顺 88xxxx 板块码无公开映射，需改用东财 BK 码或名称。名称搜索建议数据来自仓库 data/securities.json，面板从 CDN 拉取并缓存约一天。

设置¶

在 设置 → 插件 → 「数据面板」 卡片中可改：显示名称（默认「数据」）、刷新间隔、涨跌配色（红涨绿跌 / 绿涨红跌）、可隐藏的列、异动提醒阈值、自选股 JSON 导入导出。设置存 localStorage（dsh-stock-quotes/prefs）。面板自选股与 Host 配置里的默认列表相互独立。

安装与启用¶

插件以 bundle 形式安装。README 给出的流程是：先把仓库放到本机目录，再在 DSH 会话里用 plugin_manager 按绝对路径安装。

获取源码（README 原文）：

git clone https://github.com/AhaCrazy/dsh-stock-quotes.git

在 DSH 中安装 bundle（将 <path-to> 换成你本机上的实际路径）：

plugin_manager  action: install_bundle  target: <path-to>/dsh-stock-quotes

客户端模块加载后侧边栏会出现图标；若没有，刷新一次页面。stock_quote 会在下一次请求的工具清单里出现。

卸载：

plugin_manager  action: remove_bundle  target: dsh-stock-quotes

安装前建议自行查看仓库源码与 MIT 许可证；插件在 DSH 进程权限下运行，并会访问东方财富公开行情接口（push2 / push2his），非官方、无 SLA，可能限流或变更。

典型用法¶

配置 Agent 默认查询列表¶

编辑插件 bundle 中的 cordis.patch.yml，config.defaultSymbols 决定 stock_quote 无参时的默认标的。README 示例：

- insert:
    - id: stock-quotes
      name: 'dsh-stock-quotes'
      config:
        defaultSymbols:
          - sh000001
          - sh600519
          - sz300750
          - hk00700
          - usAAPL

改完后按你的 DSH 插件更新方式使配置生效；这与浏览器面板里维护的自选股无关。

面板里加自选¶

在面板顶部输入代码或板块名后回车或点「添加」。不确定代码时可输入名称（如 茅台）从建议列表选择。删除：在行上右键选「删除」。导入导出使用 JSON：{"version":1,"symbols":[...]} 或字符串数组，便于换机器。

对话中查价¶

安装并加载工具后，可向 Agent 提问需要实时行情的问题（README 举例：「茅台现在多少钱」）。Agent 应调用 stock_quote；具体参数形态以工具定义为准，多标的时传入对应代码列表即可。

适用场景与注意¶

适合谁：在 DSH 里开发或日常使用智能体、希望侧边栏盯自选、又希望对话里能查 A/HK/US 及东财板块快照的用户。

数据与合规：数据可能延迟或不准确；勿用于交易决策。插件不收集、不上报数据；自选与设置仅存在本机 localStorage。

覆盖范围（README）：支持 A 股、北交所、港股、美股、指数、ETF/LOF、可转债、B 股、板块等东财接口能覆盖的标的；不支持已退市代码、场外基金净值、期货、期权、外汇等。中文个股名称的浏览器端泛搜索暂不支持（板块名称例外）。

开发与测试：仓库提供 npm test（Node >= 20）；维护者可用 node scripts/build-index.mjs 重建搜索索引（需能访问 push2.eastmoney.com）。

结尾¶

dsh-stock-quotes 把「侧边栏中性数据面板」和「Host 工具 stock_quote」绑在一个 DSH bundle 里，降低在 Harness 里接行情的成本。更多操作细节、曲线图交互与免责声明见 GitHub README。

• SkillHub 目录页：https://www.skillhub.cn/plugins/AhaCrazy/dsh-stock-quotes
• 仓库：https://github.com/AhaCrazy/dsh-stock-quotes