霜折

一、先认识几个常用目录#

可以先用一个简单原则判断应该改哪里：文章正文放 content，列表数据放 data，功能开关和站点行为放 config。

二、新建和编辑公开文章#

公开文章都是 src/content/posts/ 下的 .md 或 .mdx 文件。可以复制已有文章，也可以在项目目录运行：

1
pnpm.cmd new-post article-name

文件名建议使用小写英文、数字和短横线，例如：

1
rh7777-cell-recovery.md
2
npc1l1-weekly-progress.md
3
western-blot-protocol.md

每篇文章开头都要有 Frontmatter：

1
---
2
title: 文章标题
3
published: 2026-10-14
4
description: 用一句话概括文章内容。
5
category: 实验进展
6
tags: [NPC1L1, 细胞培养]
7
draft: false
8
---

常用字段如下：

文章标题已经由 title 生成，正文通常从二级标题开始：

1
## 实验目标
2

3
正文写在这里。
4

5
## 实验结果
6

7
继续写结果。

更完整的 Markdown 写法见站内的 Markdown 写作速查，公式和 LaTeX 用法见 LaTeX 公式速查。

三、实验记录和 Protocol 怎么发布#

实验记录与普通文章没有区别，都会显示在主页。区别只在于使用哪个系列进行整理。

每日实验记录使用：

1
category: 实验进展
2
series: daily-lab-notes

Protocol 使用：

1
category: 实验 Protocol
2
series: lab-protocols

实验记录建议包含：

1. 实验目标；
2. 样品、批次和关键条件；
3. 操作摘要；
4. 实际观察；
5. 结果与问题；
6. 原因分析；
7. 下一步计划。

Protocol 建议包含：

1. 适用范围；
2. 材料、试剂和仪器；
3. 溶液配制；
4. 操作步骤；
5. 关键参数；
6. 常见问题；
7. 安全注意事项；
8. 版本和修改日期。

观察结果与自己的解释要分开写。无法确认的原因应写成“推测”“可能”或“仍需验证”，不要把单次观察直接写成结论。

四、在文章中插入图片#

1
public/images/experiments/2026-10-14/cell-result.jpg

1
![RH7777 细胞复苏后的镜下状态](/images/experiments/2026-10-14/cell-result.jpg)

1
src/content/posts/cell-recovery/
2
├── index.md
3
├── day-1.jpg
4
└── day-3.jpg

1
![复苏第一天](./day-1.jpg)

五、私人空间#

私人文章放在：

1
src/content/private/

文件示例：

1
---
2
title: 内部实验讨论记录
3
published: 2026-10-14
4
description: 仅供获准成员查看。
5
---
6

7
正文写在这里。

重新构建后，私人文章会统一出现在 /private/。访客输入一次私人空间密码后，可以查看该空间内的全部文章；会话有效期内刷新页面不需要重复输入。

私人空间的配置位于：

1
src/config/privateSpaceConfig.ts

修改 password 后必须重新构建和部署。当前仓库仍是公开仓库，因此 GitHub 上的 Markdown 源文件和配置密码仍可被查看；网页构建产物中的私人正文是加密的。真正需要保密的资料，后续应迁到私有内容仓库。

六、评论系统#

本站使用 Giscus，评论数据保存在 GitHub Discussions 中。配置位于：

1
src/config/commentConfig.ts

目前已经配置：

• 评论仓库：iceyan134/discussion
• 映射方式：按页面路径 pathname
• 评论语言：简体中文
• 输入框位置：评论列表底部

读者需要登录 GitHub 才能留言。若某篇文章不希望开放评论，在 Frontmatter 中添加：

1
comment: false

如果评论区没有出现，依次检查：

1. commentConfig.enable 是否为 true；
2. 仓库是否开启 Discussions；
3. Giscus App 是否已安装到评论仓库；
4. repoId 和 categoryId 是否仍然正确；
5. 浏览器是否拦截了 giscus.app。

七、修改个人资料、背景和导航#

个人资料在 src/config/profileConfig.ts：

1
avatar: "assets/images/shuangzhe-avatar.png",
2
name: "霜折",
3
bio: "个人简介",

域名、站点标题、主题色和背景图在 src/config/siteConfig.ts。导航栏入口在 src/config/navBarConfig.ts，侧栏组件在 src/config/sidebarConfig.ts。

修改配置时尽量沿用现有对象结构，只改值，不随意删除不理解的字段。路径应使用项目中的相对路径或以 / 开头的站内路径，不要把 Windows 的 C:\... 本地路径直接写进网页配置。

八、友链、音乐和番剧#

1
{
2
  id: 5,
3
  title: "站点名称",
4
  imgurl: "https://example.com/avatar.png",
5
  desc: "一句话介绍",
6
  siteurl: "https://example.com/",
7
  tags: ["Blog", "Friend"],
8
},

1
id: "1390540736,462698581",

1
pnpm.cmd anime:sync --provider bilibili

九、本地预览与检查#

在项目目录打开终端，安装依赖：

1
pnpm.cmd install

启动本地预览：

1
pnpm.cmd dev --port 4321

浏览器打开：

1
http://localhost:4321

修改文章后通常可以直接刷新查看。正式提交前至少运行：

1
npx.cmd astro check
2
pnpm.cmd build

astro check 应显示 0 errors。pnpm.cmd build 会生成 dist/，同时检查本地图标、图片、搜索索引和字体资源。

如果修改后页面没有变化：

1. 确认改的是正确文件；
2. 检查 draft 是否为 false；
3. 停止并重新启动开发服务器；
4. 清理 .astro/data-store.json 后重启；
5. 查看构建日志是否报错；
6. 线上站点等待部署完成后再强制刷新。

十、Git 提交与发布#

每次修改后的基本流程是：

1
git status --short
2
git add -- 修改过的文件
3
git commit -m "docs(posts): update article"
4
git push origin master

推送后由部署平台自动重新构建。只有 GitHub 已收到提交并且线上构建成功，网站才会发生变化。

常见提交类型：

不要直接修改 dist/。它是构建生成的文件，下次构建会被覆盖。

十一、常见问题#

十二、我的日常维护清单#

• 文章标题和摘要能否说明内容；
• 日期、分类、标签和系列是否正确；
• 实验事实与原因推测是否分开；
• 图片路径、说明和敏感性是否检查；
• 草稿状态是否正确；
• npx.cmd astro check 是否为 0 错误；
• 正式构建是否成功；
• 是否只暂存本次修改的文件；
• Git 是否已经提交并推送；
• 线上部署完成后是否检查页面。

这篇手册记录的是当前博客的实际使用方式。以后功能或目录发生变化时，应同步更新这里，避免操作说明与网站现状脱节。