Gridea Pro 完全上手指南 —— 从写作到发布，一篇搞定

这篇指南会带你一步一步熟悉 Gridea Pro 的界面和操作，从写第一篇文章到把博客发布到互联网上。

认识界面

打开 Gridea Pro 后，你会看到左侧是导航栏，右侧是内容区域。

左侧导航从上到下依次是：

导航	说明
文章	管理你的所有博客文章
闪念	速记短想法、灵感碎片
评论	查看和管理读者评论
菜单	自定义博客的导航栏
分类	管理文章分类
标签	管理文章标签
友链	管理友情链接
主题	切换和配置博客主题
配置	设置部署平台、SEO、CDN 等

导航栏底部有两个重要按钮：「预览」 和 「同步」，后面会详细讲到。

第一步：写一篇文章

点击左侧导航的 「文章」，进入文章列表页
点击右上角的 「 + 」 按钮，会打开文章编辑器
最上方是标题输入框，下方是正文编辑区（支持 Markdown 语法）
写完内容后，点击编辑器顶部工具栏的 「纸飞机」图标，会弹出右侧的文章设置面板

在文章设置面板中，你可以配置：

URL — 文章的访问路径（默认用文件名）
分类 — 选择一个分类，或留空
标签 — 点击已有标签添加，或输入新标签后按回车创建
创建时间 — 默认是当前时间，可以手动修改
封面图 — 粘贴在线图片链接，或点击上传区域从本地选择图片
列表中隐藏 — 开启后，文章不会出现在博客的文章列表中（适合「关于」页面）
置顶文章 — 开启后，文章会固定在博客文章列表最顶部

设置完成后，点击面板底部的 「发布」 按钮保存文章。如果还没写完，可以点击编辑器顶部的 「存草稿」 先保存为草稿。

小技巧：在文章正文中插入  标记，标记之前的内容会作为文章摘要显示在博客文章列表中。你可以通过编辑器右侧的 「…」 按钮快速插入这个标记。

第二步：选择主题

点击左侧导航的 「主题」
默认进入 「选择主题」 标签页，上方展示当前使用的主题，下方展示其他可选主题
找到你喜欢的主题，点击 「使用该主题」 按钮即可切换
切换到 「基础配置」 标签页，填写你的博客名称、作者名、站点描述等信息
切换到 「个性化」 标签页，可以调整配色风格

每个主题还可能有自己的 「自定义配置」（第四个标签页），比如社交链接、布局选项等，按需设置即可。

第三步：预览效果

点击左侧导航栏底部的 「预览」 按钮。

Gridea Pro 会自动渲染整个博客站点，然后在浏览器中打开预览。你可以看到文章、主题、导航菜单等所有内容的实际效果。

每次修改文章或切换主题后，重新点击「预览」即可看到最新效果。

注意：博客不是实时渲染的，每次修改后都需要再次点击「预览」才能看到最新效果。

第四步：配置部署

现在你的博客在本地已经准备好了，接下来配置一个部署平台，把它发布到互联网上。

点击左侧导航的 「配置」
在 「平台」 下拉框中选择你要使用的部署方式

Gridea Pro 支持以下平台：

GitHub Pages（推荐新手）

免费、全球可访问，配置步骤：

在 GitHub 上创建一个新仓库（仓库名建议用 你的用户名.github.io）
前往 GitHub → Settings → Developer settings → Personal access tokens，生成一个 Token（勾选 repo 权限）
回到 Gridea Pro 的「配置」页面，填写以下信息：
- 域名：https://你的用户名.github.io
- 仓库名称：你的用户名.github.io
- 分支：main
- 仓库用户名：你的 GitHub 用户名
- 邮箱：你的 GitHub 注册邮箱
- 令牌：刚才生成的 Token
- CNAME：你购买的个人域名，如：are.ink`（可选，没有可不填）
点击 「检测远程连接」 验证配置是否正确
点击 「保存」

Gitee Pages

国内访问更快，配置方式与 GitHub 类似，需要在 Gitee 上创建仓库并生成私人令牌。

Vercel

支持自定义域名，智能增量部署。需要填写 Vercel 项目名称和 Access Token。

自定义域名（CNAME）

如果你有自己的域名（比如 blog.example.com），可以在上面的配置中填写 CNAME 字段：

在你的域名注册商的 DNS 管理后台，添加一条 CNAME 记录，将你的域名指向 你的用户名.github.io（GitHub）或对应的平台域名
回到 Gridea Pro 的「配置」页面，将 域名 改为你的自定义域名（如 https://blog.example.com）
在 CNAME 字段中填写你的自定义域名（如 blog.example.com）
保存后重新同步，GitHub Pages 会自动识别并生效

如果暂时没有自己的域名，跳过这步即可，后面随时可以配置。

第五步：发布上线

一切配置就绪后，点击左侧导航栏底部的 「同步」 按钮（火箭图标）。

按钮会显示加载动画，等待片刻，看到「同步成功啦！」的提示，说明你的博客已经发布到互联网上了。

打开浏览器，访问你在第四步填写的域名，就能看到你的博客了。

以后每次写完新文章或修改配置后，点一下「同步」就会自动更新。

提示：Gridea Pro 内置了完整的 Git 引擎，你的电脑上不需要安装 Git，填好配置信息后，点击 「同步」 按钮就可以直接发布。

彩蛋：MCP — 用 AI 管理你的博客

这是 Gridea Pro 最独特的能力之一。

Gridea Pro 内置了完整的 MCP（Model Context Protocol）服务，这意味着你可以通过 AI 助手（如 Claude Desktop、Cursor、Claude Code 等任何支持 MCP 协议的客户端）直接与你的博客对话。

你可以用自然语言让 AI 帮你：

写文章 — 「帮我写一篇关于 Vue 3 组合式 API 的入门教程，标签设为 Vue 和前端」
管理内容 — 「把所有标签为"草稿"的文章列出来」「删除上个月的测试文章」
记录闪念 — 「记一条速记：今天学会了 Go 的 channel 用法」
配置站点 — 「把博客名称改为"我的技术笔记"」「切换到 flavor-theme 主题」
发布部署 — 「渲染站点并部署到 GitHub Pages」

总共提供了 30+ 个 AI 可调用的工具，覆盖文章、标签、分类、菜单、友链、闪念、主题、设置、渲染和部署的完整管理。你不需要打开 Gridea Pro 的界面，在 AI 对话框里就能完成几乎所有操作。

配置方式很简单。以 Claude Desktop 为例，打开 Settings → Developer → Edit Config，在 mcpServers 中添加：

macOS：

{
  "mcpServers": {
    "gridea-pro": {
      "command": "/Applications/Gridea Pro.app/Contents/MacOS/gridea-pro-mcp",
      "env": {
        "SOURCE_DIR": "/Users/你的用户名/Documents/Gridea Pro"
      }
    }
  }
}

Windows：

{
  "mcpServers": {
    "gridea-pro": {
      "command": "C:\\Program Files\\Gridea Pro\\gridea-pro-mcp.exe",
      "env": {
        "SOURCE_DIR": "C:\\Users\\你的用户名\\Documents\\Gridea Pro"
      }
    }
  }
}

command — gridea-pro-mcp 二进制文件的路径
SOURCE_DIR — 你的博客数据目录路径
DEPLOY_ENABLED — 是否允许 AI 执行发布/同步操作（可选，默认关闭）

默认情况下，AI 只能帮你写文章、管理内容，不能直接发布到线上。如果你信任 AI 并希望它能帮你一键发布，在 env 中加上 "DEPLOY_ENABLED": "true" 即可开启。建议熟悉流程后再开启。

保存后重启 Claude Desktop，就可以在对话中直接管理你的博客了。它通过本地管道通信，不需要网络、不需要端口、不需要认证，数据始终在你的电脑上。

看到这里，相信你对 Gridea Pro 的使用已经有了全面的了解。

这篇指南可以随时删除。祝你博客之旅愉快！