danmuai

项目概述

DanmuAI 是一款运行在 Windows 的桌面 AI 弹幕助手，会按设定间隔截取指定显示器的画面，调用视觉模型理解画面内容并生成弹幕，再通过透明置顶的弹幕浮层展示。你可以在本地 Web 控制台中配置模型、人格、显示器、弹幕样式和运行参数。

让直播、录播、游戏和桌面内容拥有一个会观察、会吐槽的 AI 观众

主要功能

• 视觉弹幕：定时截取屏幕，将画面交给视觉模型生成一批与当前内容相关的弹幕
• 自定义人格与模型：配置人格、模型平台、端点和自定义模型，控制弹幕语气
• 透明弹幕浮层：在指定显示器上滚动展示弹幕，不依赖 Web 控制台是否打开
• AI 读弹幕：支持 MiMo、阿里百炼 Qwen3、MiniMax 和豆包 V3，提供音色目录、缓存、刷新与试听
• 弹幕外观可调：支持浮动面板动画、内置样式和受管 CSS 主题
• 多显示器支持：分别选择截图显示器与弹幕浮层显示器
• 可选扩展：包含麦克风输入、虚拟主播 Live2D 模型导入、烂梗弹幕与知识库等模块

适用人群

• 主播：希望给直播或录播增加 AI 弹幕的主播
• 内容观众：想要一个 AI 观众吐槽游戏或桌面内容的用户
• TTS 用户：需要 AI 朗读弹幕功能的用户
• 进阶用户：愿意自行配置模型平台与 API Key 的用户

快速上手

1. 从 Releases 页面下载最新 Windows 版本，安装版选 Setup.exe，便携版选 Portable.zip
2. 启动后在 Web 控制台填写模型平台、API Key 和模型信息
3. 选择截图显示器、弹幕显示器、识别间隔、每批弹幕数量、人格和样式
4. 开始运行，弹幕会显示在指定的显示器上
5. 如需 AI 朗读，在「AI 读弹幕」页面选择 provider、音色、朗读间隔和风格

核心优势

• 会看画面：基于屏幕截图与视觉模型，弹幕内容与当前画面相关
• 本地优先：控制台默认只监听本机，截图默认在内存中压缩，不主动写盘
• 自由配置：模型、人格、显示器与弹幕样式都可自行调整
• 不打断观看：弹幕浮层独立于控制台运行，控制台关闭也不影响显示

系统要求

项目	要求
操作系统	Windows
支持架构	Windows 桌面
运行环境	源码运行需 Python 3.12；使用默认桌面壳需 WebView2

注意事项

• 凭据安全：API Key 只填写在应用配置中，不要提交到仓库或公开截图
• 本地存储：配置、模型信息和凭据保存在本机 %APPDATA%/DanmuAI/ 目录
• 数据外发：是否将画面或文本发送到外部服务取决于你配置的模型平台
• 使用责任：AI 生成内容与第三方服务的使用责任由使用者自行承担