项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2008
技术标签
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Node.js 运行环境与 pnpm 包管理器(README 使用 pnpm 安装依赖)
- 可用的数据库(README 提供 db:generate / db:migrate 迁移命令)
- 一个 OpenAI 兼容接口的 API Key(所有 AI 功能必需)
- 可选:Docker 环境(README 将 Docker 列为推荐方式,但节选中未给出具体命令)
安装与启动步骤
-
1克隆项目仓库
使用 README 中给出的仓库地址克隆代码到本地目录,随后进入该目录继续操作。
git clone https://github.com/twwch/JadeAI.git -
2进入项目目录
切换到刚克隆下来的 JadeAI 目录,后续所有命令都在此目录执行。
cd JadeAI -
3安装项目依赖
README 使用 pnpm 作为包管理器安装全部依赖,需先确保本机已装好 pnpm。
pnpm install -
4准备环境变量文件
把示例环境变量复制为本地配置文件 .env.local,之后可按需修改其中的运行时变量。
cp .env.example .env.local -
5生成并执行数据库迁移
先根据 schema 生成迁移文件,再执行迁移完成数据库表结构初始化,两步都要成功。
pnpm db:generate pnpm db:migrate -
6配置 AI 接口密钥
启动应用后在应用内 Settings > AI 里填入 API Key 与接口地址,服务端不保存密钥。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
AUTH_ENABLED | 否 | 运行时开关,控制是否启用登录鉴权(旧版为 NEXT_PUBLIC_AUTH_ENABLED) | true |
AI API Key(应用内 Settings > AI 填写) | 是 | 调用 AI 优化简历、JD 匹配、模拟面试等功能的密钥,保存在浏览器本地 | sk-xxxxxxxx |
OpenAI 兼容接口地址 | 是 | AI 服务的 Base URL,可指向 OpenAI、Anthropic、自建网关或路由器 | https://api.openai.com/v1 |
如何确认成功
pnpm db:generate 与 pnpm db:migrate 均无报错执行完成,再按官方 Bilibili 部署视频启动服务并打开页面。
常见问题
Q:必须自己准备 AI 的 API Key 吗?
A:是的。聊天、简历生成、JD 匹配、模拟面试、翻译等所有 AI 功能都需要 Key,在应用内 Settings > AI 填写,服务端不存储,只留在浏览器本地存储中。
Q:只能接 OpenAI 官方接口吗?
A:不是。README 说明任何 OpenAI 兼容的端点都可以,可指向 OpenAI、Anthropic,也可以指向自建网关或路由器。
Q:推荐用 Docker 部署吗?怎么操作?
A:README 将 Docker 列为推荐方式,但本次节选中未给出具体的 docker 命令,可参考官方 Bilibili 部署视频(BV1h7wQzSEYe)按步骤操作。
Q:有不用自己部署的版本吗?
A:v0.5.0 起提供桌面客户端,包含 macOS(Apple Silicon / Intel)和 Windows x64 安装包,零配置、无需账号,数据保存在本地。
Q:能导出哪些格式?
A:导出管线支持 PDF、HTML 和 DOCX 三种格式,主题与品牌色改动会同步影响这些导出结果。
注意事项
- README 中给出的克隆地址是 https://github.com/twwch/JadeAI.git,与项目主页链接不一致,请以实际可用的仓库地址为准。
- AI 密钥只保存在浏览器 localStorage,服务端不存储,因此换浏览器或清空本地存储后需要重新填写。
- v0.3.2 起已移除所有 NEXT_PUBLIC_* 构建期变量,改用运行时环境变量,旧配置写法需要迁移。
- 本次 README 节选未包含启动服务的命令,请参考官方 Bilibili 部署视频完成启动步骤。
核心亮点
- 内置 50+ 专业模板,覆盖多种行业风格,选择丰富
- 支持 PDF/图片解析,自动提取已有简历信息,省去手动录入
- AI 优化 + JD 匹配分析,针对性提升简历与岗位的契合度
不足之处
- AI 优化效果依赖模型质量,复杂职业经历可能处理不精准
- 文档/社区待观察
适用场景
- 求职者快速生成或优化简历
- HR 或职业顾问批量制作简历模板
- 自托管简历工具,保护隐私数据
替代项目
OpenResume、Reactive Resume、FlowCV
同类项目推荐
chatgpt-graph-navigator
开源
把 ChatGPT 对话变成可导航的知识图谱,轻松回溯分支历史。
Transform ChatGPT into a navigable knowledge graph. Visualize complex branches with···
MinerU-Skill
开源
把 PDF/Office/图片一键转成 AI 能读的干净 Markdown
AI-Native document parser: PDF, Office & images → clean Markdown with LaTeX, tables···
awesome-spec-driven-development
开源
找全规范驱动开发资源,快速落地契约优先流程
A curated list of awesome resources for spec-driven development (SDD)
crumbs
开源
把缩进文本一键变成思维导图,告别手动绘图。
Turn asterisk-indented text lines into mind maps
note-gen
开源
随手记,AI帮你自动整理成清晰笔记,本地存储更安心。
Capture first. Organize later. A local-first Markdown app that turns scattered recor···
llama-scan
开源
本地大模型把扫描 PDF 转成可编辑文本
Transcribe PDFs with local LLMs
humla
开源
Mac 上不开会机器人,自动录音转写并生成可提问的会议笔记
Open-source AI meeting notes for Mac. Records mic + system audio with no bot, transc···
meetcap
开源
会议录音本地转写,AI 自动出纪要还能对话驱动
Powerful, free, context-aware AI native meeting assistant that transcribes in real-t···
PDFeXpress
开源
一个脚本搞定 PDF 合并拆分、图文提取与格式互转
PDF eXpress, used to handle many operations for PDF, such as merge, split, extract ···
