跳到主内容
文章阅读

Offer 手账

2026/10/09138 次阅读15 分钟

Offer 手账:把秋招中的零散信息,整理成可执行、可追溯的求职工作台

秋招开始后,我遇到的一个实际问题是:投递记录越来越多,信息却散在不同地方。招聘官网里有投递进度,邮箱里有笔试和面试通知,表格里记着公司与岗位,文件夹里放着不同版本的简历。每次准备下一轮面试,都要重新找邮件、翻岗位要求,再回忆上一轮问了什么。

投递几十家公司之后,这些事情很容易变成一项额外的日常工作。哪些公司还没有回复,哪场笔试快要截止,哪个岗位已经进入下一轮,都需要不断核对。

我希望做一个能自己长期使用的桌面工具,把这些信息放在一起,也让 AI 能基于真实记录帮我处理事情。这个项目现在叫 Offer 手账,主要面向秋招学生,围绕投递后的跟进、准备和复盘展开。

这篇文章会介绍它目前的功能,更详细地记录两个我在开发中持续思考的问题:怎样让 Agent 真正执行任务,以及怎样保证它和用户共同操作时,数据仍然可靠。

项目仓库:zzx666-code/recruitops-agent。项目基于 原 RecruitOps 项目继续开发,保留原有开源许可与组件声明。原项目提供了招聘数据、工具接口和 Agent 运行等基础设施,我在此基础上围绕自己的秋招流程进行产品调整、功能扩展与故障修复。下文涉及的架构包含继承的基础设计,也包含后续迭代中的取舍。

迭代中,我使用 AI 辅助阅读源码、实现改动和排查问题,也根据实际使用反馈不断修正需求。文中会重点说明需求为什么这样调整、哪些结果需要验证,以及实现中有哪些边界。具体代码的生成过程与设计判断同样需要被审视。

一、先想清楚:这个工具每天应该帮我做什么

早期工作台包含岗位发现、公司发现、岗位匹配等功能。这些能力适合还在寻找投递目标的时候。随着我已经投递的公司增多,实际使用重心发生了变化。

我每天更关心的是:今天要做哪些事情,昨天的笔试有没有完成,某家公司的投递状态是否更新,下一轮面试应该准备什么。

因此,后续界面逐渐围绕“已经投递之后怎么办”来组织。首页改成今日待办;原来的校招发现与公司页面,改成从投递记录生成的已投公司目录;求职助理的快捷入口也做了精简,减少与当前使用场景关系不大的操作。原有爬取能力仍保留在底层,界面入口的调整不等于删除全部后台基础设施。

这个过程中,我开始把“能增加什么功能”和“用户每天会打开什么功能”分开考虑。对一个个人桌面项目来说,使用频率和操作成本比页面数量更值得关注。

目前主要流程可以概括为:

保存投递记录 → 同步招聘邮件或复核官网进度 → 生成待办与日程 → 按时处理 → 记录笔面经历 → 准备下一轮 → 回看投递结果。

这条流程也决定了各个页面之间的关系。邮箱解析出一个笔试事项后,它应该能进入待办;用户完成这个事项后,提醒应随之停止;笔试结束后留下的记录,又应该能用于下一轮准备。每个功能都有自己的位置,同时需要通过同一份业务数据连接起来。

二、目前实现了哪些功能

投递记录与笔面记录

投递记录保存公司、岗位、阶段、投递日期以及投递记录页网址。用户可以直接切换到笔试、面试、Offer、已挂等阶段,变化会进入历史记录。已有表格也可以通过 CSV 或 JSON 导入,减少重新整理数据的成本。

在此基础上,我增加了按轮次保存的笔试、面试和测评记录:考了什么、问了什么、自己的回答如何、哪里没答好、下一轮需要准备什么。这些记录与投递阶段分别保存,官网进度同步不会把用户的面试笔记覆盖掉。

“准备下一轮”会把当前公司、岗位和已有记录带到求职助理中,用户也可以选择已经上传的 PDF 简历。这样助理拿到的是明确的上下文,而不需要从一段模糊的聊天里猜测个人经历。

招聘邮箱、今日待办与邮件提醒

招聘邮箱通过 IMAP 同步邮件,识别测评、笔试、面试等需要处理的事项。宣讲会和广告默认不进入任务清单,减少噪声。待办可以标记已完成或忽略,也可以打开原邮件核对要求。

今日待办把安排分成今天要做、已过时间仍待处理、未来七天和时间待确认。邮箱通知中的信息并不总是完整:有的给出准确时刻,有的只有日期,有的只说后续另行通知。系统会保留这些差别,日期或时间不明确时展示待确认状态。

邮件提醒使用 SMTP,发送到用户已配置的招聘邮箱。对于有具体时刻的事项,按提前分钟数计算提醒时间;对于只有日期的事项,使用当天提醒时间。软件在运行或缩到托盘时检查提醒,重启后也会检查尚未发送的过期事项。

已投公司、简历和投递复盘

已投公司页面从实际投递记录生成目录,同一公司的多个岗位集中展示。模型辅助查找官网、核对公司身份,并整理业务、产品、行业等资料;公开风评需要有足够的公开讨论依据。资料可以手动修改,点击公司名称可以打开官网。

我的简历页面支持保存多份 PDF、预览和下载。在线编辑部分接入外部简历网站,减少重复建设;从编辑网站下载的简历可以进入本地简历库。桌面浏览器还支持网站标签页、收藏网址和持久化登录状态,方便反复进入不同招聘系统。

投递复盘则围绕投递日期与阶段统计展开。用户可以查看每周投递节奏,点击某一天查看当天投递的公司和岗位,也可以查看近期笔面与测评安排。图表下面能继续看到具体记录,让数字可以被核对。

三、整体架构:把界面、Agent 和业务服务分开

项目采用本地桌面运行方式。桌面壳使用 Electron,工作台前端主要由 HTML、CSS 和 JavaScript 组成,Python 与 FastAPI 提供本地 API,PostgreSQL 保存结构化业务数据。浏览器操作使用相关浏览器能力,原有基础设施中也包含 Playwright 和 pgvector 等组件。

Agent 部分使用 Codex App Server 作为运行时,业务能力通过 MCP 工具暴露。这里的运行时负责会话、回合、工具调用、流式输出等工作;实际模型由用户配置的连接决定。 image 界面上的普通编辑操作也能通过 API 直接调用业务服务,不必让模型参与每一次点击。点击“已完成”是一项确定操作,交给普通业务接口处理更直接;“结合这家公司的岗位和我的上轮记录,帮我准备面试”则需要模型理解和组织信息。

我希望这几层之间的职责足够清楚:

层次主要职责
工作台与桌面壳展示状态、收集操作、管理窗口和网站标签页
Agent 运行时管理对话、模型交互和工具调用过程
MCP 工具层提供结构化输入输出,检查能力与操作边界
业务服务执行校验、事务、状态更新、任务编排与外部访问
数据存储保存业务事实、历史、任务状态和处理凭据

这种组织方式让模型连接和业务代码可以分别演进,也使一个故障更容易被定位到具体环节。

四、Agent 设计:把自然语言请求落到明确的业务动作

1. 先区分查询、分析和执行

用户在同一个聊天框里可能提出完全不同的需求。

“我最近有哪些面试”需要读取结构化日程;“我上轮面试哪里准备不足”需要读取笔面记录并分析;“每天十点帮我复核投递进度”则需要创建定时任务。

这些请求的区别要体现在工具调用上。精确的投递数量、阶段和日期从业务存储查询,个人经验等非结构化材料才适合知识检索。尤其是“面试阶段有几条记录”这种问题,直接按条件查询数据库能给出可核对的结果。

模型负责理解用户想做什么、选择工具、解释返回结果。字段校验、权限判断、数据库提交和任务状态转换由程序执行。模型生成的一段文字,不能成为“已经写入”的依据。

2. 工具需要表达实际能力

在迭代中,曾经出现过邮箱连接测试成功,实际同步却提示功能未启用的情况。这里涉及几种不同状态:账号能否认证、网络能否连通、邮箱功能是否启用、业务写入是否允许。

如果界面和助理只看到“测试通过”,就很容易把这些状态混在一起。因此,运行时提供能力信息,助理应根据当前工具是否可用、写入是否启用、所需配置是否完整来决定下一步。

默认关闭业务写入是项目保留的边界。用户对当前实例明确启用后,受控工具才能执行相应操作。遇到限制时,需要给出真实的原因和可操作的入口,不能靠修改提示词让模型绕过检查。

3. 接收任务和完成任务要分别表达

假设用户说:“立即在后台执行一次全量岗位爬取,包括公司发现、岗位抓取、职位详情补全和匹配评分。”

正常链路是模型理解请求后,调用高层同步工具;工具创建或接续运行,保存任务标识、范围与状态;确定性的后台流水线负责公司发现、岗位检测、详情补全、持久化和评分;之后通过状态查询获得真实进度。

当前日常全量流程的公司发现来源包含 OfferBiu 快照,并按规则合并已有来源。“全量”的含义是这次运行确定的完整公司目录,覆盖范围受来源和抓取能力约束。因此,向用户报告结果时也要说明范围,不能把它扩写成全互联网的招聘信息。

高层工具返回已接收或正在运行时,助理只能说明任务已经启动。抓取完成了多少、多少失败、哪些详情不足,都要以当前运行的结果为准。旧任务的成功记录,也不能被当作这次执行成功。

4. 长任务交给可恢复的流水线

爬取、批量复核等任务会受到网络、登录状态、验证码和网站变化影响。如果让模型在对话里逐家公司规划和保存进度,一旦对话超时,任务状态就很难判断。

项目把这类工作交给后台服务,保存运行状态和检查点。模型可以发起任务、查看进度、请求控制,但执行范围和完成记录留在程序里。恢复时需要沿用已确定的范围与检查点,避免同一次任务在续跑时悄悄扩大范围。

聊天回合、后台运行和数据库写入还有各自的生命周期。对话结束后,已经启动的某些后台任务可以继续;删除聊天也不会撤销已经完成的写入。停止后台任务需要明确的控制动作,并等待停止状态确认。软件完全退出或电脑关机后,本地任务也不能继续执行。

5. 模型服务和 Agent 运行时分别处理

用户使用智谱模型时,界面曾出现“Codex 流连接中断”。这类文案容易让人误以为实际模型被切换了。

实际上,模型提供方、Agent 运行时和流式连接是不同层次。智谱提供模型推理,Codex App Server 管理对话与工具循环,本地 API 再把状态传给前端。

项目中的 GLM 本地适配接口把运行时使用的 Responses 请求转换成 Chat Completions 请求,并处理文本、工具调用、工具结果和返回事件。它实现的是当前运行所需的协议子集,不能据此声称完整兼容所有 Responses 功能。

这一点让我更重视接口之间的契约。增加一个模型服务,需要在连接配置之外,核对工具参数、命名空间、流式参数增量和结束状态。报错时也应区分上游模型拒绝请求、本地运行时异常和前端连接中断。

五、数据一致性:先明确什么是独立的业务事实

这个项目的数据会从多个入口改变:用户手动编辑、表格导入、招聘邮件解析、官网状态复核、后台公司资料整理,还有提醒发送。

只要多个入口能修改同一份数据,就会遇到重复、覆盖、迟到结果和部分失败。我的处理思路从业务事实的划分开始。

投递日期、当前阶段和笔面经历分别保存

一条投递至少包含三类事实:什么时候投递、现在进入什么阶段、过程中发生过什么。

例如,9 月 20 日投递的岗位,在 10 月 5 日进入面试,投递日期仍然应该是 9 月 20 日。若用最后更新时间统计投递节奏,修改阶段也会被算成当天新投递,复盘图表就失去原来的意义。

因此,投递日期使用独立字段保存,阶段变化进入历史,笔面记录再单独关联到投递记录。修改日期时记录日期修正,避免制造一次并不存在的阶段变化。

这看起来是一个字段设计问题,却会影响整个产品:投递趋势能否正确统计,下一轮准备能否找到上一轮记录,用户能否理解一条记录为什么变成当前状态,都依赖这些事实被分开处理。

六、导入记录:覆盖旧值,同时保留已有关系

导入功能经历了一次比较典型的需求变化。开始时,重复记录被跳过;后来我的需求变成:如果已有记录和导入记录相同,应以导入文件为准。

直接删除旧行再插入,会影响关联的笔面记录、日程和历史。因此,处理方式调整为:匹配原记录,在原记录上更新字段,保留原来的标识和关联关系。

当前投递导入使用公司名与岗位名的精确组合作为匹配依据,并生成相应摘要。这个规则可以稳定解释和复现,也有明确局限:公司简称变化、岗位名称不同,可能被视为不同记录。模型辅助判断公司身份用于公司资料整理;把两个投递合并,是另一项会影响关联数据的业务操作,不能直接复用一次身份判断就自动执行。

导入流程先读取并校验全部行,再进入写入事务。日期、阶段和网址有问题时,整批数据不会部分写入;错误应尽量指向具体行和字段,方便修正。

日期支持“月.日”,例如 9.20,默认使用当前年份;留空则使用导入当天日期,跨年记录可以填写完整日期。空岗位可规范化为“岗位未注明”,已知的阶段别名按规则处理。无法明确判断的内容仍需要用户核对。

进入事务后,PostgreSQL 中使用身份对应的事务锁,并对匹配记录加锁,再比较新旧字段。发生变化时更新原记录并追加历史;内容没有变化时保持原样。重复导入同一份完整且规范化后的数据,应尽量成为没有额外变化的操作。

这里还有一个容易忽略的边界:留空日期意味着“导入当天”。同一份留空日期的文件在不同日期导入,规范化结果本来就可能不同。因此,幂等性要结合输入语义理解,不能只比较文件字节是否一致。

用户明确导入的阶段可以用于纠正旧数据,即使是把阶段改回较早的状态,也应保留修正历史。自动同步观察到的状态则需要自己的校验规则。把所有更新都套成“阶段只能向前”,会阻碍用户纠错。

七、并发和迟到结果:旧结果不能覆盖新操作

编辑时检查版本

用户打开一条记录后,后台可能已经更新了它。如果用户基于旧页面保存,直接覆盖就会丢失后台新状态。

部分编辑接口会要求提交 expected_updated_at,服务端在事务中核对实际更新时间。版本不一致时返回冲突,让用户刷新后再保存。这种乐观并发控制适合低冲突的交互编辑,也能让“记录已变化”成为明确的状态。

公司资料整理时检查任务归属

自动整理公司介绍通常需要先读取网页,再调用模型,耗时比一次普通编辑长。期间用户可能已经修改介绍、修正官网,或者点击停止。

后台收集任务因此保存领取凭据、有效期和修订号。结果写回时重新检查:凭据是否仍属于这次收集,修订号是否变化,公司是否仍在已投目录中。用户编辑、停止或新的任务尝试会使旧结果失效。

这样,后台完成得晚,并不会自动获得覆盖用户操作的权利。事务解决写入时的原子性,版本与凭据检查解决“这个结果现在是否仍有效”,两者处理的是不同问题。

前端同样需要处理迟到响应

删除求职助理对话时,我曾遇到明显的等待感。删除完成的反馈被后续会话加载、运行时恢复和列表刷新拖住;与此同时,删除前发出的请求还可能在稍后返回,把旧内容重新画到页面上。

调整后,删除成功会及时反映到当前界面,下一会话的加载独立进行。运行时恢复放到实际发送消息时处理,减少切换阶段的额外工作。前端还通过请求取消、请求标识和已删除状态,阻止旧响应重新填充已清理的会话。

这个修复让我认识到,用户感受到的延迟,经常来自操作之间的等待关系。一次删除动作不应被无关的后续加载拖住。数据一致性也延伸到了界面:数据库里已经删除的会话,页面不能又被迟到响应恢复出来。

八、邮件提醒:承认外部操作存在不确定状态

提醒涉及数据库和 SMTP 服务,无法用一个本地事务把两个系统一起提交。

假设邮件服务器已经接受了邮件,但本地连接随即中断,程序没有收到明确回执。这时重新发送可能造成重复;把它标成成功又可能误报。

项目用持久化提醒凭据记录发送过程。提醒身份由事项、目标时间等信息组成,邮件渠道还包含收件账号范围。发送前领取任务,保存领取期限;明确成功后记录已发送,明确失败时进入可重试状态;发送阶段出现无法确认的结果则进入 uncertain。

uncertain 状态不会无限自动重发,用户需要先核对收件箱,再选择重试。发送成功后本地记录回执失败,也要考虑这一风险。稳定的邮件标识可以辅助核对,但无法替所有邮箱服务保证去重,更不能保证最终进入收件箱。

这是一项实际取舍:降低重复发信风险,同时向用户展示尚未确认的状态。系统可以改善重试与恢复行为,但不能把跨数据库和外部邮件服务的过程宣传成严格的“只执行一次”。

提醒时间的交互也由真实使用推动过调整。19:00 的笔试,提前 30 分钟应在 18:30 提醒;只有日期、没有具体时刻的事项,才使用用户设置的当天时间。把这两个设置写清楚,并展示下一次提醒,比只显示“设置已保存”更有帮助。

九、一次导入故障,让我重新看待“格式正确”

导入过程中遇到的几次故障,分别发生在前端调用、字段解析和文件读取环节。

有一次点击导入直接报 upload is not defined,请求尚未到达后端,问题出在前端调用了缺失的上传辅助函数。另一次是阶段、空岗位和日期写法没有被正确解释,需要完善规范化规则及逐行错误提示。

还有一份文件虽然扩展名是 .csv,内部却是 Excel 工作簿的压缩内容。外观和文件名都不足以证明真实格式符合解析器要求。那次处理需要把文件转换成真正的文本 CSV;这也不代表当前导入接口已经支持直接读取所有 Excel 文件。

这些经历让我把排查路径拆得更细:文件选择是否成功,浏览器是否读到了内容,请求是否发出,编码和实际格式是否匹配,字段是否有效,事务是否提交。泛泛的“导入失败”会把不同故障压到同一句话里,也把排查成本推给用户。

后续改进的重点是更早识别格式、更明确指出出错位置,并保留整批校验后再写入的原则。宽容解析适合含义明确的常见写法;对于无法确定的业务信息,需要让用户知道哪里仍需确认。

十、桌面化带来的便利和成本

我选择桌面应用,主要是为了把本地资料、招聘网站、邮箱和后台任务放在一个长期可使用的环境里。用户进入官网时可以继续完成登录、验证码和最终提交;这些环节保留给用户操作。

网站使用持久化浏览器会话,重启后可以保留登录状态。不过会话能否继续使用还受网站过期策略影响,系统加密的数据也可能与设备、用户环境绑定。把程序目录复制到另一台电脑,不能据此保证所有登录状态一起迁移。

程序文件、业务数据、简历文件、浏览器资料和凭据各有自己的存储位置与生命周期。桌面发行版默认会使用程序旁的 .data,实际数据位置还会受到启动方式和实例配置影响。便携程序能够被拷走,完整数据迁移仍需要明确的备份范围和恢复流程,这也是我认为值得继续补齐的能力。

另一项成本是发行包体积。桌面包包含 Electron 及 Chromium、Python、Node.js、PostgreSQL 等运行环境,目的是让用户少安装依赖。文件夹很大描述的是磁盘占用,运行时内存需要另外观察。后续优化应区分必要运行时、重复构建产物、缓存和用户数据,逐项测量。

本地部署也需要准确描述隐私边界。业务记录主要保存在本地,配置的模型服务仍可能接收完成分析所需的上下文,邮件与官网操作同样需要网络。项目应持续限制发送内容,避免把密钥、Cookie、完整浏览器资料等带入提示或公开仓库。

十一、我怎样验证这些改动

对这类项目来说,页面能打开只能证明一部分事情。我更关心一项操作后,关联数据和后续行为是否符合预期。

导入测试需要覆盖新建、覆盖、重复导入、日期修正,以及无效行导致整批不写入;公司资料测试需要覆盖收集期间手动编辑和停止,验证旧结果失效;提醒测试需要覆盖明确成功、明确失败、结果不确定和重启后的处理。

前端则需要覆盖真实交互路径,例如点击导入按钮、删除后切换会话、旧响应迟到,以及移动端布局和键盘操作。模型适配还要核对工具调用、参数与流式事件,避免普通文本能返回就被误认为 Agent 已经可用。

这些场景尽量使用确定性的模拟数据和可控制的依赖,方便稳定复现。真实招聘网站、邮箱和模型接口单独验证,因为它们受到网络、站点结构、账户和模型行为影响。模拟测试通过与真实服务验证通过需要分别记录,避免把测试结果解释得过宽。

十二、当前边界,以及下一步值得做什么

Offer 手账已经能覆盖我的一段实际秋招流程,仍有需要继续打磨的地方。

首先是数据迁移和备份。桌面工具会被用户换目录、换电脑,数据库、简历、配置和登录资料需要有清晰的导出范围;设备绑定的敏感信息则需要另行说明。

其次是公司与岗位身份管理。精确名称匹配容易解释,却无法处理所有别名;模型判断可以辅助核对,真正合并关联记录还需要可审查的过程和修正方式。

另外,招聘官网的状态复核会受到登录、验证码和页面改版影响。系统需要把“确认发现变化”“暂时无法观察”“需要用户处理”区分开。公司风评也依赖公开材料的质量与时效,适合作为准备时的参考,保留用户修正入口。

模型协议适配还需要更多契约测试,尤其是不同模型对工具调用的支持差异。定时任务目前依赖本地软件持续运行,若未来需要关机后执行,就要重新设计远程运行、账户与敏感数据边界。

我希望优先补齐这些长期使用会遇到的问题,让已有流程更稳定,再决定是否扩大功能范围。

十三、这个项目带给我的思考

从自己的使用习惯出发迭代一个工具,能看到许多最初设计时没有考虑到的细节。用户说“没有收到提醒”,可能是触发规则没有解释清楚,也可能是 SMTP 尚未配置;用户说“导入格式正确”,需要继续核对实际文件内容;用户说“删除很慢”,则要检查完成反馈是否被后续加载拖住。

这些问题让我把注意力放到完整流程:输入来自哪里,系统如何解释,谁有权修改,结果如何保存,失败后怎样恢复,用户能否知道当前状态。

Agent 在这里承担理解和协调工作,业务服务负责把动作执行成可验证的结果。工具返回值、版本校验、事务、历史和处理凭据,帮助自然语言操作落到明确的系统行为上。数据一致性也体现在许多细节中:同一条投递保留原有关联,修改阶段不改变投递日期,手动编辑使旧后台结果失效,邮件发送不确定时留下可核对的状态。

对我来说,Offer 手账目前最有价值的地方,是把真实使用中不断出现的问题变成具体的设计约束。它让我有机会同时思考产品流程、Agent 边界和数据可靠性,也留下了可以继续验证、修正和扩展的代码基础。


项目地址: Offer 手账 / recruitops-agent

原项目地址: RecruitOps

阅读源码的入口: packages/codex_runtime/instructions.py 与 packages/mcp/server.py 对应 Agent 的行为约束和工具接口;apps/api/model_adapter.py 对应 GLM 协议适配;apps/api/configuration.py 与 apps/api/local_ui.py 对应导入及投递编辑;packages/applied_companies.py 对应公司资料的收集与版本检查;packages/desktop_reminders.py 和 packages/email_reminders.py 对应提醒凭据与 SMTP 发送。