PROJECT CASE
个人数字花园与碧影
把公开笔记、项目记录、留言、公开知识库和碧影放进同一个长期入口里，让内容、交互、检索和部署一起慢慢长出来。
定位
个人数字花园，不是一次性作品集。
核心
公开内容、双语笔记、RAG 检索、碧影对话、留言。
状态
站点已上线，后端 API、知识库构建、移动端验证和部署检查已形成闭环。
这是我为自己搭建的长期个人网站。它不是单独的作品集，也不只是一个聊天 demo，而是把公开笔记、项目记录、当前状态、留言、公开知识库和碧影放进同一个入口里。
我希望它能随着我学习和做项目一起长大：现在它已经有了双语页面、课程笔记、公开知识检索、留言与后台管理接口、移动端基础测试和自托管数学公式资源；之后会继续加入更多真实项目、调试记录、阶段性的想法，以及更稳定的线上运行细节。
背景¶
我想要一个比社交主页更稳定、又比正式介绍更松弛的地方。朋友可以从这里知道我最近在折腾什么；同样对 AI 和工程感兴趣的人，也能顺着笔记和项目看到更具体的过程。
碧影是这个项目里比较特别的一部分。他不是“全知”的替身，只是一个温和的公开内容向导：读取网站里已经发布的内容，帮访客快速找到线索，也在没有资料时坦白说不知道。
我做了什么¶
站点结构
搭建 MkDocs Material 站点，规划首页、关于、现在、笔记、项目、碧影和留言等页面。
双语内容
设计 `/zh/` 与 `/en/` 双语结构，让导航、页面和公开知识库成对维护。
笔记导入
导入并整理离散数学、计算机系统基础和 FDS 数据结构基础三篇课程讲义，修复公式渲染和章节目录。
碧影与留言
设计碧影的语气、读取范围和拒答边界，实现聊天前端、留言板前端、后台入口和 EdgeOne Functions 风格 API。
知识库与检索
把公开页面构建成可读取的知识库，按章节切块，并为当前页、Now 页和项目页设置更高检索权重。
稳定性与验证
补齐共享前端工具、API 错误处理、限流返回、公开范围校验、站点同步检查和移动端 Playwright 测试。
技术栈¶
内容站点
MkDocs Material、Markdown、Pymdown Extensions 和 MathJax，用来维护笔记、页面结构和数学公式。
双语内容
中文作为主源，英文同步维护；导航、页面和公开知识库都按中英文成对组织。
碧影对话
公开知识库构建脚本、章节级切块、来源边界、对话设定、EdgeOne Functions 风格 API，以及 DeepSeek/OpenAI 兼容模型接口。
交互与部署
原生 JavaScript、共享前端工具、赛博风格 CSS、公开留言板、EdgeOne Pages/Functions/KV 部署路线、GitHub CI 和 Playwright 移动端测试。
资源与公式
MathJax 以本地自托管资源随仓库和站点发布，减少外部 CDN 依赖；构建脚本会同步处理静态站点输出。
成果¶
- 网站可以本地构建和预览，
python scripts/build_site.py能完成知识库、MkDocs 构建和站点同步。 - 中文和英文页面已经有了清晰结构，后续新增内容知道该往哪里放。
- 三篇课程讲义已经变成可阅读的网站页面，支持数学公式和章节目录。
- 碧影可以基于公开知识库回答与网站内容相关的问题，并在公开范围外保持拒答边界。
- 留言板、后台消息管理、认证辅助接口和 EdgeOne 部署路线已经有基础闭环。
- 公开范围校验、移动端 smoke test、站点同步检查和自托管 MathJax 已纳入维护流程。
不足¶
- 英文课程笔记还需要更完整的翻译和人工校对。
- 线上环境仍需要确认真实模型密钥、KV 绑定和 EdgeOne 平台配置。
- 留言板还需要更细的审核、删除、反垃圾和更顺手的管理界面。
- 移动端阅读、长笔记体验和视觉细节还可以继续打磨。
edgeone开发依赖链存在 npm audit 风险，适合后续单独评估升级或替换方案。
下一步¶
- 项目页需要持续补充更真实的作品、复盘和阶段性总结。
- 继续把 EdgeOne Functions、KV、模型密钥和公开来源引用流程接成更稳定的真实线上能力。
- 单独处理依赖审计，不把工具链升级混进内容维护任务里。
- 为新增项目保留同样的结构：背景、我做了什么、技术栈、成果、不足、下一步。