IBus 安装后 ASR 模型加载失败：缺少 funasr_onnx 和 modelscope 依赖

[dempsey-wen]

环境

• Ubuntu 22.04
• IBus 1.5.26
• Python 3.11 (conda)
• 安装方式：IBus 纯语音版

现象

安装完成、重启 IBus 后，按 F9 可以看到"正在录音"提示，但松开后没有文字输入。查看日志 ~/.local/share/vocotype/ibus.log：

[ERROR] app.funasr_server: ASR模型加载失败: No module named 'funasr_onnx'
[ERROR] app.funasr_server: 标点恢复模型加载失败: No module named 'funasr_onnx'

安装 funasr_onnx 后，再次尝试：

[ERROR] app.funasr_server: 下载 ASR ONNX 模型失败: No module named 'modelscope'
[ERROR] app.funasr_server: 下载 标点 ONNX 模型失败: No module named 'modelscope'

根因

funasr_onnx 和 modelscope 是 ASR 推理和模型下载的核心依赖，但不在 requirements.txt 或安装脚本中，首次运行才报错，用户体验很差。

修复建议

在 requirements.txt 或安装脚本中显式添加：

funasr_onnx
modelscope

[LauraGPT]

感谢提供完整日志。我按当前 master、v2.2.3 以及干净的 Python 3.11/3.12 环境复查了一遍，这里其实有两个独立问题。

复查结论

1. funasr_onnx==0.4.1、jieba==0.42.1 和 modelscope==1.30.0 当前都已经写在 requirements.txt 和 pyproject.toml 中；三项依赖从仓库初始提交起就存在。因此这不是简单的“依赖文件漏写 funasr_onnx / modelscope”。
2. 这个现象可以由安装脚本的 [3] 使用系统 Python 分支稳定解释：该分支只检查 numpy、sounddevice、soundfile，不会安装或检查完整 ASR 运行时依赖；随后生成的 IBus launcher 又固定使用安装时选中的 Python。把包安装到另一个 conda/system Python 中，对 IBus 实际进程不会生效。
3. 另外还有一个上游打包缺口：funasr_onnx 0.4.1 的顶层初始化会导入 SenseVoiceSmall，继而导入 torch，但该 wheel 的依赖元数据没有声明 torch（也没有声明 jieba）。所以只手动安装 issue 中提到的两个包，在干净环境里还会继续遇到 jieba 或 torch 缺失。

现有安装的恢复方法

先确认 IBus 实际使用的解释器，再把依赖安装到这个解释器中。请在 VocoType-linux 仓库目录执行：

LAUNCHER="$HOME/.local/libexec/ibus-engine-vocotype"
PYTHON="$(sed -n 's/^PYTHON="\([^"]*\)"/\1/p' "$LAUNCHER")"

printf 'IBus Python: %s\n' "$PYTHON"
"$PYTHON" -c 'import sys; print(sys.executable, sys.version)'

"$PYTHON" -m pip install \
  "funasr_onnx==0.4.1" \
  "jieba==0.42.1" \
  "modelscope==1.30.0"

# funasr_onnx 0.4.1 当前顶层导入 torch；CPU wheel 即可满足这个导入。
"$PYTHON" -m pip install \
  --index-url https://download.pytorch.org/whl/cpu \
  "torch==2.9.1"

然后用同一个解释器做自检：

"$PYTHON" - <<'PY'
from funasr_onnx.paraformer_bin import Paraformer
from funasr_onnx.vad_bin import Fsmn_vad
from funasr_onnx.punc_bin import CT_Transformer
from modelscope.hub.snapshot_download import snapshot_download

print("VoCoType ASR runtime imports OK")
PY

自检通过后执行 ibus restart 再试 F9。如果 PYTHON 为空、路径不存在，或者该解释器因 PEP 668 不允许 pip install，建议重新运行 scripts/install-ibus.sh，选择 [1] 项目虚拟环境 或 [2] 用户级虚拟环境，不要选择 [3]；安装后仍需按上面方式给 launcher 对应环境补一次 CPU torch，直到上游导入问题修复。

我在干净的 Python 3.11.15 和 3.12.3 中都复现了“不装 torch 时 funasr_onnx.paraformer_bin 导入失败”；补充 torch 2.9.1+cpu 后，Paraformer、Fsmn_vad、CT_Transformer 和 snapshot_download 四个 VocoType 实际入口全部导入成功。

仓库侧的长期修复建议是：系统 Python 分支应检查完整运行时入口并打印精确的 "$PYTHON" -m pip ... 命令；同时应和 funasr_onnx 上游处理 eager SenseVoiceSmall 导入。若目标是保持 ONNX 默认安装轻量，长期方案应是延迟/隔离该导入，而不是永久把完整 Torch 设为默认依赖。

[LauraGPT]

上游交付缺口已经重新纳入维护队列：modelscope/FunASR#2604。

当前 main 构建的 wheel 已在干净 Python 3.11/3.12 环境验证：无需安装 Torch，四个 VocoType 使用的 ONNX 入口均可导入且依赖检查通过。现在缺的是新版本号和 PyPI 发布；在新 wheel 发布前，上一条针对 launcher 实际解释器的恢复命令仍然适用。后续有新包时会回到这里请求用 IBus 路径复测。

[LauraGPT]

上游进度更新：funasr-onnx 0.4.2 已进入 FunASR #3242 发布候选，Python 3.11 / 3.12 的无 Torch 构建、安装、pip check 和公开入口导入 CI 均已通过，另有一条真实 SenseVoice ONNX CPU 转写验证通过。

目前 PR 仍是 Draft，且 0.4.2 尚未上传 PyPI，所以现阶段不要把“候选已通过”当作用户安装问题已经消失。合并并发布后，我会从 PyPI 重新下载 wheel，复验后再回到这里确认 VocoType 的依赖路径。

[LauraGPT]

下游安装器修复已提交为 Draft #32。

当前 head f739e82db94f 会在接受“系统 Python”前，用该解释器导入 ModelScope 以及实际使用的 Paraformer、VAD、标点 ONNX 入口；失败时保留原始异常，并打印绑定到同一解释器的恢复命令。这样缺少 funasr_onnx、modelscope、jieba 或当前 0.4.1 间接需要的 torch 都会在安装阶段暴露，不再等到 IBus 首次转写才失败。

验证包括 29 项通过、5 项安装环境跳过，3 项新增回归通过，以及探针成功/失败 CLI、Bash 语法、Python 编译和 diff 检查。

边界不变：#32 修复 VocoType 的安装器漏检；上游 Torch-free funasr_onnx 0.4.2 仍未发布到 PyPI，因此本 issue 还不应关闭。

[LauraGPT]

上游交付阻塞已经解除：funasr-onnx 0.4.2 已正式发布，不再需要为了顶层导入额外安装 Torch。

请用 IBus launcher 实际绑定的解释器升级，而不是另一个 shell/conda Python：

LAUNCHER="$HOME/.local/libexec/ibus-engine-vocotype"
PYTHON="$(sed -n 's/^PYTHON="\([^\"]*\)"/\1/p' "$LAUNCHER")"

"$PYTHON" -m pip install --upgrade \
  "funasr-onnx==0.4.2" \
  "modelscope==1.30.0"

"$PYTHON" - <<'PY'
import importlib.util
from funasr_onnx import Paraformer, Fsmn_vad, CT_Transformer, SenseVoiceSmall
from modelscope.hub.snapshot_download import snapshot_download

assert importlib.util.find_spec("torch") is None
print("VocoType ASR runtime imports OK without Torch")
PY

ibus restart

发布后我已从 PyPI Simple Index 用全新缓存分别在 Python 3.11.15 和 3.12.3 安装：两边 pip check、四个 ONNX 入口导入和真实 SenseVoice CPU 转写均通过，Torch 未安装，jieba 已由包元数据正确拉取。PyPI 上 wheel 的 SHA256 为：

88c3540973d1ee7af929e4451191da72aaabf1ed0473941cb68c3173b397171a

#32 仍负责让“系统 Python”安装路径在安装阶段暴露缺失依赖；本 issue 先保持打开，等待上述 IBus 实际路径复测。

[LeonardNJU]

安装器修复 PR #32 已合并，并已在 master 使用 funasr-onnx==0.4.2。

当前修复包含：

• “系统 Python”路径在写入 IBus launcher 前，实际导入 ModelScope、Paraformer、VAD 和标点 ONNX 入口；
• 探针失败时保留原始异常，并给出绑定到同一解释器的安装命令；
• funasr-onnx 0.4.2 不再为了顶层导入要求 Torch；
• uv.lock 已由维护者补齐后再合并。

PR 分支与合并后的完整测试均通过：31 passed / 5 skipped；随后本轮 master 回归为 39 passed / 5 skipped。

请基于最新 master 重新运行安装脚本，或确认 launcher 绑定的解释器已升级到 funasr-onnx==0.4.2，然后实际测试一次 F9 录音与转写。这个 issue 先保留，收到 IBus 实际路径复测通过后再关闭。

[LeonardNJU]

#32 已合并，funasr-onnx==0.4.2 与同步后的 uv.lock 已进入 master。系统 Python 安装路径现在会在生成 launcher 前验证实际使用的 ModelScope、Paraformer、VAD 和标点入口，不再把缺失依赖延迟到首次 F9 转写时才暴露。

合并后的当前主线完整回归为 46 passed / 5 skipped；干净 Python 3.12 环境也已验证 0.4.2 无需 Torch 即可导入所需入口。该根因已修复，现关闭。若 launcher 绑定解释器在更新后仍报缺包，请附 launcher 中的 PYTHON 路径和日志重新打开。