{"id":43829865,"url":"https://github.com/ruilisi/lingti-bot","last_synced_at":"2026-03-09T01:04:33.563Z","repository":{"id":335982821,"uuid":"1146290683","full_name":"ruilisi/lingti-bot","owner":"ruilisi","description":"🐕⚡ 「极简至上 效率为王 一次编译 到处执行 极速接入」的 AI Bot","archived":false,"fork":false,"pushed_at":"2026-02-20T23:40:41.000Z","size":3874,"stargazers_count":162,"open_issues_count":1,"forks_count":23,"subscribers_count":3,"default_branch":"master","last_synced_at":"2026-02-21T04:56:50.083Z","etag":null,"topics":["bot","lingtibot","mcp-server","openclaw"],"latest_commit_sha":null,"homepage":"https://cli.lingti.com/bot","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ruilisi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-30T21:52:04.000Z","updated_at":"2026-02-21T04:26:03.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ruilisi/lingti-bot","commit_stats":null,"previous_names":["ruilisi/lingti-bot"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/ruilisi/lingti-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruilisi%2Flingti-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruilisi%2Flingti-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruilisi%2Flingti-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruilisi%2Flingti-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ruilisi","download_url":"https://codeload.github.com/ruilisi/lingti-bot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruilisi%2Flingti-bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29677881,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-21T06:23:40.028Z","status":"ssl_error","status_checked_at":"2026-02-21T06:23:39.222Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","lingtibot","mcp-server","openclaw"],"created_at":"2026-02-06T03:08:39.867Z","updated_at":"2026-02-26T17:23:56.613Z","avatar_url":"https://github.com/ruilisi.png","language":"Go","funding_links":[],"categories":["カテゴリ"],"sub_categories":["🛠️ \u003ca name=\"developer-tools\"\u003e\u003c/a\u003e開発ツール"],"readme":"[English](./README_EN.md) | 中文\n\n---\n\n# lingti-bot (灵小缇 [cli.lingti.com/bot](https://cli.lingti.com/bot))\n\n\u003e 🐕⚡「**极简至上 效率为王 一次编译 到处执行 极速接入**」的 AI Bot\n\n[![Go Version](https://img.shields.io/badge/Go-1.23+-00ADD8?style=flat\u0026logo=go)](https://go.dev/)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![Website](https://img.shields.io/badge/官网-cli.lingti.com-blue?style=flat)](https://cli.lingti.com/bot)\n\n**灵小缇** 是一个集 **MCP Server**、**多平台消息网关**、**丰富工具集**、**智能对话**、**语音交互**于一体的 AI Bot 平台。\n\n**核心优势：**\n- 🚀 **零依赖部署** — 单个 30MB 二进制文件，无需 Node.js/Python 运行时，**一行命令**安装即用\n- ☁️ **[云中继](docs/cloud-relay.md)加持** — 无需公网服务器、域名备案、HTTPS 证书，5 分钟接入企业微信/微信公众号\n- 🤖 **[浏览器自动化](docs/browser-automation.md)** — 内置完整 CDP 控制引擎，可接管已有 Chrome 窗口，快照-操作模式精准定位元素，无需 Puppeteer/Playwright/Node.js\n- 🌐 **[社交平台自动化](docs/social-platform-automation.md)** — 通过 MCP + Chrome 浏览器能力，AI 代操作知乎、小红书等内容平台，自动发帖、评论、互动，解放运营双手\n- 🛠️ **75+ MCP 工具** — 覆盖文件、Shell、系统、网络、日历、Git、GitHub 等全场景\n- 🌏 **中国平台原生支持** — 钉钉、飞书、企业微信、微信公众号开箱即用\n- 🔌 **嵌入式友好** — 可编译到 ARM/MIPS，轻松部署到树莓派、路由器、NAS\n- 🧠 **多 AI 后端** — 集成 Claude、DeepSeek、Kimi、MiniMax、Gemini 等 [16 种 AI 服务](AI-PROVIDERS.md)，按需切换，支持[按平台/频道指定不同模型](#per-channel-model)\n- 🔬 **Claude 深度思考** — 原生支持 Claude Extended Thinking API，`/think high` 即可启用真正的链式推理\n- 🐳 **Docker 部署** — 提供 Dockerfile 和 docker-compose.yml，一键容器化部署\n- 🩺 **健康诊断** — `lingti-bot doctor` 一键检查配置、连接、依赖，快速定位问题\n\n支持企业微信、飞书、钉钉、Slack、Telegram、Discord、WhatsApp、LINE、Teams 等 [19 种聊天平台](docs/chat-platforms.md) 接入，既可通过**云中继 5 分钟秒接**，也可 [OpenClaw](docs/openclaw-reference.md) 式**传统自建部署**。查看 [开发路线图](docs/roadmap.md) 了解更多功能规划。\n\n\u003e 🐕⚡ **为什么叫\"灵小缇\"？** 灵缇犬（Greyhound）是世界上跑得最快的犬，以敏捷、忠诚著称。灵小缇同样敏捷高效，是你忠实的 AI 助手。\n\n## 安装\n\n### macOS / Linux / WSL\n\n```bash\ncurl -fsSL https://cli.lingti.com/install.sh | bash -s -- --bot\n```\n\n### Windows (PowerShell)\n\n```powershell\nirm https://cli.lingti.com/install.ps1 | iex\n```\n\n安装完成后，通过交互式向导完成首次配置：\n\n```bash\nlingti-bot onboard\n```\n\n配置保存后，无需任何参数即可启动：\n\n```bash\nlingti-bot relay\n```\n\n也可以通过命令行参数直接启动，适合运行多个实例或覆盖已有配置：\n\n```bash\nlingti-bot relay --platform wecom --provider deepseek --api-key sk-xxx\n```\n\n## 样例\n### 智能对话、文件管理、信息检索\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"33%\"\u003e\u003cimg src=\"docs/images/demo-chat-1.png\" alt=\"智能助手\" /\u003e\u003c/td\u003e\n\u003ctd width=\"33%\"\u003e\u003cimg src=\"docs/images/demo-chat-2.png\" alt=\"企业微信文件传输\" /\u003e\u003c/td\u003e\n\u003ctd width=\"33%\"\u003e\u003cimg src=\"docs/images/demo-chat-3.png\" alt=\"信息搜索\" /\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\"\u003e\u003csub\u003e💬 智能对话\u003c/sub\u003e\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\u003csub\u003e📁 企微文件传输\u003c/sub\u003e\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\u003csub\u003e🔍 信息搜索\u003c/sub\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n\u003csummary\u003e📺 \u003cb\u003e后台运行演示\u003c/b\u003e — \u003ccode\u003emake \u0026\u0026 dist/lingti-bot router\u003c/code\u003e\u003c/summary\u003e\n\u003cbr\u003e\n\u003cimg src=\"docs/images/demo-terminal.png\" alt=\"Terminal Demo\" /\u003e\n\u003cp\u003e\u003csub\u003e克隆代码后直接编译运行，配合 DeepSeek 模型，实时处理钉钉消息\u003c/sub\u003e\u003c/p\u003e\n\n### 定时任务 — AI 自动创建 Cron Job\n\n\u003e 用自然语言创建定时任务 — 告诉 AI 你想要什么，剩下的交给它\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"docs/images/demo-cron-wecom.png\" alt=\"AI 创建定时任务演示\" width=\"720\" /\u003e\n\u003c/p\u003e\n\n在企业微信中对 AI 说一句话，即可创建复杂的定时任务。支持 Cron 表达式调度、macOS 系统通知、Shell 脚本执行等，真正实现无人值守自动化。\n\n### 企业微信 AI 文件助手\n\n\u003e 用自然语言管理和传输文件 — 就像跟同事说话一样简单\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"docs/images/wecom-file-transfer.png\" alt=\"企业微信 AI 文件传输\" width=\"720\" /\u003e\n\u003c/p\u003e\n\n直接在企业微信中用自然语言浏览、查找、传输电脑上的文件。无需远程桌面，无需 U 盘，对 AI 说一句话即可。\n\n### 社交平台自动化 — AI 驱动的内容平台运营\n\n\u003e 通过 MCP + Chrome 浏览器能力，让 AI 代替你操作知乎、小红书等内容平台\n\nlingti-bot 将浏览器自动化能力与 AI 深度结合，针对中国主流内容平台提供**智能化运营**支持。不是简单的脚本录制回放，而是 AI 理解页面语义后的精准操作。\n\n**已支持平台：**\n\n| 平台 | 发帖/回答 | 评论 | 点赞/收藏 | 状态 |\n|------|:---------:|:----:|:---------:|------|\n| **知乎** | ✅ | ✅ | ✅ | 已支持 |\n| **小红书** | 🔜 | 🔜 | 🔜 | 规划中 |\n| **微博** | 🔜 | 🔜 | 🔜 | 规划中 |\n| **抖音（网页版）** | 🔜 | 🔜 | 🔜 | 规划中 |\n| **B站** | 🔜 | 🔜 | 🔜 | 规划中 |\n| **今日头条** | 🔜 | 🔜 | 🔜 | 规划中 |\n\n**使用示例：**\n\n```\n\"帮我在知乎上回答这个问题，内容围绕 Go 语言的优势\"\n\"打开知乎这篇文章，帮我写一条评论\"\n\"在小红书发一篇关于效率工具的笔记\"\n\"帮我给这篇知乎回答点个赞\"\n```\n\n**工作原理：** AI 通过 MCP 协议调用浏览器工具（CDP 或 Chrome MCP），在你已登录的 Chrome 中操作，**复用你的登录态**，无需提供账号密码。AI 读取页面无障碍树快照，理解每个按钮和输入框的含义，像人一样精准操作。\n\n\u003e 📖 **详细文档：[社交平台自动化指南](docs/social-platform-automation.md)**\n\n### 浏览器自动化 — 让 AI 像人一样操控浏览器\n\n\u003e 无需 Puppeteer、无需 Node.js、无需安装任何依赖——直接用自然语言驾驭 Chrome\n\nlingti-bot 内置完整的 CDP（Chrome DevTools Protocol）自动化引擎，采用**快照-操作（Snapshot-then-Act）**模式：先读取页面无障碍树，理解每个元素的角色和名称，再精准点击、输入、截图。\n\n**直接在你正在使用的 Chrome 里操作：**\n\n```bash\n# 1. 用调试端口启动 Chrome（一次配置，长期使用）\n/Applications/Google\\ Chrome.app/Contents/MacOS/Google\\ Chrome \\\n  --remote-debugging-port=9222 \\\n  --user-data-dir=\"$HOME/.lingti-bot/chrome-profile\"\n\n# 2. ~/.lingti.yaml 中添加一行\n# browser:\n#   cdp_url: \"127.0.0.1:9222\"\n```\n\n之后，对 AI 说话即可——bot 会在你已有的 Chrome 里开新标签页操作，不再另弹窗口：\n\n```\n\"打开知乎，搜索 Go 语言并截图\"\n\"帮我登录 GitHub，查看我最新的 PR\"\n\"打开这个表单，填写姓名张三、手机 138xxxx1234，然后提交\"\n\"把电商后台所有待审核商品都批量通过\"\n\"每隔5分钟截一张这个监控大屏的图\"\n```\n\n**工作原理（AI 自动完成全部步骤）：**\n\n```\nbrowser_navigate url=\"https://www.zhihu.com\"\nbrowser_snapshot\n→ [1] textbox \"搜索\" [2] button \"搜索\" [3] link \"登录\" ...\n\nbrowser_type ref=1 text=\"Go 语言\" submit=true\nbrowser_snapshot\n→ 看到搜索结果列表\n\nbrowser_screenshot path=\"/tmp/zhihu-result.png\"\n→ 截图保存完成\n```\n\n14 个浏览器工具覆盖完整自动化流程：生命周期管理、导航、无障碍树快照、点击/输入/按键、JavaScript 执行、批量操作、多标签页管理、截图。\n\n\u003e 📖 **完整使用指南、连接配置、故障排除：[浏览器自动化文档](docs/browser-automation.md)**\n\u003e\n\u003e 📋 **AI 操作规则详解（快照法则、搜索行为、弹窗处理、批量操作等）：[浏览器 AI 操作规则](docs/browser-agent-rules.md)**\n\n---\n\n## 为什么选择 lingti-bot？\n\n### lingti-bot vs OpenClaw\n\n|  | **lingti-bot** | **OpenClaw** |\n|--|----------------|--------------|\n| **语言** | 纯 Go 实现 | Node.js |\n| **运行依赖** | 无（单一二进制） | 需要 Node.js 运行时 |\n| **分发方式** | 单个可执行文件，复制即用 | npm 安装，依赖 node_modules |\n| **嵌入式设备** | ✅ 可轻松部署到 ARM/MIPS 等小型设备 | ❌ 需要 Node.js 环境 |\n| **安装大小** | ~15MB 单文件 | 100MB+ (含 node_modules) |\n| **输出风格** | 纯文本，无彩色 | 彩色输出 |\n| **设计哲学** | 极简主义，够用就好 | 功能丰富，灵活优先 |\n| **Docker 部署** | ✅ 多阶段构建，~15MB 镜像 | ✅ Docker 支持 |\n| **Extended Thinking** | ✅ Claude 原生 API | ✅ 支持 |\n| **按平台模型切换** | ✅ 配置文件声明式 | ✅ 支持 |\n| **健康诊断** | ✅ `doctor` 命令 | ✅ 支持 |\n| **中国平台** | 原生支持飞书/企微/钉钉 | 需自行集成 |\n| **云中继** | ✅ 免自建服务器，秒级接入微信/企微 | ❌ 需自建 Web 服务 |\n\n\u003e 详细功能对比请参考：[OpenClaw vs lingti-bot 技术特性对比](docs/openclaw-feature-comparison.md)\n\n**为什么选择纯 Go + 纯文本输出？**\n\n\u003e *\"Simplicity is the ultimate sophistication.\"* — Leonardo da Vinci\n\nlingti-bot 将**简洁性**作为最高设计原则：\n\n1. **零依赖部署** — 单一二进制，`scp` 到任何机器即可运行，无需安装 Node.js、Python 或其他运行时\n2. **嵌入式友好** — 可编译到 ARM、MIPS 等架构，轻松部署到树莓派、路由器、NAS 等小型设备\n3. **纯文本输出** — 不使用彩色终端输出，避免引入额外的渲染库或终端兼容性问题\n4. **代码克制** — 每一行代码都有明确的存在理由，拒绝过度设计\n5. **云中继加持** — 无需自建 Web 服务器，通过云中继秒级完成微信公众号、企业微信的回调验证，Bot 即刻上线\n\n```bash\n# 克隆即编译，编译即运行\ngit clone https://github.com/ruilisi/lingti-bot.git\ncd lingti-bot \u0026\u0026 make\n./dist/lingti-bot router --provider deepseek --api-key sk-xxx\n```\n\n### 单一二进制\n\n```bash\n# 编译\nmake build\n\n# 即可使用\n./dist/lingti-bot serve\n```\n\n无需数据库，无需云服务。也支持 [Docker 部署](#docker-部署)。\n\n### 本地优先\n\n所有功能都在本地运行，数据不会上传到云端。你的文件、日历、进程信息都安全地保留在本地。\n\n### 跨平台支持\n\n核心功能支持 macOS、Linux、Windows。macOS 用户可享受日历、提醒事项、备忘录、音乐控制等原生功能。\n\n**支持的目标平台：**\n\n| 平台 | 架构 | 编译命令 |\n|------|------|----------|\n| macOS | ARM64 (Apple Silicon) | `make darwin-arm64` |\n| macOS | AMD64 (Intel) | `make darwin-amd64` |\n| Linux | AMD64 | `make linux-amd64` |\n| Linux | ARM64 | `make linux-arm64` |\n| Linux | ARMv7 (树莓派等) | `make linux-arm` |\n| Windows | AMD64 | `make windows-amd64` |\n\n## 功能概览\n\n### MCP Server — 标准协议，无缝集成\n\n灵小缇实现了完整的 [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) 协议，让任何支持 MCP 的 AI 客户端都能访问本地系统资源。\n\n| 客户端 | 状态 | 说明 |\n|--------|------|------|\n| Claude Desktop | ✅ | Anthropic 官方桌面客户端 |\n| Cursor | ✅ | AI 代码编辑器 |\n| Windsurf | ✅ | Codeium 的 AI IDE |\n| 其他 MCP 客户端 | ✅ | 任何实现 MCP 协议的应用 |\n\n**特点：** 无需额外配置、无需数据库、无需 Docker、无需云服务，单一二进制文件即可运行。\n\n### 多平台消息网关 — 企业 IM 秒接入\n\n支持国内外主流企业消息平台，让团队在熟悉的工具中直接与 AI 对话。\n\n| 平台 | 协议 | 接入方式 | 文件发送 | 状态 |\n|------|------|----------|---------|------|\n| **企业微信** | 回调 API | 云中继 / 自建 | ✅ 全格式 | ✅ |\n| **微信公众号** | 云中继 | 10秒接入 | ✅ 图片/语音/视频 | ✅ |\n| **钉钉** | Stream Mode | 一键接入 | 🔜 计划中 | ✅ |\n| **飞书/Lark** | WebSocket | 一键接入 | 🔜 计划中 | ✅ |\n| **Slack** | Socket Mode | 一键接入 | 🔜 计划中 | ✅ |\n| **Telegram** | Bot API | 一键接入 | 🔜 计划中 | ✅ |\n| **Discord** | Gateway | 一键接入 | 🔜 计划中 | ✅ |\n| **WhatsApp** | Webhook + Graph API | 自建 | 🔜 计划中 | ✅ |\n| **LINE** | Webhook + Push API | 自建 | 🔜 计划中 | ✅ |\n| **Microsoft Teams** | Bot Framework | 自建 | 🔜 计划中 | ✅ |\n| **Matrix / Element** | HTTP Sync | 自建 | 🔜 计划中 | ✅ |\n| **Google Chat** | Webhook + REST | 自建 | 🔜 计划中 | ✅ |\n| **Mattermost** | WebSocket + REST | 自建 | 🔜 计划中 | ✅ |\n| **iMessage** | BlueBubbles | 自建 | 🔜 计划中 | ✅ |\n| **Signal** | signal-cli REST | 自建 | 🔜 计划中 | ✅ |\n| **Twitch** | IRC | 自建 | — | ✅ |\n| **NOSTR** | WebSocket Relays | 自建 | 🔜 计划中 | ✅ |\n| **Zalo** | Webhook + REST | 自建 | 🔜 计划中 | ✅ |\n| **Nextcloud Talk** | HTTP Polling | 自建 | 🔜 计划中 | ✅ |\n\n\u003e 文件发送详情（配置方法、支持的文件类型、限制）：[文件发送指南](docs/file-sending.md)\n\n\u003e 完整列表（含配置参数、环境变量）：[聊天平台列表](docs/chat-platforms.md)\n\n**云中继优势：** 无需公网服务器、无需域名备案、无需 HTTPS 证书、无需防火墙配置，5 分钟完成接入。\n\n### MCP 工具集 — 75+ 本地系统工具\n\n覆盖日常工作的方方面面，让 AI 成为你的全能助手。\n\n| 分类 | 工具数 | 功能 |\n|------|--------|------|\n| **文件操作** | 9 | 读写、搜索、整理、批量删除、废纸篓 |\n| **Shell 命令** | 2 | 命令执行、路径查找 |\n| **系统信息** | 4 | CPU、内存、磁盘、环境变量 |\n| **进程管理** | 3 | 列表、详情、终止 |\n| **网络工具** | 4 | 接口、连接、Ping、DNS |\n| **日历** | 6 | 查看、创建、搜索、删除日程 (macOS) |\n| **提醒事项** | 5 | 列表、添加、完成、删除 (macOS) |\n| **备忘录** | 6 | 文件夹、列表、读取、创建、搜索、删除 (macOS) |\n| **天气** | 2 | 当前天气、多日预报 |\n| **网页搜索** | 2 | DuckDuckGo 搜索、网页内容获取 |\n| **剪贴板** | 2 | 读写剪贴板 |\n| **截图** | 1 | 屏幕截图 |\n| **系统通知** | 1 | 发送桌面通知 |\n| **音乐控制** | 7 | 播放、暂停、切歌、音量、搜索 (macOS) |\n| **Git** | 4 | 状态、日志、差异、分支 |\n| **GitHub** | 6 | PR 列表/详情、Issue 管理、仓库信息 |\n| **[浏览器自动化](docs/browser-automation.md)** | 14 | CDP 控制引擎，可接管已有 Chrome，快照定位、点击/输入/JS、多标签页、截图 |\n| **定时任务** | 5 | 创建、列表、删除、暂停、恢复计划任务 |\n\n### 定时任务 — 自动化你的工作流\n\n使用标准 Cron 表达式调度周期性任务，支持两种模式：\n\n| | **AI 智能任务** (`prompt`) | **静态消息** (`message`) |\n|--|---------------------------|------------------------|\n| **内容** | 每次触发生成全新内容 | 每次发送相同文本 |\n| **工具调用** | 可调用 web_search、天气、日历等所有工具 | 无 |\n| **适用场景** | 新闻摘要、每日简报、随机鸡汤、学习提醒 | 固定提醒、打卡通知 |\n| **示例** | \"搜索最新AI新闻整理摘要\" | \"该喝水了！\" |\n\n**AI 智能任务** — 每次触发运行完整 AI 对话，内容永远不重复：\n\n```\n\"每小时43分发一段鸡汤激励我写代码\"\n\"每天早上9点搜索AI新闻发给我摘要\"\n\"每天中午教我一个Go语言技巧\"\n```\n\n**静态消息** — 每次发送固定文本：\n\n```\n\"每天早上9点提醒我开站会\"\n\"每小时提醒我喝水\"\n```\n\n\u003e 详细文档（完整示例、Cron 表达式、管理命令）：[定时任务指南](docs/cron-jobs.md)\n\n### 智能对话 — 多轮记忆，自然交流\n\n支持多轮对话记忆，能够记住之前的对话内容，实现连续自然的交流体验。\n\n| 特性 | 说明 |\n|------|------|\n| **上下文记忆** | 每个用户独立的对话上下文，最近 50 条消息 |\n| **自动过期** | 对话 60 分钟无活动后自动清除 |\n| **多 AI 后端** | [16 种 AI 服务](AI-PROVIDERS.md)按需切换 |\n| **对话管理** | `/new`、`/reset`、`新对话` 命令重置对话 |\n\n### 健康诊断 — 一键排查配置问题\n\n```bash\nlingti-bot doctor\n```\n\n```\nlingti-bot doctor\n=================\nOS: darwin/arm64, Go: go1.24.0\n\nChecks:\n  ✓ Config file (~/.lingti.yaml) — loaded\n  ✓ AI API key — set (sk-ant-a..., provider: claude)\n  ✓ AI provider connectivity — reachable (HTTP 200)\n  ✓ Platform credentials — wecom, telegram\n  ✓ Binary: gh — found\n  ✗ Binary: chrome — not found in PATH\n  ✓ Binary: claude — found\n  ✓ MCP server: chrome — command \"npx\" available\n  ✓ Temp directory — writable\n\n8 passed, 1 failed\n```\n\n检查项包括：配置文件、API 密钥、AI 连接、平台凭证、必需工具、CDP 连接、MCP 服务器、磁盘空间。\n\n### \u003ca id=\"per-channel-model\"\u003e\u003c/a\u003e按平台/频道模型切换\n\n为不同平台或频道配置不同的 AI 模型，在 `~/.lingti.yaml` 中声明：\n\n```yaml\nai:\n  provider: deepseek\n  api_key: sk-xxx\n  model: deepseek-chat\n\n  # 按平台/频道覆盖\n  overrides:\n    - platform: telegram\n      provider: claude\n      api_key: sk-ant-xxx\n      model: claude-sonnet-4-20250514\n    - platform: discord\n      provider: openai\n      api_key: sk-xxx\n      model: gpt-4o\n    - platform: slack\n      channel_id: C12345\n      provider: claude\n      api_key: sk-ant-xxx\n```\n\n匹配规则：先匹配 `platform + channel_id`（精确），再匹配 `platform`（宽泛），最后使用默认配置。\n\n### Claude 深度思考 — 原生 Extended Thinking API\n\n对 Claude 模型启用真正的链式推理（非提示词模拟），通过会话命令切换：\n\n| 命令 | 模式 | 思考 Token 预算 |\n|------|------|-----------------|\n| `/think off` | 关闭 | 0 |\n| `/think low` | 简单 | 1,024 |\n| `/think medium` | 中等（默认） | 4,096 |\n| `/think high` | 深度 | 16,384 |\n\n- **Claude 模型**：自动使用 Anthropic Thinking API，模型在回复前进行真正的内部推理\n- **其他模型**：降级为系统提示词引导的思考模式\n\n### Docker 部署\n\n```bash\n# 构建镜像\ndocker build -t lingti-bot .\n\n# 运行\ndocker run -e AI_API_KEY=sk-xxx -e TELEGRAM_BOT_TOKEN=xxx lingti-bot\n\n# 使用 docker-compose（推荐）\ndocker compose up -d\n```\n\n`docker-compose.yml` 支持配置文件挂载、环境变量注入，以及可选的 Chrome 容器用于浏览器自动化。\n\n### 语音交互 — 解放双手，畅快对话\n\n支持语音输入和语音输出，实现真正的免提 AI 交互体验。\n\n| 命令 | 说明 |\n|------|------|\n| `lingti-bot voice` | 按 Enter 录音，AI 处理后返回文字/语音响应 |\n| `lingti-bot talk` | 持续监听模式，支持唤醒词激活 |\n\n| 语音引擎 | 说明 |\n|----------|------|\n| **system** | 系统原生（macOS say/whisper-cpp，Linux espeak） |\n| **openai** | OpenAI TTS + Whisper API |\n| **elevenlabs** | ElevenLabs 高品质 TTS |\n\n**特点：** 本地语音识别（whisper-cpp）、多语言支持、唤醒词激活、连续对话模式。\n\n### Skills — 模块化能力扩展\n\nSkills 是模块化的能力包，教会 lingti-bot 如何使用外部工具。每个 Skill 是一个包含 `SKILL.md` 文件的目录，通过 YAML frontmatter 声明依赖和元数据，通过 Markdown 正文提供 AI 指令。\n\n```bash\n# 列出所有已发现的 Skills\nlingti-bot skills\n\n# 查看就绪状态\nlingti-bot skills check\n\n# 查看某个 Skill 的详细信息\nlingti-bot skills info github\n```\n\n内置 8 个 Skills：Discord、GitHub、Slack、Peekaboo（macOS UI 自动化）、Tmux、天气、1Password、Obsidian。支持用户自定义和项目级 Skills。\n\n详细文档：[Skills 指南](docs/skills.md)\n\n### 功能速览表\n\n| 模块 | 说明 | 特点 |\n|------|------|------|\n| **MCP Server** | 标准 MCP 协议服务器 | 兼容 Claude Desktop、Cursor、Windsurf 等所有 MCP 客户端 |\n| **多平台消息网关** | [19 种聊天平台](docs/chat-platforms.md) | 微信公众号、企业微信、Slack、飞书一键接入，支持云中继 |\n| **MCP 工具集** | 75+ 本地系统工具 | 文件、Shell、系统、网络、日历、Git、GitHub 等全覆盖 |\n| **Skills** | 模块化能力扩展 | 8 个内置 Skill，支持自定义和项目级扩展 |\n| **智能对话** | 多轮对话与记忆 | 上下文记忆、[16 种 AI 后端](AI-PROVIDERS.md)、按平台模型切换 |\n| **深度思考** | Claude Extended Thinking | 原生 Thinking API，4 级思考深度 |\n| **语音交互** | 语音输入/输出 | 本地 whisper-cpp、OpenAI、ElevenLabs 多引擎支持 |\n| **健康诊断** | `doctor` 命令 | 一键检查配置、连接、依赖 |\n| **Docker 部署** | 容器化 | 多阶段构建，docker-compose 支持 |\n\n## 云中继：零门槛接入企业消息平台\n\n\u003e **告别公网服务器、告别复杂配置，让 AI Bot 接入像配置 Wi-Fi 一样简单**\n\n传统接入企业微信等平台需要：公网服务器 → 域名备案 → HTTPS 证书 → 防火墙配置 → 回调服务开发...\n\n**lingti-bot 云中继** 将这一切简化为 3 步：\n\n```bash\n# 步骤 1: 安装\n# macOS / Linux / WSL:\ncurl -fsSL https://cli.lingti.com/install.sh | bash -s -- --bot\n# Windows (PowerShell):\nirm https://cli.lingti.com/install.ps1 -OutFile install.ps1; .\\install.ps1 -Bot\n\n# 步骤 2: 配置企业可信IP（应用管理 → 找到应用 → 企业可信IP → 添加 106.52.166.51）\n\n# 步骤 3: 一条命令搞定验证和消息处理\nlingti-bot relay --platform wecom \\\n  --wecom-corp-id ... --wecom-token ... --wecom-aes-key ... \\\n  --provider deepseek --api-key sk-xxx\n\n# 然后去企业微信后台配置回调 URL: https://bot.lingti.com/wecom\n```\n\n**工作原理：**\n\n```\n企业微信(用户消息) --\u003e bot.lingti.com(云中继) --WebSocket--\u003e lingti-bot(本地AI处理)\n```\n\n**优势对比：**\n\n| | 传统方案 | 云中继方案 |\n|---|---|---|\n| 公网服务器 | ✅ 需要 | ❌ 不需要 |\n| 域名/备案 | ✅ 需要 | ❌ 不需要 |\n| HTTPS证书 | ✅ 需要 | ❌ 不需要 |\n| 回调服务开发 | ✅ 需要 | ❌ 不需要 |\n| 接入时间 | 数天 | **5分钟** |\n| AI处理位置 | 服务器 | **本地** |\n| 数据安全 | 云端存储 | **本地处理** |\n\n\u003e 📖 **深入了解云中继的架构原理、协议规范和完整消息流程，请阅读 [云中继技术方案详解](docs/cloud-relay.md)**\n\u003e\n\u003e 详细对比请参考：[lingti-bot vs OpenClaw：简化 AI 集成的努力](docs/vs-openclaw-integration.md)\n\n### 微信公众号一键接入\n\n微信搜索公众号「**灵缇小秘**」，关注后发送任意消息获取接入教程，10秒将lingti-bot接入微信。\n详细教程请参考：[微信公众号接入指南](docs/wechat-integration.md)\n### 飞书接入\n\n- 飞书商店应用正在上架流程中，目前可通过自建应用实现绑定。教程请参考：[飞书集成指南](https://github.com/ruilisi/lingti-bot/blob/master/docs/feishu-integration.md)\n\n### 企业微信接入\n\n通过**云中继模式**，无需公网服务器即可接入企业微信：\n\n```bash\n# 1. 先去企业微信后台配置企业可信IP\n#    应用管理 → 找到应用 → 企业可信IP → 添加: 106.52.166.51\n\n# 2. 一条命令搞定验证和消息处理\nlingti-bot relay --platform wecom \\\n  --wecom-corp-id YOUR_CORP_ID \\\n  --wecom-agent-id YOUR_AGENT_ID \\\n  --wecom-secret YOUR_SECRET \\\n  --wecom-token YOUR_TOKEN \\\n  --wecom-aes-key YOUR_AES_KEY \\\n  --provider deepseek \\\n  --api-key YOUR_API_KEY\n\n# 3. 去企业微信后台配置回调 URL: https://bot.lingti.com/wecom\n#    保存配置后验证自动完成，消息立即可以处理\n```\n\n详细教程请参考：[企业微信集成指南](docs/wecom-integration.md) | [云中继技术方案详解](docs/cloud-relay.md)\n\n### 钉钉接入\n\n使用 **Stream 模式**，无需公网服务器即可接入钉钉机器人：\n\n```bash\n# 一条命令搞定\nlingti-bot router \\\n  --dingtalk-client-id YOUR_APP_KEY \\\n  --dingtalk-client-secret YOUR_APP_SECRET \\\n  --provider deepseek \\\n  --api-key YOUR_API_KEY\n```\n\n**配置步骤：**\n1. 登录 [钉钉开放平台](https://open.dingtalk.com/)，创建企业内部应用\n2. 在应用详情页获取 AppKey (ClientID) 和 AppSecret (ClientSecret)\n3. 开启机器人功能，配置消息接收模式为 **Stream 模式**\n4. 运行上述命令即可\n\n## Sponsors\n\n- **[灵缇游戏加速](https://game.lingti.com)** - PC/Mac/iOS/Android 全平台游戏加速、热点加速、AI 及学术资源定向加速，And More\n- **[灵缇路由](https://router.lingti.com)** - 您的路由管家、网游电竞专家\n\n## lingti-cli 生态\n\n**lingti-bot** 是 **lingti-cli** 五位一体平台的核心开源组件。\n\n我们正在打造 **AI 时代开发者与知识工作者的终极效率平台**：\n\n| 模块 | 定位 | 说明 |\n|------|------|------|\n| **CLI** | 操控总台 | 统一入口，如同操作系统的引导程序 |\n| **Net** | 全球网络 | 跨洲 200Mbps 加速，畅享全球 AI 服务 |\n| **Token** | 数字员工 | Token 即代码，代码即生产力 |\n| **Bot** | 助理管理 | 数字员工接入与管理，简单到极致 ← *本项目* |\n| **Code** | 开发环境 | Terminal 回归舞台中央，极致输入效率 |\n\n\u003e **为什么是 cli.lingti.com/bot 而不是 bot.lingti.com？**\n\u003e\n\u003e 因为 Bot 是 CLI 生态的一部分。IDE 正在消亡，纯粹的 Terminal 界面正在回归。未来的生产力工具，将围绕 CLI 重新构建。\n\n**联系我们 / 加入我们**\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003cth align=\"center\" width=\"56%\"\u003e邮件联系\u003c/th\u003e\n    \u003cth align=\"center\" width=\"44%\"\u003e扫码加群\u003c/th\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd width=\"56%\"\u003e\n      无论您是追求极致效率的顶尖开发者、关注 AI 时代生产力变革的投资人，还是想成为 Sponsor，\n      欢迎联系：\n      \u003ccode\u003ejiefeng@ruc.edu.cn\u003c/code\u003e\n      /\n      \u003ccode\u003ejiefeng.hopkins@gmail.com\u003c/code\u003e\n    \u003c/td\u003e\n    \u003ctd width=\"44%\" align=\"center\"\u003e\n      \u003cimg src=\"https://lingti-1302055788.cos.ap-guangzhou.myqcloud.com/contact_me_qr-2.png\" alt=\"扫码加群\" width=\"230\" /\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n```\n                              lingti-bot\n    +---------------+    +---------------+    +---------------+\n    |  MCP Server   |    |   Message     |    |    Agent      |\n    |   (stdio)     |    |   Gateway     |    |   (Claude)    |\n    +-------+-------+    +-------+-------+    +-------+-------+\n            |                    |                    |\n            +--------------------+--------------------+\n                                 |\n                                 v\n                       +-------------------+\n                       |    MCP Tools      |\n                       | Files, Shell, Net |\n                       | System, Calendar  |\n                       | Browser Automation|\n                       +-------------------+\n                                 |\n            +--------------------+--------------------+\n            |                                         |\n            v                                         v\n    +---------------+                       +------------------+\n    | Claude Desktop|                       | Slack / Feishu   |\n    | Cursor, etc.  |                       | Messaging Apps   |\n    +---------------+                       +------------------+\n```\n\n---\n\n## MCP Server\n\n灵小缇作为标准 MCP (Model Context Protocol) 服务器，让任何支持 MCP 的 AI 客户端都能访问本地系统资源。\n\n### 支持的客户端\n\n- **Claude Desktop** - Anthropic 官方桌面客户端\n- **Cursor** - AI 代码编辑器\n- **其他 MCP 客户端** - 任何实现 MCP 协议的应用\n\n### 快速配置\n\n**Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json`)：\n\n```json\n{\n  \"mcpServers\": {\n    \"lingti-bot\": {\n      \"command\": \"/path/to/lingti-bot\",\n      \"args\": [\"serve\"]\n    }\n  }\n}\n```\n\n**Cursor** (`.cursor/mcp.json`)：\n\n```json\n{\n  \"mcpServers\": {\n    \"lingti-bot\": {\n      \"command\": \"/path/to/lingti-bot\",\n      \"args\": [\"serve\"]\n    }\n  }\n}\n```\n\n就这么简单！重启客户端后，AI 助手即可使用所有 lingti-bot 提供的工具。\n\n### 特点\n\n- **无需额外配置** - 一个二进制文件，两行配置\n- **无需数据库** - 无外部依赖\n- **无需 Docker** - 单一静态二进制\n- **无需云服务** - 完全本地运行\n\n---\n\n## 多平台消息网关\n\n灵小缇支持多种企业消息平台，让你的团队在熟悉的工具中直接与 AI 对话。\n\n### 支持的平台\n\n| 平台 | 协议 | 状态 |\n|------|------|------|\n| **企业微信** | 回调 API | ✅ 已支持 |\n| **微信公众号** | 云中继 | ✅ 已支持 |\n| **钉钉** | Stream Mode | ✅ 已支持 |\n| **飞书/Lark** | WebSocket | ✅ 已支持 |\n| **Slack** | Socket Mode | ✅ 已支持 |\n| **Telegram** | Bot API | ✅ 已支持 |\n| **Discord** | Gateway | ✅ 已支持 |\n| **WhatsApp** | Webhook + Graph API | ✅ 已支持 |\n| **LINE** | Webhook + Push API | ✅ 已支持 |\n| **Microsoft Teams** | Bot Framework | ✅ 已支持 |\n| **Matrix / Element** | HTTP Sync | ✅ 已支持 |\n| **Google Chat** | Webhook + REST | ✅ 已支持 |\n| **Mattermost** | WebSocket + REST | ✅ 已支持 |\n| **iMessage** | BlueBubbles | ✅ 已支持 |\n| **Signal** | signal-cli REST | ✅ 已支持 |\n| **Twitch** | IRC | ✅ 已支持 |\n| **NOSTR** | WebSocket Relays | ✅ 已支持 |\n| **Zalo** | Webhook + REST | ✅ 已支持 |\n| **Nextcloud Talk** | HTTP Polling | ✅ 已支持 |\n\n\u003e 完整列表：[聊天平台列表](docs/chat-platforms.md)\n\n### 一键接入\n\n灵小缇提供 **1 分钟内一键接入**方式，无需复杂配置：\n\n```bash\n# 设置 API 密钥\nexport ANTHROPIC_API_KEY=\"sk-ant-your-api-key\"\n\n# Slack 一键接入\nexport SLACK_BOT_TOKEN=\"xoxb-...\"\nexport SLACK_APP_TOKEN=\"xapp-...\"\n\n# 飞书一键接入\nexport FEISHU_APP_ID=\"cli_...\"\nexport FEISHU_APP_SECRET=\"...\"\n\n# 启动网关\n./lingti-bot router\n```\n\n### 多 AI 后端\n\n支持 **16 种 AI 服务**，涵盖国内外主流大模型平台，按需切换：\n\n| # | Provider | 名称 | 默认模型 |\n|---|----------|------|----------|\n| 1 | `deepseek` | DeepSeek (推荐) | `deepseek-chat` |\n| 2 | `qwen` | 通义千问 (Qwen) | `qwen-plus` |\n| 3 | `claude` | Claude (Anthropic) | `claude-sonnet-4-20250514` |\n| 4 | `kimi` | Kimi / 月之暗面 | `moonshot-v1-8k` |\n| 5 | `minimax` | MiniMax / 海螺 AI | `MiniMax-Text-01` |\n| 6 | `doubao` | 豆包 (ByteDance) | `doubao-pro-32k` |\n| 7 | `zhipu` | 智谱 GLM | `glm-4-flash` |\n| 8 | `openai` | OpenAI (GPT) | `gpt-4o` |\n| 9 | `gemini` | Gemini (Google) | `gemini-2.0-flash` |\n| 10 | `yi` | 零一万物 (Yi) | `yi-large` |\n| 11 | `stepfun` | 阶跃星辰 (StepFun) | `step-2-16k` |\n| 12 | `baichuan` | 百川智能 (Baichuan) | `Baichuan4` |\n| 13 | `spark` | 讯飞星火 (iFlytek) | `generalv3.5` |\n| 14 | `siliconflow` | 硅基流动 (aggregator) | `Qwen/Qwen2.5-72B-Instruct` |\n| 15 | `grok` | Grok (xAI) | `grok-2-latest` |\n| 16 | `ollama` | Ollama (本地) | `llama3.2` |\n\n\u003e 完整列表（含 API Key 获取链接、别名）：[AI 服务列表](AI-PROVIDERS.md)\n\n```bash\n# 使用命令行参数指定\nlingti-bot router --provider qwen --api-key \"sk-xxx\" --model \"qwen-plus\"\n\n# 覆盖默认模型\nlingti-bot relay --provider openai --api-key \"sk-xxx\" --model \"gpt-4o-mini\"\n```\n\n### 详细文档\n\n- [配置优先级](CONFIGURATION.md) - 命令行参数 \u003e 环境变量 \u003e 配置文件的解析机制\n- [AI 服务列表](AI-PROVIDERS.md) - 16 种 AI 服务详情、API Key 获取、别名\n- [聊天平台列表](docs/chat-platforms.md) - 19 种聊天平台详情、配置参数、环境变量\n- [命令行参考](docs/cli-reference.md) - 完整的命令行使用文档\n- [Skills 指南](docs/skills.md) - Skills 系统详解：创建、发现、配置\n- [Slack 集成指南](docs/slack-integration.md) - 完整的 Slack 应用配置教程\n- [飞书集成指南](docs/feishu-integration.md) - 飞书/Lark 应用配置教程\n- [企业微信集成指南](docs/wecom-integration.md) - 企业微信应用配置教程\n- [文件发送指南](docs/file-sending.md) - 各平台文件传输能力、配置与限制\n- [定时任务指南](docs/cron-jobs.md) - AI 智能任务 vs 静态消息、Cron 表达式、管理命令\n- [浏览器自动化指南](docs/browser-automation.md) - CDP 引擎、接管已有 Chrome、14 个工具完整参考、典型场景与故障排除\n- [浏览器 AI 操作规则](docs/browser-agent-rules.md) - AI agent 的所有浏览器行为规则：快照法则、搜索行为、弹窗处理、批量操作、连接模式、常见错误纠正\n- [社交平台自动化指南](docs/social-platform-automation.md) - 知乎、小红书等内容平台的 AI 自动化运营\n- [OpenClaw 技术特性对比](docs/openclaw-feature-comparison.md) - 详细功能差异分析\n\n---\n\n## MCP 工具集\n\n灵小缇提供 **75+ MCP 工具**，覆盖日常工作的方方面面。包含全新的[浏览器自动化](docs/browser-automation.md)能力。\n\n### 工具分类\n\n| 分类 | 工具数 | 说明 |\n|------|--------|------|\n| 文件操作 | 9 | 读写、搜索、整理、废纸篓 |\n| Shell 命令 | 2 | 命令执行、路径查找 |\n| 系统信息 | 4 | CPU、内存、磁盘、环境变量 |\n| 进程管理 | 3 | 列表、详情、终止 |\n| 网络工具 | 4 | 接口、连接、Ping、DNS |\n| 日历 (macOS) | 6 | 查看、创建、搜索、删除 |\n| 提醒事项 (macOS) | 5 | 列表、添加、完成、删除 |\n| 备忘录 (macOS) | 6 | 文件夹、列表、读取、创建、搜索、删除 |\n| 天气 | 2 | 当前天气、预报 |\n| 网页搜索 | 2 | DuckDuckGo 搜索、网页获取 |\n| 剪贴板 | 2 | 读写剪贴板 |\n| 截图 | 1 | 屏幕截图 |\n| 系统通知 | 1 | 发送通知 |\n| 音乐控制 (macOS) | 7 | 播放、暂停、切歌、音量 |\n| Git | 4 | 状态、日志、差异、分支 |\n| GitHub | 6 | PR、Issue、仓库信息 |\n| [浏览器自动化](docs/browser-automation.md) | 14 | 快照、点击、输入、JS 执行、批量操作、截图、标签页 |\n\n### 文件操作\n\n| 工具 | 功能 |\n|------|------|\n| `file_read` | 读取文件内容 |\n| `file_write` | 写入文件内容 |\n| `file_list` | 列出目录内容 |\n| `file_search` | 按模式搜索文件 |\n| `file_info` | 获取文件详细信息 |\n| `file_list_old` | 列出长时间未修改的文件 |\n| `file_delete_old` | 删除长时间未修改的文件 |\n| `file_delete_list` | 批量删除指定文件 |\n| `file_trash` | 移动文件到废纸篓（macOS） |\n\n### Shell 命令\n\n| 工具 | 功能 |\n|------|------|\n| `shell_execute` | 执行 Shell 命令 |\n| `shell_which` | 查找可执行文件路径 |\n\n### 系统信息\n\n| 工具 | 功能 |\n|------|------|\n| `system_info` | 获取系统信息（CPU、内存、OS） |\n| `disk_usage` | 获取磁盘使用情况 |\n| `env_get` | 获取环境变量 |\n| `env_list` | 列出所有环境变量 |\n\n### 进程管理\n\n| 工具 | 功能 |\n|------|------|\n| `process_list` | 列出运行中的进程 |\n| `process_info` | 获取进程详细信息 |\n| `process_kill` | 终止进程 |\n\n### 网络工具\n\n| 工具 | 功能 |\n|------|------|\n| `network_interfaces` | 列出网络接口 |\n| `network_connections` | 列出活动网络连接 |\n| `network_ping` | TCP 连接测试 |\n| `network_dns_lookup` | DNS 查询 |\n\n### 日历（macOS）\n\n| 工具 | 功能 |\n|------|------|\n| `calendar_today` | 获取今日日程 |\n| `calendar_list_events` | 列出未来事件 |\n| `calendar_create_event` | 创建日历事件 |\n| `calendar_search` | 搜索日历事件 |\n| `calendar_delete_event` | 删除日历事件 |\n| `calendar_list_calendars` | 列出所有日历 |\n\n### 提醒事项（macOS）\n\n| 工具 | 功能 |\n|------|------|\n| `reminders_today` | 获取今日待办事项 |\n| `reminders_add` | 添加新提醒 |\n| `reminders_complete` | 标记提醒为已完成 |\n| `reminders_delete` | 删除提醒 |\n| `reminders_list_lists` | 列出所有提醒列表 |\n\n### 备忘录（macOS）\n\n| 工具 | 功能 |\n|------|------|\n| `notes_list_folders` | 列出备忘录文件夹 |\n| `notes_list` | 列出备忘录 |\n| `notes_read` | 读取备忘录内容 |\n| `notes_create` | 创建新备忘录 |\n| `notes_search` | 搜索备忘录 |\n| `notes_delete` | 删除备忘录 |\n\n### 天气\n\n| 工具 | 功能 |\n|------|------|\n| `weather_current` | 获取当前天气 |\n| `weather_forecast` | 获取天气预报 |\n\n### 网页搜索\n\n| 工具 | 功能 |\n|------|------|\n| `web_search` | DuckDuckGo 搜索 |\n| `web_fetch` | 获取网页内容 |\n\n### 剪贴板\n\n| 工具 | 功能 |\n|------|------|\n| `clipboard_read` | 读取剪贴板内容 |\n| `clipboard_write` | 写入剪贴板 |\n\n### 系统通知\n\n| 工具 | 功能 |\n|------|------|\n| `notification_send` | 发送系统通知 |\n\n### 截图\n\n| 工具 | 功能 |\n|------|------|\n| `screenshot` | 截取屏幕截图 |\n\n### 音乐控制（macOS）\n\n| 工具 | 功能 |\n|------|------|\n| `music_play` | 播放音乐 |\n| `music_pause` | 暂停音乐 |\n| `music_next` | 下一首 |\n| `music_previous` | 上一首 |\n| `music_now_playing` | 获取当前播放信息 |\n| `music_volume` | 设置音量 |\n| `music_search` | 搜索并播放音乐 |\n\n### Git\n\n| 工具 | 功能 |\n|------|------|\n| `git_status` | 查看仓库状态 |\n| `git_log` | 查看提交日志 |\n| `git_diff` | 查看文件差异 |\n| `git_branch` | 查看分支信息 |\n\n### GitHub\n\n| 工具 | 功能 |\n|------|------|\n| `github_pr_list` | 列出 Pull Requests |\n| `github_pr_view` | 查看 PR 详情 |\n| `github_issue_list` | 列出 Issues |\n| `github_issue_view` | 查看 Issue 详情 |\n| `github_issue_create` | 创建新 Issue |\n| `github_repo_view` | 查看仓库信息 |\n\n### 浏览器自动化\n\n基于 [go-rod](https://github.com/go-rod/rod) 的纯 Go 浏览器自动化引擎，采用**快照-操作（Snapshot-then-Act）**模式，可接管已有 Chrome 窗口，无需 Puppeteer/Playwright/Node.js。\n\n\u003e 📖 完整指南：[浏览器自动化文档](docs/browser-automation.md)\n\n**连接已有 Chrome（推荐）：**\n\n```yaml\n# ~/.lingti.yaml\nbrowser:\n  cdp_url: \"127.0.0.1:9222\"   # Chrome 需以 --remote-debugging-port=9222 启动\n  screen_size: \"1920x1080\"     # 或 \"fullscreen\"\n```\n\n**核心工作流：**\n\n```\nbrowser_snapshot  →  [1] textbox \"搜索\"  [2] button \"搜索\"  [3] link \"登录\"\nbrowser_type ref=1 text=\"keyword\"\nbrowser_click ref=2\nbrowser_snapshot  →  重新获取编号（页面变化后必须重新 snapshot）\n```\n\n**14 个工具完整列表：**\n\n| 工具 | 功能 |\n|------|------|\n| `browser_start` | 启动新浏览器，或连接已有 Chrome（`cdp_url` 参数） |\n| `browser_stop` | 关闭浏览器；CDP 连接模式下只断开，不关闭 Chrome |\n| `browser_status` | 查看运行状态（是否 connected、页面数、当前 URL） |\n| `browser_navigate` | 导航到 URL，自动等待页面加载，浏览器未启动时自动按优先级连接 |\n| `browser_snapshot` | 获取无障碍树快照，为每个可交互元素分配数字 ref |\n| `browser_screenshot` | 截图，支持视口截图或整页截图，`full_page=true` |\n| `browser_click` | 按 ref 编号点击元素，自动滚动到可见位置 |\n| `browser_type` | 按 ref 编号输入文本，`submit=true` 输入后按 Enter |\n| `browser_press` | 按键（Enter、Tab、Escape、方向键、PageUp/Down 等） |\n| `browser_execute_js` | 在当前页面执行任意 JavaScript，返回结果字符串 |\n| `browser_click_all` | 按 CSS 选择器批量点击，支持间隔延迟和跳过条件 |\n| `browser_tabs` | 列出所有标签页（target_id、url、title） |\n| `browser_tab_open` | 打开新标签页，可指定初始 URL |\n| `browser_tab_close` | 按 target_id 关闭标签页，或关闭当前活跃标签页 |\n\n### 其他\n\n| 工具 | 功能 |\n|------|------|\n| `open_url` | 在浏览器中打开 URL |\n\n---\n\n## 智能对话\n\n灵小缇支持**多轮对话记忆**，能够记住之前的对话内容，实现连续自然的交流体验。\n\n### 工作原理\n\n- 每个用户在每个频道有独立的对话上下文\n- 自动保存最近 **50 条消息**\n- 对话 **60 分钟**无活动后自动过期\n- 支持跨多轮对话的上下文理解\n\n### 使用示例\n\n```\n用户：我叫小明，今年25岁\nAI：你好小明！很高兴认识你。\n\n用户：我叫什么名字？\nAI：你叫小明。\n\n用户：我多大了？\nAI：你今年25岁。\n\n用户：帮我创建一个日程，标题就用我的名字\nAI：好的，我帮你创建了一个标题为\"小明\"的日程。\n```\n\n### 对话管理命令\n\n| 命令 | 说明 |\n|------|------|\n| `/new` | 开始新对话，清除历史记忆 |\n| `/reset` | 同上 |\n| `/clear` | 同上 |\n| `新对话` | 中文命令，开始新对话 |\n| `清除历史` | 中文命令，清除对话历史 |\n\n\u003e **提示**：当你想让 AI \"忘记\"之前的内容重新开始时，只需发送 `/new` 即可。\n\n---\n\n## 语音交互\n\n灵小缇支持**语音输入和语音输出**，让你可以完全通过语音与 AI 交互，解放双手。\n\n### 两种模式\n\n| 模式 | 命令 | 说明 |\n|------|------|------|\n| **Voice 模式** | `lingti-bot voice` | 按 Enter 开始录音，录音结束后 AI 处理并响应 |\n| **Talk 模式** | `lingti-bot talk` | 持续监听，支持唤醒词激活，连续对话 |\n\n### 语音引擎\n\n| 引擎 | STT（语音转文字） | TTS（文字转语音） | 说明 |\n|------|------------------|------------------|------|\n| **system** | whisper-cpp | macOS say / Linux espeak | 本地处理，无需联网 |\n| **openai** | Whisper API | OpenAI TTS | 云端处理，效果好 |\n| **elevenlabs** | - | ElevenLabs API | 高品质语音合成 |\n\n### 快速开始\n\n```bash\n# Voice 模式（按 Enter 录音）\nlingti-bot voice --api-key sk-xxx\n\n# 指定录音时长和语言\nlingti-bot voice -d 10 -l zh --api-key sk-xxx\n\n# 启用语音回复\nlingti-bot voice --speak --api-key sk-xxx\n\n# Talk 模式（持续监听）\nlingti-bot talk --api-key sk-xxx\n\n# 使用 OpenAI 语音引擎\nlingti-bot voice --provider openai --voice-api-key sk-xxx --api-key sk-xxx\n```\n\n### 环境变量\n\n| 变量 | 说明 |\n|------|------|\n| `VOICE_PROVIDER` | 语音引擎：system、openai、elevenlabs |\n| `VOICE_API_KEY` | 语音 API 密钥（OpenAI 或 ElevenLabs） |\n| `WHISPER_MODEL` | whisper-cpp 模型路径 |\n| `WAKE_WORD` | 唤醒词（如 \"hey lingti\"） |\n\n\u003e **提示**：首次使用 system 引擎时会自动下载 whisper-cpp 模型（约 141MB）。\n\n---\n\n## 快速开始\n\n### 其他安装方式\n\n**从源码编译**\n\n```bash\ngit clone https://github.com/ruilisi/lingti-bot.git\ncd lingti-bot\nmake build  # 或: make darwin-arm64 / make linux-amd64\n```\n\n**手动下载**\n\n前往 [GitHub Releases](https://github.com/ruilisi/lingti-bot/releases) 下载对应平台的二进制文件。\n\n### 使用方式\n\n**方式一：MCP Server 模式**\n\n配置 Claude Desktop 或 Cursor，详见 [MCP Server](#mcp-server) 章节。\n\n**方式二：消息网关模式**\n\n连接 Slack、飞书等平台，详见 [多平台消息网关](#多平台消息网关) 章节。\n\n---\n\n## 使用示例\n\n配置完成后，你可以让 AI 助手执行以下操作：\n\n### 日历与日程\n\n```\n\"今天有什么日程安排？\"\n\"这周有哪些会议？\"\n\"帮我创建一个明天下午3点的会议，标题是'产品评审'\"\n\"搜索所有包含'周报'的日程\"\n```\n\n### 文件操作与传输\n\n```\n\"列出桌面上的所有文件\"\n\"读取 ~/Documents/notes.txt 的内容\"\n\"将 ~/Desktop/报告.pdf 发送给我\"\n\"把 Documents 里的产品介绍发给我\"\n\"桌面上超过30天没动过的文件有哪些？\"\n\"帮我把这些旧文件移到废纸篓\"\n```\n\n### 系统与进程\n\n```\n\"我的电脑配置是什么？\"\n\"现在 CPU 占用多少？\"\n\"Chrome 占用了多少内存？\"\n\"结束 PID 1234 的进程\"\n```\n\n### 网络与搜索\n\n```\n\"我的 IP 地址是什么？\"\n\"帮我搜索一下最新的 AI 新闻\"\n\"查询 github.com 的 DNS\"\n```\n\n### 音乐控制\n\n```\n\"播放音乐\"\n\"下一首\"\n\"音量调到 50%\"\n\"播放周杰伦的歌\"\n```\n\n### 组合任务\n\n```\n\"查看今天的日程，然后检查天气，最后列出待办事项\"\n\"帮我整理桌面：列出超过60天的旧文件，然后移到废纸篓\"\n\"搜索最近的科技新闻，整理成备忘录\"\n```\n\n---\n\n## 项目结构\n\n```\nlingti-bot/\n├── main.go                 # 程序入口\n├── Makefile                # 构建脚本\n├── Dockerfile              # 多阶段 Docker 构建\n├── docker-compose.yml      # 容器编排\n├── go.mod                  # Go 模块定义\n│\n├── cmd/                    # 命令行接口\n│   ├── root.go             # 根命令\n│   ├── serve.go            # MCP 服务器命令\n│   ├── doctor.go           # 健康诊断命令\n│   ├── service.go          # 系统服务管理\n│   └── version.go          # 版本信息\n│\n├── internal/\n│   ├── mcp/\n│   │   └── server.go       # MCP 服务器实现\n│   │\n│   ├── browser/            # 浏览器自动化引擎\n│   │   ├── browser.go      # 浏览器生命周期管理\n│   │   ├── snapshot.go     # 无障碍树快照与 ref 映射\n│   │   └── actions.go      # 元素交互（点击、输入、悬停）\n│   │\n│   ├── tools/              # MCP 工具实现\n│   │   ├── filesystem.go   # 文件读写、列表、搜索\n│   │   ├── shell.go        # Shell 命令执行\n│   │   ├── system.go       # 系统信息、磁盘、环境变量\n│   │   ├── process.go      # 进程列表、信息、终止\n│   │   ├── network.go      # 网络接口、连接、DNS\n│   │   ├── calendar.go     # macOS 日历集成\n│   │   ├── filemanager.go  # 文件整理（清理旧文件）\n│   │   ├── reminders.go    # macOS 提醒事项\n│   │   ├── notes.go        # macOS 备忘录\n│   │   ├── weather.go      # 天气查询（wttr.in）\n│   │   ├── websearch.go    # 网页搜索和获取\n│   │   ├── clipboard.go    # 剪贴板读写\n│   │   ├── notification.go # 系统通知\n│   │   ├── screenshot.go   # 屏幕截图\n│   │   ├── browser.go      # 浏览器自动化工具（12个）\n│   │   └── music.go        # 音乐控制（Spotify/Apple Music）\n│   │\n│   ├── router/\n│   │   └── router.go       # 多平台消息路由器\n│   │\n│   ├── platforms/          # 消息平台集成\n│   │   ├── slack/\n│   │   │   └── slack.go    # Slack Socket Mode\n│   │   └── feishu/\n│   │       └── feishu.go   # 飞书 WebSocket\n│   │\n│   ├── agent/\n│   │   ├── agent.go        # Agent 主逻辑与工具定义\n│   │   ├── pool.go         # Agent 连接池（按平台模型切换）\n│   │   ├── provider.go     # AI Provider 接口\n│   │   ├── provider_claude.go  # Claude 实现（含 Extended Thinking）\n│   │   ├── session.go      # 会话设置（思考级别）\n│   │   ├── tools.go        # 工具执行\n│   │   └── memory.go       # 会话记忆\n│   │\n│   └── service/\n│       └── manager.go      # 系统服务管理\n│\n└── docs/                   # 文档\n    ├── slack-integration.md    # Slack 集成指南\n    ├── feishu-integration.md   # 飞书集成指南\n    └── openclaw-reference.md   # 架构参考\n```\n\n---\n\n## Make 目标\n\n```bash\n# 开发\nmake build          # 编译当前平台\nmake run            # 本地运行\nmake test           # 运行测试\nmake fmt            # 格式化代码\nmake lint           # 代码检查\nmake clean          # 清理构建产物\nmake version        # 显示版本\n\n# 跨平台编译\nmake darwin-arm64   # macOS Apple Silicon\nmake darwin-amd64   # macOS Intel\nmake darwin-universal # macOS 通用二进制\nmake linux-amd64    # Linux x64\nmake linux-arm64    # Linux ARM64\nmake linux-all      # 所有 Linux 平台\nmake all            # 所有平台\n\n# 服务管理\nmake install        # 安装为系统服务\nmake uninstall      # 卸载系统服务\nmake start          # 启动服务\nmake stop           # 停止服务\nmake status         # 查看服务状态\n\n# macOS 签名\nmake codesign       # 代码签名（需要开发者证书）\n```\n\n---\n\n## 命令行选项\n\n### 全局选项\n\n这些选项可用于所有命令，放在子命令之前使用。\n\n| 选项 | 简写 | 说明 | 默认值 |\n|------|------|------|--------|\n| `--yes` | `-y` | **自动批准模式** - 跳过所有确认提示，直接执行操作 | `false` |\n| `--debug` | - | **调试模式** - 启用详细日志和浏览器截图 | `false` |\n| `--log \u003clevel\u003e` | - | **日志级别** - silent, info, verbose, very-verbose | `info` |\n| `--debug-dir \u003cpath\u003e` | - | **调试目录** - 保存调试截图的路径 | `/tmp/lingti-bot` |\n\n#### 自动批准模式 (`--yes`)\n\n启用后，AI 将立即执行文件写入、删除、Shell 命令等操作，无需每次询问确认。\n\n**适用场景：**\n- ✅ 批量文件处理\n- ✅ 代码生成和重构\n- ✅ 文档自动更新\n- ✅ CI/CD 自动化流程\n- ✅ 信任环境下的快速操作\n\n**不适用场景：**\n- ❌ 生产环境服务器\n- ❌ 共享系统\n- ❌ 首次尝试新操作\n- ❌ 涉及敏感数据\n\n**使用示例：**\n\n```bash\n# 启用自动批准\nlingti-bot --yes router --provider deepseek --api-key sk-xxx\n\n# 简写形式\nlingti-bot -y router --provider deepseek --api-key sk-xxx\n\n# 结合调试模式\nlingti-bot --yes --debug router --provider deepseek --api-key sk-xxx\n```\n\n**行为对比：**\n\n```bash\n# 不使用 --yes（默认）\n用户：保存这个文件到 config.yaml\nAI：  我已经准备好内容。是否确认保存到 config.yaml？\n用户：是的\nAI：  ✅ 已保存到 config.yaml\n\n# 使用 --yes\n用户：保存这个文件到 config.yaml\nAI：  ✅ 已保存到 config.yaml (247 字节)\n```\n\n**安全提示：**\n- 在 git 仓库中使用 `--yes` 最安全，可随时通过 `git diff` 查看变更\n- 建议先在测试目录中尝试 `--yes` 模式\n- 即使启用 `--yes`，危险操作（如 `rm -rf /`）仍会被拒绝\n\n详细文档：\n- [自动批准完整指南](docs/auto-approval.md)\n- [快速参考](docs/auto-approval-quickref.md)\n\n#### 调试模式 (`--debug`)\n\n启用后自动设置日志级别为 `very-verbose`，并在浏览器操作出错时保存截图。\n\n```bash\nlingti-bot --debug router --provider deepseek --api-key sk-xxx\n```\n\n详细文档：\n- [浏览器调试指南](docs/browser-debug.md)\n- [快速参考](docs/browser-debug-quickref.md)\n\n---\n\n## 配置优先级\n\n所有配置项按以下优先级解析：**命令行参数 \u003e 环境变量 \u003e 配置文件 (`~/.lingti.yaml`)**\n\n```bash\n# 配置文件已保存 provider: qwen，但命令行覆盖为 deepseek\nlingti-bot relay --provider deepseek\n```\n\n完整的环境变量、命令行参数、配置文件对照表请参考：[配置优先级](CONFIGURATION.md)\n\n---\n\n## 数据文件\n\nlingti-bot 在用户主目录下存储以下文件：\n\n| 路径 | 说明 |\n|------|------|\n| `~/.lingti.yaml` | 配置文件（AI 服务、平台密钥等） |\n| `~/.lingti.db` | SQLite 数据库（定时任务等持久化数据） |\n| `~/.lingti.db-wal` | SQLite WAL 日志（自动管理，勿手动删除） |\n| `~/.lingti.db-shm` | SQLite 共享内存（自动管理，勿手动删除） |\n| `~/.lingti-bot/browser/` | 浏览器自动化的用户数据目录 |\n\n---\n\n## 安全注意事项\n\n- lingti-bot 提供对本地系统的访问能力，请在可信环境中使用\n- Shell 命令执行有基本的危险命令过滤，但仍需谨慎\n- API 密钥等敏感信息请使用环境变量，不要提交到版本控制\n- 生产环境建议使用专用服务账号运行\n\n---\n\n## 依赖\n\n- [mcp-go](https://github.com/mark3labs/mcp-go) - MCP 协议 Go 实现\n- [cobra](https://github.com/spf13/cobra) - CLI 框架\n- [gopsutil](https://github.com/shirou/gopsutil) - 系统信息\n- [slack-go](https://github.com/slack-go/slack) - Slack SDK\n- [oapi-sdk-go](https://github.com/larksuite/oapi-sdk-go) - 飞书/Lark SDK\n- [go-anthropic](https://github.com/liushuangls/go-anthropic) - Anthropic API 客户端\n\n---\n\n## 许可证\n\nMIT License\n\n---\n\n## 贡献\n\n欢迎提交 Issue 和 Pull Request！\n\n---\n\n## 开发环境\n\n本项目完全在 **[lingti-code](https://cli.lingti.com/code)** 环境中编写完成。\n\n### 关于 lingti-code\n\n[lingti-code](https://github.com/ruilisi/lingti-code) 是一个一体化的 AI 就绪开发环境平台，基于 **Tmux + Neovim + Zsh** 构建，支持 macOS、Ubuntu 和 Docker 部署。\n\n**核心组件：**\n\n- **Shell** - ZSH + Prezto 框架，100+ 常用别名和函数，fasd 智能导航\n- **Editor** - Neovim + SpaceVim 发行版，LSP 集成，GitHub Copilot 支持\n- **Terminal** - Tmux 终端复用，vim 风格键绑定，会话管理\n- **版本控制** - Git 最佳实践配置，丰富的 Git 别名\n- **开发工具** - asdf 版本管理器，ctags，IRB/Pry 增强\n\n**AI 集成：**\n\n- Claude Code CLI 配置，支持项目感知的 CLAUDE.md 文件\n- 自定义状态栏显示 Token 用量\n- 预配置 LSP 插件（Python basedpyright、Go gopls）\n\n**一键安装：**\n\n```bash\nbash -c \"$(curl -fsSL https://raw.githubusercontent.com/lingti/lingti-code/master/install.sh)\"\n```\n\n更多信息请访问：[官网](https://cli.lingti.com/code) | [GitHub](https://github.com/ruilisi/lingti-code)\n\n---\n\n**灵小缇** - 你的敏捷 AI 助手 🐕\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fruilisi%2Flingti-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fruilisi%2Flingti-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fruilisi%2Flingti-bot/lists"}