首页 / 关于小助 / 知识库说明
知识库使用与更新(实操手册)
这个知识库是静态站点 + Markdown 源结构,更新成本极低:加一个 .md 文件,跑一条命令,部署上去即可。AI 会自动生成页面、llms.txt、sitemap.xml。
目录结构(本地 kb-source/)
kb-source/
├── build.js # 零依赖生成器(node build.js)
├── deploy.sh # 部署脚本(scp 到服务器)
├── content/ # ← 你只改这里
│ ├── 00-overview/ # 每个板块一个文件夹,前缀数字决定顺序
│ │ ├── section.json # 板块标题/图标/简介
│ │ └── *.md # 文档(第一行 # 标题)
│ ├── 01-member-marketing/
│ └── ...
└── dist/ # 生成结果(部署用,勿手改)build.js 真实机制(不是黑箱)
- 零依赖:只用 Node 内置
fs/path,不需要npm install - Markdown → 预渲染 HTML:
mdToHtml()支持标题 / 表格 / 列表 / 代码块 / 引用 / 加粗 / 链接 - GEO 产物:自动生成
index.html/llms.txt/llms-full.txt/sitemap.xml/robots.txt - 保留基线:现有
/chapter/15 章 GEO 课程从基线dist/chapter保留,不覆盖 - JSON-LD + ai-scraper:allow:每页带结构化数据与 AI 抓取放行
怎么加一篇新内容(3 步)
- 在对应板块文件夹下新建
xx-标题.md,第一行写# 文档标题 - 下面正常写 Markdown(支持标题/表格/列表/代码/引用/链接)
- 终端执行:
cd kb-source
node build.js # 生成 dist/
bash deploy.sh # 部署到 geo.memberhandbook.cn- 打开
https://geo.memberhandbook.cn验证
没有板块?新建一个
mkdir content/14-your-topic
echo '{"title":"你的板块","icon":"🚀","desc":"一句话简介"}' > content/14-your-topic/section.json
# 然后往里放 .md设计原则(给 AI 协作时参考)
- 预渲染纯 HTML:每个页面是完整静态 HTML,AI 爬虫直接读正文(不是 JS 空壳)
- GEO 友好:每页带
llms.txt入口、robots.txt放行 AI 爬虫、og-image、JSON-LD - 手机端优先:CSS 单文件内联,无外部依赖,窄屏自适应
- 零依赖:生成器只用 Node 内置模块,不需要
npm install
想让我(小助/AI)帮忙更新?直接说"把 XX 案例加进知识库",我会写好 .md、构建并部署。