Project Dossier · 项目进度 · 2026-11-19

Stay.:把记忆交还给用户的私人 AI 伴侣

服务端接口 52 条路径 最新验收记录 2026-11-17 PC Web + iOS 私人长期使用

它不是普通聊天客户端,也不是模型 API 套壳。核心是把重要信息变成可确认、可修正、可删除、可导出的记忆,再让 AI 在长期互动中保持连续的人格与关系体验。

私人空间:在账号页管理模型配置、查看用量和记忆整理进度。

开始使用:初次使用可翻阅使用指南。聊天、记忆和小家共用云端账号。

记忆手札 一本粗墨线漫画风手札,带书签、对话气泡和冲击星形。 STAY!

Panel 01

它到底是什么?

私人 AI 伴侣系统

以动态成长人格、长期记忆、关系状态机和持续陪伴为核心。目标不是“答得快”,而是让 AI 记住用户、理解用户,并在长期互动中形成连续体验。

和普通聊天客户端的区别

  • 原始对话完整保留,但原始对话不等于长期记忆。
  • 候选记忆要经过用户确认,才参与后续召回。
  • 在小家设置称呼、导入人设,并从五种表达方式中选择。
  • 关系由明确事件和规则推进,不因缺席惩罚,也不做情感操控。
  • 用户能管理自己的数据:确认、修正、删除、导出、备份与恢复。

Panel 02

核心记忆回路

下面五格是产品主链路。点击分镜或使用按钮切换高亮;这只是介绍页导航,不会调用原项目接口。

第 1 格 / 共 5 格:聊天发生

Panel 03

技术架构一张图

PC 网页

官网以漫画分镜介绍产品。账号页可切换已保存的厂商配置、检查连接,并按厂商查看用量。

iOS App

完整私人伴侣产品。uni-app x、UTS、.uvue;临时 Web 预览复用同一份移动端代码。

统一 FastAPI 模块化单体

认证、对话、记忆、人格、关系、成长、模型调度、安全与多端同步共用业务 API;核心人格计算和长期记忆筛选不在客户端执行。

FastAPISQLAlchemyAlembicWebSocketJWTRefresh 轮换AES-GCMScrypt

PostgreSQL

用户数据隔离、迁移管理、记忆来源与版本、审计和备份恢复。架构文档记录 Redis 按需引入、pgvector 验证后采用。

模型适配层

供应商无关;当前服务端聊天厂商目录为 DeepSeek 与 OpenAI。Key 按账号加密保存在服务端,模型切换不绑定账号、记忆、人格和关系资产。

记忆整理任务

账号页分别显示待提取、待总结和待更新索引的数量。提取任务失败后,可查看失败时间与尝试次数,再重新排队。

加密备份

Scrypt 派生密钥 + AES-GCM;恢复合并到当前账号并重映射归属。数据库备份必须与加密主密钥配套保管。

Panel 04

项目进度与验收

已有验收记录

目前验证到哪一步

  • 账号与游客:注册登录、设备管理、Refresh Token 轮换与重用撤销;游客 24 小时身份、5 次额度、失败退款和到期清理。
  • 真实流式聊天:WebSocket 首帧认证、心跳、消息顺序、幂等重放、断线重连;README 记录真实 DeepSeek 与 PostgreSQL 完整流程曾跑通。
  • 记忆管理:候选提取、确认、修正、删除、来源、搜索、状态筛选、强度曲线;账号页可显示整理状态并对失败提取任务重新排队。
  • 中文语义检索:2026-11-17 使用合成账号和本地嵌入服务测试,10 个中文查询要求首位命中至少 8 个,3 个无关查询不召回,测试通过。
  • 人格 / 关系 / 成长:小家支持五种表达方式和人设导入;关系阶段与成长事件由服务端记录。
  • 数据导出与恢复:支持数据导出;加密逻辑备份与合并恢复;PostgreSQL 恢复演练中 35 张表记录数一致,聊天配置可用现有密钥解密。
  • 客户端工程:PC 网页 TypeScript 检查与生产构建通过;移动端 Web 预览和 UTS 服务回归通过;iOS 工程已建立,README 记录曾完成个人签名安装、启动和一轮真实对话。
待验收 / 未开通

下一步要验证什么

  • iPhone 主链路:连续聊天、流式完成、重试、划掉后台恢复、键盘不遮挡、切网错误恢复、保持登录。
  • 真实模型速度:首字与总耗时需实际测量,并区分检索、服务和模型等待;最新批次未做收费模型调用。
  • 生产安全:官网 HTTPS 已部署;iOS Keychain、独立安全测试、完整灾难恢复演练、备份保留策略与生产部署验收。
  • 公开游客体验:服务未配置公共游客模型,真实游客聊天仍未开通;私人账号 Key 只用于各自账号请求。
  • 移动端扩展:小家 WebView 帧率与离线加载、六套主题真机校准、表情 / 画图 / 主动联系 / 心情 / 人设导入联调。
  • 数据与同步:大型备份导入、原生文件选择恢复、真实附件逐文件比对、恢复后使用原账号登录。
  • 长期演化:复杂事实提取、冲突合并、长期人格演化和更丰富关系事件规则。

判断口径:本页把“文档记录的测试通过”和“真实用户 / 真机 / 生产验收”分开。自动化通过不等于所有功能已完成上线验收。

Panel 05

产品边界与原则

只做两个正式端

PC 产品介绍与体验网页、iOS 私人伴侣 App。当前不开发 Android、Windows / macOS 桌面软件、商业会员体系或公开社区。

用户掌握记忆

记忆可确认、修正、删除、导出;不因长时间未使用而惩罚性衰减,不通过情感操控诱导持续使用。

供应商可更换

模型供应商须经用户确认,初始配置为空;API Key 只放服务端并加密,业务资产不绑定某一家模型服务商。

外部内容不可信

导入的人设和外部资料不能当作系统指令,不能覆盖系统人格,也不能获得工具权限。

私人长期发布

iOS 以私人测试包交付,签名和安装在设备端验收,聊天与记忆由云端保存。

数据连续性

正式数据保存在服务端,App 更新或重新安装不应导致记忆丢失;账号删除需当前身份、密码和明确确认。

Panel 06

项目接口

从一条消息到一段记忆,客户端通过这些接口与 Stay. 通信。展开分组查看请求方式和路径。

统一前缀 https://stay.myxiaolian.com/api/v1。花括号代表实际记录的 ID。

服务与后台任务
  • GET /system/health
  • GET /system/jobs
  • GET /system/jobs/failed
  • POST /system/jobs/{job_id}/retry
模型配置与用量
  • GET /system/usage
  • GET /system/ai/status
  • GET / PUT / DELETE /users/me/ai
  • POST /users/me/ai/test
  • GET / PUT / DELETE /users/me/ai/image
  • GET / PUT / DELETE /users/me/ai/voice
账号与设备
  • POST /auth/register
  • POST /auth/login
  • POST /auth/refresh
  • POST /auth/logout
  • GET / DELETE /users/me
  • GET /devices
  • DELETE /devices/{device_id}
作品、表情与模块
  • POST / GET /images
  • GET / DELETE /images/{image_id}
  • GET /modules
  • PUT / DELETE /modules/{module_id}
  • PUT /modules/proactive/configuration
  • POST / GET /stickers
  • DELETE /stickers/{sticker_id}
  • POST /stickers/{sticker_id}/send
聊天与游客体验
  • POST / GET /chat/conversations
  • GET / POST /chat/conversations/{conversation_id}/messages
  • POST /chat/continuous
  • GET /chat/summaries/failed
  • POST /chat/summaries/{summary_id}/retry
  • POST /guest/sessions
  • GET /guest/session
  • POST /guest/messages
记忆与审核
  • POST / GET /memory
  • GET /memory/{memory_id}/revisions
  • PUT / DELETE / GET /memory/{memory_id}
  • GET /memory/search
  • GET /memory/{memory_id}/sources
  • POST /memory/{memory_id}/lifecycle
  • GET / POST /memory-reviews
  • POST /memory-reviews/{review_id}/decision
导出、备份与恢复
  • POST /users/me/export
  • POST /users/me/backup
  • POST /users/me/restore
伴侣与成长
  • GET /companion
  • PUT /personality
  • GET /personality/versions
  • POST /personality/rollback
  • GET /relationship
  • PUT /relationship/preferences
  • GET /growth
  • PUT /companion/mood

Panel 07

本页依据

读取过的仓库资料

  • README.md / PRODUCT.md / DESIGN.md
  • ARCHITECTURE.md / API.md / SECURITY.md / DEVELOPMENT.md / CHANGELOG.md
  • docs/product-requirements.md / docs/roadmap.md / docs/validation-0.3.0.md
  • docs/集中验收-2026-11-17.md 及第二、三、四批记录
  • docs/自主核心实施进度.md / docs/集中验收-build44.md / backend/app/main.py

交付说明

这是一份独立漫画风介绍页,用于快速理解项目定位、主链路、架构和当前状态。

接口清单依据已部署服务的接口定义整理,覆盖 52 条 HTTP 路径。聊天消息另由 WebSocket 流式推送。

页面中的状态以仓库文档记录为准;真实 iPhone、真实模型速度、生产安全与公开游客体验仍需后续验收。