release: v0.5.0

joohw · joohw · commit 091b24eca923 · 2026-06-12T17:34:26.000+08:00
diff --git a/README.md b/README.md
@@ -63,6 +63,7 @@ boss help
 | 命令 | 说明 |
 | --- | --- |
 | `boss login` | 打开 Boss直聘登录页（扫码/验证后手动完成） |
+| `boss update` | 通过 npm 安装最新版 boss-cli |
 | `boss list [--unread]` | 读取聊天列表；`--unread` 仅未读 |
 | `boss chat <姓名> [--strict]` | 打开指定候选人会话 |
 | `boss send [--text <内容>]` | 向当前会话发送消息 |
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@joohw/boss-cli",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Boss直聘自动化 CLI：批量发消息、自动打招呼、候选人管理、深度搜索。基于 Puppeteer/CDP 驱动本机 Chrome，支持 AI Agent 编排",
   "keywords": [
     "boss",
diff --git a/src/cli/cliRouter.ts b/src/cli/cliRouter.ts
@@ -22,7 +22,11 @@ import {
   type ChatPageAction,
 } from '../toolset/index.js';
 import { printBossInteractiveBanner } from './banner.js';
-import { printVersionInfo } from './version.js';
+import {
+  printPackageUpdateNoticeIfDue,
+  printVersionInfo,
+  runPackageUpdate,
+} from './version.js';
 
 class CliError extends Error {
   constructor(message: string) {
@@ -133,6 +137,8 @@ function printHelp(): void {
       显示本帮助
   boss version | ver（或 -v / --version）
       显示当前版本并检查 npm 是否有更新
+  boss update
+      使用 npm 安装最新版 boss-cli
   boss login
       打开登录页（需要用户在浏览器中自行完成登录，这个命令会直接返回）
   boss list [--unread]
@@ -278,6 +284,14 @@ export async function executeCommand(argv: string[]): Promise<string> {
     return implLogin();
   }
 
+  if (cmd === 'update') {
+    const { rest, opts, flags } = parseOpts(tail);
+    if (rest.length > 0 || Object.keys(opts).length > 0 || flags.size > 0) {
+      die('❌ 用法: update');
+    }
+    return runPackageUpdate();
+  }
+
   if (cmd === 'list') {
     const { flags } = parseOpts(tail);
     if (flags.has('unread')) {
@@ -440,6 +454,7 @@ export async function runOneCommand(argv: string[]): Promise<void> {
 
 async function runInteractiveLoop(): Promise<void> {
   const rl = createInterface({ input, output, terminal: true });
+  await printPackageUpdateNoticeIfDue();
   printBossInteractiveBanner();
   try {
     for (;;) {
@@ -506,6 +521,10 @@ export async function runCli(argv: string[]): Promise<void> {
     return;
   }
 
+  if (normalizeSubcommand(argv[0] ?? '') !== 'update') {
+    await printPackageUpdateNoticeIfDue();
+  }
+
   if (argv[0] === 'help' || argv[0] === '--help' || argv[0] === '-h') {
     printHelp();
     return;
diff --git a/src/cli/version.ts b/src/cli/version.ts
@@ -1,6 +1,13 @@
-import { readFileSync } from 'node:fs';
+import { spawn } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
 import { dirname, join } from 'node:path';
+import process from 'node:process';
 import { fileURLToPath } from 'node:url';
+import { CACHE_DIR } from '../config.js';
+
+const UPDATE_CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
+const UPDATE_CHECK_STATE_FILE = join(CACHE_DIR, 'version-check.json');
 
 function getPackageJsonPath(): string {
   return join(dirname(fileURLToPath(import.meta.url)), '..', '..', 'package.json');
@@ -18,7 +25,7 @@ export function getPackageMeta(): { name: string; version: string } {
 }
 
 /** 比较 semver x.y.z（忽略预发布标签，仅比较主版本段） */
-function compareSemver(a: string, b: string): number {
+export function compareSemver(a: string, b: string): number {
   const core = (s: string) => s.split('-')[0] ?? '';
   const pa = core(a).split('.').map((x) => parseInt(x, 10));
   const pb = core(b).split('.').map((x) => parseInt(x, 10));
@@ -36,6 +43,30 @@ function compareSemver(a: string, b: string): number {
   return 0;
 }
 
+export type PackageUpdateCheckResult = {
+  checked: boolean;
+  current: string;
+  latest: string | null;
+  updateAvailable: boolean;
+};
+
+type PackageUpdateCheckState = {
+  checkedAt: string;
+  packageName: string;
+  currentVersion: string;
+  latestVersion: string;
+};
+
+type CheckPackageUpdateOptions = {
+  currentVersion?: string;
+  fetchLatestVersion?: (packageName: string) => Promise<string>;
+  force?: boolean;
+  intervalMs?: number;
+  now?: Date;
+  packageName?: string;
+  statePath?: string;
+};
+
 export async function fetchNpmLatestVersion(packageName: string): Promise<string> {
   const path = `${encodeURIComponent(packageName)}/latest`;
   const url = `https://registry.npmjs.org/${path}`;
@@ -52,12 +83,148 @@ export async function fetchNpmLatestVersion(packageName: string): Promise<string
   return data.version;
 }
 
+function getUpdateCheckStatePath(): string {
+  return process.env.BOSS_CLI_UPDATE_CHECK_STATE_PATH?.trim() || UPDATE_CHECK_STATE_FILE;
+}
+
+function shouldCheckFromState(
+  state: PackageUpdateCheckState | null,
+  now: Date,
+  intervalMs: number,
+): boolean {
+  if (!state) {
+    return true;
+  }
+  const checkedAtMs = Date.parse(state.checkedAt);
+  if (Number.isNaN(checkedAtMs)) {
+    throw new Error(`版本检查缓存 checkedAt 无法解析：${state.checkedAt}`);
+  }
+  return now.getTime() - checkedAtMs > intervalMs;
+}
+
+async function readUpdateCheckState(statePath: string): Promise<PackageUpdateCheckState | null> {
+  if (!existsSync(statePath)) {
+    return null;
+  }
+  const raw = await readFile(statePath, 'utf8');
+  const parsed = JSON.parse(raw) as Partial<PackageUpdateCheckState>;
+  if (
+    typeof parsed.checkedAt !== 'string' ||
+    typeof parsed.packageName !== 'string' ||
+    typeof parsed.currentVersion !== 'string' ||
+    typeof parsed.latestVersion !== 'string'
+  ) {
+    throw new Error(`版本检查缓存格式无效：${statePath}`);
+  }
+  return {
+    checkedAt: parsed.checkedAt,
+    packageName: parsed.packageName,
+    currentVersion: parsed.currentVersion,
+    latestVersion: parsed.latestVersion,
+  };
+}
+
+async function writeUpdateCheckState(
+  statePath: string,
+  state: PackageUpdateCheckState,
+): Promise<void> {
+  await mkdir(dirname(statePath), { recursive: true });
+  const tmpPath = `${statePath}.tmp`;
+  await writeFile(tmpPath, `${JSON.stringify(state, null, 2)}\n`, 'utf8');
+  await rename(tmpPath, statePath);
+}
+
+export function formatPackageUpdateNotice(result: PackageUpdateCheckResult): string {
+  if (!result.updateAvailable || !result.latest) {
+    throw new Error('没有可用更新，无法生成升级提示');
+  }
+  return `[boss-cli] boss-cli 需要升级：当前 ${result.current}，最新 ${result.latest}。请运行 boss update`;
+}
+
+export async function checkPackageUpdate(
+  options: CheckPackageUpdateOptions = {},
+): Promise<PackageUpdateCheckResult> {
+  const meta = getPackageMeta();
+  const packageName = options.packageName ?? meta.name;
+  const current = options.currentVersion ?? meta.version;
+  const now = options.now ?? new Date();
+  const intervalMs = options.intervalMs ?? UPDATE_CHECK_INTERVAL_MS;
+  const statePath = options.statePath ?? getUpdateCheckStatePath();
+  const fetchLatestVersion = options.fetchLatestVersion ?? fetchNpmLatestVersion;
+  const state = await readUpdateCheckState(statePath);
+
+  if (!options.force && !shouldCheckFromState(state, now, intervalMs)) {
+    const latest = state?.latestVersion ?? null;
+    return {
+      checked: false,
+      current,
+      latest,
+      updateAvailable: latest ? compareSemver(latest, current) > 0 : false,
+    };
+  }
+
+  const latest = await fetchLatestVersion(packageName);
+  const result = {
+    checked: true,
+    current,
+    latest,
+    updateAvailable: compareSemver(latest, current) > 0,
+  };
+  await writeUpdateCheckState(statePath, {
+    checkedAt: now.toISOString(),
+    packageName,
+    currentVersion: current,
+    latestVersion: latest,
+  });
+  return result;
+}
+
+export async function printPackageUpdateNoticeIfDue(): Promise<void> {
+  try {
+    const result = await checkPackageUpdate();
+    if (result.checked && result.updateAvailable) {
+      console.error(formatPackageUpdateNotice(result));
+    }
+  } catch (e) {
+    const message = e instanceof Error ? e.message : String(e);
+    console.error(`[boss-cli] 版本更新检查失败：${message}`);
+  }
+}
+
 export async function printVersionInfo(): Promise<void> {
   const { name, version: current } = getPackageMeta();
   console.log(`${name} ${current}`);
-  const latest = await fetchNpmLatestVersion(name);
-  const cmp = compareSemver(latest, current);
-  if (cmp > 0) {
-    console.log(`新版本可用: ${latest}（当前 ${current}）。更新: npm i -g ${name}`);
+  const result = await checkPackageUpdate({ force: true });
+  if (result.updateAvailable) {
+    console.log(formatPackageUpdateNotice(result));
+  } else if (result.latest) {
+    console.log(`未发现更新：当前 ${result.current}，npm latest ${result.latest}`);
+  }
+}
+
+export async function runPackageUpdate(): Promise<string> {
+  const { name } = getPackageMeta();
+  const npmCommand = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+  const args = ['install', '-g', `${name}@latest`];
+  console.error(`[boss-cli] 正在执行：npm install -g ${name}@latest`);
+
+  const code = await new Promise<number>((resolve, reject) => {
+    const child = spawn(npmCommand, args, {
+      shell: process.platform === 'win32',
+      stdio: 'inherit',
+    });
+    child.on('error', reject);
+    child.on('close', (exitCode, signal) => {
+      if (signal) {
+        reject(new Error(`npm 更新进程被信号中断：${signal}`));
+        return;
+      }
+      resolve(exitCode ?? 0);
+    });
+  });
+
+  if (code !== 0) {
+    throw new Error(`npm 更新失败，退出码 ${code}`);
   }
+  return 'boss-cli 更新完成。请重新运行 boss version 确认当前版本。';
 }

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@joohw/boss-cli",`
`3`		`- "version": "0.4.1",`
	`3`	`+ "version": "0.5.0",`
`4`	`4`	`"description": "Boss直聘自动化 CLI：批量发消息、自动打招呼、候选人管理、深度搜索。基于 Puppeteer/CDP 驱动本机 Chrome，支持 AI Agent 编排",`
`5`	`5`	`"keywords": [`
`6`	`6`	`"boss",`