YuukaAI GUI(YuukaAI V2)

hu0503hu
7
2026-02-24
.NET
License
Platform
BlueArchive

注:GUI V2.0.0 完全重写,从 CLI 终端界面升级为图形界面

🌸 与千年科学学园研讨会会计早濑优香(Hayase Yuuka)在图形界

yuuka
  • 式、自定义主题色、背景图片

  • yuuka

    - 分类清晰的设置面板,实时预览效果

  • 毛玻璃效果 - 可调整的区域透明度,打造个性化界面

  • 气泡样式自定义 - 用户 /AI 气泡颜色、间距、圆角、内边距

  • 三层记忆系统 - 短期记忆、中期摘要、长期记忆

  • 设置自动保存 - 配置自动保存到本地,下次启动自动加载

🚀 快速开始

下载运行

Releases 下载对应平台的可执行文件。

配置 API Key

首次启动后,点击右上角 「设置」 按钮,在 「API 设置」 中配置:

  1. 输入你的 API Key(留空使用默认)

  2. 点击 「保存并连接」

🔑 获取 API Key:阿里云百炼

自定义主题

打开设置面板,你可以:

  • 常规设置 - 切换深色 / 浅色模式、调整字体大小和圆角

  • 外观设置 - 选择主题色、调整各区域透明度

  • 气泡设置 - 自定义用户和 AI 的气泡颜色、消息间距

  • 背景设置 - 设置背景图片和不透明度

  • 记忆设置 - 配置三层记忆系统(短期记忆、中期摘要、长期向量记忆)

📦 构建发布

环境要求

构建命令

# 调试运行
dotnet run

# 发布 Windows 版本(框架依赖,单文件)
dotnet publish -f net10.0 -c Release -p:PublishSingleFile=true --self-contained false

🧠 记忆系统

YuukaAI GUI 采用三层记忆架构,让 AI 能够记住对话历史和用户偏好:

短期记忆

  • 保留最近 N 轮对话(默认 20 轮,可配置 5-50 轮)

  • 用于维持即时对话的连贯性

  • 自动清理旧对话,控制上下文长度

中期摘要

  • 使用千问 Flash 模型自动生成对话摘要

  • 每 N 轮对话触发一次(默认 50 轮,可配置 20-100 轮)

  • 摘要仅对主模型可见,帮助理解历史背景

长期记忆

  • 自动提取用户偏好、重要事实、特定信息

  • 使用智能相关性评分算法检索

  • 支持关键词匹配、时间衰减、类别优先级

记忆配置

在设置面板的「记忆」菜单中,你可以:

  • 启用 / 禁用记忆功能

  • 配置短期记忆轮数

  • 配置摘要生成间隔

  • 设置自定义 API Key(留空使用主模型 API Key)

  • 清除所有记忆

🏗️ 项目结构

yuukaaigui/
├── Program.cs              # 程序入口点 & 主视图逻辑
├── yuukaaigui.csproj       # 项目配置文件
├── Memory/                 # 记忆系统
│   ├── MemoryConfig.cs     # 记忆配置
│   ├── MemoryManager.cs    # 记忆管理器
│   ├── SummaryService.cs   # 摘要服务
│   └── VectorStoreService.cs # 向量存储服务
├── Core/
│   ├── Client.cs           # AI 对话客户端
│   └── Models/
│       ├── Message.cs      # 消息模型
│       ├── ChatResponse.cs # API 响应模型
│       └── ChatChoice.cs   # 选择项模型
└── favicon.ico             # 应用程序图标

🔧 自定义角色设定

你可以在 Program.cs 中修改 CharacterPrompt 常量来自定义角色行为和性格。

🖼️ 界面预览

主界面

  • 简洁的聊天界面,气泡式消息展示

  • 支持用户(右侧)和 AI(左侧)消息对齐

  • 实时显示 "思考中..." 状态

设置面板

  • 左侧分类菜单:常规、外观、气泡、背景、API、记忆

  • 右侧详细设置,支持实时预览

  • 支持主题色选择(20 种预设颜色)

  • 记忆系统配置(三层记忆架构)

📝 更新日志

GUI V2.1.2

  • 优化 UI

  • 优化深色主题

  • 实验性添加动画功能

GUI V2.1.0

  • 优化设定内容

  • 支持长期记忆

📜 许可证

本项目采用 AGPL-3.0 许可证 开源。

🙏 致谢

📧 联系方式

如有问题或建议,欢迎通过以下方式联系:

支持开发:爱发电


"完美~与计算一致"

🌸 与千年科学学园研讨会会计早濑优香(Hayase Yuuka)在图形界面中聊天

动物装饰