本文档是 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 主题加载关系(已知部分)

  1. _config.yml 声明使用 Minima。
  2. _includes/head.html 加载 /assets/main.css,这是 Minima 样式入口;同时加载 /css/override.css。
  3. _layouts/post.html 是仓库自定义文章布局,并包含分享区域和文章导航。
  4. _includes/sharelinks.html 与 _includes/navlinks.html 分别负责分享和前后篇导航。
  5. Minima 主题自身提供的默认布局、页眉、页脚等具体文件,尚未在本仓库路径中完整核实。

结构保护原则:基础主题与仓库自定义样式/布局分开看待。保留 Minima 及现有页面、导航和自定义功能;未经用户确认,不替换主题、不整体重建主题,也不删除已有结构。

2.4 尚未核实或发现路径差异的文件

以下路径的 GitHub 文件读取请求返回 404;这只说明这些确切路径未找到,不代表相应功能一定不存在:

  • _layouts/default.html
  • _layouts/page.html
  • index.html
  • archive.html
  • .github/workflows/jekyll.yml
  • Gemfile
  • CNAME

特别注意:_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 文章编辑约定

  1. 保留作者原意和完整原文。
  2. 未经允许,不擅自删段、删句或缩写。
  3. 未经允许,不改变文章立意和叙述视角。
  4. 润色必须尊重原文,不擅自添加作者没有提供的经历或事实。
  5. 用户要求整理成文档时,保留其确认过的内容。
  6. 修改已发布文章前,先说明修改方案;重要改动必须征得用户确认。
  7. 任何文章修改都要保留可追溯的原文记录。

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 仓库安全(最高优先级)

  1. 所有仓库操作前,先确认完整仓库名。
  2. 本项目唯一指定主仓库为 mymsnn/mymsnn.github.io。
  3. 确认当前目标分支;目前已核实为 master,后续操作仍需重新检查实际状态。
  4. 备份仓库与主仓库严格区分。
  5. 不得误操作其他用户或其他项目的仓库。
  6. 不得因仓库名称相似而自行判断目标。

7.2 修改前确认

  1. 修改代码前先检查 GitHub 实际状态。
  2. 先向用户说明修改方案、原因、涉及文件及影响范围。
  3. 重要修改必须征得用户确认。
  4. 用户明确要求直接执行的具体操作,可按其授权范围执行;不得扩大操作范围。
  5. 不确定的文件、依赖、部署配置先核实,不靠猜测。
  6. 优先小范围、可回退的修改。

7.3 内容和结构保护

  • 不擅自删除文章、图片、导航、页面或主题文件。
  • 不擅自替换 Minima 主题。
  • 不擅自改变网站整体结构。
  • 不擅自改写用户文章。
  • 不把其他仓库的配置或代码直接覆盖到本仓库。
  • 不因测试而清理用户未授权删除的分支或文件。

7.4 面向 Android 用户的协作方式

用户主要使用 Android 手机,不熟悉代码。操作时应:

  • 在授权范围内尽量直接完成 GitHub 操作;
  • 避免要求用户手动编辑复杂代码;
  • 减少让用户在 GitHub 页面中寻找文件的步骤;
  • 需要用户操作时,给出清晰、简短、按步骤的说明;
  • 完成后说明修改文件、提交记录和后续状态。

7.5 每次重要工作后的记录

每次完成重要修改、文章发布、主题调整或部署工作后,都更新本文件。

每次更新至少记录:

档案字段 应记录内容
仓库 完整仓库名称
分支 实际操作分支
修改文件 文件路径及具体变化
提交记录 Commit SHA、时间、提交说明
部署状态 成功、失败或待核实,并记录证据
文章记录 标题、路径、完整原文或原文变更说明
主题结构 结构、依赖或样式变化
下一步任务 未完成事项及阻塞原因

7.6 新聊天接续

新聊天开始时,先核对 GitHub 实际状态,再继续工作:

  1. 核对主仓库名称和默认分支;
  2. 获取最新提交;
  3. 检查上次修改的文件;
  4. 对照本档案中的文章原文和提交记录;
  5. 检查部署状态;
  6. 更新本档案中的待办和已完成事项。

接近上下文上限时,主动生成完整交接记录,至少包含仓库、分支、文件修改、提交记录、部署状态、文章原文和下一步任务。


8. 当前待办事项

8.1 已确定的工作方向

  • 完整核对仓库目录树。
  • 核实上游主题的来源、仓库地址及版本。
  • 区分 Minima 提供的文件与仓库自定义文件。
  • 核实 MiSans 字体是否实际加载。
  • 检查手机端和电脑端的实际显示效果。
  • 检查文章分享、上一篇/下一篇导航是否正常。
  • 检查旧文章清理后的页面状态。
  • 确认开篇文章及其图片可正常访问。
  • 检查归档链接与归档页面路径是否一致。

8.2 必须核实的信息

项目 状态
实际网站域名 待核实
GitHub Pages 是否启用 待核实
Pages 发布来源及工作流 待核实
最新提交是否部署成功 待核实
上游主题仓库地址 待核实
Minima 准确版本 待核实
Jekyll 构建环境版本 待核实
完整目录树 待核实
图片和静态资源完整性 待核实
MiSans 字体实际加载情况 待核实
手机端/电脑端实际效果 待核实
备份仓库同步状态 待核实
归档页面实际位置及可访问性 待核实

9. 档案维护记录

日期 变更
2026-11-21 建立初始项目档案;记录仓库、分支、主题配置、已读取文件、提交历史、开篇文章原文、写作及操作约定;部署、上游版本和备份同步状态标记为待核实。

维护规则:本文件是项目事实记录,不是愿望清单。只有实际完成并有证据的工作才能从“待办/待核实”更新为“已完成/已确认”。更新本档案本身也必须产生可追溯的 Git 提交。