mymsnn 项目档案(PROJECT-RECORD)
本文档是
mymsnn/mymsnn.github.io的项目记录。
最后核对:2026-11-21
当前档案状态:初始版;部分部署、主题来源及运行状态仍待核实。
记录原则:只记录已由用户明确说明或通过 GitHub 实际读取确认的信息;不把推测写成事实。
1. 项目与仓库信息
1.1 主仓库
| 项目 | 记录 |
|---|---|
| 仓库全名 | mymsnn/mymsnn.github.io |
| GitHub 地址 | https://github.com/mymsnn/mymsnn.github.io |
| 仓库所有者 | mymsnn |
| 可见性 | Public(已核实) |
| 默认分支 | master(已核实) |
| 当前存在的分支 | 本次分支查询返回 master |
| 是否归档 | 否(已核实) |
| 仓库大小 | 最近一次查询约 10,933 KB;可能随仓库变化 |
| 项目用途 | 个人博客 |
仓库操作边界:本项目的所有 GitHub 操作只针对 mymsnn/mymsnn.github.io。不得将 myogg 名下的其他仓库当作本项目目标。
1.2 备份仓库
用户已建立私有备份仓库:
mymsnn/mymsnn.github.io-backup
待核实:备份仓库当前是否存在、是否仍为私有、最近同步时间、与主仓库的文件及提交差异。本次没有验证同步状态。不得假定备份已经同步。
1.3 其他仓库的区分
此前对话中出现过 myogg/moon、myogg/astro 等其他项目仓库。它们不是本项目的主仓库。除非用户明确提出跨仓库参考或操作,否则不得对它们执行本项目的写入操作。
2. 技术与主题结构
2.1 已确认的技术基础
从主仓库 _config.yml 读取确认:
- 静态站点生成器:Jekyll
- 主题:Minima(配置项为
theme: "minima") - 插件:
jekyll-feed、jekyll-sitemap - RSS 配置:
rss: rss - Kramdown 的语法高亮选项中设置了
disable: true - 文章默认标签:
Other
因此,本项目是 Jekyll + Minima,不是 Astro 项目。
待核实:Minima 的准确版本、依赖锁定方式、主题代码实际来源,以及 GitHub Pages 构建环境使用的 Jekyll 版本。本次未找到 Gemfile,不能据此推断依赖版本。
2.2 已读取确认的文件
| 文件路径 | 已确认用途或内容 |
|---|---|
_config.yml |
网站标题、作者、描述、社交账号配置、Minima 主题、插件及文章默认值 |
_includes/head.html |
页面 head;加载 Minima 的 /assets/main.css、自定义 CSS、feed 元信息和 highlight.js |
css/override.css |
仓库自定义字体、颜色、文章排版、首页列表、导航等样式 |
_layouts/post.html |
仓库自定义文章布局;输出标题、日期、作者、分享区域、正文及前后篇导航 |
_includes/navlinks.html |
文章上一篇/下一篇导航;无前后篇时链接到 archive.html |
_includes/sharelinks.html |
文章分享区域及相关图标、分享链接 |
about.md |
About 页面内容,使用 layout: page |
link.md |
友情链接页面内容,使用 layout: page |
_posts/2026-11-21-zuoge-youyisi-de-ren.md |
当前已核实的开篇文章 |
2.3 主题加载关系(已知部分)
_config.yml声明使用 Minima。_includes/head.html加载/assets/main.css,这是 Minima 样式入口;同时加载/css/override.css。_layouts/post.html是仓库自定义文章布局,并包含分享区域和文章导航。_includes/sharelinks.html与_includes/navlinks.html分别负责分享和前后篇导航。- Minima 主题自身提供的默认布局、页眉、页脚等具体文件,尚未在本仓库路径中完整核实。
结构保护原则:基础主题与仓库自定义样式/布局分开看待。保留 Minima 及现有页面、导航和自定义功能;未经用户确认,不替换主题、不整体重建主题,也不删除已有结构。
2.4 尚未核实或发现路径差异的文件
以下路径的 GitHub 文件读取请求返回 404;这只说明这些确切路径未找到,不代表相应功能一定不存在:
_layouts/default.html_layouts/page.htmlindex.htmlarchive.html.github/workflows/jekyll.ymlGemfileCNAME
特别注意:_includes/navlinks.html 中确实引用了 archive.html,但本次在仓库根目录读取 archive.html 返回 404。需要检查完整目录树,确认是否有其他归档页面路径、主题提供的页面或链接失效情况。不要在核实前自行创建、删除或改写页面。
另外,_includes/head.html 引用了 /js/highlightjs/ 下的样式和脚本;目录具体文件清单尚未完整检查。
3. 已完成修改记录
以下记录来自 GitHub 主仓库提交历史。时间同时列出 GitHub 返回的 UTC 时间及对应北京时间(UTC+8)。
| 北京时间 | 提交说明 | Commit SHA |
|---|---|---|
| 2026-11-21 16:02:35 | Clear repository contents and start fresh(清空仓库内容,重新开始) | 939d9dc41e7c7b7d366d1200ceb0bf04ed87cd10 |
| 2026-11-21 16:07:32 | Restore site files without old posts(恢复网站文件,不恢复旧文章) | b5dd65435edcccbab8ee028e992e8898cab89717 |
| 2026-11-21 16:18:34 | Add opening post: 做个有意思的人(添加开篇文章) | 1a18908893f2c53b4a79c6e548fa929074a3ccdb |
| 2026-11-21 16:29:06 | Improve typography and reading layout(改进字体与阅读排版) | 620e1896c9f3f89732af3056356b948d2800cce8 |
| 2026-11-21 16:29:12 | Load site-wide typography styles(加载全站字体样式) | 4c53c5f71ef5f44d1503a95a455fd21cae743f20 |
相关提交链接:
- https://github.com/mymsnn/mymsnn.github.io/commit/939d9dc41e7c7b7d366d1200ceb0bf04ed87cd10
- https://github.com/mymsnn/mymsnn.github.io/commit/b5dd65435edcccbab8ee028e992e8898cab89717
- https://github.com/mymsnn/mymsnn.github.io/commit/1a18908893f2c53b4a79c6e548fa929074a3ccdb
- https://github.com/mymsnn/mymsnn.github.io/commit/620e1896c9f3f89732af3056356b948d2800cce8
- https://github.com/mymsnn/mymsnn.github.io/commit/4c53c5f71ef5f44d1503a95a455fd21cae743f20
3.1 清理与恢复
提交记录显示,项目经历了清空仓库内容、恢复网站文件(不恢复旧文章)的过程。当前已核实网站配置、布局、样式、About 页面、友情链接页面等文件存在。
用户明确的目标是清理旧文章内容、保留网站主题和结构。不得把“清理文章”扩大解释为“删除主题、图片、导航或页面”。
3.2 字体和排版修改
已核实修改涉及:
css/override.css_includes/head.html
当前 css/override.css 中可直接读取到的设置:
| 项目 | 当前代码值 |
|---|---|
| 中文/系统字体优先级 | MiSans、MiSans L3、系统字体及 sans-serif 回退 |
| 正文字色 | #292929(body);文章正文为 #303030 |
| 全站基础行距 | 1.75 |
| 桌面文章正文 | 18px |
| 手机文章正文(宽度不超过 600px) | 17px |
| 文章正文行距 | 1.9 |
| 文章最大宽度 | 720px |
| 桌面文章标题 | 2.35rem |
| 手机文章标题 | 1.85rem |
| 首页文章列表 | 去掉圆点,增加底部分隔线 |
| 正文图片 | 最大宽度 100%,高度自适应 |
待核实:CSS 已将 MiSans 列为优先字体,但是否实际下载、安装或由浏览器加载成功,尚未验证。不能仅凭 CSS 声明认定字体已经在所有设备生效。
3.3 主题与设计方向
用户已明确:
- 保持当前主题,不换成另一套主题。
- 希望借鉴上游主题值得参考的风格和设计。
- 当前阶段重点是重新写内容,而不是反复更换主题。
- 代码修改尽量克制,优先借鉴字体、排版等细节。
- 不因为“可以改”就随意改动。
4. 文章记录与写作约定
4.1 文章目录和格式
当前已核实的文章路径:
_posts/2026-11-21-zuoge-youyisi-de-ren.md
从该文章确认的 Front Matter 格式:
---
title: "文章标题"
date: 2026-11-21
---
文章正文使用 Markdown。
配置文件为所有 post 设置了默认标签 Other。目前没有证据表明摘要或 tags 是每篇文章必须手动填写的字段,因此不将其列为强制要求。
待核实:是否存在其他文章命名规范、时区约定、摘要要求或额外 Front Matter 字段。
4.2 写作方向
博客是个人记录空间,内容方向包括:
- 日常生活与心境;
- 个人经历和回忆;
- 读书、音乐及兴趣;
- 生活见闻和观察;
- 那些值得记录、不愿遗忘的事情。
不必追热点,不必迎合他人,也不为了更新而更新。
4.3 文章编辑约定
- 保留作者原意和完整原文。
- 未经允许,不擅自删段、删句或缩写。
- 未经允许,不改变文章立意和叙述视角。
- 润色必须尊重原文,不擅自添加作者没有提供的经历或事实。
- 用户要求整理成文档时,保留其确认过的内容。
- 修改已发布文章前,先说明修改方案;重要改动必须征得用户确认。
- 任何文章修改都要保留可追溯的原文记录。
4.4 当前开篇文章原文
标题:做个有意思的人
文件: _posts/2026-11-21-zuoge-youyisi-de-ren.md
GitHub 文件链接:
https://github.com/mymsnn/mymsnn.github.io/blob/master/_posts/2026-11-21-zuoge-youyisi-de-ren.md
以下为从 GitHub 当前文件读取的正文原文,作为档案保存:
有些事情,做着做着就放下了;有些地方,走着走着又想回来。
这个博客其实已经存在很久了。以前写过一些东西,也折腾过不少页面和功能。后来文章越来越少,网站也渐渐安静下来。偶尔想起,才发现自己已经很久没有认真坐下来写点什么了。
前些日子,我把这里的旧文章清理了一遍。
不是觉得过去写得不好,也不是想把曾经的自己抹去。只是觉得,一个地方如果很久没有打理,不如收拾干净,重新开始。
人到了一定年纪,慢慢会发现,生活其实没有那么多惊天动地的大事。每天上班、下班,吃饭、睡觉,偶尔遇到一点开心的事,也会碰上一些不顺心的事。日子就这样一天天过去。
但我还是觉得,生活应该有点意思。
所谓有意思,不一定是做出什么了不起的事情,也不一定要活得多么精彩。可能是读到一本喜欢的书,听见一首熟悉的歌,想起一段很久以前的往事;也可能只是某个普通的下午,突然有了一个想法,想把它记下来。
网络上的地方很多,热闹的地方也很多。但我还是想留一个属于自己的小角落。
不必追赶热点,不必迎合谁,也不必为了更新而更新。想写的时候就写几句,想记录的时候就留下一点文字。写生活,写见闻,写那些说不清楚却又不愿意忘记的东西。
至于以后这里会变成什么样子,现在还不知道。
至少,从今天开始,它又有了新的内容。
做个有意思的人,过点有意思的日子。
这就够了。
文章顶部还包含一张图片,Markdown 图片地址为:
https://i.134688.xyz/file/1795248988860_Screenshot_20261119_103646_com_android_chrome_CustomTabActivity.webp
待核实:该图片链接目前是否可访问,以及是否已纳入主仓库自身的图片备份。不要擅自替换图片。
5. 页面、导航及功能保护清单
以下项目已在仓库文件中看到,修改时应保护:
- Minima 基础主题配置;
- 自定义文章布局
_layouts/post.html; - 分享区域
_includes/sharelinks.html; - 上一篇/下一篇导航
_includes/navlinks.html; - About 页面
about.md; - 友情链接页面
link.md; - 自定义样式
css/override.css; - highlight.js 资源引用;
- 文章图片及其他静态资源。
用户明确要求:不得擅自删除文章、图片、导航、页面或主题结构。
待核实:完整静态资源目录、图片数量、所有页面及导航入口、移动端菜单行为、主题默认页眉页脚的实际来源。
6. 部署状态
6.1 当前结论
部署状态:待核实。
对最新提交 4c53c5f71ef5f44d1503a95a455fd21cae743f20 查询 GitHub Combined Status,返回的 status checks 列表为空。
这只说明本次查询没有取得状态检查记录,不代表部署失败,也不代表部署成功。
6.2 尚需核实
- GitHub Pages 是否启用;
- Pages 的发布来源(分支/目录或 Actions);
- 实际部署工作流名称和文件路径;
- 最近一次 Pages 部署记录及结果;
- 网站实际访问域名;
- 最新提交是否已经上线;
- 自定义域名及 DNS 配置;
- 备份仓库同步情况。
本档案不记录未经核实的部署成功/失败结论,也不推测网站域名。
7. 操作约定
7.1 仓库安全(最高优先级)
- 所有仓库操作前,先确认完整仓库名。
- 本项目唯一指定主仓库为
mymsnn/mymsnn.github.io。 - 确认当前目标分支;目前已核实为
master,后续操作仍需重新检查实际状态。 - 备份仓库与主仓库严格区分。
- 不得误操作其他用户或其他项目的仓库。
- 不得因仓库名称相似而自行判断目标。
7.2 修改前确认
- 修改代码前先检查 GitHub 实际状态。
- 先向用户说明修改方案、原因、涉及文件及影响范围。
- 重要修改必须征得用户确认。
- 用户明确要求直接执行的具体操作,可按其授权范围执行;不得扩大操作范围。
- 不确定的文件、依赖、部署配置先核实,不靠猜测。
- 优先小范围、可回退的修改。
7.3 内容和结构保护
- 不擅自删除文章、图片、导航、页面或主题文件。
- 不擅自替换 Minima 主题。
- 不擅自改变网站整体结构。
- 不擅自改写用户文章。
- 不把其他仓库的配置或代码直接覆盖到本仓库。
- 不因测试而清理用户未授权删除的分支或文件。
7.4 面向 Android 用户的协作方式
用户主要使用 Android 手机,不熟悉代码。操作时应:
- 在授权范围内尽量直接完成 GitHub 操作;
- 避免要求用户手动编辑复杂代码;
- 减少让用户在 GitHub 页面中寻找文件的步骤;
- 需要用户操作时,给出清晰、简短、按步骤的说明;
- 完成后说明修改文件、提交记录和后续状态。
7.5 每次重要工作后的记录
每次完成重要修改、文章发布、主题调整或部署工作后,都更新本文件。
每次更新至少记录:
| 档案字段 | 应记录内容 |
|---|---|
| 仓库 | 完整仓库名称 |
| 分支 | 实际操作分支 |
| 修改文件 | 文件路径及具体变化 |
| 提交记录 | Commit SHA、时间、提交说明 |
| 部署状态 | 成功、失败或待核实,并记录证据 |
| 文章记录 | 标题、路径、完整原文或原文变更说明 |
| 主题结构 | 结构、依赖或样式变化 |
| 下一步任务 | 未完成事项及阻塞原因 |
7.6 新聊天接续
新聊天开始时,先核对 GitHub 实际状态,再继续工作:
- 核对主仓库名称和默认分支;
- 获取最新提交;
- 检查上次修改的文件;
- 对照本档案中的文章原文和提交记录;
- 检查部署状态;
- 更新本档案中的待办和已完成事项。
接近上下文上限时,主动生成完整交接记录,至少包含仓库、分支、文件修改、提交记录、部署状态、文章原文和下一步任务。
8. 当前待办事项
8.1 已确定的工作方向
- 完整核对仓库目录树。
- 核实上游主题的来源、仓库地址及版本。
- 区分 Minima 提供的文件与仓库自定义文件。
- 核实 MiSans 字体是否实际加载。
- 检查手机端和电脑端的实际显示效果。
- 检查文章分享、上一篇/下一篇导航是否正常。
- 检查旧文章清理后的页面状态。
- 确认开篇文章及其图片可正常访问。
- 检查归档链接与归档页面路径是否一致。
8.2 必须核实的信息
| 项目 | 状态 |
|---|---|
| 实际网站域名 | 待核实 |
| GitHub Pages 是否启用 | 待核实 |
| Pages 发布来源及工作流 | 待核实 |
| 最新提交是否部署成功 | 待核实 |
| 上游主题仓库地址 | 待核实 |
| Minima 准确版本 | 待核实 |
| Jekyll 构建环境版本 | 待核实 |
| 完整目录树 | 待核实 |
| 图片和静态资源完整性 | 待核实 |
| MiSans 字体实际加载情况 | 待核实 |
| 手机端/电脑端实际效果 | 待核实 |
| 备份仓库同步状态 | 待核实 |
| 归档页面实际位置及可访问性 | 待核实 |
9. 档案维护记录
| 日期 | 变更 |
|---|---|
| 2026-11-21 | 建立初始项目档案;记录仓库、分支、主题配置、已读取文件、提交历史、开篇文章原文、写作及操作约定;部署、上游版本和备份同步状态标记为待核实。 |
维护规则:本文件是项目事实记录,不是愿望清单。只有实际完成并有证据的工作才能从“待办/待核实”更新为“已完成/已确认”。更新本档案本身也必须产生可追溯的 Git 提交。