docs(i18n/zh-CN): Complete full Chinese documentation translation and… (zeroclaw-labs#3429)

* docs(i18n/zh-CN): Complete full Chinese documentation translation and i18n migration

  - Translate 58 core Chinese docs covering all modules (setup, reference, operations, security, hardware,
  contributor guides, etc.)
  - Migrate all .zh-CN.md files to i18n/zh-CN directory preserving original directory structure
  - Update internal links across 3 entry files:
    * Root README.zh-CN.md
    * docs/README.zh-CN.md
    * docs/SUMMARY.zh-CN.md
  - All links point to correct i18n paths with full accessibility
  - Align with Vietnamese i18n directory structure per project conventions

* fix(i18n/zh-CN): resolve all 30 blocking markdown lint errors
- Fix all MD022 blank lines around headings issues across 10 files
- Fix MD036 emphasis used as heading issue in refactor-candidates.md

* docs(i18n/zh-CN): resolve broken document reference link in root README.zh-CN.md

* fix(docs): repair double-quote HTML bug and broken relative links in zh-CN docs

- Remove stray extra `"` after href closing quotes in 6 HTML links in
  root README.zh-CN.md
- Fix relative link depth for files under docs/i18n/zh-CN/ that
  reference repo-root files (CONTRIBUTING.md, README.zh-CN.md,
  .github/workflows/, tests/, docs/SUMMARY.zh-CN.md): use correct
  number of `../` levels based on actual file location in the tree

---------

Co-authored-by: argenis de la rosa <theonlyhennygod@gmail.com>

Author: cnxzq

README.zh-CN.md

@@ -54,26 +54,26 @@
 
 <p align="center">
   <a href="install.sh">一键部署</a> |
-  <a href="docs/setup-guides/README.md">安装入门</a> |
+  <a href="docs/i18n/zh-CN/setup-guides/README.zh-CN.md">安装入门</a> |
   <a href="docs/README.zh-CN.md">文档总览</a> |
-  <a href="docs/SUMMARY.md">文档目录</a>
+  <a href="docs/SUMMARY.zh-CN.md">文档目录</a>
 </p>
 
 <p align="center">
   <strong>场景分流：</strong>
-  <a href="docs/reference/README.md">参考手册</a> ·
-  <a href="docs/ops/README.md">运维部署</a> ·
-  <a href="docs/ops/troubleshooting.md">故障排查</a> ·
-  <a href="docs/security/README.md">安全专题</a> ·
-  <a href="docs/hardware/README.md">硬件外设</a> ·
-  <a href="docs/contributing/README.md">贡献与 CI</a>
+  <a href="docs/i18n/zh-CN/reference/README.zh-CN.md">参考手册</a> ·
+  <a href="docs/i18n/zh-CN/ops/README.zh-CN.md">运维部署</a> ·
+  <a href="docs/i18n/zh-CN/ops/troubleshooting.zh-CN.md">故障排查</a> ·
+  <a href="docs/i18n/zh-CN/security/README.zh-CN.md">安全专题</a> ·
+  <a href="docs/i18n/zh-CN/hardware/README.zh-CN.md">硬件外设</a> ·
+  <a href="docs/i18n/zh-CN/contributing/README.zh-CN.md">贡献与 CI</a>
 </p>
 
 > 本文是对 `README.md` 的人工对齐翻译（强调可读性与准确性，不做逐字直译）。
-> 
+>
 > 技术标识（命令、配置键、API 路径、Trait 名称）保持英文，避免语义漂移。
-> 
-> 最后对齐时间：**2026-02-22**。
+>
+> 最后对齐时间：**2026-03-14**。
 
 ## 📢 公告板
 
@@ -146,7 +146,7 @@ cd zeroclaw
 
 可选环境初始化：`./install.sh --install-system-deps --install-rust`（可能需要 `sudo`）。
 
-详细说明见：[`docs/setup-guides/one-click-bootstrap.md`](docs/setup-guides/one-click-bootstrap.md)。
+详细说明见：[`docs/setup-guides/one-click-bootstrap.md`](docs/i18n/zh-CN/setup-guides/one-click-bootstrap.zh-CN.md)。
 
 ## 快速开始
 
@@ -312,20 +312,20 @@ allow_public_bind = false
 - 文档总览（英文）：[`docs/README.md`](docs/README.md)
 - 统一目录（TOC）：[`docs/SUMMARY.md`](docs/SUMMARY.md)
 - 文档总览（简体中文）：[`docs/README.zh-CN.md`](docs/README.zh-CN.md)
-- 命令参考：[`docs/reference/cli/commands-reference.md`](docs/reference/cli/commands-reference.md)
-- 配置参考：[`docs/reference/api/config-reference.md`](docs/reference/api/config-reference.md)
-- Provider 参考：[`docs/reference/api/providers-reference.md`](docs/reference/api/providers-reference.md)
-- Channel 参考：[`docs/reference/api/channels-reference.md`](docs/reference/api/channels-reference.md)
-- 运维手册：[`docs/ops/operations-runbook.md`](docs/ops/operations-runbook.md)
-- 故障排查：[`docs/ops/troubleshooting.md`](docs/ops/troubleshooting.md)
-- 文档清单与分类：[`docs/maintainers/docs-inventory.md`](docs/maintainers/docs-inventory.md)
-- 项目 triage 快照（2026-02-18）：[`docs/maintainers/project-triage-snapshot-2026-02-18.md`](docs/maintainers/project-triage-snapshot-2026-02-18.md)
+- 命令参考：[`docs/reference/cli/commands-reference.md`](docs/i18n/zh-CN/reference/cli/commands-reference.zh-CN.md)
+- 配置参考：[`docs/reference/api/config-reference.md`](docs/i18n/zh-CN/reference/api/config-reference.zh-CN.md)
+- Provider 参考：[`docs/reference/api/providers-reference.md`](docs/i18n/zh-CN/reference/api/providers-reference.zh-CN.md)
+- Channel 参考：[`docs/reference/api/channels-reference.md`](docs/i18n/zh-CN/reference/api/channels-reference.zh-CN.md)
+- 运维手册：[`docs/ops/operations-runbook.md`](docs/i18n/zh-CN/ops/operations-runbook.zh-CN.md)
+- 故障排查：[`docs/ops/troubleshooting.md`](docs/i18n/zh-CN/ops/troubleshooting.zh-CN.md)
+- 文档清单与分类：[`docs/maintainers/docs-inventory.md`](docs/i18n/zh-CN/maintainers/docs-inventory.zh-CN.md)
+- 项目 triage 快照（2026-02-18）：[`docs/maintainers/project-triage-snapshot-2026-02-18.md`](docs/i18n/zh-CN/maintainers/project-triage-snapshot-2026-02-18.zh-CN.md)
 
 ## 贡献与许可证
 
 - 贡献指南：[`CONTRIBUTING.md`](CONTRIBUTING.md)
-- PR 工作流：[`docs/contributing/pr-workflow.md`](docs/contributing/pr-workflow.md)
-- Reviewer 指南：[`docs/contributing/reviewer-playbook.md`](docs/contributing/reviewer-playbook.md)
+- PR 工作流：[`docs/contributing/pr-workflow.md`](docs/i18n/zh-CN/contributing/pr-workflow.zh-CN.md)
+- Reviewer 指南：[`docs/contributing/reviewer-playbook.md`](docs/i18n/zh-CN/contributing/reviewer-playbook.zh-CN.md)
 - 许可证：MIT 或 Apache 2.0（见 [`LICENSE-MIT`](LICENSE-MIT)、[`LICENSE-APACHE`](LICENSE-APACHE) 与 [`NOTICE`](NOTICE)）
 
 ---

docs/README.zh-CN.md

@@ -2,7 +2,7 @@
 
 这是文档系统的中文入口页。
 
-最后对齐：**2026-02-18**。
+最后对齐：**2026-03-14**。
 
 > 说明：命令、配置键、API 路径保持英文；实现细节以英文文档为准。
 
@@ -11,77 +11,83 @@
 | 我想要… | 建议阅读 |
 |---|---|
 | 快速安装并运行 | [../README.zh-CN.md](../README.zh-CN.md) / [../README.md](../README.md) |
-| 一键安装与初始化 | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md) |
-| 按任务找命令 | [commands-reference.md](reference/cli/commands-reference.md) |
-| 快速查看配置默认值与关键项 | [config-reference.md](reference/api/config-reference.md) |
-| 接入自定义 Provider / endpoint | [custom-providers.md](contributing/custom-providers.md) |
-| 配置 Z.AI / GLM Provider | [zai-glm-setup.md](setup-guides/zai-glm-setup.md) |
-| 使用 LangGraph 工具调用集成 | [langgraph-integration.md](contributing/langgraph-integration.md) |
-| 进行日常运维（runbook） | [operations-runbook.md](ops/operations-runbook.md) |
-| 快速排查安装/运行问题 | [troubleshooting.md](ops/troubleshooting.md) |
+| macOS 平台更新与卸载 | [macos-update-uninstall.md](i18n/zh-CN/setup-guides/macos-update-uninstall.zh-CN.md) |
+| 一键安装与初始化 | [one-click-bootstrap.md](i18n/zh-CN/setup-guides/one-click-bootstrap.zh-CN.md) |
+| 按任务找命令 | [commands-reference.md](i18n/zh-CN/reference/cli/commands-reference.zh-CN.md) |
+| 快速查看配置默认值与关键项 | [config-reference.md](i18n/zh-CN/reference/api/config-reference.zh-CN.md) |
+| 接入自定义 Provider / endpoint | [custom-providers.md](i18n/zh-CN/contributing/custom-providers.zh-CN.md) |
+| 配置 Z.AI / GLM Provider | [zai-glm-setup.md](i18n/zh-CN/setup-guides/zai-glm-setup.zh-CN.md) |
+| 使用 LangGraph 工具调用集成 | [langgraph-integration.md](i18n/zh-CN/contributing/langgraph-integration.zh-CN.md) |
+| 进行日常运维（runbook） | [operations-runbook.md](i18n/zh-CN/ops/operations-runbook.zh-CN.md) |
+| 快速排查安装/运行/通道问题 | [troubleshooting.md](i18n/zh-CN/ops/troubleshooting.zh-CN.md) |
+| Matrix 加密房间配置与诊断 | [matrix-e2ee-guide.md](i18n/zh-CN/security/matrix-e2ee-guide.zh-CN.md) |
 | 统一目录导航 | [SUMMARY.md](SUMMARY.md) |
-| 查看 PR/Issue 扫描快照 | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) |
+| 查看 PR/Issue 扫描快照 | [project-triage-snapshot-2026-02-18.md](i18n/zh-CN/maintainers/project-triage-snapshot-2026-02-18.zh-CN.md) |
 
 ## 10 秒决策树（先看这个）
 
-- 首次安装或快速启动 → [setup-guides/README.md](setup-guides/README.md)
-- 需要精确命令或配置键 → [reference/README.md](reference/README.md)
-- 需要部署与服务化运维 → [ops/README.md](ops/README.md)
-- 遇到报错、异常或回归 → [troubleshooting.md](ops/troubleshooting.md)
-- 查看安全现状与路线图 → [security/README.md](security/README.md)
-- 接入板卡与外设 → [hardware/README.md](hardware/README.md)
-- 参与贡献、评审与 CI → [contributing/README.md](contributing/README.md)
+- 首次安装或快速启动 → [setup-guides/README.md](i18n/zh-CN/setup-guides/README.zh-CN.md)
+- 需要精确命令或配置键 → [reference/README.md](i18n/zh-CN/reference/README.zh-CN.md)
+- 需要部署与服务化运维 → [ops/README.md](i18n/zh-CN/ops/README.zh-CN.md)
+- 遇到报错、异常或回归 → [troubleshooting.md](i18n/zh-CN/ops/troubleshooting.zh-CN.md)
+- 查看安全现状与路线图 → [security/README.md](i18n/zh-CN/security/README.zh-CN.md)
+- 接入板卡与外设 → [hardware/README.md](i18n/zh-CN/hardware/README.zh-CN.md)
+- 参与贡献、评审与 CI → [contributing/README.md](i18n/zh-CN/contributing/README.zh-CN.md)
 - 查看完整文档地图 → [SUMMARY.md](SUMMARY.md)
 
 ## 按目录浏览（推荐）
 
-- 入门文档： [setup-guides/README.md](setup-guides/README.md)
-- 参考手册： [reference/README.md](reference/README.md)
-- 运维与部署： [ops/README.md](ops/README.md)
-- 安全文档： [security/README.md](security/README.md)
-- 硬件与外设： [hardware/README.md](hardware/README.md)
-- 贡献与 CI： [contributing/README.md](contributing/README.md)
-- 项目快照： [maintainers/README.md](maintainers/README.md)
+- 入门文档： [setup-guides/README.md](i18n/zh-CN/setup-guides/README.zh-CN.md)
+- 参考手册： [reference/README.md](i18n/zh-CN/reference/README.zh-CN.md)
+- 运维与部署： [ops/README.md](i18n/zh-CN/ops/README.zh-CN.md)
+- 安全文档： [security/README.md](i18n/zh-CN/security/README.zh-CN.md)
+- 硬件与外设： [hardware/README.md](i18n/zh-CN/hardware/README.zh-CN.md)
+- 贡献与 CI： [contributing/README.md](i18n/zh-CN/contributing/README.zh-CN.md)
+- 项目快照： [maintainers/README.md](i18n/zh-CN/maintainers/README.zh-CN.md)
 
 ## 按角色
 
 ### 用户 / 运维
 
-- [commands-reference.md](reference/cli/commands-reference.md)
-- [providers-reference.md](reference/api/providers-reference.md)
-- [channels-reference.md](reference/api/channels-reference.md)
-- [config-reference.md](reference/api/config-reference.md)
-- [custom-providers.md](contributing/custom-providers.md)
-- [zai-glm-setup.md](setup-guides/zai-glm-setup.md)
-- [langgraph-integration.md](contributing/langgraph-integration.md)
-- [operations-runbook.md](ops/operations-runbook.md)
-- [troubleshooting.md](ops/troubleshooting.md)
+- [commands-reference.md](i18n/zh-CN/reference/cli/commands-reference.zh-CN.md) — 按工作流查询命令
+- [providers-reference.md](i18n/zh-CN/reference/api/providers-reference.zh-CN.md) — Provider ID、别名、凭证环境变量
+- [channels-reference.md](i18n/zh-CN/reference/api/channels-reference.zh-CN.md) — 通道功能与配置路径
+- [matrix-e2ee-guide.md](i18n/zh-CN/security/matrix-e2ee-guide.zh-CN.md) — Matrix 加密房间（E2EE）配置与无响应诊断
+- [config-reference.md](i18n/zh-CN/reference/api/config-reference.zh-CN.md) — 高优先级配置项与安全默认值
+- [custom-providers.md](i18n/zh-CN/contributing/custom-providers.zh-CN.md) — 自定义 Provider/基础 URL 集成模板
+- [zai-glm-setup.md](i18n/zh-CN/setup-guides/zai-glm-setup.zh-CN.md) — Z.AI/GLM 配置与端点矩阵
+- [langgraph-integration.md](i18n/zh-CN/contributing/langgraph-integration.zh-CN.md) — 模型/工具调用边缘场景的降级集成方案
+- [operations-runbook.md](i18n/zh-CN/ops/operations-runbook.zh-CN.md) — 日常运行时运维与回滚流程
+- [troubleshooting.md](i18n/zh-CN/ops/troubleshooting.zh-CN.md) — 常见故障特征与恢复步骤
 
 ### 贡献者 / 维护者
 
 - [../CONTRIBUTING.md](../CONTRIBUTING.md)
-- [pr-workflow.md](contributing/pr-workflow.md)
-- [reviewer-playbook.md](contributing/reviewer-playbook.md)
-- [ci-map.md](contributing/ci-map.md)
-- [actions-source-policy.md](contributing/actions-source-policy.md)
+- [pr-workflow.md](i18n/zh-CN/contributing/pr-workflow.zh-CN.md)
+- [reviewer-playbook.md](i18n/zh-CN/contributing/reviewer-playbook.zh-CN.md)
+- [ci-map.md](i18n/zh-CN/contributing/ci-map.zh-CN.md)
+- [actions-source-policy.md](i18n/zh-CN/contributing/actions-source-policy.zh-CN.md)
 
 ### 安全 / 稳定性
 
-> 说明：本分组内有 proposal/roadmap 文档，可能包含设想中的命令或配置。当前可执行行为请优先阅读 [config-reference.md](reference/api/config-reference.md)、[operations-runbook.md](ops/operations-runbook.md)、[troubleshooting.md](ops/troubleshooting.md)。
+> 说明：本分组内有 proposal/roadmap 文档，可能包含设想中的命令或配置。当前可执行行为请优先阅读 [config-reference.md](i18n/zh-CN/reference/api/config-reference.md)、[operations-runbook.md](i18n/zh-CN/ops/operations-runbook.md)、[troubleshooting.md](i18n/zh-CN/ops/troubleshooting.zh-CN.md)。
 
-- [security/README.md](security/README.md)
-- [agnostic-security.md](security/agnostic-security.md)
-- [frictionless-security.md](security/frictionless-security.md)
-- [sandboxing.md](security/sandboxing.md)
-- [resource-limits.md](ops/resource-limits.md)
-- [audit-logging.md](security/audit-logging.md)
-- [security-roadmap.md](security/security-roadmap.md)
+- [security/README.md](i18n/zh-CN/security/README.zh-CN.md)
+- [agnostic-security.md](i18n/zh-CN/security/agnostic-security.zh-CN.md)
+- [frictionless-security.md](i18n/zh-CN/security/frictionless-security.zh-CN.md)
+- [sandboxing.md](i18n/zh-CN/security/sandboxing.zh-CN.md)
+- [resource-limits.md](i18n/zh-CN/ops/resource-limits.zh-CN.md)
+- [audit-logging.md](i18n/zh-CN/security/audit-logging.zh-CN.md)
+- [security-roadmap.md](i18n/zh-CN/security/security-roadmap.zh-CN.md)
 
 ## 文档治理与分类
 
 - 统一目录（TOC）：[SUMMARY.md](SUMMARY.md)
-- 文档结构图（按语言/分区/功能）：[structure/README.md](maintainers/structure-README.md)
-- 文档清单与分类：[docs-inventory.md](maintainers/docs-inventory.md)
+- 文档结构图（按语言/分区/功能）：[structure/README.md](i18n/zh-CN/maintainers/structure-README.zh-CN.md)
+- 文档清单与分类：[docs-inventory.md](i18n/zh-CN/maintainers/docs-inventory.zh-CN.md)
+- 国际化文档索引：[i18n/README.md](i18n/README.md)
+- 国际化覆盖度地图：[i18n-coverage.md](i18n/zh-CN/maintainers/i18n-coverage.zh-CN.md)
+- 项目分诊快照：[project-triage-snapshot-2026-02-18.md](i18n/zh-CN/maintainers/project-triage-snapshot-2026-02-18.zh-CN.md)
 
 ## 其他语言