注:GUI V2.0.0 完全重写,从 CLI 终端界面升级为图形界面
🌸 与千年科学学园研讨会会计早濑优香(Hayase Yuuka)在图形界
式、自定义主题色、背景图片
多

- 分类清晰的设置面板,实时预览效果
毛玻璃效果 - 可调整的区域透明度,打造个性化界面
气泡样式自定义 - 用户 /AI 气泡颜色、间距、圆角、内边距
三层记忆系统 - 短期记忆、中期摘要、长期记忆
设置自动保存 - 配置自动保存到本地,下次启动自动加载
🚀 快速开始
下载运行
从 Releases 下载对应平台的可执行文件。
配置 API Key
首次启动后,点击右上角 「设置」 按钮,在 「API 设置」 中配置:
输入你的 API Key(留空使用默认)
点击 「保存并连接」
🔑 获取 API Key:阿里云百炼
自定义主题
打开设置面板,你可以:
常规设置 - 切换深色 / 浅色模式、调整字体大小和圆角
外观设置 - 选择主题色、调整各区域透明度
气泡设置 - 自定义用户和 AI 的气泡颜色、消息间距
背景设置 - 设置背景图片和不透明度
记忆设置 - 配置三层记忆系统(短期记忆、中期摘要、长期向量记忆)
📦 构建发布
环境要求
Windows/Linux/macOS 构建无需额外依赖
构建命令
# 调试运行
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 许可证 开源。
🙏 致谢
蔚蓝档案 - 早濑优香角色与蔚蓝档案的原作者
Avalonia UI - 跨平台 .NET UI 框架
DeepSeek - 提供强大的语言模型
阿里云百炼 - API 服务
📧 联系方式
如有问题或建议,欢迎通过以下方式联系:
GitHub Issues: 提交问题
Email: huyzhong@outlook.com
BiliBili:BiliBili
支持开发:爱发电
"完美~与计算一致"
🌸 与千年科学学园研讨会会计早濑优香(Hayase Yuuka)在图形界面中聊天
