ESC
开源 1 分钟阅读

truanayangi:Trưa Nay Ăn Gì — 支持 pnpm 本地运行,自动 Cookie 存储,无需登录、后端或云服务

越南语开源小工具 Trưa Nay Ăn Gì(今天中午吃什么)发布社区版,可用 pnpm 在本地运行。它是一个午餐随机选菜应用,自动以 Cookie 保存偏好与自建菜谱列表,无需登录、后端或云服务。项目需 Node.js 22.12+,支持测试、构建与预览,欢迎社区提交 Issue 和 PR。

来源:GitHub

Trưa Nay Ăn Gì 🍜

Tiếng Việt · English

官方网站:truanayangi.com

还不知道今天中午吃什么?打开盒子,转一转,给午餐一点小惊喜。

这是运行在你自己电脑上的社区版本,无需登录或后端。你可以筛选菜品、添加自己的菜谱列表,并直接在浏览器中保存偏好。

在本地运行

需要 Node.js 22.12+ 以及 package.json 中记录的 pnpm 版本。

git clone https://github.com/truanayangi-com/truanayangi.git
cd truanayangi
pnpm install --frozen-lockfile
pnpm start

打开 127.0.0.1:5173。无需创建 .env 或配置外部服务。如果端口被占用,可运行 pnpm start --port 5188。

开发命令:

pnpm test       # 运行测试
pnpm build      # 生成构建版本
pnpm preview    # 在 http://127.0.0.1:4173 查看构建版本

服务器只监听 127.0.0.1。安装依赖后,应用从本机加载资源;外部链接仅在你点击时才会打开。

你的数据

偏好、菜谱列表和转动记录会通过 Cookie 自动保存在当前浏览器中。删除 Cookie 将重置数据;数据不会在设备间同步。显示的转动记录仅属于当前浏览器。

如果 Cookie 被阻止或菜谱列表过大,应用会提示未能保存。

GitHub Pages 与官方网站

GitHub Pages 仅重定向到 https://truanayangi.com/。这样做是为了保持功能一致:访客始终使用同一个 production 前端,API 与登录 Cookie 同源,而不是一个容易产生功能偏差或在刷新后丢失登录状态的第二个静态应用。只需将 pages-redirect/ 发布到 gh-pages;不要将本地构建版本发布到那里。静态 UI 修改和转盘动效的改动需要在此仓库与私有的 production 前端中同步更新。

贡献

欢迎大家报告问题、提出想法,或 fork 仓库并向 main 提交 PR。你可以使用越南语或英语,可以开启 draft PR 进行交流,无需事先通过 issue 审核或加入组织。

只需清楚地描述改动内容以及你如何进行了验证。对于代码改动,请尽可能运行测试和构建;维护者会在合并前提供帮助并进行审查。请将敏感信息保留在仓库之外,并为所使用的来源注明出处。

来源

该仓库由 nagisanzenin/truanayangi 迁移而来,保留了完整的 Git 历史和社区贡献。参见作者与资源致谢。

GitHub Pages 会重定向到官方网站。只有 pages-redirect/ 目录会被发布到 gh-pages;仓库中的应用代码用于本地运行。