persona-test-cli 0.1.3 → 0.1.5

package/README.md

@@ -38,8 +38,9 @@ authorize page loads decides the scope of the issued token.
 | `logout` | anyone | Clear the stored token |
 | `whoami` | anyone | Show current identity + available commands |
 | `campaigns list/create/edit/link/stats` | anyone | Share links — scoped to your own unless admin |
+| `campaigns create/edit --image <path>` | anyone | Set the entry image from a local file — auto-resized/compressed to match the web dashboard's pipeline |
 | `personas list/create/edit` | anyone | Ad-copy personas — scoped to your own unless admin |
-| `events tail` | anyone | Poll new impression/click events |
+| `events tail` | anyone | Poll new impression/click events (starts from now; `--since <iso>` to replay history first) |
 | `users list/approve/reject` | **admin only** | Registration approval queue |
 
 Run any command with `--help` for its full options and copy-pasteable examples.
@@ -56,6 +57,9 @@ Run any command with `--help` for its full options and copy-pasteable examples.
   hanging on a prompt when stdin isn't a TTY).
 - `login --no-open`: print the authorize URL instead of trying to launch a browser (headless/
   sandboxed environments).
+- Update notice: once a day, checks npm for a newer version and prints a one-line reminder to
+  stderr if you're behind. Skipped automatically under `--json`, in CI (`CI` env set), or with
+  `NO_UPDATE_NOTIFIER=1`.
 
 ## License
 

package/dist/commands/campaigns.js

@@ -2,14 +2,17 @@ import { apiRequest } from "../http.js";
 import { requireSession } from "../session.js";
 import { fail, EXIT_CODES } from "../errors.js";
 import { action, printJsonOrText, printTable } from "../output.js";
+import { resizeImageToDataUrl } from "../image.js";
 export const CAMPAIGNS_LIST_USAGE = `  persona-test-cli campaigns list
   persona-test-cli campaigns list --json`;
 export const CAMPAIGNS_CREATE_USAGE = `  persona-test-cli campaigns create --name "夏季活动" --slug summer --category MyApp
   persona-test-cli campaigns create --name "夏季活动" --slug summer --category MyApp --persona-keys A,B1 --poster-headline "..." --poster-body "..."
+  persona-test-cli campaigns create --name "夏季活动" --slug summer --category MyApp --image ./poster.jpg --image-alt "夏季活动海报"
 
-注:入口图(entryImageUrl)无法在终端里裁剪压缩,建好后请到网页后台(/dashboard 或 /admin)补传。`;
+注:--image 本地路径会被自动缩放(宽300px)并转成 JPEG,和网页后台的处理逻辑一致。`;
 export const CAMPAIGNS_EDIT_USAGE = `  persona-test-cli campaigns edit summer --poster-caption "扫码入群"
-  persona-test-cli campaigns edit summer --no-active`;
+  persona-test-cli campaigns edit summer --no-active
+  persona-test-cli campaigns edit summer --image ./poster.jpg --image-alt "新海报"`;
 export const CAMPAIGNS_LINK_USAGE = `  persona-test-cli campaigns link summer
   persona-test-cli campaigns link summer --persona A`;
 export const CAMPAIGNS_STATS_USAGE = `  persona-test-cli campaigns stats summer`;
@@ -50,11 +53,14 @@ export function campaignsCommand(program) {
         .option("--poster-caption <text>", "海报二维码下方文案", "扫码入群")
         .option("--poster-headline <text>", "通用海报标题")
         .option("--poster-body <text>", "通用海报正文")
+        .option("--image <path>", "本地图片路径,自动缩放压缩为入口图(entryImageUrl)")
+        .option("--image-alt <text>", "入口图的 alt 文本")
         .option("--base-url <url>")
         .addHelpText("after", `\n示例:\n${CREATE_USAGE}`)
         .action(action(async (opts) => {
         const { baseUrl, token } = requireSession(opts.baseUrl);
         const personaKeys = opts.personaKeys ? opts.personaKeys.split(",").map((k) => k.trim()) : [];
+        const entryImageUrl = opts.image ? await resizeImageToDataUrl(opts.image) : undefined;
         const data = await apiRequest(baseUrl, token, "POST", "/api/cli/campaigns", {
             name: opts.name,
             slug: opts.slug,
@@ -63,6 +69,8 @@ export function campaignsCommand(program) {
             posterCaption: opts.posterCaption,
             posterHeadline: opts.posterHeadline,
             posterBody: opts.posterBody,
+            ...(entryImageUrl !== undefined ? { entryImageUrl } : {}),
+            ...(opts.imageAlt !== undefined ? { entryImageAlt: opts.imageAlt } : {}),
         });
         printJsonOrText(data, () => console.log(`已创建:${data.slug}`));
     }));
@@ -73,6 +81,8 @@ export function campaignsCommand(program) {
         .option("--poster-caption <text>")
         .option("--poster-headline <text>")
         .option("--poster-body <text>")
+        .option("--image <path>", "本地图片路径,自动缩放压缩后替换入口图(entryImageUrl)")
+        .option("--image-alt <text>", "入口图的 alt 文本")
         .option("--active", "启用")
         .option("--no-active", "停用")
         .option("--base-url <url>")
@@ -88,6 +98,10 @@ export function campaignsCommand(program) {
             patch.posterHeadline = opts.posterHeadline;
         if (opts.posterBody !== undefined)
             patch.posterBody = opts.posterBody;
+        if (opts.image !== undefined)
+            patch.entryImageUrl = await resizeImageToDataUrl(opts.image);
+        if (opts.imageAlt !== undefined)
+            patch.entryImageAlt = opts.imageAlt;
         if (opts.active !== undefined)
             patch.active = opts.active;
         if (Object.keys(patch).length === 0) {

package/dist/commands/events.js

@@ -2,8 +2,10 @@ import { apiRequest } from "../http.js";
 import { requireSession } from "../session.js";
 import { jsonMode } from "../output.js";
 import { action } from "../output.js";
+import { fail, EXIT_CODES } from "../errors.js";
 export const EVENTS_TAIL_USAGE = `  persona-test-cli events tail
-  persona-test-cli events tail --slug summer --interval 3`;
+  persona-test-cli events tail --slug summer --interval 3
+  persona-test-cli events tail --since 2026-08-30T00:00:00Z   # 回看历史,再接实时`;
 const TAIL_USAGE = EVENTS_TAIL_USAGE;
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
@@ -12,17 +14,31 @@ export function eventsCommand(program) {
     const cmd = program.command("events").description("查看展示/点击事件");
     cmd
         .command("tail")
-        .description("轮询打印新的展示/点击事件,Ctrl+C 退出")
+        .description("从现在开始轮询打印新的展示/点击事件,Ctrl+C 退出(要回看历史用 --since)")
         .option("--slug <slug>", "只看某条分享链接的事件")
         .option("--interval <seconds>", "轮询间隔秒数", "5")
+        .option("--since <iso>", "从这个 ISO 时间点开始回放,再接实时(默认从启动时刻开始)")
         .option("--base-url <url>")
         .addHelpText("after", `\n示例:\n${TAIL_USAGE}`)
         .action(action(async (opts) => {
         const { baseUrl, token } = requireSession(opts.baseUrl);
         const intervalMs = Math.max(1, Number(opts.interval) || 5) * 1000;
-        let since = new Date(0).toISOString();
+        // Default to "now", not the epoch: `tail` promises *new* events, and
+        // starting at 1970 made the first poll replay up to 50 historical
+        // events before showing anything live.
+        let since = new Date().toISOString();
+        if (opts.since) {
+            const parsed = new Date(opts.since);
+            if (Number.isNaN(parsed.getTime())) {
+                fail(`--since 不是合法的时间: ${opts.since}(用 ISO 格式,如 2026-08-30T00:00:00Z)`, {
+                    exitCode: EXIT_CODES.validation,
+                    usage: TAIL_USAGE,
+                });
+            }
+            since = parsed.toISOString();
+        }
         if (!jsonMode) {
-            console.log(`轮询中(每 ${opts.interval} 秒)... Ctrl+C 退出`);
+            console.log(`轮询中(每 ${opts.interval} 秒)... Ctrl+C 退出${opts.since ? ` — 回放起点 ${since}` : ""}`);
         }
         for (;;) {
             const query = new URLSearchParams({ since, limit: "50" });

package/dist/config.js

@@ -1,7 +1,7 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
-function configDir() {
+export function configDir() {
     const base = process.env.XDG_CONFIG_HOME || join(homedir(), ".config");
     return join(base, "persona-test-cli");
 }

package/dist/image.js

@@ -0,0 +1,38 @@
+import { readFile } from "node:fs/promises";
+import { CliError, EXIT_CODES } from "./errors.js";
+/**
+ * Mirrors src/lib/resizeImage.ts (the web dashboard's client-side pipeline):
+ * downscale to a fixed width, preserve aspect ratio, re-encode as JPEG, and
+ * return a data URL so the server can store it inline (no object storage).
+ */
+export async function resizeImageToDataUrl(filePath, targetWidth = 300, quality = 82) {
+    let sharp;
+    try {
+        sharp = (await import("sharp")).default;
+    }
+    catch {
+        throw new CliError("缺少图片处理依赖 `sharp`,请先运行 `npm install` (persona-test-cli 依赖已声明,重新安装即可)", { exitCode: EXIT_CODES.generic });
+    }
+    let input;
+    try {
+        input = await readFile(filePath);
+    }
+    catch (err) {
+        throw new CliError(`无法读取图片文件 "${filePath}": ${err instanceof Error ? err.message : String(err)}`, {
+            exitCode: EXIT_CODES.validation,
+        });
+    }
+    let jpeg;
+    try {
+        jpeg = await sharp(input)
+            .resize({ width: targetWidth, withoutEnlargement: false })
+            .jpeg({ quality })
+            .toBuffer();
+    }
+    catch (err) {
+        throw new CliError(`图片处理失败,请确认文件是有效的图片格式: ${err instanceof Error ? err.message : String(err)}`, {
+            exitCode: EXIT_CODES.validation,
+        });
+    }
+    return `data:image/jpeg;base64,${jpeg.toString("base64")}`;
+}

package/dist/index.js

@@ -2,7 +2,7 @@
 import { readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { dirname, join } from "node:path";
-import { Command } from "commander";
+import { Command, CommanderError } from "commander";
 import { registerCommand } from "./commands/register.js";
 import { loginCommand } from "./commands/login.js";
 import { logoutCommand } from "./commands/logout.js";
@@ -12,7 +12,9 @@ import { personasCommand } from "./commands/personas.js";
 import { eventsCommand } from "./commands/events.js";
 import { usersCommand } from "./commands/users.js";
 import { examplesCommand } from "./commands/examples.js";
-import { jsonMode } from "./output.js";
+import { jsonMode, printError } from "./output.js";
+import { CliError, EXIT_CODES } from "./errors.js";
+import { checkForUpdates } from "./updateCheck.js";
 // Reads package.json's version whether running from source (cli/index.ts,
 // package.json next to it) or from the built dist/index.js (package.json one
 // directory up) — avoids a hardcoded version string drifting from package.json.
@@ -30,6 +32,17 @@ function readVersion() {
 }
 const version = readVersion();
 const program = new Command();
+// Commander hardcodes exit code 1 for every usage/argument problem (missing
+// option, unknown flag, bad value) and writes the message to stderr itself.
+// `examples` documents 3 = 参数校验失败, so take over both halves: exitOverride
+// stops commander calling process.exit(1), and configureOutput silences its
+// stderr write so every error flows through printError() — which honours --json
+// and applies the documented exit code.
+//
+// MUST come before the subcommands are registered: commander copies
+// _exitCallback and _outputConfiguration onto a child at addCommand() time,
+// so declaring this at the bottom leaves every subcommand untouched.
+program.exitOverride().configureOutput({ writeErr: () => { } });
 program
     .name("persona-test-cli")
     .description("persona-test 运维 CLI —— admin 和已审核通过的普通用户都能用,普通用户只能看到/编辑自己创建的 campaigns/personas。\n" +
@@ -57,4 +70,19 @@ personasCommand(program);
 eventsCommand(program);
 usersCommand(program); // [仅 admin] — see the description on each of its subcommands
 examplesCommand(program);
-program.parseAsync(process.argv);
+program
+    .parseAsync(process.argv)
+    .catch((err) => {
+    if (err instanceof CommanderError) {
+        // --help / -v travel through the throw path too, but they are normal exits.
+        if (err.code === "commander.helpDisplayed" || err.code === "commander.version")
+            return;
+        // Commander bakes its own "error: " prefix into some messages; printError
+        // adds ours, which would otherwise read "错误: error: unknown command ...".
+        const message = err.message.replace(/^error:\s*/i, "");
+        printError(new CliError(message, { exitCode: EXIT_CODES.validation }));
+        return;
+    }
+    printError(err);
+})
+    .finally(() => checkForUpdates(version, { jsonMode }));

package/dist/updateCheck.js

@@ -0,0 +1,75 @@
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { configDir } from "./config.js";
+const REGISTRY_URL = "https://registry.npmjs.org/persona-test-cli/latest";
+const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
+const FETCH_TIMEOUT_MS = 2000;
+function cachePath() {
+    return join(configDir(), "update-check.json");
+}
+function readCache() {
+    try {
+        return JSON.parse(readFileSync(cachePath(), "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+function writeCache(cache) {
+    try {
+        mkdirSync(configDir(), { recursive: true });
+        writeFileSync(cachePath(), JSON.stringify(cache));
+    }
+    catch {
+        // best-effort — a stale/missing cache just means the next run re-checks
+    }
+}
+/** True if `a` is strictly newer than `b` (both "x.y.z", missing/non-numeric parts treated as 0). */
+function isNewer(a, b) {
+    const pa = a.split(".").map((n) => parseInt(n, 10) || 0);
+    const pb = b.split(".").map((n) => parseInt(n, 10) || 0);
+    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const diff = (pa[i] ?? 0) - (pb[i] ?? 0);
+        if (diff !== 0)
+            return diff > 0;
+    }
+    return false;
+}
+async function fetchLatestVersion() {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+    try {
+        const res = await fetch(REGISTRY_URL, { signal: controller.signal });
+        if (!res.ok)
+            return undefined;
+        const json = (await res.json());
+        return typeof json.version === "string" ? json.version : undefined;
+    }
+    catch {
+        return undefined; // offline / registry unreachable / timed out — silently skip
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Best-effort "a new version is available" notice, in the spirit of npm's own
+ * update-notifier: never throws, never blocks scripting/agent use (skipped
+ * under --json, CI, or NO_UPDATE_NOTIFIER), and only hits the network once
+ * per CHECK_INTERVAL_MS — everything else reuses the cached result.
+ */
+export async function checkForUpdates(currentVersion, opts) {
+    if (opts.jsonMode || process.env.CI || process.env.NO_UPDATE_NOTIFIER)
+        return;
+    const cache = readCache();
+    const isStale = !cache || Date.now() - Date.parse(cache.lastCheckedAt) > CHECK_INTERVAL_MS;
+    let latestVersion = cache?.latestVersion;
+    if (isStale) {
+        latestVersion = await fetchLatestVersion();
+        writeCache({ lastCheckedAt: new Date().toISOString(), latestVersion });
+    }
+    if (latestVersion && isNewer(latestVersion, currentVersion)) {
+        console.error(`\n有新版本可用: ${currentVersion} -> ${latestVersion}\n` +
+            `运行 \`npm install -g persona-test-cli@latest\` 升级(设置 NO_UPDATE_NOTIFIER=1 可关闭此提醒)。`);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "persona-test-cli",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "运维 CLI for persona-test — admin 和已审核通过的普通用户都能用；设备码浏览器授权登录，管理分享链接(campaigns)和画像(personas)，普通用户只能看到/编辑自己创建的。",
   "type": "module",
   "bin": {
@@ -18,7 +18,8 @@
     "dev": "tsx index.ts"
   },
   "dependencies": {
-    "commander": "^15.0.0"
+    "commander": "^15.0.0",
+    "sharp": "^0.33.0"
   },
   "devDependencies": {
     "@types/node": "^20",