1. 五子棋評(píng)分鏈路為什么肉眼看不出來如果你寫過 javascript 五子棋大概率見過這種結(jié)構(gòu)棋盤上每個(gè)空點(diǎn)都要算分算完排序取最高分落子。代碼能跑但你想確認(rèn)「是不是所有可落子點(diǎn)都進(jìn)了評(píng)分列表」「排序后拿到的到底是不是最高分」光靠盯屏幕是看不出來的。原帖里Role.getPeak()就是這條鏈路的核心它先調(diào)getScoreList()把board.getAvaiablePoints()返回的每個(gè)點(diǎn)都跑一遍getScore(point)再用scoreInfo.sort(function(a,b){ return b.score - a.score; })降序排列最后return scoreInfo[0]。而Machine.setChess()拿到自己的myPeak和對(duì)手的rivalPeak后用myPeak.score rivalPeak.score決定落子位置。問題在于這條鏈路沒有任何控制臺(tái)輸出。getScoreList()返回的數(shù)組里每個(gè)元素是{score, point}排序是否正確、最高分是不是真的對(duì)應(yīng)最優(yōu)落點(diǎn)、邊界點(diǎn)有沒有被漏算全靠腦補(bǔ)。我試過在瀏覽器里打斷點(diǎn)但getAvaiablePoints()每次遍歷 17×17 的棋盤斷點(diǎn)一多就卡得沒法看。更麻煩的是getScore()內(nèi)部把Five、Four_Live、Tree_Live等八個(gè)評(píng)分器依次compute再累加任何一個(gè)評(píng)分器的_computeScore返回異常最終分?jǐn)?shù)都會(huì)偏但你從落子結(jié)果上根本反推不出來是哪一層出的問題。這時(shí)候需要的不是再寫一堆console.log而是讓一個(gè)能讀懂上下文的工具幫你逐段核對(duì)。Codex 這類編碼助手可以做到前提是它得連上一條穩(wěn)定的模型通道。下面我就按「驗(yàn)證用量」的視角把從創(chuàng)建 Key 到讓 Codex 返回核對(duì)結(jié)果的完整過程走一遍。你跟著做最后會(huì)擁有一條可以長(zhǎng)期用來調(diào)試五子棋這類前端代碼的通道。2. 給 Codex 接上 TaoToken 的前置準(zhǔn)備Codex 默認(rèn)走的是官方端點(diǎn)國(guó)內(nèi)直連經(jīng)常超時(shí)而且用量不透明。TaoToken 提供的是兼容 OpenAI 協(xié)議的接口把 Base URL 換掉就能用。你需要先拿到一個(gè) Key。打開 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注冊(cè)后在控制臺(tái)里創(chuàng)建一個(gè) API Key。創(chuàng)建入口在 https://taotoken.net/console 里Key 管理頁(yè)是 https://taotoken.net/api-keys 。Key 只顯示一次復(fù)制下來存好。注意Key 不要寫進(jìn)前端代碼或提交到 Git本地調(diào)試用環(huán)境變量或者臨時(shí)配置文件。Codex 的配置分兩塊Base URL 和 API Key。Base URL 填https://taotoken.net/api注意末尾不要多加/v1Codex 會(huì)自己拼路徑。如果你用的是 Codex CLI配置文件通常在~/.codex/config.json或項(xiàng)目根目錄的.codex/config.json如果用的是 VS Code 插件在設(shè)置里搜codex找到 endpoint 相關(guān)字段。配置項(xiàng)填寫值說明Base URLhttps://taotoken.net/api兼容 OpenAI 協(xié)議API Key控制臺(tái)創(chuàng)建的 Key只顯示一次Model按 Codex 默認(rèn)或指定不影響核對(duì)邏輯超時(shí)建議 60s 以上長(zhǎng)代碼核對(duì)耗時(shí)略長(zhǎng)配好之后先別急著貼五子棋代碼用一個(gè)最小請(qǐng)求確認(rèn)通道是通的。你可以直接在終端里用 curl 測(cè)curl https://taotoken.net/api/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -d { model: gpt-4o-mini, messages: [{role: user, content: 回復(fù) ok}], max_tokens: 10 }返回里如果有choices字段且內(nèi)容正常說明 Key 和 Base URL 都對(duì)。這一步跑通后面貼代碼才有意義。如果這里就報(bào) 401先回去檢查 Key 有沒有復(fù)制全報(bào) 404 多半是 Base URL 多寫了/v1。3. 把 getScoreList 與 getPeak 貼給 Codex 逐行核對(duì)通道通了之后把原帖里Role構(gòu)造函數(shù)中g(shù)etScoreList和getPeak這兩段單獨(dú)摘出來連同getScore一起貼給 Codex。不要貼整個(gè) HTML太長(zhǎng)會(huì)稀釋注意力。我整理了一份可以直接復(fù)制的核對(duì)提示詞下面是一段 javascript 五子棋的評(píng)分邏輯請(qǐng)逐行核對(duì)三個(gè)問題 1. getScoreList() 是否把 board.getAvaiablePoints() 返回的每一個(gè)可用點(diǎn)都算進(jìn)了 result 2. getScore() 內(nèi)部對(duì) computers 數(shù)組的遍歷是否有遺漏或重復(fù)累加 3. getPeak() 里 scoreInfo.sort 的降序?qū)懛ㄊ欠裾_scoreInfo[0] 是否一定是最高分 代碼 var getScore function(point) { var score 0; for(var i 0 , computer; computer computers[i];) { computer.compute(point); score computer.getScore(); } var result {score: score , point : point}; return result; } var getScoreList function() { var result []; var avaiablePoints board.getAvaiablePoints(); for(var i 0 , point; point avaiablePoints[i];) { result.push(getScore(point)); } return result; } this.getPeak function() { var scoreInfo getScoreList(); scoreInfo.sort(function(a,b){ return b.score - a.score ; }); return scoreInfo[0]; }貼過去之后Codex 會(huì)返回一段核對(duì)結(jié)論。正常情況下它會(huì)指出getScoreList的for循環(huán)用point avaiablePoints[i]作為條件當(dāng)point為undefined時(shí)循環(huán)終止所以每個(gè)可用點(diǎn)都被push了一次getScore里computers[i]同理八個(gè)評(píng)分器都會(huì)執(zhí)行sort的b.score - a.score是標(biāo)準(zhǔn)降序scoreInfo[0]就是最高分。如果它發(fā)現(xiàn)getAvaiablePoints里chessBoard[y][x]為undefined時(shí)continue的邏輯有邊界問題也會(huì)一并指出來。這一步的關(guān)鍵不是讓 Codex 幫你改代碼而是讓它把「你肉眼看不到的執(zhí)行路徑」用文字復(fù)述出來。它返回核對(duì)結(jié)果就代表這次請(qǐng)求完整跑通了你的 TaoToken 通道對(duì) Codex 是可用的。4. 驗(yàn)證請(qǐng)求成功與結(jié)果解讀Codex 返回核對(duì)結(jié)果后你要確認(rèn)兩件事一是請(qǐng)求本身成功二是核對(duì)內(nèi)容確實(shí)對(duì)應(yīng)你貼的代碼。請(qǐng)求成功的標(biāo)志是 Codex 的回復(fù)里出現(xiàn)了對(duì)你代碼的具體引用比如提到avaiablePoints、computers、scoreInfo[0]這些變量名。如果它只回了一句「代碼看起來沒問題」而沒有具體分析可能是模型沒讀到完整上下文把代碼再貼一次或者在提示詞里明確要求「逐行引用變量名說明」。結(jié)果解讀上重點(diǎn)看它有沒有回答這三個(gè)問題可用點(diǎn)是否全部算分看它有沒有確認(rèn)getAvaiablePoints()的返回被完整遍歷。評(píng)分器是否全部執(zhí)行看它有沒有數(shù)出computers數(shù)組里八個(gè)評(píng)分器都被compute調(diào)用。排序是否取到最高分看它有沒有確認(rèn)sort比較函數(shù)的方向和scoreInfo[0]的語(yǔ)義。如果 Codex 指出getScoreList里result.push(getScore(point))在point為undefined時(shí)可能出錯(cuò)你可以順著它的提示去檢查getAvaiablePoints的循環(huán)邊界。原帖里for(var y 0 ; y VERTICAL ; y)用的是而VERTICAL 16棋盤是 17×17這個(gè)邊界本身是對(duì)的但chessBoard[y][x]在未初始化時(shí)是undefinedcontinue會(huì)跳過所以不會(huì)把空點(diǎn)算進(jìn)去。Codex 如果提到這一點(diǎn)說明它真的讀懂了。提示核對(duì)結(jié)果里如果出現(xiàn)「建議加 console.log」之類的泛泛建議可以忽略你要的是它對(duì)現(xiàn)有邏輯的判斷不是改造方案。跑通一次之后你可以把這段核對(duì)流程固定下來以后每次改評(píng)分器都把改動(dòng)的那段貼給 Codex 核對(duì)一遍。這比在瀏覽器里打斷點(diǎn)快得多而且不依賴本地環(huán)境。5. 本篇常見錯(cuò)排查報(bào) 401 UnauthorizedKey 沒復(fù)制全或者環(huán)境變量名寫錯(cuò)。檢查Authorization: Bearer后面的值注意不要有多余空格。如果用的是 Codex 插件確認(rèn)它讀的是你改的那個(gè)配置文件有些插件會(huì)緩存舊配置重啟一下。報(bào) 404 Not FoundBase URL 寫成了https://taotoken.net/api/v1。Codex 會(huì)自己拼/chat/completions你只需要填到/api。另外確認(rèn)請(qǐng)求方法用的是 POST不是 GET。Codex 回復(fù)與代碼無(wú)關(guān)提示詞里代碼和問題混在一起模型可能只讀了問題沒讀代碼。把代碼放在問題之后用明確的「代碼」分隔或者分兩輪先貼代碼再問。核對(duì)結(jié)果太籠統(tǒng)模型可能沒拿到完整上下文。把getScore、getScoreList、getPeak三段一起貼不要只貼getPeak。如果還是籠統(tǒng)在提示詞里加一句「請(qǐng)引用具體變量名和行號(hào)」。請(qǐng)求超時(shí)五子棋代碼雖然不長(zhǎng)但如果你把整個(gè) HTML 貼進(jìn)去token 量會(huì)上去。只貼評(píng)分相關(guān)的函數(shù)控制在幾百 token 以內(nèi)。超時(shí)時(shí)間設(shè)到 60s 以上。排序結(jié)果看起來不對(duì)先確認(rèn)scoreInfo里每個(gè)元素的score是不是數(shù)字。如果某個(gè)評(píng)分器的_computeScore返回了undefined累加后score會(huì)變成NaNsort對(duì)NaN的比較結(jié)果是不確定的。Codex 核對(duì)時(shí)如果發(fā)現(xiàn)某個(gè)評(píng)分器沒有return會(huì)指出來。6. 長(zhǎng)期調(diào)試五子棋的通道怎么用跑通這一次之后你手里就有了一條可以反復(fù)用的通道。五子棋這類前端代碼的調(diào)試最耗時(shí)的不是寫邏輯而是確認(rèn)邏輯有沒有按預(yù)期執(zhí)行。評(píng)分鏈路尤其如此八個(gè)評(píng)分器疊加任何一個(gè)的_computeScore寫錯(cuò)最終落子就會(huì)偏但你從棋盤上看不出來。我的做法是每次改完評(píng)分器把改動(dòng)的那段和getScoreList、getPeak一起貼給 Codex讓它核對(duì)「改動(dòng)后可用點(diǎn)是否仍全部算分」「排序是否仍取最高分」。這比寫單元測(cè)試快因?yàn)槲遄悠宓脑u(píng)分依賴棋盤狀態(tài)構(gòu)造測(cè)試用例本身就很麻煩。Codex 能直接讀代碼邏輯不需要你構(gòu)造棋盤。如果你要長(zhǎng)期做這類調(diào)試建議把 Codex 的配置固定下來Key 用環(huán)境變量管理Base URL 寫死在配置里。需要看模型對(duì)話效果時(shí)可以走 https://taotoken.net/models 確認(rèn)當(dāng)前可用模型需要管理 Key 和用量走 https://taotoken.net/console 和 https://taotoken.net/api-keys 。接入文檔在 https://taotoken.net/doc 里面有各語(yǔ)言 SDK 的示例。如果你后面要拿 Codex 做更長(zhǎng)期的編碼任務(wù)比如持續(xù)重構(gòu)五子棋的評(píng)分器可以看看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content ?；氐轿遄悠灞旧韌etPeak這條鏈路的核心就三件事可用點(diǎn)全算分、評(píng)分器全執(zhí)行、排序取最高。Codex 幫你核對(duì)的就是這三件事。核對(duì)通過落子邏輯就是可信的核對(duì)不通過它會(huì)告訴你哪一層斷了。這比在瀏覽器里反復(fù)刷新看落子結(jié)果效率高得多。