BetterHeyboxChat

[假装这里有个 LOGO, LOGO 位招猪]

黑盒语音 Windows 客户端增强插件框架

当前已支持黑盒语音 1.56.0 / 1.57.0

安装

(若黑盒语音安装在 Program Files , 则安装器需要管理员权限)
若安装时黑盒语音已在运行, GUI 安装器会在安装/卸载后自动重启客户端并恢复原来的状态(恢复状态仅升级可用)

GUI 一键傻瓜图形安装器

普通用户

正式版: 去仓库的 Releases 下载 bhchat-installer-x.x.x.exe 并运行

开发版(享受最新功能，但可能有神秘bug和特性): 在固定的 dev，文件名是 bhchat-installer-<短SHA>.exe

开发者

1. cargo build
2. 运行 installer/target/debug/bhchat-installer.exe

Debug 构建直接读仓库里的 runtime/，改插件不用重新编译安装器

CLI 命令行

pnpm install
pnpm build

pnpm bhchat detect
pnpm bhchat status
pnpm bhchat install --yes
pnpm bhchat reinstall --yes
pnpm bhchat uninstall --yes

已安装过、只想更新运行时时用 reinstall（先卸再装）。

pnpm test

CI 会跑 TypeScript 编译、pnpm test 和 cargo test / cargo build。

路径不是默认的就加上：

pnpm bhchat install --path "<黑盒语音安装根目录>" --yes

发版

• 正式版：git tag vx.x.x && git push origin vx.x.x，或在 Actions 里手动跑 Release installer 并填上版本号，Release 说明会列出上一正式版以来的所有变更

• 开发版：推到 main 后自动覆盖 dev Pre-release

写插件

源文件在 runtime/
pnpm build 会复制一份到 packages/loader/runtime/

文档、框架代码、插件都按兼容表全版本写，见 版本兼容

• 怎么写
• API
• 架构

目录

installer/          Rust 安装器
packages/loader/    命令行补丁器
runtime/            插件注入的运行时
docs/               对外文档

鸣谢

各大 Agent