diff --git a/README.md b/README.md
index 07ca011..485a1ef 100644
--- a/README.md
+++ b/README.md
@@ -1,19 +1,25 @@
-# Agentic Plugin Marketplace
+<!-- WEHUB_ZH_README -->
+> [!NOTE]
+> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。  
+> [English](./README.en.md) · [原始项目](https://github.com/wshobson/agents) · [上游 README](https://github.com/wshobson/agents/blob/HEAD/README.md)  
+> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
 
-> Production-ready agentic workflow building blocks: **92 plugins**, **199 agents**,
-> **162 skills**, **106 commands** — built for Claude Code and consumed natively by
-> OpenAI Codex CLI, Cursor, OpenCode, Gemini CLI, and GitHub Copilot from a single Markdown source.
+# Agentic 插件市场
+
+> 生产就绪的智能体（agentic）工作流构建块：**92 个插件**、**199 个智能体**、
+> **162 项技能**、**106 条命令** —— 面向 Claude Code 构建，并由单一 Markdown 源原生供
+> OpenAI Codex CLI、Cursor、OpenCode、Gemini CLI 和 GitHub Copilot 使用。
 
 [![Claude Code](https://img.shields.io/badge/Claude%20Code-native-blueviolet)](#claude-code) [![Codex CLI](https://img.shields.io/badge/Codex%20CLI-supported-black)](docs/harnesses.md) [![Cursor](https://img.shields.io/badge/Cursor-supported-purple)](docs/harnesses.md) [![OpenCode](https://img.shields.io/badge/OpenCode-supported-green)](docs/harnesses.md) [![Gemini CLI](https://img.shields.io/badge/Gemini%20CLI-supported-blue)](GEMINI.md) [![Copilot](https://img.shields.io/badge/Copilot-supported-lightgrey)](docs/harnesses.md)
 
 > [!NOTE]
-> One source-of-truth (`plugins/`), five harnesses. Each harness gets idiomatic,
-> harness-native artifacts — not lowest-common-denominator translations.
-> See [docs/harnesses.md](docs/harnesses.md) for the capability matrix.
+> 单一事实来源（`plugins/`），五种工具链（harness）。每种工具链都会获得符合其习惯、
+> 原生于该工具链的产物 —— 而非最低公分母的翻译。
+> 能力矩阵见 [docs/harnesses.md](docs/harnesses.md)。
 
-## Quick start
+## 快速开始
 
-Pick your harness:
+选择你的工具链：
 
 ### Claude Code
 
@@ -22,18 +28,18 @@ Pick your harness:
 /plugin install python-development          # or any of 92 plugins
 ```
 
-[→ Full Claude Code setup, troubleshooting, and plugin catalog](docs/usage.md)
+[→ Claude Code 完整设置、故障排查与插件目录](docs/usage.md)
 
 ### Codex CLI · Cursor · OpenCode · Gemini CLI · Copilot
 
-Codex and Cursor install natively from the committed registries (which point at the source `plugins/`):
+Codex 和 Cursor 可从已提交的注册表原生安装（注册表指向源 `plugins/`）：
 
 ```bash
 npx codex-marketplace add wshobson/agents        # Codex; then install individual plugins
 # Cursor: add the marketplace, then `/plugin install <name>` (reads .cursor-plugin/ + source)
 ```
 
-Gemini and OpenCode install via clone + generate (the transformed trees are gitignored):
+Gemini 和 OpenCode 通过克隆 + 生成安装（转换后的目录树已加入 gitignore）：
 
 ```bash
 gh repo clone wshobson/agents ~/agents && cd ~/agents
@@ -41,25 +47,24 @@ make generate HARNESS=gemini && gemini extensions install .   # Gemini
 make install-opencode                                          # OpenCode (runs generate + symlinks)
 ```
 
-Setup details and per-harness gotchas: [docs/harnesses.md](docs/harnesses.md). Gemini-specific setup: [GEMINI.md](GEMINI.md) (also auto-loaded by Gemini CLI).
+设置详情及各工具链注意事项：[docs/harnesses.md](docs/harnesses.md)。Gemini 专属设置：[GEMINI.md](GEMINI.md)（也会由 Gemini CLI 自动加载）。
 
-## What's inside
+## 内容概览
 
-| | Count | What it is |
+| | 数量 | 说明 |
 |---|---:|---|
-| **Plugins** | 92 | Granular, single-purpose installable units (88 local + 4 external via git-subdir) |
-| **Agents** | 199 | Domain experts (architecture, languages, infra, security, data, ML, docs, business, SEO) |
-| **Skills** | 162 | Modular knowledge packages with progressive disclosure (load when activated) |
-| **Commands** | 106 | Slash commands: scaffolding, security scans, test gen, infrastructure setup |
-| **Orchestrators** | 16 | Multi-agent coordination workflows (full-stack, security, ML, incident response) |
+| **Plugins（插件）** | 92 | 细粒度、单一用途的可安装单元（88 个本地 + 4 个通过 git-subdir 引入的外部插件） |
+| **Agents（智能体）** | 199 | 领域专家（架构、语言、基础设施、安全、数据、ML、文档、业务、SEO） |
+| **Skills（技能）** | 162 | 模块化知识包，支持渐进式披露（激活时加载） |
+| **Commands（命令）** | 106 | 斜杠命令：脚手架、安全扫描、测试生成、基础设施设置 |
+| **Orchestrators（编排器）** | 16 | 多智能体协调工作流（全栈、安全、ML、事件响应） |
 
-Browse the catalog: [docs/plugins.md](docs/plugins.md) · [docs/agents.md](docs/agents.md) · [docs/agent-skills.md](docs/agent-skills.md)
+浏览目录：[docs/plugins.md](docs/plugins.md) · [docs/agents.md](docs/agents.md) · [docs/agent-skills.md](docs/agent-skills.md)
 
-## How it works
+## 工作原理
 
-Each plugin is isolated and composable: agents, commands, and skills are auto-discovered
-from directory structure. **Installing a plugin loads only its components into
-context** — not the whole marketplace.
+每个插件相互隔离且可组合：智能体、命令和技能会根据目录结构自动发现。
+**安装插件时，仅将其组件加载到上下文中** —— 而非整个市场。
 
 ```
 plugins/python-development/
@@ -69,31 +74,31 @@ plugins/python-development/
 └── skills/             # 16 specialized skills (async, testing, packaging, …)
 ```
 
-Tiered model strategy:
+分层模型策略：
 
-| Tier | Model | Use |
+| 层级 | 模型 | 用途 |
 |---|---|---|
-| 0 | Fable 5  | Longest-horizon autonomous work — large migrations, multi-hour runs (opt-in, premium cost) |
-| 1 | Opus     | Architecture, security, code review, production-critical |
-| 2 | inherit  | User-chosen — backend, frontend, AI/ML, specialized |
-| 3 | Sonnet   | Docs, testing, debugging, API references |
-| 4 | Haiku    | Fast operational tasks, SEO, deployment, content |
+| 0 | Fable 5  | 最长时程的自主工作 —— 大型迁移、数小时运行（可选，高级费用） |
+| 1 | Opus     | 架构、安全、代码审查、生产关键任务 |
+| 2 | inherit  | 用户自选 —— 后端、前端、AI/ML、专项领域 |
+| 3 | Sonnet   | 文档、测试、调试、API 参考 |
+| 4 | Haiku    | 快速运维任务、SEO、部署、内容 |
 
-[→ Model configuration details](docs/agents.md#model-configuration)
+[→ 模型配置详情](docs/agents.md#model-configuration)
 
-## Multi-harness support
+## 多工具链支持
 
-This marketplace ships to five agentic harnesses from one Markdown source. Each adapter
-emits harness-native artifacts (not lowest-common-denominator translations):
+本市场从单一 Markdown 源分发至五种智能体工具链。每个适配器
+会生成原生于该工具链的产物（而非最低公分母的翻译）：
 
-| Harness | Generates | Notes |
+| 工具链 | 生成内容 | 说明 |
 |---|---|---|
-| **Claude Code** | (source-of-truth) | Native `marketplace.json` + `plugins/` |
-| **Codex CLI** | `.agents/plugins/marketplace.json` + `plugins/*/.codex-plugin/plugin.json` (committed); `.codex/skills/`, `.codex/agents/` (gitignored) | 8 KB skill cap respected; commands → skills |
-| **Cursor** | `.cursor-plugin/`, `.cursor/rules/` | Thin marketplace + curated rules; reuses `.claude/` |
-| **OpenCode** | `.opencode/agents/`, `.opencode/commands/`, `.opencode/skills/` | `permission:` block from `tools:` allowlist; OpenCode-safe skill names |
-| **Gemini CLI** | `skills/`, `agents/`, `commands/` (TOML) | Native skills + subagents (April 2026 spec) |
-| **Copilot** | `.copilot/agents/`, `.copilot/skills/`, `.copilot/commands/` | Markdown agent profiles + SKILL.md skills + commands-as-skills; model maps to native Claude models |
+| **Claude Code** | （事实来源） | 原生 `marketplace.json` + `plugins/` |
+| **Codex CLI** | `.agents/plugins/marketplace.json` + `plugins/*/.codex-plugin/plugin.json`（已提交）；`.codex/skills/`、`.codex/agents/`（gitignored） | 遵守 8 KB 技能上限；命令 → 技能 |
+| **Cursor** | `.cursor-plugin/`、`.cursor/rules/` | 轻量市场 + 精选规则；复用 `.claude/` |
+| **OpenCode** | `.opencode/agents/`、`.opencode/commands/`、`.opencode/skills/` | 来自 `tools:` 白名单的 `permission:` 块；OpenCode 安全的技能命名 |
+| **Gemini CLI** | `skills/`、`agents/`、`commands/`（TOML） | 原生技能 + 子智能体（2026 年 4 月规范） |
+| **Copilot** | `.copilot/agents/`、`.copilot/skills/`、`.copilot/commands/` | Markdown 智能体配置 + SKILL.md 技能 + 命令即技能；模型映射到原生 Claude 模型 |
 
 ```bash
 make generate-all                        # all five
@@ -101,63 +106,62 @@ make validate                            # structural checks
 make garden                              # drift / dead-link / cap detection
 ```
 
-Codex and Cursor install from source via committed registries; Gemini and OpenCode install via clone + `make`.
+Codex 和 Cursor 通过已提交的注册表从源安装；Gemini 和 OpenCode 通过克隆 + `make` 安装。
 
-[→ Full capability matrix and per-harness deep-dives](docs/harnesses.md)
+[→ 完整能力矩阵与各工具链深入说明](docs/harnesses.md)
 
-## Quality evaluation
+## 质量评估
 
-[`plugin-eval`](plugins/plugin-eval/) is a three-layer evaluation framework for measuring
-and certifying plugin/skill quality:
+[`plugin-eval`](plugins/plugin-eval/) 是用于衡量
+和认证插件/技能质量的三层评估框架：
 
-- **Static** — deterministic structural analysis (<2s, free)
-- **LLM Judge** — semantic evaluation across 4 dimensions (~30s, Haiku + Sonnet)
-- **Monte Carlo** — statistical reliability via 50-100 simulated runs (~2-5 min)
+- **Static（静态）** —— 确定性结构分析（<2s，免费）
+- **LLM Judge（LLM 评判）** —— 跨 4 个维度的语义评估（约 30s，Haiku + Sonnet）
+- **Monte Carlo（蒙特卡洛）** —— 通过 50–100 次模拟运行进行统计可靠性验证（约 2–5 分钟）
 
 ```bash
 uv run plugin-eval score path/to/skill --depth quick
 uv run plugin-eval certify path/to/skill
 ```
 
-[→ PluginEval framework documentation](docs/plugin-eval.md)
+[→ PluginEval 框架文档](docs/plugin-eval.md)
 
-## Documentation map
+## 文档地图
 
-Detail lives in `docs/`. Read in this order:
+详细内容位于 `docs/`。建议按以下顺序阅读：
 
-- **[docs/plugins.md](docs/plugins.md)** — full catalog of all 92 plugins
-- **[docs/agents.md](docs/agents.md)** — all 199 agents by category
-- **[docs/agent-skills.md](docs/agent-skills.md)** — 162 skills with progressive disclosure
-- **[docs/usage.md](docs/usage.md)** — commands, workflows, examples
-- **[docs/architecture.md](docs/architecture.md)** — design principles
-- **[docs/harnesses.md](docs/harnesses.md)** — cross-harness capability matrix
-- **[docs/authoring.md](docs/authoring.md)** — portable-content style guide
-- **[docs/plugin-eval.md](docs/plugin-eval.md)** — quality evaluation framework
-- **[docs/round-trip-results.md](docs/round-trip-results.md)** — real-CLI verification recipes
+- **[docs/plugins.md](docs/plugins.md)** —— 全部 92 个插件的完整目录
+- **[docs/agents.md](docs/agents.md)** —— 按类别列出的全部 199 个智能体
+- **[docs/agent-skills.md](docs/agent-skills.md)** —— 162 项技能及渐进式披露说明
+- **[docs/usage.md](docs/usage.md)** —— 命令、工作流、示例
+- **[docs/architecture.md](docs/architecture.md)** —— 设计原则
+- **[docs/harnesses.md](docs/harnesses.md)** —— 跨工具链能力矩阵
+- **[docs/authoring.md](docs/authoring.md)** —— 可移植内容风格指南
+- **[docs/plugin-eval.md](docs/plugin-eval.md)** —— 质量评估框架
+- **[docs/round-trip-results.md](docs/round-trip-results.md)** —— 真实 CLI 验证方案
 
-Gemini-specific setup: [GEMINI.md](GEMINI.md). All other harness setup, capability deltas, and gotchas live in [docs/harnesses.md](docs/harnesses.md).
+Gemini 专属设置：[GEMINI.md](GEMINI.md)。其他所有工具链的设置、能力差异和注意事项见 [docs/harnesses.md](docs/harnesses.md)。
 
-Contributing: [CONTRIBUTING.md](CONTRIBUTING.md) · Authoring: [docs/authoring.md](docs/authoring.md)
+贡献指南：[CONTRIBUTING.md](CONTRIBUTING.md) · 创作指南：[docs/authoring.md](docs/authoring.md)
 
-## External Memory Integration
+## 外部记忆集成
 
-[Pensyve](https://github.com/major7apps/pensyve) is included as an external
-`git-subdir` entry for Claude Code. Pensyve also maintains direct upstream
-integrations for this marketplace's other supported harnesses.
+[Pensyve](https://github.com/major7apps/pensyve) 作为外部
+`git-subdir` 条目包含在 Claude Code 中。Pensyve 还为该市场支持的其他工具链维护直接上游集成。
 
-| Harness | Pensyve integration |
+| 工具链 | Pensyve 集成 |
 |---|---|
-| Claude Code | `/plugin install pensyve` from this marketplace (`integrations/claude-code`) |
+| Claude Code | 来自本市场的 `/plugin install pensyve`（`integrations/claude-code`） |
 | Codex CLI | [integrations/codex-plugin](https://github.com/major7apps/pensyve/tree/main/integrations/codex-plugin) |
 | Cursor | [integrations/cursor](https://github.com/major7apps/pensyve/tree/main/integrations/cursor) |
 | OpenCode | [integrations/opencode-plugin](https://github.com/major7apps/pensyve/tree/main/integrations/opencode-plugin) |
 | Gemini CLI | `gemini extensions install https://github.com/major7apps/pensyve` |
-| Copilot | `.copilot/` in repo root or `~/.copilot/` via `make install-copilot` |
+| Copilot | 仓库根目录的 `.copilot/` 或通过 `make install-copilot` 使用 `~/.copilot/` |
 
-## License
+## 许可证
 
-MIT — see [LICENSE](LICENSE).
+MIT —— 见 [LICENSE](LICENSE)。
 
-## Star history
+## Star 历史
 
 [![Star History Chart](https://api.star-history.com/svg?repos=wshobson/agents&type=date&legend=top-left)](https://www.star-history.com/#wshobson/agents&type=date&legend=top-left)