89 lines
4.6 KiB
Markdown
89 lines
4.6 KiB
Markdown
---
|
||
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`）。
|
||
|
||
> 本维护计划依据已标记的证据编写，未引入外部假设。 |