# 遠見指揮台

> 本機網頁控制台，也是唯一的入口：設定遊戲目錄、啟動／停止各項服務、啟動／停止遊戲實例、設定下一局、查看 AI 在想什麼、手動下令、導播、對局紀錄。

來源: https://war3ai.com/zh-tw/docs/console/

遠見（Farsight）是在你本機執行的網頁指揮台，**只監聽 127.0.0.1**。它也是整套系統唯一的入口：開局、換 AI、閘道、頭頂氣泡、本機 LLM 都在這裡操作，不必再找別的指令碼。

```bash
start.bat                 # 部署檢查，然後開啟遠見 http://127.0.0.1:8866
start.bat 5 6             # 順便開始 5、6 號實例的測試（遊戲 + 參考大腦）
start.bat restart         # 只重新啟動遠見後台（修改伺服器端程式碼後使用；遊戲和各項服務不受影響）
stop.bat                  # 徹底停止全部
```

連接埠在 `openwar3.json` 的 `ports.console` 中修改（預設 8866）。

## 控制中心

遠見的首頁。

- **遊戲目錄**：自動尋找或自行選擇，檢查遊戲版本，從你的遊戲中擷取資料。
- **本機服務**：[閘道](https://war3ai.com/zh-tw/docs/gateway/)、[頭頂聊天氣泡](https://war3ai.com/zh-tw/docs/speech/)、本地大模型（LM Studio）、官網本地預覽，每張卡片上都能啟動、停止、重新啟動、看日誌；另外顯示 [MCP](https://war3ai.com/zh-tw/docs/mcp/) 伺服器有沒有被用戶端掛上。
- **環境自檢**：Python、執行環境檔案、遊戲資料、AMAI 資料等各部分是否都已裝好。
- **全部停止**（右上角）：遊戲實例、AI、閘道、氣泡、本系統使用的本機模型、遠見後台依序全部停止；和按兩下 `stop.bat` 一樣。MCP 伺服器由 Claude 等用戶端管理，不會被停止；LM Studio 程式本身也不會被關閉。

## 頁面

| 分組 | 頁面 | 做什麼 |
|---|---|---|
| 總控 | 控制中心 | 見上一節 |
| 對局 | 總覽 | 目前實例的對局概況 |
| | 戰場指揮 | 地圖檢視；可以手動下令（手動命令在仲裁表裡優先順序最高：95） |
| | 單位資料 | 每個單位的指令、任務目標（實際在攻擊誰）、魔力、英雄等級經驗、技能冷卻、物品欄 |
| | AI 決策／戰鬥決策 | 參考大腦這一拍在想什麼、每一次戰鬥決策的明細 |
| | 運營顧問 | [LLM 參謀](https://war3ai.com/zh-tw/docs/llm-coach/)的狀態：模型服務是否在線、每個實例有沒有連上、最近一條建議以及它看到的輸入 |
| | 導播台 | 自動運鏡、頭頂血條 |
| | 頭頂氣泡 | 讓單位說話、和本機模型對話、農民茶話會、鏡頭對白、戰況觸發、模型設定。請見 [頭頂氣泡](https://war3ai.com/zh-tw/docs/speech/) |
| | 指令速度 | APM 與命令吞吐量 |
| | 事件與輸入 | 這一局發生了什麼：放技能、聊天和螢幕訊息、點按鈕、熱鍵、點地面、選取、玩家離開，可依類別篩選；旁邊是滑鼠位置、懸停項目和本機選取。請見 [介面與輸入](https://war3ai.com/zh-tw/docs/ui-input/) |
| 紀錄 | 日誌／對局紀錄 | 每個實例的日誌來源；每一局的結果、時長、兵力峰值 |
| | 問題備忘 | 在遊戲中按 Pause/Break 暫停並記下時間點，之後再回來這裡補上描述 |
| 系統 | 實例與開局 | 啟動／停止實例；設定**下一局**的地圖（對戰地圖，也可以選 RPG／自訂地圖）、雙方種族、難度、遊戲速度；每個實例選一個 AI 方案；「開始測試」一鍵啟動遊戲 + AI |
| | AI 方案 | 匯入、匯出、複製、信任、刪除方案，為實例切換方案（正在進行的這一局也能立即換人接手），查看每個方案的戰績。請見 [AI 方案](https://war3ai.com/zh-tw/docs/schemes/) |
| | JASS 控制台 | 撰寫 JASS 腳本後點選執行，右側可依分類查詢 1291 個函式、點一下即可插入腳本；變數在同一局裡會一直保留。請見 [JASS 通道](https://war3ai.com/zh-tw/docs/jass/) |
| | 串接與擴充 | 閘道狀態和一鍵啟動；依開發／選手／觀眾角色產生的連線網址、MCP 掛載命令和設定；JS、Python 範例。請見 [閘道](https://war3ai.com/zh-tw/docs/gateway/)、[MCP](https://war3ai.com/zh-tw/docs/mcp/) |
| | 數據與磁盤 | 錄製、對局紀錄、日誌等執行資料各占用多少磁碟空間、最近一天新增多少，哪些可以刪除（遠見不會自動刪除任何東西） |
| | 設定 | 遊戲目錄、介面語言、外觀（深色／淺色、現代／魔獸風格）等 |
| | 反饋與建議 | 遇到問題、有建議，直接提交給我們；診斷資訊只在你勾選時附上，送出前可以預覽 |

按 Ctrl + K 開啟命令面板：跳頁、切換實例、結束目前這一局、啟動新大腦。

側邊欄底部的「最近更新」列出遠見和底層平台最近新增了什麼。遠見啟動時（之後每 6 小時）會詢問 War3AI.com 有沒有新版本，有的話會提醒你。遠見更新後，頁面頂端會出現一條橫幅，先儲存好手上的輸入，再點「重新整理」。

## 多實例

`runtime/farm.py` 負責多開（遠見啟動／停止實例時會替你呼叫它）：把原版 `War3.exe` 啟動殼複製並改名為 `War3-<N>.exe`（不修改任何遊戲檔案），每個實例一個編號、一個目錄（`bin/inst<N>/`）。打完一局後依 `next_game.json`（在指揮台「實例與開局」頁修改的就是它）自動開始下一局。

> **提示**
>
> 你的 Bot 用 `--inst N` 連線到指定實例。在指揮台的「實例與開局」頁可以看到哪些編號正在使用，別和參考大腦撞號。

## 直播頁

`http://127.0.0.1:8866/live` 是一個適合放進 OBS「瀏覽器來源」的捲動日誌頁，顯示 AI 的決策與戰況。

## API

指揮台的伺服器端是一組本機 REST + WebSocket API（實例狀態、下一局設定、單位詳情、手動下令、日誌、對局紀錄、導播、AI 方案、JASS 呼叫、畫板……），網頁只是其中一個用戶端，任何語言的程式都能直接呼叫。API 清單寫在 `console/server/app.py` 的檔案開頭；方案、JASS、畫板這三組的用法分別請見 [AI 方案](https://war3ai.com/zh-tw/docs/schemes/)、[JASS 通道](https://war3ai.com/zh-tw/docs/jass/)、[畫板](https://war3ai.com/zh-tw/docs/canvas/)。
