Skip to content
项目

Liam-Frost/AutoApply has 61 GitHub stars and 22 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-18 00:03 UTC. Last push 2026-11-14.

这些数字如何统计

实测星标增长

24小时
0
7天
更新延迟
15天
更新延迟
1个月
更新延迟

各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。

关于

A personal job application AI Agent for job discovery, fit scoring, tailored materials, form filling, human-gated submission and application tracking.

人工智能

README.zh-CN.md

原文

AutoApply

在你自己电脑上运行的求职助手。
找岗位、按你自己的规则评分、把每份申请准备成草案,
你批准之后才替你填表。之后读邮件,跟踪每份申请的进展。

最新版本 CI 平台 许可

English | 简体中文

概览

目录

它做什么

找岗位 读你选的雇主的招聘页:Greenhouse、Lever、Ashby、SmartRecruiters、Workday 的公开看板,八家大型科技公司的官网,有订阅源的行业职位站,或者任意招聘页(由 AI 读)。有 46 家雇主和 16 个职位站已经核对过,可以直接勾选。
评分 按你用大白话写的规则评分,规则可以随时改。明显不合适的岗位(国家不对、级别不对)在花 AI 额度之前就被筛掉。
准备草案 打开真实的申请表,读出每一道题,只用你的个人资料作答。每个答案都写明依据和把握;答不上来的留给你,不猜。
等你 你审阅草案,用平常说话的方式改(“求职信第二段改成讲我的实习”),然后批准。
填表 专用的填表程序先填,程序再检查表单自己报了什么问题,剩下的由 AI 接手。默认由你自己点“提交”,除非你另有设置。
跟踪结果 只读你的邮箱,识别确认信、拒信和面试邀请,更新每份申请的状态。

它会按你的情况调整:第一次运行时的向导会问你的求职阶段(实习、应届、有经验)、领域和目标岗位,据此设置筛选条件、评分规则和界面。不只是给软件岗位用的。

审阅草案
草案。每个答案都带依据;你批准之前什么都不会发出去。
需要你处理的事
需要你处理。程序自己做不了的事,逐项列出来。
岗位
岗位,评分排序,每份申请到了哪一步一目了然。
备用 AI 服务
备用 AI 服务,以及每家还剩多少额度。
AI 成本
AI 花了多少。每次模型请求都有记录:各类 Token、按模型和功能的成本、每个成果的成本、失败花掉的钱。

它不做什么

这几条写死在代码里,没有开关:

  • 不编造你的任何信息。 答案、求职信、按岗位调整的简历,只用你的简历和你确认过的个人资料。
  • 不提交你没批准的东西。 交给 AI 的工具里没有“提交”这个动作。
  • 不绕过网站的防护。 不破解人机验证,不伪装浏览器。网站拒绝程序的浏览器时,这一步交给你。
  • 表单还在报错时,不会说“填好了”。 哪一栏还空着或被拒绝,会明确告诉你。
  • 看不到你的密码。 密码在系统的密码库里;AI 只知道“已登录”或“需要你来”。

安装

从最新版本下载:

系统 文件 怎么装
Windows 10 / 11 AutoApply-Setup-<版本>.exe 运行它,选安装位置和要不要快捷方式。
macOS 12+ AutoApply-<版本>-macos.dmg 打开后把 AutoApply 拖进“应用程序”。
Linux AutoApply-<版本>-linux.run sh AutoApply-<版本>-linux.run
任意系统,免安装 AutoApply-<版本>.zip 解压后运行 start.bat(Windows)或 ./start.sh。

安装窗口

安装不需要管理员权限,所有东西都在你的用户目录里。第一次运行会下载 uv、Python、依赖和程序自己用的浏览器(约 600 MB,几分钟)。升级、修复、卸载也用同一个安装程序;升级不会动你的数据。安装程序的语言跟随系统(中文或英文),也可以在窗口里切换。

安装包没有代码签名。 Windows 会提示“Windows 已保护你的电脑”,点“更多信息 → 仍要运行”。macOS 第一次打开时右键点应用,选“打开”。每个安装包都由发布流程构建,并在对应系统上实际安装、启动过才会发布;SHA-256 校验值在 SHA256SUMS.txt 里。

求职信、按岗位调整简历和 Word 文件预览需要把 Word 转成 PDF:有 Microsoft Word 就用它,没有的话装免费的 LibreOffice。

第一次使用

启动后托盘(macOS 是菜单栏)里会出现图标,网页自动打开在 http://127.0.0.1:8000。

托盘菜单

  1. 向导问你是谁、想找什么,然后给出筛选条件和评分规则的建议,你可以改。
  2. AI 服务:用 Claude 或 ChatGPT 订阅登录,或者填 API key(见下文)。
  3. 个人资料:上传简历,程序据此起草你的个人资料,并标出申请表会问、但简历上没写的内容。
  4. 试一次:贴一个岗位的网址,看程序怎么准备草案,不会真的发出去。

之后它按计划工作:扫描、评分、准备草案,有事需要你时通知你(在网页里;设置了 Telegram 的话也发到 Telegram)。

一份申请是怎么投出去的

flowchart LR
    A[发现岗位] --> B[按你的规则评分]
    B --> C[读申请表<br>准备草案]
    C --> D{你审阅}
    D -- 要改 --> C
    D -- 批准 --> E[填表程序填写]
    E --> F{表单报了<br>问题吗?}
    F -- 没有 --> H[提交]
    F -- 有 --> G[AI 按你的资料<br>把这一页做完]
    G --> F2{还有问题吗?}
    F2 -- 没有 --> H
    F2 -- 有 --> I[在可见窗口里<br>逐项交给你]
    I --> H
    H --> J[跟踪邮件]

这条链路有三点值得知道:

  • 表单说了算。 填完之后,程序会问页面自己哪里不对:被标成无效的字段、页面上的报错、还空着的必填项。只要页面不认,填表程序和 AI 谁都不能说这一页填完了。
  • AI 是兜底,不是主驾驶。 例行的填写由确定性的填表程序完成,又快又不花额度。AI 只在三种情况接手:没见过的表单、选了某个答案后才冒出来的字段、被表单拒绝的值;而且它只能用你个人资料里写明的内容。
  • 学到的东西会留下。 关于这个网站的笔记、表单对你答案的实际说法、新发现的字段都会保存,下一次需要的帮助更少。

谁来点“提交”由你按网站设置:默认情况下,在久经验证的网站上,你批准的草案会直接提交;AI 动过的、没有专用填表程序的网站、以及你把握不大的答案,都等你自己点。

AI 服务、备用和额度

在“设置 → AI 模型”里。

服务 怎么付费 能否查额度
Claude 订阅(Pro / Max) 你的订阅 能
ChatGPT 订阅(Plus / Pro) 你的订阅 能
Claude API 按用量 不能(Anthropic 不提供这个接口)
OpenAI API 按用量 不能
Google Gemini 按用量 不能
DeepSeek 按用量 能(余额)
通义千问(DashScope) 按用量 不能
OpenRouter 按用量 能(余额)
任何兼容 OpenAI 接口的服务,包括本机的 Ollama — 不能

备用服务。 可以按顺序排一串备用。主用的额度用完、被限流或连不上时,同一步会立刻改用下一个;出问题的那家歇到它的额度重置为止,之后自动切回。主要模型和处理简单任务的小模型都按这条顺序走。

额度。 能查的服务会显示已用多少;超过你设的提醒线(默认 80%)时通知你一次;用完的服务在重置之前不再调用。

Claude 订阅是测试得最充分的。其他服务走同一套接口;能力弱的模型读表单更容易出错。上面那些“不做”的规则都在代码里,不依赖模型。

你的数据

  • 所有东西都在你的电脑上:一个 SQLite 数据库、你的文件,以及几份你能直接读和改的 Markdown 文档(个人资料、评分规则、关于各网站的笔记)。
  • 密码和 API key 在系统的密码库里。保存的登录状态是加密的。
  • 除了你选的 AI 服务和招聘网站本身,不向任何地方发送数据。没有遥测,不需要注册账号。
  • 服务只监听 127.0.0.1,而且只回应它自己的页面:你浏览器里开着的其他网站发来的请求会被拒绝。
  • “设置 → 高级 → 导出全部数据”会生成一个压缩包;在另一台电脑上用 uv run autoapply restore <文件.zip> 恢复。

上一版错在哪里,这一版改了什么

AutoApply 1.0 是重写的。上一版(legacy-v0 分支)有大约 5.5 万行代码和 1720 个通过的测试,却投不出一份申请:填表、提交、状态跟踪、定时搜索这四条主线最后都返回 not_implemented。同一段时间里,同一个作者手动驱动一个通用的编程助手,实际投出了 140 多份申请。两相对比,问题出在哪里就清楚了。

上一版的做法 为什么行不通 1.0 的做法
用测试数量衡量进度。 1720 个测试,没有一个投出过申请。 测试都过了,产品却不能用。 每个里程碑都用真实投递验收。docs/STATUS.md 写明哪些实际跑过、哪些只有单元测试。
把 AI 关在格子里。 模型只负责在固定流水线里填几个受限的文本格。 真实的表单千奇百怪;流水线里没有“选了这个答案之后又冒出一栏”的格子。 模型负责感知、判断和修复;代码负责状态、执行和规则。
只给模型看页面的摘要。 最多 60 个字段的静态快照,没有截图。 模型看不到人能看到的东西,注意不到报错,也认不出自定义控件。 AI 能读整页、截图、列出控件和它们的选项,还能问表单“你还在报什么错”。
用表格和正则表达式存个人信息。 一套结构化表,加十类按模式匹配的答案。 真实的规则带条件和例外(“只有表单明确问法定姓名时才用法定姓名”),表格装不下。 个人资料是一份带日期的 Markdown 文档,你和 AI 都能读、都能改。
求职信靠关键词分桶。 给岗位分类,选一个写死的能力桶,填进固定的五段。 写出来的信放在谁身上都行。 用你的完整简历、完整岗位说明和你自己的范例来写,写完再对照简历检查有没有编造。
每个招聘网站提前写一个适配器。 永远追不上:大多数网站没有适配器。 常见系统有专用的填表程序;其他网站由 AI 探索一次,学到的留下来。
没有兜底。 一步要么成功,要么停下。 一个意料之外的字段就让整次运行作废。 填表程序 → 表单自己的判断 → AI 接手 → 再判断 → 你。运行会被交接,不会被丢掉。

还有两个错误是在做 1.0 的过程中又犯了一遍、在这一版里改掉的。记在这里,因为它们很容易重犯:

  • AI 接手时,最初只允许它填指定的几个字段。于是选了答案之后冒出来的必填项没人管,表单还在报错时程序却说“填好了”。现在它负责把整页做完,而且由页面说了算。
  • 读表单时如果用“页面上第二个下拉框”这种方式指代控件,好几道题会得到同一个身份,答案就对不上了。现在不管表单怎么描述,每道题都有自己的身份,按位置数的指代方式会被退回。

哪些实际验证过

如实的状态记在 docs/STATUS.md。简要地说:

状态
Windows 10 / 11 每天在用
Greenhouse;由 AI 探索的表单(Microsoft Careers、BambooHR、JazzHR 的网站) 真实投递过,并收到确认邮件
Ashby 在真实表单上填写并逐项核对过;还没有提交过
Workday、UBC 门户的填表程序 按之前手动投递的记录写的;登录之后的步骤没有实际跑过
Windows 安装程序(安装、带着运行中的程序升级、修复、卸载) 从头到尾实跑过
AI 服务之间的故障转移 在一家订阅的额度真的用完时实跑过一次
macOS 和 Linux 安装包 每次发布都由 CI 构建、安装并启动;作者日常不用这两个系统
Claude 订阅以外的 AI 服务 接口测过;投递质量没有比较过
英文界面 机器翻译,没有人工校对

开发

git clone https://github.com/Liam-Frost/AutoApply
cd AutoApply
./start.sh            # 或 start.bat:缺什么装什么,构建界面,然后启动
命令 作用
uv run pytest 测试(不会访问真实的 AI 服务或真实网站)
uv run autoapply serve 只启动服务,在终端里运行
uv run autoapply tray 托盘启动器
cd frontend && npm run dev 界面的开发模式
uv run python scripts/demo.py --serve 8020 一份全是虚构数据的演示实例(截图用的就是它)
uv run python scripts/make_release.py 打免安装的 zip
uv run python scripts/make_installer.py 打 Windows 安装包

目录:backend/autoapply(FastAPI、SQLite、Playwright;ats/ 是各系统的填表程序和页面自查,executor.py 是兜底链路,repair.py 是 AI 接手,llm.py 是各家 AI 服务和故障转移)、frontend(Vue 3)、scripts(打包、安装、演示)、docs。

发布。 改 pyproject.toml 里的版本号,在 CHANGELOG.md 里加上这一版的说明,然后:

git tag v1.2.3 && git push origin v1.2.3

发布流程会跑测试、构建四个安装包,在 Windows、macOS、Linux 上各自安装并启动一遍,都通过了才发布。

只往某个清单里加一项的贡献(一家雇主、一个职位站、一种第三方登录、一种邮箱、一个地区包、一种翻译)不需要了解整个程序,见 CONTRIBUTING.md。界面遵循 docs/DESIGN_SYSTEM.md。

社区

许可

PolyForm Noncommercial 1.0.0:个人使用和其他非商业用途免费。

各招聘网站的使用条款由你自己负责遵守。这个程序是用你自己的信息填写你自己的申请;它不是替别人投递或批量投递的工具。