跳转到主要内容
本指南带你从源码启动应用。完成后，你可以在浏览器中输入日语句子并查看解析结果。

​
准备工作

开始前，请准备：
  • Node.js 22 和 npm
  • Git
  • 一个 DeepSeek API Key 或 Gemini API Key
推荐先配置 DeepSeek。它是默认的服务商，负责解析、翻译、释义和图片识别。只有 Gemini TTS 朗读必须使用 Gemini API Key。

​
启动应用

1

克隆仓库

2

安装依赖

3

创建环境变量文件

4

填写 API Key

打开 .env.local，至少填写一个 Key：
.env.local
其他变量都是可选的。完整列表见配置。
5

启动开发服务器

打开 http://localhost:3000。
输入一句日语，例如「天気がいいから、散歩しましょう」，然后点击解析。如果看到逐词注音和中文译文，说明配置成功。首页的今日一句也可以直接点击解析。

​
在手机上访问

如果你想用同一局域网里的手机访问开发服务器，让服务器监听所有网卡：
然后在手机浏览器中打开 http://电脑IP:3000。

​
只配置了 Gemini Key

应用默认使用 DeepSeek。如果你只填写了 GEMINI_API_KEY，打开页面后点击右上角的设置，把模型服务切换为 Gemini，再点击保存设置。

​
运行生产构建

想在本机试用生产版本时，运行：
npm start 默认监听 3000 端口。

​
接下来

使用指南

了解解析、单词详解和多词圈选的用法。

部署

发布到 Vercel，或用 Docker 运行在服务器上。