AI 面试知识库

深色模式

发布与使用指南 ​

目标闭环：Obsidian 本地编辑 → 发布 → 手机浏览器随时学习（无电脑场景：通勤、碎片时间）。

当前状态：已上线 ✅ ​

  • 生产网址：https://ai-interview-kb.pages.dev （手机浏览器「添加到主屏幕」即可当 App 用，站点自带全文搜索）
  • 托管：Cloudflare Pages，项目名 ai-interview-kb，wrangler 直发（无 GitHub 依赖）
  • Account ID：f6f863bd88ce72317ccec8121d1abfb0

日常更新流程 ​

  1. 在 Obsidian 里编辑 AI Study KB/ 下的 Markdown（遵守首页的全局约定）。
  2. 新增文章后，在 AI Study KB/.vitepress/config.mjs 的 sidebar 补一条链接。
  3. 部署（三选一）：
    • 一键脚本（推荐）：在项目根目录右键 → Git Bash Here → ./deploy.sh。凭据从 .env.deploy 自动读取（该文件被 git 忽略），无需每次设环境变量。
    • 最省事：直接让 WorkBuddy「重新部署一下」，它会执行构建+发布。
    • 手动命令：设好 CLOUDFLARE_API_TOKEN / CLOUDFLARE_ACCOUNT_ID 环境变量后 npm run deploy。

npm run deploy = 构建（vitepress build）+ 发布（wrangler pages deploy），一条命令搞定。

Token 安全（重要） ​

  • API Token 不写进任何文件（package.json、文档、git 都不放），只在环境变量里用。
  • Token 可随时在 Cloudflare 后台吊销：My Profile → API Tokens → 找到后 Delete。吊销后重新生成一个即可，部署命令不变。
  • 如果 token 给过 AI 助手且不想保留其长期访问权，用完后吊销即可。

可选升级：GitHub + Pages 自动发布 ​

当前 wrangler 直发已够用。若以后想要「push 即自动发布 + 云端版本备份」：建 GitHub 仓库 push 上去 → Cloudflare Pages 里 Connect to Git → 框架选 VitePress、构建命令 npm run build、输出目录 AI Study KB/.vitepress/dist、环境变量 NODE_VERSION=22。本地 git 仓库已初始化（main 分支），随时可以推。

本机环境备忘（排坑记录，重装依赖前先读） ​

  • wrangler 必须用 npm i -D wrangler --ignore-scripts 安装——本机安全软件会让 esbuild 的安装脚本必现 spawnSync node.exe EBUSY，跳过脚本不影响运行（平台二进制是独立可选包）。
  • rollup/esbuild 的 Windows 原生包已写入 optionalDependencies（@rollup/rollup-win32-x64-msvc、@esbuild/win32-x64）。不要用 --no-save 补装——下次 npm install 会被当作冗余包清掉，构建立刻报 Cannot find module '@rollup/rollup-win32-x64-msvc'。
  • VitePress 配置里 vite.build.emptyOutDir=false 不能删——本机 safe-delete 钩子会拦截构建前清空 dist 的操作导致构建失败，改为增量覆盖。
  • WorkBuddy 沙箱对部分域名有网络限制，但 Cloudflare API 与本机浏览器访问均正常。