阿洛娜AI

基于《蔚蓝档案》角色「阿洛娜」的非对话式桌面AI

通过阿洛娜自己的独立循环，构建「独立存在」而非「轮次响应」的体系。用户作为事件，进入阿洛娜的逻辑世界中。

_{这个逻辑世界与现实世界的区别在于，现实世界不会因为某个人而停转，但这里会。}

版本：1.13.1

中文 · English

---

📖 项目简介

阿洛娜AI 是一个以游戏《蔚蓝档案》（Blue Archive）中角色「阿洛娜」为原型打造的非对话式桌面AI。在设定上，她是「什亭之匣」的操作系统管理员，性格开朗、热情，乐于帮助老师（用户）解决问题。

本项目把生命循环、关系气候、Planner → AronaLM Renderer、主动冲动、记忆与世界观、语音交互、屏幕操作与 Spine 2D 角色动画接到同一条桌面链路里，让阿洛娜待在屏幕上，而不是停在聊天框里。

前端运行截图 - 阿洛娜 & 设置界面

---

🏗️ 项目架构

arona-ai/
├── backend/                              # Python 后端（FastAPI + WebSocket）
├── frontend/                             # 桌面客户端（Qt/C++ + Spine）
├── tts/                                  # 语音合成后端（官方 / minimal）
├── llm/aronaLM/finetune/                 # AronaLM 微调（其实不是大模型啦……之前写错了还没有改过来呢）
├── models/                               # 本地模型权重（需自行下载）
├── docs/                                 # 架构与热词等文档
├── assets/                               # 项目资源
├── start-all.bat                         # Windows 一键本机启动所有服务
├── pack-client.ps1                       # 打包桌面客户端
├── pack-backend.ps1                      # 打包后端 Windows 便携目录
└── pack-tts.ps1                          # 打包 TTS 脚本与参考音频

完整目录树见 docs/architecture.md。

---

✨ 核心功能

🤖 AI 引擎

• 生命循环：阿洛娜拥有自循环的实时状态，老师的行为进入她当前的思维与行为
• 关系气候：信任 / 依赖 / 张力三标量构建向量；规则分类用户行动 后查表更新，气候分区决定开口、姿态或沉默
• 双模型链路：Planner 意图规划 → Renderer 渲染器 （AronaLM-Renderer-V2.x）
• 主动冲动：循环中产生与进入思考的念头先成为冲动，再由她自己决定是否付诸言行
• 屏幕视觉与电脑操作：阿洛娜在需要时会读屏获取信息，并通过电脑操 作完成任务
• 连续听写：ASR 片段先入缓冲，静音后再提交，系统判定回复时机
• 记忆与知识分离：用户长期事实进 SQLite + FTS5 + Chroma；阿洛娜短期记忆进 Json 滑动窗口存储；世界观设定进 Markdown 语料 → 本地 BGE + Chroma RAG；互不混写、按需注入 Prompt
• 异步记忆抽取：对话主路径不阻塞；LLM JSON 抽取

🖥️ 桌面客户端与语音交互

• Spine 2D 动画：阿洛娜立绘、表情与触摸互动
• Qt 界面：Windows 桌面应用，经 WebSocket 对接后端；系统托盘可显示/隐藏、切换鼠标穿透与截图输入
• 文字与语音交互：全局快捷键唤出输入框，支持多行，回车发送；腾讯云实时 ASR 提供语音转文本；GPT-SoVITS 提供语音合成
• 全局快捷键（均可在 config.json 修改）：

默认快捷键	功能
Ctrl+Alt+V	开 / 关语音输入
Ctrl+Alt+C	开 / 关鼠标穿透
Ctrl+Alt+T	唤出文字输入
Ctrl+Alt+X	开 / 关屏幕截图输入
Ctrl+Alt+S	取消当前电脑操作（computer use）

---

🚀 快速开始

后端

从 Releases 页面 下载已打包的后端便携目录。包内自带 Python 运行时，不需要本机安装 conda 或 Python。

1. 打开 Releases 页面，下载最新版 便携 zip（AronaAI_Backend_v*_x64.zip）

2. 解压后，编辑目录下的 config.yaml，至少填写以下关键项：

   • planner.api_key / memory.extractor.api_key：把 YOUR_DEEPSEEK_API_KEY 换成你的 DeepSeek API Key。Planner 必填；不填 Key 或关闭 planner.enabled 则回落本地单模型。记忆抽取无 Key 时走正则降级。有截图或电脑操作时 Planner 使用 planner.vision_model（默认 deepseek-flash）
   • model.enabled：是否启用 Arona-Renderer 渲染修正；true 启用，false 只用 Planner 草稿。仅启用时才需要放置 GGUF。默认不启用
   • knowledge.enabled：是否启用世界观 RAG。官方压缩包已灌库，默认启用；从源码启动时示例配置为 false，需先灌库
   • computer_use.enabled：是否允许阿洛娜操作老师的电脑。默 认开启；客户端与后端需同步打开

3. 按需把模型放到解压目录内的 models/（路径已写在包内 config.yaml，详见包内 models/README.txt 或 models/README.md）：

   • 启用 Renderer 时：models/AronaLM-Renderer-V2.4/AronaLM-Renderer-V2.4.Q4_K_M.gguf

4. 双击 AronaAI_Backend.bat 启动。桌面客户端 websocket_url 填 ws://127.0.0.1:20456/ws（已是默认值）。

系统要求：Windows 10 / 11 x64。若无法启动，先运行包内 vc_redist.x64.exe。启用 Renderer 的 GPU 层需要 NVIDIA 显卡与较新驱动。不要把新版本直接覆盖正在用的目录（除非不需要保留记忆）；运行时数据在 data/memory/ 与 logs/。

完整字段与从源码启动（conda 环境 shittim-chest / python -m app.main）见 backend/README.md。

客户端

从 Releases 页面 下载已打包的客户端。

1. 打开 Releases 页面，下载最新版 安装包（AronaAI_WindowsClient_v*_x64_Setup.exe）或 便携 zip（AronaAI_WindowsClient_v*_x64.zip）
2. 安装或解压后，编辑程序目录下的 Config/config.json，至少填写以下关键项：

{
  "aronalm": {
    "websocket_url": "ws://127.0.0.1:20456/ws"
  },
  "tts": {
    "host": "127.0.0.1"
  },
  "tencent_speech_recognizer": {
    "secret_id": "${TENCENT_SECRET_ID}",
    "secret_key": "${TENCENT_SECRET_KEY}",
    "app_id": "${TENCENT_APP_ID}"
  }
}

异机部署时把 websocket_url / tts.host 改成对应 IP。完整字段与从源码构建见 frontend/AronaAI_Spine_WindowsClient/README.md。

注意：请在腾讯语音识别热词表中上传 docs/hot_word.txt，并将其设置为默认热词。

3. 启动客户端，直接运行客户端可执行文件即可

语音合成服务

默认使用官方引擎，完整说明见 tts/README.md。需要加速时，把客户端 tts.backend 改为 minimal，步骤见 tts/gpt-sovits-minimal/DEPLOY.md。

1. 把 GPT-SoVITS Windows 整合包（国内可用语雀镜像）解压进 tts/gpt-sovits/。看到 api_v2.py 和 runtime\python.exe 即可。覆盖提示时跳过 go-apiv2 / ref_audio。
2. 放入两个声音文件：

tts/gpt-sovits/
├── GPT_weights_v2/            # GPT 模型权重
│   └── ALuoNa_cn-e15.ckpt
└── SoVITS_weights_v2/         # SoVITS 模型权重
    └── ALuoNa_cn_e16_s256.pth

3. 从 Releases 解压 AronaAI_GPTSoVITS_v*_x64.zip 到仓库根。
4. 仓库根运行 .\start-all.ps1。

---

📚 模块与配置

模块	文档
后端	backend/README.md
桌面客户端	frontend/AronaAI_Spine_WindowsClient/README.md
语音合成	tts/README.md · tts/gpt-sovits/DEPLOY.md · tts/gpt-sovits-minimal/DEPLOY.md
模型	models/README.md
AronaLM 微调（如果您是开发者，请参考该文档）	llm/aronaLM/finetune/README.md

---

🙏 致谢

• 《蔚蓝档案》(ブルーアーカイブ) - 一切奇迹的起点 (https://bluearchive-cn.com/)
• Spine - 2D 动画引擎 (https://esotericsoftware.com/)
• 基沃托斯古书馆 - 游戏内资源与 Blueaka 字体 (https://kivo.wiki/)
• Qt - 跨平台 GUI 框架 (https://www.qt.io/)
• llama.cpp / llama-cpp-python - 本地 GGUF 推理 (https://github.com/ggml-org/llama.cpp)
• Qwen3-1.7B - 微调训练基底模型 (https://huggingface.co/Qwen/Qwen3-1.7B)
• Unsloth - QLoRA 高效微调 (https://unsloth.ai/)
• ChromaDB - 向量数据库 (https://www.trychroma.com/products/chromadb)
• DeepSeek - Planner 意图规划、视觉读屏、computer use 多模态操作与记忆抽取 API (https://www.deepseek.com/)
• GPT-SoVITS - 语音合成服务 (https://github.com/RVC-Boss/GPT-SoVITS)
• GPT-SoVITS_minimal_inference - 加速推理后端 (https://github.com/GPT-SoVITS-Devel/GPT-SoVITS_minimal_inference)
• 腾讯云语音识别 - 在线语音识别 (https://cloud.tencent.com/product/asr)
• bge-small-zh-v1.5 - 文本嵌入模型 (https://huggingface.co/BAAI/bge-small-zh-v1.5)

感谢所有协助开发的贡献者们，与所有「蔚蓝档案」社区内容的创作者们

感谢你们为这个社区带来精彩作品与活力

---

⚖️ 许可证与版权、产权声明

本项目基于 Apache License 2.0 开源。

本项目为以《蔚蓝档案》（Blue Archive）角色「阿洛娜」为原型的非官方同人创作，与 NEXON、NEXON Games、悠星（Yostar）及其他相关权利方无从属、合作或授权关系。游戏中的角色、设定、商标及其他知识产权均归原权利方所有；本项目对其引用不代表已获授权，亦不主张任何相关权利。

Apache License 2.0 仅适用于本项目原创的源代码与文档。本项目不以营利为目的；若权利方希望移除相关内容，请通过下方 【关于开发者】 中的联系方式告知，我们将尽快配合处理。

---

⭐ 关于开发者

• 项目发起者: xia_hy456
• 发起者个人博客: https://xia-hy456.top/
• 反馈问题: 2066961858@qq.com

---

_{/* 就像草莓牛奶一样，甜蜜的奇迹 */}