讓自主編程代理在桌面上跑起來Cline Desktop 完整避坑指南【免費下載鏈接】clineAutonomous coding agent as an SDK, IDE extension, or CLI assistant.項目地址: https://gitcode.com/GitHub_Trending/cl/clineCline Desktop 是一個用于運行、檢查與調(diào)度 Cline 自主編程代理會話的原生桌面客戶端采用 Tauri 窗口 Bun sidecar Next.js 前端三層結(jié)構(gòu)與 CLI、VS Code 擴展共享同一套 Hub 會話運行時桌面、終端、編輯器之間的會話互不孤立。它還能把 Claude Code、Codex、opencode 的歷史對話直接導(dǎo)入成可完全恢復(fù)的會話。 為什么不只用終端桌面客戶端帶給你什么你可能會問CLI 已經(jīng)能跑代理了桌面端多了什么定位上它是三件事運行會話、檢查會話、調(diào)度任務(wù)。CLI 適合寫進腳本而你想逐條查看代理的每次工具調(diào)用和推理過程、回看凌晨定時任務(wù)跑完的結(jié)果時桌面 UI 更直觀。更關(guān)鍵的一點會話不困在應(yīng)用里。桌面端和 CLI、擴展連的是同一個 Hub 運行時同一個對話在終端和桌面打開狀態(tài)是一致的。版本 0.0.4 起可以不打開項目文件夾直接開聊首次啟動附帶引導(dǎo)流程。平臺覆蓋方面macOS 從 0.0.2 版本首發(fā)已簽名公證0.0.9 起改為單個 universal 包Apple Silicon 與 Intel 共用一份下載0.0.20 加入代碼簽名的 Windows x64 安裝器自動更新源與 macOS 相同。 它是怎么搭起來的Tauri 殼、sidecar 與共享 Hub把這套應(yīng)用想象成一家門店。Tauri 窗口是店面只管開門和收發(fā)貨窗口管理、原生文件選擇器、打開外部路徑。配置見 tauri.conf.json。Bun sidecar 是后廚一個持久化進程sidecar/index.ts 負責(zé)發(fā)現(xiàn)或啟動規(guī)范的共享 Cline Hub并只暴露一個 WebSocket 端點/transport桌面端的命令、查詢與推送事件全走它。Hub 是配送站不只服務(wù)桌面CLI 和擴展也接進來。后面很多復(fù)雜度都源于此。傳輸協(xié)議是簡單的 JSON 信封請求{ type: command, id, command, args? }響應(yīng){ type: response, id, ok, result?, error? }另有事件推送細節(jié)見 desktop-app README 的 Runtime Overview。前端功能代碼不再直接引入tauri-apps/api/core統(tǒng)一走類型化客戶端 desktop-client.ts。? 對真實使用最有價值的 5 個能力改寫過去的消息編輯對話中任意早期消息時應(yīng)用會在那個點 fork 會話、把工作區(qū)回滾到那次運行的 checkpoint再從你編輯后的 prompt 重跑?；貪L是事務(wù)化且工作區(qū)原子的失敗不會留下半回滾狀態(tài)0.0.8 版本引入。0.0.20 起加了一道保護checkpoint 之后有新 commit 時恢復(fù)直接拒絕重置工作區(qū)避免新提交被悄悄抹掉。0.0.22 又把沒有 checkpoint 歷史的會話如剛導(dǎo)入的納入了支持范圍消除了 No checkpoint found at or before run N 報錯。從其他工具導(dǎo)入歷史0.0.22 起Sessions 標(biāo)題欄的 Import 按鈕Settings → General 也有入口會掃描 Claude Code、Codex、opencode 的本地存儲把選中的對話轉(zhuǎn)成可完全恢復(fù)的 Cline 會話。按工具分組、支持全選、跨標(biāo)題/文件夾/首條 prompt 搜索已導(dǎo)入的會標(biāo)明狀態(tài)重復(fù)打開對話框是安全的。導(dǎo)入的會話在你的提供方與模型上恢復(fù)運行實現(xiàn)見 session-import.ts。語音輸入點輸入框的麥克風(fēng)按鈕邊說話邊轉(zhuǎn)寫用的是你配置的提供方與模型。語音選擇以modes.voiceInput獨立于聊天模型存取憑據(jù)只留在 sidecar 不進前端。流式模型如 Vercel AI Gateway 的openai/gpt-realtime-whisper說話時實時刷新輸入框批量模型如openai/whisper-1在停止錄音后轉(zhuǎn)寫。配置頁在 voice-input-view.tsx只在配好語音模型后才出現(xiàn)麥克風(fēng)按鈕。0.0.22 還修復(fù)了 macOS 上因缺少麥克風(fēng)權(quán)限描述導(dǎo)致聽寫靜默失敗的問題。定時任務(wù)Settings 的 Routine 視圖列出全部調(diào)度顯示enabled、nextRunAt與是否在運行中可增刪、暫停/恢復(fù)、立即觸發(fā)。它接的是與cline schedule命令相同的調(diào)度器 API見 routine-view.tsx。代理也可以創(chuàng)建持久 todo 與一次性/循環(huán)調(diào)度0.0.20 起代理創(chuàng)建的調(diào)度統(tǒng)一存放在~/.cline/schedules。模型選擇與 Web 搜索模型選擇器按 Recommended / Free 分層展示名稱與描述替代按字母排序的裸模型 id 列表0.0.21 起 Cline provider 的模型從實時目錄刷新新發(fā)布模型無需等應(yīng)用更新。Web 搜索自 0.0.22 起默認(rèn)開啟注意只有內(nèi)置 web 搜索的提供方才生效搜索與結(jié)果寫入 transcript 并隨會話持久。 避坑手冊5 個值得讀過的修復(fù)這些條目全是現(xiàn)象 → 原因 → 修復(fù)式的經(jīng)驗也是 changelog 里最有含金量的一批。后臺進程內(nèi)存漲到幾十 GB。長會話時后臺進程內(nèi)存不斷膨脹狀態(tài)更新給每個已連接客戶端都帶了一整份對話 transcript 的拷貝。修復(fù)后狀態(tài)更新只帶 state狀態(tài)、用量、模型、工作區(qū)、checkpointtranscript 改為按需獲取0.0.19。工具調(diào)用被靜默禁用。Dify、SAP AI Core、opencode、Codex CLI 等模型的目錄條目不聲明任何 capabilities空列表被當(dāng)作權(quán)威性否定請求里的所有工具被剝光。0.0.22 修復(fù)了這一點同版本還修了能力列表為空時文件讀取丟圖的問題。0.0.16 修過自定義 OpenAI-Compatible 模型的同類坑——其能力列表由supportsReasoning之類便利開關(guān)推斷推斷失敗就禁了工具調(diào)用。agent 找不到gh。Finder/Dock 啟動的應(yīng)用只繼承 launchd 的極簡 PATH/usr/bin:/bin:/usr/sbin:/sbinHomebrew 工具對它不可見。sidecar 啟動時通過getpwuid回退$SHELL詢問登錄 shell 并合并其 PATH刻意只導(dǎo)入 PATH不導(dǎo)入SSH_AUTH_SOCK、API key 等變量?？捎肅LINE_SIDECAR_SKIP_SHELL_PATH1關(guān)閉實現(xiàn)見 shell-path.ts。更新源一旦丟失就回不來。feed URL滾動發(fā)布desktop-latest的latest.json編譯進了二進制應(yīng)用啟動時 每 2 小時輪詢后臺下載并提示一鍵重啟。feed 或TAURI_SIGNING_PRIVATE_KEY私鑰丟了全部存量安裝會被永久困在失效源上。0.0.20 還修了重啟時 cron 對賬誤清 Hub 調(diào)度記錄、導(dǎo)致計劃任務(wù)在更新后消失的問題。多個安裝之間互相協(xié)調(diào)。兩個不同版本的 Cline 安裝曾互相關(guān)閉對方的 Hub形成死循環(huán)。0.0.13 起應(yīng)用附著仍在服務(wù)會話的 Hub待其空閑后再切換0.0.16 支持兩個 Hub 實例間無丟失交接重啟中的 Hub 完成手頭運行前拒絕新工作斷線期間錯過的事件會重放0.0.22 起 Hub 比應(yīng)用舊時會提示你選擇替換顯示將被打斷的會話數(shù)并先 drain 讓在飛 turn 完成或繼續(xù)運行。 上手指南安裝、啟動命令與日志排障安裝macOS 從 GitHub Releases 下載 DMG0.0.2 首發(fā)即簽名公證下載一次后所有后續(xù)版本自動送達Windows 自 0.0.20 起提供簽名 x64 安裝器。想嘗鮮可以并排裝 Cline Beta它跟蹤實驗分支desktop-experimental與穩(wěn)定版更新 feed 互相隔離流程見 EXPERIMENTAL.md。本地跑起來在apps/examples/desktop-app/目錄下執(zhí)行bun run dev:headless啟動 UIhttp://localhost:3125與 sidecar 后端bun run dev是 Tauri 桌面開發(fā)模式。數(shù)據(jù)在哪會話產(chǎn)物寫于~/.cline/data/sessions/sessionId/核心回放產(chǎn)物是sessionId.messages.json有序消息加modelInfo/metrics完整 v1 契約見 messages-contract-v1.md。日志默認(rèn)寫到~/.cline/data/logs/code.log超 50 MiB 自動滾動CLINE_LOG_LEVELdebug開詳細日志CLINE_LOG_ENABLED0關(guān)閉文件日志。快捷鍵Cmd/CtrlP 打開會話搜索命令條服務(wù)端排序結(jié)果、覆蓋全量索引歷史實現(xiàn)見 session-command-bar.tsxEsc 停止當(dāng)前輪次Cmd/CtrlN 新建會話。排障實時更新卡住時先確認(rèn)后端 WebSocket 已連接且chat_event消息在到達SDK 包改動不生效就跑bun run build:sdk重新構(gòu)建?；仡^看Cline Desktop 最值得學(xué)的工程哲學(xué)一句話就夠把桌面端當(dāng)作共享 Hub 的一個客戶端來設(shè)計而不是一個獨立應(yīng)用——大部分修復(fù)都花在跨進程協(xié)調(diào)、版本錯配與重啟接管上。下一步建議先讀 desktop-app README然后跑bun run dev:headless把整條鏈路在本地跑起來?！久赓M下載鏈接】clineAutonomous coding agent as an SDK, IDE extension, or CLI assistant.項目地址: https://gitcode.com/GitHub_Trending/cl/cline創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 讓自主編程代理在桌面上跑起來：Cline Desktop 完整避坑指南
讓自主編程代理在桌面上跑起來Cline Desktop 完整避坑指南【免費下載鏈接】clineAutonomous coding agent as an SDK, IDE extension, or CLI assistant.項目地址: https://gitcode.com/GitHub_Trending/cl/clineCline Desktop 是一個用于運行、檢查與調(diào)度 Cline 自主編程代理會話的原生桌面客戶端采用 Tauri 窗口 Bun sidecar Next.js 前端三層結(jié)構(gòu)與 CLI、VS Code 擴展共享同一套 Hub 會話運行時桌面、終端、編輯器之間的會話互不孤立。它還能把 Claude Code、Codex、opencode 的歷史對話直接導(dǎo)入成可完全恢復(fù)的會話。 為什么不只用終端桌面客戶端帶給你什么你可能會問CLI 已經(jīng)能跑代理了桌面端多了什么定位上它是三件事運行會話、檢查會話、調(diào)度任務(wù)。CLI 適合寫進腳本而你想逐條查看代理的每次工具調(diào)用和推理過程、回看凌晨定時任務(wù)跑完的結(jié)果時桌面 UI 更直觀。更關(guān)鍵的一點會話不困在應(yīng)用里。桌面端和 CLI、擴展連的是同一個 Hub 運行時同一個對話在終端和桌面打開狀態(tài)是一致的。版本 0.0.4 起可以不打開項目文件夾直接開聊首次啟動附帶引導(dǎo)流程。平臺覆蓋方面macOS 從 0.0.2 版本首發(fā)已簽名公證0.0.9 起改為單個 universal 包Apple Silicon 與 Intel 共用一份下載0.0.20 加入代碼簽名的 Windows x64 安裝器自動更新源與 macOS 相同。 它是怎么搭起來的Tauri 殼、sidecar 與共享 Hub把這套應(yīng)用想象成一家門店。Tauri 窗口是店面只管開門和收發(fā)貨窗口管理、原生文件選擇器、打開外部路徑。配置見 tauri.conf.json。Bun sidecar 是后廚一個持久化進程sidecar/index.ts 負責(zé)發(fā)現(xiàn)或啟動規(guī)范的共享 Cline Hub并只暴露一個 WebSocket 端點/transport桌面端的命令、查詢與推送事件全走它。Hub 是配送站不只服務(wù)桌面CLI 和擴展也接進來。后面很多復(fù)雜度都源于此。傳輸協(xié)議是簡單的 JSON 信封請求{ type: command, id, command, args? }響應(yīng){ type: response, id, ok, result?, error? }另有事件推送細節(jié)見 desktop-app README 的 Runtime Overview。前端功能代碼不再直接引入tauri-apps/api/core統(tǒng)一走類型化客戶端 desktop-client.ts。? 對真實使用最有價值的 5 個能力改寫過去的消息編輯對話中任意早期消息時應(yīng)用會在那個點 fork 會話、把工作區(qū)回滾到那次運行的 checkpoint再從你編輯后的 prompt 重跑?；貪L是事務(wù)化且工作區(qū)原子的失敗不會留下半回滾狀態(tài)0.0.8 版本引入。0.0.20 起加了一道保護checkpoint 之后有新 commit 時恢復(fù)直接拒絕重置工作區(qū)避免新提交被悄悄抹掉。0.0.22 又把沒有 checkpoint 歷史的會話如剛導(dǎo)入的納入了支持范圍消除了 No checkpoint found at or before run N 報錯。從其他工具導(dǎo)入歷史0.0.22 起Sessions 標(biāo)題欄的 Import 按鈕Settings → General 也有入口會掃描 Claude Code、Codex、opencode 的本地存儲把選中的對話轉(zhuǎn)成可完全恢復(fù)的 Cline 會話。按工具分組、支持全選、跨標(biāo)題/文件夾/首條 prompt 搜索已導(dǎo)入的會標(biāo)明狀態(tài)重復(fù)打開對話框是安全的。導(dǎo)入的會話在你的提供方與模型上恢復(fù)運行實現(xiàn)見 session-import.ts。語音輸入點輸入框的麥克風(fēng)按鈕邊說話邊轉(zhuǎn)寫用的是你配置的提供方與模型。語音選擇以modes.voiceInput獨立于聊天模型存取憑據(jù)只留在 sidecar 不進前端。流式模型如 Vercel AI Gateway 的openai/gpt-realtime-whisper說話時實時刷新輸入框批量模型如openai/whisper-1在停止錄音后轉(zhuǎn)寫。配置頁在 voice-input-view.tsx只在配好語音模型后才出現(xiàn)麥克風(fēng)按鈕。0.0.22 還修復(fù)了 macOS 上因缺少麥克風(fēng)權(quán)限描述導(dǎo)致聽寫靜默失敗的問題。定時任務(wù)Settings 的 Routine 視圖列出全部調(diào)度顯示enabled、nextRunAt與是否在運行中可增刪、暫停/恢復(fù)、立即觸發(fā)。它接的是與cline schedule命令相同的調(diào)度器 API見 routine-view.tsx。代理也可以創(chuàng)建持久 todo 與一次性/循環(huán)調(diào)度0.0.20 起代理創(chuàng)建的調(diào)度統(tǒng)一存放在~/.cline/schedules。模型選擇與 Web 搜索模型選擇器按 Recommended / Free 分層展示名稱與描述替代按字母排序的裸模型 id 列表0.0.21 起 Cline provider 的模型從實時目錄刷新新發(fā)布模型無需等應(yīng)用更新。Web 搜索自 0.0.22 起默認(rèn)開啟注意只有內(nèi)置 web 搜索的提供方才生效搜索與結(jié)果寫入 transcript 并隨會話持久。 避坑手冊5 個值得讀過的修復(fù)這些條目全是現(xiàn)象 → 原因 → 修復(fù)式的經(jīng)驗也是 changelog 里最有含金量的一批。后臺進程內(nèi)存漲到幾十 GB。長會話時后臺進程內(nèi)存不斷膨脹狀態(tài)更新給每個已連接客戶端都帶了一整份對話 transcript 的拷貝。修復(fù)后狀態(tài)更新只帶 state狀態(tài)、用量、模型、工作區(qū)、checkpointtranscript 改為按需獲取0.0.19。工具調(diào)用被靜默禁用。Dify、SAP AI Core、opencode、Codex CLI 等模型的目錄條目不聲明任何 capabilities空列表被當(dāng)作權(quán)威性否定請求里的所有工具被剝光。0.0.22 修復(fù)了這一點同版本還修了能力列表為空時文件讀取丟圖的問題。0.0.16 修過自定義 OpenAI-Compatible 模型的同類坑——其能力列表由supportsReasoning之類便利開關(guān)推斷推斷失敗就禁了工具調(diào)用。agent 找不到gh。Finder/Dock 啟動的應(yīng)用只繼承 launchd 的極簡 PATH/usr/bin:/bin:/usr/sbin:/sbinHomebrew 工具對它不可見。sidecar 啟動時通過getpwuid回退$SHELL詢問登錄 shell 并合并其 PATH刻意只導(dǎo)入 PATH不導(dǎo)入SSH_AUTH_SOCK、API key 等變量?？捎肅LINE_SIDECAR_SKIP_SHELL_PATH1關(guān)閉實現(xiàn)見 shell-path.ts。更新源一旦丟失就回不來。feed URL滾動發(fā)布desktop-latest的latest.json編譯進了二進制應(yīng)用啟動時 每 2 小時輪詢后臺下載并提示一鍵重啟。feed 或TAURI_SIGNING_PRIVATE_KEY私鑰丟了全部存量安裝會被永久困在失效源上。0.0.20 還修了重啟時 cron 對賬誤清 Hub 調(diào)度記錄、導(dǎo)致計劃任務(wù)在更新后消失的問題。多個安裝之間互相協(xié)調(diào)。兩個不同版本的 Cline 安裝曾互相關(guān)閉對方的 Hub形成死循環(huán)。0.0.13 起應(yīng)用附著仍在服務(wù)會話的 Hub待其空閑后再切換0.0.16 支持兩個 Hub 實例間無丟失交接重啟中的 Hub 完成手頭運行前拒絕新工作斷線期間錯過的事件會重放0.0.22 起 Hub 比應(yīng)用舊時會提示你選擇替換顯示將被打斷的會話數(shù)并先 drain 讓在飛 turn 完成或繼續(xù)運行。 上手指南安裝、啟動命令與日志排障安裝macOS 從 GitHub Releases 下載 DMG0.0.2 首發(fā)即簽名公證下載一次后所有后續(xù)版本自動送達Windows 自 0.0.20 起提供簽名 x64 安裝器。想嘗鮮可以并排裝 Cline Beta它跟蹤實驗分支desktop-experimental與穩(wěn)定版更新 feed 互相隔離流程見 EXPERIMENTAL.md。本地跑起來在apps/examples/desktop-app/目錄下執(zhí)行bun run dev:headless啟動 UIhttp://localhost:3125與 sidecar 后端bun run dev是 Tauri 桌面開發(fā)模式。數(shù)據(jù)在哪會話產(chǎn)物寫于~/.cline/data/sessions/sessionId/核心回放產(chǎn)物是sessionId.messages.json有序消息加modelInfo/metrics完整 v1 契約見 messages-contract-v1.md。日志默認(rèn)寫到~/.cline/data/logs/code.log超 50 MiB 自動滾動CLINE_LOG_LEVELdebug開詳細日志CLINE_LOG_ENABLED0關(guān)閉文件日志。快捷鍵Cmd/CtrlP 打開會話搜索命令條服務(wù)端排序結(jié)果、覆蓋全量索引歷史實現(xiàn)見 session-command-bar.tsxEsc 停止當(dāng)前輪次Cmd/CtrlN 新建會話。排障實時更新卡住時先確認(rèn)后端 WebSocket 已連接且chat_event消息在到達SDK 包改動不生效就跑bun run build:sdk重新構(gòu)建?；仡^看Cline Desktop 最值得學(xué)的工程哲學(xué)一句話就夠把桌面端當(dāng)作共享 Hub 的一個客戶端來設(shè)計而不是一個獨立應(yīng)用——大部分修復(fù)都花在跨進程協(xié)調(diào)、版本錯配與重啟接管上。下一步建議先讀 desktop-app README然后跑bun run dev:headless把整條鏈路在本地跑起來?！久赓M下載鏈接】clineAutonomous coding agent as an SDK, IDE extension, or CLI assistant.項目地址: https://gitcode.com/GitHub_Trending/cl/cline創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考