前言¶

做 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