你的个人网站使用说明

你只负责知识内容和视觉选择。网站程序、报错修复和配置由 AI 负责，不需要你修改代码。

打开网站

在“my learning map”文件夹中，双击 启动网站.cmd。保持出现的启动窗口打开，然后在浏览器访问：

http://127.0.0.1:4321/

第一次加载稍等几秒。关闭启动窗口会停止网站；下次重新双击即可。网站现在只在你的电脑运行，没有发布到互联网，也没有自动发布。

如果不方便操作，直接告诉 AI：“帮我启动个人网站。”

首页与知识地图的位置

首页现在是以你为中心的个人主页。顶部有“首页、关于我、思考、学习、项目”导航；当前先连接首页对应区块，其他独立栏目页留待后续制作。

知识地图已完整保留，入口在首页的“学习”部分，地址是 **http://127.0.0.1:4321/learning/map/**。已有知识详情页的网址保持不变。

个人内容放在哪里

• 内容 / 个人 / 首页.md：昵称、一句话介绍、简介、正在做什么、正在学习什么、联系邮箱，以及关于我的正文。
• 内容 / 思考：文章或随笔。复制“随笔模板.md”到这里，填写标题、摘要和正文。
• 内容 / 学习笔记：学习记录。复制“学习笔记模板.md”到这里填写。
• 内容 / 项目：项目介绍。复制“项目模板.md”到这里填写。
• 内容 / 知识点：保留的知识地图内容，操作方式见下文。

你不需要编辑程序代码，也可以直接把这些文字交给 AI 代为写入。

当前是首页视觉预览阶段：新类型的内容自动用于首页摘要展示，暂未制作独立文章页、栏目归档页或项目详情页。首页显示最近两篇思考、两篇学习笔记和一个项目；日期留空也可以，填写时使用“2026-09-28”这样的格式。

现有个人文字与项目、随笔均明确标记为占位，不代表你的真实经历。换成真实内容后，把“内容状态”填写为“正式”，相应占位提示会消失。没有提供邮箱时只显示“联系方式待补充”，不会制造虚假的联系链接。

友链 / Friends

首页的“友链”位于主要内容之后、页尾之前。当前四张卡片是明确标记的占位内容，没有虚构网址，因此不会跳转。

以后把朋友的名称、一句话介绍、完整网址与头像交给 AI，就能替换卡片；你也可以复制“内容 / 模板 / 友链模板.md”到“内容 / 友链”填写。

• 网站地址：粘贴真实的完整 https:// 或 http:// 网址。留空时卡片显示“网址待补充”，不会出现假链接。
• 头像：把图片放入“内容 / 图片”，填写文件名，例如“朋友头像.png”；也支持你提供的完整图片网址。留空时使用狐狸占位头像。
• 内容状态：真实资料准备好后填“正式”。标为“占位”的卡片始终不跳转。

保存后自动更新。正式友链整张卡片都可点击，在新窗口打开朋友的网站，不需要修改任何程序。

维护知识地图时使用这三个位置

• 内容 / 知识点：你的笔记，一篇知识点对应一个 .md 文件。
• 内容 / 图片：笔记使用的图片，支持常见的 PNG、JPG、WebP、SVG 等格式。
• 内容 / 模板 / 知识点模板.md：复制这份模板来新建知识点，不要直接改掉唯一的模板。

.md 是普通的文字笔记文件。你可以使用已有的 Markdown 编辑器或记事本，不需要代码编辑器，也不需要安装在线后台。可以直接让 AI 代为保存你提供的内容和图片。

新增一个知识点

1. 复制“知识点模板.md”到“内容 / 知识点”。
2. 把副本改为一个容易识别的文件名，例如“循环.md”。保留 .md 后缀，不要变成 .md.txt。
3. 打开副本，填写“知识点名称”和“所属学科”，在“正文：”后写笔记。
4. 按需填写简介、前置知识、相关知识、标签；没有的项目留空即可。
5. 如需图片，将图片放入“内容 / 图片”，并在正文中插入图片引用。
6. 保存。开发服务器运行时，网站会自动重新读取内容；浏览器没有立即变化时刷新一次即可。

这六步里没有代码操作，没有安装依赖或重新配置网站的步骤。新增学科只需填写新的学科名称，目录和颜色会自动生成。

填写知识关系

使用知识点的名称，不需要编号。多个名称之间使用顿号“、”分隔。例如：

前置知识：变量与数据类型、比较与逻辑运算

相关知识：分段函数

前置知识有方向：在 B 中填写前置知识 A，地图就画出 A → B。B 页面可以跳到 A，A 页面也会自动列出 B。

相关知识没有方向：A 关联 B，只填写一次即可，B 页面也能跳回 A。

不同学科出现同名知识时，填写“数学 / 函数”这样的完整名称。同一学科不要放两个完全同名的知识点。关系填写的名称应与已有知识点一致；尚不存在或无法区分的关系会在首页显示中文提示。

尽量避免相互作为前置知识，学习顺序会变得不明确。

添加图片

例如，把“笔记照片.png”放进“内容 / 图片”，在正文写：

![这张图片的说明](笔记照片.png)

这是一条笔记的图片标记，不是程序代码。如果不想填写这种格式，直接把图片和要插入的位置告诉 AI。支持使用中文和带空格的图片文件名；文件名含空格时写成 ![说明](<我的 图片.png>)。

图片可放进子文件夹，例如 几何/三角形.png。不要把电脑的 C:\... 路径直接写到笔记里。

文字、代码与公式

正文是 Markdown 笔记，可以写段落、列表、标题和链接。## 标题 表示一个小节；正文普通换段用空行。

程序示例用三个反引号包起来，并注明语言，例如 cpp；可参考“C++基础”笔记。这里的代码是你学习的内容，不是网站程序，不需要运行。

行内公式使用一个美元符号包住，例如 $x^2$。单独一行的公式使用两个美元符号包住，可参考“分段函数”和“导数”笔记。不熟悉公式写法时，把公式内容交给 AI 转换即可。

地图、卡片与搜索

• 从首页“学习”进入知识地图后，电脑默认打开地图，点击节点进入详情页。
• 拖动地图空白处移动视野，用鼠标滚轮或右下角按钮缩放，方框按钮恢复完整视野。
• “卡片”按钮提供列表形式，也适合用键盘浏览。
• 手机尺寸默认显示卡片；切换“地图”后可以触摸拖动和双指缩放。
• 搜索匹配名称、简介、学科和标签，不搜索正文。清空搜索框可恢复全部结果。
• 左侧学科筛选与搜索可同时使用；没有结果时可一键清除筛选。
• 详情页中的“先学这些”“接下来可以学”“相关知识”都可以点击。

修改与删除

修改笔记正文后保存即可。修改知识点名称时，也要把其他笔记中引用它的名称一起修改；不确定时请让 AI 完成批量更新。

网页地址根据文件位置生成，修改正文和显示名称不影响地址。重命名或移动笔记文件会改变地址，因此建议文件名确定后保持不变。

删除笔记后，相关引用需要清理；首页会提示找不到的关联。让 AI 帮你删除和整理会更方便。

出现问题时

告诉 AI 你做了什么、哪里没有达到预期，有截图或提示文字可以一起提供。例如：“新增循环以后，地图没有出现，请检查并修复。”不要自行修改程序文件。

调整外观或功能

关于我页面

顶部导航“关于我”打开独立的 /about/ 页面。资料集中保存在 内容/个人/关于我.md，与首页占位文字分开维护。直接把更新后的信息告诉 AI 即可，不需要编辑代码。真实姓名不收录；社交平台只有名称时只展示文字，不生成链接。

直接提出效果，例如“背景改成深色，数学用蓝色”“手机只显示卡片”“增加学习状态”。由 AI 修改并验证，你不需要知道 CSS 或 JavaScript。

保存与备份

笔记和图片是真实文件，关闭浏览器不会丢失。请定期复制整个“内容”文件夹作为备份；如果需要保留网站外观和程序，也备份完整项目文件夹。第一版没有云端备份或同步。

当前使用手机宽度检查布局；本地地址 127.0.0.1 只指向打开浏览器的那台设备。真正从另一台手机访问需要另外配置局域网访问，这不是公开部署，可以以后让 AI 帮你设置。