anhe2021212-spec/Tidal_Echo

解决的问题

Tidal Echo 在移动设备（通过 PWA）与本地计算机或服务器上运行的 AI 同伴之间建立一个私有的 1:1 通信通道。它消除了对第三方托管或复杂账户系统的需求，确保消息仅通过用户拥有的服务器传输。

工作原理

该系统由三个主要组件构成：

1. 后端中继：使用 FastAPI 和 SQLite 的服务器，负责消息存储，并通过 Server-Sent Events (SSE) 分发消息。
2. 前端 PWA：用户可安装在移动设备主屏幕上的单页 Web 应用程序，用于发送和接收消息。
3. AI 接口：可以是 Claude Code 通道插件（将聊天直接集成到 Claude Code 会话中），也可以是独立的 API 循环（一个 Python 脚本，将任何 OpenAI 兼容的 LLM 连接到中继）。

消息从 PWA 流向中继，中继再将其推送到 AI 侧。AI 通过工具调用或 API 请求进行响应，中继再将响应以聊天气泡或锁屏通知的形式推回 PWA。

适用人群

希望拥有自托管、私密的 AI 同伴接口，特别是使用 Claude Code 或其他 LLM API，并倾向于避免中心化平台的用户。

核心亮点

• 隐私优先：无账户系统；访问由单个共享密钥（RELAY_SECRET）控制。
• 灵活的 AI 脑：原生支持 Claude Code 的 MCP 插件，但可轻松替换为任何 OpenAI 兼容 API（GPT、DeepSeek、Gemini 等）。
• PWA 集成：移动界面表现如原生应用，支持锁屏推送通知。
• 可扩展性：支持 MiniMax TTS 实现语音回复，并提供模块化后端协议，允许用户用自定义实现替换中继。