这个博客用来沉淀技术内容:Agent 架构、工程实践、踩坑记录与工具折腾。
技术栈
- Astro + AstroPaper 主题:内容驱动 SSG,默认零 JS,输出纯静态页
- Markdown / MDX:普通文章用 Markdown;需要嵌组件的文章用 MDX
- 内置功能:亮/暗色切换、文章搜索、归档、标签、RSS、动态 OG 图
如何写新文章
- 在
src/content/posts/新建.md或.mdx文件 - frontmatter 必填:
title、description、pubDatetime;可选tags、draft、featured
---
title: 文章标题
description: 摘要(首页/SEO/RSS 用)
pubDatetime: 2026-09-09T10:00:00+08:00
featured: true # 选填,精选会出现在首页
draft: false # true = 草稿,不发布
tags:
- agent
---draft: true的文章不会发布;本地可用npm run dev预览
Note
本仓库部署在个人工作站 Docker 里,npm run build 后线上即生效,详见 README。
写作约定
- 标签宁缺毋滥,统一用英文小写
- 代码示例要完整、能跑通,标明运行环境
- 引用外部资料注明出处
- 长文记得用
##/###分层,自动生成目录
提示框语法(本主题支持)
文章里可以用 callout 写提示、警告等强调块:
Tip
用 > [!TIP] 写小贴士,支持 NOTE / TIP / IMPORTANT / WARNING / CAUTION。