浏览器速记无需配置 · 发布自己的题库约 5~10 分钟

建立自己的大模型面经

只想先记题或练习时,直接使用网站表单,不需要后台、Markdown 或 GitHub 登录。选择“私人”后,题目会在同一题库中标注“私人”,只存在当前浏览器;选择“公开”并保存后,题目会直接进入共享题库,不创建 Issue,也不经过人工审核。要建立自己的站点或多人维护时,再创建仓库并连接 Pages CMS。

先记录、以后再创建自己的站点? 选择“私人”的题目和面试记录都按网站、仓库标识和浏览器分别保存。切换到自己的公开站点前,先分别导出两份 JSON,再到新站点恢复。Private 仓库不会部署这些浏览器页面;可以继续使用当前公开站点,或在自己的电脑上本地预览,但本机数据不会自动写入 Private 仓库。

不要把两种“公开 / 私有”混在一起。 增加单道题时,在网站表单里选择“公开 / 私人”;创建整个仓库时,才在 GitHub 的“Create a new repository”页面选择 Public / Private。Pages CMS 不能修改仓库可见性。

先确认你需要哪种模式

已经选好模式?
创建独立题库时使用基础模板,可以选择 Public 或 Private;如果要参与当前公开题库,用 Fork 保留当前内容并提交贡献。

1. 从模板创建仓库

1

打开模板

点击上方按钮进入 GitHub,然后选择 Use this template → Create a new repository。

没有 Use this template? 优先点击仓库顶部的“generated from”来源;仓库主人也可以在 Settings → General 中开启 Template repository。

模板和 Fork 的区别:模板用于建立完全独立的个人题库,可选择 Public 或 Private;Fork 会复制当前公开仓库并保留关联,适合投稿和跟进当前项目,但 Fork 仍是 Public。二次定制站点若没有开启 Template,基础模板按钮不会包含该站点后来新增的内容。

GitHub 仓库页面中 Use this template 按钮的位置示意图
图 1:Use this template 的位置。点击图片查看大图。

2. 在创建页选择公开或私有

2

填写仓库信息

选择自己的 Owner,填写 Repository name,再到 Visibility 选择:

  • 想发布阅读网页:选择 Public。
  • 只想自己或受邀者查看:选择 Private。

最后点击 Create repository。

GitHub 创建仓库表单中 Public 和 Private 选项的位置示意图
图 2:公开 / 私有就在 Visibility 中选择。点击查看大图。

3. 只展开你选择的模式

Public公开题库:启用阅读网页展开步骤
  1. 打开新仓库的 Settings → Pages。
  2. 在 Build and deployment → Source 选择 GitHub Actions。项目已经包含工作流,不要再点击 Jekyll 或 Static HTML 的 Configure。
  3. 进入 Actions → 内容检查与网站发布 → Run workflow,Branch 选择仓库默认分支(通常是 main),手动运行第一次部署。
  4. 工作流变为绿色后,回到 Settings → Pages 点击 Visit site。
  5. 如果只自己记私人题,到这里即可;如果要让任何人都能在网页直接发布公开题,再完成一次[共享题目服务设置](/llm/questions/setup/)。以后发布者不需要 GitHub 登录或 Issue。
  6. 如果要开放题下评论,把 COMMENTS_API_URL 设为第五步中同一个 Worker 根网址;不需要再部署第二套服务。
GitHub Settings Pages 中选择 GitHub Actions 的操作示意图
图 3:这张图只适用于公开题库。点击查看大图。

共享服务只需要题库主人配置一次。完成后,访客选择“公开”并保存,题目会立即出现在题库;仓库内置核验题仍由 Pages CMS 管理。

Private私有题库:跳过 Pages展开步骤
  1. 不要启用 GitHub Pages,直接继续连接 Pages CMS。
  2. 需要共同编辑时,在 GitHub 仓库中邀请协作者,并在 Pages CMS 中补充仓库授权。
  3. 每次保存会先更新私有仓库,再执行内容校验,不会部署公开网页。

Private repository 不等于 private Pages。 真正带访问控制的私有 Pages 主要面向 GitHub Enterprise Cloud;机密内容不要发布到 Pages。Private / Internal 题库不要启用公共匿名评论,关闭评论也不能替代仓库和网站本身的访问控制。

两种模式从这里汇合:接下来都使用 Pages CMS 可视化编辑题目。

4. 连接可视化管理后台

4

登录并只授权题库

  1. 打开 Pages CMS,点击 Sign in with GitHub。
  2. 点击 Install GitHub App。
  3. 选择 Only select repositories。
  4. 只选择刚创建的题库仓库,再点 Install。

第三方权限说明:Pages CMS 获得授权后可以读取和修改所选仓库,并缓存项目配置与内容。Private 仓库内容也会经过该服务。以后可在 GitHub 的 Settings → Applications → Installed GitHub Apps 中复查、缩小或撤销权限;不想授权时,也可以在 GitHub 网页中复制 docs/_templates/question.md 手动编辑。

Pages CMS 登录和 Only select repositories 授权操作示意图
图 4:只授权题库仓库,减少不必要的权限。点击查看大图。

5. 新增第一道题

5

填表并保存

  1. 在 Pages CMS 的 Open a project 中打开仓库和默认分支(通常是 main)。
  2. 进入“面试题与解答”,点击 Add an entry(手机端显示 +)。
  3. 第一次可以只填写面试题目;日期会自动使用本地当天,答案可以稍后补。
  4. 使用 Private 仓库个人保存,或在 Public 仓库暂不展示:保持“在阅读网站显示这道题”关闭。想先公开问题:最后再打开它,并让“答案状态”保持待解答。
  5. 点击 Save(手机端是软盘图标)。待解答题只显示问题,不展示半成品,也不会进入模拟面试。
  6. 答案完成后,把分类和难度改为正式值、复习状态改为“待复习”或“已掌握”,再把答案状态改成已完成并保存。

使用 AI 补答案:Codex 打开你自己的题库仓库并拥有工作区写权限后,可以直接修改对应文件;要继续同步 GitHub,还必须已经完成 GitHub 身份验证,并对远端仓库有写权限。使用普通 AI,或任一条件不满足时,请先让 AI 生成答案,再把内容粘贴回 Pages CMS,手动修改答案状态并保存。

注意:未发布只代表不在阅读网站显示。Public 仓库中的草稿源文件仍然公开;Private 只适合普通个人非公开笔记。公司机密、未授权题库或受 NDA 约束的内容不要上传到 GitHub。

Pages CMS 打开网站显示开关、让答案保持待解答并点击 Save 的表单示意图
图 5:先记题目就能保存;发布开关控制题目是否可见,答案状态控制题解是否展示。点击查看大图。
GitHub Actions 内容校验、构建和部署成功示意图
图 6:公开模式会继续部署网页;私有模式只校验并保存内容。点击查看大图。
配置完成后

以后按需要走五条日常路径

现场记题:在“+题目”只填问题或继续记录追问,保存前选择“私人”或“公开”。只留给自己:私人题会在同一题库中标注“私人”,只存在当前浏览器。让别人也能看:选择“公开”后登录 GitHub 完成最终确认,题目会自动发布。内容纠错:使用题目页底部的反馈入口,题库主人通过网页管理入口直接修改。真实面试:记录公司、轮次、结果和复盘,需要分享时再做匿名检查。个人仓库速记:使用 Private 仓库。准备复习:先看学习分级说明,从“核心必会”开始,再按目标岗位和分类随机抽题。

直接在网页记题 记录一次真实面试 查看匿名面经发布步骤 查看记题流程 开始模拟面试

记录与公开是两件事。 公司、轮次、结果和个人复盘默认只保存在当前浏览器。只有经过匿名化整理、确认不含隐私或受限内容,并且你明确打开发布开关的面经或题目,才应公开。即使关闭发布开关,Public 仓库中的源文件仍然可见。

已有仓库想改变模式

Private → Public

  1. 在 Settings → General → Danger Zone 修改 Visibility。
  2. 按上面的公开流程启用 Pages。
  3. 手动运行一次部署工作流。
  4. 模板副本不会复制原仓库的 Worker 或变量;需要评论时只连接自己的服务。

Public → Private

  1. 先在 Settings → Pages 停止发布并确认网站下线。
  2. 确认 Pages CMS“站点设置”中的题目评论仍为关闭,并移除任何旧的外部服务配置。
  3. 再到 Danger Zone 修改 Visibility。
  4. 已经公开过的内容可能仍有缓存,不能当作从未公开。

常见问题

打开公开仓库配置自检

看到的状态 代表什么 下一步
Actions 没有任何运行 工作流未触发,或仓库禁用了 Actions 确认选择了仓库默认分支,并在 Settings → Actions 中允许 Actions
灰色 / Skipped Private 模式正常跳过公开构建和部署 只要“检查内容”绿色即可;Private 本来就没有公开网站
“检查内容”红色 文件已经保存到 GitHub,但本次没有发布 展开失败步骤,按日志最后的中文提示修改,然后再次 Save
“发布公开网站”红色 Pages 设置或发布权限不正确 确认 Settings → Pages → Source 已选择 GitHub Actions
全部绿色但网页暂时 404 GitHub Pages 仍在生效,或打开的网址不完整 等几分钟,从 Settings → Pages 的 Visit site 进入
全部绿色但仍是旧内容 浏览器缓存,或看的不是最新一次运行 强制刷新,并确认最新运行对应刚才的提交

如果误传了密码、Token 或密钥:先立即去对应服务撤销或轮换,再处理 GitHub 历史。删除文件、关闭发布开关或新增修正提交,都不能让旧凭据重新安全,也不能自动清除 Git 历史。