适合在手机上看。完整版（带截图、20+ 章）在安装后桌面的 布嘎使用教程.docx 里。当前版本 v3.15.2.1.1.2.1.2.1。
双击桌面上的 布嘎 图标。加载约 2 秒，屏幕右侧会出现一团会呼吸的光。
| 形态 | 长什么样 | 怎么切 |
|---|---|---|
| 球形 | 一团放射状的光 | 拖到任意位置；点一下展开面板 |
| 面板 | 输入框 + 语音/截屏按钮 | 点球；或右键 → 展开 |
| 折叠 | 只有一行输入框 | 面板右上角的小箭头 |
按住 Ctrl+Alt+空格，说完松手，约 0.1 秒出结果。
下面这些说法都能叫醒它（10 种）：
| 说法 | 说明 |
|---|---|
| 你好布嘎 / 你好布嘎布嘎 | 最标准 |
| 嗨布嘎 / 嘿布嘎 | 更短，容易叫醒 |
| 布嘎 / 布嘎布嘎 | 安静的屋子里很灵 |
叫醒后会有一声轻提示音，然后开始听你说话。6 秒没听到任何话，它会自己收起来，不会一直挂在屏幕上。
嫌它太灵敏（看视频时自己醒）：右键 → 唤醒灵敏度 → 低；叫不醒就调 高。也可以右键关闭唤醒词，只用热键。
点输入框打字，或点「截屏」让它看屏幕。
| 类别 | 你可以说 | 它会 |
|---|---|---|
| 程序 | 打开微信 / 帮我叫出网易云 / 把微信打开 | 已开着的叫到前台，没开才启动 |
| 音量亮度 | 音量调到 30 / 声音大一点 / 静音 / 亮度调到 60 | 直接调 |
| 算术 | 128 乘 37 / 一百二十三加四百五十六 / 2 的 10 次方 | 直接算，中文数字也认 |
| 时间日期 | 现在几点 / 今天几号 / 今天星期几 | 直接答 |
| 天气 | 明天北京天气 / 明天北京海淀区会下雨吗 / 外面冷吗 | 联网查，同一天第二次秒回（缓存） |
| 建文件 | 建个 PPT 叫周报 / 新建 word 叫报告 / 做个 excel 叫数据 / 建个文件夹叫资料 | 在桌面创建并打开 |
| 看屏幕 | 看看屏幕上写了什么 / 屏幕上是什么 / 屏幕上有报错吗 | 读字（1 秒）或看图（5 秒） |
| 读文档 | 总结 报告.docx / 读一下这个 pdf | 读出来并给要点（见第七节） |
| 剪贴板 | 剪贴板里是什么 / 剪贴板历史 / 用回第 2 条 | 读 / 列 / 放回剪贴板 |
| 提醒 | 10 分钟后提醒我喝水 / 看看有什么提醒 / 取消提醒 | 定时弹提醒，重启布嘎也不丢 |
| 窗口 | 把窗口放左边 / 窗口最大化 / 窗口居中 / 窗口放右下 | 调整当前窗口位置 |
| 多步 | 打开计算器然后静音 / 建个文件夹叫资料再打开记事本 | 按顺序一步步做 |
| 系统 | 显示桌面 / 截屏 / 还有多少电 | 执行 |
| 找文件 | 找一下我的简历 | 在常用目录里搜 |
它怎么回答你的问题，取决于右上角这项设置（右键 → 思考用）：
| 模式 | 有网时 | 没网时 | 花钱吗 | 会不会打扰你 |
|---|---|---|---|---|
| 在线 API | 用你填的 Key 联网答（约 1 秒） | 自动回本地模型 | 按用量，很少 | 不会 |
| 本地模型 | 用电脑上的小模型（1~4 秒） | 照常用 | 完全免费 | 不会 |
| DSH 协作 | 把难活转给 DSH 处理 | — | 用你的 DSH 额度 | 会（默认关） |
回答前面的标记含义：☁️ = 在线答的，🧠 = 本地模型答的，没有标记 = 本机技能直接执行（例如天气、开程序）。
右键 → 本地模型档位。它会先探测你的显卡和内存，标 ★ 的就是推荐档，点一下自动下载并切换。
| 档位 | 模型 | 下载 | 适合的电脑 |
|---|---|---|---|
| 极简 | qwen2.5:0.5b | 0.4G | 核显、8G 内存以下 |
| 轻量 | qwen2.5:1.5b | 1G | 核显（Iris Xe 这类） |
| 标准 | qwen2.5:3b | 2G | 6G 显存以上 |
| 进阶 | qwen2.5:7b | 4.7G | 8G 显存（3060 / 4060） |
| 高性能 | qwen2.5:14b | 9G | 12~16G 显存 |
| 顶级 | qwen2.5:32b | 20G | 24G 显存（3090 / 4090 / 5090） |
右键 → 看图方式，三选一：
| 方式 | 速度 | 要准备什么 | 适合 |
|---|---|---|---|
| 只用系统读字（默认） | 1 秒 | 什么都不用 | 看报错、读网页、认表格文字 |
| 本地视觉模型 | 20~40 秒 | 下载 qwen2.5vl:3b（3.2G） | 想看界面长什么样、认图标 |
| 云端视觉 | 1~5 秒 | 填一个视觉接口的 Key | 又快又准（推荐） |
推荐用智谱 GLM-4V-Flash：免费，注册后在控制台拿 API Key，右键 → 看图方式 → 云端视觉 → 粘进弹框即可。安装时也可以直接勾「同时装一个看图模型」。
两种用法：
总结 报告.docx、读一下这个 pdf| 格式 | 能读到的内容 |
|---|---|
| Word (.docx) | 正文 + 表格 |
| 有文字层的才行；扫描图片版会明确告诉你读不了 | |
| Excel (.xlsx) | 前 200 行，带工作表名 |
| PPT (.pptx) | 每页文字，标了页码 |
| txt / md / csv | 直接读 |
用「然后 / 再 / 接着 / 之后 / 并且 / 顺便」把几件事串起来，最多 5 步：
打开计算器然后静音 建个文件夹叫资料再打开记事本
| 说 | 效果 |
|---|---|
| 把窗口放左边 / 右半屏 | 占半屏 |
| 窗口最大化 / 最小化 / 还原 | 对应操作 |
| 窗口居中 / 左上 / 右下 | 停到指定位置 |
它会自动识别窗口在哪块屏幕上，多显示器也对。
它在后台记着最近 30 条复制过的文字，存在本机，重启也在。
剪贴板历史 → 列出最近 8 条用回第 2 条 → 把那条放回剪贴板剪贴板里是什么 → 看当前这条右键 → 插件目录，往文件夹里放一个 .py，重启布嘎就多一个技能。插件里只要写两个东西：
| 内容 | 作用 |
|---|---|
PATTERNS = [r"查汇率"] | 哪些话归它管（正则） |
def handle(m, text) | 干什么活，返回 (True, "回答") |
右键 → MCP 工具服务，在 mcp_servers.json 里填服务（例如 filesystem，只给它一个目录）。填完重启，它就能用那些工具干活。
| 入口 | 给谁用 |
|---|---|
buga-run.bat "打开微信" | 任何脚本 / 批处理 |
buga_skill.py | Python 程序 |
buga_mcp.py | 支持 MCP 的 AI 客户端（Claude Desktop、Cursor 等） |
反过来，在布嘎里说「问 DSH 帮我改这个文件」，它会把话转给 DSH（默认关闭，需要时在右键菜单开「DSH 协作」）。
| 项目 | 说明 |
|---|---|
| 数据收集 | 不收集、不上传文件、不需要注册账号 |
| API Key | 用 Windows 自带 DPAPI 加密保存，只有你这个登录账户能解开 |
| 电源操作 | 锁屏 / 休眠 / 关机默认禁用，需手动开启 |
| 权限等级 | 简单 / 标准 / 完全，决定它能动多深（右键 → 权限等级） |
| 删文件 | 只删到回收站 |
| MCP 服务 | 默认全关，用哪个开哪个；第三方服务先看它的源码 |
完全不用网：开程序、音量亮度、算数、时间日期、电量、建/删文件、剪贴板、提醒、窗口、截屏、看屏幕读字、唤醒词。
需要网：天气、AI 问答。装了本地模型的话，断网也能问答（前面带 🧠）。
默认自动更新：启动时检查新版本，有就提示，点了会静默安装并自动重启，设置不会丢。也可以右键 → 检查更新。
右键 → 生成月度报告：自动统计这个月「哪些话没听懂」「哪些地方报错」，生成一份 Markdown 清单，告诉你下个月该补什么。数据全部来自本机日志，不上传。
这是 Windows 的 SmartScreen 提示，因为布嘎没有购买微软认证证书（一年几千块），不是病毒。解决：点弹窗里的 「更多信息」→「仍要运行」。
如果双击安装包完全没反应（连蓝框都不出）：右键安装包 → 属性 → 勾选最下面的 「解除锁定」 → 确定，再双击。
权限调到「完全」之后，布嘎不再只是聊天——它会自己读文件、写文件、跑命令，干完再回你。
| 你说 | 它内部做什么 |
|---|---|
| 读一下 D 盘那个 config.json 第 5 行写了啥 | READ 文件，把内容摘给你 |
| 把这个文件里的 8080 改成 9090 | READ → WRITE 整份写回 → 回答改好了 |
| 跑一下这个脚本，看报什么错 | SHELL 执行，把报错原文贴给你 |
① 写文件是整份覆盖，不是打补丁；改几百行以上的大文件容易写不全，建议交给 DSH。
② 默认每次动手前会弹确认框；嫌烦：右键 → 🧠 AI 与模型 → 自动执行：开。
③ 一次最多 6 轮工具调用；不填 API Key / 断网时这段能力不生效。
看屏幕右侧有没有光团，可能被别的窗口挡住。第一次启动要加载模型，约 2 秒。
右键 → 唤醒灵敏度 → 高；确认「唤醒词：开」；开会软件（腾讯会议、微信语音）会抢麦克风。
灵敏度调「低」；还不行就关掉唤醒词，只用 Ctrl+Alt+空格。
它现在会先复述确认：「我听到的是「啊」，对吗？」——说「是」才执行。
让它「继续」，或把「思考用」切成在线 API。
可能提示「未知发布者」，因为没买数字签名。选择允许运行即可。安装包已做自签名，双击「安装签名证书.bat」后可减少提示。
不装离线 AI 约 60MB；本地模型常驻：1.5b 约 1GB、3b 约 2GB、7b 约 5GB。
C:\Users\你的用户名\.dsh\handoff（ai_config.json 是设置，reminders.json 是提醒，clip_history.json 是剪贴板历史）。
| 东西 | 位置 |
|---|---|
| 程序 | 你安装时选的目录（默认 %LOCALAPPDATA%\Programs\布嘎） |
| 配置 / 历史 | %USERPROFILE%\.dsh\handoff |
| 教程（Word） | 桌面 布嘎使用教程.docx |
| 日志 | %TEMP%\desktop_agent.log（超过 2MB 自动轮转） |
卸载：安装目录里的 卸载.bat，或控制面板 → 应用 → 布嘎。想彻底清干净就再把 %USERPROFILE%\.dsh\handoff 删掉。