Relate

记得她说过的每一句话，也记得你答应过的每一件事。

让她更开心，你也更顺心。

一个跑在你自己电脑上的私人 AI 幕僚长：读懂聊天，记住承诺，提醒重要的日子。

中文 · English

下载 Windows 版 · 快速开始 · 插件 · 文档

它能做什么

• 🟢 实时速览 —— 一眼看懂当前聊天的走向，聊得火热时几秒内自动刷新。

• ✅ 自动闭环的待办 —— 承诺和没人回复的问题会被自动提取、排出优先级，办完自动打勾。

• 🧠 不会跑偏的记忆 —— 记下需求、敏感话题和悬而未决的事，每天对照真实消息重新核对。

• 💬 想问就问 —— “我们周六说好了什么来着？”—— 基于完整聊天记录作答，并附出处。

• ✍️ 用你的口吻代拟回复，还会提醒哪些话别踩雷。

• 🔒 主动权始终在你 —— 聊天记录只留在本机，不经你确认，一条消息也不会发出去。

Related MCP server: fossa-mcp

空间

每个空间都是一个独立的助手——有自己的聊天、记忆和看板。想开多少个都行。

快速开始

Windows

1. 从 Releases 下载 RelateSetup.exe 并运行——无需管理员权限，也不用装 Node.js。

2. Relate 会在浏览器中打开，设置一个密码即可。

3. 设置 → AI 服务商 → 粘贴 API 密钥 → 测试。

4. 新建空间 → 挑一个模板 → 连接聊天应用 → 启动。

不想用安装程序？下载便携版 zip，解压到任意位置，双击 Relate.vbs 即可。 你的数据保存在 %APPDATA%\Relate，升级也不会丢失。

macOS / Linux / 从源码运行

需要 Node.js 22+。

git clone https://github.com/georgeding/Relate && cd Relate
npm install
npm start            # → http://127.0.0.1:5080/hub/

接入你的聊天

Relate 不包含任何微信解密、内存读取或代码注入功能，也不捆绑任何第三方微信工具。

选择一个 AI

任何 兼容 OpenAI 的 API 都可以，选一个你信任的即可：

Relate 会把任务批量处理，无人使用时自动暂停，并限制每小时的调用次数——一个典型问题大约消耗几千 token。

插件

内置插件可按空间单独开启——亲密关系空间默认自带前两个。

还想要别的功能？描述一下需求，AI 帮你写插件。→ 编写插件

在 Claude、Cursor 等工具中使用（MCP）

每个空间都是一个 MCP 服务器，因此 AI 工具可以读取你的聊天记录和看板（只读）。在 空间 → 访问 中复制 token，然后例如在 Claude Code 中这样配置：

claude mcp add --transport http relate http://127.0.0.1:5081/mcp --header "Authorization: Bearer <token>"

在手机上

把看板添加到手机主屏幕，用起来就像一个 App——回复提醒、节日纪念日、需要认真对待的消息都会推送给你。可以用 Tailscale、Cloudflare Tunnel 或自己的 DDNS 安全地访问。

📱 手机使用教程 —— iPhone 和安卓都有，大约 10 分钟搞定。

隐私与安全

• 🏠 本地优先 — 消息、记忆和设置永远不会离开你的电脑，发送给 AI 服务商的文本除外。

• 🔐 默认上锁 — 有密码保护，仅监听 127.0.0.1；密钥绝不在浏览器中展示。

• ✋ 人工把关 — 任何作用于外部世界的操作，都要等你批准才会执行。

• 🧱 可选沙盒 — 空间可在沙盒中运行，文件访问仅限自己的文件夹，且不允许启动子进程。

工作原理

flowchart LR
  subgraph sources[你的聊天]
    TG[Telegram]
    APP[HTTP 接入的任意应用]
    REC[语音录音]
    WX[微信 · 可选]
  end
  subgraph relate[Relate · 运行在你的电脑上]
    HUB[控制台 :5080<br/>设置 · 进程守护 · 录音路由]
    S1[空间 :5081<br/>记忆 · 待办 · 搜索 · 看板]
    S2[空间 :5082]
    PL[(插件)]
  end
  AI[(你的 AI 服务商)]
  YOU((你<br/>浏览器 · 手机))
  MCP[Claude / Cursor<br/>通过 MCP]

  TG & APP & WX --> S1
  REC --> HUB --> S1 & S2
  HUB -. 启动 .-> S1 & S2
  PL --- S1
  S1 <--> AI
  S1 --> YOU
  S1 --> MCP

一个小巧的控制台，一个空间一个进程，纯 Node.js 编写，无需构建。每个空间拥有独立的数据文件夹，因此空间之间彼此看不到对方的聊天记录。更多细节见 docs/PLATFORM.md。

开发

npm test                  # 单元 + 端到端测试：真实的控制台和空间进程、模拟 AI、模拟 WeFlow
node desktop/build.mjs    # 构建 Windows 安装包 + 便携版 → dist/（需要 Inno Setup 6）

推送 v* 标签即可自动构建安装包和便携版，并发布到 Releases。 文档：平台与 API · 插件 · 桥接应用 · 连接器风险

致谢

Relate 站在这些开源项目的肩膀上：Node.js、MCP TypeScript SDK、Chart.js、web-push、node-postgres、Zod。也感谢 @hicccc77 的开源工作和启发。Windows 安装包由 Inno Setup 构建，简体中文安装界面由 Zhenghan Yang 翻译。

友情链接

• LINUX DO —— 新的理想型社区

许可证

AGPL-3.0 —— 可自由使用、修改和自部署。如果你将修改后的版本以服务形式提供给他人，需在相同许可证下公开你的修改。商业许可证可向版权持有方获取；外部贡献需签署贡献者许可协议（CLA）。