--- title: 已作出关键决策 type: curated permalink: main/projects/49564d35-91ae-430d-9d67-7bb8bec4c646/curated/已作出关键决策 stable_id: f89fd472-41f6-4af1-9290-657982cabbbb scope: project project_id: 49564d35-91ae-430d-9d67-7bb8bec4c646 workspace_type: development usage_profile_id: null preference_context: development document_type: decisions 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: memory:580584b3-22e9-419b-a989-e4fe26081a2b: '1' source_dispositions: processed: 24 unchanged: 0 unsupported: 0 skipped: 0 cited_source_ids: - memory:580584b3-22e9-419b-a989-e4fe26081a2b - global_guidance_memory:1194be51-ee29-47e1-8957-ec2888007db6 - global_guidance_memory:ff34c6eb-6bba-41e5-9e43-ff80941fa823 - global_guidance_document:6973450e-6ecc-48e3-8cdd-4d7d7707d843 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: null created_at: '2026-08-26T19:01:02.310618+00:00' updated_at: '2026-09-23T14:54:13.041859+00:00' tags: - decisions - VMZhCN - development restored_from_commit: 6a6a895eafcca6052e81a14fca103a42635dd1c2 --- # 关键决策记录 | 决策 | 说明 | 参考来源 | |------|------|----------| | **翻译基线** | 以 VMware Workstation Pro 26H1 Linux 二进制为唯一可信来源;Windows 17.6.4 字典仅用于共享可合法使用的翻译片段。 | "memory:f89fd472-41f6-4af1-9290-657982cabbbb" | | **提交信息格式** | Git 提交使用 `type: 中文一句话描述`(如 `feat: 添加用户登录`),保持中文一致性。 | "memory:f89fd472-41f6-4af1-9290-657982cabbbb" | | **开发环境** | 采用 Windows + WSL2 + Docker Desktop,所有脚本和路径需兼容 Windows。 | "memory:f89fd472-41f6-4af1-9290-657982cabbbb" | | **实现原则** | KISS & YAGNI:只实现最简可行方案,避免投机式依赖。 | "memory:bf88c265-4749-4c50-85bc-4bae25298cd5" | | **AI 与 Git 自动化** | 默认禁用 AI 驱动的代码审查与自动 Git 操作,除非显式开启。 | "memory:3f91189b-11a1-45bb-8357-4f413dc1609d" | | **凭据处理** | 所有登录、SSH、API 调用前先在 Vaultwarden 查询;新增或变更的凭据立即写入密码库,仅存储名称、用途、使用场景。 | "memory:105b328f-4bda-4641-90a7-7282ef156316" | | **代码实现细节** | `vmzhcn.py` 的核心工作流包括 `scan`、`build`、`install`、`restore`、`switch`、`coverage`、`status`,并在根权限下执行系统路径修改。 | "memory:git:vmzhcn.py" | | **单元测试规范** | `tests/test_vmzhcn.py` 检查重复键、占位符匹配、语言归一化等,确保字典合并的可靠性。 | "memory:git:tests/test_vmzhcn.py" | | **README 指南** | `README.md` 记录生成、覆盖率报告、备份恢复的完整命令示例。 | "memory:git:data/source/README.md" | > 所有决策均遵循项目级别的 **MemRelay‑only** 工作流(见 `5ed86f53-b53e-4534-8e51-d3a010069d5e`)以及 **全局语言首选**(中文) **标签**:["decisions","VMZhCN","development"]