geekgeekrun/plan/logger_usage.md

招聘端 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 包内任意模块中：

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 中可选增加：

{
  "logLevel": "debug"
}

合法值为 "debug" | "info" | "warn" | "error"。开发时可设为 "debug"，生产环境建议 "info" 或 "warn"。