mars-tw / jev-trading-command-center

# JEV Trading Command Center
A paper-trading research application with TypeSafe Jev decisions, an animated 3D command center, model pets, a responsive ten-timeframe research panel, an owner-authenticated remote view, and a local offline demo. The application is open source; the Jev model and external provider services are not included.
這是 **JEV 整合程式的開源版**：保留環狀 3D 首頁、沿線移動的多視角寵物、模型／任務標籤與決策流程。所有交易由程式內的 PaperBroker 模擬，沒有交易所私有下單功能。
## 新版實錄：桌面與手機
兩支皆錄自 **v0.3 新版介面**，附原創配樂。畫面中的標的、帳戶、決策及模型工作都是合成 DEMO；沒有拍攝私人登入、API 金鑰或真實交易資料。
### 桌面版 · 44.6 秒
https://github.com/user-attachments/assets/5d10386f-13b8-4de7-9b45-ede341cc5d9c
下載桌面 MP4 · 查看桌面預覽圖
### 手機版 · 39.2 秒
https://github.com/user-attachments/assets/d82f5742-44ed-4aba-9e67-5a782c4582b2
下載手機 MP4 · 查看手機預覽圖
手機影片是 390×844 響應式瀏覽器實錄，包含完整模型夥伴面板及週期指標卡。影片展示介面操作，不代表模型實際推論、策略績效或實機手機驗收。
下載 v0.3.0 原始碼與影片 · 錄影與素材來源
## 先開啟離線展示
需要 Python 3.11 或更新版本，以及支援 WebGL 的瀏覽器。DEMO 不需要安裝 Python 套件、API 金鑰、原生 AI CLI 或連網；Three.js 已隨程式附上。
 [code] 
Windows 也可使用 `py -3 -B run_app.py --demo --port 8765`。接著開啟 ，按 `Ctrl+C` 結束服務。這個服務維持 loopback，不要直接公開到 Internet。
沒有參數時預設也是離線 DEMO。可以先執行不開服務的自我檢查：
 [code] 
**DEMO 畫面上的行情、帳戶、損益、JEV 回覆與代理工作全部是合成資料。** `DEMO PASS`、`DEMO WAIT`、`DEMO 風控拒絕` 和 `DEMO 自動輪播` 只切換示範情境，不呼叫模型、不啟動原生 CLI，也不送出真實委託。錄影使用的就是這個模式。
## 介面
新版預設為立體星環，可切換組織圖，並以拖曳、滾輪或雙指調整視角。M1 與策略實驗室均為唯讀檢視：缺少或過期的外部狀態會標示不可用；本版不附帶研究生產器、私人 runtime 或績效承諾。
- 原有 3D 核心、行情清單、決策回執、風控、模擬持倉及事件流。
- 每隻寵物有模型／實例名稱與目前工作；工作、待命、冷卻、離線分開呈現。
- 正面、左右側面與背面，四幀走路步態及工作道具。角色沿原路線移動，支援暫停與恢復。
- 只有執行回執才呈現通過；WAIT、風控拒絕及缺少決策分開顯示。模型 confidence 不是勝率。
- 桌面顯示角色旁的任務卡；窄螢幕保留核心，下方另列可讀的任務標籤。
- 「多週期研究」是原核心之外的可收合面板，固定呈現 5m、15m、30m、45m、1h、2h、4h、8h、16h、1d 共十張卡；60 分鐘與 1 小時共用同一張卡，1d 顯示為 24 小時。
- 每張週期卡分別標示來源、實際／預期 as-of、最後已收盤 bar、coverage、資料與快取 stale 狀態，以及有限值的 EMA、MACD、RSI、ATR、趨勢、突破與型態。缺最新 bar、資料不完整或格式無效時不補造指標，也不產生決策。
- DEMO 只可明確選擇 `DEMO1USDT` 至 `DEMO12USDT`；公開行情模式只接受 USDT 標的。面板只呼叫同源分析端點，不接受網址，也沒有下單權限。
此版的主要入口是 `stage.html`。此處的 TF 是時間週期（timeframe），不是 TensorFlow。
## 使用公開行情與 Jev 做紙上研究
這個模式會對外連線，並可能使用你自行提供之 API／CLI 的額度。先安裝正式模式依賴：
 [code] 
在啟動程序的環境中提供 `TYPESAFE_API_KEY`，再執行：
 [code] 
請使用上一步虛擬環境內的 Python。金鑰缺少時會拒絕啟動此模式；不會改讀 `JEV.txt` 或從其他專案取得金鑰。不要把真實金鑰寫入程式、設定、Git 或命令歷史。
Bash 可用不回顯的互動輸入：
 [code] 
PowerShell 可透過你既有的 OS／秘密管理工具把金鑰注入目前程序的環境。`.env.example` 只列變數名稱，本程式不自動載入 `.env`。
可將 `config.example.json` 複製為被 Git 忽略的 `config.json` 調整非秘密設定。預設關閉外部分析 CLI 與本機模型整合；這些服務的安裝、授權與使用額度由使用者自行管理。
### 選用的原生 CLI 伴跑
這是獨立的公開行情研究台帳，不把伴跑結果直接當作 JEV 或模擬交易授權。必須明確選擇啟用；請先自行安裝並登入需要的 CLI。
 [code] 
Windows PowerShell 入口：
 [code] 
要讓紙上研究頁面連接這個已另外啟動的伴跑服務：
 [code] 
`--native-companion` 不會替你啟動 CLI、登入帳戶或更改認證設定。關閉頁面不等於停止另外啟動的後端程序，請在對應終端以 `Ctrl+C` 結束。
Antigravity 在研究面板中顯示名稱 **Antigravity** 與協定 **AGY**。後端的 `enabled`、設定旗標及相容版本 `1.4.2` 只代表設定／相容性；`context_ready` 與 `frame_count=10` 只代表十個已收盤摘要已準備。能力未驗證時，研究請求、spawn、原生呼叫、工具、MCP 與外掛證明全部維持關閉，模型來源仍是 `UNVERIFIED`。既有 CLI 的安裝、登入及額度由使用者自行管理，本專案不承諾任何模型推論成功。
## 擁有者密碼閘道
遠端入口必須放在受信任的 HTTPS 反向代理後方；`run_app.py` 的 8765 與選用伴跑的 8766 都只留在 loopback。先把帳號存放區放在版本庫外的私有、非同步／非虛擬化目錄，並建立唯一擁有者：
 [code] 
密碼長度為 8 至 128 個字元，使用 scrypt 儲存，沒有預設密