## 功能特性 - 情绪支持对话：通过 FastAPI + LangGraph 后端提供文字陪伴，支持用户围绕压力、关系、想法循环和行动卡点进行持续对话。 - 安全路由：每轮对话都会先进入安全与危机分流逻辑，危机判断结果会写入持久化审计日志。 - 持久记忆：支持语义事实、会话摘要和偏好规则三类记忆，用户可以在 Memory 页面查看和删除已保存内容。 - 引导练习：内置 grounding、breathing、thought work、values reflection 等多轮练习，适合把开放式倾诉转入结构化整理。 - 会话线程：用户可以通过 Thread ID 延续同一段对话，也可以从 `PAST` 侧栏恢复已有 persistent 线程。 - 状态观察：State 页面可查看 `Route`、`Response Style`、`Crisis`、`Transcript` 等状态块，便于理解一次回复背后的判断链路。 ### 首次使用流程 1. 进入应用后， 默认模式为 `Persistent`。`USER ID` 输入框保持只读，Placeholder 为 `from Lazycat account`；`THREAD ID` 需要手动填写。 2. 首页底部有两个主按钮：`Getting started` 和 `Start session`。点击 `Start session` 后，才会进入带侧边导航的会话界面。 3. 进入会话后，左侧导航会显示 `HOME`、`CHAT`、`VOICE`、`MEMORY`、`STATE`、`PAST`、`END`。 ### 日常使用方式 1. 在 `Chat` 页面输入当天想整理的事情，例如压力来源、关系冲突、反复出现的想法或下一步行动；也可以直接点 `Sort out what happened`、`Regulate first`、`Untangle a thought`、`Find the next step` 进入对应引导。 2. 需要长期连续性时继续使用同一个 `Thread ID`；需要恢复旧线程时点左侧 `PAST`，右侧会打开 `Previous sessions` 抽屉，列出当前用户可恢复的 persistent 会话。 3. 打开 `Memory` 页面后，可以在 `Overview`、`Facts`、`Sessions`、`Rules` 四个标签之间切换。`Overview` 会显示 `semantic / episodic / procedural` 三类计数，以及 `Mode`、`Owner`、`Crisis log`、`Session feedback`、`Proactive recall`。 4. 打开 `State` 页面后，可查看 `Route`、`Response Style`、`Approach`、`Response Text`、`Crisis`、`Session Memory`、`Procedural Profile`、`Transcript` 等状态块。遇到回复异常时，优先在这里确认是否还停留在 `pending`、以及当前 route 是否已经定为 `therapeutic`。 5. `Voice` 页面会显示 `LIVEKIT`、`Connect voice`、`VOICE`、`TRANSCRIPT` 等控件。当前页面标题为 `Take a breath. Begin when ready.`，副文案为 `Voice runs with persistent memory. We won’t speak until you do.` ### 配置向导说明 1. `llm_provider=openai` 时，至少填写 `openai_api_key`。默认快速模型为 `gpt-5.4-mini`，高质量模型为 `gpt-5.4`。 2. 使用三方 OpenAI-compatible API 时，继续保持 `llm_provider=openai`，把 `openai_base_url` 填成服务商提供的 Base URL，例如 `https://api.example.com/v1`，并把快速模型、高质量模型改成该服务商支持的模型名。该接口必须兼容 OpenAI Responses API；只兼容 Chat Completions 的地址不能保证可用。 3. `llm_provider=gemini` 时，至少填写 `gemini_api_key`。默认模型为 `gemini-3-flash-preview`。 4. 使用三方 Gemini-compatible API 时，继续保持 `llm_provider=gemini`，把 `gemini_base_url` 填成服务商提供的 Gemini API 地址，并把快速模型、高质量模型改成该服务商支持的模型名。该接口必须兼容 Google Gen AI API。 5. `livekit_url`、`livekit_api_key`、`livekit_api_secret` 是必填项，配置完后可启用浏览器语音，见下获取方式。 ### LiveKit Cloud 获取方式 1. 打开 [LiveKit Cloud](https://cloud.livekit.io/) ，登录并创建项目。 2. 在 `Settings -> API keys -> Create key` 新建一个专用于 OpenCouch 的 key。创建成功后，弹窗只会展示一次 `Websocket URL``API Key`和`API secret`，对应记录填写到配置向导中即可。