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 金鑰或真實交易資料。
jev-desktop-v0.3.mp4
jev-mobile-v0.3-final.mp4
手機影片是 390×844 響應式瀏覽器實錄，包含完整模型夥伴面板及週期指標卡。影片展示介面操作，不代表模型實際推論、策略績效或實機手機驗收。
需要 Python 3.11 或更新版本，以及支援 WebGL 的瀏覽器。DEMO 不需要安裝 Python 套件、API 金鑰、原生 AI CLI 或連網；Three.js 已隨程式附上。
python -B run_app.py --demo --port 8765Windows 也可使用 py -3 -B run_app.py --demo --port 8765。接著開啟 http://127.0.0.1:8765/stage.html，按 Ctrl+C 結束服務。這個服務維持 loopback，不要直接公開到 Internet。
沒有參數時預設也是離線 DEMO。可以先執行不開服務的自我檢查：
python -B run_app.py --demo --checkDEMO 畫面上的行情、帳戶、損益、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。
這個模式會對外連線，並可能使用你自行提供之 API／CLI 的額度。先安裝正式模式依賴：
python -m venv .venv
# Windows: .venv\Scripts\python.exe -m pip install -r requirements.txt
# macOS/Linux: .venv/bin/python -m pip install -r requirements.txt在啟動程序的環境中提供 TYPESAFE_API_KEY，再執行：
python -B run_app.py --real-paper --port 8765請使用上一步虛擬環境內的 Python。金鑰缺少時會拒絕啟動此模式；不會改讀 JEV.txt 或從其他專案取得金鑰。不要把真實金鑰寫入程式、設定、Git 或命令歷史。
Bash 可用不回顯的互動輸入：
read -r -s -p 'TypeSafe API key: ' TYPESAFE_API_KEY; echo
export TYPESAFE_API_KEY
python -B run_app.py --real-paper --port 8765
unset TYPESAFE_API_KEYPowerShell 可透過你既有的 OS／秘密管理工具把金鑰注入目前程序的環境。.env.example 只列變數名稱，本程式不自動載入 .env。
可將 config.example.json 複製為被 Git 忽略的 config.json 調整非秘密設定。預設關閉外部分析 CLI 與本機模型整合；這些服務的安裝、授權與使用額度由使用者自行管理。
這是獨立的公開行情研究台帳，不把伴跑結果直接當作 JEV 或模擬交易授權。必須明確選擇啟用；請先自行安裝並登入需要的 CLI。
python -B run_workguild.py --enable-native-cli --source-url http://127.0.0.1:8765 --port 8766 --capacity 8Windows PowerShell 入口：
./run_workguild.ps1 -EnableNativeCli -Port 8766 -Capacity 8要讓紙上研究頁面連接這個已另外啟動的伴跑服務：
python -B run_app.py --real-paper --port 8765 --native-companion--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。先把帳號存放區放在版本庫外的私有、非同步／非虛擬化目錄，並建立唯一擁有者：
python -B run_remote.py --setup-owner --auth-store "<private-dir>/owner.json"密碼長度為 8 至 128 個字元，使用 scrypt 儲存，沒有預設密碼或公開註冊。啟動完全離線的遠端 DEMO：
python -B run_remote.py --public-origin https://public.example.invalid --auth-store "<private-dir>/owner.json"只有已在 8765 啟動的 real-paper 公開行情來源，才可加上真實研究橋：
python -B run_remote.py --public-origin https://public.example.invalid --auth-store "<private-dir>/owner.json" --upstream http://127.0.0.1:8765 --companion http://127.0.0.1:8766 --market-analysis --enable-antigravity--upstream 與 --companion 都是固定 loopback 唯讀來源；--market-analysis 只用於 real-paper 公開行情，允許擁有者以 CSRF 保護的同源請求選擇研究標的。遠端交易、財務與排程控制仍停用。--enable-antigravity 目前只附加已收盤研究上下文，在能力通過驗證前不會啟動或呼叫原生 Antigravity。完整代理、cookie、期限與多裝置邊界見 遠端存取文件。
python -B -m unittest discover -s tests -v
node tests/test_line_workers.cjs
node tests/test_companion_timeframes.cjsNode.js 僅用於前端驗證，不是離線展示的執行依賴。真實 API 回覆與各平台原生 CLI 的相容性仍取決於外部服務；離線測試不會冒充實際模型驗收。
run_app.py／run_demo.py 是入口；scanner/demo_engine.py 與 demo_server.py 提供合成示範；engine.py、jev_client.py、jev_decision.py、paper_broker.py 是公開行情／Jev／紙上研究流程；agent_cli.py 與 agent_guild.py 提供選用的原生 CLI 伴跑。web/ 保留原環面首頁、寵物顯示層及獨立的 timeframe-research.js／.css 研究面板，web/vendor/three/ 是附帶的授權依賴。
應用程式及原創寵物素材採 MIT License。Three.js 等第三方元件保留各自授權，見 THIRD_PARTY_NOTICES.md。展示配樂 Neon Circuit 為原創程序化合成作品，來源、音樂授權與成品隨版本發布。
本專案沒有附帶私人帳戶資料、交易紀錄、供應商認證、模型權重或原生 CLI 執行檔。新的多週期面板只使用瀏覽器原生 API，沒有加入第三方執行依賴或素材。Jev 仍透過 TypeSafe 官方 API 使用；這不是 TypeSafe 官方產品，也不以示範結果主張投資績效。安全預設及回報方式見 SECURITY.md。