Claude Desktop 0Q0LSP1 错误排查与修复手册

2026-10-13

最后更新：2026年6月2日 | 适用版本：v1.9659.2 → v1.9659.4 当前版本：1.9659.4 | 中文恢复方案已集成

问题现象

Claude Desktop（Windows MSIX 中文版）的项目入口页面和 Artifacts 页面无法访问，显示：

Claude will return soon
Claude is currently experiencing a temporary service disruption.
We're working on it, please check back soon.

错误码：0Q0LSP1

附加问题：MSIX 自动更新到 v1.9659.4 后，UI 变成英文且无法恢复为中文。

问题根因

直接原因

前端 JS 的 luxon 日期库在 zh-CN locale 下调用了 Intl.RelativeTimeFormat.prototype.format('小时')，但当前 Electron/Chromium 版本的 JS 引擎不接受中文字符串 '小时' 作为 unit 参数，抛出 RangeError 导致页面崩溃。

RangeError: Invalid unit argument for Intl.RelativeTimeFormat.prototype.format() '小时'
errorCode: "0Q0LSP1"
url: "/projects"           ← 项目页面崩溃
url: "/cowork-artifact"    ← Artifacts 页面崩溃

触发原因

  1. 应用在 2026年5月30日 进行了版本更新，新版前端 JS（vendor-luxon-D0OkDiyb.js 和 index-C_tZnXTW.js）存在此 bug
  2. 更新时应用创建了旧版文件的备份（.zh-cn-backups 目录）
  3. 此后在排查过程中清除了前端缓存（Code Cache），触发了新版 JS 的完整加载，导致问题暴露

部署模式信息

  • 部署模式：3p（第三方/中文版），通过 Microsoft Store 安装
  • 推理网关：http://127.0.0.1:15721/claude-desktop（本地网关）
  • 模型映射：DeepSeek 模型通过 Gateway 转发到 Claude 模型
  • 注：/api/organizations/.../code/repos 返回 503（custom_3p_not_available）是 3p 模式的服务端正常限制，不影响入口页面功能

解决方法

前提判断：v1.9659.4 中的变化

好消息： v1.9659.4 的 vendor-luxon-D0OkDiyb.js（130176 字节）已经和旧版大小一致，0Q0LSP1 已不再出现，项目/Artifacts 入口页面可以正常打开。但 MSIX 自动更新后 UI 会变回英文。

修复目标： patch index-C_tZnXTW.js 中 locale 判断逻辑 + 安装中文翻译资源包。

方案一：使用 claude-desktop-zh-cn 社区汉化工具（推荐）

使用 GitHub 上的开源汉化补丁 javaht/claude-desktop-zh-cn，它包含了完整的中文翻译资源（约 1 MB）和自动化安装脚本。

# 1. 关闭 Claude Desktop
taskkill /f /im Claude.exe

# 2. 下载汉化工具
# 从 https://github.com/javaht/claude-desktop-zh-cn/releases 下载最新版 ZIP

# 3. 解压后以管理员身份运行 install-windows.bat

# 4. 选择安装模式：
#    1 = Cowork 兼容模式（推荐，不修改 app.asar）
#    2 = 官方账号模式
#    3 = 第三方 API 模式

# 5. 选择语言：1 = 简体中文

# 6. 脚本自动完成资源写入和 locale 注册，重启后生效

如果脚本第 6 步注册语言失败（提示"前端 bundle 格式可能已经变化"），翻译文件实际已写入成功，只需手动补 locale patch：

VERSION=$(ls -d "/c/Program Files/WindowsApps/Claude_"* 2>/dev/null | tail -1)
INDEX="$VERSION/app/resources/ion-dist/assets/v1/index-C_tZnXTW.js"

# locale patch（补完脚本未完成的注册）
sed -i 's/const xF="en-US"/const xF="zh-CN"/' "$INDEX"
sed -i 's/yF=\["en-US"/yF=["zh-CN","en-US"/' "$INDEX"
sed -i 's/L0t={locale:w0t,/L0t={locale:"zh-CN",/' "$INDEX"
sed -i 's/document\.documentElement\.lang=w0t/document.documentElement.lang="zh-CN"/' "$INDEX"
sed -i 's/encodeURIComponent(r)/encodeURIComponent("zh-CN")/g' "$INDEX"

# 清理缓存
rm -rf "$LOCALAPPDATA/Claude-3p/Cache" "$LOCALAPPDATA/Claude-3p/Code Cache"

# 重启 Claude Desktop

方案二：手动 patch + 从社区资源获取中文翻译

如果汉化工具不可用，可以手动放置翻译文件并 patch JS：

第1步：下载或准备中文翻译文件 从 claude-desktop-zh-cn 项目中提取 resources/frontend-zh-CN.json 和 resources/statsig-zh-CN.json，放入对应目录：

# 放置位置
VERSION=$(ls -d "/c/Program Files/WindowsApps/Claude_"* | tail -1)
Copy-Item frontend-zh-CN.json "$VERSION/app/resources/ion-dist/i18n/zh-CN.json"
Copy-Item statsig-zh-CN.json "$VERSION/app/resources/ion-dist/i18n/statsig/zh-CN.json"

第2步：执行 5 处 locale patch

VERSION=$(ls -d "/c/Program Files/WindowsApps/Claude_"* 2>/dev/null | tail -1)
INDEX="$VERSION/app/resources/ion-dist/assets/v1/index-C_tZnXTW.js"

# locale patch
sed -i 's/const xF="en-US"/const xF="zh-CN"/' "$INDEX"
sed -i 's/yF=\["en-US"/yF=["zh-CN","en-US"/' "$INDEX"
sed -i 's/L0t={locale:w0t,/L0t={locale:"zh-CN",/' "$INDEX"
sed -i 's/document\.documentElement\.lang=w0t/document.documentElement.lang="zh-CN"/' "$INDEX"
sed -i 's/encodeURIComponent(r)/encodeURIComponent("zh-CN")/g' "$INDEX"

# 清理缓存
rm -rf "$LOCALAPPDATA/Claude-3p/Cache" "$LOCALAPPDATA/Claude-3p/Code Cache"

patch 作用说明

# Patch 作用
① xF="zh-CN" 不被语言白名单覆盖的 locale fallback 值
② yF=["zh-CN",... 将 zh-CN 加入语言白名单首项
③ L0t={locale:"zh-CN",...} React Intl provider 初始 locale
④ document.documentElement.lang="zh-CN" HTML 根节点语言标记
⑤ encodeURIComponent(r)→"zh-CN" 强制 i18n JSON 请求语言为中文

仅 v1.9659.2 需要额外步骤

如果当前版本是 v1.9659.2（且仍报 0Q0LSP1），需额外恢复旧版 luxon：

VERSION="/c/Program Files/WindowsApps/Claude_1.9659.2.0_x64__pzs8sxrjxfjjc"
BACKUP="$VERSION/app/resources/.zh-cn-backups/20260530-144406/ion-dist"
CURRENT="$VERSION/app/resources/ion-dist"

# 恢复旧版文件（消除 0Q0LSP1 bug）
cp "$BACKUP/assets/v1/vendor-luxon-D0OkDiyb.js" "$CURRENT/assets/v1/vendor-luxon-D0OkDiyb.js"
cp "$BACKUP/assets/v1/index-C_tZnXTW.js" "$CURRENT/assets/v1/index-C_tZnXTW.js"

回溯方法（恢复官方版本）

VERSION=$(ls -d "/c/Program Files/WindowsApps/Claude_"* 2>/dev/null | tail -1)
INDEX="$VERSION/app/resources/ion-dist/assets/v1/index-C_tZnXTW.js"

# 清除前端缓存，应用启动时会从 CDN 重新下载最新版 JS
rm -rf "$LOCALAPPDATA/Claude-3p/Cache"
rm -rf "$LOCALAPPDATA/Claude-3p/Code Cache"
rm -rf "$LOCALAPPDATA/Claude-3p/GPUCache"

# 或者：直接重新安装 Claude Desktop

注意事项

1. MSIX 自动更新后如何快速修复

  • MSIX 自动更新后会清除所有手动修改（locale patch + zh-CN.json 翻译文件）
  • 更新后需要重新执行方案一或方案二的操作
  • 汉化工具脚本和翻译文件建议保存在本地安全位置备用

2. config.json 会被应用覆盖

  • Claude-3p/config.json 的 locale 字段每次启动会被应用重写，无需手动修改
  • JS locale patch 已在前端层面锁定 zh-CN，不受 config.json 影响

3. 汉化工具脚本第6步失败的处理

install-windows.bat 在第 6 步注册中文语言时，如果 index.js 的 yF 数组已经被手动修改过（或版本格式变化），正则匹配失败会报错。此时：

  • 翻译文件（zh-CN.json, statsig/zh-CN.json）实际已写入成功
  • 只需手动执行 5 处 locale patch 即可
  • 详见方案一中的手动补齐指令

4. 数据安全

  • 所有修改仅涉及前端 JS 文件和 i18n 翻译 JSON，不影响用户数据
  • 聊天记录：C:\Users\用户名\.claude\history.jsonl
  • 项目数据：C:\Users\用户名\.claude\projects\
  • 会话记录：C:\Users\用户名\.claude\sessions\
  • 个性化设置：C:\Users\用户名\.claude\settings.json

5. 验证修复

VERSION=$(ls -d "/c/Program Files/WindowsApps/Claude_"* 2>/dev/null | tail -1)
INDEX="$VERSION/app/resources/ion-dist/assets/v1/index-C_tZnXTW.js"

echo "xF=$(grep -o 'const xF="[^"]*"' "$INDEX")"
echo "yF=$(grep -o 'yF=\["[^"]*' "$INDEX")"
echo "L0t=$(grep -c 'L0t={locale:"zh-CN"' "$INDEX")"
echo "docElem=$(grep -c 'documentElement.lang="zh-CN"' "$INDEX")"
echo "encodeURI=$(grep -c 'encodeURIComponent.*zh-CN' "$INDEX")"

echo ""
echo "zh-CN.json: $(wc -c < "$VERSION/app/resources/ion-dist/i18n/zh-CN.json") 字节"
echo "zh-CN.statsig: $(wc -c < "$VERSION/app/resources/ion-dist/i18n/statsig/zh-CN.json" 2>/dev/null || echo '无')"

期望输出： - 各项 patch 均应有输出 - zh-CN.json 约为 950 KB 以上（真实中文翻译包）

6. 错误日志位置

  • 前端 web 日志：%LOCALAPPDATA%/Claude-3p/logs/claude.ai-web.log
  • 主进程日志：%LOCALAPPDATA%/Claude-3p/logs/main.log
  • Cowork VM 日志：%LOCALAPPDATA%/Claude-3p/logs/cowork_vm_node.log
  • Claude Code SDK 日志：%LOCALAPPDATA%/Claude-3p/logs/cowork_host_loop_debug.log
  • 汉化工具日志：%LOCALAPPDATA%/Temp/ClaudeDesktopZhCnInstaller/install-windows.log

← 返回文章列表