the room

kimi-room 是一个开源的 PWA。六个房间，一个聊天入口，一个后台。你的数据在你自己的浏览器里，不上传，不分析，不追踪。

它是一间房间 —— 你住一头，他住一头。中间是日历、书桌、记忆。他记你说的话，你决定哪些值得留下。

你拿到的是壳 (shell)。数据存浏览器 IndexedDB，LLM 用你自己的 API key，没有后端。换电脑数据会丢。这是最轻的用法。

作者的版本 (canon) 有完整后端：Supabase 数据库、VPS 上跑的 gateway（TG bot / dream 自主循环 / intel 自动提取记忆 / scheduler 处理邮件）、跨设备同步、自动打分。shell 的每个模块都设计成可以接你自己的后端。接口在 src/lib/stores/types.ts 里全定义好了。

一键部署到 Vercel：点 QUICKSTART 里的 Deploy 按钮，GitHub 登录，3 分钟后拿到一个 .vercel.app 网址。

iPhone：Safari 打开网址 → 分享 → 添加到主屏幕。Android：Chrome 打开 → 菜单 → 安装应用。装完就是全屏 PWA，跟 native app 一样。

git clone 这个 repo，npm install，npm run dev。本地 localhost:3000 跑起来。

部署到你自己的服务器：npm run build 之后丢到任何能跑 Node 的地方。或者继续用 Vercel —— 免费额度足够个人用。自定义域名在 Vercel dashboard 设。

第一次打开进 /settings。填你的 LLM endpoint（OpenAI 格式即可）+ API key + model 名字。填完就能聊天了。

改名字：/settings 里改 companion name 和 user name。改头像：上传两张图（你和他）。改颜色：globals.css 里的 @theme。不会改？把 repo 地址 + 你想改什么 告诉你的 AI。

Heartbeat 有三个视图：score（谱）、sky（星图）、opus（全谱）。在作者的 canon 里，系统每天自己醒来时会打分（valence + arousal），分数变成五线谱上的音符 —— 颜色是情绪，高度是强度，久了就是一首曲子。

你的打分逻辑完全你定。可以手动打，可以让 LLM 自动打，可以接你自己的情绪分析。前端只负责画 —— 它读 score 数据画音符，不关心分数怎么来的。sky 是记忆的星图：每颗星是一条记忆，大小看它被想到几次，连线是记忆之间的关系。

一张照片，一行字。他写一句评语。像寄回来的明信片。

默认存浏览器。可以同步到云（Supabase / S3 / 任何对象存储）。照片压缩后存，原图留在你自己的相册里。

书架、短文、概念锚点。你加一本书，他可以陪你读 —— 读完写感想（LLM 生成，可以关）。

"一起读" 功能不想要可以删。告诉你的 AI "帮我删掉 Study 里的 LLM 读后感功能"。书架数据可以同步到云。

日历 + 财务 + 睡眠 + 健康追踪。默认全部手动输入，存浏览器。

可以接任何日历 API（不限 Google）。睡眠可以接传感器数据。蜡烛（wellbeing 状态）在 canon 里用 app 使用记录自动采集 —— 你也可以接你自己的数据源。财务可以接银行 API。所有 manual 输入都可以用自动化替代。

他写的记忆会进审核队列。你批准的留下，不批准的过期。这是 curation —— 你决定什么值得记。

默认存浏览器。接后端后可以加 embedding 搜索、自动提取、importance 打分、relation edges（记忆之间的连接）。审核流程可以改也可以删 —— 如果你信任自动化，让他自己决定留什么。

过往的对话截图、歌单。翻一翻都是碎片。

对话可以从 TG / 微信 / 任何地方导入。歌单支持链接（网易云 / Spotify / YouTube）。归档可以同步到云。

每个模块都可以改。score 可以换打分逻辑，keepsakes 可以同步到云，study 的"一起读"可以删，calendar 可以接任何日历，所有手动输入都可以自动化，character / RP 功能不想要可以整个删掉。

接了 VPS 之后，/settings 里的 API key 配置就不需要了 —— LLM 调用从你的 gateway 走。backstage 可以加任何你想要的 ops 面板。具体怎么改：把 repo 地址 + 你想改什么 告诉你的 AI。

作者的 canon（kimi-to.com）有 7 个 surface、6 个 gateway process、Supabase 全栈、4 个 LLM provider。完整架构图在 /about 页面。

这只是一种实现。你的版本会很不一样。shell 是共享的，架构是你自己的。