# JiaErCSearchJob **Repository Path**: JiaErC/JiaErCSearchJob ## Basic Information - **Project Name**: JiaErCSearchJob - **Description**: 我个人的AI寻找工作的项目 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-15 - **Last Updated**: 2026-11-15 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # JiaErCSearchJob 本地优先的 **AI 找工作工作台**:经历库、简历生成、平台账号、投递追踪、能力差距,外加两条服务线路(岗位线 / 用户线)。 - 前端:网页工作台(Obsidian 式 Markdown 编辑、简历预览导出、投递看板、AI 对话) - 后端:Node 22+,**零第三方依赖**,双击 `start.bat` 就能跑 - 数据:四个目录就是唯一事实来源,全部可被 AI 读写,也可被你自己用编辑器改 - 生态:自带 Agent Skill + MCP 服务,能装进 DSH / Claude Code / Codex / Cursor / Gemini CLI ## 快速开始 1. 确认装了 **Node.js ≥ 22**(`node --version`)。 2. 双击 **`start.bat`**:打开一个常驻终端窗口跑服务,并自动在默认浏览器里打开工作台。 - **窗口保持打开 = 服务在运行;关掉窗口 = 停止服务**,不会在后台留下进程。 - 已经启动过再双击:不会再开第二个实例,只把浏览器叫到已有地址。 - 等价的命令行:`node server/index.mjs --open --exit-with-parent`(去掉 `--exit-with-parent` 就不会跟着窗口退出)。 3. 浏览器打开 (端口被占用时会自动换,地址以窗口里显示的为准)。 4. 第一次用,先到 **设置 → AI** 填一个供应商(DeepSeek 兼容 OpenAI 协议,Base URL `https://api.deepseek.com/v1`,模型 `deepseek-chat`)。 5. 回到 **经历库** 写第一段经历;**简历 → 配置与预览** 看一眼效果。 > 没有 AI 也能用:经历/简历/投递/能力全都能手动编辑,PDF 导出不依赖 AI。 ## 七个模块 | 模块 | 能做什么 | 数据在哪 | | --- | --- | --- | | 工作台 | 今天该做什么、谁改了什么、岗位线状态 | — | | 经历库 | 三栏 Markdown 编辑、按类型套模板、AI 起草/润色、wiki 链接 | `experience/` | | 简历 | 基本信息键值对、照片、简介、模板上传、A4 预览、导出 PDF/DOCX、Word/WPS 打开 | `resume/` | | 平台账号 | 绑定各平台、AES 加密保存、点图标跳聊天记录、AI 查漏 | `platforms/` | | 投递记录 | 全部 / 有回复 / 满足加分 / 面试中筛选,对话时间线,适配度明细 | `submission/record/` | | 待遇要求 | 基本要求 + 加分要求 + 绝对不接受,AI 从文字解析 | `submission/requirement/` | | 能力画像 | 全部能力(1-5 级 + 证据)、能力欠缺(AI 提议 → 你确认) | `capability/` | | 岗位类别 | 想投什么、绝对不投什么 | `resume/targets.json` | | AI 对话 | 用自然语言改数据源,工具调用实时可见 | `.state/chat/` | ## 两条服务线路 ``` ┌──────────── 同一份数据源 ────────────┐ 岗位线(Agent 会话驱动)─▶ experience / resume / submission / capability ◀── 用户线(收件箱) 搜索→评估→通知 │ .state/changelog.jsonl 记录每次变更 │ HR 回复 / 面试 / 差距 / 报错 可选自动投递 └──────────────────────────────────────────────┘ → 网页 SSE / 微信 / Webhook ``` - **岗位线**默认由 **Agent 会话**(DSH / Claude Code…)驱动:会话里说「跑一轮岗位线」,Agent 用 `jobsearch_line_lease → jobsearch_job_next → 执行 → jobsearch_job_submit` 逐步跑;规则评估仍在服务端算。 服务端定时是可选逃生舱(设置 → 岗位线 → 执行方式),两者不要同时开。 - **用户线**:`jobsearch_user_inbox` 取待处理的通知/差距/HR 对话;通知进右上角铃铛,微信通道见下一节。 - 每次运行在 `.state/runs/*.json` 留步骤记录;租约在 `.state/lines.json`。 ## 微信接入(不修改 dsh-weixin-player) 插件本身没有对外「主动发消息」的 HTTP 接口,所以这里用**三种不侵入**的方式: 1. **bridgeUrl**:你在设置里填一个自己的转发端,通知会 POST 过去(最实时)。 2. **outbox + `weixin_send`**:通知写进 `.state/outbox/`;装了本 Skill 的微信会话用 `weixin_send` 把它转给你。 3. **MCP 拉取**:微信会话通过 `jobsearch_outbox` / `jobsearch_pending_notifications` 主动取。 `E:\AI_dsh_plugin\dsh-weixin-player` 一行代码都不用改。详见 `skills/job-search/references/wechat-bridge.md`。 ## 简历 PDF 怎么来的 - **HTML 模板 → PDF**:Edge/Chrome 无头打印(与网页预览一致);没有浏览器时回退 Word/WPS 打开 HTML 另存 PDF。 - **DOCX 模板 → PDF**:Word/WPS 填充 `{{占位符}}` 后转 PDF。 - **DOCX 导出**:Word COM → 失败时用纯 JS 的 OOXML 生成器(不需要 Office)。 - **打开**:Word / WPS / 系统默认程序。 导出文件在 `resume/user_resume/exports/`,网页里可以直接「下载 / 打开 / 用 Word / 用 WPS」。 ## 目录结构 ``` JiaErCSearchJob/ ├─ start.bat / start.ps1 # 双击启动 ├─ AGENTS.md # 给 AI 的项目入口 ├─ project.manifest.json # 机器可读的目录约定 ├─ server/ # 零依赖 Node 服务 │ ├─ index.mjs # HTTP + SSE + 静态 │ ├─ lib/ # store / ai / resume / docx / pdf / browser … │ ├─ routes/ # 业务接口 │ ├─ lines/ # 岗位线 / 用户线 │ ├─ ai/ # 系统提示词 + 工具 │ ├─ channels/wechat.mjs # 微信桥 │ ├─ templates/ # 内置简历模板源文件 │ └─ mcp-server.mjs # MCP(stdio) ├─ web/ # 前端(无构建) ├─ skills/job-search/ # 可安装的 Agent Skill ├─ scripts/ # 启动辅助 / 自检 / 安装 Skill / UI 冒烟 ├─ experience/ # 经历(Markdown) ├─ resume/ # 简历 ├─ submission/ # 投递 + 要求 ├─ capability/ # 能力 + 短板 ├─ platforms/ # 平台目录 + 加密账号 ├─ .config/ # 设置、AI Key、主密钥(不要提交) └─ .state/ # 日志、通知、聊天、运行记录、变更日志 ``` ## 安装 Skill 到别的 Agent 工具 ```powershell node scripts/install-skill.mjs # 交互式选择 node scripts/install-skill.mjs --target all --scope project node scripts/install-skill.mjs --target claude --scope user ``` 支持:DSH(`.dsh/skills`)、Claude Code(`.claude/skills`)、Codex/Antigravity(`.agents/skills`),以及用户级目录。 也可以只把 MCP 服务挂上去:命令 `node <项目>/server/mcp-server.mjs`,传输 `stdio`。 ## 隐私 - 平台账号、AI Key:AES-256-GCM 加密;只显示掩码;查看明文要二次确认并写审计日志。 - 主密钥在 `.config/master.key`(权限 600);可在设置里开启**口令模式**,启动后需解锁。 - 服务只监听 `127.0.0.1`,并校验 Origin,只允许本机页面调用。 - 所有数据都在本机;没有任何遥测。 ## 自检与测试 ```powershell node scripts/doctor.mjs # 环境依赖、浏览器、Office、AI 配置 node scripts/smoke-ui.mjs # 用 CDP 打开 10 个页面并截图(需先开服务) node --test # 单元测试 ``` ## 常见问题 - **端口被占用**:会自动往后找端口,看启动窗口里的地址。 - **重复双击 start.bat**:只会提示「已经在运行」并打开浏览器,不会再起一个实例;确实要开第二个(例如换端口调试)加 `--no-single-instance`。 - **关掉终端窗口后网页打不开**:这是设计如此——服务跟着窗口一起退出,避免后台僵尸进程;重新双击 start.bat 即可。 - **PDF 生成失败**:先看「设置」里的 Word/WPS/浏览器检测结果;Edge 路径不存在时填 Chrome 路径。 - **AI 说没有权限**:AI 只能写四个数据目录,这是故意的。 - **改了文件网页没变**:经历列表不会自动刷新,点一下左侧类型或按 F5;变更已经记进 changelog。 - **不想被 AI 改某段内容**:在正文里写清楚,或把文件移出四个目录(AI 只写这四个目录)。 ## License MIT