DeepSeek HarnessHub
Submit plugin

c-ling/dsh-plugin-goldboard ↗★ 4

dsh-plugin-goldboard

Gold price dashboard and intraday decision support for the DeepSeek Harness web GUI: versioned market-data facts, independent CMB/SGE/XAU calendars, durable CMB bid/ask history, fee-aware suggestions, exploratory replay diagnostics, and host system/webhook alerts. 适合关注黄金行情、需要日内参考和策略回放的投资研究用户。

Agent collaborationFinancial dataInterface extensions
Package
dsh-plugin-goldboard
Compatibility
Unverified
Version
1.14.0
License
MIT
Last updated
Sep 3, 2026

Install

This plugin has no verified bundle, or compatibility checks failed. Read the repository notes first. Read the full README ↗

README

Read the full README ↗

dsh-plugin-goldboard

English

DeepSeek Harness 黄金实时看板与策略诊断插件：Au99.99/XAU/CMB 行情、独立交易日历、招行双边历史、持仓建议与探索性回放。右上角可拖拽浮窗（可收起为小圆球），优先通过招商银行公开接口拉取积存金客户买卖价，接口不可用时回退为国际金价按汇率折算 + 固定价差估算；结合持仓/上限与手续费（默认买入 0 + 卖出 5 元/克）给出日内参考，并通过宿主机系统通知和 Webhook 在阈值穿越时提醒。

dsh-plugin topic license

本插件只提供技术面参考，不自动下单，不构成投资建议。

v1.11.0 执行、估值与回放 v5 的完成项/延期项见 策略优化说明。 v1.12.0 在策略统计明细中保留达到仓位上限等原因导致的未执行信号，并支持跨重启查看。 v1.13.0 完成阶段 0 证据与口径冻结：回放报告统一标记为“探索性诊断”，5 分钟模拟、真实/代理/未知双边覆盖、完整/部分交易日、成本假设和 control 版本均会随报告输出；当前没有已验证策略或真实业绩结论。 v1.14.0 完成阶段 1 数据与执行事实层：新增 market data v2、独立品种日历、长期 CMB 双边 point-in-time 历史、state v2 迁移/回滚、完整覆盖质量、统一执行证据和收紧后的公共接口；默认 RSI、ATR、仓位与提醒策略保持不变。

安装

从 GitHub 安装到 web profile（需要 pnpm 在 PATH 上；没有则用下面的 corepack 方式）：

npx @deepseek-ai/dsh plugin --profile web add "github:c-ling/dsh-plugin-goldboard#v1.14.0"

或使用已有的 dsh 命令：

dsh plugin --profile web add "github:c-ling/dsh-plugin-goldboard#v1.14.0"

pnpm 不在 PATH 上时：

cd ~/.dsh/profiles/web
corepack pnpm add "github:c-ling/dsh-plugin-goldboard#v1.14.0"

dsh plugin 把参数原样转发给 pnpm，直接从本仓库拉取包（pnpm 9+，本机需装有 git）。 安装时若看到 declares no dsh.bundle — installed as a plain dependency 的提示属正常现象： 本插件不是 profile bundle 层，而是通过下面的 loader 行激活。

然后在 ~/.dsh/profiles/web/cordis.patch.yml 增加一行插入：

- insert:
    - id: dsh-plugin-goldboard
      name: 'dsh-plugin-goldboard'

重启 dsh web（client-modules 按进程缓存包裁决，新包必须重启宿主），然后硬刷新页面。 右上角会出现黄金看板浮窗；设置页新增“黄金看板”。

验证

curl -s http://127.0.0.1:3080/plugins/dsh-plugin-goldboard/client.js | head -c 60

应输出 window.__ModuleLoader__.load({ 开头的 factory bundle。

curl -s http://127.0.0.1:3080/dsh-plugin-goldboard/snapshot

应返回 { ok: true, quotes: { AU9999, XAU, USDCNY, CMB }, quality: …, plan: … }；quotes.GCF 若存在表示独立的 COMEX 期货诊断口径。/replay-stats 新报告会额外返回 strategyVersion、calculationVersion、dataSchemaVersion、executionVersion、calendarVersion、evidenceStatus: "exploratory"、costAssumptions 和 real/proxy/unknown executionCoverage。

curl -s http://127.0.0.1:3080/dsh-plugin-goldboard/models
curl -s 'http://127.0.0.1:3080/dsh-plugin-goldboard/analysis-logs?limit=30'

模型目录来自 Harness 当前已注册 provider，日志查询只返回脱敏的结构化摘要；没有选定模型时不会发起模型调用。数据质量门控未通过时仍可手动调用模型，模型会以数据不足/过期/无效等状态说明限制。

更新

dsh plugin --profile web add "github:c-ling/dsh-plugin-goldboard#v1.14.0"
# 或：npx @deepseek-ai/dsh plugin --profile web add "github:c-ling/dsh-plugin-goldboard#v1.14.0"
# 或：cd ~/.dsh/profiles/web && corepack pnpm add "github:c-ling/dsh-plugin-goldboard#v1.14.0"

用新的 #v1.14.0 重新执行安装命令即可升级依赖；cordis.patch.yml 中的 loader 行保持不变。 重启 dsh web，然后硬刷新。

卸载

cd ~/.dsh/profiles/web
corepack pnpm remove dsh-plugin-goldboard
# 或：dsh plugin --profile web remove dsh-plugin-goldboard

同时删除 cordis.patch.yml 中对应的 insert 行，然后重启 dsh web。 本插件会保存状态，热缓存位于 $DSH_HOME/storages/dsh-plugin-goldboard/state.json，长期 CMB 双边历史按交易日追加到 history/*.jsonl；卸载后需手动清理整个目录。

功能

  • 右上角浮窗（头部/底部均可拖拽，位置锚定窗口边缘并随窗口缩放自动修正），可收起为小圆球；10 秒刷新（页面隐藏时 60 秒），时间按北京时间展示。
  • Au99.99（元/克）、XAU（美元/盎司）、USDCNY、国际金价折算元/克与内外价差。
  • 招行积存金价格：优先通过招行 mbmodule-openapi.paas.cmbchina.com 市场中心接口拉取实时客户买卖价（zBuyPrc / zSelPrc，客户买入=ask、客户卖出=bid）；接口不可用时回退为 国际金价按汇率折算 + 买/卖偏移。实时报价有效期间会分别采样 customerBuy-reference 与 customerSell-reference，样本充足时按双边中位数动态校准；v1.10 的单一中间价样本仍可读取，但明确标记为 legacy。新采集的 CMB K 线会同时持久化真实 ask/bid OHLC，旧单边历史不会伪装成真实双边数据。点击招行区域可查看自建折线图；昨收和手动补录行为保持不变。
  • 建议区域优先以招行积存金实时数据为准；信号道切换带粘滞保护——当前数据源需连续约 90 秒不可用才降级到下一优先道（国际金价折算 → Au99.99），恢复约 90 秒后才自动切回，避免接口抖动导致指标口径来回翻转；等待期间看板标注「信号源降级观察中」，确认降级时发送一次提醒。
  • 日内信号：买入信号参考 5/10/30/60 分钟数据——10/30/60 分钟 EMA20 一致向上做趋势过滤（10/30 分钟线由 5 分钟线重采样），5 分钟 RSI/支撑做入场时机；5/10 分钟窗口每分钟有效数据覆盖率必须 >80%，30/60 分钟窗口必须 >60% 才给出建议，任一时段数据有缺失时看板提示「当前数据有缺失，暂不给出建议」。覆盖投影同时记录有效样本分钟、最大缺口、距最近缺口、重锚状态和缺失桶；重锚后的短片段即使比例为 100%，UI 也会显示例如“有效 6/60 分钟”，不会冒充完整窗口。开盘后 1 小时内只校验 5/10 分钟窗口（30/60 分钟窗口开盘初期天然不足）；每天北京时间 0 点-1 点期间也同样只校验 5/10 分钟窗口。止盈、移动止盈、止损、走弱减仓提醒；收盘前强制平仓提示默认关闭（v1.9.0 起不固定倾向于日内了结），持仓在临近收盘时段继续按常规信号判断，需要收盘了结纪律时可在设置中开启「收盘前强制平仓提示」。策略按目标仓位区间（轻仓/标准/重仓）计算加减仓量，并加入同方向冷却、连续确认和信号强度显示；仓位变化只重置确认 streak，不再清空同向冷却时钟。浮窗「当前建议」模块会展示 5/10/30/60 分钟 EMA20/RSI/SMA/布林/ATR/MACD 数值及判定依据；指标名称旁的 ? 悬浮可查看含义与计算公式。
  • 多笔持仓：可按每次买入的克数/价格分批记录，自动汇总总克数与平均成本；回调企稳时给出补仓建议，冲高回落/超买走弱时给出减仓建议；补仓/减仓按目标仓位区间计算，并保留最小底仓，避免小仓位被反复清仓。
  • 统一执行账本：ask + 显式买入费 + 买入滑点 形成买入成本，bid - 显式卖出费 - 卖出滑点 形成卖出净额；真实 CMB 双边报价不再重复叠加估算点差，估算点差只用于缺少双边价的 synthetic fallback。回本、目标、止损、浮盈亏、回放和期末估值共享同一 module。默认配置仍为买入 0 + 卖出 5 元/克；该字段现在明确表示报价外显式费用，请按实际产品协议核对。
  • 挂单跟踪（v1.9.0 生命周期语义）：插件会记住最近一次已提醒的委托建议并进入「监控中」状态——建议后的同方向冷却转观望、连续确认中或数据短暂缺失，都只是继续等待成交，不会再反复提示撤单。只有出现实质性变化才会更新或撤销跟踪：方向相反的新信号、现价偏离原挂单价超过阈值（「挂单偏离撤单阈值」，默认 0.5%，可调）、挂单到期或休市清空，以及检测到仓位已朝建议方向变化（视为已成交，静默清除）。委托价格/克数发生实质变化（≥0.5 元/克）时发送“挂单已更新”提醒，微小重报只静默刷新有效期。同一挂单的同形改价有 10 分钟静默期（期间仅当相对上次通知价累计漂移 ≥3 元/克才立即再提醒），不会再被实时报价抖动刷屏。
  • 提醒：宿主机系统通知（macOS/Linux/Windows）+ 飞书/钉钉/企业微信/通用 Webhook；无冷却、无勿扰，交易时段内每次阈值穿越都提醒。通用 Webhook 的 Host 请求仅允许无凭据 HTTPS 公网目标，拒绝 loopback、私网、link-local、metadata 地址、危险 header 与重定向。另含 sell_weakness 和 spread_alert 两类保护性提示；提醒日志记录每个渠道的实际送达结果。
  • 交易时段：可编辑的工作日 09:00–次日 02:00 仅作为 CMB 提醒/执行规则；Au99.99 使用 SGE 日盘+夜盘 adapter，XAU/USD 使用独立 24x5 adapter。snapshot 与新 replay 报告保存实际 calendarVersion。
  • 配置存储（v1.6.0）：配置迁移到 Harness 统一设置（$DSH_HOME/settings.yaml 的 dsh-plugin-goldboard namespace），保存后立即生效、刷新与重启均保留；旧版 config.json 在升级后首次启动自动迁移并保留为 config.json.migrated 备份；无 settings 服务的环境自动回落原存储，功能不变。Webhook 签名密钥只写不回显，页面仅显示「已配置」徽标。
  • 中英文 UI，跟随「设置 → 通用 → 语言」；明暗主题使用 DSW 设计变量。
  • 技术口径审计：quote/bar 使用 goldboard-market-data-v2，带 sourceTimestamp/receivedAt/ingestedAt、source delay/future skew、品种、市场、货币、单位、质量和 real/synthetic/proxy/unknown 执行证据；compact 北京时间、epoch 秒/毫秒和 ISO 时间统一规范化。XAU 与 USDCNY 任一 stale 或 point-in-time future 都禁止 fallback 新开仓和历史污染。所有自然时间聚合缺子 K 或包含 partial 子 K 时，父桶保持 partial 并排除在正式指标之外；XAU 现货与 GC=F 期货严格分开。
  • 长期事实存储与源健康：HistoricalStore 按 CMB 交易日 append-only 保存 customer ask/bid、各侧来源和三类时间，稳定 event ID 去重并支持 as-of 查询；旧单边、手工和派生记录永久保留 proxy 身份。状态页显示源成功率、连续失败时长、P50/P95、可用备用源、执行证据比例、最后有效时刻和缺口。旧 state 首次升级前原字节备份并生成 hash manifest；损坏 state/历史分区隔离，支持显式回滚。
  • 公共接口：根入口只导出插件生命周期和稳定领域接口；./market-data、./execution、./history、./replay 提供领域入口，parser、bar 变异器、存储原语和 fetch 替换 hook 仅位于 ./testing。
  • 模型分析（手动触发）：从 Harness 当前可用的 provider/model 目录选择模型和 reasoning effort，不改变当前会话模型；模型只解释宿主指标和规则 plan，不能补造价格或生成买卖指令。即使数据质量门控未通过也可手动调用，模型需以数据不足/过期/无效等状态说明限制。设置页的「模型与分析」区域提供目录选择、「立即分析」和独立「查询日志」面板。
  • 分析查询日志：每次真实模型调用生成 queryId，记录 started/finished 生命周期、模型、行情快照、质量状态、输入 hash、结构化结果、usage 和错误；日志写入 $DSH_HOME/storages/dsh-plugin-goldboard/analysis-log.jsonl，支持脱敏详情、筛选、游标分页和孤儿 running 查询恢复。
  • 回放诊断（v1.14.0，基于 v1.13.0 阶段 0 / report v5）：默认只选已到配置收盘时点且数据到达时段尾部的完整交易日。策略在信号 K 收盘后只创建限价 pending order，最早从下一根完整 5 分钟 K 线判断 ask/bid 是否触及；未触及或超过 validUntil 记为 expired，不成交。同一 K 同触目标和止损时标记 ambiguousBar，默认按多头止损先到的保守路径，并报告最佳/最差区间。报告新增订单数、成交率、过期率、平均延迟、双触及数、真实/代理/未知 bid/ask 覆盖、成本假设与成本拆分、权益曲线和最大回撤，并冻结 control 策略、指标、market data v2、execution v2、所选 lane 的独立日历和 report 版本。报告明确 evidenceStatus: "exploratory"，并携带长期历史、OOS、真实双边、费用语义、基准和不确定性区间等验证准入门槛；这些门槛未满足前不称为验证结果。订单、fills 和兼容 trade 明细一并持久化。策略条件已确认但因连续账户达到最大克数而没有创建订单时，会另存为“未执行策略信号”，显示信号时间、价格、当时仓位/上限和原因，且不计入成交率、现金流或收益。独立信号表也先走同一 next-bar fill/expiry 判断，未成交建议只计决策/过期数，不进入目标、回本或时段净结果。v4 和阶段 0 之前的 v5 报告只读显示已有版本、窗口、参数和 caveat，不补字段、不重算、不与新口径比较。所有数字仍是 5 分钟数据上的探索性模拟诊断，不是实际成交或样本外业绩证据。

数据源

免费公开源，非官方接口，可能限流或变更：

  • Au99.99：新浪 gds_AU9999（主）→ 上金所 SGE graph/quotations → 东财 118.AU9999 → 60s API（备）
  • XAU 现货：腾讯/新浪 hf_XAU → gold-api.com → 60s API → GoldPrice.Today；Yahoo GC=F 仅作为单独标记的黄金期货诊断源，不替代现货
  • USDCNY：腾讯 whUSDCNY
  • 招行积存金：https://mbmodule-openapi.paas.cmbchina.com/product/v1/func/market-center（POST params=[{"prdType":"H","prdCode":""}]）
  • 品牌金价/积存金（状态页展示）：金投网 api.jijinhao.com、京东金融 api.jdjygold.com
  • Au99.99 K 线：东财 push2his.eastmoney.com（被限流时自动切换 push2delay.eastmoney.com 延迟镜像，仅取已收盘历史数据），历史可用上金所 graph/Dailyhq 兜底
  • XAU/USD 现货 K 线：东财 push2his.eastmoney.com；若源不可用则标记为数据不足，不把 Yahoo GC=F 期货历史改名为现货
  • GC=F 期货日线诊断：Yahoo Finance query1.finance.yahoo.com/v8/finance/chart/GC=F?interval=1d
  • XAU / 招行积存金分钟线：宿主以轮询报价自建

插件使用低频轮询、多源降级、本地缓存；看板标注数据是否过期。仅供个人参考，不用于分发。

免责声明

本插件输出均为技术面参考，不构成投资建议。黄金价格波动可能导致亏损，请自行决策并核实招行 App 实际报价。

License

MIT