chore: 导入旧记忆备份供恢复

2026-09-23 22:38:40 +08:00
parent 5313fcee7a
commit 6a6a895eaf
638 changed files with 29816 additions and 1 deletions
@@ -0,0 +1,72 @@
+---
+title: VMZhCN 常见故障及排查指南
+type: curated
+permalink: main/projects/49564d35-91ae-430d-9d67-7bb8bec4c646/curated/development/vmzh-cn-常见故障及排查指南
+stable_id: f68be77d-5786-49bb-8079-7dad971a5ae7
+scope: project
+project_id: 49564d35-91ae-430d-9d67-7bb8bec4c646
+workspace_type: development
+usage_profile_id: null
+preference_context: development
+document_type: troubleshooting
+revision: 1
+source_memory_ids: []
+source_checkpoint_ids: []
+source_file_ids: []
+source_git_commit: 3e0661c1216b285a039518ba6d810b8394657e1d
+source_git_commits:
+- 3e0661c1216b285a039518ba6d810b8394657e1d
+source_agent_sync_ids: []
+model_connection: Sub2API
+model_name: openai/gpt-oss-120b
+source_count: 24
+source_revisions: {}
+source_dispositions:
+  processed: 24
+  unchanged: 0
+  unsupported: 0
+  skipped: 0
+cited_source_ids: []
+job_cited_source_ids: []
+conflicts: []
+supersedes: []
+preferences: []
+source_cursor: 196
+source_hash: 0a84505c3e53c83a1d2f2e939a42b813a45b865e71febe7c7d488f60c0578b9b
+prompt_version: 2026-08-12.3
+schema_version: '3'
+curation_job_id: c431b17f-7247-44bf-bb35-1eb6862bbace
+created_at: '2026-08-27T18:35:55.011353+00:00'
+updated_at: '2026-08-27T18:35:55.012016+00:00'
+tags:
+- 故障排查
+- 错误码
+- 解决方案
+---
+
+## 错误与解决方案集合
+
+| 场景 | 典型错误信息 | 可能原因 | 推荐处理步骤 |
+|------|--------------|----------|--------------|
+| **文件缺失/锁定** | `msg.cui.vmdberror.fileNotFound` / `msg.cui.vmdberror.vmlocked` | 文件路径错误或被其他进程占用 | 检查路径、确保文件未被占用；必要时重启 VMware 服务（source: `Batch 3/4 – Localization & UI Message Summary`）。 |
+| **权限不足** | `msg.cui.vmdberror.noPermission` / `msg.cui.host.noPermission` | 以非 root 用户执行需要管理员权限的操作 | 使用 `sudo` 重新运行命令；或在 Vaultwarden 中获取已保存的提升凭证（source: `105b328f-4bda-4641-90a7-7282ef156316`）。 |
+| **VM 正在运行时修改磁盘** | `msg.cui.vm.disk.shrink.independentNonpersistent` | 试图在运行状态下压缩或改变磁盘模式 | 先 **停止** 虚拟机，再执行磁盘操作。 |
+| **不受支持的硬件/控制器** | `msg.cui.wizard.vm.busLogicVista` | 选用了不兼容的 SCSI/IDE 控制器 | 在向导中提升硬件版本或更换为受支持的控制器。 |
+| **加密冲突** | `msg.cui.vmCryptoVMDB.decryptionFailedValidation` | 存在快照、TPM、或链接克隆导致加密无法修改 | 删除相关快照或克隆，或先 **导出** 并重新导入为未加密的 VM。 |
+| **网络配置错误** | `msg.netcfg.NAT.PrefixV6BadFormat` / `msg.vmnetcfg.linux.cantRead` | IPv6 前缀格式错误或缺少根权限读取配置文件 | 使用正确的 IPv6 前缀格式；以 root 重新运行 `vmware-netcfg` 并检查 `/etc/vmware/networking`。 |
+| **更新服务器不可达** | `msg.cui.cdsResult.httpHostResolveError` / `msg.cui.cdsResult.proxyAuthenticationError` | DNS 问题或代理认证失败 | 检查网络连接、代理设置，必要时在 UI 中手动输入凭证。 |
+| **VMware Tools 未安装** | `msg.cui.toolsInfoBar.txtNotInstalled` | 客户系统未挂载或未运行 Tools 安装程序 | 在虚拟机内挂载 Tools ISO，手动运行 `VMware-Tools-*.rpm` 或对应的安装脚本。 |
+| **Easy‑Install 失效** | `msg.cui.wizard.vm.easyinstall.fail.scanIso` | 未提供有效的驱动 ISO 路径 | 在向导中手动指定驱动位置或改为手动安装。 |
+| **VNC 端口冲突** | `msg.vnc.portChanged` | 已有用户连接到 VNC 服务器 | 断开当前连接后再修改端口，或重启 VMware 服务。 |
+| **备份恢复错误** | `msg.cui.vmBackendVMDB.overrideLock` | 备份目录已被占用或权限不足 | 确认 `/var/backups/vmzhcn` 存在且可写，必要时手动清理冲突的子目录。 |
+
+### 诊断工具
+- 使用 `vmzhcn.py status` 查看当前字典路径、已安装消息数以及用户 locale（source: `git:vmzhcn.py`）。
+- `vmzhcn.py coverage` 能快速定位仍缺失的 Linux 键，输出为 `missing-linux-en.vmsg`，供翻译人员补全（source: `git:README.md`）。
+- `vmzhcn.py scan` 重新抓取最新二进制中的英文键，以便在新版本发布后生成增量更新（source: `git:README.md`）。
+
+### 参考来源
+- 错误信息与对应解释均摘自 **Batch 3/4 – Localization & UI Message Summary**（source: `Batch 3/4 – Localization & UI Message Summary`）。
+- 工作流与命令实现细节来源于 `vmzhcn.py`（source: `git:vmzhcn.py`）以及单元测试文件 `tests/test_vmzhcn.py`（source: `git:tests/test_vmzhcn.py`）。
+
+**标签**: [故障排查], [错误码], [解决方案]