第4章 career-ops 快速上手指南
快速上手 用大约15分钟开始使用 career-ops:安装这个开源AI求职系统,打开你的AI命令行工具,评估你的第一份职位。全程无需编写代码。 首次使用,本指南将在约15分钟内带你从零完成第一份职位评估。你需要搭建工作区,打开AI编码助手,粘贴一份职位描述。智能体将自动完成必要的引导设置,随后提供完整报告、评分以及定制的PDF简历。
所需准备 你不需要懂编程。只需熟悉打开终端并运行命令即可。 不熟悉终端?如果你从未用过命令行,完全没问题——但这篇指南不适合初学者入门。想快速上手,建议阅读 freeCodeCamp 的《初学者命令行手册》。它涵盖了跟随本指南所需的全部内容。待你能熟练打开终端并运行命令后,回来从第1步继续。 AI编码助手安装 Claude Code、Codex、OpenCode、Qwen Code 或 GitHub Copilot CLI——运行该系统所需的AI编码助手。career-ops 对11种命令行工具提供一等支持;安装任意一种并登录即可继续。 Node.js 22.13+安装 Node.js——版本需在22.13及以上(若使用Node 23,则需23.4及以上)。它用于运行辅助脚本和生成PDF。旧版本会无法通过设置检查,因为跟踪器的SQLite索引需要更新的Node。运行 `node --version` 检查版本。 Git安装 Git——脚手架内部使用。大多数电脑已预装。检查方法:打开终端运行 `git --version`。
第1步:设置工作区 在你希望 career-ops 存放的文件夹中打开终端。推荐路径只需一条命令;高级路径使用 git clone,见下方。如果缺少 Node(22.13+,或Node 23的23.4+)或 Git,npx 将拒绝运行——请先安装二者(参见上文先决条件)。
推荐 — 一条命令 终端 `npx @santifer/career-ops init` 这会将最新发行版克隆至 ./career-ops,安装依赖并搭建工作区结构。它还会检测你已安装的AI命令行工具,并告知你应使用的启动命令。仅在新文件夹中安装:若 ./career-ops 已存在且非空,命令将报错并中止,不做任何更改;因此重复运行无法修复或更新现有工作区。 完成后进入工作区: 终端 `cd career-ops`
高级 — 自行克隆仓库如果你希望跟踪特定分支、贡献代码或在安装依赖前审计代码,请使用此路径。终端 `git clone https://github.com/career-ops-hq/career-ops.git` `cd career-ops` `npm install`
无头浏览器(一次性) career-ops 在多项任务中使用无头 Chromium:渲染PDF、检查职位是否仍在招聘、运行完整ATS扫描。安装程序在依赖安装后会自动配置;若该步骤在你的机器上失败,请手动安装: 终端 `npx playwright install chromium`
第2步:打开你的AI助手 在 career-ops 文件夹内,启动你已安装的AI命令行工具。 终端 `claude` 终端 `codex` 终端 `opencode` 终端 `qwen` 终端 `copilot` 终端 `agy` 终端 `pi`
需要个人资料时才会开始引导 在进行首次职位评估或其他需要个人资料的流程前,career-ops 智能体将检查你的设置,并在必要时进行简短的引导对话。你也可直接请求运行引导。它会询问你的简历、目标职位类型、薪酬范围及地点偏好。你用自然语言回复,智能体会为你编写配置文件。会话耗时约两到三分钟。浏览工作区、查看代码或诊断设置不会启动引导或创建个人资料文件。 开发者说明:设置检查运行 `node doctor.mjs --json`,仅读取数据。引导通过 `node doctor.mjs --json --init-templates` 从模板创建缺失的个人化文件(modes/_profile.md、modes/_custom.md、modes/_brief.md 和 voice-dna.md),绝不会覆盖你已有的文件。 你可能看到的无关提示某些命令行工具(如 Claude Code)首次打开新文件夹时会询问你是否信任该文件夹中的文件。该提示来自命令行工具本身,而非 career-ops。选择“是”以继续。接受它不会启动 career-ops 引导。 使用 Claude Pro 或 Max?检查本次会话的计费方式在首次评估前,在 career-ops 文件夹运行 `node doctor.mjs`。它会一行报告你的计费来源。如果环境中设置了 ANTHROPIC_API_KEY,你的命令行工具将使用它并按token计费,即使你订阅了 Pro 或 Max。此优先级规则属于 Claude Code,而非 career-ops:doctor 仅检测并告知你。若需使用订阅账户,请从 ~/.zshrc、~/.bashrc、~/.profile 或项目 .env 中删除 `export ANTHROPIC_API_KEY=...` 行,重启终端并运行 `/login`。若你本意是使用API额度,则无任何问题。其他命令行工具各自设定订阅与密钥的优先规则,career-ops 不予检查。完整答案见FAQ。
第3步:运行首次评估 复制任意职位广告的URL,粘贴到聊天窗口。若个人资料未就绪,智能体将先完成引导。使用 Claude Code、Antigravity CLI 或 Pi 时,前缀加上明确命令;使用其他命令行工具时,直接粘贴URL并要求智能体运行自动流水线: `/career-ops auto-pipeline https://jobs.example.com/senior-engineer-ai` 使用职位URL运行自动流水线命令:https://jobs.example.com/senior-engineer-ai 使用职位URL运行自动流水线命令:https://jobs.example.com/senior-engineer-ai 使用职位URL运行自动流水线命令:https://jobs.example.com/senior-engineer-ai 使用职位URL运行自动流水线命令:https://jobs.example.com/senior-engineer-ai `/career-ops https://jobs.example.com/senior-engineer-ai` `/skill:career-ops auto-pipeline https://jobs.example.com/senior-engineer-ai`
若没有URL,可直接粘贴职位描述全文到聊天窗口。智能体将识别输入为职位并发布,自动运行完整流水线——这就是自动流水线。
后续步骤 粘贴职位后,career-ops 将自动执行以下操作: 读取职位描述理解职位角色、要求及薪酬。 读取你的简历从 cv.md 提取信息,找出与该职位的匹配项及差距。 为职位评分从1到5分,从职位匹配度、薪酬、远程政策等多个维度评估。 撰写报告将详细分析保存到 reports/ 文件夹。 生成定制PDF简历在 output/ 文件夹输出针对该职位定制的简历版本。 在跟踪器中新增一行在 data/applications.md 记录申请。 整个过程约需一到两分钟。完成后,career-ops 将展示评分及报告摘要。
解读结果 报告在“风险摘要”之后包含“评分证据”。它涵盖五个维度:简历匹配度、北极星对齐度、薪酬、文化信号及风险警示。每行记录证据状态(支持、部分或未知)、具体来源或观察结果,以及未解决的问题。该部分结尾附上证据置信度层级(高、中、低)、原因及最多三项验证优先级。 在 reports/ 中打开报告文件。文件名遵循 {编号}-{公司}-{日期}.md 模式。内容包括: 评分 — 1到5的数字。低于4.0表示该职位可能不是强力匹配。 A区块 — 职位的通俗英语摘要。 B区块 — 表格展示你的简历与每项职位要求的匹配情况及差距。 C区块 — 针对该职位的定位策略建议。 D区块 — 薪酬调研,将报价与市场费率对比。 E区块 — 申请个性化备注。 F区块 — 面试准备,针对该职位定制的STAR故事。 G区块 — 发布真实性:启发式检查信号,如职位是否仍在开放、是否频繁重发。它报告发现,判断权在你。 H区块 — 申请表格草稿答案,仅在评分4.5及以上时生成。
你的定制PDF简历在 output/ 文件夹中。发送前请仔细审阅——career-ops 未经你批准绝不会提交任何内容。
下一步操作 首次评估完成后,可尝试以下操作: 完善个人资料。向智能体提供关于你的新信息——“这里有更多背景:我刚刚发布了X。”它会更新资料,后续评估更精准。 评估更多职位。粘贴更多URL或职位描述。每一项都将添加到你的跟踪器。 扫描招聘板。输入 `/career-ops scan` 一次性搜索数十个预配置的公司招聘页。 对比offer。若有多份报告,输入 `/career-ops ofertas` 获取排名对比。
故障排除 发现bug或有问题? 若功能未按指南说明运行,请反馈。bug报告有助于后续所有用户。 报告bug:在GitHub仓库开启issue。描述预期与实际发生情况,粘贴看到的错误信息。 提问:加入Discord社区。这是获得其他用户及作者帮助的最快方式。 贡献修复:若你知道如何修复问题,在开启pull request前请阅读 CONTRIBUTING.md。简版规则:新功能、新模式或命令、架构变更需先开issue;bug修复、新的零认证扫描器提供者、文档及翻译可直接开pull request。
GitHub Star · 74.9K 设置免费AI引擎 以0元运行 career-ops — 无需Claude订阅或任何付费方案。career-ops 的免费AI引擎——使用免费提供方的OpenCode、通过Ollama的本地模型、任何OpenAI兼容端点、或内置的OpenRouter运行器——以及搜索中途token耗尽时的应对方法。