致谢

在此特别感谢以下开源项目与参考网站。

一、生产依赖（dependencies）h2

项目运行必须的核心包，上线后仍需依赖。

1. 框架 & 核心

• astro：静态站点/全栈框架，项目核心构建工具

• @astrojs/react：Astro中集成React组件的适配器

• react：React核心库，用于构建UI组件

• react-dom：React DOM渲染工具，负责将React组件渲染到页面

• typescript：提供类型检查与TypeScript语法支持，提升代码健壮性

2. 状态管理

• nanostores：轻量级全局状态管理库，体积小、性能优

• @nanostores/react：nanostores与React的适配层，实现状态在React组件中使用

3. UI / 交互

• @floating-ui/react：悬浮层定位工具，用于实现弹窗、下拉菜单、提示框等组件

• framer-motion：React动效库，快速实现组件过渡、动画效果

• clsx：className条件拼接工具，简化多条件类名组合写法

• tailwind-merge：Tailwind CSS类名合并与去重工具，避免类名冲突

• react-hot-toast：轻量级消息提示组件（toast），用于反馈操作结果

4. 内容渲染

• react-markdown：在React中渲染Markdown内容的组件

• remark-gfm：扩展Markdown语法支持，新增表格、删除线等功能

• medium-zoom：图片点击放大预览工具，提升图片浏览体验

5. 服务端 / 鉴权

• jsonwebtoken：生成与验证JWT（JSON Web Token），用于用户登录鉴权

• bcryptjs：密码加密与验证工具，保障用户密码安全

• @octokit/rest：GitHub API客户端，用于调用GitHub相关接口

6. 评论 / 部署

• @waline/client：Waline评论系统的客户端组件，实现站点评论功能

• @astrojs/vercel：Astro适配Vercel部署的插件，简化部署流程

二、开发依赖（devDependencies）h2

仅用于开发、构建、格式化等过程，上线后无需依赖。

1. Astro 插件

• @astrojs/check：Astro项目的类型检查工具

• @astrojs/markdown-remark：Astro处理Markdown的核心插件

• @astrojs/mdx：支持MDX（Markdown + JSX）语法的Astro插件

• @astrojs/rss：生成站点RSS订阅文件的插件

• @astrojs/sitemap：生成站点地图（sitemap）的插件

• astro-robots-txt：生成robots.txt文件，控制搜索引擎抓取规则

• astro-expressive-code：Astro代码块增强插件，提升代码展示效果

2. 代码高亮 / 语法

• shiki：高性能代码高亮引擎，支持多种编程语言

• @expressive-code/plugin-collapsible-sections：代码块可折叠区域插件

• @expressive-code/plugin-line-numbers：为代码块添加行号的插件

3. Markdown / MDX 增强

• rehype-slug：为Markdown标题自动生成唯一ID（锚点）

• rehype-autolink-headings：为Markdown标题自动添加锚点链接

• rehype-callouts：为Markdown添加提示框（警告、注意、信息等）

• rehype-external-links：自动为外部链接添加target=“_blank”，新窗口打开

• rehype-unwrap-images：将Markdown中包裹图片的p标签解包，便于样式控制

• remark-directive：支持自定义Markdown指令，扩展Markdown功能

• remark-directive-sugar：为remark-directive提供语法糖，简化指令写法

• remark-imgattr：扩展Markdown图片属性，支持自定义图片样式

• remark-math：支持Markdown中插入数学公式

• remark-smartypants：自动将普通引号、破折号转换为智能引号、em dash等

• mdast-util-to-string：将Markdown AST（抽象语法树）转换为纯文本

• unist-util-visit：遍历AST节点的工具，用于处理Markdown/MDX内容

4. 样式 / Tailwind

• tailwindcss：原子化CSS框架，快速构建自定义样式

• @tailwindcss/typography：Tailwind排版插件，优化文章、文档类内容的排版

• @tailwindcss/vite：Vite集成Tailwind的插件，提升开发体验

• @iconify/json：Iconify图标库的JSON数据，提供海量图标

• @iconify/tailwind4：Tailwind CSS 4.x适配Iconify图标的插件

5. 数学公式

• katex：快速渲染LaTeX数学公式的库，轻量高效

• rehype-katex：Rehype集成KaTeX的插件，实现Markdown中数学公式渲染

6. 图片 / 处理

• sharp：高性能图片处理库，支持图片压缩、裁剪、格式转换等

• ndarray-pixels：像素处理工具，用于图片像素级操作

• @lokesh.dhakar/quantize：颜色量化工具，用于提取图片主色调等场景

7. 开发工具

• prettier：代码格式化工具，统一代码风格

• prettier-plugin-astro：Prettier适配Astro文件的插件

• tsx：直接运行TypeScript/TSX文件的工具，无需编译

• terser：JavaScript代码压缩工具，减小打包体积

• node-cache：Node.js内存缓存工具，提升开发效率

8. 命令行工具

• chalk：命令行彩色输出工具，提升命令行日志可读性

• cli-progress：命令行进度条工具，展示长时间任务进度

• ora：命令行loading动画工具，提示任务执行状态

• yargs：命令行参数解析工具，简化命令行工具开发

• pagefind：静态站点离线搜索工具，构建时生成搜索索引

9. 类型定义

• @types/node：Node.js相关类型定义

• @types/react：React相关类型定义

• @types/react-dom：React DOM相关类型定义

• @types/jsonwebtoken：jsonwebtoken库的类型定义

• @types/cli-progress：cli-progress库的类型定义

• @types/mdast：mdast（Markdown AST）相关类型定义

• @types/yargs：yargs库的类型定义

10. 编译优化

• babel-plugin-react-compiler：React编译器插件，自动优化React组件编译结果

11. 统计

• reading-time：计算文章阅读时长的工具

三、参考网站h2

• https://ned.im 由 needim 创建
• https://astro-antfustyle-theme.vercel.app 由 lin-stephanie 开发
• https://astro-sphere-demo.vercel.app 由 markhorn-dev 设计
• https://enscribe.dev/ 由 jktrn 维护
• https://litos.vercel.app/ 由 Dnzzk2 维护

这些开发者创作的主题同样优秀，如果您喜欢他们的作品，请不吝给予Star✨支持。