讓 AI 陪你操作 nexus
nexus 可以讓 AI 助手（Claude Code、Claude Desktop、Codex、Gemini CLI、VS Code、Cursor、
Windsurf、Cline）透過 MCP（Model Context Protocol，AI 工具連接外部程式的通用規格）
陪同你操作正在執行的 nexus_tui.exe 或 nexus_gui.exe：讀暫存器、下指令、等事件、
寫 Lua 腳本；而你在畫面上看得到它做的每一件事。
陪同模式
- 你先開著程式，AI 在同一個 session 工作。 AI 不會自己啟動 nexus，也不會另外開一個你看不到的 nexus；沒開程式時，它每次呼叫都只會得到「nexus 沒有在執行」。
- AI 下的指令和你在指令列輸入的完全一樣（同一份解析、同一份指令表），結果也寫進同一個 Log。
Log 面板會多出標示來源的兩行：
[mcp] <指令>與[mcp] -> <結果>。 - 中間有一支很小的
nexus_mcp.exe（出貨在安裝目錄）：AI 工具啟動它，它再把請求轉給你開著的 nexus。每次呼叫只佔一條很短的連線，所以你重開 nexus 之後，AI 工具不必重啟就能接著用。
安全須知（請先讀完）
⚠ AI 能做你能做的一切，而且不會跳出確認框。
- 寫入暫存器（
wr、set）、解鎖（password）、執行任意 Lua 腳本（Lua 能寫 I2C、操作 GPIO）、uart send、安裝或移除 Plugin、quit——全部都可以。一般會讓你按「確定」的確認框，對 AI 都視同已經按了確定。沒有指令黑名單。 - 所以：不要讓 AI 自由操作不能復原的東西（量產中的設備、沒備份的 EEPROM／OTP）。要限制它，最直接的 方式是不要核准它的工具呼叫——多數 AI 工具預設每次呼叫都會先問你。
- AI 可以在你已開啟的 TERM（UART／SSH）中打字執行指令：
term_send等於直接在你登入的 shell 輸入， 包括你開著的 SSH session。AI 不能自己開或關 TERM（term open／term close對 AI 被拒絕），只能操作你已經連好的那一個； Log 只顯示[mcp] term_send <N> bytes，不記內容。 - 檔案範圍很小：AI 只能讀
logs\底下的文字檔、只能寫到logs\mcp\；..、絕對路徑、 磁碟代號、裝置名一律被拒絕。（但它下run、dump load這類指令時，能碰到的檔案和你自己下是一樣的。） - 只有同一位 Windows 使用者的程式連得上，遠端連線一律拒絕。
nexus_mcp.exe連上之後，會先確認對面 真的是你自己的 nexus（不是別的程式冒充），確認不過就一個位元組都不送。 - 以系統管理員身分啟動 nexus 要小心：同一位使用者底下的一般權限程式，仍然可以驅動一個 以管理員身分執行的 nexus。需要用管理員身分跑 nexus 時，請把這件事算進風險。
- 不要讓不可信的內容（網頁、第三方韌體 log）直接餵給握有 nexus 權限的 AI——內容裡藏的「指示」 可能被 AI 當成你的要求照做。
隨時可以關
- GUI：
Device > MCP server，選一次切換一次。 - 終端機版與 GUI 都可以：指令列下
mcp off、mcp on、mcp status。 - 關掉之後，已連著的 AI 不會被斷線，但它之後呼叫的每個工具都會被拒絕；已經在跑的指令照常跑完， 正在等待事件的呼叫會以錯誤結束。
- 預設是開的，而且不會存進
config.ini——每次啟動 nexus 都是開的。
你看得到它在做事
狀態列右下角（ESC 的左邊）常駐 MCP；有 AI 呼叫進行中時變成 MCP:<n>（n 是進行中的呼叫數）；
關掉就不顯示。如果 GUI 選單右邊顯示 unavailable，表示通道根本沒有在運行（通常是名稱被別的程式
佔住），程式每 2 秒自動重試，也可以下 mcp on 立刻再試。
它能用什麼
AI 一共有 17 個工具：下指令（nexus_exec）、中止 Lua 腳本、查指令表與狀態、讀 Log 與 UART 紀錄、
等事件、讀暫存器快取與 regdef 解碼、讀監看清單與監看值的歷史（get_trend）、讀寫 Plugin widget、讀寫 logs\ 底下的檔案。
完整清單與參數見安裝與註冊最後一節，實際用法見使用範例。
資料類的工具只讀快取、絕不為了回答問題去碰 I2C 匯流排；沒讀過的值一律標成「沒有」，不會用 0
冒充。要最新值，讓 AI 先下 dump 或 rd。