🎯 JD Matcher 文档

配置指南

.env 文件所有配置项说明,以及如何自定义品牌和 AI 接入。

配置指南

JD Matcher 通过根目录的 .env 文件配置,应用启动时由浏览器异步加载。 所有配置项均有默认值,.env 缺失时会静默降级,页面仍可正常使用。


快速开始

# 1. 从示例文件创建 .env
cp .env.example .env
 
# 2. 按需编辑
nano .env   # 或任意文本编辑器
 
# 3. 启动服务
npm run dev

所有配置项

站点品牌

配置项默认值说明
JDM_APP_TITLEDream Offer Matcher — 目标岗位匹配分析浏览器标签页标题
JDM_APP_NAMEDream Offer Matcher页头 Logo 文字
JDM_RESUME_URL(空)预置远程简历 JSON URL(空则禁用)
JDM_APP_TITLE=我的求职助手
JDM_APP_NAME=Offer Hunter

Claude API

配置项默认值说明
JDM_CLAUDE_ENDPOINThttps://api.anthropic.com/v1/messagesClaude API 端点
JDM_CLAUDE_MODELclaude-haiku-4-5使用的 Claude 模型
JDM_CLAUDE_MAX_TOKENS1024最大输出 token 数
# 使用更强的模型(更慢更贵)
JDM_CLAUDE_MODEL=claude-sonnet-4-5
JDM_CLAUDE_MAX_TOKENS=2048

OpenAI API

配置项默认值说明
JDM_OPENAI_ENDPOINThttps://api.openai.com/v1/chat/completionsOpenAI API 端点
JDM_OPENAI_MODELgpt-4o-mini使用的 OpenAI 模型
JDM_OPENAI_MAX_TOKENS1024最大输出 token 数
# 使用 gpt-4o
JDM_OPENAI_MODEL=gpt-4o
JDM_OPENAI_MAX_TOKENS=2048

API Key 说明

⚠️ API Key 不应写入 .env 文件

用户在页面的「AI 配置」卡片中直接输入 API Key,Key 只在当前浏览器会话中保存, 不发送到任何服务器(直接从浏览器调用 AI API)。

Provider 自动识别

  • sk-ant-... 开头 → Claude API
  • 其他 → OpenAI API

远程简历预置(JDM_RESUME_URL)

适合将工具分享给他人时预置候选人简历:

# 指向一个公开可访问的 JSON 简历
JDM_RESUME_URL=https://your-domain.com/resume.json

要求 JSON 格式,结构与 Resume 类型定义一致(见 types 文档)。 服务器需支持 CORS(Access-Control-Allow-Origin: *)。


.env 格式规范

# 注释行(以 # 开头)
KEY=value          # 普通赋值
KEY='带空格的值'   # 单引号(引号会被去掉)
KEY="带空格的值"   # 双引号(引号会被去掉)

解析规则:

  • 忽略空行和注释行(# 开头)
  • 取第一个 = 作为分隔符
  • 去除值首尾的单/双引号

安全提示

注意项说明
API Key 不写入 .env用户页面填写,不落磁盘
.env 已加入 .gitignore避免意外提交到仓库
远程简历 URL 需 HTTPS避免混合内容警告
私人简历 JSON 不要公开托管保护个人信息

On this page