📚 同福客栈知识库 wiki 部署指南 · 发布公告

静态站点,纯前端,后端只需要能 serve 静态文件即可。

🟢 本地(已默认在跑)

服务器已经在后台跑着了,地址:

http://127.0.0.1:8765/

控制命令(在项目根目录打开 PowerShell):

.\wiki-server.ps1 start    # 启动 (后台)
.\wiki-server.ps1 stop     # 停止
.\wiki-server.ps1 status   # 状态
.\wiki-server.ps1 restart  # 重启
.\wiki-server.ps1 open     # 在默认浏览器打开主页

⚠️ python 别用 store alias,要用 C:\Users\xjf\AppData\Local\Programs\Python\Python311\python.exe(已硬编码)。

🔄 增量更新

& "C:\Users\xjf\AppData\Local\Programs\Python\Python311\python.exe" "E:\同福客栈挂机游戏\scripts\docs-to-html\build.py"

输出(每次):

✅ 395 MD + 20 HTML, 32 分类, 26 标签, 7.96 MB
🔄 nav.js 已自动同步 CATEGORY_META(32 个分类)

🚀 公网部署(任选)

docs-site/ 整个目录是部署单元。以下 3 个 zero-config 选项:

方案 A — GitHub Pages(免费,推荐)

新建一个空 repo(比如 tongfu-wiki),只 push docs-site/ 内容,根为 index.html
Settings → Pages → Branch: main / (root) → Save
3 分钟后 https://<user>.github.io/tongfu-wiki/

方案 B — Cloudflare Pages(免费,国内可访问性最好)

登录 https://dash.cloudflare.com → Pages → Connect to Git
选 repo → Build settings:
- Build command: 留空
- Build output directory: docs-site(根目录是仓库根的话)
- Root directory: /(空)
Deploy

方案 C — 任何 Nginx/Caddy/Apache

把 docs-site/ 当静态根目录就行,不用任何路由配置(因为我们走的是 ?cat= 参数不是 hash)。

🛠️ 故障速查