1
┌─────────────────────────────────────────────────────┐
2
│                   构建时 (Build Time)                │
3
│                                                     │
4
│  scripts/fill-descriptions/index.ts                 │
5
│  ├── 扫描 src/content/posts/ 下所有 .md/.mdx         │
6
│  ├── 跳过已有 description 的文章                      │
7
│  ├── 调用千问 API 生成摘要                            │
8
│  └── 写回 frontmatter (description + descriptionSource) │
9
└─────────────────────────────────────────────────────┘
10
                          ↓
11
┌─────────────────────────────────────────────────────┐
12
│                   运行时 (Runtime)                   │
13
│                                                     │
14
│  src/components/widget/AiSummary.astro              │
15
│  ├── 读取 description 和 descriptionSource           │
16
│  ├── IntersectionObserver 监听滚动进入视口            │
17
│  ├── 逐字打字机动画，标点处自动停顿                    │
18
│  └── astro:page-load 支持 Swup 站内导航              │
19
└─────────────────────────────────────────────────────┘

1
INSERT INTO "public"."friends" (
2
    "id",
3
    "title",
4
    "desc",
5
    "siteUrl",
6
    "imgUrl",
7
    "tags",
8
    "status",
9
    "ip",
10
    "email",
11
    "message",
12
    "updatedAt",
13
    "createdAt",
14
    "weight" -- 新增int4权重字段
15
) VALUES
16
(
17
    '64f3b4ef-490d-4440-ad8e-5dc73034ccb9',
18
    '云原生构建',
19
    '会Fork就会CNB',
20
    'https://cnb.cool/',
21
    'https://cnb.cool/cnb/-/logos/s',
22
    '["Blog","Astro"]'::jsonb,
23
    'rejected',
24
    'unknown',
25
    NULL,
26
    NULL,
27
    '1785103334148',
28
    '1784148550477',
29
    0
30
),
31
(
32
    '80a0e1dc-7f96-42df-be62-3d0edabc77ac',
33
    '启源',
34
    '技术丶生活',
35
    'https://czxcly.cn/',
36
    'https://personal-biz.czxcly.cn/profile/avatar/2026/05/18/594c922986f34225aa6917bb0b2908ca.jpg',
37
    '["Blog","Astro"]'::jsonb,
38
    'approved',
39
    '129.204.149.174',
40
    NULL,
41
    NULL,
42
    '1785102151599',
43
    '1783301022476',
44
    0
45
),
46
(
47
    '8f652adc-0d92-4c53-9e5a-5088048b76e9',
48
    'ZhiJing''s Blog',
49
    'Go with the flow.',
50
    'https://iwexe.top',
51
    'https://iwexe.top/avatar.svg',
52
    '["Blog","Astro"]'::jsonb,
53
    'approved',
54
    '43.139.234.199',
55
    NULL,
56
    NULL,
57
    '1785102152667',
58
    '1783185799746',
59
    0
60
),
61
(
62
    'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
63
    'One',
64
    '明心见性，爱自己',
65
    'https://onedayxyy.cn/',
66
    'https://img.onedayxyy.cn/images/Teek/Teekwebsite/xyy-logo.avif',
67
    '["Blog","Astro"]'::jsonb,
68
    'approved',
69
    'unknown',
70
    NULL,
71
    NULL,
72
    '1785102169329',
73
    '1783815691854',
74
    0
75
),
76
(
77
    'a56878d9-4649-439d-b16d-abb4fa87ec7f',
78
    'gc的小站',
79
    '综合性小站,希望能帮到你!',
80
    'https://gcweb.cc',
81
    'https://www.gcweb.cc/static/img/pig.jpg',
82
    '["Blog","Astro"]'::jsonb,
83
    'approved',
84
    '223.104.116.184',
85
    NULL,
86
    NULL,
87
    '1785102168900',
88
    '1783462756928',
89
    0
90
),
91
(
92
    'b2c3d4e5-f6a7-8901-bcde-f23456789012',
93
    'Hyde',
94
    '人心中的成见是一座大山',
95
    'https://seasir.top/',
96
    'https://seasir.top/_astro/avatar.B2RZ_bo3_JV0dW.webp',
97
    '["Blog","Astro"]'::jsonb,
98
    'approved',
99
    'unknown',
100
    NULL,
101
    NULL,
102
    '1785102168100',
103
    '1783462753394',
104
    0
105
);

1
Firefly-hyde/
2
├── astro.config.mjs                                    # 修改 - 添加路径别名
3
│
4
├── src/
5
│   ├── components/
6
│   │   └── moments/                                    # 新增目录
7
│   │       ├── MomentCard.astro                       # 新增 - 朋友圈卡片组件
8
│   │       └── MomentsCover.astro                     # 新增 - 朋友圈封面组件
9
│   │
10
│   ├── config/
11
│   │   ├── externalMomentsConfig.ts                   # 新增 - 朋友圈配置
12
│   │   ├── externalNotebooksConfig.ts                 # 新增 - 笔记本配置
13
│   │   ├── navBarConfig.ts                            # 修改 - 添加导航链接
14
│   │   └── siteConfig.ts                              # 修改 - 添加封面配置
15
│   │
16
│   ├── content/
17
│   │   ├── config.ts                                  # 修改 - 添加moments集合
18
│   │   └── moments/                                    # 新增目录
19
│   │       └── *.md                                   # 新增 - 本地朋友圈内容文件
20
│   │
21
│   ├── data/
22
│   │   └── moments.ts                                 # 新增 - 获取远程朋友圈数据脚本
23
│   │
24
│   ├── pages/
25
│   │   ├── admin/                                     # 新增目录
26
│   │   │   ├── index.astro                           # 新增 - 登录页
27
│   │   │   ├── moments.astro                         # 新增 - 朋友圈管理
28
│   │   │   └── notebooks.astro                       # 新增 - 笔记本管理
29
│   │   ├── life/notebooks/
30
│   │   │   └── remote-entry.astro                    # 新增 - 远程笔记页
31
│   │   ├── moments.astro                              # 新增 - 朋友圈主页
32
│   │   └── moments/
33
│   │       └── pinned.astro                           # 新增 - 精选朋友圈
34
│   │
35
│   ├── types/
36
│   │   └── siteConfig.ts                              # 修改 - 添加momentsCover类型
37
│   │
38
│   └── utils/
39
│       ├── content-utils.ts                           # 修改 - 添加数据获取
40
│       └── gist-api.ts                                # 新增 - Gist API工具
41
└──

1
// 外部朋友圈数据源配置（基于 GitHub Gist，完全免费）
2
// 数据存储在 GitHub Gist 中，通过 GitHub API 读写
3

4
export const externalMomentsConfig = {
5
    // 是否启用外部朋友圈数据源
6
    enable: true,
7

8
    // GitHub Gist ID（创建 Gist 后从 URL 中获取）
9
    // 替换为你的 Gist ID。https://gist.github.com/Seasir-Hyde/xxxx，其中 xxxx 即为 Gist ID
10
    gistId: "替换为你的 Gist ID",
11

12
    // Gist 中的文件名
13
    fileName: "moments.json",
14

15
    // 默认作者信息
16
    defaultAuthor: "Hyde",
17
    defaultAvatar: "https://你的头像URL.jpg",
18

19
    // 后台登录密码的 SHA-256 哈希
20
    // 生成方式：在线工具:https://www.strongpasswordgenerator.org/zh-cn/sha256-hash-generator/
21
    adminPasswordHash:
22
        "b5d9ded2ab2812e8653f06fc4d3246a4b13642e8371bc74a7f1003eb4fb4e637",
23

24
    // GitHub Token（优先从环境变量 GITHUB_TOKEN 读取）
25
    githubToken: process.env.GITHUB_TOKEN || "",
26
};

1
// 外部笔记数据源配置（基于 GitHub Gist）
2
// 每个笔记本有独立的 Gist 仓库
3

4
export const externalNotebooksConfig = {
5
    // 是否启用外部笔记数据源
6
    enable: true,
7

8
    // 每个笔记本对应的 Gist ID
9
    // 在 https://gist.github.com 创建 Secret Gist，文件名 notebooks-entries.json，内容 []
10
    notebookGists: {
11
        "每日总结": "your-gist-id-here",
12
        "日记": "your-gist-id-here",
13
        "日常琐记": "your-gist-id-here",
14
        "学习笔记": "your-gist-id-here",
15
    } as Record<string, string>,
16

17
    // 笔记模板（Admin 页面快速选择）
18
    // {name} 会被替换为今天的日期
19
    templates: [
20
        {
21
            id: "daily",
22
            icon: "📝",
23
            name: "每日总结",
24
            title: "{name} 每日总结",
25
            content: "📍今天做了什么：\n📅今日感想：\n🔮明日计划：",
26
        },
27
        {
28
            id: "diary",
29
            icon: "📔",
30
            name: "日记",
31
            title: "{name}",
32
            content: "## 天气\n\n## 今天发生了什么\n\n## 心情\n\n",
33
        },
34
        {
35
            id: "reading",
36
            icon: "📚",
37
            name: "读书笔记",
38
            title: "",
39
            content: "## 📚 书籍信息\n\n- 书名：\n- 作者：\n\n## 核心观点\n\n## 我的感想\n\n",
40
        },
41
        {
42
            id: "free",
43
            icon: "📄",
44
            name: "空白",
45
            title: "",
46
            content: "",
47
        },
48
    ] as Array<{
49
        id: string;
50
        icon: string;
51
        name: string;
52
        title: string;
53
        content: string;
54
    }>,
55

56
    // 后台登录密码的 SHA-256 哈希（与朋友圈后台共用同一密码）
57
    adminPasswordHash:
58
        "b5d9ded2ab2812e8653f06fc4d3246a4b13642e8371bc74a7f1003eb4fb4e637",
59

60
    // GitHub Token
61
    githubToken: process.env.GITHUB_TOKEN || "",
62
};

1
// 朋友圈集合
2
const momentsCollection = defineCollection({
3
    loader: glob({ pattern: "**/*.{md,mdx}", base: "./src/content/moments" }),
4
    schema: ({ image }) =>
5
        z.object({
6
            author: z.string().optional().default(""),
7
            avatar: z.string().optional().default(""),
8
            pinned: z.boolean().optional().default(false),
9
            published: z.date(),
10
            images: z
11
                .array(image().or(z.string()))
12
                .or(z.string())
13
                .optional()
14
                .default([]),
15
            tags: z.array(z.string()).optional().default([]),
16
            location: z.string().optional().default(""),
17
            device: z.string().optional().default(""),
18
        }),
19
});
20

21
// 导出朋友圈集合
22
export const collections = {
23
    posts: postsCollection,
24
    spec: specCollection,
25
    ziyuan: ziyuanCollection,
26
    moments: momentsCollection,  // 朋友圈集合
27
};

1
import { defineConfig } from 'astro/config';
2

3
export default defineConfig({
4
    vite: {
5
        resolve: {
6
            alias: {
7
                "@": "./src",
8
                "@components": "./src/components",
9
                "@layouts": "./src/layouts",
10
                "@config": "./src/config",
11
                "@utils": "./src/utils",
12
                "@data": "./src/data",
13
            },
14
        },
15
    },
16
});

1
// 获取默认封面图显示状态
2
export function getDefaultPostCoverImageEnabled(): boolean {
3
  return siteConfig.postListLayout.showCover ?? true;
4
}
5

6
// 从localStorage读取封面图显示状态
7
export function getStoredPostCoverImageEnabled(): boolean {
8
  if (
9
    typeof localStorage === "undefined" ||
10
    typeof localStorage.getItem !== "function"
11
  ) {
12
    return getDefaultPostCoverImageEnabled();
13
  }
14
  const stored = localStorage.getItem("postCoverImageEnabled");
15
  if (stored === null) {
16
    return getDefaultPostCoverImageEnabled();
17
  }
18
  return stored === "true";
19
}
20

21
// 设置封面图显示状态
22
export function setPostCoverImageEnabled(enabled: boolean): void {
23
  if (
24
    typeof localStorage === "undefined" ||
25
    typeof localStorage.setItem !== "function"
26
  ) {
27
    return;
28
  }
29
  localStorage.setItem("postCoverImageEnabled", String(enabled));
30
  applyPostCoverImageEnabledToDocument(enabled);
31
  if (typeof window !== "undefined") {
32
    window.dispatchEvent(
33
      new CustomEvent("postCoverImageChange", {
34
        detail: { enabled },
35
      }),
36
    );
37
  }
38
}
39

40
// 将封面图状态应用到文档
41
export function applyPostCoverImageEnabledToDocument(enabled: boolean): void {
42
  if (typeof document === "undefined") {
43
    return;
44
  }
45
  document.documentElement.setAttribute(
46
    "data-post-cover-enabled",
47
    String(enabled),
48
  );
49
}

1
/* === Hide Post Cover Image === */
2
/* 当 data-post-cover-enabled="false" 时隐藏封面图 */
3
:global([data-post-cover-enabled="false"]) .post-card-image {
4
  display: none !important;
5
}
6

7
:global([data-post-cover-enabled="false"]) .has-cover {
8
  &.post-card-wrapper {
9
    .post-card-content {
10
      width: calc(100% - 52px - 12px) !important;
11
    }
12
  }
13
}
14

15
:global([data-post-cover-enabled="false"]) .has-cover .post-card-enter-btn {
16
  display: flex !important;
17
}