快速开始

在本地安装、配置并运行日本語文章解析。

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

准备工作

开始前，请准备：

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

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

启动应用

1. 克隆仓库

   git clone https://github.com/cokice/japanese-analyzer.git
   cd japanese-analyzer
   
2. 安装依赖

   npm install
   
3. 创建环境变量文件

   Windows PowerShell

   Copy-Item .env.example .env.local
   

   cp .env.example .env.local
   
4. 配置模型

   打开 .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=
   
5. 启动开发服务器

   npm run dev
   

   打开 http://127.0.0.1:3000。

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

接下来

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