前言¶
在 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。
