从0到1用Notion AutoPoster搭自动更新的免费轻量个人知识付费课程展示站

一、准备前置资源

这一步所有工具和账号均免费，无需付费升级：

• Notion账号：https://www.notion.so/ 注册并实名认证（可选但建议，防风控）
• Gitee Pages账号：https://gitee.com/ 注册并实名认证（必须，国内访问快）
• AutoPoster项目：直接访问Fork后的稳定国内镜像 https://gitee.com/chenjiandongx/notion-auto-poster/fork，点击右上角“Fork”按钮复制到自己仓库
• Git工具：Windows用户下载 https://git-scm.com/download/win，默认勾选所有安装选项完成；Mac/Linux用户无需下载，系统自带

二、配置Notion数据库与API

2.1 创建Notion专属课程数据库

打开Notion，点击左侧「+新建页面」，输入“知识付费课程库”，然后：

1. 点击页面空白处输入“/database inline”，选择「数据库-内联」
2. 修改默认数据库名为“在售课程”，删除默认属性（除「标题」）
3. 添加以下必填属性：
   • 状态：属性类型选「状态」，预设状态改为「草稿」「上架」「下架」
   • 课程链接：属性类型选「URL」
   • 封面图：属性类型选「文件与媒体」
   • 课程简介：属性类型选「文本」
   • 标签：属性类型选「多选」，可预设「编程」「写作」「运营」等
   • 上架时间：属性类型选「日期」，自动生成或手动选
4. 点击数据库右上角「...」→「复制链接」，备用

2.2 获取Notion API集成密钥

1. 访问 https://www.notion.so/my-integrations，点击「+新建集成」
2. 填写「集成名称」为“课程站自动同步”，选择关联的Notion工作区（选你的个人工作区）
3. 权限设置只勾选「内容能力」→「读取内容」，点击「提交」
4. 在集成详情页复制「内部集成令牌」，格式是secret_开头的字符串，保存到记事本，不要泄露

2.3 授权集成访问课程数据库

回到Notion的「知识付费课程库」页面：

1. 点击页面右上角「...」→「添加连接」
2. 搜索刚才创建的“课程站自动同步”，点击确认授权

三、配置Gitee仓库与AutoPoster

3.1 克隆仓库到本地

打开Git Bash（Windows）或终端（Mac/Linux），依次执行以下命令：

• Windows用户先设置工作目录（比如桌面）：cd Desktop
• 克隆你的Fork仓库：git clone https://gitee.com/你的Gitee用户名/notion-auto-poster.git（把“你的Gitee用户名”替换成真实的）
• 进入仓库目录：cd notion-auto-poster

3.2 修改配置文件

用记事本或VS Code打开仓库根目录下的config.yaml，删除所有内容，粘贴以下完整配置：

 Notion配置
notion:
token: "secret_你的Notion内部集成令牌"
database_url: "https://www.notion.so/你的课程库数据库链接ID"
站点配置
site:
title: "我的知识付费课程站"
description: "分享实用干货课程"
keywords: "知识付费,干货课程"
url: "https://你的Gitee用户名.gitee.io/notion-auto-poster"
author: "你的名字"
theme: "next"
filter:
status: ["上架"]  只同步上架状态的课程
Gitee Pages部署配置（不需要本地Git提交，AutoPoster自动触发）
deploy:
provider: gitee
repo: "你的Gitee用户名/notion-auto-poster"
branch: "gh-pages"  固定gh-pages分支
token: "你的Gitee私人令牌"

注意替换以下3个加粗占位符：

• secret_你的Notion内部集成令牌：粘贴2.2节的secret开头的字符串
• 你的课程库数据库链接ID：把2.1节复制的数据库链接最后面的“?v=...”去掉，剩下的32位/36位字符就是ID
• 你的Gitee私人令牌：获取方法见3.3节

3.3 获取Gitee私人令牌

1. 访问 https://gitee.com/profile/personal_access_tokens
2. 点击「+生成新令牌」，填写「令牌描述」为“自动部署课程站”
3. 权限只勾选「projects」→「projects (读写)」和「pull_requests」→「pull_requests (读写)」，点击「提交」
4. 复制生成的令牌（只显示一次，必须立刻保存到记事本）

四、本地生成测试页面

测试一下配置是否正确：

• Windows用户在仓库根目录右键→「Git Bash Here」，依次执行：

  pip install -r requirements.txt
  python main.py
  

• Mac用户（需先安装Homebrew https://brew.sh/）依次执行：

  brew install python3
  pip3 install -r requirements.txt
  python3 main.py
  

执行成功后，仓库根目录会生成public文件夹，里面是完整的静态页面，双击index.html即可预览。

五、开启自动同步与部署

5.1 本地提交修改后的配置

Git Bash/终端中依次执行：

git add config.yaml
git commit -m "配置课程站参数"
git push origin master

输入Gitee的账号密码完成提交。

5.2 配置Gitee Pages自动触发

1. 访问你的Gitee仓库「设置」→「WebHooks」，点击「+添加WebHook」
2. 填写「URL」为：https://你的Gitee用户名-notion-auto-poster.hf.space/webhook（后面再补HF的步骤）
3. 填写「密码」为你自己设置的任意字符串（比如mypassword123），保存备用
4. 只勾选「Push」触发事件，点击「添加」

5.3 用Hugging Face Spaces托管AutoPoster同步脚本

HF Spaces是免费的Python托管平台，负责监听Notion数据库变化并自动部署：

1. 访问 https://huggingface.co/join，注册并登录HF账号
2. 访问 https://huggingface.co/spaces/chenjiandongx/notion-auto-poster-server，点击「Duplicate this Space」
3. 填写「Space name」为「notion-auto-poster」，选择「Public」或「Private」（建议Private），点击「Duplicate Space」
4. 等待Space创建完成（约1分钟），进入Space「Settings」→「Secrets and variables」→「Repository secrets」，添加以下4个密钥：
   • Name：NOTION_TOKEN，Value：你的Notion内部集成令牌
   • Name：DATABASE_URL，Value：你的课程库数据库链接ID
   • Name：GITEE_TOKEN，Value：你的Gitee私人令牌
   • Name：WEBHOOK_SECRET，Value：5.2节设置的WebHook密码
5. 复制Space的URL（格式是https://你的HF用户名-notion-auto-poster.hf.space），替换5.2节WebHook的URL中的占位符，重新保存WebHook

六、后续维护与课程发布

6.1 发布/更新课程

直接在Notion的「在售课程」数据库中：

• 添加新行，填写必填属性，状态设为「上架」
• 修改已有课程的任意属性
• 操作完成后，HF Spaces会自动触发同步，Gitee Pages会在1-2分钟内更新（国内快）

6.2 修改站点主题与样式

仓库根目录的themes文件夹有默认的next主题，你可以直接修改里面的CSS/HTML文件，提交后自动生效。