﻿小锋语音伴侣  安装说明
版本 2.3.25     打包日期 2026 年 10 月 21 日

============================================================
一、这个软件是做什么的
============================================================

它给工作台（WorkBuddy）加一套语音交互：

  · 按住 F4 说话，松开后文字自动填进输入框
  · 工作台每回应一次，自动用语音念一遍回复
  · 需要您确认权限、需要您拍板的时候，语音把问题和选项念出来
  · Ctrl+F4 一键把焦点切回指令输入框
  · 还能念出工作流的进展、自动聚焦选项卡片

特别针对读屏用户设计：不抢读屏的焦点、不打断读屏正在念的内容。

============================================================
二、安装前要准备什么
============================================================

  1. 一台 64 位 Windows 电脑
  2. C 盘至少 600 兆可用空间
  3. 不需要自己装 Python，程序自带了运行环境
  4. 不需要管理员密码，安装全程不会弹出权限窗口

如果您装了争渡读屏，播报会自动使用您惯用的读屏音色，听起来和平时一样。

============================================================
三、怎么安装（一共三步）
============================================================

第一步
  把「小锋语音伴侣_v2.3.25_安装包」这个文件夹整个复制到电脑上。
  直接插着 U 盘打开也可以，但装完之前不要拔 U 盘。

第二步
  在这个文件夹里找到「一键安装.bat」，按回车（或者鼠标双击）。

第三步
  剩下的不用管。接下来会出现一个窗口，同时有语音报告进度。
  全程大约两到三分钟。听到「安装完成」，按一下任意键关闭窗口就行了。

提示：安装过程中如果听到「正在安装运行环境」或者「正在复制语音识别模型」，
      那是在搬大文件，请耐心等，不要关闭窗口。

============================================================
四、装完以后怎么验证
============================================================

  1. 按 Ctrl+F2，应该能听到最近的一条播报。
  2. 按住 F4 对着麦克风说一句话，松开手，
     文字应该出现在工作台的指令输入框里。
  3. 按 F1，会打开快捷键说明。

上面三条都正常，就说明装好了。

============================================================
五、装到哪里去了
============================================================

程序本体：
  C 盘，您的用户目录下面，名字叫 XiaofengVoice

运行环境：
  C 盘，您的用户目录下面，名字叫 .venv-voice

开机自启：
  在「启动」文件夹里放了一个快捷方式，名字是 XiaofengVoice.lnk
  想取消开机自启，把这个快捷方式删掉即可。

安装日志：
  桌面上的「小锋语音伴侣_安装日志.txt」，安装包文件夹里也有一份。

============================================================
六、以后再装新版本
============================================================

直接运行新版本的「一键安装.bat」覆盖安装就行。

您已经改过的设置（配置文件）和历史上的日志、记录都会被保留，
新版本新增的设置项会自动补上。

============================================================
七、遇到问题怎么办
============================================================

  1. 先看桌面上的「小锋语音伴侣_安装日志.txt」，
     里面按时间记录了每一步的结果，最后几行通常就是出错的原因。
  2. 也可以到装好的 XiaofengVoice 文件夹里运行：
       修复重启.bat     重新把语音服务拉起来
       一键体检.bat     检查各项是否正常
  3. 把安装日志发给技术支持，可以快速定位问题。

============================================================
八、常用快捷键
============================================================

  F4          按住说话，松开送进输入框
  F8          按住说话，让工作台把口语改写成专业指令
  Ctrl+F4     把焦点切回指令输入框
  Ctrl+F1     念出当前窗口的内容摘要
  Ctrl+F2     重新念一遍最近的一条播报
  Ctrl+F3     展开工作台的个人中心菜单
  Ctrl+F7     手动触发一次自检
  F1          打开快捷键说明
  Esc         按两下可以停止当前正在执行的任务
