把「想说的话」,先说给 AI 听。
一款纯本地的 AI 人格分析与对话预演桌面应用。 上传一段真实的聊天记录,让 AI 以第三方视角读懂「对方」, 再走进你的视角,替 TA 与你预演那场还没发生的对话。
V1.0.4 · Windows · 纯本地运行
第三视角 · 分析师:粘贴聊天记录后,AI 流式解读对方性格,画像与标签自动沉淀于右上角
生活中最重要的那些对话——解释、道歉、争取、告别——往往发生在我们最没有准备的时候。 等真正坐到对方面前,情绪已经替我们说了话。
Emotional AI 想做的,是在对话发生之前,给你一个可以停下来思考的空间:
- 先理解——把你们的聊天记录交给「分析师」,从旁观者的角度读出 TA 的性格、在意的事与沟通模式;
- 再预演——由 AI 扮演 TA,和你反复推演想说的话,直到你说出自己想要的那一版;
- 最后回到现实——带着更清晰的判断,去进行那场真实的对话。
它不替你说话,只帮你看清。
- 粘贴
名字:内容格式的聊天记录,或直接描述你所面对的情况; - 深度思考模型流式解读:对方是什么样的人、雷区在哪里、建议你如何切入;
- 解读结果自动沉淀为画像(一句话概括 + 性格标签),随输入不断修正;
- 全程可见 AI 的工作状态(判断输入类型 → 整理对话记录 → 输出分析)。
- AI 根据画像扮演「对方」,与你实时对话,可用模型一键切换;
- 每条回复附带分析师的心路历程注解,让你看到「TA 为什么这么说」;
- 历史聊天记录经向量化存入本地记忆库,对话时自动检索相关片段作为上下文, 扮演越用越像。
主视角 · 对话预演:AI 扮演「对方」与你实时对话,每条回复下方附分析师的心路历程注解
- 侧栏管理多个人物画像(家人、朋友、同事……彼此独立);
- 画像随时手动「更新重塑」;
- 侧栏支持收缩,最小化时只保留首字与图标。
多关系管理:侧栏维护彼此独立的人物画像,进入对话后顶部常驻画像概述,可随时点「更新画像」重塑
flowchart LR
subgraph Electron["Electron 34 桌面壳"]
MP["主进程<br/>窗口 / sidecar 生命周期<br/>IPC 白名单 / fetch 代理"]
PR["preload<br/>contextBridge"]
RD["渲染进程 React<br/>第三视角 · 主视角 · 设置"]
end
subgraph Sidecar["FastAPI sidecar(本地子进程)"]
API["REST API<br/>X-Sidecar-Token 校验"]
SVC["分析师 / 扮演 / 导入解析<br/>画像塑造"]
end
DB[("SQLite<br/>personas · conversations · messages")]
VS[("LanceDB<br/>向量记忆 1024 维")]
ARK["火山方舟<br/>深度思考 · 扮演 · Embedding"]
RD -->|preload IPC| MP -->|HTTP + Token| API --> SVC
SVC --> DB
SVC --> VS
SVC -->|HTTPS| ARK
- Electron 主进程负责窗口与 sidecar 生命周期管理;渲染进程与后端之间的所有请求 均由主进程代理转发,渲染层永远接触不到访问令牌。
- FastAPI 以子进程(sidecar)方式随应用启停,本地数据不出机器; 唯一的外部连接是调用火山方舟的模型 API。
- SQLite 存储结构化数据(画像 / 会话 / 消息),LanceDB 存储向量记忆, 两者均为本地嵌入式存储,无任何服务端依赖。
纯本地是这个项目的底线:
- 数据不出机器——聊天记录、画像、对话历史全部存储在本地 SQLite 与 LanceDB 中, 没有账号体系,没有云端同步,没有服务端;
- API Key 明文不落盘——使用 Electron
safeStorage(Windows 底层 DPAPI)加密后 存入用户数据目录,开发态密钥仅存放于 git 忽略的server/.env; - 进程间最小信任——渲染进程开启
contextIsolation且禁用 Node, 仅通过 preload 白名单桥接;sidecar 接口强制校验X-Sidecar-Token(生产态由主进程随机生成注入),杜绝本机其他进程未授权访问。
| 依赖 | 版本 |
|---|---|
| Node.js | 18+ |
| Python | 3.11 / 3.12 |
| 火山方舟 API Key | 控制台获取 |
# 1. 安装前端依赖
npm install
# 2. 创建 Python 虚拟环境并安装后端依赖
python -m venv server/.venv
server\.venv\Scripts\pip install -r server/requirements.txt
# 3. 配置后端环境变量
copy server\.env.example server\.env
# 编辑 server\.env,填入 ARK_API_KEY 与 SIDECAR_TOKEN
# 4. 启动应用(Electron 会自动复用或拉起 8765 端口的后端)
npm run dev首次进入后,在「设置」页填入 API Key 即可开始使用(也可直接写入 server/.env)。
一条命令生成 Windows 安装包(dist/Emotional-AI-Setup-<版本号>.exe):
# 首次:安装打包依赖
server\.venv\Scripts\pip install -r server/requirements-build.txt
# 打包:PyInstaller 打后端 → electron-vite 构建界面 → electron-builder 生成 NSIS 安装包
npm run dist- 后端代码没改、只改了界面时,可用
npm run dist:app跳过后端打包,快很多; - 安装包内含独立的后端
server.exe,用户电脑无需安装 Python / Node; - 用户数据(数据库、向量记忆、加密的 API Key、日志
sidecar.log)存放在%APPDATA%\emotional-ai,与安装目录分离,卸载或覆盖安装都不会丢; - 未做代码签名,首次运行 Windows 可能提示「未知发布者」,点「更多信息 → 仍要运行」即可。
若 electron-builder 报
Cannot create symbolic link(解压 winCodeSign 失败): 打开 Windows「开发者模式」,或手动把%LOCALAPPDATA%\electron-builder\Cache\winCodeSign\*.7z解压到同目录下的winCodeSign-2.6.0文件夹(忽略两个 macOS 符号链接的报错)后重试。
- 修改代码,并把
package.json的version改高(如1.0.3→1.0.4); - 运行
npm run dist,得到新的Emotional-AI-Setup-1.0.4.exe; - 直接运行新安装包即可覆盖升级(
appId不变,Windows 识别为同一软件),数据与设置保留; - 若新版本改了数据库结构,在
server/app/db/engine.py的_migrate_schema里补迁移。
| 层 | 技术 |
|---|---|
| 桌面壳 | Electron 34 · electron-vite · electron-builder(NSIS 安装包)· PyInstaller(后端打包) |
| 界面 | React 18 · TypeScript · Zustand · Arco Design · SSE 流式渲染 |
| 后端 | FastAPI · uvicorn(sidecar 子进程)· Pydantic v2 |
| 存储 | SQLite(SQLModel)· LanceDB(向量,cosine top-k) |
| 模型 | 火山方舟 SDK:深度思考模型(分析师)· doubao-seed-2-0-lite / Doubao-Seed-Character(扮演,可切换)· doubao-embedding-vision(记忆向量化) |
Emotional-AI/
├─ src/
│ ├─ main/ # Electron 主进程:窗口、sidecar 生命周期、IPC、安全存储
│ ├─ preload/ # contextBridge 白名单桥接
│ └─ renderer/ # React 界面(工作区 / 第三视角 / 主视角 / 设置)
├─ server/
│ ├─ app/
│ │ ├─ api/ # REST 接口(settings · personas · imports · conversations …)
│ │ ├─ db/ # SQLModel 三表与 CRUD
│ │ └─ services/ # 方舟调用 · 导入解析 · 画像塑造 · 向量记忆
│ └─ requirements.txt
├─ electron.vite.config.ts
└─ launch.vbs
完整的模型设置(火山方舟模型会更新下线,模型 ID 不再写死)
- 扮演、分析师、辅助、向量四类模型各自可填任意 Model ID 或推理接入点 ID(
ep-开头), 改完立即生效、无需更新软件;设置保存在数据目录model_settings.json - 每个模型都可单独「测试」:用表单里尚未保存的值发一次真实请求,返回可用性、耗时(向量模型还返回实际维度)
- 可修改接口地址(兼容 OpenAI 格式的服务)、扮演 / 分析师温度;单项「恢复默认」与「恢复全部默认模型」
- 向量记忆支持多模态 / 文本两种接口与自定义输出维度
记忆库重建
- 记忆库记录自己由哪个向量模型、多少维生成;更换向量设置后自动识别为「待重建」, 期间检索暂停(对话照常进行),新产生的记忆以原文暂存,不会丢失
- 一键重建:用新模型重新向量化全部记忆(含暂存),显示进度;全部成功后才替换旧索引, 中途失败旧索引原样保留、可重试;空记忆库直接采用新设置,无需重建
问题修复
- 主视角重启后历史「消失」:前端没记住已有会话,每次重启都新建一个;现由服务端统一 get-or-create,并发请求也只会有一个会话
- 中断生成可能误删整段历史:改为服务端在连接断开时按消息 ID 撤销本轮,不再依赖客户端计数;半截回复不再落库
- 导入聊天记录会清空该人格已有的全部向量记忆(含分析师洞察),现改为追加;解析失败 / 未配 Key 时不再留下孤儿人格
- 中文输入法组字时按 Enter 会直接发送 / 触发弹窗确定
- 新建对话弹窗按 Enter 读到的是空名字(键盘回调闭包过期)
- 第三视角分析结果缺少换行样式,分点内容挤成一段
- 长聊天记录只取前 60 行、每行 200 字送去分析;整理失败时只剩一行截断原文
- 嵌入失败时写入零向量,导致余弦相似度为 NaN、污染检索
- 设置页保存的 Key / 扮演模型在应用重启后不生效(开发态侧车未注入、模型选择从未推送)
- 本地服务启动失败后界面永久离线、侧栏清空;现会自动退避重试,崩溃后下次请求自动重启
- 错误提示带有 "Error invoking remote method…" 前缀
逻辑改进
- 主视角历史去掉
<thought>心路历程,避免角色把分析旁注当成自己说过的话 - 扮演提示词区分「过往聊天片段」与「分析师观察」,并带入最近的观察记录
- 画像生成参考历次观察,同一人格的手动 / 自动生成串行执行
- 后台任务持有强引用,避免被垃圾回收而静默丢失
- 人格字段校验(名字非空、标签去重限长),扮演模型只接受配置中的两款
- 生产态数据目录改为 Electron userData;侧车输出写入
userData/sidecar.log
新功能
- 编辑画像:手动修改名字、一句话概述、性格标签与背景
- 主视角「重新开始预演」、第三视角「清空分析记录」
- 画像悬停卡展示近期观察
- 设置页显式「保存」按钮与保存结果提示,离线时可一键重连
- 中断生成后自动把原文还给输入框;滚动查看历史时不再被流式输出拽回底部
我们相信,沟通是一门可以练习的技艺,而理解他人是一切沟通的起点。
Emotional AI 的长期愿景,是成为每个人随身携带的「对话排练厅」:
- 在重要的谈话之前,有一个安全的沙盒去试错,把最坏的误解留在练习里;
- 让 AI 不只学会「像人说话」,更学会站在他人的立场上理解人—— 当你与它预演时,你其实是在学习一种视角转换的能力;
- 证明一类真正尊重用户的 AI 产品形态:模型在云端推理,但记忆、画像与关系 永远只属于你和你的机器。
同时我们清醒地划出边界:这个工具的目的是理解与自我成长, 它不应、也不会被用于操纵或伤害任何真实的人。 每一次预演的终点,都是更真诚的现实对话。
© 2026 Nanyang Technological University · WANG QIALUN
Emotional AI V1.0.4

