LiveAgent: LiveAgent – 一个本地优先的桌面 AI 助手，可以读写文件、运行 shell 命令，并通过 Web 网关进行远程访问。\n\n## 它是什么\nLiveAgent 是一个跨平台桌面客户端（macOS, Windows, Linux），它允许由大语言模型驱动的 agent 在您的计算机上执行操作。它可以：\n- 与 Claude, OpenAI Codex, Gemini 或您指定的任何兼容 API 进行对话；\n- 读取、编辑、创建和删除文件，使用 glob/regex 进行搜索，并运行 Bash 命令；\n- 保持长时间运行的进程存活，并通过一键隧道将其暴露到互联网；\n- 在本地 SQLite + Markdown 存储中保存对话历史和知识；\n- 运行计划任务（类似 cron）并在不同会话之间保留上下文。\n所有这些都在桌面上 离线 工作；如果您想从任何浏览器控制同一个 agent，可以部署一个独立的基于 Go 的 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 密钥（仅存储在本地机器上），然后开始聊天。\n3. 可选 – 远程访问：拉取 Docker 镜像 ghcr.io/stack-cairn/liveagent-gateway:latest，使用 token 运行它，并将桌面 Settings → Remote 页面指向网关 URL。提供了用于 TLS 的 Nginx 反向代理配置。\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（例如，通过 Docker gateway）提供自托管远程 UI 的团队。\n\n## 许可与贡献\n该项目基于 MIT 许可发布。欢迎贡献；该仓库包含 TypeScript, Rust 和 Go 的 CI 检查，包含常用开发命令的 Makefile，以及显示社区贡献者的 contrib.rocks 徽章。