前言¶
在 DeepSeek Harness（DSH）里做联网相关开发时，经常需要对照合约行情：最新价、多周期 K 线、简单均线，而不是反复打开交易所网页或自己写一遍 OKX 公开接口代理。社区插件 dsh-btc-dashboard（仓库 altmanWang/dsh_plugin_btc_dashboard）把 OKX 永续的只读行情嵌进宿主侧边栏和全屏看板，并在同一 npm 包里附带可 CLI、也可在看板里触发的回测框架。下面介绍它是什么、能做什么、如何安装与典型用法。
这是什么¶
维护者 altmanWang 的 DSH 插件，npm 包名 dsh-btc-dashboard，分类属于联网工具（社区目录：SkillHub 条目）。它解决两类问题：一是在浏览器宿主里稳定查看 BTC-USDT-SWAP / ETH-USDT-SWAP 的公开 ticker 与 K 线；二是在相同数据源与费率假设下，用仓库内 backtest/ 做历史策略验证（看板内面板或命令行）。
插件只读 OKX 公开行情（ticker / candles），不发私有请求；账户与持仓相关逻辑已从工程中移除。可选 .env 仅用于面板展示「当前生产/模拟环境配了哪把钥匙」的掩码，不配密钥也能正常看行情。
核心功能¶
看板与交互¶
侧边栏底部增加带实时价与涨跌幅的入口，点开为全屏看板。面板顶部可用 BTC / ETH 分段切换合约（选择记在浏览器 localStorage），切换后 K 线、价格、均线、画线、预警与回测默认标的一并跟随。
- 周期：
1m / 3m / 15m / 1h / 4h / 1D六档可切；默认 EMA20 / EMA480 双均线，周期与条数可在「均线管理」中增删改，配置存localStorage；均线在浏览器侧按整条序列（含预热）现算，拖动或改周期即时重算。 - 图表：拖动平移、滚轮缩放、双击复位、按住轴拖动缩放；跟随最新时有当前价水平线与收盘倒计时，未收盘 K 线单独描边；时间刻度对齐整点并带纵向网格。
- 画线：直线、斐波那契、尺子（端点可吸附 OHLC）；画线数据存浏览器
localStorage，不写插件工作区目录。 - 键盘：
←/→平移，Ctrl+↑/↓缩放，Alt+R回最新，1–6切周期。 - 环境：生产 / 模拟可切换；插件持久化选择写在
.dashboard/state.json（仓库示例里该路径被 gitignore）。
收线预警（可选通道）¶
K 线收线后，收盘价上穿/下穿指定均线时可 toast、价格行常驻条、桌面通知（需授权）、提示音（WebAudio，需先与页面交互）。邮件走可选插件 dsh-qq-email 的宿主服务 ctx.qqEmail：不装邮件插件时看板照常启动；要用邮件时按预警面板提示在「插件 → 发现 / Discover」安装并重启宿主。判定引擎挂在 shell.overlay，关闭看板后仍可常驻执行；规则与记录存 localStorage。
回测¶
backtest/ 与看板同包发布（零第三方 npm 依赖）。看板工具条「回测」可选标的（BTC / ETH 白名单）、策略、周期、区间、资金、杠杆、费率，面板内看 KPI、资金曲线与交易明细，并可打开完整 HTML 报告；K 线缓存与报告默认写到工作区 .dashboard/backtest/（首次运行会联网拉历史数据）。
CLI 入口为 backtest/run.mjs，支持 --strategy、--start、--end、--bar、--leverage、--maker、--taker 等；默认标的 BTC-USDT-SWAP，--inst ETH-USDT-SWAP 可回测 ETH；周期含 1m / 3m / 5m / 15m / 1h / 4h / 1D（默认 1h）。杠杆默认 1 倍；手续费默认挂单 maker 0.0200%、吃单 taker 0.0500%（可用参数覆盖）。1.7.0 起回测默认计入资金费率（8 小时结算；更早区间 OKX 历史有限时按文档说明估算并在报告标注）。
内置策略示例包括 buy-hold、sma-cross、multi-tf-dual、adaptive-dual、breakout-hold 等，详见仓库 backtest/README.md 与 backtest/strategies/。
安装与启用¶
发布到 npm 后，在对应 profile 下安装并重启该 profile，浏览器刷新页面：
dsh plugin --profile web add dsh-btc-dashboard
# --profile 换成你的 profile 名（如 web）
也可从 GitHub 源码安装（仓库根即包根，backtest/ 会一并带上）：
dsh plugin --profile web add "github:altmanWang/dsh_plugin_btc_dashboard"
可选：将 .env.example 复制为 .env 填写 OKX 密钥，仅影响面板「配了哪把钥匙」的展示，不影响只读行情。
卸载：
dsh plugin --profile web remove dsh-btc-dashboard
包清单当前版本为 1.8.1（MIT 许可证），Host 半有改动时需重启 DSH 宿主；仅改客户端半时刷新页面即可。本地开发时须把仓库根链进 profile，不要只指向 plugin/dsh-btc-dashboard，否则 backtest/ 不会随包链接。
典型用法¶
安装后日常使用¶
- 安装并重启 profile，打开 DSH Web 宿主，刷新页面。
- 点侧边栏底部看板入口，选择 BTC 或 ETH，切换
1m–1D周期查看 K 线与均线。 - 需要历史验证时，打开工具条「回测」，选策略与区间运行；产物与缓存落在工作区
.dashboard/backtest/。
命令行回测示例¶
在插件包根目录（或 clone 后的仓库根）执行：
# 4h 多空主策略示例（参数与区间按 README 说明）
node backtest/run.mjs --strategy multi-tf-dual --bar 4h --start 2020-01-01 --end now
# ETH 永续
node backtest/run.mjs --strategy adaptive-dual --bar 1D --start 2020-01-01 --end now --inst ETH-USDT-SWAP
同一段区间第二次回测会复用 backtest/data/ 缓存；需要完全离线时可查 README 中的 --offline / --data 用法。
适用场景与注意¶
适合：在 DSH Web 宿主里做合约相关对话、脚本或策略讨论时，需要内嵌 OKX 永续公开行情与简单技术分析工具；需要在同一数据源假设下快速跑回测、对照看板 K 线。
注意：
- 插件以当前 DSH 进程权限运行，安装前请自行审阅 GitHub 源码 与 MIT 许可证，确认可接受其联网行为（仅 OKX 公开接口）。
- 回测结果为研究工具输出，README 中给出的历史绩效数字来自作者本地运行示例，不构成投资建议；实盘还需自行核对费率、滑点与资金费率数据可用区间。
- 社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系，属 DSH「一切皆插件」生态的独立收录站点。
结尾¶
dsh-btc-dashboard 把 OKX BTC/ETH 永续的只读看板、画线、收线预警（含可选邮件通道）与 backtest/ 回测收进一个 DSH 插件包，适合在宿主内一站式对照行情与历史策略。目录页：https://www.skillhub.cn/plugins/altmanWang/dsh_plugin_btc_dashboard；源码与完整参数说明：https://github.com/altmanWang/dsh_plugin_btc_dashboard。
