4.0 KiB
4.0 KiB
title, type, permalink, stable_id, scope, project_id, workspace_type, usage_profile_id, preference_context, document_type, revision, source_memory_ids, source_checkpoint_ids, source_file_ids, source_git_commit, source_git_commits, source_agent_sync_ids, model_connection, model_name, source_count, source_revisions, source_dispositions, cited_source_ids, job_cited_source_ids, conflicts, supersedes, preferences, source_cursor, source_hash, prompt_version, schema_version, curation_job_id, created_at, updated_at, tags
| title | type | permalink | stable_id | scope | project_id | workspace_type | usage_profile_id | preference_context | document_type | revision | source_memory_ids | source_checkpoint_ids | source_file_ids | source_git_commit | source_git_commits | source_agent_sync_ids | model_connection | model_name | source_count | source_revisions | source_dispositions | cited_source_ids | job_cited_source_ids | conflicts | supersedes | preferences | source_cursor | source_hash | prompt_version | schema_version | curation_job_id | created_at | updated_at | tags | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| VMZhCN 系统架构与工作流概览 | curated | main/projects/49564d35-91ae-430d-9d67-7bb8bec4c646/curated/development/vmzh-cn-系统架构与工作流概览 | 7370b9b5-c94f-40a2-a98c-5bd36be07b2f | project | 49564d35-91ae-430d-9d67-7bb8bec4c646 | development | null | development | architecture | 1 | 3e0661c1216b285a039518ba6d810b8394657e1d |
|
Sub2API | openai/gpt-oss-120b | 24 |
|
196 | 0a84505c3e53c83a1d2f2e939a42b813a45b865e71febe7c7d488f60c0578b9b | 2026-08-12.3 | 3 | c431b17f-7247-44bf-bb35-1eb6862bbace | 2026-08-27T18:35:52.911964+00:00 | 2026-08-27T18:35:52.912485+00:00 |
|
架构概览
项目核心由 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）。 |
数据流顺序（典型使用场景）
- 初次部署 →
scan→ 生成base-en.vmsg→build（合并本地覆盖） →install（备份+替换） →switch zh_CN（用户层切换）。 - 版本升级 → 再次
scan→build（可能出现新键） →coverage检查缺口 → 翻译缺失键 →install→switch。 - 故障恢复 →
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）。
标签: [架构], [工作流], [实现]