1
# npm
2
npm create fuwari@latest
3

4
# yarn
5
yarn create fuwari
6

7
# pnpm
8
pnpm create fuwari@latest
9

10
# bun
11
bun create fuwari@latest
12

13
# deno
14
deno run -A npm:create-fuwari@latest

1
---
2
title: My First Blog Post
3
published: 2023-09-09
4
description: This is the first post of my new Astro blog.
5
image: ./cover.jpg
6
tags: [Foo, Bar]
7
category: Front-end
8
draft: false
9
lang: jp# 仅当文章语言与 `config.ts` 中的网站语言不同时需要设置
10
---

1
# ✅ 确认项目结构（Fuwari 标准）
2
my-fuwari/
3
├── astro.config.mjs    # 确保 site: 'https://upsubs.com'
4
├── src/content/posts/  # 文章放这里
5
├── src/assets/         # 封面图放这里（用 import 引入）
6
├── package.json        # 确认有 "build": "astro build"
7
└── .gitignore          # 确保 node_modules/ dist/ 已忽略
8

9
# ✅ 本地构建测试（关键！）
10
pnpm run build
11
# 应无报错，生成 dist/ 目录

1
git init
2
git add .
3
git commit -m "chore: init fuwari for upsubs.com"
4
git branch -M main
5
git remote add origin https://github.com/你的用户名/upsubs.com.git
6
git push -u origin main

1
upsubs.com      A     @     (自动，代理状态: Proxied)
2
upsubs.com      CNAME @     (备用，自动)

1
import { defineConfig } from 'astro/config';
2
import fuwari from 'fuwari'; // 假设主题插件
3

4
export default defineConfig({
5
  site: 'https://upsubs.com', // ✅ 裸域，统一规范
6
  base: '/',                  // GitHub Pages 才需改，CF Pages 保持 '/'
7
  integrations: [fuwari()],
8
  image: {
9
    domains: ['upsubs.com'],  // 允许生成 OG 图片
10
    service: {
11
      entrypoint: 'astro/assets/services/sharp' // Cloudflare 支持 Sharp
12
    }
13
  },
14
  // ✅ 开启 View Transitions（Fuwari 动效核心）
15
  experimental: {
16
    viewTransitions: true
17
  }
18
});

1
# 1. 检查重定向（终端执行）
2
curl -I https://www.upsubs.com
3
# ✅ 应返回：
4
# HTTP/2 301
5
# location: https://upsubs.com/
6

7
# 2. 检查规范标签
8
curl -s https://upsubs.com | grep 'rel="canonical"'
9
# ✅ 应返回：<link rel="canonical" href="https://upsubs.com/" />
10

11
# 3. 检查图片优化
12
# 访问一篇带封面图的文章 → 右键图片 → 复制链接
13
# ✅ 应为 .webp 或 .avif 格式，且带 ?width=xxx&format=xxx 参数
14

15
# 4. SEO 工具
16
- Google Search Console：提交 `https://upsubs.com/sitemap-index.xml`
17
- Cloudflare Web Analytics：在 Pages 项目开启，免费监控真实用户性能
18

19
# 5. 移动端/暗色模式
20
用手机访问 + 切换系统深色模式，确认：
21
- 页面过渡动画流畅（View Transitions）
22
- 无布局偏移（CLS ≈ 0）
23
- 暗色模式切换无闪烁