Amitia（Ai智能体陪伴项目）开源项目Vibe Coding

立项原因
当前主流 AI 对话工具存在三大痛点：一是对话无记忆，每次聊天都从零开始，无法建立真正的情感连接；二是数据上云，用户隐私难以保障，个人对话和偏好存在泄露风险；三是功能单一，仅能提供问答服务，缺少个性化陪伴与主动关怀能力。阿米缇娅旨在解决上述产品问题，打造一款数据完全本地化、具备长期记忆、能够主动交互的桌面端私人 AI 陪伴应用。

行业场景
随着大模型技术普及和情感经济崛起，AI 虚拟伴侣市场正快速增长。现代都市人群面临孤独感加剧、社交圈收窄等现实困境，对低成本、高隐私、可定制的情感陪伴服务需求日益旺盛。桌面端 AI 陪伴产品天然契合办公与家居场景，用户希望在工作间隙获得放松与陪伴，同时严守个人数据隐私。微信、QQ 等社交平台的桥接能力进一步拓展了使用边界，使 AI 陪伴能够融入用户日常沟通习惯，形成持续性、场景化的服务体验。

阿米缇娅是一款本地优先的桌面 AI 陪伴应用。支持接入 OpenAI 兼容 API，可对接 DeepSeek、Ollama 等多种大模型。基于 Qdrant 向量数据库实现长期记忆，AI 能记住你们之间的重要对话；SurrealDB 知识图谱让 AI 理解人物关系与上下文。提供多角色系统，每个角色拥有独立性格与记忆。内置 TTS 语音合成与 ASR 语音识别，支持语音交互。具备主动关怀能力，AI 可定时发起问候与提醒。支持微信、 QQ 侧车桥接，实现跨平台对话。所有数据本地存储，隐私无忧。

一、我负责的具体任务
本人主导了 Electron 桌宠窗口重构（第5步） 的完整实施，具体任务涵盖前后端多个层面：

后端部分：
完成 Runtime Bridge 协议接线，实现 WebSocket 通信端点注册
设计并实现 RuntimeSettings 增强机制，引入 Revision 乐观并发控制
编写数据库迁移脚本，新增三张运行时表（clients、commands、actual_states）
实现事件/心跳/结果的持久化存储逻辑
处理客户端连接生命周期管理（上线、离线、状态同步）

桌面端（Electron）部分：
从零搭建 runtime-bridge-client.ts，实现 WebSocket 客户端完整协议通信
设计并实现 pet-preload.ts，负责渲染进程与主进程的安全 IPC 通信
重构 window-adapter.ts，配置沙箱模式与专用 preload 加载
实现三模式穿透（none/alpha/boundingBox）及像素级命中测试
实现手势识别系统（单击、双击、悬停、拖动去抖与阈值检测）
集成 manager.ts，完成 Bridge 命令回调映射与状态对账逻辑
构建 pet.html Canvas 渲染页面，支持 DPI 感知与透明背景
二、技术栈、架构与实现亮点
技术栈： Go（Gin + GORM）、Vue 3 + TypeScript + Vite、Electron、Qdrant 向量数据库、SurrealDB 图数据库、WebSocket 双工通信。

架构设计： 采用 C/S 分离架构，后端通过 WebSocket Bridge 协议与 Electron 渲染进程通信；引入状态机模型管理桌宠生命周期（spawn → play → sync → shutdown）；使用乐观并发控制（Revision CAS）解