recruiter: add boss auto browse/chat flows, webhook, and candidate tables

- Add recruiter-side automation core and run-core entry
- Extend sqlite-plugin with candidate info + contact logs
- Add UI routes/pages, IPC handlers, progress + log panel
- Document current status and plans under plan/

Made-with: Cursor

plan/logger_usage.md

@@ -0,0 +1,70 @@
+# 招聘端 logger 用法说明
+
+> **定位**：`packages/boss-auto-browse-and-chat/logger.mjs` 的 API、配置与使用约定。  
+> 最后更新：2026-03-18
+
+---
+
+## 1. 用途与级别
+
+- **用途**：招聘端推荐页、沟通页的统一日志输出，支持按级别过滤，避免生产环境刷屏。
+- **级别**（由低到高）：`debug` < `info` < `warn` < `error`。  
+  设置某一级别后，只会输出 **大于等于** 该级别的日志（例如设为 `info` 时，会输出 info / warn / error，不输出 debug）。
+
+---
+
+## 2. API
+
+| 接口 | 说明 |
+|------|------|
+| `setLevel(level)` | 设置当前最低输出级别。`level` 为 `'debug'` / `'info'` / `'warn'` / `'error'`；非法值会回退为 `'info'`。 |
+| `getLevel()` | 返回当前级别对应的数字（debug=0, info=1, warn=2, error=3）。 |
+| `debug(...args)` | 输出 debug 级日志，底层使用 `console.log`。 |
+| `info(...args)` | 输出 info 级日志，底层使用 `console.log`。 |
+| `warn(...args)` | 输出 warn 级日志，底层使用 `console.warn`。 |
+| `error(...args)` | 输出 error 级日志，底层使用 `console.error`。 |
+
+`debug` / `info` / `warn` / `error` 的调用方式与 `console.log` 一致，支持多参数和字符串替换。
+
+---
+
+## 3. 配置来源与谁调 setLevel
+
+- **配置项**：`config.logLevel`（来自 `~/.geekgeekrun/config/boss-recruiter.json` 或流程传入的 config 对象）。
+- **调用时机**：由主流程在**读取 config 之后**调用一次 `setLevel`，后续所有模块共享同一级别。
+- **实际调用位置**：
+  - **推荐牛人**：`index.mjs` 在启动时读取 `boss-recruiter.json`，调用 `setLevel((readConfigFile('boss-recruiter.json') || {}).logLevel || 'info')`；配置热更新时再次 `setLevel(config?.logLevel || 'info')`。
+  - **沟通页**：`chat-page-processor.mjs` 启动时根据传入的 `config` 调用 `setLevel(config.logLevel || 'info')`。
+- **默认级别**：未配置或配置缺失时为 `'info'`。
+
+---
+
+## 4. 在业务模块中的使用方式
+
+在 `boss-auto-browse-and-chat` 包内任意模块中：
+
+```javascript
+import { debug as logDebug, info as logInfo, warn as logWarn, error as logError } from './logger.mjs'
+
+// 按需使用，语义与级别一致
+logDebug('详细调试信息', someObject)
+logInfo('正常流程提示')
+logWarn('可恢复的异常或边界情况')
+logError('错误信息', err)
+```
+
+约定：业务模块**只使用** `debug` / `info` / `warn` / `error`，**不调用** `setLevel`；`setLevel` 仅由 `index.mjs` 与 `chat-page-processor.mjs` 在读取 config 后调用。
+
+---
+
+## 5. 配置文件示例
+
+在 `boss-recruiter.json` 中可选增加：
+
+```json
+{
+  "logLevel": "debug"
+}
+```
+
+合法值为 `"debug"` | `"info"` | `"warn"` | `"error"`。开发时可设为 `"debug"`，生产环境建议 `"info"` 或 `"warn"`。