快速开始

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

准备工作

开始前，请准备：

Node.js 和 npm
一个 DeepSeek API Key，或一个 Gemini API Key
Git

如果你只想先体验文本解析，建议配置 DeepSeek。图片识别和 Gemini TTS 需要 Gemini API Key。

启动应用

克隆仓库

git clone https://github.com/cokice/japanese-analyzer.git
cd japanese-analyzer

安装依赖

npm install

创建环境变量文件

Copy-Item .env.example .env.local

cp .env.example .env.local

配置模型

打开 .env.local。至少填写一个模型服务商的 API Key。

DEEPSEEK_API_KEY=your_deepseek_api_key
DEEPSEEK_API_URL=https://api.deepseek.com/chat/completions

GEMINI_API_KEY=your_gemini_api_key
GEMINI_API_URL=https://generativelanguage.googleapis.com/v1beta/openai/chat/completions

CODE=
NEXT_PUBLIC_UMAMI_SRC=
NEXT_PUBLIC_UMAMI_WEBSITE_ID=

启动开发服务器

npm run dev

打开 http://127.0.0.1:3000。

页面打开后，输入一句日语并点击解析。如果使用 DeepSeek，图片上传功能会自动关闭。

接下来

查看配置说明，了解每个环境变量和模型的用途。
查看部署指南，将应用发布到 Vercel 或 VPS。
查看开发指南，运行测试并了解项目结构。

日本語文章解析配置说明

开始使用

配置与部署

开发指南

准备工作

启动应用

接下来

​准备工作

​启动应用

​接下来

准备工作

启动应用

接下来