给主播朋友们用的 B 站直播间桌面助手。自动欢迎、礼物感谢、屏幕特效、TTS 语音、弹幕朗读、弹幕点歌台、弹幕抽奖 / 投票 / 赛马 / 养宠互动、弹幕悬浮窗（钉住穿透）、SuperChat 横幅、盲盒查询、DeepSeek AI 智能回复、OBS 观众端主题。 立项时间：2026-05-12 · 立项人：跳蛛先生 · 当前版本：v1.9.0 · 状态：朋友内测版
📥 下载安装：点击上方绿色按钮，或前往 Releases 页面 下载
LiveLink-Setup-x.x.x.exe，双击即装。首次运行若被 Windows SmartScreen 拦截，点「更多信息 → 仍要运行」即可。
跳蛛先生在朋友的直播间看到一个弹幕互动插件，感兴趣，决定 DIY 一个供主播朋友圈使用。终端用户是非技术主播，对"装环境"零容忍。
最终交付：
- 一份双击即用的 Windows 桌面应用（
.exe安装包） - 主播双击安装 → 输入直播间号 → 点击"开始" → 在 OBS 添加一个浏览器源 → 立即能用
- 不写 Python、不装 Node、不开命令行
| # | 功能 | 状态 |
|---|---|---|
| 1 | 新进房间自动欢迎（按粉丝牌等级过滤、Home 快捷开关） | ✅ |
| 2 | 观众弹幕关键词回复（自定义关键词 / 正则 / 粉丝牌门槛） | ✅ |
| 3 | 礼物感谢 + OBS overlay 礼物特效（按价位 3 档动画 + 真实礼物图） | ✅ |
| 4 | TTS 语音播报（Edge TTS 8 个中文音色，分事件多角色） | ✅ |
| 4b | 弹幕朗读（把观众发的弹幕原文念出来：范围过滤 / 垃圾净化 / 去重限流 / 独立音色） | ✅ |
| # | 功能 | 状态 |
|---|---|---|
| 5 | 主播弹幕悬浮窗（置顶 / 钉住穿透 / 字体、透明度、颜色、动画与停留时间可调） | ✅ |
| 6 | OBS 弹幕信息板（给观众看，任意位置拖动 + 完整样式面板与即时预览） | ✅ |
| 7 | SuperChat 横幅展示（按价位 4 档视觉：basic / premium / epic / legendary 屏幕中央） | ✅ |
| 8 | 盲盒投喂记录查询（弹幕"查盲盒"→ Overlay 盈亏卡） | ✅ |
| # | 功能 | 状态 |
|---|---|---|
| 9 | 弹幕抽奖（关键词参与 → 倒计时 → Overlay 公布中奖名单） | ✅ |
| 10 | 互动投票（2-6 选项 → 实时柱状图 → 公布赢家） | ✅ |
| 11 | 赛马（2-8 匹马 → 弹幕押注 → 随机赛跑动画 → 排名 + 押中观众） | ✅ |
| 12 | 三大游戏开场招牌 + 结果飘彩庆祝（屏幕全局视觉） | ✅ |
| 13 | 直播养宠（哈松币领养 / 投喂 / 观看时长成长 / 3 阶进化 / OBS 底部宠物栏） | ✅ |
| 14 | 曼波播报风格（TTS 轻快抽象预设，不克隆具体人物声线） | ✅ |
| 15 | DeepSeek AI 智能回复（主播自备 API Key，默认关闭，不填 Key 不产生费用） | ✅ |
| 16 | OBS 观众端主题（樱花甜心 / 糖果泡泡 / 霓虹夜场 / 经典简约） | ✅ |
| 17 | 弹幕点歌台（弹幕点歌 → 队列 → OBS 点歌板；可设门槛 / 消耗货币，删歌自动退币） | ✅ |
| # | 功能 | 状态 |
|---|---|---|
| # | 功能 | 状态 |
| --- | --- | --- |
| 18 | 抖音 / 虎牙适配器 | P3 |
- 桌面框架：Electron + TypeScript
- UI 层：Vue 3 + Vite + Tailwind CSS（控制台 + OBS Overlay 同一技术栈）
- B 站协议：
blive-message-listener(npm) - TTS：
edge-tts-universal(npm，免费、20+ 中文语音、无 API key) - OBS 联动：内嵌 Express + Socket.IO 本地 HTTP 服务，OBS 用浏览器源加载
http://localhost:<port>/overlay - 配置持久化：
electron-store - 打包：
electron-builder输出 NSIS 安装器
P0 MVP ┃ ✅ 骨架 + 三件套 + TTS + 礼物特效 overlay + 打包成 exe
P0.5 分发就绪 ┃ ✅ NSIS 中文化 + SESSDATA 加密 + 应用图标 + 开始菜单分组
P1 增强 ┃ ✅ 粉丝牌过滤 / 盲盒查询 / 弹幕悬浮窗 / 抽奖 / SC 横幅 / 分事件 TTS
/ OBS 弹幕信息板（任意位置）
P2 互动小游戏 ┃ ✅ 投票 / 赛马 / 开场招牌 + 结果飘彩
P2+ 养成+AI ┃ ✅ 养宠 / DeepSeek AI 回复 / 曼波播报 / 观众端主题
P3 多平台 ┃ ❌ 抖音 / 虎牙适配器
详见 ROADMAP.md，v1.4.0 变更日志见 docs/RELEASE_NOTES_v1.4.0.md。
D:\B站直播弹幕+礼物插件\
├── README.md # 本文档（项目概述）
├── ROADMAP.md # 阶段路线图
├── ARCHITECTURE.md # 系统架构与模块边界
├── package.json # Electron + Vite 项目根
├── electron-builder.yml # 打包配置
├── src/
│ ├── main/ # Electron 主进程（Node.js）
│ │ ├── index.ts # 主进程入口
│ │ ├── platform/ # 平台适配层（含 BilibiliAdapter）
│ │ ├── events/ # 统一事件总线
│ │ ├── rules/ # 规则引擎（欢迎/回复/感谢）
│ │ ├── actions/ # 动作派发（TTS / Overlay / 日志）
│ │ ├── overlay-server/ # 内嵌 Express + Socket.IO
│ │ └── config/ # electron-store 配置封装
│ ├── preload/ # Electron preload 脚本（IPC 桥）
│ ├── renderer/ # 控制台 UI（Vue 3）
│ │ ├── pages/ # 房间号配置 / 规则编辑 / 实时日志
│ │ └── components/
│ └── overlay/ # OBS 浏览器源页面（Vue 3 单页）
│ ├── index.html
│ └── gift-effect/ # 礼物弹出特效组件
├── resources/ # 打包资源（图标、默认音效等）
├── dist/ # 打包输出（gitignored）
└── docs/ # 用户文档（主播使用手册）
└── 主播使用说明.md
- 项目主文档：
README.md（你正在读） - 路线图：
ROADMAP.md - 架构设计：
ARCHITECTURE.md - 阶段交接文档：
D:\AIGC工作站\跨会话协作\B站直播弹幕插件_P*_交接给_ClaudeCode.md - 完工报告（Claude Code 写）：
D:\AIGC工作站\跨会话协作\B站直播弹幕插件_P*_完成报告.md
当前模式（2026-05-13 起）：
[跳蛛先生] [Claude Code] [Cowork Claude · 按需]
│ │ │
│ 直接说需求 │ │
├──────────────────────────►│ │
│ │ 实现 + 自己 ff 到 main │
│ │ + 复制 exe 到主工作树 │
│ │ + 写完成报告 │
│◄─────────────────────────┤ │
│ 自己测试 + git push │
│ │
│ 遇到架构决策 / review / 全局协调 时主动叫 │
├────────────────────────────────────────────────────►│
│ │ 讨论 / 二选一意见
│◄────────────────────────────────────────────────────┤
跳蛛先生参与度：高。他直接 drive 工程，Cowork 只在他主动求助时介入。
历史模式（P0/P0.5 期 · 2026-05-12 之前）：
[跳蛛先生] ──► [Cowork] ──写交接文档──► [Claude Code]
│ │
│◄──完成报告 / 验收─────────┘
[跳蛛先生] ◄── [Cowork] 反馈
那个阶段 Cowork 当协调员价值高（架构选型 / 静态审查 / 教程图 / 模式约定）。进入 P1 维护期后，跳蛛先生直接对接 Claude Code 更高效，Cowork 仅在需要"另一双眼睛"或"卡住要拍板"时被主动调用。
模式变更详见 D:\AIGC工作站\跨会话协作\B站直播弹幕插件_协作模式变更_交接给_ClaudeCode.md。