缺陷报告：SenseVoice 本地模型下载失败 —— Host 未跟随 HTTP 重定向（308 / 302）

[GershonWang]

摘要

在 DeepSeek Harness 桌面版中启用「语音输入」Bundle 并准备 SenseVoice 本地模型时，下载固定失败：

无法下载 model.int8.onnx：下载服务返回 HTTP 308。
下载来源：https://hf-mirror.com

hf-mirror.com 与 huggingface.co 都会把 resolve/<revision>/<file> 重定向到实际 CDN。报错说明 Host 进程收到的就是一个 308 响应，重定向没有被跟随。同一台机器、同一网络下，curl、Node v24.9.0、Node v24.20.0、undici 8.10/8.11 均能正常跟随并下载成功，因此问题定位在 Harness 侧的出站 HTTP 行为。

影响：所有走 HTTP 重定向的模型下载资源都无法通过 Harness 自身的下载通道获取（至少包括 SenseVoice INT8 与 Silero VAD）。用户只能手动放置文件绕过。

---

环境

项	值
产品	DeepSeek Harness 桌面版 0.1.7-rc.2（玲珑包 com.deepseek.dsh-desktop）
Host 启动方式	<prefix>/node/bin/node <prefix>/harness/lib/bin.js web --patch <overlay> --port 34563（见 apps/desktop-launcher/internal/appenv/env.go:55-68）
Host Node	v24.9.0（随包，内置 undici 7.16.0）
harness 自带 undici	8.11.0（harness/node_modules/undici）
系统	Deepin 25
代理	Clash Verge Rev / mihomo v1.19.21；mixed-port: 7897、allow-lan: false、TUN 开启（gvisor、auto-route）
网络命名空间	容器与宿主共享，127.0.0.1:7897 直达，DNS 走 fake-ip（198.18.0.0/15 路由至 TUN）

代理配置本身已确认正常：curl https://www.google.com、git ls-remote https://github.com/git/git、npm registry、node -e "fetch(...)" 全部成功。

---

复现步骤

1. 插件页启用「语音输入」Bundle（组件：dsh-experimental-speech-to-text、-speech-to-text-sensevoice、-api-speech-to-text、-client-ui-voice-input）。
2. 在 Bundle 详情点击「下载并准备」（或失败后点「重试准备」）。
3. 观察结果。

期望：模型下载并校验通过，状态变为「本地语音已就绪」。

实际：准备失败 —— 无法下载 model.int8.onnx：下载服务返回 HTTP 308。下载来源：https://hf-mirror.com

---

证据

1. 服务端行为完全正常

资源固定 URL（来自 packages/experimental/speech-to-text-sensevoice/runtime/assets.json）：

https://huggingface.co/csukuangfj/sherpa-onnx-sense-voice-zh-en-ja-ko-yue-2024-07-17/resolve/2365baeacb507f821a0c8120fcee3d484dba7a07/model.int8.onnx

两个源的重定向链（curl -D -，不跟随 vs curl -L 跟随）：

源	首跳	第二跳	跟随到底
huggingface.co	302 → us.aws.cdn.hf.co	—	200 / 206
hf-mirror.com	308 → huggingface.co 同路径	302 → us.aws.cdn.hf.co	200 / 206

curl -L：num_redirects=2，最终 206（带 Range）。

请求头变体测试（默认 / accept-encoding: gzip, deflate, br / Chrome UA / Range: bytes=0- / Accept: */* / 去掉 UA）全部稳定返回 308 且带 Location，排除了 UA 或请求头导致响应差异的可能。

2. UI 的「下载来源」字段证明重定向未发生

packages/experimental/speech-to-text-sensevoice/src/runtime.ts:114-119：

const response = await fetch(asset.url, { signal })
source = new URL(response.url || asset.url).origin
if (!response.ok || !response.body) {
  await response.body?.cancel()
  throw new SpeechDownloadError({ resource: asset.name, source, reason: 'http', status: response.status })
}

source 取自 response.url。UI 显示 下载来源：https://hf-mirror.com，而报错 reason: 'http'、status: 308 —— 二者结合说明：

• fetch 返回了一个响应（不是抛网络异常）；
• 该响应的 status === 308，且 response.url 仍停留在 hf-mirror.com，即重定向没有发生。

3. 两个源都失败，UI 显示的是最后一个错误

runtime.ts:161-174 按源逐个重试，并且抛出最后一个错误：

const urls = await orderModelSources(asset.url, origins, config.modelProbeTimeoutMs, signal)
for (const [index, url] of urls.entries()) {
  try {
    await downloadAsset({ ...asset, url }, root, signal, ...)
    return
  } catch (error) {
    if (signal.aborted || !(error instanceof SpeechDownloadError) || error.download.reason === 'storage'
      || error.download.reason === 'unknown' || index === urls.length - 1) throw error
  }
}

代理侧日志（mihomo /logs 实时流）在点击「重试准备」窗口内捕获到：

[TCP] 127.0.0.1:<port> --> hf-mirror.com:443    match Match using <节点>
[TCP] 127.0.0.1:<port> --> huggingface.co:443   match Match using <节点>

两个域名都被成功请求——证明网络链路完全通畅；也印证了 HF（302）与 hf-mirror（308）两个源都失败，UI 呈现的是顺序上最后一个（hf-mirror）的错误。

4. 命令行无法复现（关键对照）

同一台机器、同一容器、同一 Clash、同一 URL：

客户端	结果
curl -L	200 / 206，redirected ✅
Node v24.9.0（与 Host 同版本）内置 fetch	status=200、redirected=true、url=us.aws.cdn.hf.co ✅
Node v24.20.0 内置 fetch	同上 ✅
npm undici 8.10.0 / 8.11.0 的 fetch	同上 ✅
先调用 installProxyFromEnvironment() 装好全局 dispatcher，再 fetch	同上 ✅
fetch(url, { redirect: 'manual' }) 对照	status=308、redirected=false、url=hf-mirror.com ← 与产品表现逐字吻合

即：产品表现等价于在 Host 进程内以 redirect: 'manual' 发起了请求。

---

分析

服务端链路正常，客户端链路正常，差异只存在于 Harness 完整进程内。而语音包本身使用裸全局 fetch，未引入任何 fetch 封装或 redirect 覆盖：

• 源码：runtime.ts:114 → await fetch(asset.url, { signal })
• 打包产物核对（dsh-experimental-speech-to-text-sensevoice/lib/index.js:266）与源码一致
• 该包 dependencies 不含 dsh-web-fetch-http 等封装包，无 import ... as fetch 绑定
• 打包 harness 全树搜索 globalThis.fetch =：无命中

因此需要排查在完整 Harness 启动后，globalThis.fetch 的行为为何退化为不跟随重定向。

待验证线索（均已定位到代码，但尚未证实因果）

线索 A —— setGlobalDispatcher 作用的 undici 与 globalThis.fetch 使用的 undici 可能不是同一份。

packages/util/http-proxy/src/install.ts 通过 await import('undici') 动态导入：

const { getGlobalDispatcher, setGlobalDispatcher } = await import('undici')
...
setGlobalDispatcher(agent)

• Host 的 globalThis.fetch 使用 Node 内置 undici 7.16.0；
• 打包 harness 内 import('undici') 解析到 自带 node_modules/undici 8.11.0。

两者是不同的模块实例，其「全局 dispatcher」状态很可能并不共享。若成立，则 installProxyFromEnvironment() 的安装对 globalThis.fetch 无效（这本身也是一个独立缺陷，与本次重定向问题可能相关也可能无关）。建议先确认该假设是否成立。

线索 B —— 是否存在插件在 Host 侧包装 globalThis.fetch。

仓库内已知存在一处替换：packages/experimental/webworker-runtime/src/polyfill/async-context/async-context-hooks.ts:69：

globalThis.fetch = ((input: RequestInfo | URL, init?: RequestInit): Promise<Response> => {
  const snapshot = captureAsyncContext()
  if (snapshot === undefined) return nativeFetch(input, init)
  ...
})

该实现透传 init，理论上不影响 redirect；但需要确认它在 Host 进程中的实际加载范围，以及是否存在其它未纳入搜索的包装点（如打包拼装、动态 import）。

线索 C —— 出站请求策略是否被统一收口。

packages/web/web-fetch-http/lib/index.js:163,197 使用 redirect: "manual"（这是为 web_fetch 工具做 SSRF 防护的主动设计）。需要确认该策略是否通过某个公共出站入口被扩展到其它调用方。

---

建议的最小复现

在 Harness Host 进程内（而非外部 shell）执行：

const u = 'https://hf-mirror.com/csukuangfj/sherpa-onnx-sense-voice-zh-en-ja-ko-yue-2024-07-17/resolve/2365baeacb507f821a0c8120fcee3d484dba7a07/model.int8.onnx'
const r = await fetch(u)
console.log(r.status, r.redirected, r.url)

• 期望：200 true https://us.aws.cdn.hf.co/...
• 若得到：308 false https://hf-mirror.com/... → 复现成功

同时建议打印 globalThis.fetch === (await import('undici')).fetch 与 (await import('undici')).getGlobalDispatcher() === /* Node 内置 dispatcher */ 的对比结果，用于验证线索 A。

---

影响范围

• 所有依赖出站重定向的资源下载都会失败。已确认受影响：SenseVoice model.int8.onnx（239 MB，308）、tokens.txt、silero_vad.onnx（1.8 MB）。
• 未验证但存在同样风险的：model.onnx（FP32，937 MB）等其它走 Hugging Face resolve 路径的资源。
• 不限于代理环境：无论走代理由还是 TUN 直连，只要服务端返回重定向就会触发。

临时绕过（已验证可行）

模型就绪判定只校验文件大小 + sha256（runtime.ts:40-53），手动放置文件即可跳过下载：

目标路径	大小	sha256
~/.dsh/speech-to-text/sensevoice/models/sensevoice-onnx/model.int8.onnx	239233841	c71f0ce00bec95b07744e116345e33d8cbbe08cef896382cf907bf4b51a2cd51
~/.dsh/speech-to-text/sensevoice/models/sensevoice-onnx/tokens.txt	315894	f449eb28dc567533d7fa59be34e2abca8784f771850c78a47fb731a31429a1dc
~/.dsh/speech-to-text/sensevoice/models/silero/silero_vad.onnx	1807522	a35ebf52fd3ce5f1469b2a36158dba761bc47b973ea3382b3186ca15b1f5af28

用 curl -L（能正确跟随重定向）下载即可；放置后点「重试准备」会直接校验通过并显示「本地语音已就绪」。

---

附：本次未改动的说明

排查过程未修改任何 Harness 源码、配置或代理设置；仅新增了上述三个模型缓存文件（约 229 MB）。临时脚本与后台任务均已清理。

[PerryLink]

按设计应当跟随重定向——所以一个 308 漏到用户面前，本身就是缺陷

1. 该模块的 README 把重定向这件事写明了

packages/experimental/speech-to-text-sensevoice/README.md:30（原文）：

Before each missing asset is downloaded, the Host compares the Hugging Face-compatible modelOrigins, which default to https://huggingface.co and HF-Mirror. Concurrent HEAD requests follow the pinned file path and redirects through the Host's fetch proxy; the first 2xx response is tried first. … Network, HTTP, certificate and integrity failures try the remaining sources…

⇒ 也就是说："跟随重定向"是有意设计的一部分，而且是经 Host 的 fetch 代理完成的。你看到的"下载服务返回 HTTP 308"意味着这条代理路径没有把重定向跟下去——不是 hf-mirror.com 行为异常（你已经用 curl / 两个 Node 版本 / 两个 undici 版本证明它们都能跟随）。

2. 你的排除工作正好把这一定位撑住了

你列的"同机同网下 curl、Node v24.9.0、Node v24.20.0、undici 8.10/8.11 全部能跟"是最有说服力的一段——它排除了"网络/代理/目标站点"这一整层，把问题锁在Harness 侧那条出站 HTTP 路径上。建议把这段放在报告最前面。

3. 一个值得你去交叉验证的线索（假设，不是结论）

同期另有一条独立报告（#7468）说 dsh-http-proxy 的 undici v8 dispatcher 破坏了 content-encoding，导致 web_search 拿到原始 brotli 字节。两条的共同点是"Host 自己的出站 HTTP 代理层"。

⇒ 如果你能在报告里加一句"这条下载是否也经同一条代理路径"（以及它和 #7468 是否同因），维护者很可能一次修掉两处。我这边无法确认两者同因，所以请把它写成待验证的关联，而不是定论。

4. 建议补的证据（能让它几分钟内被确认）

1. 失败时那只 HEAD / GET 的完整请求与响应头（尤其 location）——你说日志里有 308，把那一行原文贴出来；
2. 代理开关对照：把 Clash 的 TUN 关掉（或让 dsh 进程不带代理变量）再试一次——如果直连时能下载成功，就说明问题出在"代理路径下不跟随重定向"这个组合上；
3. 你那条"手动放文件可绕过"也保留，它是影响面的证据。

5. 版本提醒

你写的是桌面版 0.1.7-rc.2，就是当前最新（tag dsh-v0.1.7-rc.2，npm next 也是它）⇒ 不用先升级，你的现场就是最新代码。

⚠️ 另外请保持别把核换成 latest（npm 上它仍停在 0.1.5-rc.3，更旧）：

npm i -g @deepseek-ai/dsh@next      # 当前 = 0.1.7-rc.2

6. 一句总结

这不是"HF-Mirror 抽风"，而是设计里承诺了跟随重定向、实际没跟——按缺陷报是对的，而且你已经有把它钉死的全部素材。