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

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

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

1. 安装时不再乱报「找不到运行环境」
   老版本常会念一句「没有找到合适的运行环境，正在安装」，
   然后白白装一遍 Python，多等一分钟。
   这一版改成：已经有合格运行环境的，直接复用，不再重装。

2. 安装完不再乱报「语音钩子没装全」
   老版本装好了也会念「语音钩子没装全，自动播报可能失效」，
   害得大家以为装失败了，反复重启、反复重装。
   这一版改成：真没装全才说；装好了就念「语音钩子已就位」。

3. 松开录音键后有一句「收到指令，现在开始处理！」
   以前说完话松手，要等一会儿才有动静，不知道话收进去没有，容易着急。
   这一版：F4、F8 松手后会先念一句回执，告诉你话已经收到了。

4. 按 F1 就能打开快捷键说明
   以前要看按键说明，得自己去文件夹里翻《快捷键说明.txt》。
   这一版：在工作台里直接按 F1，说明文档就打开了，读屏软件可以直接读。
   找不到文件时会念一句「没找到《快捷键说明.txt》」。

5. 高危命令预警不再乱报
   老版本把「2>/dev/null」这种丢弃报错的普通写法
   误当成「磁盘覆写」，于是查个进程、看个日志也会报警告说
   「风险很高，系统会弹出确认框」，可屏幕上根本没有框。
   这一版改成：
     · 只认真正的危险操作（格式化、写裸盘、rm -rf、强制推送等）；
     · 不再打包票说「会弹确认框」，改成「如果需要你批准，按 1 允许、按 2 取消」；
     · 没听清可以按 Ctrl 和 F2 再听一遍。

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

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

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

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

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

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

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

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

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

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

              「体检完成，一切正常。」

        如果念出「发现 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

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