1. Delphi 開發(fā)者接入大模型為什么總卡在“通道”這一步如果你用 Delphi 寫過稍微現(xiàn)代一點(diǎn)的桌面應(yīng)用大概率動過“接個大模型進(jìn)來”的念頭。比如讓工具自動總結(jié)一份 Word 報(bào)告、把 Excel 里的客戶數(shù)據(jù)轉(zhuǎn)成自然語言、或者干脆在 IDE 里掛一個能讀代碼的 AI 助手。想法很順真動手就會發(fā)現(xiàn)麻煩不在 Delphi 本身而在“怎么把請求發(fā)出去、怎么管住一堆 Key、怎么讓不同工具共用同一條通道”。我最近在折騰一套 Delphi 工具鏈核心場景是用 Delphi 構(gòu)建 AI 應(yīng)用同時把 OfficeXML 解析、MCP 協(xié)議對接這些能力串起來。過程中最耗時間的不是寫解析邏輯而是配置層——每個 AI 工具都要單獨(dú)填 Base URL、單獨(dú)填 Key、單獨(dú)處理模型名Cline 一套、CC Switch 一套、自己寫的 Delphi 客戶端又一套。改一次 Key 要翻五個配置文件這種體驗(yàn)對獨(dú)立開發(fā)者很不友好。TaoToken 在這里扮演的角色就是把這些分散的入口收斂成一條統(tǒng)一通道。它提供兼容 OpenAI 風(fēng)格的 API 地址你只需要維護(hù)一個 Key就能讓 Cline、CC Switch 以及你自己的 Delphi HTTP 客戶端走同一條路。對 Delphi 項(xiàng)目來說這意味著System.Net.HttpClient里那個TGraphHttpClient式的封裝可以復(fù)用不用為每個模型供應(yīng)商改一遍請求頭。這篇文章面向的是已經(jīng)會用 Delphi 寫業(yè)務(wù)代碼、但對 AI 接入鏈路還比較陌生的開發(fā)者。我會先給出一份可復(fù)制的config.toml與settings.json骨架再演示在 Cline 和 CC Switch 里驗(yàn)證 API 連通性的具體步驟最后把 OfficeXML4D、MCP 服務(wù)器這些庫怎么和這條通道配合講清楚。全程不需要你裝 Node.js也不需要額外部署中間層。2. TaoToken 前置準(zhǔn)備一個 Key 打通 Delphi 工具鏈在寫任何 Delphi 代碼之前先把通道本身跑通。TaoToken 的接入信息很集中API 根地址是https://taotoken.net/api官網(wǎng)入口在https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。你需要在控制臺里創(chuàng)建一個 API Key這個 Key 后面會同時出現(xiàn)在 Cline、CC Switch 和 Delphi 客戶端的配置里。創(chuàng)建 Key 的入口在控制臺的 API Keys 頁面地址是https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite。進(jìn)去之后新建一個 Key復(fù)制出來先存到臨時文本里。注意這個 Key 只在創(chuàng)建時完整顯示一次關(guān)掉頁面就看不到了所以別急著刷新。這里有個容易踩的坑很多人會把官網(wǎng)首頁地址當(dāng)成 API 地址填進(jìn)工具里。官網(wǎng)是給人看的API 根地址是https://taotoken.net/api兩者不能混。Cline 這類工具通常要求你填Base URL填成https://taotoken.net/api即可它自己會拼接/v1/chat/completions這類路徑。如果你填了帶 UTM 的官網(wǎng)地址請求會打到網(wǎng)頁路由上返回的是一堆 HTML不是 JSON。模型選擇上TaoToken 支持對話模型和編碼模型兩類。日常驗(yàn)證連通性用對話模型就夠長期跑 Agent 或編碼任務(wù)建議單獨(dú)看 Coding Plan入口在https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite。如果你只是想先確認(rèn)“這條路能不能走通”用模型對話頁面手動發(fā)一條消息最快地址是https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite。注意API Key 屬于敏感憑證不要寫進(jìn)會提交到 Git 的配置文件里。下面給的骨架里我用占位符sk-xxxx你本地替換成真實(shí) Key 后記得把配置文件加入.gitignore。3. 可復(fù)制配置config.toml 與 settings.json 骨架Delphi 生態(tài)里配置格式?jīng)]有統(tǒng)一標(biāo)準(zhǔn)但 TOML 和 JSON 是最常見的兩種。我習(xí)慣把“通道級”配置放 TOML把“工具級”配置放 JSON這樣換 Key 時只改一處。下面這份config.toml是給 Delphi 客戶端和 MCP 服務(wù)器共用的骨架。# config.toml —— Delphi AI 工具鏈統(tǒng)一通道配置 [provider] name taotoken base_url https://taotoken.net/api api_key sk-xxxx default_model gpt-4o-mini timeout_seconds 60 [provider.headers] Content-Type application/json Accept application/json [office] # OfficeXML4D 解析時的臨時目錄與最大文件尺寸 temp_dir C:\\Temp\\delphi_ai max_docx_mb 50 max_xlsx_mb 100 [mcp] # Delphi MCP 服務(wù)器監(jiān)聽配置 transport stdio server_name delphi-mcp auto_discover_tools true這份配置里base_url和api_key是核心。default_model可以先填一個便宜的對話模型等連通性驗(yàn)證通過再換成編碼模型。timeout_seconds給 60 秒是因?yàn)橛行┠Ｐ褪?token 返回慢設(shè)太短會誤判為失敗。接下來是給 Cline 和 CC Switch 用的settings.json骨架。這兩個工具都支持自定義 OpenAI 兼容端點(diǎn)字段名略有差異我把它拆成兩個塊你按工具取用。{ cline: { apiProvider: openai, openAiBaseUrl: https://taotoken.net/api, openAiApiKey: sk-xxxx, openAiModelId: gpt-4o-mini, openAiLegacyFormat: false }, ccSwitch: { provider: custom, baseUrl: https://taotoken.net/api, apiKey: sk-xxxx, model: gpt-4o-mini, wireApi: chat } }openAiLegacyFormat這個字段值得單獨(dú)說一句。Cline 早期版本用的是舊版補(bǔ)全接口新版走 chat 接口。如果你填了false還是報(bào) 404把它改成true試試反過來也一樣。這個字段是 Cline 側(cè)的行為和 TaoToken 無關(guān)但排查時容易混淆。配置寫完后Delphi 側(cè)讀取 TOML 可以用System.IniFiles的變體或者引入一個輕量 TOML 解析單元。我自己的做法是寫一個TAppConfig類把base_url和api_key暴露成屬性MCP 服務(wù)器和 HTTP 客戶端都從這里取。這樣以后換供應(yīng)商只改config.toml一行。4. 驗(yàn)證請求在 Cline 與 CC Switch 中確認(rèn)連通性配置寫完不等于通了。我見過太多人配置文件填得漂漂亮亮一發(fā)請求就 401然后開始懷疑人生。下面這套驗(yàn)證流程是我自己踩過坑之后固定下來的順序。第一步先用 TaoToken 的模型對話頁面手動發(fā)一條消息。打開https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite選一個對話模型輸入“你好”看是否正常返回。這一步能排除 Key 本身無效、賬戶余額不足這類問題。如果這里就失敗后面所有工具都不用試了。第二步在 Cline 里驗(yàn)證。打開 Cline 的設(shè)置面板把settings.json里cline塊的內(nèi)容填進(jìn)去。保存后新建一個對話輸入一句簡單指令比如“用一句話說明什么是 Delphi”。如果返回正常說明 Cline 到 TaoToken 的鏈路通了。如果報(bào)401 Unauthorized檢查 Key 是否復(fù)制完整有沒有多帶空格。如果報(bào)404 Not Found檢查openAiBaseUrl是不是寫成了帶/v1的地址——TaoToken 的根地址不帶/v1工具會自己拼。第三步在 CC Switch 里驗(yàn)證。CC Switch 的配置界面字段更少把baseUrl、apiKey、model三項(xiàng)填好即可。它的驗(yàn)證方式是發(fā)一條測試請求成功后會顯示模型返回的文本。這里有個細(xì)節(jié)CC Switch 的wireApi字段如果填chat走對話接口填completion走補(bǔ)全接口。TaoToken 兩種都支持但建議先用chat兼容性更好。第四步回到 Delphi 側(cè)做一次原生請求。這一步很多人跳過結(jié)果工具里能用、自己代碼里不能用。用System.Net.HttpClient發(fā)一個最小請求uses System.Net.HttpClient, System.Net.URLClient, System.SysUtils; function TestTaoToken(const AApiKey: string): string; var Http: THTTPClient; Body: TStringStream; Resp: IHTTPResponse; Json: string; begin Http : THTTPClient.Create; try Http.CustomHeaders[Authorization] : Bearer AApiKey; Http.CustomHeaders[Content-Type] : application/json; Json : {model:gpt-4o-mini,messages:[{role:user,content:ping}]}; Body : TStringStream.Create(Json, TEncoding.UTF8); try Resp : Http.Post(https://taotoken.net/api/v1/chat/completions, Body); Result : Resp.ContentAsString(TEncoding.UTF8); finally Body.Free; end; finally Http.Free; end; end;這段代碼跑通說明 Delphi 原生 HTTP 棧也能走這條通道。注意Post的 URL 里帶了/v1/chat/completions因?yàn)檫@里是直接調(diào)接口不是交給工具去拼。如果你在config.toml里存的是根地址代碼里要自己補(bǔ)全路徑。提示如果 Delphi 請求返回Could not load SSL library說明你的System.Net.HttpClient沒配好 OpenSSL。Delphi 12 默認(rèn)用系統(tǒng) TLS一般不需要額外 DLL老版本可能需要把libssl和libcrypto放到 exe 同目錄。5. 本篇常見錯排查從 401 到 MCP 工具不發(fā)現(xiàn)排障這部分我按“癥狀 → 原因 → 處理”來寫都是實(shí)際遇到過的。癥狀一401 Unauthorized。最常見的原因是 Key 復(fù)制時帶了首尾空格或者把 Key 填到了model字段里。檢查config.toml和settings.json里api_key的值確保是sk-開頭的一整串。另一個可能是 Key 被刪除或過期去控制臺 API Keys 頁面確認(rèn)狀態(tài)。癥狀二404 Not Found。九成是 Base URL 寫錯。TaoToken 的根地址是https://taotoken.net/api不要寫成https://taotoken.net/api/v1也不要寫成官網(wǎng)首頁。工具內(nèi)部會拼接路徑你多寫一段就變成/api/v1/v1/chat/completions自然 404。癥狀三請求超時。先確認(rèn)網(wǎng)絡(luò)能訪問taotoken.net。如果瀏覽器能打開官網(wǎng)但 Delphi 請求超時檢查是不是公司網(wǎng)絡(luò)對非標(biāo)準(zhǔn)端口做了限制。TaoToken 走 443 標(biāo)準(zhǔn)端口一般不受影響。另一個可能是timeout_seconds設(shè)太短改成 120 再試。癥狀四MCP 服務(wù)器啟動后工具列表為空。Delphi MCP 服務(wù)器用 RTTI 自動發(fā)現(xiàn)工具如果你的工具方法沒有加正確的特性標(biāo)注或者方法不是published可見性就不會被掃到。檢查你的工具類是否繼承自約定的基類方法上是否有[MCPTool]之類的標(biāo)注。另外auto_discover_tools在config.toml里要設(shè)為true。癥狀五OfficeXML4D 解析 docx 報(bào) XML 格式錯誤。這種情況通常是文件本身不是標(biāo)準(zhǔn) OOXML比如是.doc改后綴來的。OfficeXML4D 只處理 Office Open XML不處理老的二進(jìn)制格式。用 Word 另存為.docx再試。另外注意max_docx_mb限制超過尺寸會被拒絕。癥狀六Cline 里模型列表拉不出來。Cline 會嘗試調(diào)/v1/models接口。TaoToken 支持這個接口但如果你的 Key 權(quán)限受限可能返回空列表。這種情況下手動填openAiModelId即可不影響對話功能。排查時有個通用技巧把請求的完整 URL 和響應(yīng)狀態(tài)碼打出來。Delphi 里用Resp.StatusCode和Resp.ContentAsStringCline 和 CC Switch 一般在日志面板里能看到?？吹骄唧w數(shù)字比“連不上”三個字有用得多。6. 把 OfficeXML 與 MCP 接進(jìn)同一條通道前面驗(yàn)證的是“通道能通”現(xiàn)在說“通道通了之后能干什么”。Delphi 工具包里有兩個庫和 AI 接入關(guān)系最緊OfficeXML4D 和 Delphi MCP 服務(wù)器。OfficeXML4D 負(fù)責(zé)讀寫 Word 和 Excel純 Delphi 實(shí)現(xiàn)不依賴 Office 安裝。典型場景是用戶上傳一份.docx合同你的 Delphi 應(yīng)用解析出段落和表格拼成 prompt 發(fā)給模型做摘要。解析部分用TWordDocumentFactory發(fā)送部分用第 4 節(jié)那個TestTaoToken的封裝。兩者之間用config.toml里的[office]段控制臨時目錄和尺寸上限。MCP 服務(wù)器則是把 Delphi 的能力暴露給 AI 助手。比如你寫了一個查詢本地?cái)?shù)據(jù)庫的工具方法通過 MCP 協(xié)議注冊后Claude 這類助手就能調(diào)用它。Delphi MCP 服務(wù)器用 RTTI 自動發(fā)現(xiàn)工具你只需要在方法上加標(biāo)注。它支持 Windows 和 Linux傳輸方式在config.toml的[mcp]段里配stdio或http。這里有個組合玩法把 OfficeXML4D 的解析能力包裝成一個 MCP 工具AI 助手就能直接讀你本地的 Word 文件。配置上MCP 服務(wù)器讀config.toml拿base_url和api_keyOfficeXML4D 讀同一份配置拿臨時目錄。一份配置兩個庫共用換 Key 時只改一處。如果你打算長期跑編碼類 Agent建議單獨(dú)配置 Coding Plan入口在https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite。它和普通對話通道的區(qū)別在于計(jì)費(fèi)和模型池適合高頻調(diào)用場景。接入文檔在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite里面有各語言的請求示例Delphi 部分可以參考 HTTP 客戶端的寫法自己封裝。最后說一個我自己的習(xí)慣所有 AI 請求都走一個統(tǒng)一的TAIChannel類這個類從config.toml讀配置對外只暴露Ask和AskStream兩個方法。OfficeXML4D 解析完的內(nèi)容、MCP 工具收到的參數(shù)都通過這個類發(fā)出去。這樣以后不管換哪個供應(yīng)商改的都是TAIChannel內(nèi)部業(yè)務(wù)代碼一行不動。Delphi 的接口式設(shè)計(jì)在這里很占便宜TAIChannel定義成接口測試時用 mock 實(shí)現(xiàn)生產(chǎn)時用真實(shí) HTTP 實(shí)現(xiàn)切換成本幾乎為零。