前言¶

在 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