暖夕 · 老年人心理疗愈开源平台

面向老年人的 AI 情绪陪伴与辅助开源平台。融合陪伴对话、回忆疗法、情绪日记三大功能，内置安全护栏实现危机转介。提供纯前端（双击即用）与全栈后端（带登录会话）两种运行模式。基于国产开源模型构建，规划适配国产算力。

一句话介绍

暖夕是一个零门槛、适老化的心理疗愈网页应用：老人打开就能用，支持语音输入与逐行朗读（不识字也能用），内置安全护栏作为底线。它把有实证支持的”回忆疗法”用开源 AI 实现，并始终坚持一条底线——安全护栏不缺席。

功能模块

模块	做什么	适老化设计
💬 陪伴对话	随时倾述，温和回应；支持打字与语音输入	大字体、大按钮、语音友好
🌿 回忆疗法	AI 像老朋友一样引导老人讲人生故事，生成「人生小传」	分步提问、节奏慢、可复制保存
📔 情绪日记	每天记心情，自动看趋势	五星图标选择、持久化存储
ℹ️ 安全护栏	检测到极端消极/轻生念头立即弹窗求助	24 小时援助热线 + 紧急提示

两种运行模式

模式	怎么跑	是否需要登录	数据存哪
本地模式	直接双击 `index.html`（无需任何环境）	否	浏览器 `localStorage`，仅本机
全栈模式	运行 `app/server.py` 后端，浏览器访问 `http://localhost:8000`	是（注册/登录）	服务端 SQLite，按账号隔离

两种模式功能完全一致。本地模式零门槛适合演示与申报验证；全栈模式适合多设备、多用户、数据集中管理的真实部署。

快速开始

方式一：双击打开（零门槛，无需环境）

双击 index.html 即可在浏览器打开，演示模式默认开启，不联网也能体验全部流程。
想接真实模型：在「陪伴对话」里填写接口地址和密钥（如硅基流动、阿里云百炼等兼容 OpenAI 的接口），取消勾选「演示模式」。
推荐模型：国产开源 Qwen2.5 系列（7B/14B 均可），或本地用 Ollama 跑 qwen2.5:7b。

方式二：运行全栈后端（带登录，需 Python 3.10+）

# Windows 双击 start.bat，或：
python app/server.py
# 自定义端口：python app/server.py --port 8000

浏览器访问 http://localhost:8000，首次进入需注册账号并登录。登录后：

陪伴记录、回忆、心情都保存在你的账号下，仅你可见；
对话默认走服务端大模型（在 app/config.json 配置 model_api 后即为真实模型；未配置时返回兜底暖心回复）；
注册账号命令（可选）：python app/server.py --create-user 用户名。

本项目为情绪陪伴与辅助工具，不是医疗治疗，不能替代医生和心理医生。如有需要请拨打全国心理援助热线 12356。

项目架构

warm-sunset/
├── index.html              # 入口页面（结构骨架，引用样式与脚本）
├── styles.css              # 全局样式（墨绿纸卡设计系统）
├── js/
│   ├── config.js           # 全局配置：模型/提示词/危机词/回忆问题/热线/语音参数
│   ├── api.js              # 运行模式探测 + 登录会话 + 数据层（服务端/本地双实现）
│   ├── voice.js            # 语音模块：speak 朗读 / startVoiceInto 识别
│   ├── guardian.js         # 安全护栏：危机词检测与弹窗
│   ├── companion.js        # 陪伴对话模块（服务端 / 本地双分支）
│   ├── memory.js           # 回忆疗法（生命回顾）模块
│   ├── mood.js             # 情绪日记模块
│   └── app.js              # 主控：启动流程、登录网关、导航、初始化
├── app/                    # 后端（Python 标准库，零第三方依赖）
│   ├── server.py           # HTTP 服务：静态托管 + REST 路由 + 会话 + CSRF
│   ├── accounts.py         # 注册/登录/会话（PBKDF2 密码哈希）
│   ├── storage.py          # SQLite 持久化与统一错误
│   ├── llm.py              # 大模型代理（OpenAI 兼容 /chat/completions）
│   └── config.json         # 后端配置（数据目录、模型接口、会话时长）
├── docs/
│   ├── architecture.md     # 架构说明（本文件配套）
│   ├── deployment.md       # 运行与部署指南
│   └── mxmaca-adaptation.md# 沐曦 MXMACA 国产算力适配规划
├── tests/
│   └── test_server.py      # 后端自动化自测（仅标准库）
├── start.bat / start.sh    # 一键启动后端
├── requirements.txt        # 仅标准库，无第三方依赖
├── package.json            # 工程元数据（npm start 起后端）
├── LICENSE                 # Apache-2.0
├── README.md
└── 申报表文案.md            # 青年开源种子计划申报逐字段文案

前端为原生 HTML/CSS/JS，无框架、无构建步骤；后端为纯 Python 标准库，无第三方依赖；
两种模式共用同一套前端：api.js 自动探测运行模式并切换数据来源（服务端 fetch / 本地 localStorage）；
模型通过 OpenAI 兼容接口调用，可替换为任意国产模型；未配置时自动兜底，保证可用性。

创新点

回忆疗法 + 开源 AI：把有研究支撑的”生命回顾”干预做成可复用工具，而非又一个通用聊天框。
安全护栏是灵魂：多数陪伴项目忽略危机转介，暖夕把”识别危机 → 弹窗求助”作为底线功能。
适老化无障碍：语音输入 + 逐行朗读，让不识字的老人也能使用。
双模式工程化：既有零门槛的本地模式，也有带登录与会话的全栈后端，适配不同部署场景。
国产模型适配：已基于 Qwen/DeepSeek 构建，规划适配沐曦 MXMACA 国产算力软件栈。

开源协议

Apache-2.0（OSI 认可）。欢迎社区贡献：提交 Issue、PR，或补充回忆疗法题库、情绪词库、适老化交互规范。

关于申报

本项目申报「青年开源专项基金种子计划」，方向为 AI Agent（陪伴智能体）+ AIGC（疗愈内容生成）+ AI Infra（安全层）。详见 申报表文案.md。