﻿小锋语音伴侣 V2.3.27 —— 测试要点
（纯文本，读屏软件可直接朗读；请优先用耳朵听，不必看屏幕）

开发者：星夜高飞    开发工具：WorkBuddy（腾讯「小龙虾」）
本软件公益免费，祝大家使用便利，创业成功！

========================================
一、这一版改了什么（请重点验证这四项）
========================================

1. 录屏新增三档画质，按 Ctrl+Shift+F11 循环切换
   三档（行业标准，换到哪档会念出来）：
     高清：最高 1080p、30 帧、每分钟约 60 兆；
     标准：720p、15 帧、每分钟约 30 兆（出厂默认）；
     流畅：480p、10 帧、每分钟约 15 兆。
   请重点听三件事：
     a) 连按四次应当依次念出三档，最后回到「标准」；
     b) 各档各录半分钟，看文件大小是不是差别明显（高清约是流畅的四倍）；
     c) 录制中按下也安全：念「本次录制保持不变，下次录制生效」。

2. 开录前的「自检门禁」——专治双显卡、双声卡机器录出来没画面没声音
   a) 开录时会念出画面与声音的实际来源，例如
      「系统声音来自 扬声器 xxx、麦克风是 xxx」——
      外置声卡的用户听一眼就知道抓的是不是正在用的那块；
   b) 万一画面抓不到（个别双显卡机器、或开了 HDR 的机器），
      程序会自动换「桌面复制」方式重试并念一句「已改用桌面复制方式」；
      实在不行会如实播报「画面抓取失败，已取消本次录制」——
      绝不存出一个黑屏文件；开了 HDR 的请按提示关掉 HDR 再录。
   c) 要了声音但没抓到时，同样会播报原因并取消，不交废文件。

3. 热键调整（都是全局热键）
     Ctrl + F1  切换播报模式（结果模式 / 全部模式）；
     Ctrl + F8  也切换播报模式——F8 恢复原有功能，两个键按哪个都行；
     Ctrl + Shift + F8  问一句「现在用的是哪种音色」
                        （本版与 Ctrl+F8 对换，顺手键留给播报模式）；
     F2         读当前窗口内容摘要（从 Ctrl+F1 迁来）；
     Ctrl + Shift + F11  循环切换三档画质。
   请验证：按 Ctrl+F1 与 Ctrl+F8 都应念「已切换到××模式」；
   按 Ctrl+Shift+F8 应念出当前音色与降级原因；
   按 F2 应念窗口摘要。两个键互不串音：Ctrl+F8 不应念音色，
   Ctrl+Shift+F8 不应切模式。

4. 自检仍是 10 项，「录屏」这一项现在查五个键和画质档
   双击「一键体检（check.bat）」，最后一句应当念
   「10 项全部正常」。这一项现在会念：
   「模块与媒体组件正常；五个热键都在且是全局；当前模式…、画质…；存到…」。
   若它念「录屏热键不对」「不是全局作用域」或「画质档不认识」，
   说明配置没迁到位，运行一次安装程序（覆盖安装即可）就会自动修好。

（更早版本的改进照旧有效：录屏四模式与四键位、安装不再乱报运行环境、
 不再乱报钩子没装全、松手后有语音回执、F1 打开快捷键说明、
 网络探测不再白等、阻断警报不再谎报军情。）

========================================

【以下为 2.3.22 版本说明，留档备查】

0. 不再乱报「检测到批量删除操作……小锋在等你决定」
   老版本会把「命令里提到」或者「读到的文件里写着」这类字眼，
   当成真的被安全机制拦下了，于是播报一句提示；
   可屏幕上根本没有要你确认的按钮，用光标怎么也找不到。
   这一版改成：只看「这一步到底成没成功」，
   确实被拦下才出声；提示也改成条件句，并会明确告诉你
   「没弹出提示，就说明是被直接拦下的，这一步需要换个做法」。

0.1 新增音色确认：随时能问「现在用的是哪种语音」
   按 Ctrl 和 F9，会念出当前这一档音色以及为什么用它，例如：
   「现在用的是争渡读屏语音。外网不通，所以没走音质更好的
     在线神经语音。外网恢复后会自动换回去。」
   播报顺序是：外网通 -> 微软自然神经语音（音质最好）；
   网络受限 -> 争渡读屏语音；两者都不行 -> 系统语音慧慧。
   另外，首次换档时会主动补念一句说明（只念一次，不重复吵）。

0.2 网络不通时不再白等
   老版本每次都要先干等一次连接超时（约 8 秒）才知道网络不通，
   听着像「卡了一下」。
   这一版改成后台先探一次，探明之后播报直接走下一档，不再等待。

（上一版 2.3.10 的几处也照旧，可一并留意：安装不再乱报运行环境、
 不再乱报钩子没装全、松手后有语音回执、F1 打开快捷键说明、
 高危命令预警不再乱报。）

========================================
二、安装前请准备
========================================

· 系统：Windows 10 或 11，64 位。
· 内存 8GB 以上更稳妥；包里自带运行环境，不用提前装 Python。
· 整个安装约 5 到 10 分钟，全程语音引导，请插上电源再开始。
· 请把安装包放在一个你记得住的文件夹里，不要放在桌面临时目录。
· 关于工作台（WorkBuddy），最保险的顺序是：
    **先把它整个退出 → 再运行安装 → 装完再打开**。
  原因：语音钩子是写进工作台自己的配置文件的，
  开着装的话，工作台退出时有可能把配置回写回去，把刚装的钩子盖掉。
  开着也能装，只是多一步：装完必须重新打开一次。
  装完程序会按当时的状态告诉你该怎么做，仔细听最后那句。

========================================
三、安装过程中，请留意这几句话
========================================

正常应该听到（按这个顺序）：

    「小锋语音伴侣安装程序，现在开始」—— 介绍系统与要求
    「接下来会弹出协议确认框，同意选「是」」—— 按 Tab 或左右方向键选
    「正在为您准备运行环境」或「已有运行环境，直接复用」—— 两种都正常
    「正在安装语音组件，大约三到五分钟」
    「正在检测麦克风，请保持安静」—— 这时请别说话
    「麦克风检测通过，可以正常录音」
    「安装完成。」后面会接着一句，按你当时的情况二选一：
      · 工作台还开着 —— 「工作台这会儿还开着，请把它整个退出、
        重新打开一次，新装的语音提醒才会全部生效。」
      · 工作台是关着的 —— 「工作台现在是关着的，直接打开就能用，
        全部提醒都是新的。」
      （如果程序没能确认工作台状态，会说「请确认工作台是重新打开的」。）
    再接一句「相关热键功能可查阅热键说明！」

出现下面任何一句，请记下来告诉我们（这是我们要找的问题）：

    「没有找到合适的运行环境，正在安装」
        —— 如果你的电脑上以前装过本软件，就不该听到这句。
    「语音钩子没装全，自动播报和指令优化可能失效」
        —— 装完不该听到这句；听到了请退出工作台重开，还是不行就反馈。
    「Python 版本过低，安装无法继续」
    「部署不完整，以下程序文件没能复制成功」
        —— 多半是杀毒软件拦截，换个目录或关掉杀软重试。

========================================
四、装完之后，请这样自查
========================================

第 1 步：按 Win+R，输入 shell:Startup 回车，
        确认「启动」文件夹里有 XiaofengVoice。

第 2 步：在程序目录里找到「一键体检（check.bat）」，双击运行。
        它会一项一项念给你听，最后一句应当是：

              「检查完毕，语音伴侣跟新版本兼容，9 项全部正常，
                可以继续使用。」

        如果念出「发现 N 个问题」，请把每一条问题的内容告诉我们。
        焦点切换这一项如果报失败，多半是当时窗口没在最前面，
        重跑一次体检再看看，不必紧张。

第 3 步：按住 F8 说一句话。
        松手后应当**先听到一句**「收到指令，现在开始处理！」——
        这是告诉你：话已经收进去了，正在帮你整理说法。
        随后听到 AI 把你说的口语改写成更专业的说法，并念给你听；
        你按回车才真正执行。

第 4 步：按住 F4 说一句话（比如「帮我看看 D 盘有哪些文件夹」）。
        松手后应当听到「收到指令，现在开始处理！」，指令随即被执行。
        三种情况请分辨清楚：
          · 听到「收到指令，现在开始处理！」—— 正常，已发出去执行；
          · 听到「指令已填进输入框，按回车发送」—— 当时焦点不在工作台，
            只填进了输入框，需要你自己按一下回车；
          · 听到「这句话没送进去，请再说一次」—— 这次确实没成功，
            重新按 F4 再说一遍就行（不用担心重复提交，上一句没进去）。

第 5 步：在 WorkBuddy 工作台窗口里，单独按一下 F1（不用按住）。
        应当念「已打开《快捷键说明.txt》」，同时记事本（或你电脑上的
        默认文本程序）会打开这份说明，读屏软件可以直接读。
        如果念的是「没找到《快捷键说明.txt》」，请把你的程序目录
        （完整路径）告诉我们 —— 这一条正是我们想验证的：
        不同电脑、不同盘符、不同用户名，都要能找得准。
        注意：在别的软件窗口里按 F1 是没用的，这是局部热键。

第 6 步：等 AI 做完，应当自动把要点念给你听 —— 不用任何设置。

========================================
五、日常使用中，请帮忙留意
========================================

· 只是查东西的命令（搜索、列文件、看日志、查进程），
  不该听到「磁盘覆写」「风险很高」这类警报。听到了请记下来。

· 真的遇到危险操作时，提示应当是这样说的：
      「注意，接下来要执行某某命令。这一步需要你批准才会执行。
        如果 WorkBuddy 向你确认，按 1 允许，按 2 取消；
        没听到询问，就说明这一步不用你另外批准。
        没听清，按 Ctrl 和 F2 可以再听一遍。」


· 听到警报但屏幕上找不到确认框：先按 Ctrl 和 F2 重听一遍；
  如果确认念的是「按 1 允许、按 2 取消」而屏幕上确实没有框，
  请把当时的情况告诉我们 —— 这正是我们想找出来的问题。

========================================
六、有问题怎么反馈（越具体越好）
========================================

请尽量说清这四件事：

    1. 你听到的是哪一句原话（照着念的写下来最好）；
    2. 当时正在做什么（安装第几步 / 让 AI 执行什么）；
    3. 你的系统版本（Win10 还是 Win11）；
    4. 程序目录里 XiaofengVoice_install_log.txt 的最后几行。

反馈渠道：
    · 大爱先锋学员群（QQ 群）
    · YY 语音 151991 直播频道
    · 电话：0539-2232972
    · 邮箱：277276857@qq.com

========================================
本软件公益免费，可原样转发给有需要的人；禁止商用。
感谢你帮忙测试，你的每一条反馈都会让这个工具更好用。
========================================
