【已修复并验证】远程用 Web 时文件预览失败（鸿蒙 ArkWeb）：已定位根因并真机验证补丁

[kidding1412]

鸿蒙 ArkWeb（及若干旧内核）下，远程访问 DSH Web 时所有文件预览都报「文件资源服务不可用」；根因是 protocolOf() 依赖 new URL().hostname，而这些内核不把 dsh-resource:// 的 //<type> 当 authority。我已在真机验证修复方法有效，附前后对比图与补丁。

说明：这是社区本地验证的修复方法，不是官方修复。同一服务在桌面 Chrome 上一直正常，所以问题出在客户端内核，与网络 / 认证 / secure context 无关。

现象（同一会话、同一文件：修复前 / 修复后）

修复前：点任何文件链接，右侧预览面板固定显示「文件资源服务不可用」；聊天、工具调用、WebSocket 全部正常。

修复后：同一地址、同一文件，HTML / Markdown / TXT / PNG / DOCX 预览全部恢复。

最小复现

在受影响设备的控制台执行：

new URL("dsh-resource://file/session/demo/readme.md").hostname
// Chrome 156（符合 WHATWG）        → "file"
// ArkWeb 7.0.0.107（Chromium 144） → ""

根因

packages/client/resources/src/client/resources.ts:56-68：

return parsed.hostname === '' ? undefined : parsed.hostname.toLowerCase()

hostname 为空 → 找不到 provider → 资源状态 none → 预览面板渲染 resourceUnavailable。
master 22ddee379240（2026-10-23）仍是这一行；该文件自 2026-09-09 起未改动。

已验证的修复

不依赖引擎的 authority 解析，改为字符串切分：

const match = /^dsh-resource:\/\/([^/?#]+)/i.exec(address)
return match === null ? undefined : match[1].toLowerCase()

• 同一台 Pad、同一浏览器：预览恢复（见上图）
• 仓库既有单测 tests/resources.client.spec.ts:96-105 的 8 条断言，该实现全部通过（本地 Node v24.21.0 实测）
• 更稳的写法是保留 new URL 快路径、仅在 hostname 为空时回退字符串切分（见 [Bug] dsh-client-resources 的 protocolOf 依赖 new URL().hostname，Edge 129 下文件预览显示“文件资源服务不可用” #6437 的补丁），对规范引擎零偏离；本帖所附为最小验证版

环境

• @deepseek-ai/dsh 0.2.1-rc.2（npm 全局，dsh web，经 SSH 转发 / frp 暴露访问）
• 客户端：HarmonyOS 平板 PC 模式，ArkWeb 7.0.0.107 / HuaweiBrowser 6.1.9.321（UA 自称 Chrome/144）
• 对照：同宿主 Chrome 156 正常

关联

• [Bug] dsh-resource:// 地址在华为 ArkWeb 内核上 hostname 为空，导致所有资源预览失效（文件预览显示「文件资源服务不可用。」） #7412（ArkWeb 同款报告）
• [Bug] dsh-client-resources 的 protocolOf 依赖 new URL().hostname，Edge 129 下文件预览显示“文件资源服务不可用” #6437（同根因，含可 git apply 的上游补丁）
• [Bug] Kylin V10 / Chromium 128: three client-side failures (dsh-resource protocol, PDF worker features, session-log download) #10605（另含 PDF worker 问题）

PPTX 预览失败是另一个问题（捆绑 pdf.js 依赖 Map.prototype.getOrInsertComputed），不在本帖范围。