sherotree.github.io

个人技术博客，目标是「把复杂技术讲清楚」。基于 Astro 构建，部署在 GitHub Pages：https://sherotree.github.io

本地开发

npm install
npm run dev       # 本地预览 http://localhost:4321
npm run build     # 构建静态站点到 dist/
npm run preview   # 预览构建产物

如何新增一篇文章

1. 先定第三方分发渠道，在 src/content/blog/{platform}/{YYYY-MM}/ 下新建 文章-slug/index.md（platform 为 csdn 或 cnblogs；YYYY-MM 与 frontmatter date 年月一致；配图放同目录 images/）。一文只放一个渠道目录。
2. 填写 frontmatter：

---
title: 理解上下文窗口：token 到底在限制什么
date: 2026-08-12
updated:            # 可选，修订日期
description: 一句话摘要，用于列表与 SEO
tags: [AI, 基础概念]
series:             # 可选：browser-graphics | agent-notes | understanding-ai | ai-coding-workflow
draft: false        # 本站上线用 false；未完成稿用 true
---

3. 正文从 ## 二级标题开始写（一级标题由页面模板根据 title 渲染）。
4. 发布：改 draft: false 后 push main，GitHub Actions 自动构建。
   • 本站文章 URL：/blog/{slug}/（不含渠道 / 月份路径；渠道目录只用于仓库归档，不对读者展示）
   • slug 须跨渠道唯一

目录结构

src/
  content/blog/
    csdn/{YYYY-MM}/{slug}/     # CSDN 分发母稿（本站同步展示）
    cnblogs/{YYYY-MM}/{slug}/  # 博客园分发母稿（本站同步展示）
  content.config.ts   # 内容集合与 frontmatter 校验
  layouts/            # 页面布局（含 BlogPosting JSON-LD）
  pages/              # 路由：/、/blog/、/series/、/about/
  styles/global.css
  consts.ts           # 站点常量与专栏元数据
docs/plans/           # 选题、建站档案、运营计划（不进站点内容集合）
.agents/skills/       # 写作 skill（ruanyifeng-tech-writing）
public/robots.txt
.github/workflows/deploy.yml
AGENTS.md

选题与分发纪律见 docs/README.md。新增文章只往对应渠道目录写，不要写回其他仓库。

导出 CSDN 分发稿

把母稿里的 ./images/ 相对路径换成 jsDelivr 绝对链接，去掉 frontmatter，写入 # 标题；单篇时默认复制到剪贴板：

# 单篇
npm run export:csdn -- understanding-moe
npm run export:csdn -- src/content/blog/csdn/2026-08/understanding-moe

# 整月 / 全部 CSDN
npm run export:csdn -- 2026-08
npm run export:csdn -- src/content/blog/csdn/2026-08
npm run export:csdn -- src/content/blog/csdn

产物在 dist-publish/csdn/{slug}.md。可选参数：--no-clipboard、--ref <git-ref>（默认 main）。
批量导出不会写剪贴板。图片需已 push 到对应远程分支，jsDelivr 才能访问。

部署

仓库 Settings → Pages → Source 选择 GitHub Actions，之后每次 push main 自动上线。