-
Notifications
You must be signed in to change notification settings - Fork 7
Home
本地优先的 AI 简历工作台。单用户单机运行，业务数据默认只存在本机 SQLite。
当前版本：0.11.0 · 主仓库 · 下载 Release
⚠️ 本 Wiki 是0.11.0时点的快照，为「导航 + 索引」而建，不随每次发版自动更新。 界面细节、功能清单与版本相关信息请以主仓库为准： README ·docs/文档目录 · CHANGELOG · 最新 Release
求职期间的资料是散的：JD 在收藏夹、简历有七八个版本、投递进度记在备忘录、面试完就忘了被问什么。
更要紧的是另一个问题：AI 会替你把简历写得很漂亮，也会替你编。 简历工具最危险的行为不是排版难看， 而是把你没做过的事写进去——面试官追问两句就露馅。
ResumeForge 的做法是把「事实」从「表述」里拆出来单独管一份：只有状态为「已确认」的台账条目才会作为事实 参与 AI 生成，生成结果里的学校 / 公司 / 项目名会与资料库逐条比对，不一致时给出防虚构警告。
围绕这条主线：岗位与资料是输入，简历是产物，投递台与求职进度是执行与反馈，模拟面试与面试深挖是检验—— 检验的结果又能反过来修简历。
| 我想…… | 去哪 |
|---|---|
| 把它装到自己电脑上跑起来 | 快速开始 |
| 弄清每个界面怎么用 | 功能指南 |
| 配置大模型 API Key | 功能指南 § 配置大模型 |
| 解决启动失败 / 装不上依赖 | 常见问题 或 排错与升级 |
| 知道我的数据去了哪、安不安全 | 功能指南 § 数据与隐私 |
| 升级到新版本且不丢数据 | 排错与升级 § 升级 |
| 参加这个项目的开发 | 见本页下方的「参与开发」一节 |
| 看完整的字段级说明 | 使用指南（1359 行，最权威） |
每条要写进简历的说法记成一条，包含四件事：原始事实、简历表述、承担程度（参与 / 负责模块 / 主导 / 项目负责人）与个人边界。
三道闸门：
- 只有「已确认」的条目会作为事实参与 AI 生成，未确认的说法被显式避开；
- 生成结果里的学校 / 公司 / 项目名自动与资料库逐条比对，不一致时给出警告；
- 正文还留着【待补】标记时，导出会被直接拦下并指出具体位置。
结论只能是五类：已匹配 / 表达缺口 / 证据不足 / 真实缺口 / 待确认。因为分数会让人误以为它能决定投递 结果，而五类结论说明的是「为什么」，可以直接指导改简历。另有一个 0–100 的匹配度参考分，但明确标注 仅作展示辅助、不参与投递准入（准入仍只由五类结论决定），并带免责说明。
| 模块 | 一句话 |
|---|---|
| 📋 岗位管理 | 手动填写、粘贴招聘信息、贴截图或上传文档识别；一次粘贴多份会自动拆分并先让你逐条确认 |
| 🧾 事实台账 | 事实与表述分离，只有已确认的条目参与生成 |
| 🤖 AI 定制简历 | 按 JD 筛选事实并流式生成，可选美化强度、篇幅、字号、样式与格式模板 |
| ✍️ 自行编写简历 | 从个人资料预填后自由修改，编辑器旁保留岗位参考 |
| 📄 多格式导出 | A4 HTML / PDF / Word / Markdown / txt / JSON，支持水印与一键隐私脱敏 |
| 🚀 自动投递台 | 按关键词城市采集岗位入库，驱动本机浏览器投递（唯一会访问外部站点的链路，需显式发起） |
| 🎯 求职进度 | 一家公司一个岗位一条记录，粘邮件或截图即可识别进展 |
| 🎤 模拟面试 | 逐轮追问，结束后给维度评分与改进建议 |
| 🔎 面试深挖 | 按已确认的主张逐条压力测试，用「已验证 / 部分验证 / 未验证 / 存在矛盾」代替分数 |
| 💬 AI 求职助手 | 能查库、能引用资料、只在明确要求时写数据 |
| 📈 求职数据看板 | 转化与卡点、时间与节奏、渠道与去向、简历与健康度 |
| ♻️ 回收站 | 十类内容删除后先进回收站，支持批量恢复 |
完整特性清单（40+ 项，含字段细节）见 README 的「功能特性」表。
-
默认全部留在本机。 业务数据存在
backend/data/resume_forge.db这一个 SQLite 文件里， 附件与照片也在库内，导出、渲染、PDF 生成都在本机完成。 - 只有你主动配置并触发的动作才会发出请求。 发送对象是你自己填地址和密钥的模型服务商； 照片不会发送给模型。
- 默认只监听回环地址。 这是单用户工具，没有账号体系，暴露到局域网或公网等于把数据库交给别人。
自动投递不保存招聘网站密码、Cookie、令牌或验证码——它通过 CDP 连接你自己登录的浏览器（独立用户目录）， 扫码登录由你在浏览器窗口里完成。
细节见 功能指南 § 数据与隐私 与 SECURITY.md。
| 页面 | 内容 |
|---|---|
| 快速开始 | 环境要求、Windows 一键启动、手动启动、首次配置 |
| 功能指南 | 按求职流程串起各功能的用法与关键概念 |
| 常见问题 | 高频问题、错误提示对照、怎么反馈问题 |
| 排错与升级 | 启动失败排查、数据备份、升级与回滚 |
Wiki 与仓库文档的分工：本 Wiki 是导航门户，提供快速上手的路径与索引； 权威正文在仓库的
docs/目录—— 字段级细节、架构设计、提示词调参等都在那里，且随代码一起更新。Wiki 里的链接会直接锚点到对应章节。
技术栈：React 18 + TypeScript + Ant Design 5 + Vite（前端）/ FastAPI + SQLAlchemy 2.0 + SQLite（后端）。
# 提交前请确认这两条命令都是绿的
cd backend; .venv\Scripts\python.exe -m ruff check .; .venv\Scripts\python.exe -m pytest
cd frontend; npm run format:check; npm run lint; npm test开始之前请读 CONTRIBUTING.md 与 AGENTS.md（后者是仓库的长期维护规则， 包含「一处逻辑只留一份实现」「新增迁移要同步更新测试」这类会直接影响 PR 能否通过的约定）。
- 修 bug 请先补一个能复现的测试，再改实现；
- 用户可见的行为变化请同步更新 README、
docs/user-guide.md、应用内使用指南与CHANGELOG.md； - 提交信息遵循 Conventional Commits（
feat:/fix:/docs:…）。
开发者文档索引：
| 文档 | 用途 |
|---|---|
| 项目导航图 | 从功能倒查代码位置，想改某功能先看这份 |
| 架构设计 | 分层、数据模型、决策记录、扩展点 |
| 提示词调优 | 各生成链路用的提示词与调整方法 |
| 面试讲解指南 | 怎么把项目讲清楚、讲出深度 |
| 变更记录 | 每个版本改了什么 |
MIT © 2026 magicapple123
如果这个项目帮你少踩了一个坑，去仓库给个 ⭐ 会让我知道它值得继续维护。