前言¶

在 DSH 裏做自動化或盯行情時，金價往往要切到瀏覽器查上金所、銀行積存金或國際現貨。頁面分散、刷新節奏不一致，也很難在同一屏裏對比「交易所價」和「銀行買入/贖回價」是否偏離合理區間。下面介紹社區客戶端插件 dsh-gold-card（維護者 ZCX26324）：在 DSH 左側邊欄增加「黃金實時價格」入口，用貼邊卡片聚合四類權威報價，並帶交叉校驗與可選走勢、要聞和本地持倉估算。

插件定位¶

• 名稱：dsh-gold-card（npm 包名同名，當前版本 1.9.3，MIT 許可證）
• 分類：客戶端（側邊欄入口 + 瀏覽器內面板）
• 倉庫：github.com/ZCX26324/dsh-gold-card
• 目錄頁：skillhub.cn 插件頁

Host 側用 Node 內置模塊直連官方/權威數據源（https / zlib / crypto），免 Key、免登錄；前端面板每 15 分鐘自動刷新，Host 對報價做 60 秒緩存，四源併發抓取文檔中實測約 520~900ms。

界面與入口¶

側邊欄「面板導航」在 「自動化任務」正下方、「更多」上方 多出一行純文字 「黃金實時價格」（行內不塞價格，避免擠壓原生布局；懸停 tooltip 可帶 Au99.99 實時價與漲跌幅）。樣式複用 DSH 原生面板行的 CSS Module，與「插件 / 自動化任務」一致。點擊展開貼邊面板，標題同爲「黃金實時價格」，再點或按 Esc 收起；側邊欄完全收起時退化爲左下角金錠圖標按鈕。

每張卡片主視覺爲 26px 主價 + 漲跌膠囊（漲紅跌綠）+ 統計網格；左緣按校驗等級上色，右上角徽標區分：已交叉校驗、兩產品價差、兩源有差異、僅單源、疑似陳舊快照。面板頭部第三個按鈕（折線圖標）控制右側「Au99.99 走勢圖 + 黃金要聞」列，默認隱藏，顯隱記在 localStorage['dsh-gold-card:extras']。

四類報價與數據源¶

卡片展示數據源自帶的報價時間戳，不用本地抓取時刻頂替。單源失敗不拖垮其它卡片；失敗時回退上次成功數據並標註可能滯後。

可選：走勢、要聞與積存金持倉¶

展開右側列後面板可加寬到 780px（窄屏自動上下堆疊）。

1. Au99.99 走勢：東方財富 118.AU9999 日 K；主源不可用時用上金所日行情兜底。可在「本週 / 本月」間切換（僅重繪、不重新請求）。
2. 黃金要聞：北京時間每天抓一次，官方源（人民銀行、統計局、上金所、美聯儲等）與新浪財經貴金屬等排序後取前 3 條；當天無新增時保留原列表並標註「今日暫無新增資訊」。內容爲標題與鏈接聚合，不構成投資建議。
3. 積存金持倉：記錄在 localStorage['dsh-gold-card:positions']，不上傳；按渠道規則估算「當前贖回價一次性全部贖回」盈虧（工行贖回另計 0.5% 手續費等口徑見 README）。僅展開右側列後可見。

數據層要點（使用者可讀）¶

插件對多源價格做容差交叉校驗、溢價帶分產品類型、雙重反算與時間戳時效判斷，避免把「報價時點不同」一律標成陳舊。工行、建行服務端仍可能觸發 OpenSSL 3 / Node 18+ 的 legacy renegotiation 問題，實現裏對 HTTPS 請求使用 SSL_OP_LEGACY_SERVER_CONNECT，否則兩銀行源會同時失敗（證書校驗仍開啓）。

安裝與啓用¶

插件以當前 DSH 進程權限訪問外網與本地路由，安裝前請閱讀源碼與 MIT 許可證。DSH 生態偏「一切皆插件」；社區目錄（如 SkillHub）與 DeepSeek / 幻方無官方從屬關係，下面命令均來自倉庫 README。

方式一：插件市場索引（適合不手工拉倉庫）¶

1. 側邊欄 設置 → 插件 → 發現（Discover） → 索引源（Index sources） → 添加
2. 粘貼索引 URL：

https://raw.githubusercontent.com/ZCX26324/dsh-gold-card/main/market/index.json

3. 在「發現」頁找到「黃金實時價格」，點 安裝。DSH 默認「發現」頁無索引源，需先添加（官方設計）。

方式二：本地目錄 + CLI¶

在已有插件目錄絕對路徑的前提下：

dsh plugin --profile desktop add link:<本目錄絕對路徑>

方式三：install_bundle¶

在 DSH 中通過 Agent 或插件管理器執行：

plugin_manager install_bundle(target = "link:<目錄絕對路徑>")

裝好後¶

• Host 側路由與抓取 即時生效，一般無需重啓 DSH。
• 側邊欄入口需 刷新頁面（Ctrl+R）；個別老桌面殼若仍無入口，可重啓 DSH 一次（啓動時注入 index 快照）。
• 面板靜態資源 cache-control: no-store，改面板後刷新頁面即可。

典型用法與自檢¶

瀏覽器內：點側邊欄「黃金實時價格」→ 查看四卡片與徽標含義 → 需要走勢/要聞/持倉時點頭部的折線按鈕展開右列。

開發者 / 運維：倉庫內可用 npm 腳本驗證（四源冒煙需外網，CI 跑離線段）：

npm test            # 五段全跑（含真實四源連通）
npm run test:apply  # 離線：路由 / index 注入
npm run test:sources# 真實四源連通性

安裝後可在 Host 進程內訪問例如：

Windows 下可查看 %USERPROFILE%\.dsh\.dsh-gold-card.log，確認 route registered、index-inject verify、selfcheck quotes 等行。

適用場景與注意¶

適合在 DSH 桌面環境常駐盯 Au99.99、國際金價與工建積存金報價，並需要多源一致性提示的場景。資訊與持倉盈虧均爲參考，不含稅費、大額贖回限制等完整交易規則。

注意：數據來自公網行情接口，受交易時段、源站變更與網絡環境影響；插件 MIT 開源，維護者與 Star 數（目錄頁約 2 stars）反映社區規模，不保證商業 SLA。接入前請自行評估合規與風險偏好。

結尾¶

dsh-gold-card 把上金所、國際現貨與工建積存金報價收進 DSH 側邊欄一張面板，用交叉校驗和顯式時間戳減少「看錯價、看錯新舊」的概率。詳情與契約見倉庫 CONTRACT.md 與 README。

• 目錄頁：https://www.skillhub.cn/plugins/ZCX26324/dsh-gold-card
• GitHub：https://github.com/ZCX26324/dsh-gold-card