全平台适配的技术解决方案
CapsWriter-Offline 在跨平台场景下的适配方案如下:
Windows system
- 确保系统版本为Win10 1809或更新,旧系统需安装 Universal C Runtime 更新
- 32位系统只能运行客户端,需通过修改 client_config.json 的 server_address 连接局域网内64位设备提供的服务
macOS
- 通过Homebrew安装依赖:brew install protobuf && brew install portaudio
- 权限问题解决方案:在系统偏好设置→安全性与隐私中开启麦克风和辅助功能权限
- 快捷键冲突处理:修改 config.py 将 shortcut 改为 F13 等非常用键
Linux系统
- 基础依赖:sudo apt-get install python3-pyaudio xclip
- 声卡配置:检查 /etc/asound.conf 确保默认录音设备正确
- 无GUI环境:通过 ssh -X 启用X11转发支持剪贴板功能
通用解决方案:对于ARM架构设备(如M1 Mac),建议使用Docker容器部署(项目提供 Dockerfile),或等待社区编译的ARM专用版本。
This answer comes from the articleCapsWriter-Offline: Speech Input and Subtitle Transcription Tool for the PCThe