前言¶

做 DSH / 智能体开发的同行，调试 Web 客户端时如果要确认国内金价，通常的做法是切到另一个行情页面或行情软件，回来再接着看日志。dsh-gold-price 这个插件把这一步省掉了：它在 DSH Web 客户端侧栏底部常驻显示黄金 9999 的最新价和涨跌幅，并提供一个可打开的「国内金价」实时面板。插件由 douzhihao111 维护，当前版本 0.1.0，许可证 MIT。下面介绍它的功能、安装方式和实际使用要点。

这是什么¶

一句话定位：一个 DeepSeek Harness（DSH）Web 客户端插件，把国内金价行情嵌入侧栏和面板，无需离开客户端即可查看。

它解决的问题很具体：国内金价分散在黄金 9999、黄金 T+D、上海金、沪金主连等多个合约上，手动查要逐个看，插件在一个面板里统一展示，并保持后台轮询刷新。插件本身只做展示，不涉及交易指令，也明确标注不构成投资建议。

核心功能¶

下面介绍的能力都来自插件 README，可以逐条核对。

侧栏常驻行情

• 侧栏底部显示黄金 9999 最新价与涨跌幅，点击可打开完整面板。
• 侧栏收起时保留金色金条图标。

实时面板

• 黄金 9999（Au99.99，上海黄金交易所）主报价：最新价、涨跌额、涨跌幅、今开、昨收、最高、最低。
• 黄金 T+D、上海金、沪金主连（上海期货交易所）三张行情卡。
• 黄金 9999 日内分时走势图，支持鼠标悬停查看每个分钟点的价格。
• 交易中 / 已休市状态、行情时间、页面刷新时间与手动刷新。

刷新与适配

1、每 5 秒刷新报价，每 30 秒刷新分时走势。
2、页面隐藏时暂停请求，重新可见时立即刷新。
3、自动适配浅色 / 深色主题与窄窗口。

数据来源¶

报价和分时数据来自东方财富公开行情接口，不是插件自己抓取或转发：

• https://push2.eastmoney.com/api/qt/ulist.np/get（报价）
• https://push2.eastmoney.com/api/qt/stock/trends2/get（分时走势）

用到的合约代码：

需要注意，行情可能存在延迟，交易时段外显示的是最近一次报价。

安装与启用¶

插件以 profile bundle 的形式安装。先构建 / 准备好本目录，然后执行：

dsh plugin --profile desktop add /absolute/path/to/dsh-gold-price

再把包名加入 profile 的 package.json 中的 dsh.profile.bundles：

{
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-gold-price"
      ]
    }
  }
}

重启 Harness（或让配置热重载生效）后，侧栏底部会出现金价行情，侧栏导航会出现「金价」面板入口。

卸载分两步：

dsh plugin --profile desktop remove dsh-gold-price

并从 dsh.profile.bundles 中移除 dsh-gold-price。

目录结构与实现说明¶

插件源码很薄，主要三个文件：

实现上值得留意的几点：

1、报价与分时共用一个模块级 store，侧栏 ticker 与面板共享同一份轮询，不会重复请求。
2、组件通过 useSyncExternalStore 订阅 store；组件卸载时最后一个订阅者会停止全部定时器，避免后台继续轮询。
3、浏览器半是纯 JavaScript（无 JSX、无构建步骤），以 Harness 的 window.__ModuleLoader__.load({ id, factory }) 形式交付，React 由客户端模块系统提供。
4、通过 ctx.slots 注册三个位置：main（面板）、sidebar.panellist（面板入口）、sidebar.footer.action（侧栏常驻行情）。

package.json 里与运行相关的字段：

• version：0.1.0
• license：MIT
• engines.dsh：>=0.2.1-rc.5
• dsh.bundle.patch：./cordis.patch.yml
• dsh.client.platform：web

典型用法¶

安装并启用后，日常使用不需要额外配置：

1、打开 DSH Web 客户端，侧栏底部直接看到黄金 9999 最新价与涨跌幅。
2、点击侧栏行情或侧栏导航的「金价」入口，打开完整面板。
3、在面板里查看主报价、三张行情卡和分时走势图；把鼠标停在分时图上可查看分钟点价格。
4、需要最新数据时点手动刷新；页面切到后台会自动暂停轮询，回来立即刷新。

适用场景与注意¶

适合需要长时间开着 DSH Web 客户端、想顺手看到国内金价，或想以面板为底座做二次开发的用户。插件只做行情展示，不包含交易功能，不要把它当作行情分析或投资建议工具。

几点提醒：

1、插件以当前 DSH 进程的权限运行，能访问进程可访问的网络和文件。安装前应先检查源码与许可证（本插件为 MIT），确认第三方接口调用符合自己的环境要求。
2、数据依赖东方财富公开接口，接口可用性和延迟由上游决定，插件不改数据来源。
3、行情可能延迟，交易时段外显示的是最近一次报价。
4、社区目录站点是独立站点，与 DeepSeek / 幻方无官方从属关系，不要把它当作应用商店。

结尾¶

dsh-gold-price 的价值在于把国内金价行情变成了 DSH Web 客户端的一个原生面板，减少查看行情时的窗口切换。它体量小、职责单一，刷新策略和主题适配都处理得比较克制。如果你要在自己维护的 profile 里加一个行情展示插件，这个仓库的结构（Host 半只提供 Loader 行、浏览器半独立轮询、通过 ctx.slots 注册三个位置）可以作为参考。

插件目录页：https://www.skillhub.cn/plugins/douzhihao111/dsh-gold-price

GitHub：https://github.com/douzhihao111/dsh-gold-price