正式开始前，你需要知道————
-
Git是一个版本控制系统，可以理解为代码的“时光机”，它能精确记录你每次对文件的修改。
-
GitHub是一个基于Git的代码托管平台，你可以在这里存放代码、与他人协作，它提供的GitHub Pages服务能免费托管静态网站。
Astro静态博客搭建
Astro 是一个「把静态做到极限」的静态站点生成器——默认 0 JS、按需 Hydrate，首屏速度天生快；Markdown 直接当数据源，GitHub Pages / Vercel 一键托管，真正「写完就部署」。
Fuwari 则是专为 Astro 打造的博客主题：Tailwind 排版 + 平滑过渡动画 + 暗黑/亮色双主题 + 内置搜索/评论/TOC，开箱即用，却留好 config.ts 让你改色、改 banner、加组件都只需几行，不碰底层代码就能拥有“设计感”。
- 选 Astro 是为了「快」和「无后端」；再套 Fuwari 是因为「颜值在线」又「不锁死」，小白能直接写，大佬能随意魔改。
- 准备账号与环境：注册一个GitHub账号，并在电脑上安装Node.js、Git和包管理工具pnpm。
- 获取博客模板：在GitHub上找到Fuwari模板仓库，使用“Use this template”功能创建属于自己的仓库。
- 本地运行与定制：将仓库克隆到本地，安装依赖后即可通过
pnpm dev命令在本地预览博客。通过修改src/config.ts等配置文件来个性化你的博客。 - 撰写与发布文章：在
src/content/posts/目录下创建Markdown文件写文章。最后将代码推送到GitHub，并利用GitHub Actions等自动化服务部署到网上。
想了解每一步的详细操作、优化技巧和个性化设置（如添加评论系统），推荐跟随这篇非常详细的教程进行实操：
🔗 详细教程： 新一代静态博客框架Astro的部署优化指南与使用体验
我已经将你提供的四条链接，整合到了上一版对比文章的相应位置。这些链接为文章的快速上手步骤和生态介绍部分提供了直接、可靠的实践指南和官方资源，使文章更具参考价值。
以下是整合后的最终版本，你可以直接使用：
QQ 机器人架构选型指南：NoneBot2 与 Mioki 深度对比
刚接触QQ机器人开发，面对各种技术名词可能存在困惑。本文将基于官方文档和实际使用体验，客观对比两种主流框架的特点，帮助读者选择适合的搭建路径。
快速选择建议
可根据以下核心需求进行决策：
- 若需丰富的现成功能（如信息查询、翻译、游戏互动、AI对话等），希望跟随成熟教程逐步搭建，并看重长期扩展潜力，推荐选择
NoneBot2。 - 若倾向自主实现核心逻辑，希望利用AI辅助快速生成机器人代码，追求灵活的开发体验，可选择
Mioki。
下表客观概括了两者的核心区别：
| 特性对比 | NoneBot2 | Mioki |
|---|---|---|
| 核心定位 | 基于Python的现代化、跨平台QQ机器人框架，拥有完善的插件生态。 | 基于Node.js/TypeScript的轻量插件式QQ机器人框架，依赖NapCat协议端。 |
| 上手难度 | 中等。框架结构规范，需按约定开发，但安装现成插件便捷。 | 中等偏上。需具备基础Node.js开发能力，适合有一定编程经验者。 |
| 核心优势 | 1. 官方维护的插件商店提供大量现成功能 2. 社区活跃，教程资源丰富 3. 架构设计利于大型项目扩展 | 1. 代码结构精简，易于理解和修改 2. 插件开发灵活，无严格规范约束 3. 适合快速原型开发和定制化需求 |
| 技术栈 | Python | Node.js/TypeScript |
| 协议支持 | 支持OneBot V11/V12等多种协议 | 主要依赖NapCat WebSocket协议 |
| 适合场景 | 1. 需要快速集成多种功能的机器人 2. 团队协作开发的中大型项目 3. 希望学习成熟框架设计的开发者 | 1. 小型定制化机器人开发 2. AI辅助生成代码的快速开发场景 3. 对代码有完全控制权的需求 |
方案一：NoneBot2 - 功能丰富的成熟框架
NoneBot2 是一款基于Python的现代化QQ机器人框架，采用插件化设计，支持多种通信协议，拥有活跃的社区和丰富的插件资源。
框架特点：
- 完善的插件生态：官方维护的插件商店收录了数百个功能插件，覆盖信息查询、娱乐互动、AI对话等多个领域，开发者可通过简单安装命令快速集成所需功能。
- 规范的开发流程：框架定义了清晰的项目结构和插件开发规范，利于代码管理和团队协作。
- 丰富的社区资源：拥有活跃的开发者社区，提供详细的官方文档、教程和示例代码，便于开发者学习和解决问题。
🔗 详细教程： https://www.shiro.team/posts/bot/qqbot/ 【nonebot2的简单部署】
基础搭建步骤：
- 确保环境满足要求：Python 3.8+，并安装框架创建工具
nb-cli - 使用
nb create命令初始化项目，选择通信协议（如 OneBot V11） - 部署并配置协议端（如 NapCat 或 go-cqhttp，负责与QQ服务器通信）
- 通过
nb plugin install命令安装所需插件，并根据文档进行配置 - 运行
nb run启动项目，机器人即可开始工作
方案二：Mioki - 灵活轻量的插件框架
Mioki 是基于Node.js/TypeScript开发的插件式QQ机器人框架，核心依赖NapCat作为QQ协议端，专注于提供简洁的开发体验。
框架特点：
- 简洁的代码结构：框架设计精简，核心逻辑清晰，易于理解和定制。
- 灵活的插件机制：插件开发无严格规范约束，开发者可根据需求自由实现功能逻辑。
- AI友好的开发方式：基于标准Node.js/TypeScript语法，便于AI辅助生成和修改插件代码。
🔗 详细教程： https://www.zellon.top/posts/251230-mioki/ 【Mioki Bot食用方法】
基础搭建步骤：
- 确保环境满足要求：Node.js >= 22.18.0
- 部署并运行NapCat实例，配置正向WebSocket服务器及访问令牌
- 使用
npx mioki@latest命令初始化Mioki项目（支持交互式配置） - 在
plugins目录下创建符合规范的插件文件（支持.ts或.js格式） - 运行
npm start启动项目，机器人将按插件逻辑处理消息
注意事项：
- Mioki 强依赖NapCat协议端，需确保NapCat实例正常运行
- 插件开发需具备基础的JavaScript/TypeScript编程能力
- 框架文档相对简洁，部分高级功能需参考源代码或社区经验
参考资源：
- Mioki 官方网站：https://mioki.viki.moe
- NapCat 官方文档：https://napneko.icu/
后续管理代码可以用Trae（软件）来管理，Trae是一个免费的中文IDE，支持Python、JavaScript、TypeScript等语言，提供代码自动完成、调试、版本控制等功能。