remix-words-funny

“

围绕”单词书”来组织学习，把查词、记进度、看详情、做评论这些功能串在一起，让人能系统性地背单词而不是零散地碰。

Github地址

在线体验

功能特性

• • 以单词书为中心组织学习内容，支持浏览单词书、进入词表、收藏常用单词书，并在全部、已掌握、未掌握之间切换学习范围。
  • 提供完整的单词详情页，集中展示音标、发音、记忆提示、释义、短语、例句、同义词和同根词，方便在一个页面完成理解和复习。
  • 支持全站单词搜索，搜索结果会带出所属单词书，适合快速定位陌生词或跨单词书查找相关内容。
  • 登录后可以记录个人学习进度，标记单词掌握状态，并通过个人资料中的学习日历查看近半年的学习情况。
  • 提供账号、评论和主题等基础体验，包括邮箱注册/登录/重设密码、单词评论与点赞、浅色/深色主题，以及桌面端和移动端适配。

开发指南

1. 安装依赖

npm install

2. 准备数据库

创建 PostgreSQL 数据库。使用 Docker 时可以直接启动一个本地数据库：

docker run -d \  --name wordsfunny-postgres \  -p 5432:5432 \  -v wordsfunny_postgres_data:/var/lib/postgresql/data \  -e POSTGRES_USER=postgres \  -e POSTGRES_PASSWORD=your_password \  -e POSTGRES_DB=wordsfunny \  postgres:16-alpine

3. 配置环境变量

在项目根目录创建 .env：

DATABASE_URL="postgresql://postgres:your_password@localhost:5432/wordsfunny"
JWT_SECRET="replace_with_a_long_random_secret"
CRYPTO_SECRET="replace_with_a_long_random_secret"
EMAIL_SERVER_ADDRESS="your_email@163.com"
EMAIL_SERVER_PASS="your_smtp_authorization_code"

EMAIL_SERVER_ADDRESS 和 EMAIL_SERVER_PASS 可选，是用于发送注册和重设密码验证码。 当前代码默认使用 smtp.163.com，如果使用其他邮件服务，需要同步调整 app/.server/common/mail.ts。

4. 初始化表结构

psql "postgresql://postgres:your_password@localhost:5432/wordsfunny" -f app/.server/db/init.sql

5. 导入词库数据

https://mypikpak.com/s/VOEs95bTB0KGAg75t0Nrs-oOo1

下载数据压缩包，解压后使用 TablePlus、psql 或其他数据库工具导入。导入顺序建议为：

Book -> Word -> Translation / Phrase / Sentence / Synonym / Cognate

6. 启动项目

本地调试：

npm run dev

默认访问地址：

http://localhost:3001

生产构建与启动：

npm run buildnpm run start