dsh-plugin-goldboard
面向 DeepSeek Harness Web and Desktop 的黄金仪表盘和日内决策支持：侧边栏中的 Gold Board 页面，包含报价、计划/风险面板、回放诊断、隔离的策略实验、模型分析、数据源健康状态和设置。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:c-ling/dsh-plugin-goldboard#5eda00d6a86ad713cb9fe6253502b2585cf7a2c2Plugin Goldboard 以 dsh-plugin-goldboard 发布，当前版本为 1.15.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness 黄金实时看板与策略诊断插件（Web 与 Desktop）：侧边栏「黄金看板」入口打开独立主面板页面，用「概览 / 交易 / 策略与回放 / 分析 / 数据 / 设置」六个 Tab 承载 Au99.99/XAU/CMB 行情、独立交易日历、招行双边历史、风险约束的持仓建议，以及带数据集/OOS 准入门槛的可复现回放。优先通过招商银行公开接口拉取积存金客户买卖价，接口不可用时回退为国际金价按汇率折算 + 固定价差估算；结合持仓/上限与手续费（默认买入 0 + 卖出 5 元/克）给出日内参考，并通过宿主机系统通知和 Webhook 在阈值穿越时提醒。
本插件只提供技术面参考，不自动下单，不构成投资建议。
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、仓位与提醒策略保持不变。 v1.15.0 发布阶段 2/3/4、0.2.1 侧边栏页面重构，以及目标回撤止盈、日线 EMA20 趋势闸门、武装前时间止损、按卖出价推导手续费和持仓重置/信号账本弹窗等交易能力；默认仍为固定克数与 control。 v1.15.0 包含阶段 2 风险闸门与订单生命周期：默认仍为
fixed_grams；可选budget模式、日/周/回撤与加仓闸门、stable setup/decision/order ID、state v3 和只读信号账本已实现。参考权益与 ledger 损益都只是本地风险估算，不是真实账户余额或流水。 v1.15.0 包含阶段 3 ReplaySimulator 与长期验证框架：report v6 固定 as-of、dataset/input/report fingerprint，按月生成 6+1 walk-forward folds，并报告风险调整指标、Wilson/block-bootstrap 区间和四类同口径基准。实际历史不足 12 个月、真实双边覆盖不足或费用语义未核实时，Host 会强制保留exploratory，不显示“已验证策略”。 v1.15.0 包含阶段 4 策略实验层：正式策略契约/注册表、control adapter、ORB 趋势回调状态机、趋势/震荡/高波动标签、point-in-time 因子契约、隔离的策略/lane/消融/参数/成本矩阵和 fail-closed 晋级报告。实验默认关闭，live 始终固定control；缺少 XAU+USDCNY 点时联合数据的场景明确为 unavailable，统计/ML/DRL 只登记未运行能力，不伪造训练结果。 v1.15.0 同时完成 0.2.1 侧边栏页面重构：移除右上角浮窗与 Settings 页面，改为sidebar.panellist入口 +main独立页面；Host 路由迁移到/api/dsh-plugin-goldboard/...，配置回到插件私有config.json。安装命令统一 pin 到#v1.15.1；v1.14.0仅用于回退旧浮窗版本。 v1.15.1 修复今日走势图：白盘不再丢弃当天00:00–02:00的分钟线（此前该区间只剩一条由昨收锚点连成的假折线），>5 分钟断开模式下孤立分钟改为圆点而不是被丢弃；跨零点时段（昨晚 + 今晨）行为不变。
目标运行时 DeepSeek Harness 0.2.1+（Web 与 Desktop）。本包声明 dsh.bundle，推荐按 bundle 安装。
版本提示：从 v1.15.0 起，GitHub 安装即得到侧边栏页面 + bundle 形态（无需手写 loader 行）；
v1.14.0仍是旧浮窗版本，仅用于回退。
dsh plugin --profile web add "github:c-ling/dsh-plugin-goldboard#v1.15.1"
# 或
npx @deepseek-ai/dsh plugin --profile web add "github:c-ling/dsh-plugin-goldboard#v1.15.1"
dsh plugin 会把包加入 profile 的 dsh.profile.bundles，cordis.patch.yml 负责插入 loader 行；不要再手写同一条 loader 行。
使用 Desktop 自带 CLI（--profile desktop 由 Desktop App 管理，npx @deepseek-ai/dsh 会拒绝）：
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
plugin --profile desktop add "github:c-ling/dsh-plugin-goldboard#v1.15.1"
也可以退出 App 后，在 Plugins 页面安装本地路径或 GitHub tag。
cd ~/.dsh/profiles/web
corepack pnpm add "github:c-ling/dsh-plugin-goldboard#v1.15.1"
然后在 ~/.dsh/profiles/web/cordis.patch.yml 增加：
- insert:
- id: dsh-plugin-goldboard
name: 'dsh-plugin-goldboard'
手动模式不要再把包加入 dsh.profile.bundles，否则会重复激活。
本地开发验证也可以直接安装绝对路径（Web）：
dsh plugin --profile web add "link:/absolute/path/to/dsh-plugin-goldboard"
Desktop 使用同一 link: 形式调用自带 CLI，或从 Plugins 页面选择本地目录。
安装/更新后重启宿主（Web 重启 dsh web；Desktop 退出并重新打开 App），然后硬刷新页面。client-modules 按进程缓存包裁决，新 bundle 不重启不会生效。
侧边栏会出现「黄金看板 / Gold Board」入口；点击后在主内容区打开独立页面，包含：
每个可配置 Tab 有独立的保存按钮，只提交本 Tab 的配置节；未保存的修改在 Tab 间保留。页面只滚动 Tab 内容区，页头与 Tab 栏固定。旧的「右上角浮窗」和 Settings 中的「黄金看板」页面已移除。
curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:<port>/api/dsh-plugin-goldboard/snapshot
# 401 = 请求已到达 /api 认证桥；不能据此证明路由存在，需在已认证 GUI 中验证
curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:<port>/dsh-plugin-goldboard/snapshot
# 404 = 旧的匿名 webServer 路由已移除
在已登录 GUI 打开侧边栏「黄金看板」，确认：
slot entry crashed；主要端点（均需认证，路径包含 /api）：
curl -s 'http://127.0.0.1:<port>/api/dsh-plugin-goldboard/snapshot'
curl -s 'http://127.0.0.1:<port>/api/dsh-plugin-goldboard/ledger?limit=20'
curl -s 'http://127.0.0.1:<port>/api/dsh-plugin-goldboard/strategies'
curl -s 'http://127.0.0.1:<port>/api/dsh-plugin-goldboard/replay-reports'
/snapshot 返回 { ok: true, quotes: { AU9999, XAU, USDCNY, CMB }, quality, risk, ledger, plan }；/replay-stats 的 report v6 返回 asOf、dataset、inputFingerprint、reportFingerprint、metrics、oos、benchmarks、real/proxy/unknown groups 和 Host 派生的 validationGate。GET /replay-stats?reportId=…&detail=true 可按 ID 跨重启查询不可变报告明细。
GET/POST /api/dsh-plugin-goldboard/strategy-experiments 读取或显式运行隔离实验矩阵；POST 只有先在「策略与回放」保存实验配置后才接受，报告始终包含 promotion.liveStrategyChanged:false。
GET /api/dsh-plugin-goldboard/analysis 返回最近分析状态，GET /api/dsh-plugin-goldboard/analysis-logs?limit=30 返回脱敏日志；模型目录来自 Harness 当前注册的 provider，没有选定模型时不会发起模型调用。
bundle 模式重新执行安装命令即可：
dsh plugin --profile web add "github:c-ling/dsh-plugin-goldboard#v1.15.1"
# 或 Desktop：
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
plugin --profile desktop add "github:c-ling/dsh-plugin-goldboard#v1.15.1"
更新后重启宿主并硬刷新。手动模式需要重新 corepack pnpm add，loader 行保持不变。
当前 pin 指向 v1.15.0；如需回退旧浮窗版本，可显式使用 v1.14.0。
dsh plugin --profile web remove dsh-plugin-goldboard
# Desktop：
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
plugin --profile desktop remove dsh-plugin-goldboard
bundle 模式会同时从 dsh.profile.bundles 和 patch 层移除，不需要手动删 loader 行。状态和配置位于 $DSH_HOME/storages/dsh-plugin-goldboard/（config.json、state.json、history/*.jsonl、replay-reports/ 等）；卸载后如需彻底清理，请手动删除该目录。
mbmodule-openapi.paas.cmbchina.com 市场中心接口拉取实时客户买卖价（zBuyPrc / zSelPrc，客户买入=ask、客户卖出=bid）；接口不可用时回退为 国际金价按汇率折算 + 买/卖偏移。实时报价有效期间会分别采样 customerBuy-reference 与 customerSell-reference，样本充足时按双边中位数动态校准；v1.10 的单一中间价样本仍可读取，但明确标记为 legacy。新采集的 CMB K 线会同时持久化真实 ask/bid OHLC，旧单边历史不会伪装成真实双边数据。点击招行卡片可切换到自建折线图；昨收和手动补录行为保持不变。strategy.targetTrailPerGram > 0 时，触达目标只「武装」不卖出，价格从峰值回撤该元/克才输出 sell_target_trail；targetPartialRatio 可选首触目标先卖一部分，targetTrailBars 控制未创新高时的最长观察 K 线数。strategy.requirePriceAboveEma60 开启后，买点还额外要求现价高于 60 分钟 EMA20；strategy.requireDailyUptrend 再要求最近一根已收盘日线收盘价高于日线 EMA20 且 EMA20 上行，用于过滤下跌趋势中的逆势做多。strategy.maxBarsBeforeTarget > 0 时，持仓满 N 根已收盘 5m K 线仍未触目标会输出 sell_time_stop（武装前时间止损）；它和 targetTrailBars 的武装后超时是两套规则。这些开关都只影响买入/持仓退出，不影响止损与收盘保护。fixed_grams 保留原分档克数；opt-in budget 以 max(ATR×倍数, bid/ask 缓冲, 滑点缓冲) + 执行成本 计算每克最坏风险，再与最大克数、名义金额、单笔风险、日/周损失、回撤、流动性和 add 次数取最小约束。所有新增数值闸门为 0 时关闭；闸门只阻止新增买入，观察状态和保护性卖出仍可用。建议单显示名义金额、止损距离、每克风险、最坏情景亏损与参考权益占比；referenceEquityCny 不代表账户余额。setupId/decisionId，重复轮询幂等；订单保留 pending/filled/expired/replaced 轨迹，受阻断信号保存为 not_executed decision 且不创建 order/fill。用户持仓变化与唯一 pending 建议的方向及克数精确匹配时，才以 user_position_confirmation 记录推断成交；partial、超额或无法归因的编辑只记 adjustment。「策略与回放」Tab 可查看有界明细，state v3 恢复 add 计数、损失、cooldown 与 pending 轨迹。免费公开源，非官方接口，可能限流或变更：
gds_AU9999（主）→ 上金所 SGE graph/quotations → 东财 118.AU9999 → 60s API（备）hf_XAU → gold-api.com → 60s API → GoldPrice.Today；Yahoo GC=F 仅作为单独标记的黄金期货诊断源，不替代现货whUSDCNYhttps://mbmodule-openapi.paas.cmbchina.com/product/v1/func/market-center（POST params=[{"prdType":"H","prdCode":""}]）api.jijinhao.com、京东金融 api.jdjygold.compush2his.eastmoney.com（被限流时自动切换 push2delay.eastmoney.com 延迟镜像，仅取已收盘历史数据），历史可用上金所 graph/Dailyhq 兜底push2his.eastmoney.com；若源不可用则标记为数据不足，不把 Yahoo GC=F 期货历史改名为现货query1.finance.yahoo.com/v8/finance/chart/GC=F?interval=1d插件使用低频轮询、多源降级、本地缓存；看板标注数据是否过期。仅供个人参考，不用于分发。
本插件输出均为技术面参考，不构成投资建议。黄金价格波动可能导致亏损，请自行决策并核实招行 App 实际报价。
ask + 显式买入费 + 买入滑点 形成买入成本，bid - 显式卖出费 - 卖出滑点 形成卖出净额；真实 CMB 双边报价不再重复叠加估算点差，估算点差只用于缺少双边价的 synthetic fallback。回本、目标、止损、浮盈亏、回放和期末估值共享同一 module。默认配置仍为买入 0 + 卖出 5 元/克；该字段现在明确表示报价外显式费用，请按实际产品协议核对。若产品的卖出价已含手续费、且希望由配置费决定价差，可开启 cmb.deriveSellFromFee：卖出价 = 实时买入价 − 配置卖出费，执行/风控/账本/回放只计一次；派生价与实时卖出价偏离 ≥0.5 元/克时给出 configured_spread_drift 提示。默认关闭。sell_weakness 和 spread_alert 两类保护性提示；提醒日志记录每个渠道的实际送达结果。calendarVersion。$DSH_HOME/storages/dsh-plugin-goldboard/config.json；页面保存使用 revision / expectedRevision 冲突保护，文件权限 0600。旧版 config.json.migrated 在首次启动时导入为新的 config.json（保留备份）；已有 config.json 永远优先。Webhook 签名密钥只写不回显，页面仅显示「已配置」徽标。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 身份。「数据」Tab 显示源成功率、连续失败时长、P50/P95、可用备用源、执行证据比例、最后有效时刻和缺口。旧 state 首次升级前原字节备份并生成 hash manifest；损坏 state/历史分区隔离，支持显式回滚。./market-data、./execution、./risk、./ledger、./history、./replay、./strategy、./experiments、./factors 提供领域入口，parser、bar 变异器、存储原语和 fetch 替换 hook 仅位于 ./testing。queryId，记录 started/finished 生命周期、模型、行情快照、质量状态、输入 hash、结构化结果、usage 和错误；日志写入 $DSH_HOME/storages/dsh-plugin-goldboard/analysis-log.jsonl，支持脱敏详情、筛选、游标分页和孤儿 running 查询恢复。next-bar-limit 不允许信号 K 自成交，未触价不成交，同 K 双触及按策略保留 ambiguous/unknown 或保守路径。显式 asOf 同时约束已收盘 frame 与历史记录的 source/ingested 时间；每份报告保存 dataset、input 和 report SHA-256 fingerprint。CMB 优先读取 HistoricalStore point-in-time 记录并保留 real/proxy/unknown 身份，滚动 bars 只是短窗 fallback。长期模式按月建立 6 个月训练 + 1 个月测试 folds，测试参数冻结，并按 fold 保存样本数与区间；报告同时列出暴露、资金使用率、turnover、profit factor、Sharpe/Sortino/Calmar、Wilson 胜率区间、seeded moving-block bootstrap 收益区间，以及不交易、买入持有、固定节奏定投、简单均线四类同执行口径基准。报告与 events/orders/fills/ledger/unexecuted 明细进入不可变有界 registry，可按 ID 跨重启查询；replay-stats.json 继续作为最近报告兼容投影。v4/v5 原样只读，不补字段、不重算。少于 12 个月、多折 OOS 未完成、存在 proxy/unknown、费用未核实、基准/区间不完整或 session 不完整时，Host 强制 evidenceStatus:"exploratory"；当前没有可据此调整真实仓位的验证结论。StrategyRegistry 注册固定 control 与 replay-only orb-trend-pullback；统一 evaluate interface 和显式 descriptor/adapter fingerprint 进入模拟输入。ORB 用 observing/armed/triggered/expired 状态机并记录 setup、regime 和压制原因；因子契约按 observation/release/first-available/vintage/tradable-after/ingested-at 做 point-in-time 选择，缺失或过期时统一 hold。独立实验报告展开 signal lane、成本倍率、参数倍率和消融场景，比较 control 并由 OOS/成本/基准证据 fail-closed 判定晋级；任何报告都不会修改 live control。XAU lane 在 XAU 与 USDCNY 历史不能共同证明时只返回 unavailable。