命令速查

Tue, 10 Nov 2026 06:20:39 GMT

一、日常改完 → 推送（最常用）

# 本地校验（改过代码/配置建议跑；只改文章也建议跑一次 build）
pnpm exec astro check
pnpm build

# 提交
git add -A
git commit -m "post: 新增文章 xxx"     # 或 feat: / fix: / docs: / chore:

# 推送
git push origin main

推送后 GitHub Actions 会自动构建并发布；Cloudflare（如果已连仓库）也会自动构建 *.pages.dev。

二、只改文章内容时

文章在 src/content/posts/，新建一篇：

pnpm new-post my-post-name
# 编辑 src/content/posts/my-post-name.md
pnpm build
git add -A
git commit -m "post: my-post-name"
git push origin main

三、更新追番数据（需要走代理时）

NODE_USE_ENV_PROXY=1 HTTPS_PROXY=http://127.0.0.1:2080 node scripts/anime/sync.mjs --provider bangumi

# 确认 src/data/anime-snapshots/bangumi.json 有变化后
git add src/data/anime-snapshots/bangumi.json
git commit -m "chore: sync bangumi snapshot"
git push origin main

说明：快照文件现在已提交进仓库，Cloudflare 和 GitHub Pages 构建时都会读它；本地 sync 后记得把 json 一起提交。

四、常见情况

push 被拒（远端有新提交）

git pull --rebase origin main
git push origin main

`git status` 突然冒出一大堆没动过的文件

多半是 Windows 换行（CRLF）差异。先看真实改动再决定：

git diff -w --stat          # 忽略空白后的真实改动
git diff --ignore-cr-at-eol --name-only

确认是纯换行的话，可以 git checkout -- <那些文件> 还原，别直接 git add -A 把噪声提交进去。

只想本地预览，不发布

pnpm dev          # http://localhost:4321

Cloudflare 没更新

去 CF 项目 → Deployments，看最新一次是不是对应刚推的 commit；没有就点 Retry，或者推一个空提交：

git commit --allow-empty -m "chore: trigger deploy"
git push origin main

五、整合命令

cd /d/Shirone && pnpm build && git add -A && git commit -m "chore: update site" && git push origin main

把 chore: update site 换成实际做的事就行。

Hello World

Mon, 09 Nov 2026 15:39:27 GMT

这里是秋生的第一篇文章。其实我并不知道写什么所以就让AI给我填充一篇了（

关于 Shirone

Shirone 是一个基于 Astro 的博客主题，使用 Svelte 5 编写交互组件、Tailwind CSS 4 与 Stylus 组织样式，整体遵循 Material 3 Expressive 设计语言。它不只是一个排版外壳：侧边栏、顶栏、文章页、数据页面都由同一套 M3E 组件与设计令牌驱动。

页面切换使用 Swup：顶栏、侧边栏这些持久外壳不会重新渲染，只有内容区域被替换，所以站内跳转没有整页刷新的闪烁。

设计上的几个选择

设计令牌优先：颜色、圆角、字号、动效统一走 --shape-corner-*、--m3e-type-*、--m3e-duration-* 这类变量，亮色与暗色主题共用一套结构。
组件分层：atoms → molecules → organisms → templates，跨层依赖有明确方向，页面只负责编排。
可选功能零负担：评论、统计、各种小部件都遵循同一条规则——关闭时不产生网络请求、不占布局、不进入首屏包体。
图标服务端渲染：所有图标在构建期从图标集中生成 SVG，浏览器不会去请求图标接口。

内容能力

主题还扩展了一套作者可直接使用的 Markdown 语法，用来写更“像页面”的内容：

提示框、标签页、分步步骤、字段参数卡片
代码树、图片网格与图片尺寸控制
数学公式、Mermaid 图表
剧透、注解、缩写、GitHub 卡片、include 片段

这些语法不需要额外开关，写在文章里就会按需加载对应的样式与运行时。

数据驱动的页面

除了文章，站点还有一些由数据文件生成的页面：

页面	数据来源
追番	Bangumi 收藏快照
游戏 / 设备	`src/data/games.ts`、`src/data/devices.ts`
友链 / 项目 / 技能 / 时间线	`src/data/*.ts`
动态	`src/content/moments/`

每个页面都可以在 src/config/ 里单独启用或关闭；关掉之后，页面与导航入口会一起消失。

工程实现

静态构建：pnpm build 生成页面，再用 Pagefind 建立全文搜索索引。
内容分离：内容可以留在仓库里，也可以用 CONTENT_DIR 指向另一个内容仓库，构建时再同步进来。
可复用：主题本身也发布为 npm 包 shirones，可以安装到任意 Astro 项目里作为博客层。

Shinakiの部屋