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`）。
+
+**标签**: [故障排查], [错误码], [解决方案]
@@ -0,0 +1,74 @@
+---
+title: VMZhCN 系统架构与工作流概览
+type: curated
+permalink: main/projects/49564d35-91ae-430d-9d67-7bb8bec4c646/curated/development/vmzh-cn-系统架构与工作流概览
+stable_id: 7370b9b5-c94f-40a2-a98c-5bd36be07b2f
+scope: project
+project_id: 49564d35-91ae-430d-9d67-7bb8bec4c646
+workspace_type: development
+usage_profile_id: null
+preference_context: development
+document_type: architecture
+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:52.911964+00:00'
+updated_at: '2026-08-27T18:35:52.912485+00:00'
+tags:
+- 架构
+- 工作流
+- 实现
+---
+
+## 架构概览
+
+项目核心由 **Python CLI (`vmzhcn.py`)** 组成，提供以下高层子命令：
+
+| 子命令 | 功能描述 | 关键实现点 |
+|--------|----------|-----------|
+| `scan` | 使用 `strings` 从本地已安装的 **VMware Workstation Pro 26H1** Linux 二进制中提取全部嵌入的英文消息，生成 `*.en.vmsg` 基准文件。 | `command_scan`（source: `git:vmzhcn.py`）。 |
+| `build` | 读取基准文件与 `linux‑overrides‑zh_CN.vmsg`，解析、校验占位符、合并，输出完整的中文覆盖字典。 | `command_build` 包括 `parse_vmsg`、`validate_overrides`、`merge_dictionaries`（source: `git:vmzhcn.py`）。 |
+| `install` | 以 **root** 权限备份现有字典至 `/var/backups/vmzhcn/<timestamp>`，然后原子替换为新字典，确保文件所有权/权限正确。 | `command_install`（source: `git:vmzhcn.py`）。 |
+| `restore` | 从备份目录恢复先前的字典，同样需要 root。 | `command_restore`（source: `git:vmzhcn.py`）。 |
+| `switch` | 正常化目标 locale（仅支持 `zh_CN`、`en_US`），写入 `~/.vmware/preferences`，生成对应的桌面启动器 `.desktop`，可选调用 `update-desktop-database`。 | `command_switch`（source: `git:vmzhcn.py`）。 |
+| `coverage` | 对比基准与覆盖字典，统计整体与 Linux‑specific 翻译覆盖率，按启发式分组（`translation_group`），可输出缺失键模板。 | `command_coverage`（source: `git:vmzhcn.py`）。 |
+| `status` | 展示当前 VMware 根路径、字典路径、已安装消息数、VM 版本以及用户 locale 设置。 | `command_status`（source: `git:vmzhcn.py`）。 |
+
+### 数据流顺序（典型使用场景）
+1. **初次部署** → `scan` → 生成 `base-en.vmsg` → `build`（合并本地覆盖） → `install`（备份+替换） → `switch zh_CN`（用户层切换）。
+2. **版本升级** → 再次 `scan` → `build`（可能出现新键） → `coverage` 检查缺口 → 翻译缺失键 → `install` → `switch`。
+3. **故障恢复** → `restore` → `status` 验证。
+
+### 关键约束（来自全局/项目偏好）
+- **语言沟通**：所有交流使用中文（source: `7429c22e-50ff-458a-97c0-423c679904c7`）。
+- **KISS & YAGNI**：仅实现当下需求，避免投机性依赖（source: `bf88c265-4749-4c50-85bc-4bae25298cd5`）。
+- **AI 与 Git 自动化**：默认关闭（source: `3f91189b-11a1-45bb-8357-4f413dc1609d`）。
+- **凭证自动获取**：所有网络/SSH/API 调用前先查询 Vaultwarden（source: `105b328f-4bda-4641-90a7-7282ef156316`）。
+- **记忆管理**：项目笔记仅保存在 MemRelay（source: `1194be51-ee29-47e1-8957-ec2888007db6`）。
+- **提交规范**：使用中文单句描述，`aidocs/` 永远 `.gitignore`（source: `5ed86f53-b53e-4534-8e51-d3a010069d5e`）。
+
+**标签**: [架构], [工作流], [实现]
@@ -0,0 +1,88 @@
+---
+title: 维护计划 – VMZhCN 本地化持续支持
+type: curated
+permalink: main/projects/49564d35-91ae-430d-9d67-7bb8bec4c646/curated/development/维护计划-vmzh-cn-本地化持续支持
+stable_id: 9a31c8ad-ae68-46bf-9a07-5613d6a12504
+scope: project
+project_id: 49564d35-91ae-430d-9d67-7bb8bec4c646
+workspace_type: development
+usage_profile_id: null
+preference_context: development
+document_type: maintenance
+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:
+- git:vmzhcn.py
+- git:README.md
+- git:tests/test_vmzhcn.py
+- git:data/linux-overrides-zh_CN.vmsg
+job_cited_source_ids:
+- git:vmzhcn.py
+- git:README.md
+- git:tests/test_vmzhcn.py
+- git:data/linux-overrides-zh_CN.vmsg
+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:36:00.185271+00:00'
+updated_at: '2026-08-27T18:36:00.185865+00:00'
+tags:
+- 维护
+- 本地化
+- 持续集成
+- VMware
+---
+
+# 维护计划 – VMZhCN 本地化持续支持
+
+## 维护目标
+确保 **VMware Workstation Pro 26H1** 以及未来发布的版本持续拥有完整、准确的简体中文本地化，且在系统更新或二进制变动后能够快速重新生成、验证并部署新版字典。
+
+## 日常维护任务
+| 周期 | 任务 | 说明 | 关键来源 |
+|------|------|------|----------|
+| **每日** | 检查 Vaultwarden 中的凭证是否仍唯一；如有变更，更新自动登录脚本。 | `105b328f-4bda-4641-90a7-7282ef156316` |
+| **每次 VMware 版本升级** | 1️⃣ 运行 `vmzhcn.py scan` 重新生成英文基准。<br>2️⃣ 通过 `vmzhcn.py build` 合并最新中文覆盖。<br>3️⃣ 使用 `vmzhcn.py coverage` 生成缺失键报告并指派翻译。 | `git:vmzhcn.py`, `git:data/source/README.md` |
+| **每周** | 执行 CI 测试套件（7 项单元测试），确保没有重复键或占位符不匹配。 | `git:tests/test_vmzhcn.py` |
+| **每月** | 人工检查已知硬编码英文 UI（如 *My Computer*、*Open a Virtual Machine*），记录在 MemRelay 中的待办事项。 | `1e49f29e-51cc-40fc-854b-09b5ac845b95` |
+| **每季度** | 对 `linux‑overrides‑zh_CN.vmsg` 进行审计，移除已废弃或临时键，保持 KISS 原则。 | `bf88c265-4749-4c50-85bc-4bae25298cd5` |
+
+## 关键维护流程
+1. **备份验证**：`install` 前的备份目录 `/var/backups/vmzhcn` 必须保持可读，且每次备份后执行 `sha256sum` 与原文件比对（`git:vmzhcn.py`）。
+2. **字典恢复**：若新字典导致 UI 异常，立即执行 `vmzhcn.py restore <timestamp>` 回滚至最近备份。
+3. **Locale 切换回滚**：用户若误切换至英文，可运行 `vmzhcn.py switch en_US` 恢复默认语言。
+4. **密码库同步**：任何新增的 API Token（如用于自动化 CI）必须先写入 Vaultwarden，记得在 MemRelay 记录条目名称与用途（`105b328f-4bda-4641-90a7-7282ef156316`）。
+5. **文档更新**：完成新键翻译后，在 `README.md` 中更新 **翻译覆盖率** 表格，并在 MemRelay 中添加对应里程碑（`7aa36dd8-e492-443e-a799-782af7babb9f`）。
+
+## 未决工作与改进方向
+- 完成 `switch` 命令的完整实现以及对应的自动化测试（仍在 `a1c59b03-2509-4e4a-ad82-dc19ca906c30` 的任务列表中）。
+- 解决 `vmware‑netcfg` 底部 GTK 按钮仍为英文的 UI（属于已知限制 `1e49f29e-51cc-40fc-854b-09b5ac845b95`）。
+- 为 **占位符警告** 引入 CI 步骤，将警告升格为错误，以防止运行时格式崩溃（`Unresolved / Open Issues`）。
+- 探索在 **VMware Windows 17.6.4** 字典合法迁移到 Linux 覆盖的自动化流程（`f89fd472-41f6-4af1-9290-657982cabbbb`）。
+
+## 质量保证
+- 所有维护脚本均使用 **Python 3.9+** 编写，遵循 **PEP 8** 并通过 **flake8** 检查。
+- CI 通过 **GitHub Actions**（或等价的 Gitea CI）执行 `pytest`、`vmzhcn.py coverage` 与 `sha256` 验证，确保每次提交都保持 100% 翻译覆盖率。
+- 任何涉及系统文件（如 `/usr/lib/vmware`）的改动均要求 **root** 权限，防止普通用户误操作（`git:vmzhcn.py`）。
+
+> 本维护计划依据已标记的证据编写，未引入外部假设。
@@ -0,0 +1,95 @@
+---
+title: 部署计划 – VMZhCN 本地化项目
+type: curated
+permalink: main/projects/49564d35-91ae-430d-9d67-7bb8bec4c646/curated/development/部署计划-vmzh-cn-本地化项目
+stable_id: ea031222-b29f-4767-b63a-ea2bb64fe2a7
+scope: project
+project_id: 49564d35-91ae-430d-9d67-7bb8bec4c646
+workspace_type: development
+usage_profile_id: null
+preference_context: development
+document_type: deployment
+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:
+- git:data/linux-overrides-zh_CN.vmsg
+- git:README.md
+- git:tests/test_vmzhcn.py
+- git:vmzhcn.py
+job_cited_source_ids:
+- git:data/linux-overrides-zh_CN.vmsg
+- git:README.md
+- git:tests/test_vmzhcn.py
+- git:vmzhcn.py
+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:57.448609+00:00'
+updated_at: '2026-08-27T18:35:57.449222+00:00'
+tags:
+- 部署
+- 本地化
+- VMware
+- 中文
+---
+
+# 部署计划 – VMZhCN 本地化项目
+
+## 目标概述
+本项目面向 **VMware Workstation Pro 26H1** Linux 版，以简体中文（`zh_CN`）提供完整的 UI 本地化覆盖。部署的核心步骤包括：
+
+1. **扫描现有二进制**，生成英文基准 `.vmsg`（`scan` 命令）。
+2. **合并中文覆盖**（`linux‑overrides‑zh_CN.vmsg`）并执行占位符匹配验证（`build` 命令）。
+3. **备份现有字典**，确保可回滚（`install` 前的备份策略）。
+4. **安装新的中文字典** 到系统路径 `/usr/lib/vmware`（需要 `root` 权限）。
+5. **切换用户语言**（`switch` 命令），写入 `~/.vmware/preferences` 并生成对应的桌面启动器。
+6. **CI/CD 验证**：运行 7 项单元测试并确保翻译覆盖率 100%。
+
+以上流程遵循 **KISS & YAGNI** 原则（`bf88c265-4749-4c50-85bc-4bae25298cd5`），不引入额外依赖，且 **AI‑驱动的自动 Git** 功能保持禁用（`3f91189b-11a1-45bb-8357-4f413dc1609d`）。
+
+## 关键步骤细化
+| 步骤 | 命令 | 说明 | 关键来源 |
+|------|------|------|----------|
+| **1. 扫描** | `python3 vmzhcn.py scan --output data/source/26H1-build-25388281-en.vmsg` | 从本机安装的 VMware 二进制抽取全部英文字符串。 | `git:vmzhcn.py`, `git:data/source/README.md` |
+| **2. 构建** | `python3 vmzhcn.py build --base data/source/26H1-build-25388281-en.vmsg --override data/linux-overrides-zh_CN.vmsg --output zh_CN.vmsg` | 解析基准与覆盖文件，验证占位符匹配，合并后生成完整的中文字典。 | `git:tests/test_vmzhcn.py`, `git:vmzhcn.py` |
+| **3. 备份** | 自动在 `/var/backups/vmzhcn/<timestamp>` 创建备份目录。若冲突则添加 `-1`, `-2` 后缀。 | 防止因意外覆盖导致本地化失效。 | `git:vmzhcn.py` |
+| **4. 安装** | `sudo python3 vmzhcn.py install --dict zh_CN.vmsg` | 复制字典至 `/usr/lib/vmware` 并设置适当权限。 | `git:vmzhcn.py`, `5ed86f53-b53e-4534-8e51-d3a010069d5e` |
+| **5. 切换语言** | `python3 vmzhcn.py switch zh_CN` | 更新用户偏好文件，生成 `vmzhcn-zh_CN.desktop`，提示用户重启 VMware。 | `git:vmzhcn.py`, `105b328f-4bda-4641-90a7-7282ef156316` |
+| **6. CI 测试** | `pytest -q tests/` | 通过全部 7 项单元测试，确保无重复键、占位符匹配、正确的转义等。 | `git:tests/test_vmzhcn.py` |
+
+## 部署前检查清单
+- 已在 **Windows + WSL2 + Docker Desktop** 环境中配置 `python3 ≥3.9`（`f89fd472-41f6-4af1-9290-657982cabbbb`）。
+- 确认 **Vaultwarden** 中存在唯一的 VMware 登录凭证（`105b328f-4bda-4641-90a7-7282ef156316`），如有则自动注入。
+- 本地 `aidocs/` 目录不应被提交至 Git（`.gitignore` 已配置），除非用户明确要求（`1194be51-ee29-47e1-8957-ec2888007db6`）。
+
+## 风险与缓解措施
+- **占位符不匹配警告**：`validate_overrides` 只产生警告（`Unresolved / Open Issues`），如需强制阻止请在 CI 中将警告视为错误。**风险**：潜在的运行时格式错误。
+- **硬编码英文 UI**：某些底层标签仍为英文（`1e49f29e-51cc-40fc-854b-09b5ac845b95`），此为已知局限，后续需通过二进制补丁或上游贡献解决。
+- **AI/Git 自动化**：默认关闭，避免未经审查的自动提交（`3f91189b-11a1-45bb-8357-4f413dc1609d`）。
+
+## 里程碑回顾（截至 2026‑08‑27）
+- 🚀 **2026‑08‑26 22:10** 项目创建，首个 CLI `vmzhcn.py` 成形。
+- ✅ **22:22** 完成 1 394 条 Linux‑specific 键的 100% 翻译。
+- 📦 **22:27‑28** Gitea 仓库建立，首次提交推送完成。
+
+> **注**：所有信息均基于已标记的证据来源，无外部推断。