一、项目背景

本阶段主要完成了 AiPy 企业知识流量站的搭建与整体链路验证。项目最初基于 GrowAI 提供的网站内容营销能力，希望通过 AI 自动生成文章并发布到网站，从而形成一个可以持续更新内容的网站。

随着需求进一步明确，项目定位也发生了变化。最终目标不再是简单搭建一个企业产品展示页面，而是建设一个面向 AI + Python 技术领域的企业知识流量站。

网站一方面需要承担 AiPy 产品知识沉淀和企业知识中心的作用，展示 AiPy 在 AI Agent、Workflow、MCP、LLM、RAG、多模态等方向的产品能力；另一方面还需要通过持续生成高质量技术文章，获取百度等搜索引擎的技术长尾流量，吸引 AI 开发者、Python 学习者以及企业 AI 应用开发相关用户。

因此，整个项目最终形成了以下核心链路：

GrowAI 内容生成 → GitHub 内容托管 → GitBook 网站构建 → 自定义域名发布 → AiPy 企业知识站展示 → Chatbot 智能客服与知识问答

通过这一套流程，使网站既能够作为 AiPy 的企业知识中心，又能够持续通过 AI 自动生成和沉淀技术内容，为后续 SEO 流量增长提供基础。

二、需求分析与网站定位

项目初期使用的是 GrowAI 默认生成的 GitBook 网站模板，网站整体更接近普通技术文档站，页面中仍然保留了原有品牌内容，与 AiPy 的实际业务定位并不一致。

经过需求梳理后，网站最终定位为：

AiPy 企业级 AI 应用开发知识中心 + AI/Python 技术知识流量站。

目标用户主要包括：

• AI 应用开发者；
• Python 开发者及初学者；
• Agent、Workflow、MCP、RAG 等技术学习者；
• 企业 AI 应用建设人员；
• 希望了解 AiPy 产品及解决方案的企业用户。

在内容层面，网站需要同时支持两类内容。

第一类是 AiPy 官方及产品知识内容，包括 AiPy 产品介绍、核心能力、开发文档、应用案例和最佳实践等。

第二类是 SEO 技术内容，通过 GrowAI 持续生成 Agent、Workflow、MCP、RAG、Prompt Engineering、大模型等相关技术文章，为网站积累可被搜索引擎收录的长尾内容。

三、网站整体架构设计

在明确网站定位后，对原有 GitBook 网站的信息架构进行了重新设计。

最终网站主要包括以下栏目：

首页
AiPy 介绍
产品能力
├── AI Agent
├── Workflow
├── MCP
├── LLM
├── Prompt Engineering
├── RAG
└── 多模态
开发文档
├── 快速开始
├── API 文档
└── 最佳实践
博客
└── 最新文章
案例
├── 客服机器人
├── 知识库问答
└── 办公自动化
关于 AiPy
└── 联系我们

相比原来的 GitBook 默认文档结构，新的架构更接近企业技术知识站。

首页主要负责介绍 AiPy 的平台定位和核心能力；产品能力用于沉淀产品相关知识；开发文档服务开发者；博客承担 GrowAI 自动生成文章的主要展示入口；案例用于展示实际应用场景。

四、GrowAI 默认模板的 AiPy 品牌化改造

网站初始模板中存在原有 GrowAI、蓝莺等品牌内容，因此本阶段首先完成了整体品牌替换。

主要修改了 README.md、SUMMARY.md、articles/ 目录及相关静态资源，将网站主体内容统一调整为 AiPy。

首页从原来的普通 README 文档改造为 AiPy 企业知识中心首页，增加平台介绍、核心能力、应用场景、开发入口、FAQ 等内容。

同时重新设计了 GitBook 左侧导航，使用户能够按照产品能力、开发文档、博客和案例等不同路径浏览内容。

在改造过程中有一个重要原则：只修改网站展示层，不破坏 GrowAI 原有的内容生成和发布能力。

因此，没有随意修改原有 GitHub Actions 部署主流程和 GitBook 核心插件配置，尽可能保证品牌改造之后，GrowAI 仍然能够正常生成文章并同步到 GitHub。

五、GitHub 协作权限与代码发布问题

项目改造过程中遇到的第一个明显问题是 GitHub 仓库权限。

本地代码完成修改后执行：

git push origin master

最初出现 403 Permission Denied，原因是 GitHub 仓库属于 maxim-top 账号，而当前开发账号没有直接写入权限。

随后通过 GrowAI 网站配置中的 GitHub 协作者功能，将开发账号添加为仓库 Collaborator。

由于仓库所属组织要求成员开启 Two-Factor Authentication，因此还完成了 GitHub 2FA 配置并接受协作者邀请。

完成权限配置后，本地修改即可正常提交到原 GitHub 仓库，不需要创建个人 Fork，也保证了 GrowAI、GitHub 和网站仍然使用同一个仓库。

六、自定义域名配置

网站完成基础改造后，为其配置了公司提供的 jwdaren.com 域名体系。

最终使用：

verification.jwdaren.com

作为当前 AiPy 企业知识站的访问地址。

配置过程中首先完成域名归属验证，通过 DNS 添加平台要求的 TXT 记录，然后在平台完成自定义域名验证。

完成后，网站可以通过 verification.jwdaren.com 正常访问，不再依赖平台默认提供的临时域名。

这一阶段也验证了从 GitHub 仓库内容到 GitBook 构建，再到公司自定义域名访问的完整发布链路。

七、GrowAI 文章自动生成与网站同步

完成网站基础搭建后，开始验证 GrowAI 的核心内容生成能力。

通过 GrowAI 创建文章生成计划，可以围绕 AiPy 的能力展示、AiPy 应用等主题批量生成文章。

实际测试中，GrowAI 能够正常生成 Markdown 文件，并成功将文章提交到 GitHub 的 articles 目录。

但随后发现一个关键问题：

文章已经存在于 GitHub，但网站「博客 → 最新文章」页面并没有显示这些新文章。

经过分析发现，GitBook 网站的最新文章页面仍然是静态内容，SUMMARY.md 和 latest.md 没有随着 articles 目录中新文章的增加自动更新。

这意味着虽然“AI 生成文章 → GitHub”链路已经打通，但“GitHub → 网站文章展示”并没有真正实现自动同步。

针对这一问题，后续对文章索引机制进行了调整，目标是让构建流程自动扫描 articles 目录下新增的 Markdown 文件，并自动更新 latest.md 和 SUMMARY.md。

最终希望实现：

GrowAI 生成文章
↓
Markdown 自动进入 GitHub
↓
自动更新文章索引
↓
GitBook 自动构建
↓
verification.jwdaren.com 自动更新
↓
「博客 → 最新文章」展示新内容

这一机制非常重要，因为网站未来不会只生成当前几篇文章，而是会持续产生新的 AI 技术内容，因此不能依赖人工维护文章列表。

八、Chatbot 智能客服与知识问答能力

除了传统的文章和文档展示，本项目还配置了 AiPy 小助手 Chatbot。

Chatbot 的定位不是普通营销客服，而是：

AiPy 企业知识助手 + AI 技术问答助手 + 产品咨询助手。

用户访问网站后，可以围绕 AiPy 产品能力、Agent、Workflow、MCP、RAG 等内容进行咨询。

在 Chatbot 配置中，完成了昵称、简介、欢迎语、客服按钮等基础设置，并根据 AiPy 品牌设计客服形象。

后续计划将 AiPy 现有产品文档、开发文档和技术资料持续上传至知识库，使 Chatbot 能够基于真实企业知识回答问题，而不是完全依赖通用大模型知识。

这样网站最终可以形成：

技术文章负责搜索流量 → 产品文档负责知识沉淀 → Chatbot 负责即时问答

三者共同构成完整的企业知识流量站。

九、项目总结与下一阶段计划

经过本阶段开发，AiPy 企业知识流量站已经从最初的 GrowAI 默认模板，逐步改造成具有明确企业品牌和内容定位的 AI 技术知识站。

目前已经基本完成：

GrowAI 内容生成、GitHub 内容托管、GitBook 网站构建、AiPy 品牌改造、自定义域名配置、文章生成计划、Chatbot 配置以及企业认证流程准备。

整个项目最大的变化，是从最开始的“搭建一个企业介绍网站”，逐渐明确为一个能够持续运营的 AI + Python 技术知识流量站。

下一阶段将重点推进三个方向。

首先，继续完善文章自动同步机制，确保后续 GrowAI 每次生成的新文章都能够自动进入网站「博客 → 最新文章」，真正实现无人值守的内容更新。

其次，扩展 GrowAI 内容生成计划，在现有“AiPy 能力展示”和“AiPy 应用”基础上，增加 Agent 开发、Workflow、MCP、RAG、Prompt Engineering、AI 基础知识、行业解决方案、最佳实践等内容方向。

最后，将公司现有 AiPy 产品文档、技术资料和开发文档逐步接入知识库，使网站不仅能够依靠 AI 自动生成 SEO 内容，还能够真正沉淀公司内部已有的 AiPy 知识，并通过 Chatbot 为用户提供准确的产品与技术问答。

最终希望形成一套完整的内容增长闭环：

企业文档沉淀 → AI 知识库 → GrowAI 内容生产 → GitHub 内容管理 → 网站自动发布 → 搜索引擎获取流量 → 用户阅读技术内容 → Chatbot 深度咨询 → 持续沉淀新的企业知识

这也是本项目后续从“网站搭建”进一步发展为“企业 AI 知识与内容增长平台”的核心方向。