1. FreeBSD 控制臺鼠標(biāo)一動就刷 35;62;18m 亂碼到底是什么在作怪如果你在 FreeBSD 控制臺里移動鼠標(biāo)屏幕上就開始滾出35;62;18m35;60;18m35;58;這種字符而且鼠標(biāo)不停、字符就不停那你遇到的是終端鼠標(biāo)事件上報被當(dāng)成普通文本回顯了。這不是 FreeBSD 內(nèi)核壞了也不是 SSH 協(xié)議出問題而是終端模擬器、遠(yuǎn)端 TTY 狀態(tài)、以及前臺程序三者之間的鼠標(biāo)協(xié)議沒有對齊。先把結(jié)論說清楚35;62;18m這類片段本質(zhì)上是 SGR 鼠標(biāo)上報序列的殘片。標(biāo)準(zhǔn) xterm 鼠標(biāo)協(xié)議在按下、移動、釋放時會發(fā)送ESC [ b ; x ; y M或m其中b是按鈕與修飾鍵編碼x、y是列行坐標(biāo)。當(dāng)終端把 ESC 字符吞掉、或者遠(yuǎn)端 TTY 處于 raw 模式卻沒有程序去解析這些字節(jié)時剩下的35;62;18m就會被 shell 或行編輯器當(dāng)作可打印字符直接顯示出來。你看到的35;62;18m35;60;18m其實是連續(xù)多個鼠標(biāo)移動事件每個事件都丟了 ESC 前綴只剩參數(shù)和終止符。這個現(xiàn)象適合誰排查適合所有用 Windows Terminal、PuTTY、mintty、iTerm2 等終端通過 SSH 登錄 FreeBSD并且跑過 TUI 程序比如 Textual 框架寫的工具、htop、vim、tmux的人。尤其是你執(zhí)行過某個交互式程序后沒有正常退出系統(tǒng)睡眠、SSH 斷線重連問題就更容易出現(xiàn)。因為程序退出時沒有把終端狀態(tài)還原鼠標(biāo)上報模式被留在了 TTY 上而新登錄的 shell 并不知道要關(guān)掉它。我試過在 FreeBSD 上用reset和stty sane去救有時候有效有時候完全沒用。原因在于reset重置的是當(dāng)前 TTY 的 termios 屬性和部分終端能力但它不會主動向終端模擬器發(fā)送「關(guān)閉鼠標(biāo)上報」的轉(zhuǎn)義序列。如果鼠標(biāo)模式是終端模擬器本地開啟的或者被某個殘留進程持有reset 就管不到。真正要解決得從三個層面同時查終端模擬器是否開了鼠標(biāo)上報、遠(yuǎn)端 TTY 的 termios 是否被改成 raw、以及有沒有殘留進程還占著這個 pts。下面我會按「先定位、再配置、后驗證」的順序把可復(fù)制的命令和配置都給你。排查過程中我會用 TaoToken 統(tǒng)一記錄每次請求和命令輸出這樣多臺機器、多個會話的排查日志不會散掉。TaoToken 在這里的角色是統(tǒng)一的 Key/API 通道幫你把排查過程沉淀成可回溯的記錄而不是替代你的終端工具。2. 用 TaoToken 統(tǒng)一 Key/API 通道把排查過程記錄下來排查這種終端亂碼最麻煩的不是命令本身而是你會在多個會話、多臺機器之間來回切換命令輸出散落在不同窗口里過兩天就忘了哪條命令在哪個 pts 上生效。我的做法是把每次排查的關(guān)鍵命令和輸出通過 TaoToken 的 API 通道統(tǒng)一記錄形成一個可檢索的排查日志。TaoToken 的定位是統(tǒng)一的模型調(diào)用與 API 通道管理。你可以把它理解成一個「Key 和請求的集中入口」不管你用的是哪個模型、哪個工具Base URL 和 Key 都在一處配置請求記錄也集中在一處。對于終端排查這種需要反復(fù)試錯、對比不同會話結(jié)果的場景統(tǒng)一通道能省掉大量「我剛才在哪臺機器上跑了什么」的回憶成本。具體怎么接入先到官網(wǎng)注冊并拿到 Key。官網(wǎng)地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注冊后在控制臺創(chuàng)建 API Key?？刂婆_入口是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite API Key 管理頁是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。API 的基礎(chǔ)地址是 https://taotoken.net/api 注意這個地址不帶 UTM 參數(shù)配置時直接用。拿到 Key 之后你可以把它配置到常用的命令行工具里。比如你想讓排查助手幫你分析stty -a的輸出或者讓模型解釋某段轉(zhuǎn)義序列就可以通過統(tǒng)一的 Base URL 發(fā)請求。模型對話入口在 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 接入文檔在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。這里要強調(diào)一點TaoToken 不是讓你繞過終端去操作而是幫你把「排查過程中產(chǎn)生的文本」集中管理。終端亂碼的根因還是在 TTY 和終端模擬器上TaoToken 只是讓你的排查記錄不丟。如果你長期做編碼和 Agent 類工作可以考慮 Coding Plan入口是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它更適合需要持續(xù)調(diào)用、批量記錄的場景。配置的時候三件套要寫全Base URL、API Key、Model ID。Base URL 用https://taotoken.net/apiKey 用你在控制臺創(chuàng)建的那串Model ID 按你實際要用的模型填。下面給一個可復(fù)制的配置片段以常見的 OpenAI 兼容客戶端為例放在~/.config/taotoken/config.json{ base_url: https://taotoken.net/api, api_key: sk-你的Key, model: 你的ModelID, timeout: 60, log_dir: /var/log/taotoken }如果你用的是 Claude Code 這類工具配置方式類似把 Base URL 指向https://taotoken.net/apiKey 填進去Model ID 按文檔填。Claude Code 的接入說明在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里有。注意不要把它配成「替代編輯器」的用法它是通道不是 IDE。配好之后你可以在排查終端亂碼時把stty -a、ps -t pts/5、who這些命令的輸出貼給模型讓它幫你判斷哪個標(biāo)志位不對。因為請求都走同一個通道你回頭翻記錄時能看到「幾點幾分在 pts/5 上跑了什么、輸出是什么、模型怎么判斷的」這比在多個終端窗口里翻 scrollback 高效得多。3. 可復(fù)制的 reset 與 stty 配置關(guān)掉鼠標(biāo)上報現(xiàn)在進入正題怎么讓35;62;18m停止刷屏。核心思路是三步——先確認(rèn)當(dāng)前 TTY 狀態(tài)再用 stty 恢復(fù) sane 模式最后顯式關(guān)閉鼠標(biāo)上報序列。下面命令都可以直接復(fù)制。第一步確認(rèn)你當(dāng)前在哪個 pts以及這個 pts 的 termios 狀態(tài)。在出問題的終端里執(zhí)行tty who am i stty -a -f /dev/pts/5tty會告訴你當(dāng)前設(shè)備比如/dev/pts/5。who am i顯示你的登錄來源。stty -a會打印一大堆標(biāo)志位重點看這幾個icanon、echo、isig、iexten。如果icanon是-icanon即關(guān)閉說明 TTY 處于 raw 模式鼠標(biāo)上報的字節(jié)不會被行緩沖處理會直接透傳顯示。正常交互 shell 應(yīng)該是icanon echo isig都開著。第二步用 stty 恢復(fù) sane 模式。在出問題的終端里執(zhí)行stty sane如果stty sane之后鼠標(biāo)一動還是刷字符說明鼠標(biāo)上報模式是終端模擬器層面開的需要發(fā)送關(guān)閉序列。xterm 兼容的關(guān)閉序列是printf \033[?1000l\033[?1002l\033[?1003l\033[?1006l這四條分別關(guān)閉普通鼠標(biāo)追蹤1000、按鈕事件追蹤1002、任意移動追蹤1003、SGR 擴展坐標(biāo)1006。你看到的35;62;18m正是 1003 1006 組合下的移動上報殘片所以 1003 和 1006 必須關(guān)。第三步如果stty sane和關(guān)閉序列都無效說明有殘留進程還占著這個 pts 并持有鼠標(biāo)模式。用另一個干凈的 SSH 會話登錄找到占用進程ps -t pts/5輸出里會列出該 pts 上的所有進程。找到那個 TUI 程序比如你之前跑的 codexy 或類似工具記下 PID然后kill -TERM 2271如果 TERM 不生效再用kill -KILL 2271。殺完之后回到出問題的終端再跑一次stty sane和關(guān)閉序列。實測下來大多數(shù)情況下殺進程 stty sane 就能解決。為了以后不再犯建議在 shell 啟動文件里加一道保險。編輯~/.shrc或~/.bashrc看你用哪個 shell加入# 登錄時確保鼠標(biāo)上報關(guān)閉 printf \033[?1000l\033[?1002l\033[?1003l\033[?1006l stty sane 2/dev/null這樣每次新開終端都會先關(guān)掉鼠標(biāo)上報、恢復(fù) sane 模式。注意stty sane在某些非交互場景會報錯所以加了2/dev/null吞掉錯誤。如果你用的是 tmux還要檢查 tmux 的 mouse 設(shè)置。在~/.tmux.conf里set -g mouse off改完執(zhí)行tmux source-file ~/.tmux.conf或重開 tmux。tmux 的 mouse on 會自己接管鼠標(biāo)事件如果它和終端模擬器的鼠標(biāo)模式?jīng)_突也會產(chǎn)生類似亂碼。4. 驗證請求與成功結(jié)果確認(rèn)亂碼真的消失了配置改完必須驗證。驗證分兩層一層是終端層面鼠標(biāo)不再產(chǎn)生字符另一層是通過 TaoToken 通道確認(rèn)你的排查記錄和模型判斷一致。終端層面的驗證很簡單。在出問題的終端里先跑stty -a | grep -E icanon|echo|isig期望輸出里icanon、echo、isig都是正號沒有前面的-。然后移動鼠標(biāo)觀察屏幕。如果不再出現(xiàn)35;62;18m這類字符說明鼠標(biāo)上報已經(jīng)關(guān)閉。再跑一個會用到鼠標(biāo)的 TUI 程序測試比如vim在 vim 里移動鼠標(biāo)看是否正常。vim 默認(rèn)不開啟鼠標(biāo)如果你在 vim 里:set mousea后移動鼠標(biāo)有反應(yīng)說明鼠標(biāo)協(xié)議本身是通的只是之前被錯誤地留在了 shell 層。第二層驗證走 TaoToken。把stty -a的完整輸出、ps -t pts/5的輸出、以及你執(zhí)行的關(guān)閉序列整理成一段文本通過模型對話入口發(fā)一次請求讓模型確認(rèn)「當(dāng)前 TTY 是否已恢復(fù) sane、鼠標(biāo)上報是否已關(guān)閉」。模型對話地址是 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。請求走h(yuǎn)ttps://taotoken.net/api用你配好的 Key 和 Model ID。一個成功的驗證結(jié)果應(yīng)該長這樣模型回復(fù)指出icanon echo isig均已開啟、ps -t pts/5中無殘留 TUI 進程、關(guān)閉序列已覆蓋 1000/1002/1003/1006。如果模型指出還有-icanon或某個 1003 沒關(guān)你就回到第 3 節(jié)補命令。如果你用 curl 直接驗證 API 通道是否通可以這樣curl -s https://taotoken.net/api/v1/models \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json返回 JSON 里有模型列表說明 Key 和 Base URL 配置正確。這一步不是必須的但能幫你排除「到底是終端問題還是通道問題」。注意 API 地址是https://taotoken.net/api不要多加路徑。驗證通過后建議把這次排查的命令序列存成一個腳本比如~/bin/fix-mouse-tty.sh#!/bin/sh # 修復(fù) FreeBSD 控制臺鼠標(biāo)亂碼 TTY$(tty) echo 修復(fù) $TTY printf \033[?1000l\033[?1002l\033[?1003l\033[?1006l stty sane echo 已發(fā)送關(guān)閉序列并恢復(fù) sane 模式 stty -a | grep -E icanon|echo|isig加執(zhí)行權(quán)限chmod x ~/bin/fix-mouse-tty.sh下次再遇到直接跑。5. 本篇常見錯排查401、local proxy failed、reading choices、OAuth排查終端亂碼時如果你同時用 TaoToken 記錄過程可能會碰到幾類報錯。這里逐個對照真實報錯給解法。第一類401 Unauthorized。這通常是你 API Key 填錯、過期或者請求頭沒帶對。檢查~/.config/taotoken/config.json里的api_key是否以sk-開頭、有沒有多余空格。用 curl 測試時確認(rèn)Authorization: Bearer sk-xxx格式正確。如果 Key 是在控制臺剛創(chuàng)建的確認(rèn)沒有復(fù)制到換行符?？刂婆_入口 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite API Key 頁 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。第二類local proxy failed或類似連接失敗。這通常是你本地網(wǎng)絡(luò)到https://taotoken.net/api的連通性問題或者你本地配了某個代理但代理沒起來。先curl -v https://taotoken.net/api/v1/models看卡在哪一步。如果是 DNS 解析失敗檢查/etc/resolv.conf。如果是 TLS 握手失敗檢查系統(tǒng)時間是否準(zhǔn)確FreeBSD 上用date看偏差大會導(dǎo)致證書校驗失敗。注意這里說的是正常的網(wǎng)絡(luò)連通性排查不涉及任何繞過網(wǎng)絡(luò)管理的手段。第三類reading choices或響應(yīng)體解析失敗。這通常發(fā)生在你用的客戶端期望 OpenAI 格式的choices數(shù)組但返回結(jié)構(gòu)不匹配。檢查你的 Model ID 是否填對以及 Base URL 是否誤加了/v1之外的路徑。正確的基礎(chǔ)地址是https://taotoken.net/api具體路徑按接入文檔來。接入文檔在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。第四類OAuth相關(guān)報錯。如果你用的是 Claude Code 或類似需要 OAuth 的工具報 OAuth 錯誤通常是回調(diào)地址或 token 刷新問題。Claude Code 的接入方式在文檔里有說明地址同上。檢查你的配置里 Base URL 是否指向https://taotoken.net/api以及是否按文檔完成了授權(quán)步驟。如果反復(fù)失敗先用 curl 驗證 Key 本身可用再排查工具側(cè)的 OAuth 流程。除了 API 側(cè)報錯終端側(cè)還有幾個高頻坑。一是stty sane在非交互 shell 里報stty: stdin isnt a terminal這是正常的加2/dev/null或只在交互 shell 里跑。二是關(guān)閉序列發(fā)了但沒生效檢查你的終端模擬器是否支持 xterm 鼠標(biāo)協(xié)議Windows Terminal 和 mintty 都支持老版本 PuTTY 可能部分支持。三是 tmux 里鼠標(biāo)亂碼先set -g mouse off再在 tmux 內(nèi)跑關(guān)閉序列。四是 SSH 斷線重連后問題復(fù)現(xiàn)說明你的 shell 啟動文件沒加保險回到第 3 節(jié)把printf那行加進~/.shrc。如果你需要長期、批量地做這類排查記錄Coding Plan 更適合入口 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。它面向持續(xù)編碼和 Agent 場景能把多次排查的請求集中管理。6. 把 reset 排查思路固化成習(xí)慣回到最初的問題FreeBSD 控制臺鼠標(biāo)一動就冒出35;62;18m35;60;根因是鼠標(biāo)上報序列在 TTY 層被當(dāng)作文本回顯。reset命令之所以有時無效是因為它重置的是 termios而不是終端模擬器的鼠標(biāo)模式。真正管用的是「關(guān)閉 1000/1002/1003/1006 序列 stty sane 清理殘留進程」這三板斧。我的建議是把第 3 節(jié)的關(guān)閉序列寫進 shell 啟動文件把第 4 節(jié)的驗證腳本存成fix-mouse-tty.sh把每次排查的命令和輸出通過 TaoToken 的 API 通道記錄。這樣下次再遇到你不用從頭猜直接跑腳本、翻記錄。TaoToken 的接入文檔在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite API Key 在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 需要驗證模型時用 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。最后提醒一個容易忽略的點如果你在 FreeBSD 上跑的是 Textual 框架寫的 TUI程序異常退出時一定要確認(rèn)它有沒有還原終端狀態(tài)?？梢栽诔绦蛲顺龊笫謩优芤淮侮P(guān)閉序列或者用trap在 shell 退出時自動跑。終端亂碼本身不危險但它會掩蓋真正的輸出讓你誤判命令結(jié)果。把排查流程固化下來比每次臨時救火省事得多。