Skip to content

Repository files navigation

ResumeBuilder — 本地单用户 AI 简历工具

无登录 · 无账号 · 数据不出本机

三套模板 / 12 配色 / 实时预览 / AI 润色 / PDF · Word · TXT 导出


这是什么

一个跑在你自己电脑上的简历工具。打开就用,不需要注册、不需要登录、不需要联网——你的简历数据全部存在本地 SQLite 文件里,没有任何服务器能看到它。

唯一的可选在线功能是 AI 润色:配一个 DeepSeek API Key,选中一段经历让 AI 帮你改写,改写前后逐句 diff 对比,不满意不采纳。不配 Key,其余功能一切照常。

功能

📄 三套模板 现代简约 / 经典商务 / 极简白,一键切换
🎨 12 套配色 每套模板 4 种配色方案,实时预览切换效果
👁 实时预览 左侧编辑、右侧渲染,改一个字立刻看到效果
✨ AI 润色 DeepSeek 逐段改写,改写前后 diff 对比,采纳与否你说了算
📤 三种导出 PDF / Word / TXT——Word 与 PDF 同一套排版,HR 收到的 Word 打开就是 PDF 的样子
🖼 照片上传 裁剪后嵌入简历
💾 自动备份 启动时 + 每 30 分钟备份数据库,保留最近 20 份
📝 多行要点 每段经历支持多条 bullet,拖拽排序

下载即用

不想折腾环境?直接下安装包:

👉 GitHub Releases — macOS(dmg)/ Windows(安装包)

解压双击即用,首次启动自动建库,什么都不用配。

界面

简历列表 编辑器
Dashboard Editor
导出效果(PDF)
Export

截图使用演示数据拍摄,非任何真实简历。

本地开发

git clone <repo-url>
cd resume-builder
npm install                # 会自动生成 Prisma 客户端
cp .env.example .env       # 本地环境变量(默认 SQLite,开箱即用)
npm run db:init            # 建本地 SQLite 库 + 播种三套模板
npm run dev                # 打开 http://localhost:3000

平台注意事项

  • macOS:npm install 后 Electron 若启动即被杀(Code Signature Invalid),已由 postinstall 钩子(scripts/fix-electron-mac.sh)自动修复,无需手动处理。
  • Windows:打包用 npm run electron:build:win;日常 Web 开发不受影响。
  • AI 润色:复制 .env.example 为 .env,填入 DEEPSEEK_API_KEY(可选)。
  • 桌面模式:npm run electron:dev(开发)/ npm run electron:build(打包)。

工程质量

  • 59 项自动化测试(vitest,npm test):编辑器状态机、AI 润色流程、三种导出格式逐项断言
  • 导出链字体子集化:Noto Sans SC 按需子集加载,PDF 内嵌 CID 字体,体积与兼容性兼顾(WPS 实测)
  • 数据自动备份:启动 + 定时双触发,备份失败不阻塞使用
  • 真机验收闭环:Word 导出在鸿蒙 WPS、PDF 在多渲染器上逐项验过

这个项目是怎么开发的

这是一个个人项目,没有社区贡献者,也不打算装作有。

它的开发方式本身就是作品的一部分:一个人 + AI 协作流水线。

  • 规格驱动:每个批次先写任务单(目标 / 红线 / 验收标准 / 纪律),AI 执行,人验收。任务单就是合同。
  • 逐批验收:小步快跑,每批完工必须贴出证据(测试输出、截图、grep 结果),不放过"应该没问题"。
  • 真机测试闭环:Word 导出拿鸿蒙电脑上的 WPS 实测,PDF 拿多个渲染器对比——模拟器里全绿不算绿,真机上对了才算。
  • 红线先行:涉及个人数据的操作(开源前清扫、数据迁移)全部有可复现的零命中证据。

一个人能做完这些,靠的不是肝,是把"写代码"变成"写规格 + 验收"。

License

MIT · 字体:Noto Sans SC(SIL OFL 1.1)


ResumeBuilder — A Local-First, Single-User AI Resume Tool

No login · No account · No cloud — your data never leaves your machine

What

A resume builder that runs entirely on your computer. No sign-up, no server, no telemetry — your resume lives in a local SQLite file. The only optional online feature is AI polish: plug in a DeepSeek API key, highlight an experience block, and get a sentence-by-sentence diff you can accept or reject. Everything else works fully offline.

Features

  • 3 templates × 4 color schemes each, live preview
  • AI polishing with before/after diff (optional DeepSeek key)
  • Export to PDF / Word / TXT — the Word file carries the same layout as the PDF
  • Photo upload with cropping, multi-bullet entries, drag-and-drop sections
  • Automatic database backups (on start + every 30 min, keeps 20)

Download

Prebuilt packages for macOS (dmg) and Windows: GitHub Releases

Development

npm install
cp .env.example .env   # local env (SQLite by default)
npm run db:init        # create local SQLite DB + seed templates
npm run dev            # http://localhost:3000

Windows: use copy .env.example .env instead of cp.

Optional: copy .env.example to .env and set DEEPSEEK_API_KEY for AI polish. On macOS, a postinstall hook auto-fixes Electron code-signing issues after npm install.

Engineering

  • 59 automated tests (vitest) — npm test
  • Subset-embedded fonts in the PDF export chain (WPS-verified)
  • Built solo with an AI-collaboration pipeline: spec-driven task briefs, batch-by-batch acceptance, real-device testing (HarmonyOS WPS, multiple PDF renderers).

License

MIT · Fonts: Noto Sans SC (SIL OFL 1.1)

About

AI 简历生成器——本地单用户,三套模板+AI 润色+PDF/Word 导出(Mac/Win)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages