LiveAgent: LiveAgent – 一款本地優先的桌面 AI 助手，可讀寫檔案、執行 shell 命令，並可透過 Web 閘道進行遠端存取。\n\n## 什麼是 LiveAgent\nLiveAgent 是一款跨平台桌面客戶端（macOS, Windows, Linux），讓由大型語言模型驅動的 agent 能在您的電腦上執行操作。它可以：\n- 與 Claude, OpenAI Codex, Gemini 或任何您指定的相容 API 進行對話；\n- 讀取、編輯、建立與刪除檔案，使用 glob/regex 進行搜尋，並執行 Bash 命令；\n- 維持長時間運行的程序並透過一鍵隧道將其暴露於網際網路；\n- 將對話歷史與知識儲存在本地 SQLite + Markdown 儲存庫中；\n- 執行排程任務（類似 cron）並在不同工作階段之間記住上下文。\n所有這些功能都在桌面上 離線 運作；如果您想從任何瀏覽器控制同一個 agent，可以部署一個獨立的 Go-based Gateway。\n\n## 核心組件\n| 組件 | 技術 | 角色 |\n|---|---|---|\n| Agent GUI | Tauri 2 + React 19 + Rust (Tokio) | 桌面 UI、本地工具橋接、SQLite 記憶體、LLM SDKs |\n| Gateway | Go 1.25 | WebSocket/HTTP 中繼、Web UI、遠端控制 API (Docker-ready) |\n| MCP protocol | stdio / HTTP bridge | 允許第三方工具或 “Skills” 套件接入 agent |\n| Skills ecosystem | “ClawHub” packages | 按需擴充功能（例如：程式碼格式化工具、網頁爬蟲） |\n\n## 入門指南\n1. 下載 最新的 GitHub Release 中的適當安裝程式（DMG, EXE/MSI/portable zip, AppImage, DEB 或 RPM）。應用程式在適用情況下已進行簽署/公證。\n2. 執行 桌面客戶端，新增您的 API keys（僅儲存在本地機器上），然後開始對話。\n3. 選用 – 遠端存取：拉取 Docker 鏡像 ghcr.io/stack-cairn/liveagent-gateway:latest，使用 token 執行，並將桌面 Settings → Remote 頁面指向閘道 URL。已提供 Nginx 反向代理配置以用於 TLS。\n\n## 底層運作原理\n- UI 通過 Tauri 的 IPC 與 Rust 後端進行通訊。後端使用各自的 SDK 並根據所選模型路由請求，與 LLM 提供商（Claude, Codex, Gemini）進行通訊。\n- 檔案系統與 Bash 能力透過 ManagedProcess 層暴露，該層負責監督命令、強制執行工作目錄與超時限制，並能維持服務運行。\n- 對話歷史以分段訊息加上週期性的摘要檢查點儲存，使 agent 能在長對話後仍能保留上下文。\n- SQLite FTS 索引讓您能透過全文檢索進行過去知識的搜尋。\n- Gateway 鏡像了桌面客戶端使用的相同 WebSocket 協議，因此瀏覽器 UI 可以發出相同的命令。短暫的網路中斷會透過重播受限的序列窗口來恢復。\n\n## 誰可能會使用它\n- 開發者：希望 AI 能編輯程式碼、執行構建或在不離開終端機的情況下管理本地開發伺服器。\n- 進階用戶：需要個人助手來操作檔案、排程腳本，並維護一個可搜尋的知識庫。\n- 團隊：希望為共享的 agent 提供自託管的遠端 UI（例如：透過 Docker gateway）。\n\n## 授權與貢獻\n該專案以 MIT 授權條款發布。歡迎貢獻；該儲存庫包含 TypeScript, Rust 與 Go 的 CI 檢查，以及包含常用開發命令的 Makefile，並附有顯示社群貢獻者的 contrib.rocks 徽章。