智析单词书 | GPT Wordbook

AI 赋能的深度词汇学习平台

智析单词书，是 AI 驱动的深度英语词汇学习平台，精选 11960+ 核心词汇，利用 GPT 模型深度解析每个单词的词义、发音、例句、词根、词缀、同义词、反义词、文化内涵与使用场景，从理解本质出发构建长期记忆。

🌐 在线访问 | 📖 项目简介 | 🏹 快速开始 | 🚀 部署指南

---

🌍 English | 中文

📖 项目简介

智析单词书（GPT Wordbook） 是 AI 驱动的深度英语词汇学习平台，精选 11960+ 核心词汇，利用 GPT 模型深度解析每个单词的词义、例句、词根、词缀、文化内涵与使用场景，从理解本质出发构建长期记忆。

💡 为什么选择「智析单词书」？

• 🤖 AI 驱动：基于 GPT 生成高质量的词汇解析内容，专业且富有洞察力
• 🎯 系统化学习：通过词根词缀逻辑梳理，帮助你建立完整的词汇网络
• 📚 海量词库 11960+ 精选核心词汇，覆盖各类考试和应用场景
• 🚀 高性能体验：基于 Astro 构建的静态网站，加载速度极快
• 🔍 SEO 友好：优秀的搜索引擎优化，方便通过搜索引擎查找单词
• 📱 响应式设计：完美支持桌面端、平板和移动端设备

✨ 核心特性

• 📖 深度词汇解析：每个单词都包含详细的定义、音标、词性、例句
• 🌳 词根词缀拆解：深度解析单词构成，掌握词汇演变规律
• 🎭 文化背景故事：了解单词背后的历史文化内涵
• 💡 AI 助记技巧：利用 GPT 生成生动有趣的助记故事，强化感官记忆
• 🔗 词汇关联网络：智能关联相关词汇，构建系统化学习路径
• ⚡ 快速搜索：内置强大的搜索功能，快速定位目标词汇

🎯 适用人群

• 🎓 考试备考者：考研、托福 (TOEFL)、雅思 (IELTS)、GRE、四六级等各类英语考试
• 💼 职场人士：需要提升专业英语能力和职场英语应用的从业者
• 🌟 英语爱好者：对英语语言文化感兴趣，追求深度学习的学习者
• 👨‍🏫 教育工作者：英语教师、培训师等需要优质教学资源的专业人士

🛠️ 技术栈

• 框架：Astro - 现代化的静态网站生成器
• UI 组件：Starlight - Astro 官方文档主题
• 交互组件：Svelte - 轻量级响应式框架
• 样式方案：TailwindCSS - 实用优先的 CSS 框架
• 内容格式：MDX - Markdown + JSX，支持丰富的内容展示
• AI 技术：GPT - 用于生成高质量词汇解析内容

🧱 项目结构

gpt-wordbook/
├── public/              # 静态资源（图标、图片等）
│   ├── favicon.svg      # 网站图标
│   └── humans.txt       # 项目贡献者信息
├── src/
│   ├── assets/          # 项目资源文件
│   ├── components/      # 项目组件
│   ├── content/
│   │   ├── docs/        # 文档内容 (MDX/MD 格式)
│   │   │   ├── about.mdx       # 关于页面
│   │   │   └── words/          # 单词页面目录
│   │   └── config.ts    # 内容集合配置
│   └── env.d.ts         # TypeScript 类型定义
├── astro.config.mjs     # Astro 配置文件
├── tailwind.config.mjs  # Tailwind CSS 配置
├── tsconfig.json        # TypeScript 配置
├── package.json         # 项目依赖
└── README.md            # 项目说明文档

🏹 如何使用？

前置要求

• Node.js: >= 16.0.0
• 包管理器: pnpm（推荐）/ npm / yarn

克隆项目

git clone https://github.com/nicejade/gpt-wordbook.git
cd gpt-wordbook

安装依赖

# 使用 pnpm（推荐）
pnpm install

# 或使用 yarn
yarn install

# 或使用 npm
npm install

启动开发服务器

# 使用 pnpm
pnpm start

# 或使用 npm
npm run start

# 或使用 yarn
yarn start

开发服务器将在 http://localhost:6969 启动。

构建生产版本

# 使用 pnpm
pnpm build

构建完成后，静态文件将输出到 dist/ 目录。

本地预览生产版本

# 使用 pnpm
pnpm preview

Typesense 搜索配置

项目使用 starlight-docsearch-typesense 接入 Typesense。生产环境默认走 Cloudflare Pages Function 同源代理 /typesense，前端不会暴露真实 Typesense key；本地开发可以按需直连 Typesense。

先基于 Typesense bootstrap/admin key 创建一个只读搜索 key：

curl -X POST "${TYPESENSE_ORIGIN}/keys" \
  -H "X-TYPESENSE-API-KEY: ${TYPESENSE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"description":"GPT Wordbook public search","actions":["documents:search"],"collections":["docs"]}'

Cloudflare Pages 需要配置这些环境变量（下例域名为占位示例，请替换为你自己的线上站点与 Typesense 服务地址）：

PUBLIC_SITE_URL=https://your-site.example.com
TYPESENSE_COLLECTION_NAME=docs
TYPESENSE_USE_PROXY=true
TYPESENSE_PROXY_PATH=/typesense
TYPESENSE_ORIGIN=https://your-typesense.example.com
TYPESENSE_SEARCH_API_KEY=<search-only key>
TYPESENSE_PROXY_ALLOWED_ORIGINS=https://your-site.example.com

本地如需直连 Typesense，可在 .env 中配置：

TYPESENSE_USE_PROXY=false
TYPESENSE_NODE_URL=https://your-typesense.example.com
TYPESENSE_SEARCH_API_KEY=<search-only key>

TYPESENSE_API_KEY 仅用于索引/爬取等服务端脚本，不要放到 astro.config.mjs、PUBLIC_* 环境变量或任何会进入前端包的位置。如果此前把 bootstrap/admin key 用在前端，请立即在 Typesense 中删除旧 key 并重新生成。

🚀 如何部署？

由于本项目是基于 Astro 构建的纯静态网站，您可以轻松部署到各种平台。

推荐部署平台

1. Cloudflare Pages（推荐）

• 免费且不限流量
• 全球边缘网络
• 优秀的性能表现
• 持续集成支持

2. Vercel

• 零配置部署
• 自动 HTTPS
• 全球 CDN 加速
• 持续集成支持

3. GitHub Pages

# 修改 astro.config.mjs 中的 site 和 base 配置
# 然后构建并部署
pnpm build

4. Netlify

• 拖拽式部署
• 自动构建
• 表单处理等额外功能

部署步骤（以 Cloudflare Pages 为例）

1. Fork 本项目到你的 GitHub 账号。
2. 在 Cloudflare 控制台 中，点击 Workers & Pages -> Create application -> Pages -> Connect to Git。
3. 选择 gpt-wordbook 仓库，点击 Begin setup。
4. 配置构建设置：
   • Framework preset: Astro
   • Build command: pnpm build
   • Output directory: dist
5. 在 Environment variables 中添加上文 Typesense 搜索所需变量，尤其是 TYPESENSE_ORIGIN 和 TYPESENSE_SEARCH_API_KEY。
6. 点击 Save and Deploy。
7. 部署完成后，你将获得一个 *.pages.dev 域名。

🎨 自定义配置

本项目基于 Starlight 开发，具有高度的可定制性：

主题定制

• 修改配置：编辑 astro.config.mjs 文件，自定义网站标题、描述、社交链接等
• 自定义样式：通过 CSS 变量或 Tailwind 配置修改主题颜色和样式
• 组件扩展：支持自定义 Svelte/Astro 组件，扩展功能

内容管理

• 添加新词汇：在 src/content/docs/words/ 目录下创建 MDX 文件
• 修改页面：编辑对应的 MDX/MD 文件即可
• 配置导航：在 astro.config.mjs 中配置侧边栏和导航菜单

多语言支持

项目内置完善的国际化支持，可以轻松扩展多语言版本。

📊 数据来源

本项目的词汇数据由 GPT 生成，包含：

• 精准的分析词义
• 地道的列举例句
• 词根、词缀分析
• 发展历史和文化背景
• 单词变形
• 记忆技巧和助记故事

所有数据经过人工审核和优化，确保准确性和实用性。

🤝 贡献指南

欢迎各种形式的贡献！无论是：

• 🐛 报告 Bug
• 💡 提出新功能建议
• 📝 完善文档
• 🌍 翻译内容
• ⚙️ 提交代码改进

如何贡献

1. Fork 本项目
2. 创建你的特性分支 (git checkout -b feature/AmazingFeature)
3. 提交你的改动 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启一个 Pull Request

💬 反馈与支持

如果你在使用过程中遇到问题或有任何建议，欢迎通过以下方式联系：

• 📧 提交 Issue
• 💬 参与 Discussions
• 🐦 关注作者 X | Twitter
• 📝 访问作者博客 晚晴幽草轩

⭐ Star History

如果这个项目对你有帮助，请考虑给它一个 Star ⭐！

🙏 特别致谢

本项目受益于以下优秀的开源技术和社区：

• Astro & Starlight - 提供强大的静态网站生成能力
• Svelte - 轻量级的响应式框架
• TailwindCSS - 优雅的样式解决方案
• OpenAI GPT - 提供高质量的 AI 内容生成能力

感谢所有为开源社区做出贡献的开发者们！

📄 开源协议

本项目采用 MIT License 协议开源。

用 ❤️ 构建，助力英语学习

Made with ❤️ by nicejade

在线访问 · 报告问题 · 讨论交流

Copyright (c) 2026-present, nicejade.