docs: make Chinese README the default

README.md

@@ -1,3 +1,9 @@
+<!-- WEHUB_ZH_README -->
+> [!NOTE]
+> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。  
+> [English](./README.en.md) · [原始项目](https://github.com/Yuan-lab-LLM/ClawManager) · [上游 README](https://github.com/Yuan-lab-LLM/ClawManager/blob/HEAD/README.md)  
+> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
+
 # ClawManager
 
 <p align="center">
@@ -5,15 +11,15 @@
 </p>
 
 <p align="center">
-  A Kubernetes-native control plane for AI agent instance management, with governed AI access, runtime orchestration, and reusable resources across multiple agent runtimes.
+  一个面向 AI Agent 实例管理的 Kubernetes 原生控制平面，提供受治理的 AI 访问、运行时编排，以及适用于多种 Agent Runtime 的可复用资源管理能力。
 </p>
 
 <p align="center">
-  <strong>Languages:</strong>
-  English |
-  <a href="./README.zh-CN.md">Chinese</a> |
-  <a href="./README.ja.md">Japanese</a> |
-  <a href="./README.ko.md">Korean</a> |
+  <strong>语言:</strong>
+  <a href="./README.md">English</a> |
+  简体中文 |
+  <a href="./README.ja.md">日本語</a> |
+  <a href="./README.ko.md">한국어</a> |
   <a href="./README.de.md">Deutsch</a>
 </p>
 
@@ -24,18 +30,18 @@
   <img src="https://img.shields.io/badge/Kubernetes-Native-326CE5?style=for-the-badge&logo=kubernetes&logoColor=white" alt="Kubernetes Native" />
   <img src="https://img.shields.io/badge/License-MIT-2ea44f?style=for-the-badge" alt="MIT License" />
   <a href="https://discord.gg/9RwgbGJD5R">
-    <img src="https://img.shields.io/badge/Discord-Join%20Us-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Join ClawManager on Discord" />
+    <img src="https://img.shields.io/badge/Discord-Join%20Us-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="加入 ClawManager Discord 社区" />
   </a>
 </p>
 
 <p align="center">
-  <a href="#product-tour">Explore the Product</a> |
-  <a href="#team-workspaces">Team Workspaces</a> |
+  <a href="#product-tour">了解产品</a> |
+  <a href="#team-workspaces">Team 协作</a> |
   <a href="#ai-gateway">AI Gateway</a> |
   <a href="#agent-control-plane">Agent Control Plane</a> |
-  <a href="#runtime-integrations">Runtime Integrations</a> |
-  <a href="#resource-management">Resource Management</a> |
-  <a href="#get-started">Get Started</a>
+  <a href="#runtime-integrations">Runtime 接入</a> |
+  <a href="#resource-management">资源管理</a> |
+  <a href="#get-started">快速开始</a>
 </p>
 
 <p align="center">
@@ -44,29 +50,29 @@
   </a>
 </p>
 
-<h2 align="center">See ClawManager in 60 Seconds</h2>
+<h2 align="center">60 秒认识 ClawManager</h2>
 
 <p align="center">
-<img src="https://raw.githubusercontent.com/Yuan-lab-LLM/ClawManager-Assets/main/gif/clawmanager-launch-60s-hd.gif" alt="ClawManager product launch demo" width="100%" />
+<img src="https://raw.githubusercontent.com/Yuan-lab-LLM/ClawManager-Assets/main/gif/clawmanager-launch-60s-hd.gif" alt="ClawManager 产品演示" width="100%" />
 </p>
 
 <p align="center">
-  A quick look at fast agent provisioning, skill management and scanning, and AI Gateway governance.
+  快速了解 Agent 实例创建、Skill 管理与扫描，以及 AI Gateway 治理能力。
 </p>
 
-## What's New
+## 最新动态
 
-Recent highlights from the latest product and documentation updates.
+这里展示最近的重要产品与文档更新。
 
-- [2026-07-07] Added the Security Protection Platform (secplane) frontend — a comprehensive security console covering runtime defense (input/state/decision/output surface, asset tamper-proofing, human approval), host hardening & container isolation, outbound trusted-endpoint governance, policy governance, kill-switch/circuit-breaker, full-chain audit, SecureClaw data-and-component trust auditing, collaboration governance, and input detection. All 4 defense layers are accessible from a unified admin UI with full i18n for 5 languages.
-- [2026-06-14] Added Lite / Pro runtime modes and rollout support, so Lite instances can run through shared gateway runtime pools while Pro instances keep dedicated desktop deployments for stronger isolation.
-- [2026-05-18] Added the Team workspace MVP introduction and preview, covering one-click Team creation, OpenClaw member orchestration, Redis Team Bus injection, shared storage, member status, task dispatch, and event/result views.
-- [2026-04-29] Added Hermes runtime integration support, including Webtop-based instance provisioning, Agent Control Plane registration, AI Gateway injection, channel and skill bootstrap, and `.hermes` import/export workflows. See the [Hermes Runtime Guide](./docs/hermes-runtime-agent-development.md).
-- [2026-04-08] Added skill management and skill scanning workflows to the platform, via [Merged PR #52](https://github.com/Yuan-lab-LLM/ClawManager/pull/52).
-- [2026-03-26] AI Gateway documentation was refreshed with stronger coverage for model governance, audit and trace, cost accounting, and risk control. See the [AI Gateway Guide](./docs/aigateway.md).
-- [2026-03-20] ClawManager evolved into a broader control plane for AI agent workspaces, with stronger runtime control, reusable resources, and security scanning workflows.
+- [2026-07-07] 新增安全防护平台（secplane）前端控制台——覆盖运行时防御（输入面/状态面/决策面/输出面、资产防篡改、人因审批）、主机加固与容器隔离、出站可信端点治理、策略治理、应急熔断、全链路审计、SecureClaw 数据与组件可信审计、协同接入治理及输入检测，4 层防护统一管理界面，5 语言 i18n 完整支持。
+- [2026-06-14] 新增 Lite / Pro 运行时模式与滚动升级支持，Lite 实例可通过共享 gateway 运行时池运行，Pro 实例保留专属 desktop deployment 以获得更强隔离。
+- [2026-05-18] 新增 Team 工作空间 MVP 介绍与界面预览，覆盖一键创建 Team、OpenClaw 成员编排、Redis Team Bus 配置注入、共享存储、成员状态、任务派发，以及事件和结果查看。
+- [2026-04-29] 新增 Hermes Runtime 接入支持，覆盖基于 Webtop 的实例创建、Agent Control Plane 注册、AI Gateway 注入、channel 与 skill 引导注入，以及 `.hermes` 导入导出流程。见 [Hermes Runtime Guide](./docs/hermes-runtime-agent-development.md)。
+- [2026-04-08] 平台新增了 Skill 管理与 Skill 扫描工作流，见 [Merged PR #52](https://github.com/Yuan-lab-LLM/ClawManager/pull/52)。
+- [2026-03-26] AI Gateway 文档已更新，补充了模型治理、审计追踪、成本核算与风险控制能力，见 [AI Gateway Guide](./docs/aigateway.md)。
+- [2026-03-20] ClawManager 进一步演进为面向 AI Agent 工作空间的控制平面，强化了运行时控制、可复用资源与安全扫描工作流。
 
-> If ClawManager is useful to your team, please star the project to help more users and contributors discover it.
+> 如果 ClawManager 对你的团队有帮助，欢迎为项目点一个 Star，帮助更多用户和开发者发现它。
 
 <p align="center">
   <a href="https://github.com/Yuan-lab-LLM/ClawManager/stargazers">
@@ -74,61 +80,61 @@ Recent highlights from the latest product and documentation updates.
   </a>
 </p>
 
+## 社区交流
 
-## Community
-
-Join the ClawManager open source community on WeChat or Discord for product updates, usage discussion, and contributor collaboration.
+欢迎加入 ClawManager 开源社区，可通过微信群或 Discord 获取产品更新、交流使用经验，并与贡献者一起讨论共建。
 
 <table align="center">
   <tr>
     <td align="center" width="320" valign="top">
-      <img src="./docs/main/clawmanager_group_chat.jpg" alt="ClawManager WeChat group QR code" height="300" />
+      <img src="./docs/main/clawmanager_group_chat.jpg" alt="ClawManager 微信群二维码" height="300" />
       <br /><br />
-      <strong>WeChat</strong>
+      <strong>微信群</strong>
       <br />
-      Scan to join the WeChat community group
+      扫描二维码加入微信群
     </td>
     <td align="center" width="320" valign="top">
-      <img src="./docs/main/clawmanager_discord.jpg" alt="ClawManager Discord invite QR code" height="300" />
+      <img src="./docs/main/clawmanager_discord.jpg" alt="ClawManager Discord 邀请二维码" height="300" />
       <br /><br />
       <strong>Discord</strong>
       <br />
-      <a href="https://discord.gg/9RwgbGJD5R">Scan to join our Discord server</a>
+      <a href="https://discord.gg/9RwgbGJD5R">扫描二维码加入 Discord 服务器</a>
     </td>
   </tr>
 </table>
 
-## Product Tour
+<a id="product-tour"></a>
+## 产品介绍
 
-ClawManager brings AI agent instance operations to Kubernetes and layers three higher-level control planes on top of that runtime foundation. Teams use it to govern AI access, orchestrate runtime behavior through agents, and manage reusable channels and skills with scanning and bundle-based delivery.
+ClawManager 将 AI Agent 实例的运行、治理与运维能力带到 Kubernetes，并在运行时基础之上叠加三层更高阶的控制平面。团队可以用它治理 AI 访问、通过 Agent 编排运行时行为，并通过可扫描、可复用的 channel 与 skill 资源交付工作空间能力。
 
-It is designed for:
+它适合以下场景：
 
-- platform teams running AI agent instances for multiple users
-- operators who need runtime visibility, command dispatch, and desired-state control
-- builders who want governed AI access and reusable resource injection instead of manual per-instance setup
+- 面向多用户运行 AI Agent 实例的平台团队
+- 需要运行时可观测性、命令下发与期望态控制的运维团队
+- 希望以可复用资源而不是手工配置方式交付 Agent 工作空间的开发团队
 
 <a id="team-workspaces"></a>
-## Team Workspaces
+## Team 工作空间
 
-Team Workspaces provide a simplified OpenClaw Lite collaboration flow: choose a role template, create the Team, and describe the goal in the Team chat. The Leader plans the work, coordinates members, collects deliveries, and publishes the final result.
+Team 工作空间提供简化的 OpenClaw Lite 协作流程：选择角色模板、创建 Team，然后在团队群聊中描述目标即可。Leader 会负责制定计划、协调成员、收集交付并输出最终结果。
 
-- fixed Leader-mediated collaboration, without per-member runtime or resource-preset setup
-- built-in templates for focused delivery, product discovery, and software engineering work
-- Team chat for plans, assignments, progress, reviews, deliveries, and final synthesis
-- Execution Kanban for the root-task state and current member deliveries
+- 固定为 Leader 中介协作，无需逐个配置成员运行时或资源预设
+- 内置交付、产品探索和软件工程等成员模板
+- 团队群聊展示计划、派发、进度、验收、交付和最终汇总
+- Execution Kanban 展示总任务状态及当前成员交付
 
-See the [Team Workspace Quick Guide](./docs/team-workspaces-guide_en.md) for the creation flow, collaboration stages, and result viewing.
+参见 [Team 协作快速指南](./docs/team-workspaces-guide.md)，了解创建、协作阶段和查看交付结果的流程。
 
 <a id="runtime-integrations"></a>
-## Runtime Integrations
+## Runtime 接入
 
-ClawManager currently supports the following managed runtimes:
+ClawManager 当前支持以下受管 Runtime：
 
-- <img src="frontend/public/openclaw.png" alt="OpenClaw icon" width="18" /> `OpenClaw`: the default OpenClaw-style workspace runtime used by ClawManager-managed desktop instances
-- <img src="frontend/public/hermes.png" alt="Hermes icon" width="18" /> `Hermes`: a Webtop-based runtime integration with a persistent `.hermes` workspace and embedded Hermes agent
+- <img src="frontend/public/openclaw.png" alt="OpenClaw icon" width="18" /> `OpenClaw`：ClawManager 默认支持的 OpenClaw 风格桌面工作空间 Runtime
+- <img src="frontend/public/hermes.png" alt="Hermes icon" width="18" /> `Hermes`：基于 Webtop 的 Runtime 接入，带有持久化 `.hermes` 工作空间和内置 Hermes agent
 
-Runtime previews:
+Runtime 预览：
 
 **<img src="frontend/public/openclaw.png" alt="OpenClaw icon" width="18" /> OpenClaw**
 
@@ -138,149 +144,153 @@ Runtime previews:
 
 ![hermes](./docs/images/hermes.png)
 
-Runtime authors can follow the [Hermes Runtime Guide](./docs/hermes-runtime-agent-development.md), the [Generic Runtime Agent Integration Guide](./docs/runtime-agent-integration-guide.md), and the [Skill Content MD5 Spec](./docs/skill-content-md5-spec.md) to build compatible agents.
+Runtime 开发方可以参考 [Hermes Runtime Guide](./docs/hermes-runtime-agent-development.md)、[通用 Runtime Agent 接入指南](./docs/runtime-agent-integration-guide.md) 与 [Skill Content MD5 规范](./docs/skill-content-md5-spec.md) 实现兼容 agent。
 
-## Get Started
+<a id="get-started"></a>
+## 快速开始
 
-ClawManager now separates the Kubernetes distribution from the storage profile. Choose `k3s` or `k8s` first, then choose the storage profile that matches the cluster shape:
+ClawManager 现在将 Kubernetes 发行版与存储 profile 拆开。先选择 `k3s` 或 `k8s`，再选择匹配集群形态的存储 profile：
 
-- k3s single-node HostPath: [deployments/k3s/single-node/clawmanager.yaml](./deployments/k3s/single-node/clawmanager.yaml)
-- k3s cluster CSI/RWX example: [deployments/k3s/cluster/clawmanager.yaml](./deployments/k3s/cluster/clawmanager.yaml)
-- Kubernetes single-node HostPath: [deployments/k8s/single-node/clawmanager.yaml](./deployments/k8s/single-node/clawmanager.yaml)
-- Kubernetes cluster CSI/RWX example: [deployments/k8s/cluster/clawmanager.yaml](./deployments/k8s/cluster/clawmanager.yaml)
-- Operations-oriented quick start and first login flow: [User Guide](./docs/use_guide_en.md)
-- Deployment notes and architecture-level context: [Deployment Guide](./docs/deployment.md)
+- k3s 单节点 HostPath: [deployments/k3s/single-node/clawmanager.yaml](./deployments/k3s/single-node/clawmanager.yaml)
+- k3s 多节点 CSI/RWX 示例: [deployments/k3s/cluster/clawmanager.yaml](./deployments/k3s/cluster/clawmanager.yaml)
+- Kubernetes 单节点 HostPath: [deployments/k8s/single-node/clawmanager.yaml](./deployments/k8s/single-node/clawmanager.yaml)
+- Kubernetes 多节点 CSI/RWX 示例: [deployments/k8s/cluster/clawmanager.yaml](./deployments/k8s/cluster/clawmanager.yaml)
+- 首次登录与操作流程: [用户指南](./docs/use_guide_cn.md)
+- 部署说明与架构背景: [Deployment Guide（英文）](./docs/deployment.md)
 
-The cluster profile is validated with Longhorn (`longhorn` for RWO data and `longhorn-rwx` for RWX workspaces), but these StorageClass names are examples. You can replace them with any CSI classes that provide the same access modes.
+多节点 cluster profile 使用 Longhorn 作为官方验证示例，其中 `longhorn` 用于 RWO 数据卷，`longhorn-rwx` 用于 RWX workspace。项目不绑定 Longhorn，用户可以替换为具备相同访问模式能力的 CSI StorageClass。
 
-## Three Control Planes
+## 三大控制平面
 
+<a id="ai-gateway"></a>
 ### AI Gateway
 
-AI Gateway is the governance plane for model access inside ClawManager. It gives managed agent runtimes a unified OpenAI-compatible entry point while adding policy and audit controls on top of upstream providers.
+AI Gateway 是 ClawManager 中负责模型访问治理的控制平面。它为受管 Agent Runtime 提供统一的 OpenAI 兼容入口，同时在上游模型服务之上叠加策略、审计与成本控制能力。
 
-- Unified gateway entry for model traffic
-- Secure model routing and policy-aware model selection
-- End-to-end audit and trace records
-- Built-in cost accounting and usage analysis
-- Risk control rules that can block or reroute requests
+- 统一的模型访问入口
+- 安全模型路由与策略驱动的模型选择
+- 端到端审计与追踪记录
+- 内建成本核算与使用分析
+- 可阻断或改道路由的风险控制规则
 
-See the [AI Gateway Guide](./docs/aigateway.md).
+参见 [AI Gateway Guide（英文）](./docs/aigateway.md)。
 
+<a id="agent-control-plane"></a>
 ### Agent Control Plane
 
-Agent Control Plane is the runtime orchestration layer for managed AI agent instances. It turns each instance into a managed runtime that can register, report status, receive commands, and stay aligned with platform-side desired state.
+Agent Control Plane 是受管 AI Agent 实例的运行时编排层。它让每一个实例都成为可注册、可汇报状态、可接收命令，并持续对齐平台期望态的受管运行时。
 
-- Agent registration with secure bootstrap and session lifecycle
-- Heartbeat-driven runtime status and health reporting
-- Desired-state synchronization between the control plane and the instance
-- Runtime command dispatch for start, stop, config apply, health checks, and skill operations
-- Instance-level visibility into agent status, channels, skills, and command history
+- 基于安全引导与会话生命周期的 Agent 注册
+- 依靠心跳机制进行运行时状态与健康上报
+- 控制平面与实例之间的期望态同步
+- 支持启动、停止、配置应用、健康检查与 Skill 操作的命令下发
+- 在实例维度查看 Agent 状态、channel、skill 与命令历史
 
-See the [Agent Control Plane Guide](./docs/agent-control-plane.md).
+参见 [Agent Control Plane Guide（英文）](./docs/agent-control-plane.md)。
 
-### Resource Management
+<a id="resource-management"></a>
+### 资源管理
 
-Resource Management is the reusable asset layer for AI agent workspaces. It helps teams prepare channels and skills once, organize them into bundles, inject them into instances, and keep security review in the loop.
+资源管理是 AI Agent 工作空间的可复用资产层。团队可以先准备好 channel 和 skill，再通过 bundle 进行组合、注入到实例中，并把安全审查纳入整个交付流程。
 
-- Channel management for workspace connectivity and integration templates
-- Skill management for reusable packaged capabilities
-- Skill Scanner workflows for risk review and scan operations
-- Bundle-based resource composition for repeatable workspace setup
-- Injection snapshots and runtime-level visibility into what was applied
+- `Channel` 管理，用于工作空间连接与集成模板
+- `Skill` 管理，用于可复用能力包
+- `Skill Scanner` 工作流，用于风险审查与扫描任务
+- 基于 bundle 的资源组合，用于可重复交付
+- 通过注入快照追踪实际下发到实例的内容
 
-See the [Resource Management Guide](./docs/resource-management.md) and the [Security / Skill Scanner Guide](./docs/security-skill-scanner.md).
+参见 [Resource Management Guide（英文）](./docs/resource-management.md) 与 [Security / Skill Scanner Guide（英文）](./docs/security-skill-scanner.md)。
 
-## Product Gallery
+## 产品界面
 
-The product is designed to feel coherent across administration, workspace access, and AI governance. Instead of treating these as separate tools, ClawManager brings them into one control surface.
+ClawManager 的设计目标，是让管理、访问与 AI 治理体验形成统一的产品界面，而不是分散在多个孤立工具中。
 
-### Lite Mode Deployment
+### Lite 模式部署
 
-Lite mode provisions instances through a shared gateway runtime pool. Each workspace runs as an isolated gateway process inside managed runtime Pods, which keeps startup fast and lowers dedicated CPU, memory, storage, and GPU allocation overhead while preserving workspace access, Share Link / Password access, channel and skill injection, and admin visibility.
+Lite 模式通过共享 gateway 运行时池创建实例。每个工作空间作为受管 runtime Pod 中的独立 gateway 进程运行，启动更快，并减少专属 CPU、内存、存储和 GPU 配额开销，同时保留工作空间访问、Share Link / Password 访问、channel 与 skill 注入，以及管理端可见性。
 
 ![](./docs/main/liteopenclaw.png)
 
-### Pro Mode Deployment
+### Pro 模式部署
 
-Pro mode provisions a dedicated desktop runtime for each instance, backed by its own Kubernetes Deployment, Service, and PVC. Use it when users need stronger isolation, full desktop resources, runtime events, instance skill management, and the complete desktop management experience.
+Pro 模式为每个实例创建专属 desktop runtime，并使用独立 Kubernetes Deployment、Service 和 PVC。适用于需要更强隔离、完整桌面资源、runtime events、实例级 skill 管理和完整桌面管理体验的场景。
 
 ![](./docs/main/proopenclaw.png)
 
-### Team Workspace
+### Team 工作空间
 
-The Team workspace page brings the leader desktop, Team chat, member table, and dispatch workflow into one operational view, so users can follow collaboration progress without leaving ClawManager.
+Team 工作空间页面把 Leader 桌面、团队群聊、成员表格和调试派发流程集中在同一个操作视图中，用户可以直接观察协作进度、成员反馈和任务结果。
 
 <p align="center">
-  <img src="./docs/main/team-workspace.png" alt="ClawManager Team workspace" width="100%" />
+  <img src="./docs/main/team-workspace.png" alt="ClawManager Team 工作空间" width="100%" />
 </p>
 
-### Admin Console
+### 管理控制台
 
-The admin console brings together users, quotas, runtime operations, security controls, and platform-level policies in one place. It is the operational center for teams running AI agent infrastructure at scale.
+管理控制台将用户、配额、运行时操作、安全控制与平台级策略集中到一起，是团队管理 AI Agent 基础设施的核心工作台。
 
 <p align="center">
-  <img src="./docs/main/admin.png" alt="ClawManager admin console" width="100%" />
+  <img src="./docs/main/admin.png" alt="ClawManager 管理控制台" width="100%" />
 </p>
 
-### Portal Access
+### Portal 访问
 
-The portal experience gives users a clean entry point into their workspaces, with browser-based access and runtime visibility that stays connected to the control plane instead of exposing infrastructure details directly.
+Portal 为用户提供统一的工作空间入口。用户可以通过浏览器访问实例，并查看与控制平面保持一致的运行时状态，而不需要直接面对底层基础设施细节。
 
 <p align="center">
-  <img src="./docs/main/portal.png" alt="ClawManager portal access" width="100%" />
+  <img src="./docs/main/portal.png" alt="ClawManager Portal 访问" width="100%" />
 </p>
 
 ### AI Gateway
 
-AI Gateway extends the workspace experience with governed model access, audit trails, cost visibility, and risk-aware routing, making AI usage manageable as part of the platform rather than an isolated integration.
+AI Gateway 将模型访问治理纳入工作空间体验本身，提供审计记录、成本可见性与风险路由能力，让 AI 使用成为平台能力的一部分，而不是零散接入。
 
 <p align="center">
   <img src="./docs/main/aigateway.png" alt="ClawManager AI Gateway" width="100%" />
 </p>
 
-## How It Works
+## 工作方式
 
-1. Admins define governance policies and reusable resources.
-2. Users create or enter managed AI agent workspaces on Kubernetes.
-3. Team workspaces can provision multiple member runtimes with Redis Team Bus and shared storage configuration.
-4. Agents connect back to the control plane and report runtime state.
-5. Channels, skills, and bundles are compiled and applied to instances.
-6. AI traffic flows through AI Gateway with audit, risk, and cost controls.
+1. 管理员先定义治理策略与可复用资源。
+2. 用户在 Kubernetes 上创建或进入受管 AI Agent 工作空间。
+3. Team 工作空间可以一次编排多个成员 Runtime，并注入 Redis Team Bus 与共享存储配置。
+4. Agent 回连控制平面并上报运行时状态。
+5. Channel、skill 与 bundle 被编译并应用到实例中。
+6. AI 流量通过 AI Gateway 进入上游服务，并附带审计、风险与成本控制。
 
-## Developer Snapshot
+## 开发者概览
 
-ClawManager is built as a Kubernetes-native platform with a React frontend, a Go backend, MySQL for state, and supporting services such as skill-scanner and object storage integrations. The repository is organized around product subsystems rather than a single monolith page, so the best developer experience is to start from the relevant guide and then move into the code.
+ClawManager 是一个 Kubernetes 原生平台，包含 React 前端、Go 后端、MySQL 状态存储，以及 `skill-scanner` 与对象存储等支撑组件。代码库按产品子系统组织，因此更适合从对应能力的指南切入，再进入代码实现。
 
-- Frontend app and admin/user surfaces live under `frontend/`
-- Backend services, handlers, repositories, and migrations live under `backend/`
-- Deployment assets live under `deployments/`
-- Supporting product docs live under `docs/`
+- 前端管理界面与用户界面位于 `frontend/`
+- 后端服务、handler、repository 与 migration 位于 `backend/`
+- 部署资产位于 `deployments/`
+- 产品文档与素材位于 `docs/`
 
-See the [Developer Guide](./docs/developer-guide.md).
+参见 [Developer Guide（英文）](./docs/developer-guide.md)。
 
-## Documentation
+## 文档
 
-- [User Guide](./docs/use_guide_en.md)
-- [Team Workspace Quick Guide](./docs/team-workspaces-guide_en.md)
-- [Deployment Guide](./docs/deployment.md)
-- [Admin and User Guide](./docs/admin-user-guide.md)
-- [Agent Control Plane Guide](./docs/agent-control-plane.md)
-- [AI Gateway Guide](./docs/aigateway.md)
-- [Security / Skill Scanner Guide](./docs/security-skill-scanner.md)
-- [Resource Management Guide](./docs/resource-management.md)
+- [用户指南](./docs/use_guide_cn.md)
+- [Team 协作快速指南](./docs/team-workspaces-guide.md)
+- [Deployment Guide（英文）](./docs/deployment.md)
+- [Admin and User Guide（英文）](./docs/admin-user-guide.md)
+- [Agent Control Plane Guide（英文）](./docs/agent-control-plane.md)
+- [AI Gateway Guide（英文）](./docs/aigateway.md)
+- [Security / Skill Scanner Guide（英文）](./docs/security-skill-scanner.md)
+- [Resource Management Guide（英文）](./docs/resource-management.md)
 - [Hermes Runtime Guide](./docs/hermes-runtime-agent-development.md)
-- [Generic Runtime Agent Integration Guide](./docs/runtime-agent-integration-guide.md)
-- [Skill Content MD5 Spec](./docs/skill-content-md5-spec.md)
-- [Developer Guide](./docs/developer-guide.md)
+- [通用 Runtime Agent 接入指南](./docs/runtime-agent-integration-guide.md)
+- [Skill Content MD5 规范](./docs/skill-content-md5-spec.md)
+- [Developer Guide（英文）](./docs/developer-guide.md)
 
-## License
+## 许可证
 
-This project is licensed under the MIT License.
+本项目基于 MIT License 开源。
 
-## Open Source
+## 开源协作
 
-Issues and pull requests are welcome.
+欢迎提交 Issue 与 Pull Request。
 
 ## Star History