Qoder+Skills,一个人一周完成开源官网重构

“你的官网,AI 能读懂吗?”当我第一次把 Higress 文档链接丢给 Claude,让它帮我写个接入 Demo 时,AI 的回复是:“抱歉,我无法有效解析这个页面的内容结构...”这一刻我意识到:我们的文档,正在被时代淘汰。

TL;DR




Cloud Native

  • 🏗️ 技术栈大换血:迁移到 Astro 5 + Starlight,Lighthouse 性能跑分 100 分。

  • 🤖 AI 友好:接入 llms.txt 标准,支持 Cursor、Claude Code Qoder 等 主流 AI Coding 工具。

  • 🎯 AI 全能助手:设计稿转代码、无效资源自动清理、页面体验和性能优化、SEO/CRO 专业分析、内容缺失智能补全。这些原本需要设计师、运维、SEO 专家、产品经理协同的工作,现在 AI 都能搞定。

  • ⚡ 效率革命:一个人 + Qoder + Skills,完成过去需要一个小组的工作量。


01

开源技术领先,官网和文档不够美丽

Cloud Native

Higress[1]作为 AI 时代的流量基础设施,经历了多次升级,目前分为以下三大能力形态:


  • API 网关(https://higress.ai/api-gateway):将流量网关、微服务网关和安全网关三合一,提供统一的服务暴露、流量管控、API 全生命周期管理能力。

  • AI 网关(https://higress.ai/ai-gateway):专为 AI 场景设计,统一代理大模型 API 与 MCP Server,支持模型、工具(MCP)及 Agent 的集中接入与管理。

  • HiMarket(https://higress.ai/himarket):助力企业构建 Agent、Model、MCP 市场,通过统一的 AI 能力管理平台,解决 AI 资源分散、权限管控复杂、成本分摊困难等挑战。平台提供 HiChat AI 创新中心作为全员 AI 使用入口,打破团队间的能力孤岛,降低接入成本,释放 AI 创新潜能。

Higress 以 Envoy 为内核,通过 WASM[2]插件进行能力边界拓展。然而,现有的官网架构逐渐成为发展的阻碍:

  • 产品孤岛:所有的网关都需要独立的 Landing Page,以及独立产品文档,维护成本高。

  • AI 阅读障碍:随着 AI Coding 的深入使用,开发者趋向让 AI 阅读产品文档,然后编写 Demo 或者融入当前的业务逻辑。我们的产品官网不仅仅是给人阅读,更多需要考虑给 AI 阅读。

  • 能力短板:团队同学的过往工作经验一直在 B 端业务,官网首页是一个偏 C 端的场景。对于性能、SEO、样式效果要求和 B 端完全不一样。过去的这部分的工作经验非常少。

02

Higress 官网全新升级

Cloud Native

基于以上痛点,我们对 Higress 官网进行了一次全面的架构升级和体验重塑。

▍1. 技术栈大换血

新官网采用 Astro 5[3]作为核心框架,配合 Starlight[4]文档系统,实现了:

  • 岛屿架构:默认零 JS,只在需要交互的组件加载 JavaScript,首屏性能大幅提升。

  • Tailwind CSS 4:全新的样式系统,开发效率更高,产物体积更小。

  • TypeScript 全量覆盖:类型安全的开发体验。

▍2. 产品矩阵统一门户

告别产品孤岛,三大产品线统一入口,独立 Landing Page:

产品

入口

定位

首页

higress.ai

品牌门户,角色引导

API 网关

/api-gateway

流量、微服务、安全三合一

AI 网关

/ai-gateway

大模型 API + MCP 统一代理

HiMarket

/himarket

Agent/Model/MCP 市场

每个产品都有独立的快速开始文档,用户可以根据场景快速上手。

▍3. 用户引导分流

首页增加三种方案选择器(企业版[5]、快速体验[6]、产品介绍[7]),根据用户不同需求和时间投入意愿,提供差异化的引导路径,降低决策成本,提升转化率。

▍4. 用户友好设计

除了技术架构升级,我们在用户体验上也做了大量优化:

  • 场景化快速入门:首页提供四大核心场景卡片(多模型代理、应用安全防护、AI 语义缓存、Token 管理),每个场景标注预计阅读时间,hover 展示场景简介和“立即体验”按钮,帮助用户快速找到所需内容。

  • 70+ 常见问题库:整理社区高频问题,构建 FAQ 知识库,覆盖部署、配置、插件开发等常见场景,减少用户排查成本。

  • 100+ 技术博客:涵盖版本发布、最佳实践、用户案例、技术深度解读,支持按分类和标签筛选。

  • 响应式设计:全站适配 PC、平板、手机等多端设备,移动端导航优化,确保在任何设备上都有良好的阅读体验。

▍5. 让 AI 读懂你的文档:三个关键设计

在 AI Coding 时代,官网的读者不再仅仅是人类,还有 AI。我们从架构层面为 AI 阅读做了专项优化:

5.1 llms.txt 自动生成

遵循 llms.txt[8]标准,构建时自动生成 AI 专属入口文件:

  • 访问地址:https://higress.ai/llms.txt。

  • 包含:网站简介 + 文档分类 + 完整链接索引。

  • 自动同步:每次构建自动从 _sidebar.json 生成,无需手动维护。

5.2 Markdown 原文导出

所有文档页面提供 Markdown 原文访问: AI 工具可直接抓取纯净的 Markdown 内容,无需解析 HTML。

5.3 主流 AI 工具对接

提供与 Cursor、Windsurf、Claude Code、Gemini CLI、Trae、Qoder 等主流 AI Coding 工具的集成指南,开发者可一键将 Higress 文档接入 AI 助手。

详见:如何在 AI 工具中使用 Higress 文档[9]。

03

用 SKills 补齐程序员的“营销短板”

Cloud Native

网站的成功不仅依赖技术实现,流量获取与增长策略同样至关重要。这些能力长期属于 SEO 专家和增长黑客的专业领域,…

— 以上为试看内容(约 40%),开通会员后阅读全文 —