miragelyu.github.io

Personal technical blog built with Astro for GitHub Pages.

Stack

• Astro static output
• GitHub Pages user-site root (https://miragelyu.github.io/)
• Light Terminal visual style: khaki/beige paper background with terminal-style technical components
• Structured content metadata under src/content/posts/
• Rich HTML posts under src/rich-posts/

Commands

npm install
npm run dev
npm run build
npm run preview
npm run smoke

Agent maintenance conventions

When adding a new post:

1. Add metadata in src/content/posts/<slug>.json.
2. For rich HTML articles, place the source file in src/rich-posts/<slug>.html and set htmlSource in the metadata.
3. Keep theme changes centralized in src/styles/global.css.
4. Keep shared page structure in src/layouts/ and reusable UI in src/components/.
5. Run npm run build and npm run smoke before considering the site ready.

Current posts

• Programmatic Tool Calling 深度图解 — imported from the existing rich HTML article and available at /posts/programmatic-tool-calling-deep-dive/.