技术栈#

• Astro + Fuwari 主题:内容驱动 SSG,输出纯静态页
• Markdown:文章用 Markdown 写;Fuwari 主题当前以 .md 为主
• 内置功能:亮/暗色切换、文章搜索、归档、标签、RSS、目录(TOC)

如何写新文章#

1. 在 src/content/posts/ 新建 .md 文件
2. frontmatter 必填:title、published;可选 description、tags、category、draft

1
---
2
title: 文章标题
3
published: 2026-09-09
4
description: 摘要(首页/SEO/RSS 用)
5
tags:
6
  - agent
7
category: Agent
8
draft: false # true = 草稿,不发布
9
---

3. draft: true 的文章不会发布;本地可用 pnpm run dev 预览

NOTE

本仓库部署在个人工作站 Docker 里,pnpm run build 后线上即生效。

写作约定#

• 标签宁缺毋滥,统一用英文小写
• 代码示例要完整、能跑通,标明运行环境
• 引用外部资料注明出处
• 长文记得用 ##/### 分层,自动生成目录

提示框语法(本主题支持)#

文章里可以用 callout 写提示、警告等强调块:

TIP

用 > [!TIP] 写小贴士,支持 NOTE / TIP / IMPORTANT / WARNING / CAUTION。