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