﻿业余无线电通联辅助工具 · 轻量版 使用说明（接收方必读）

本版本“不内置 Python 运行环境，也不内置识别模型”，所有内容在首次使用时联网下载。
因此包体很小，但接收方需要自己装一次 Python 和依赖（约 1.x GB，国内走阿里云/清华镜像，速度正常）。

────────────────────────────────────
第一步：安装 Python 3.13（强烈建议装到短路径）
────────────────────────────────────
1. 打开 https://www.python.org/downloads/windows/ 下载 “Windows installer (64-bit)” 的 Python 3.13.x。
   国内也可从镜像下载，例如：
   · 阿里：https://mirrors.aliyun.com/python/  （要下 “Windows installer (64-bit)”，不是 embed 版）
   · 华为云：https://mirrors.huaweicloud.com/python/
   · 清华：https://mirrors.tuna.tsinghua.edu.cn/python/
2. 双击安装，选 “Customize installation”（自定义安装）；后续步骤务必：
   · 勾选 “Add Python to environment variables”（加入 PATH）；
   · 把安装位置改成短路径，例如  C:\Python313  （不要装到默认的长路径！）。
   这样能彻底避免 Windows 260 字符长路径限制（funasr / modelscope / torch 的目录很深，长路径必失败）。
3. 安装完打开“命令提示符”输入  py -3.13 --version  或  python --version  能显示版本号即成功。

提示：如果用的是“微软商店版 Python”，它装在
   C:\Users\你\AppData\Local\Packages\PythonSoftwareFoundation... 这种超长路径下，
   依赖极易因长路径安装失败。建议按上面第 2 步改从 python.org 装到 C:\Python313。
   若坚持用商店版，请管理员命令行执行：
   reg add HKLM\SYSTEM\CurrentControlSet\Control\FileSystem /v LongPathsEnabled /t REG_DWORD /d 1 /f
   然后重开命令行再试。

────────────────────────────────────
第二步：安装依赖（只需一次）
────────────────────────────────────
双击本目录下的「安装依赖.bat」。
脚本会自动：
 · 用阿里云 PyPI 镜像安装全部依赖；
 · torch 由「安装依赖.bat」自动从官方 PyTorch CPU 镜像（download.pytorch.org/whl/cpu）安装，约 200MB，国内可下；若清华镜像更快也可手动换 mirrors.tuna.tsinghua.edu.cn/pytorch-wheels/cpu/；
 · 总计约 1.x GB，按网速几分钟到十几分钟。
若中途报错，脚本会给出具体原因与解决办法，按提示处理后再双击一次即可。

────────────────────────────────────
第三步：运行
────────────────────────────────────
 · 双击「启动桌面版.vbs」或桌面快捷方式：无命令行窗口，直接进原生界面（推荐）。
 · 双击「启动.bat」：弹出命令行窗口并在浏览器打开界面。
首次运行会再从 ModelScope（阿里达摩院）下载 funasr 识别模型（约几百 MB，国内正常），
下载完即可完全离线使用。之后每次启动都不再下载。

────────────────────────────────────
常见问题
────────────────────────────────────
· 提示 “Python 3.13 not found”：说明没装 Python 或没勾 “Add to PATH”，重装并注意勾选。
· 报 “No such file or directory” / 长路径错误：见第一步，装到 C:\Python313 或开启长路径支持。
· 想换更快的识别引擎：config.yaml 里 transcription.engine 可改 faster_whisper；
  但该引擎模型来自 HuggingFace，国内需设 HF_ENDPOINT=https://hf-mirror.com（启动已自动设）。
· 仍想用内置一切、免安装的版本：请找作者要“完整便携版”。
