---
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: git-restore
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: null
created_at: '2026-08-27T18:36:00.185271+00:00'
updated_at: '2026-09-23T14:54:06.988033+00:00'
tags:
- 维护
- 本地化
- 持续集成
- VMware
restored_from_commit: 6a6a895eafcca6052e81a14fca103a42635dd1c2
---

# 维护计划 – 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`）。

> 本维护计划依据已标记的证据编写，未引入外部假设。