前言¶
在 DeepSeek Harness（DSH）里長時間寫代碼、跑智能體時，偶爾需要一塊不聯網、不佔真實資金的「換腦區」。社區裏已有各類知識庫、工具類插件；若你只想在本地用 K 線界面和固定規則對手打幾局模擬外匯，而不接行情 API、也不碰錢包，就需要一個純客戶端、零網絡的切磋型插件。下面介紹 dsh-fx-arena（包名 dsh-fx-arena，README 稱「FX戰士大肥魚」）的定位與用法。
這是什麼¶
dsh-fx-arena 由 koishi-fumo-code 維護，在 DSH 插件目錄中歸類爲客戶端。它把一局 FX 模擬對戰做進 DSH 左側面板：你和本地算法對手「大肥魚（鯨鯨）」共用同一條自生成價格流，比權益、比衝線，全程不聯網、不接真實行情、不涉及真實資金。宿主側 index.js 刻意空實現，遊戲邏輯全部在瀏覽器 bundle（client.js）裏完成。
核心功能¶
品種與記賬¶
遊戲內提供五個品種：EUR/TOKEN、GBP/TOKEN、TOKEN/JPY、黃金，以及鯨鯨自設幣對「鯨元/TOKEN」。統一按 1 token = $0.0001 折美元記賬（README 給出各品種與 token 的換算關係）。鯨元對上有彩蛋：對手永遠做多、不做空自己的幣；玩家做空或做多會觸發不同臺詞，一局結束後可切換品種。
賽制與規則¶
開局前可選，局中鎖定：
| 維度 | 選項 |
|---|---|
| 模式 | 計時賽（到點比權益）；重生之久留美歸來（初始 30 萬，先摸到 2000 萬贏，不限時，僅權益 < 0 算出局） |
| 槓桿 | 10x / 20x / 50x / 100x / 200x / 500x（默認 100x） |
| 時長 | 90s / 180s / 360s / 500s（僅計時賽；歸來模式計時顯示 ∞） |
計時賽強平：權益低於佔用保證金 × 15% 直接爆倉；計時賽權益地板爲 0，不允許倒欠。歸來模式雙方手數上限 50，鯨鯨用一半可用保證金複利滾倉衝線；面板顯示對數刻度衝線進度條（30 萬→2000 萬）。
界面與對手¶
入口在 DSH 左側圖標條（sidebar.panellist），點 K 線小圖標進入主面板（main）。面板含品種切換、Canvas 蠟燭圖（現價線、雙方開倉價線）、權益對比、手數與 BUY/SELL/平倉、鯨鯨彈幕、交易流水與局末結算。鯨鯨使用 EMA 快慢線交叉、每局方向偏好與隨機猶豫的本地算法，與玩家看同一價格流；不開大模型、零 API 成本。
後臺與戰績¶
對局狀態與 tick 放在模塊級引擎，切會話或其它面板不會停表；只有整頁刷新會重置。面板右上角「停止後臺」可清行情循環並凍結局面（不判輸贏）。歸來模式下玩家因負債出局會累計「空中飛人」次數（存 localStorage）。勝/負/平/傳說局與最大領先同樣記在瀏覽器 localStorage，不寫 DSH 數據目錄。
當前 package 版本 0.10.0，要求 DSH >= 0.1.7-rc.1、Node >= 22，許可證 MIT。
安裝與啓用¶
安裝器掃描 DSH_HOME（環境變量優先，否則 ~/.dsh）下所有帶 dsh.profile.bundles 的 profile，建立 node_modules 鏈接並在 package.json 登記 link: 依賴與 bundle；掛載寫在包內 cordis.patch.yml，用戶無需手寫 patch。裝完需重啓一次 DSH（bundles 在啓動時組合）。
Windows 可雙擊倉庫內 install.cmd；命令行等價如下（路徑以你解壓或拷貝後的插件目錄爲準，下文用 fx-arena 表示該目錄）：
node fx-arena/scripts/install.mjs # 自動檢測並安裝到所有 profile
node fx-arena/scripts/install.mjs --dry # 只預覽改什麼
node fx-arena/scripts/install.mjs --verify-only # 只自檢
macOS / Linux：
DSH_HOME=~/.dsh node scripts/install.mjs
（在插件根目錄下執行時，scripts/install.mjs 即安裝腳本路徑。）
卸載可在插件庫點「卸載」；兜底：
node fx-arena/scripts/uninstall.mjs --yes
安裝前建議自行閱讀倉庫源碼與 LICENSE；插件隨 DSH 客戶端在本地進程內運行，權限與當前 DSH 一致。
典型用法¶
- 按上一節完成安裝並重啓 DSH。
- 在左側圖標條打開「FX戰士大肥魚」面板。
- 選擇品種、模式、槓桿與（計時賽的）時長，開始切磋。
- 在 K 線圖上用 BUY/SELL/平倉與鯨鯨對戰；計時賽注意強平線，歸來模式注意負債出局與衝 2000 萬進度。
- 需要釋放 CPU 時點「停止後臺」；想新開一局再點「開始切磋」。
開發者可在不重啓 DSH 的情況下跑包內自檢（README 稱 217 條斷言，覆蓋 patch、bundle、整局冒煙等）：
node fx-arena/scripts/selftest.mjs
npm 腳本等價：npm test（在插件根目錄）。
適用場景與注意¶
適合：想在 DSH 裏本地練手速與規則感、需要短休息又不希望聯網或接實盤 API 的用戶；適合驗證客戶端 bundle 與 sidebar.panellist / main 槽位掛載是否正常。
注意（來自 README「已知邊界」）：
- 價格爲本地隨機遊走（GBM + 消息衝擊），不能替代真盤（無隔夜利息、滑點、新聞驅動等）。
- 鯨鯨是固定本地算法，不是 LLM。
- 若宿主槽位名變更，
client.js會嘗試掛到「設置 → FX戰士大肥魚」作爲退路。
DSH 社區插件目錄爲獨立站點 skillhub.cn 上的 dsh-fx-arena 頁，與 DeepSeek / 幻方無官方從屬關係；安裝來源以你信任的目錄頁或 GitHub 倉庫爲準。
結尾¶
dsh-fx-arena 把零網絡 FX 模擬對戰收進 DSH 客戶端：K 線、高槓杆計時賽或 30 萬衝 2000 萬的不限時模式、本地鯨鯨對手與可續跑的後臺引擎，都不碰真實資金。若要查看簡介與鏈出倉庫，可打開 插件目錄頁 或 GitHub：koishi-fumo-code/dsh-fx-arena。
