前言¶
在 DeepSeek Harness（DSH）里做智能体或自动化工作流时，行情、持仓和风险往往散落在脚本、表格或临时 curl 里，和对话界面脱节。若你关心国内 Au99.99、国际 XAU 以及招商银行积存金双边报价，又希望在同一宿主内查看日内参考、回放诊断和本地风险估算，而不是另开一套独立交易系统，社区插件 dsh-plugin-goldboard 提供的是侧边栏入口 + 独立主面板页面，与 Harness Web / Desktop 共用认证与进程环境。
下面按定位、能力、安装与验证、典型用法和注意事项说明该插件；事实以 GitHub 仓库 README 为准。插件在 SkillHub 目录 归类为「联网工具」，维护者为 c-ling，当前包版本为 1.15.0（MIT 许可证）。
这是什么¶
dsh-plugin-goldboard 是 DeepSeek Harness 的「黄金实时看板与策略诊断」插件：通过侧边栏「黄金看板 / Gold Board」在主内容区打开独立页面，用六个 Tab（概览、交易、策略与回放、分析、数据、设置）承载 Au99.99 / XAU / CMB 行情、独立交易日历、招行双边历史、带风险约束的持仓建议，以及带数据集与 OOS 准入门槛的可复现回放。
README 明确说明：插件只提供技术面参考，不自动下单，不构成投资建议；live 侧默认策略始终为 control，实验层默认关闭。
核心功能¶
界面与数据刷新¶
- v1.15.0 起采用 0.2.1 侧边栏页面重构：
sidebar.panellist入口 +main独立页面；Host API 路由为/api/dsh-plugin-goldboard/...，配置落在插件私有config.json。旧的右上角浮窗与 Settings 内嵌页已移除。 - 页面约 10 秒刷新（隐藏时 60 秒），时间按北京时间展示；入口右侧可显示实时金价（国内 Au99.99、国际 XAU、招行积存金，可在「设置」Tab 选择）。
行情与招行积存金¶
- 展示 Au99.99（元/克）、XAU（美元/盎司）、USDCNY、国际金价折算元/克与内外价差。
- 招行积存金：优先通过招行
mbmodule-openapi.paas.cmbchina.com市场中心接口拉取客户买卖价（zBuyPrc/zSelPrc）；接口不可用时回退为国际金价按汇率折算加固定价差估算。样本充足时可按双边中位数动态校准；新采集的 CMB K 线持久化真实 ask/bid OHLC。
日内建议与信号源¶
- 建议区域优先以招行积存金实时数据为准；信号道切换带粘滞（约 90 秒不可用才降级，约 90 秒恢复才切回），避免接口抖动导致口径翻转。
- 日内信号基于 5/10/30/60 分钟数据：EMA20 趋势过滤、5 分钟 RSI/支撑等；各窗口有数据覆盖率门槛，不足时看板提示暂不给出建议。默认手续费假设为买入 0、卖出 5 元/克（可在交易相关配置中调整语义见 README）。
- 支持多笔持仓分批记录、目标仓位区间加减仓、止盈/移动止盈/止损等；可选目标回撤止盈、日线 EMA20 趋势闸门、武装前时间止损等（多为 opt-in，默认关闭或保持 control 行为）。
风险、回放与实验¶
- 阶段 2：默认
fixed_grams；可选budget模式及日/周/回撤等闸门；参考权益与 ledger 损益为本地风险估算，非真实账户流水。 - 阶段 3：ReplaySimulator 与 report v6（as-of、dataset/input/report fingerprint、walk-forward folds、风险调整指标与基准等）；历史不足或覆盖/费用语义未核实时 Host 强制保留
exploratory，不展示「已验证策略」。 - 阶段 4：策略实验层（契约、control adapter、ORB 等）默认关闭；
promotion.liveStrategyChanged恒为 false。
提醒与分析¶
- 阈值穿越时可通过宿主机系统通知与 Webhook 提醒。
- 「分析」Tab 使用 Harness 当前注册的模型 provider；未选定模型时不发起模型调用。分析日志经脱敏接口查询。
安装与启用¶
目标运行时 DeepSeek Harness 0.2.1+（Web 与 Desktop）。包声明 dsh.bundle，推荐 bundle 安装；当前 README 将 GitHub 安装 pin 到 #v1.15.0（回退旧浮窗可用 #v1.14.0）。
Web（bundle，推荐）¶
在终端执行下列命令之一，会把包加入 profile 的 dsh.profile.bundles，并由 cordis.patch.yml 插入 loader 行，无需再手写同一条 loader。
dsh plugin --profile web add "github:c-ling/dsh-plugin-goldboard#v1.15.0"
# 或
npx @deepseek-ai/dsh plugin --profile web add "github:c-ling/dsh-plugin-goldboard#v1.15.0"
Desktop（bundle）¶
使用 Desktop 自带 CLI（npx @deepseek-ai/dsh 对 --profile desktop 会拒绝）：
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
plugin --profile desktop add "github:c-ling/dsh-plugin-goldboard#v1.15.0"
也可在退出 App 后，于 Plugins 页面安装 GitHub tag 或本地路径。
重启与入口¶
安装或更新后重启宿主（Web 重启 dsh web；Desktop 退出并重新打开 App），并硬刷新页面。client-modules 按进程缓存包裁决，不重启新 bundle 不会生效。侧边栏出现「黄金看板」后，在主内容区打开上述六个 Tab。
典型用法与验证¶
GUI 自检¶
在已登录 GUI 中打开侧边栏「黄金看板」，确认页面能加载行情与建议、Tab 可切换、各 Tab 独立保存的配置重启后仍保留，且控制台无 slot entry crashed。
HTTP 探针（需替换端口）¶
下列 curl 用于区分新旧路由；401 仅表示请求到达认证桥，不能单独证明业务路由可用，完整能力仍以 GUI 为准。
curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:<port>/api/dsh-plugin-goldboard/snapshot
curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:<port>/dsh-plugin-goldboard/snapshot
# 后者 404 表示旧匿名 webServer 路由已移除
主要 API（均需认证，路径含 /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 返回行情、质量、风险、ledger、plan 等聚合字段；回放统计见 /replay-stats（report v6 结构见 README）。策略实验经 GET/POST /api/dsh-plugin-goldboard/strategy-experiments，且需先在「策略与回放」保存实验配置后 POST 才接受。
更新与卸载¶
更新时重新执行对应 profile 的安装命令，再重启并硬刷新。卸载示例：
dsh plugin --profile web remove dsh-plugin-goldboard
状态与配置位于 $DSH_HOME/storages/dsh-plugin-goldboard/（含 config.json、state.json、history/*.jsonl、replay-reports/ 等）；卸载后若要彻底清理需手动删除该目录。
适用场景与注意¶
适合谁：已在 DSH Web 或 Desktop 上工作、需要把黄金多品种报价、日内技术面参考、本地持仓与风险闸门、探索性回放与实验矩阵放在同一宿主内的开发者或自用场景；需要招行双边或 Au99.99/XAU 对照时，数据与健康度 Tab 便于排查源与覆盖。
务必注意：
- 插件以 当前 dsh 进程权限 运行，会访问公开行情接口与本地存储；安装前请阅读 源码与 LICENSE，并理解 MIT 条款。
- 联网拉取行情与 Webhook/系统通知涉及出站请求；在受控环境中应评估合规与密钥存放方式（Webhook 在「设置」Tab 配置）。
- 回放与实验报告在证据不足时统一标记为探索性诊断；README 写明当前没有已验证策略或真实业绩结论，勿将 UI 参考当作投资建议或自动交易指令。
SkillHub 为社区插件目录站点，与 DeepSeek / 幻方无官方从属关系；安装来源以你信任的 GitHub tag 与本地 profile 为准。
结尾¶
dsh-plugin-goldboard 把黄金行情、日内建议、风险估算、回放诊断和可选策略实验收敛到 DSH 侧边栏的一条入口里，并与 v1.15.0 的 bundle / 侧边栏主面板形态对齐。若要浏览简介或跳转仓库，可使用目录页 skillhub.cn/plugins/c-ling/dsh-plugin-goldboard 与 github.com/c-ling/dsh-plugin-goldboard。
