## 快速开始
### Windows
1. 从 [Releases](../../releases/latest) 下载 **`RelateSetup.exe`** 并运行——无需管理员权限，也不用装 Node.js。
2. Relate 会在浏览器中打开，设置一个密码即可。
3. **设置 → AI 服务商** → 粘贴 API 密钥 → **测试**。
4. **新建空间** → 挑一个模板 → 连接聊天应用 → **启动**。
不想用安装程序？下载**便携版 zip**，解压到任意位置，双击 `Relate.vbs` 即可。
你的数据保存在 `%APPDATA%\Relate`，升级也不会丢失。
### macOS / Linux / 从源码运行
需要 [Node.js 22+](https://nodejs.org)。
```bash
git clone https://github.com/georgeding/Relate && cd Relate
npm install
npm start # → http://127.0.0.1:5080/hub/
```
## 接入你的聊天
| 来源 | 读取 | 发送 | 上手方式 |
|---|:-:|:-:|---|
| **Telegram** | ✓ | ✓ | 用 [@BotFather](https://t.me/BotFather) 创建一个机器人（[教程](https://core.telegram.org/bots/tutorial)），然后把 token 粘贴进来 |
| **任意应用**（WhatsApp、Slack、LINE、邮件……） | ✓ | ✓ | 通过一个小型桥接服务以 HTTP 推送消息 —— [docs/INGEST.md](docs/INGEST.md) |
| **语音录音**（[Plaud](https://www.plaud.ai) 等） | ✓ | – | 把转写文本放进一个文件夹即可；每条录音会自动路由到对应的空间 |
| **微信** | ✓ | 可选 | 两个可选的、仅限 Windows 的连接器 —— 请先阅读[风险说明](docs/CONNECTORS-AND-RISK.md) |
> Relate 不包含任何微信解密、内存读取或代码注入功能，也不捆绑任何第三方微信工具。
## 选择一个 AI
任何 **兼容 OpenAI** 的 API 都可以，选一个你信任的即可：
| 服务商 | | 服务商 | |
|---|---|---|---|
| [阿里云百炼（Qwen）](https://bailian.console.aliyun.com) | 🇨🇳 | [OpenAI](https://platform.openai.com) | 🌍 |
| [DeepSeek](https://platform.deepseek.com) | 🇨🇳 | [OpenRouter](https://openrouter.ai)（多模型，一个密钥） | 🌍 |
| [智谱 GLM](https://open.bigmodel.cn) | 🇨🇳 | [Ollama](https://ollama.com) / [LM Studio](https://lmstudio.ai) | 💻 完全本地运行 |
| [火山引擎豆包](https://www.volcengine.com/product/ark) | 🇨🇳 | | |
Relate 会把任务批量处理，无人使用时自动暂停，并限制每小时的调用次数——一个典型问题大约消耗几千 token。
## 插件
内置插件可按空间单独开启——亲密关系空间默认自带前两个。
| 插件 | 功能 |
|---|---|
| 🎑 **节日与纪念日** | 春节、七夕、中秋（任意年份的农历日期自动推算）、520、情人节……还有 100 / 520 / 1000 天、周年纪念日和生日——提前几天推送提醒 |
| ⏰ **回复提醒** | 对方等你的回复等太久时，推送提醒你 |
| 🔔 **关键词提醒** | 标记提到你关注关键词的消息 |
| 🗓️ **排班表** | 从已发布的 [Google 表格](https://support.google.com/docs/answer/183965) 或任意 CSV 中查“今天谁值班” |
| 🗄️ **只读 SQL** | 以只读方式查询你的 Postgres，回答数据类问题 |
还想要别的功能？描述一下需求，AI 帮你写插件。→ [编写插件](docs/PLUGINS.md)
## 在 Claude、Cursor 等工具中使用（MCP）
每个空间都是一个 [MCP 服务器](https://modelcontextprotocol.io)，因此 AI 工具可以读取你的聊天记录和看板（只读）。在 **空间 → 访问** 中复制 token，然后例如在 [Claude Code](https://docs.claude.com/en/docs/claude-code/mcp) 中这样配置：
```bash
claude mcp add --transport http relate http://127.0.0.1:5081/mcp --header "Authorization: Bearer