用途:在需要检查或操作 Jobber 时,通过本地 jobber CLI 执行认证检查、身份查询、操作清单浏览与 GraphQL 调用。
命名与安装:npm 包名为 jobber-cli,CLI 二进制名为 jobber。优先使用已安装的二进制:jobber --help;一次性使用可执行 npx -y jobber-cli --help;源码检出场景执行 npm install、npm run build、node dist/cli.js --help。不要猜测其他包名。
首次检查:jobber auth status --json、jobber doctor --json、jobber whoami --json。若缺少认证,可从同一机器上已登录的 agent-browser 会话或附加浏览器导入:jobber auth import-agent-browser。也支持手动 cookie 头认证,但避免将 cookie 值写入 shell 历史、日志或聊天:printf '%s' "$JOBBER_COOKIE_HEADER" | jobber auth set-cookie-header --stdin。
常用读取:jobber operations list --json、jobber operations list --search client --json、jobber operations inspect ClientDefaults --json,以及通过 jobber graphql run 执行查询,支持 --operation-name、--query、--query-file、--variables-file 与 --json。
安全与限制:这是非官方私有接口适配器,本身较脆弱。优先只读操作再考虑变更,优先使用 --json 便于机器处理。不要打印、粘贴、存入仓库或提交 Jobber cookie 头;原始浏览器抓包、trace、cookie、存储状态与完整上游 JSON 导出都应排除在仓库之外。operations list 只是已发现的清单,不保证每个操作都已恢复查询文档;对不支持的工作流可先用 graphql run 做原型验证,再添加类型化命令。其他功能、收费与平台信息暂未提供。