前言¶
DSH 的理念是「一切皆插件」。日常在同一個 dsh 頁面裏跑任務時，經常需要對照金價：看國內現貨、看延期品種、順便跟倫敦金現比一下。傳統做法是切到行情網站或瀏覽器另一個窗口，來回覈對，回到頁面再接着幹活。eastbadman/dsh-gold-price 把這件事變成頁面裏的一個可拖動懸浮窗：行情實時刷新，位置可以固定在自己順手的地方，不需要反覆切窗口。
下面介紹這個插件的定位、功能、安裝方式和運行原理。
這是什麼¶
eastbadman/dsh-gold-price 是一個 DeepSeek Harness（dsh）插件，由 eastbadman 維護，屬於社區目錄裏的「聯網工具」分類。它解決的問題是：在 dsh 頁面內直接顯示國內黃金行情，包括滬金99.99、黃金延期、金條100g，以及倫敦金現對照。
插件以 dsh-gold-price 爲包名發佈，版本 1.0.0，Node 引擎要求 >=20，許可證爲 MIT。
核心功能¶
插件在 dsh 頁面裏渲染一個懸浮窗，主要能力如下：
- 國內三個品種：滬金99.99（SGE Au99.99 現貨）、黃金延期（Au T+D）、金條100g，單位爲元/克，漲跌按昨日結算價計算。
- 倫敦金現對照：美元/盎司。
- 紅漲綠跌：按國內行情慣例，價格每次變動有紅/綠閃爍提示。
- 近 30 分鐘走勢線：針對滬金99.99，在頁面打開期間累積數據繪製。
- 20 秒自動刷新：頁面隱藏時暫停，回到前臺立即刷新。
- 可拖動、可記憶：按住標題欄拖動，位置存入
localStorage，下次打開仍在原處；可摺疊成小條。
數據來自新浪財經公開接口（上海黃金交易所 / 倫敦金現），僅供參考，不構成投資建議。休市期間顯示最後收盤價，並標註行情時間；接口若調整，面板會顯示獲取失敗並保留最後的緩存值。
安裝與啓用¶
安裝走 dsh 的插件命令，需要指定 profile：
dsh plugin --profile <profile> add dsh-gold-price
也可以直接從 GitHub 安裝：
dsh plugin --profile <profile> add https://github.com/eastbadman/dsh-gold-price
安裝後無需重啓，HMR 生效；如果頁面沒有出現懸浮窗，刷新一次頁面即可。
典型用法¶
插件沒有額外的配置項，裝好之後在 dsh 頁面裏就會出現懸浮窗。日常用法就是直接看：
1、打開 dsh 頁面，確認懸浮窗已出現。
2、對照國內三個品種的元/克報價和倫敦金現的美元/盎司報價。
3、需要時按住標題欄拖動到順手的位置，位置會自動記住。
4、不看時摺疊成小條，不影響頁面其他操作。
幕後有兩個部分在協作：
- Host 半（Node）按需抓取
hq.sinajs.cn的公開行情，帶 Referer，15 秒緩存，無人在看時不會產生後臺請求；隨後通過webServer.register()暴露同源路由/gold-price/ticker.json。 - Client 半註冊到
shell.overlay插槽渲染懸浮窗，向上面的同源路由輪詢，不產生任何跨域請求；樣式全部使用 dsh 宿主主題 token。
新浪行情接口要求新浪域 Referer 且不返回 CORS 頭，瀏覽器直連不可行，所以把抓取放在 Node 側、再由同源路由轉給前端，這是該插件的主要技術取捨。
適用場景與注意¶
適合需要在 dsh 頁面裏頻繁對照國內金價的開發者和個人用戶，尤其是希望不切窗口、不打斷當前任務的場景。
需要注意幾點：
1、插件以當前 dsh 進程的權限運行，安裝前應先檢查源碼與許可證（該插件爲 MIT）。
2、行情數據僅供參考，不構成投資建議。
3、數據源依賴新浪財經公開接口，接口調整時面板會顯示獲取失敗，並保留最後緩存。
4、package.json 聲明瞭 dsh.bundle.patch 指向 ./cordis.patch.yml，安裝方式走標準的 dsh 插件通道，不涉及手動改動宿主。
結尾¶
這個插件的價值在於把金價查詢收斂到 dsh 頁面之內，無需另開窗口，同時用同源路由的方式規避了新浪行情接口的 CORS 限制。目錄頁在 https://www.skillhub.cn/plugins/eastbadman/dsh-gold-price ，源碼在 https://github.com/eastbadman/dsh-gold-price 。
