🌐 Sync translated READMEs with v3 English README

Port the v3 feature list, AI-agent quick start, neutral CLI wording,
and upgrade section to all translations; bring the Indonesian README
to full structural parity.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

README.zh-cn.md

@@ -26,14 +26,20 @@ Blowfish 是一个轻量有力的 Hugo 主题。它使用 Tailwind CSS 构建，
 
 ## 特性
 
-- 使用 Tailwind CSS 3.0 构建全面响应式布局
+- 使用 Tailwind CSS 4 构建全面响应式布局
 - 多种配色方案，亦可完全由你定义
 - 夜间模式支持（手动开启/关闭或根据用户设备自动切换）
+- 多种主页布局，包括带有主视觉图、数据统计和功能网格的产品风格着陆页
+- 悬浮玻璃质感页眉，支持 ⌘K / Ctrl+K 搜索快捷键
+- 全局背景画布，主视觉区域随滚动溶入其中
+- 文章阅读进度条
+- 可实时预览的交互式主页布局切换器
+- 内置代理技能（agent skill），让 AI 编程代理（如 Claude Code）为你安装和配置主题
+- 配备专用打印样式的打印友好页面
 - 高度自主的配置方式
 - 集成 Firebase 以支持动态数据统计
 - 集成浏览次数统计和点赞机制
 - “相关文章”列表生成
-- 多种主页布局
 - 多作者模式支持
 - 可将文章整理成选集列表
 - 禅模式支持
@@ -42,7 +48,7 @@ Blowfish 是一个轻量有力的 Hugo 主题。它使用 Tailwind CSS 构建，
 - 支持嵌套菜单和子导航菜单
 - 支持多语言内容，包括 RTL 语言
 - 可链接到第三方网站上的帖子
-- 支持多种简码，如图库、时间轴、GitHub 卡片和图片灯箱
+- 内置 40 多种简码，包括图库、时间轴、GitHub 卡片、轮播、数据统计、功能网格、步骤和 CTA 按钮
 - 支持 GitHub Alerts 语法、15 种类型和可折叠功能
 - 支持 Buymeacoffee
 - 拥有由 Fuse.js 支持的客户端一侧网站搜索功能
@@ -77,11 +83,22 @@ Blowfish 支持多种安装方式，既能作为 git 子模块、Hugo 模块，
 
 每种方法的详细说明都可以在 [安装](https://blowfish.page/zh-cn/docs/installation) 文档中找到。为了获得最简单的安装体验，请查阅文档。如果你使用的是 git，请阅读下面使用子模块的快速开始指南；如果你能安装 Hugo 主题，请阅读下面 Hugo 模块的快速开始指南。
 
+### 使用 AI 代理快速开始
+
+Blowfish 内置了一个[代理技能（agent skill）](https://github.com/nunocoracao/blowfish/tree/main/.claude/skills/blowfish)，可以教 AI 编程代理（如 Claude Code）如何安装、配置主题并用它构建网站。在 Claude Code 中通过 Blowfish 插件市场安装：
+
+```shell
+/plugin marketplace add nunocoracao/blowfish
+/plugin install blowfish@blowfish
+```
+
+或者直接将技能文件夹复制到你网站仓库的 `.claude/skills/blowfish/` 目录中——代理会自动识别项目技能。然后让你的代理为你完成 Blowfish 的设置。
+
 ### 使用 Blowfish Tools 快速开始
 
 > **注：** 请确保你已安装 **Node.js**、 **Git** 和 **Hugo** ，且已经创建了一个 Hugo 工程。
 
-我们最新推出了一个新的 CLI 工具，帮助你开始使用 Blowfish。它将为你创建一个新的 Hugo 项目、安装主题并设置主题配置文件。它仍处于测试阶段，因此请 [报告你发现的任何问题](https://github.com/nunocoracao/blowfish-tools)。
+Blowfish Tools 是一个帮助你开始使用 Blowfish 的 CLI 工具。它将为你创建一个新的 Hugo 项目、安装主题并设置主题配置文件。请 [报告你发现的任何问题](https://github.com/nunocoracao/blowfish-tools)。
 
 使用 npm（或其他软件包管理器）全局安装 CLI 工具：
 ```shell
@@ -153,6 +170,10 @@ blowfish-tools new mynewsite
 
 详细的[更新指南](https://blowfish.page/zh-cn/docs/installation/#%E6%9B%B4%E6%96%B0%E4%B8%BB%E9%A2%98)在文档中。
 
+### 从 v2 升级到 v3
+
+Blowfish v3 完全向后兼容：所有新功能均为可选启用，没有删除任何配置选项或模板。git 子模块和手动安装的用户按常规方式升级即可，无需任何改动；Hugo 模块用户只需将 `config/_default/module.toml` 中的导入路径从 `github.com/nunocoracao/blowfish/v2` 改为 `github.com/nunocoracao/blowfish/v3`，然后运行 `hugo mod get -u`。详情请参阅[升级指南](https://blowfish.page/docs/installation/#upgrading-from-v2-to-v3)。
+
 ---
 
 ## 贡献