KNOWLEDGE NOTE / programming

个人网站项目面试题与参考答案

创建
2026年11月20日
更新
2026年11月20日

个人网站项目面试题与参考答案

适用岗位:AI(人工智能)应用开发工程师。根据项目本地代码和文档整理,参考回答帮助你理解和练习,不代表每部分都是你独立设计或手写的。请按自己的实际参与程度回答;线上部署、定时任务和测试结果要以实际核实情况为准。

一、项目介绍与个人贡献

1. 请用一分钟介绍这个项目。

**参考回答:**这是一个个人网站和内容管理平台,用于展示个人项目、工具、AI 新闻和学习笔记。我使用 Next.js、React 和 TypeScript 搭建应用,使用 Supabase 存储项目、工具和新闻,并实现管理员登录与后台管理。知识库从 Obsidian 笔记的 Git 仓库读取固定版本的 Markdown 文件,按游客和管理员身份控制可见范围。开发过程中我结合 AI 编程工具完成需求拆分、编码和问题排查,再通过阅读代码、运行检查和实际操作验证结果。

代码依据:README.md、package.json、lib/knowledge/。

2. 为什么做这个项目?

**参考回答:**我希望把个人作品、常用工具和学习资料集中管理,也给面试官提供一个了解我项目的入口。后台管理让我不必每次更新内容都修改页面代码;知识库则可以继续使用熟悉的 Obsidian 编辑,再把适合公开的笔记展示到网站。

3. 你用了 AI 编程工具,个人贡献是什么?

**参考回答:**这是我的个人实践,我负责提出需求、确定功能、使用 AI 编程工具辅助实现,并检查和调整结果。面试时我会选自己真正参与的模块,说明当时提出了什么要求、怎样检查代码、遇到什么问题以及如何验证。对于还不能独立解释的部分,我会坦诚说明借助了 AI,正在学习原理。

**准备建议:**提前整理两个自己真实处理过的问题。不要把 AI 生成的所有代码说成自己独立设计,也不要虚构测试结果。

4. 这个项目和 AI 应用开发岗位有什么关系?

**参考回答:**网站主要体现应用开发和工程能力,包括内容管理、认证授权、知识库处理和部署;它本身不是大模型问答系统。网站提供其他 AI 项目的介绍入口,知识库的内容解析和权限控制也帮助我理解 AI 应用的数据准备与安全边界。要接入智能问答,还需要另行实现检索、模型调用和效果评估。

二、技术选型与架构

5. 为什么选择 Next.js?

**参考回答:**网站同时有公开页面、后台和服务端数据访问。Next.js 的 App Router(应用路由)能够按目录组织页面,支持服务端组件和服务端操作,让我在同一项目中管理页面、读取数据和处理表单。它降低了个人项目集成成本,但权限、缓存和错误仍然需要认真设计。

6. 服务端组件和客户端组件有什么区别?

**参考回答:**服务端组件在服务器执行,适合读取数据、处理服务端依赖和生成初始页面;客户端组件在浏览器运行,适合输入、交互状态和事件处理。项目按需要组合两者。服务端组件并不自动保证数据安全,敏感数据依然要在读取前授权。

7. 什么是 Server Action(服务端操作)?为什么隐藏按钮还不够?

**参考回答:**服务端操作是在服务器执行、可由表单或客户端交互触发的函数。项目用它处理登录、保存和删除等操作。隐藏按钮只是界面效果,别人仍可能直接构造请求,所以写操作要在服务端重新验证管理员身份、校验输入,并通过数据库策略控制访问。

代码依据:app/auth/actions.ts、app/admin/tools/actions.ts。

8. 项目代码如何组织?

参考回答:app 组织路由、页面和服务端操作;components 存放展示和交互组件;lib 存放认证、数据访问和知识库解析;supabase/migrations 记录数据库结构与权限变化。数据访问尽量集中在 repository(数据访问模块),减少页面重复拼接查询。

三、登录、授权和数据库

9. 管理员登录是怎样实现的?

**参考回答:**登录表单提交到服务端操作,由 Supabase Auth(身份认证服务)验证邮箱和密码。认证成功后,还要把用户 ID(身份标识)与服务器配置的管理员 ID 比较;不是管理员就清理本次会话。敏感操作还会重新检查身份,不只依赖进入后台时的检查。

代码依据:app/auth/actions.ts、lib/auth/admin.ts。

10. 认证和授权有什么区别?

**参考回答:**认证解决“你是谁”,例如通过账号密码确认身份;授权解决“你能做什么”。在这个项目中,登录成功不自动代表拥有后台管理权限,还需要管理员身份检查和数据库策略。

11. 服务端如何确认当前用户?

**参考回答:**敏感操作通过服务端 Supabase 客户端调用 getUser(),向认证服务确认用户,再检查管理员 ID。公开导航等分支使用 getClaims() 检查会话声明。不能直接信任前端传入的“我是管理员”参数;认证服务异常也不能当成登录成功。

代码依据:lib/auth/admin.ts。

12. 为什么既要服务端鉴权,也要 RLS(数据库行级安全策略)?

**参考回答:**服务端鉴权在应用入口拒绝未授权操作,并提供清晰的错误反馈;RLS 在数据库层限制身份可读写的数据,形成另一道保护。数据库策略不能替代表单校验和业务提示,前端隐藏按钮也不能替代服务端与数据库控制。

**注意:**部分迁移策略绑定具体管理员 ID,部署到其他环境时,服务端管理员配置与数据库策略必须保持一致。

13. 浏览器可以看到的 Supabase 密钥是否安全?

参考回答:NEXT_PUBLIC_ 开头的配置会暴露给浏览器,公开密钥不能当成密码或授权依据;数据安全依赖数据库授权和 RLS。高权限 service_role 密钥可以绕过行级安全,新闻采集部署文档要求将它放在服务器受限环境中,不能放进浏览器代码或提交仓库。

代码依据:.env.example、ops/news-collector/README.md、supabase/migrations/。

14. Cookie(浏览器会话数据)在项目中起什么作用?

**参考回答:**Cookie 随请求传递登录会话,让服务端识别当前用户。项目通过 Supabase 服务端客户端读取会话,登录和退出操作需要写入 Cookie,代理逻辑负责相关请求的会话同步。敏感操作仍要单独鉴权,不能因为有 Cookie 就认为是管理员。

代码依据:lib/supabase/server.ts、lib/supabase/proxy.ts、proxy.ts。

15. 游客可见性、发布状态和项目进度有什么区别?

**参考回答:**发布状态决定内容是否发布,游客可见性决定未登录用户能否看到相关内容,项目进度表示项目处于什么阶段。它们表达不同业务含义,分开设计可以避免一个字段同时承担多种职责。实际访问还受查询条件和数据库策略约束。

16. 如何防止两个编辑操作互相覆盖?

**参考回答:**工具编辑和删除请求携带原记录的 updated_at(更新时间),数据库操作同时匹配记录 ID 和版本。如果记录已经变化,就提示刷新核对,而不是直接覆盖。这种“提交时检查版本”的做法叫乐观并发控制。

**边界:**批量修改游客可见性是逐条执行的;中途失败时,前面已修改的记录可能不会回滚,不能说它是一个事务。

代码依据:app/admin/tools/actions.ts。

17. 什么是数据库迁移?

**参考回答:**迁移文件按顺序记录数据库表、字段和权限的变化,让不同环境能够应用相同变更。已经应用过的旧迁移如果直接修改,旧环境可能不会重新执行,造成环境不一致,因此新变化应新增迁移,并同步相关类型和文档。

四、知识库:值得深入准备的部分

18. 知识库从哪里读取数据?

**参考回答:**笔记先在 Obsidian 中编辑并提交到 Git(版本管理)仓库;服务器同步脚本获取远程更新并只允许快进合并。网站读取本地仓库的当前提交,解析 notes/ 下的 Markdown(轻量标记文档)和元数据,再按身份筛选,提供搜索、列表、详情和附件。后台刷新是重新读取本地仓库,不等同于执行远程拉取。

代码依据:ops/obsidian-sync/update-obsidian-vault.sh、lib/knowledge/git-source.ts、lib/knowledge/snapshot.ts。

19. 为什么从 Git 固定提交读取,而不是直接读工作目录?

**参考回答:**构建一次知识库快照时先确定提交号,再从同一个提交读取全部文件。这样编辑或同步过程中不会把不同时间的内容混在一起,也只展示已提交内容。代价是未提交的修改不会显示;笔记数量大时,逐个读取也会产生额外开销。

20. 服务器同步怎样避免误覆盖?

**参考回答:**脚本先检查目标目录是否为 Git 仓库,发现本地修改或未跟踪文件就停止;更新时使用 fetch 获取远端内容,再通过 merge --ff-only 只允许快进合并。出现冲突或异常需要检查原因,不应直接强制重置。

**注意:**脚本存在不等于线上定时同步已启用,需要实际核实。

21. 快照读取如何处理并发和失败?

**参考回答:**快照包含提交版本、分类、笔记和诊断信息。代码按提交复用成功快照,合并同一版本正在进行的构建,并把文件读取并发限制为 4,减少瞬间创建过多 Git 进程。读取新版本失败时,已有成功快照就继续使用旧版本并记录错误;首次读取就失败则报错。代码还通过请求代次防止过期构建覆盖较新的共享状态。

**边界:**不要声称每个请求都一定返回最新版本;刷新进行中有请求可能先拿到旧快照。

代码依据:lib/knowledge/snapshot.ts、tests/knowledge/snapshot.test.ts。

22. 笔记有哪些元数据?为什么要校验?

**参考回答:**Frontmatter(正文前的元数据区域)记录标题、唯一标识、公开或私密、发布或草稿、标签和日期。代码检查必填字段、标识格式、日期是否合法,以及更新时间不能早于创建时间。格式错误会生成诊断信息;重复标识的笔记被排除并报告,避免页面指向不确定内容。

代码依据:lib/knowledge/frontmatter.ts、lib/knowledge/snapshot.ts。

23. 如何防止私密笔记泄露?

**参考回答:**权限判断放在服务端:游客只能读取既公开又已发布的笔记,管理员可以读取私密和草稿。搜索、导航、分类和统计应基于过滤后的集合生成,避免标题、数量或标签泄露。详情与附件也需要检查权限;无权访问和不存在都返回未找到,减少对内容是否存在的暴露。

代码依据:lib/knowledge/access.ts、lib/knowledge/repository.ts、app/knowledge-assets/。

24. 为什么私密笔记附件不能直接放到公开目录?

**参考回答:**如果附件直接作为公开静态文件提供,用户可能绕过笔记页面,用地址直接访问。项目通过附件路由和笔记可见性控制访问,同时校验仓库路径,拒绝绝对路径、反斜杠和 .. 等不安全形式。不能只依靠猜不到文件名来保护附件。

代码依据:app/knowledge-assets/[slug]/[...path]/route.ts、lib/knowledge/asset-policy.ts、lib/knowledge/git-source.ts。

25. 这里的搜索是向量检索或 RAG(检索增强生成)吗?

**参考回答:**不是。当前个人网站知识库对标题、描述、标签和正文进行规范化文本匹配,再筛选、排序和分页;这一模块没有用嵌入模型生成向量,也没有把检索结果交给大模型生成回答。我的另一个 AI 知识库问答项目需要单独介绍,不能把两个项目混在一起。

代码依据:lib/knowledge/query.ts。

26. 如何把现有知识库升级成 RAG?

**参考回答:**这是后续设计:基于固定 Git 版本解析笔记、切分正文,并保留笔记标识、版本和访问权限;生成向量并建立索引。提问时先确认身份,再限制检索范围,把检索结果和来源提供给模型生成回答,并展示引用。还需要处理增量更新、删除同步、效果评估和越权测试。不能只在页面层过滤权限。

27. Markdown 展示有哪些安全问题?

**参考回答:**项目使用 react-markdown 和 rehype-sanitize(内容清洗工具)等处理内容。对于外部或可编辑内容,需要限制危险 HTML、脚本、链接协议和附件路径,降低跨站脚本等风险;Markdown 并非天然安全。

代码依据:components/knowledge/KnowledgeMarkdown.tsx。

28. 什么是正向链接和反向链接?

**参考回答:**正向链接表示当前笔记指向其他哪篇笔记,反向链接表示哪些笔记指向当前笔记。项目解析链接建立关联;向游客展示关联项时还要按权限过滤,避免泄露私密笔记标题。失效链接提示主要供管理员查看。

代码依据:lib/knowledge/relations.ts、lib/knowledge/access.ts。

五、新闻采集和后台管理

29. AI 新闻从哪里来?是大模型生成的吗?

**参考回答:**项目从 RSS/Atom(内容订阅格式)新闻源采集标题、链接和时间等,按规则筛选、分类后写入数据库,再由页面读取。分类主要靠标题关键词匹配,不能说成大模型理解或自主生成新闻;项目也提供管理员手动采集入口。

代码依据:ops/news-collector/collect-news.mjs、app/admin/news/actions.ts。

30. 如何避免重复新闻?

**参考回答:**采集时根据来源链接去重,也会查询数据库中已有的链接,避免重复插入。按链接去重不能识别所有“不同网址但内容相同”的新闻;还要关注来源不可用、网络失败和采集日志。

代码依据:ops/news-collector/news-workflow.mjs、ops/news-collector/collect-news.mjs。

31. 定时新闻采集如何运行?

**参考回答:**仓库提供 systemd(系统服务管理器)的服务与定时器配置,并有配置和查看日志的文档。代码存在不代表线上定时任务正在运行;实际是否启用以及最近是否成功,需要检查服务器状态和日志。

32. 后台支持哪些功能?

**参考回答:**后台支持项目、工具和工具分类的新增、编辑、删除,以及游客可见性设置,也能查看知识库状态。表单处理字段校验、提交状态和未保存提醒;服务端写入还要进行身份、参数和版本检查。

六、部署、测试和故障处理

33. 项目怎样部署?

**参考回答:**仓库提供 Linux 服务器部署脚本和 GitHub Actions(自动化工作流)配置。设计流程是在指定分支更新或手动触发后,通过校验服务器身份的 SSH(安全远程连接)传递代码,再检查工作区和更新条件、安装依赖、构建、重启服务并进行本机健康检查。是否在线上启用需要结合工作流记录和服务器状态确认。

代码依据:.github/workflows/deploy.yml、ops/deploy/README.md、ops/deploy/。

34. 为什么要验证 SSH 主机密钥?

**参考回答:**服务器需要验证连接者身份,连接者也需要确认服务器身份。部署配置使用可信主机公钥进行严格校验,防止连接到冒充的服务器。首次获取公钥时还要通过可信渠道核对指纹,不能只因为扫描到就直接信任。

35. 当前部署方案有什么不足?

**参考回答:**文档说明当前方案在现有服务器目录构建,更新时可能短暂影响可用性;它没有提供零停机切换或自动回滚。健康检查失败需要结合日志人工排查。后续可以考虑独立发布目录、健康检查后切换和保留上一版本,但这些是改进方向。

36. 你如何验证项目?

**参考回答:**项目配置了 ESLint(代码规范检查)、TypeScript 类型检查和生产构建,也有知识库解析、权限、附件、快照等测试,以及新闻和部署相关测试。交互还需结合浏览器人工验证。面试时我只会说自己实际运行过哪些检查及其结果,不能因为仓库里有测试就说全部通过。

代码依据:package.json、tests/knowledge/、tests/news/、tests/deploy/。

37. 数据库不可用时怎样排查?

**参考回答:**先确认影响范围,是所有页面还是某类查询;再检查服务端日志、环境配置、网络连通、数据库服务状态和权限策略。要区分无数据、无权限和服务不可达,避免把错误直接当成空结果。项目的工具分类对部分网络故障有回退逻辑,但不能说整个网站都能在数据库故障时正常工作。

38. 如果私密笔记出现在游客搜索中,你怎么处理?

**参考回答:**先停止继续公开受影响内容,再检查访问身份、笔记公开和发布字段、搜索前是否已过滤、缓存是否跨用户共享,以及摘要、标签、关联链接和附件是否泄露。复现后补充游客和管理员权限测试;不要只在前端隐藏结果。

七、AI 编程和岗位追问

39. 使用 AI 编程工具时怎样保证结果可靠?

**参考回答:**先说明需求、输入输出、权限边界和项目约定,要求参考现有结构;生成后阅读关键代码,重点检查认证、数据读写、异常和边界情况,再运行对应测试或人工验证。不理解的代码先要求解释,再回到原文件确认。AI 可以辅助实现,正确性仍需验证。

40. 项目中的 AGENTS.md 有什么作用?

**参考回答:**它是给编码智能代理使用的项目规则,记录需要阅读的文档、项目结构、数据访问约定、安全要求和完成检查。例如敏感操作需要服务端授权,不修改已应用的旧数据库迁移。它帮助 AI 获取项目上下文,但不能替代测试与代码审查。

代码依据:AGENTS.md。

41. AI 生成的代码能运行,是否可以直接上线?

**参考回答:**不能只凭能运行判断。我会检查是否满足需求、泄露密钥、绕过权限、遗漏异常或破坏旧功能,再做相应测试、构建和人工验证。上线前还要确认目标环境、数据库变更和回滚方式。

42. 面试官说“这个项目只是套壳”,你如何回答?

**参考回答:**我会承认项目使用了成熟框架和服务,也借助 AI 编程工具,然后重点讲自己如何确定需求、组织方案及验证结果。例如知识库从固定 Git 提交读取,并区分游客和管理员可见性;后台更新通过版本检查减少互相覆盖。对于尚未完全掌握的实现,我会如实说明,并以自己的实际经历解释参与过程。

43. 如果笔记和访问量增长,下一步怎么优化?

**参考回答:**先用日志和指标定位瓶颈。当前知识库会逐篇读取 Git 文件,文本搜索也会遍历和解析内容;规模增长后可以考虑增量解析、缓存搜索文本或建立专门索引。与此同时要保证权限过滤、缓存隔离和新旧版本一致性,再根据实际测量决定是否引入数据库全文检索或向量检索。

面试前自查

  • 能不看稿讲清楚项目目标、功能、技术架构和个人贡献。
  • 能画出“浏览器 → Next.js 服务端 → Supabase 或 Git 知识库 → 页面”的数据流。
  • 能讲一个亲自处理的问题、排查过程和验证结果。
  • 能区分本站的文本搜索与另一个项目中的向量检索、RAG。
  • 能说明管理员鉴权、数据库行级安全和私密笔记及附件保护。
  • 对 AI 的参与程度、部署状态、定时任务与测试结果如实说明。

代码阅读索引

  • 项目概况:README.md、package.json、AGENTS.md
  • 管理员认证:lib/auth/admin.ts、app/auth/actions.ts、lib/supabase/
  • 业务数据和写入:lib/project-repository.ts、lib/tool-repository.ts、app/admin/tools/actions.ts
  • 数据库权限:supabase/migrations/
  • 知识库:lib/knowledge/、components/knowledge/、app/knowledge-assets/
  • 同步和新闻:ops/obsidian-sync/、ops/news-collector/
  • 部署和测试:.github/workflows/deploy.yml、ops/deploy/、tests/

放弃未保存的修改?

有未保存的修改,离开会丢失这些内容。