career-ops

环境要求

• Node.js（npx 随 Node.js 一起提供，没有的话需要先安装）
• 一个本地 AI 编程 CLI：Claude Code / Codex / Qwen / OpenCode / agy / grok 等
• 生成 ATS 简历 PDF 时需要 Chromium（通过 npx playwright install chromium 安装）

安装与启动步骤

1. 1一键初始化

   在终端执行该命令，会把最新 release 克隆到 ./career-ops 目录并自动安装依赖

   npx @santifer/career-ops init

   复制

2. 2进入目录开 CLI

   切到 career-ops 目录，然后用你自己的 AI CLI 打开（claude / codex / qwen / opencode / agy / grok 任选）

   cd career-ops
   claude

   复制

3. 3对话式完成配置

   首次启动时 career-ops 会通过聊天引导你录入简历、个人画像和目标岗位，无需手工编辑任何文件

4. 4手动安装方式

   不想用 npx 时可用 git clone 方式；最后一行只在需要生成 PDF 时执行

   git clone https://github.com/career-ops-hq/career-ops.git
   cd career-ops && npm install
   npx playwright install chromium

   复制

5. 5全局安装命令

   装好后终端任意位置都能直接使用 career-ops 命令，适合已有项目目录、想直接调用的场景

   npm i -g @santifer/career-ops

   复制

6. 6环境自检

   在 career-ops 目录运行，检查所有前置条件是否满足，有缺失按提示补齐后再继续

   npm run doctor

   复制

7. 7使用各功能模式

   在 AI CLI 中用斜杠命令：scan 扫描职位、pdf 生成简历、tracker 看进度、apply 填表等；也可直接粘贴 JD 或职位链接

   /career-ops scan
   /career-ops tracker
   /career-ops pdf

   复制

如何确认成功

npx init 后能生成 career-ops 目录并进入 AI CLI；执行 npm run doctor 显示前置条件全部通过，即安装成功。

常见问题

注意事项

• 整个系统设计成由你的 AI 编程 CLI 自己来定制：模式、评分权重、谈判脚本等都可以直接让它改。
• email 模式只生成申请邮件草稿，不会自动发送、提交或点击任何东西。
• 首次配置全靠对话完成，不用手工改配置文件；更多细节见 docs/SETUP.md、docs/AUTOMATION.md、docs/FAQ.md。