Repolode
提交项目
anhe2021212-spec

anhe2021212-spec/Tidal_Echo

自托管的私密 1:1 聊天通道，把手机 PWA 与你的 AI 伴侣连接起来，可接 Claude Code 或任意 OpenAI 兼容模型。

在 GitHub 查看
Star
326
Fork
164
未关闭 Issue
2
最近提交
上个月

这是什么？

Companion Channel 是一个单用户聊天中转服务，把可安装到手机主屏的 PWA 与运行在你自己电脑或服务器上的 AI 伴侣连接起来。你在手机上发出的消息会落库到 VPS 上的 SQLite，再通过 Server-Sent Events 推给 Claude Code 的 channel 插件，在会话中以 channel 块的形式出现；AI 通过 reply 工具回复，回复会以气泡的形式显示在手机上。

默认的 AI 侧是基于 Bun 和 MCP 的 Claude Code channel 插件。仓库中的 examples/bridge_any_llm.py 可以让 GPT、DeepSeek、Gemini 等任意 OpenAI 兼容模型替代 Claude Code，前后端无需改动。另外提供服务器端常驻的 API loop，支持多步 MCP 工具调用、图片和文件附件，以及无需重启即可热加载的人格设定文件。

所有接口都由同一把 Bearer 密钥 RELAY_SECRET 保护，没有账号体系，也不依赖第三方托管。后端基于 FastAPI，前置 nginx，安装 PWA 和使用 Web Push 需要 HTTPS 域名。语音合成（MiniMax TTS）和推送均为可选，未配置时自动关闭，不影响文字聊天。

核心功能

  • 01通过 SSE 与 HTTP 在手机 PWA 和 AI 会话之间中转消息。
  • 02通过基于 Bun 和 MCP 的 channel 插件接入 Claude Code。
  • 03借助桥接脚本或服务器端 API loop，支持任意 OpenAI 兼容模型。
  • 04聊天记录存于自有服务器的 SQLite，使用 Bearer 密钥鉴权。
  • 05支持图片和文件附件，MCP 工具调用以可展开卡片显示。
  • 06可选接入 MiniMax 文字转语音和 Web Push 锁屏推送。

适用场景

  • 在手机上与由 Claude Code 驱动的 AI 伴侣进行私密一对一聊天。
  • 把自托管的手机聊天界面接到 GPT、DeepSeek 等非 Claude 模型。
  • 将 PWA 壳子作为自有消息后端的前端复用。
  • 运行服务器端 AI 助手，调用 MCP 工具并处理文件附件。

标签

#ai-companion#claude-code#llm#pwa#self-hosted#chatbot#mcp#privacy#ai-agents#personal-ai

常见问题

Tidal_Echo 是什么？
自托管的私密 1:1 聊天通道，把手机 PWA 与你的 AI 伴侣连接起来，可接 Claude Code 或任意 OpenAI 兼容模型。 Companion Channel 是一个单用户聊天中转服务，把可安装到手机主屏的 PWA 与运行在你自己电脑或服务器上的 AI 伴侣连接起来。你在手机上发出的消息会落库到 VPS 上的 SQLite，再通过 Server-Sent Events 推给 Claude Code 的 channel 插件，在会话中以 channel 块的形式出现；AI 通过 reply 工具回复，回复会以气泡的形式显示在手机上。
Tidal_Echo 可以免费使用吗？用的什么许可证？
Tidal_Echo 以 AGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。
Tidal_Echo 还在维护吗？
半年内有更新。Tidal_Echo 最近一次提交是在 2026年9月22日。
Tidal_Echo 适合用来做什么？
在手机上与由 Claude Code 驱动的 AI 伴侣进行私密一对一聊天。 把自托管的手机聊天界面接到 GPT、DeepSeek 等非 Claude 模型。 将 PWA 壳子作为自有消息后端的前端复用。 运行服务器端 AI 助手，调用 MCP 工具并处理文件附件。
在哪里获取 Tidal_Echo？
源代码和安装说明在 GitHub 上：https://github.com/anhe2021212-spec/Tidal_Echo

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目