Skip to content

About

一款纯本地的 AI 人格分析与对话预演桌面应用。 上传一段真实的聊天记录,让 AI 以第三方视角读懂「对方」, 再走进你的视角,替 TA 与你预演那场还没发生的对话。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Emotional AI

把「想说的话」,先说给 AI 听。

一款纯本地的 AI 人格分析与对话预演桌面应用。 上传一段真实的聊天记录,让 AI 以第三方视角读懂「对方」, 再走进你的视角,替 TA 与你预演那场还没发生的对话。

V1.0.4 · Windows · 纯本地运行

Emotional AI 第三视角:聊天记录解读与画像自动沉淀

第三视角 · 分析师:粘贴聊天记录后,AI 流式解读对方性格,画像与标签自动沉淀于右上角


为什么做这件事

生活中最重要的那些对话——解释、道歉、争取、告别——往往发生在我们最没有准备的时候。 等真正坐到对方面前,情绪已经替我们说了话。

Emotional AI 想做的,是在对话发生之前,给你一个可以停下来思考的空间:

  1. 先理解——把你们的聊天记录交给「分析师」,从旁观者的角度读出 TA 的性格、在意的事与沟通模式;
  2. 再预演——由 AI 扮演 TA,和你反复推演想说的话,直到你说出自己想要的那一版;
  3. 最后回到现实——带着更清晰的判断,去进行那场真实的对话。

它不替你说话,只帮你看清。

核心功能

第三视角 · 分析师

  • 粘贴 名字:内容 格式的聊天记录,或直接描述你所面对的情况;
  • 深度思考模型流式解读:对方是什么样的人、雷区在哪里、建议你如何切入;
  • 解读结果自动沉淀为画像(一句话概括 + 性格标签),随输入不断修正;
  • 全程可见 AI 的工作状态(判断输入类型 → 整理对话记录 → 输出分析)。

主视角 · 对话预演

  • AI 根据画像扮演「对方」,与你实时对话,可用模型一键切换;
  • 每条回复附带分析师的心路历程注解,让你看到「TA 为什么这么说」;
  • 历史聊天记录经向量化存入本地记忆库,对话时自动检索相关片段作为上下文, 扮演越用越像。

Emotional AI 主视角:与扮演的「对方」对话预演

主视角 · 对话预演:AI 扮演「对方」与你实时对话,每条回复下方附分析师的心路历程注解

画像与多关系管理

  • 侧栏管理多个人物画像(家人、朋友、同事……彼此独立);
  • 画像随时手动「更新重塑」;
  • 侧栏支持收缩,最小化时只保留首字与图标。

Emotional 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
Loading
  • 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 符号链接的报错)后重试。

发布新版本

  1. 修改代码,并把 package.json 的 version 改高(如 1.0.3 → 1.0.4);
  2. 运行 npm run dist,得到新的 Emotional-AI-Setup-1.0.4.exe;
  3. 直接运行新安装包即可覆盖升级(appId 不变,Windows 识别为同一软件),数据与设置保留;
  4. 若新版本改了数据库结构,在 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

更新日志

V1.0.4

完整的模型设置(火山方舟模型会更新下线,模型 ID 不再写死)

  • 扮演、分析师、辅助、向量四类模型各自可填任意 Model ID 或推理接入点 ID(ep- 开头), 改完立即生效、无需更新软件;设置保存在数据目录 model_settings.json
  • 每个模型都可单独「测试」:用表单里尚未保存的值发一次真实请求,返回可用性、耗时(向量模型还返回实际维度)
  • 可修改接口地址(兼容 OpenAI 格式的服务)、扮演 / 分析师温度;单项「恢复默认」与「恢复全部默认模型」
  • 向量记忆支持多模态 / 文本两种接口与自定义输出维度

记忆库重建

  • 记忆库记录自己由哪个向量模型、多少维生成;更换向量设置后自动识别为「待重建」, 期间检索暂停(对话照常进行),新产生的记忆以原文暂存,不会丢失
  • 一键重建:用新模型重新向量化全部记忆(含暂存),显示进度;全部成功后才替换旧索引, 中途失败旧索引原样保留、可重试;空记忆库直接采用新设置,无需重建

V1.0.3

问题修复

  • 主视角重启后历史「消失」:前端没记住已有会话,每次重启都新建一个;现由服务端统一 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

About

一款纯本地的 AI 人格分析与对话预演桌面应用。 上传一段真实的聊天记录,让 AI 以第三方视角读懂「对方」, 再走进你的视角,替 TA 与你预演那场还没发生的对话。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages