PROJECT CASE
个人数字花园与碧影
把公开笔记、项目记录、留言板和数字分身碧影放进同一个长期入口里，让内容、交互和部署一起生长。
定位
个人数字花园，不是一次性作品集。
核心
公开内容、双语笔记、碧影对话、留言。
状态
静态站点已可部署，后端能力继续完善。
这是我为自己搭建的长期个人网站。它不是单独的作品集，也不只是一个聊天 demo，而是把公开笔记、项目记录、当前状态、留言板和数字分身「碧影」放在同一个入口里。
我希望它能随着我学习和做项目一起长大：今天可能只是几篇课程笔记和一个能对话的入口，之后会慢慢加入更多真实项目、调试记录、阶段性想法和更稳定的部署。
为什么做¶
我想有一个比社交主页更稳定、比正式介绍更松弛的空间。朋友可以从这里知道我最近在折腾什么；同样对 AI 和工程感兴趣的人，可以顺着笔记和项目看到更具体的过程。
碧影是这个项目里比较特别的一部分。他不是“全知”的替身，只是一个温和的公开内容向导：读取网站里已经发布的内容，帮访客快速找到线索，也在没有资料时坦白说不知道。
技术栈¶
内容站点
MkDocs Material、Markdown、Pymdown Extensions 和 MathJax，用来维护笔记、页面结构和数学公式。
双语内容
中文作为主源，英文同步维护；导航、页面和公开知识库都按中英文成对组织。
碧影对话
公开知识库构建脚本、persona 设定、EdgeOne Functions 风格 API，以及 DeepSeek/OpenAI 兼容模型接口。
交互与部署
原生 JavaScript、赛博风格 CSS、公开留言板、EdgeOne Pages/Functions/KV 部署路线和 GitHub CI。
我做了什么¶
- 搭建 MkDocs Material 站点结构，规划首页、关于、现在、笔记、项目、碧影和留言等页面。
- 设计
/zh/与/en/双语内容结构，让中英文导航和页面保持成对维护。 - 导入并整理离散数学、计算机系统基础和 FDS 数据结构基础三篇课程讲义。
- 修复课程笔记中的公式渲染问题，让 LaTeX 能被 MathJax 正常显示。
- 为长篇课程笔记整理标题层级，让右侧目录能承担章节索引。
- 编写
build_knowledge.py，把公开页面生成碧影可读取的知识库。 - 设计碧影的人格、语气、可读取范围和拒答边界。
- 实现聊天前端、留言板前端，以及 EdgeOne Functions 风格的 API 雏形。
- 补充部署说明、架构说明和协作说明，方便之后继续维护。
当前成果¶
- 网站可以本地构建和预览，
mkdocs build --strict能通过。 - 中文和英文页面已经形成基本结构，后续新增内容有清晰位置。
- 三篇课程讲义已经变成可阅读的网站页面，支持数学公式和章节目录。
- 碧影可以基于公开知识库回答与网站内容相关的问题。
- 留言板和 EdgeOne 部署路线已经有基础实现，可以继续往真实线上环境推进。
还想改进¶
- 英文课程笔记还需要更完整的翻译和人工校对。
- 碧影后端上线前，需要配置真实模型密钥、KV 绑定和限流策略。
- 留言板还需要审核、删除、反垃圾和更顺手的管理界面。
- 移动端阅读、长笔记体验和视觉细节还可以继续打磨。
- 项目页需要持续补充更真实的作品、复盘和阶段性总结。