npm - pi-courier - Versions diffs - 0.1.41 → 0.1.42 - Mend

pi-courier 0.1.41 → 0.1.42

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (86) hide show

package/assets/avatars/instance-01.png CHANGED Viewed

Binary file

package/assets/avatars/instance-02.png CHANGED Viewed

Binary file

package/assets/avatars/instance-03.png CHANGED Viewed

Binary file

package/assets/avatars/instance-04.png CHANGED Viewed

Binary file

package/assets/avatars/instance-05.png CHANGED Viewed

Binary file

package/assets/avatars/instance-06.png CHANGED Viewed

Binary file

package/assets/avatars/instance-07.png CHANGED Viewed

Binary file

package/assets/avatars/instance-08.png CHANGED Viewed

Binary file

package/assets/avatars/instance-09.png CHANGED Viewed

Binary file

package/assets/avatars/instance-10.png CHANGED Viewed

Binary file

package/assets/avatars/instance-11.png CHANGED Viewed

Binary file

package/assets/avatars/instance-12.png CHANGED Viewed

Binary file

package/assets/avatars/management.png CHANGED Viewed

Binary file

package/assets/avatars-drafts/.pi.txt ADDED Viewed

	@@ -0,0 +1 @@
1	+ π

package/assets/avatars-drafts/instance-01-cat-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-01-cat.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-01-cat2-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-01-cat2.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-01-cat3-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-01-cat3.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-01-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-01-seedream-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-01-seedream.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-01-v2-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-01-v2.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-01-v3-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-01-v3.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-01-v4-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-01-v4.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-01-v5-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-01-v5.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-01.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-02-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-02-seedream-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-02-seedream.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-02.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-03-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-03-seedream-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-03-seedream.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-03.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-04-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-04-seedream-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-04-seedream.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-04.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-05-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-05-seedream-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-05-seedream.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-05.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-06-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-06-seedream-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-06-seedream.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-06.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-07-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-07-seedream-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-07-seedream.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-07.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-08-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-08-seedream-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-08-seedream.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-08.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-09-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-09-seedream-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-09-seedream.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-09.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-10-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-10-seedream-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-10-seedream.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-10.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-11-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-11-seedream-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-11-seedream.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-11.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-12-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-12-seedream-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-12-seedream.png ADDED Viewed

Binary file

package/assets/avatars-drafts/instance-12.png ADDED Viewed

Binary file

package/assets/avatars-drafts/management-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/management-seedream-raw.png ADDED Viewed

Binary file

package/assets/avatars-drafts/management-seedream.png ADDED Viewed

Binary file

package/assets/avatars-drafts/management.png ADDED Viewed

Binary file

package/assets/avatars-drafts/preview.html ADDED Viewed

@@ -0,0 +1,14 @@
+<!doctype html><html lang="zh"><head><meta charset="utf-8"><title>头像草稿审阅</title>
+<style>
+body{font-family:sans-serif;background:#1e2128;color:#eee;padding:24px}
+.grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(300px,1fr));gap:16px;max-width:1400px}
+.cell{background:#2a2e37;border-radius:12px;padding:14px;text-align:center}
+.cell h3{margin:0 0 10px;font-size:15px} .cell small{color:#9aa3b2;font-weight:normal}
+.pair{display:flex;gap:12px;justify-content:center;align-items:flex-end}
+figure{margin:0} img{width:128px;height:128px;image-rendering:pixelated;background:#fff;border-radius:8px;display:block}
+figcaption{font-size:12px;color:#9aa3b2;margin-top:6px}
+.old img{opacity:.75}
+</style></head><body>
+<h1>头像草稿审阅(左:seedream 新版 / 右:旧版智谱)</h1>
+<p>挑选方法:把满意的 seedream 图替换正式头像池,告诉我文件名即可,例如「全部替换」或「替换 01/02/05,07 重生成」。</p>
+<div class="grid"><div class="cell"><h3>instance-01<br><small>橘猫</small></h3><div class="pair"><figure><img src="instance-01-seedream.png"><figcaption>seedream 新版</figcaption></figure><figure class="old"><img src="instance-01.png"><figcaption>旧版(智谱)</figcaption></figure></div></div><div class="cell"><h3>instance-02<br><small>企鹅</small></h3><div class="pair"><figure><img src="instance-02-seedream.png"><figcaption>seedream 新版</figcaption></figure><figure class="old"><img src="instance-02.png"><figcaption>旧版(智谱)</figcaption></figure></div></div><div class="cell"><h3>instance-03<br><small>狐狸</small></h3><div class="pair"><figure><img src="instance-03-seedream.png"><figcaption>seedream 新版</figcaption></figure><figure class="old"><img src="instance-03.png"><figcaption>旧版(智谱)</figcaption></figure></div></div><div class="cell"><h3>instance-04<br><small>猫头鹰</small></h3><div class="pair"><figure><img src="instance-04-seedream.png"><figcaption>seedream 新版</figcaption></figure><figure class="old"><img src="instance-04.png"><figcaption>旧版(智谱)</figcaption></figure></div></div><div class="cell"><h3>instance-05<br><small>白兔</small></h3><div class="pair"><figure><img src="instance-05-seedream.png"><figcaption>seedream 新版</figcaption></figure><figure class="old"><img src="instance-05.png"><figcaption>旧版(智谱)</figcaption></figure></div></div><div class="cell"><h3>instance-06<br><small>柴犬</small></h3><div class="pair"><figure><img src="instance-06-seedream.png"><figcaption>seedream 新版</figcaption></figure><figure class="old"><img src="instance-06.png"><figcaption>旧版(智谱)</figcaption></figure></div></div><div class="cell"><h3>instance-07<br><small>灰猫</small></h3><div class="pair"><figure><img src="instance-07-seedream.png"><figcaption>seedream 新版</figcaption></figure><figure class="old"><img src="instance-07.png"><figcaption>旧版(智谱)</figcaption></figure></div></div><div class="cell"><h3>instance-08<br><small>小棕熊</small></h3><div class="pair"><figure><img src="instance-08-seedream.png"><figcaption>seedream 新版</figcaption></figure><figure class="old"><img src="instance-08.png"><figcaption>旧版(智谱)</figcaption></figure></div></div><div class="cell"><h3>instance-09<br><small>熊猫</small></h3><div class="pair"><figure><img src="instance-09-seedream.png"><figcaption>seedream 新版</figcaption></figure><figure class="old"><img src="instance-09.png"><figcaption>旧版(智谱)</figcaption></figure></div></div><div class="cell"><h3>instance-10<br><small>青蛙</small></h3><div class="pair"><figure><img src="instance-10-seedream.png"><figcaption>seedream 新版</figcaption></figure><figure class="old"><img src="instance-10.png"><figcaption>旧版(智谱)</figcaption></figure></div></div><div class="cell"><h3>instance-11<br><small>松鼠</small></h3><div class="pair"><figure><img src="instance-11-seedream.png"><figcaption>seedream 新版</figcaption></figure><figure class="old"><img src="instance-11.png"><figcaption>旧版(智谱)</figcaption></figure></div></div><div class="cell"><h3>instance-12<br><small>小鸡</small></h3><div class="pair"><figure><img src="instance-12-seedream.png"><figcaption>seedream 新版</figcaption></figure><figure class="old"><img src="instance-12.png"><figcaption>旧版(智谱)</figcaption></figure></div></div><div class="cell"><h3>management<br><small>管理房间·皇冠猫</small></h3><div class="pair"><figure><img src="management-seedream.png"><figcaption>seedream 新版</figcaption></figure><figure class="old"><img src="management.png"><figcaption>旧版(智谱)</figcaption></figure></div></div></div></body></html>

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "pi-courier",
-  "version": "0.1.41",
+  "version": "0.1.42",
   "description": "Run pi coding agent from Matrix. Slash commands, skills and prompts fully work from messengers via the RPC protocol.",
   "type": "module",
   "main": "dist/standalone.js",

package/scripts/generate-avatars-openrouter.mjs ADDED Viewed

@@ -0,0 +1,174 @@
+#!/usr/bin/env node
+/**
+ * Generate avatar drafts via OpenRouter text-to-image (bytedance-seed/seedream-4.5).
+ *
+ * NOT part of the runtime — this is a human-in-the-loop tool: it writes
+ * candidates to assets/avatars-drafts/ for review; winners get copied over
+ * the same-named file in assets/avatars/ by hand (the runtime pool contract:
+ * same filename, drop-in replacement).
+ *
+ * Usage:
+ *   export OPENROUTER_API_KEY=sk-or-...        # required
+ *   node scripts/generate-avatars-openrouter.mjs               # all 13
+ *   node scripts/generate-avatars-openrouter.mjs --only instance-01,management
+ *
+ * Env:
+ *   OPENROUTER_API_KEY   (required) OpenRouter key
+ *   OPENROUTER_MODEL     (optional) default: google/gemini-2.5-flash-image
+ *
+ * Raw model output is kept as <name>-raw.<ext>; a 128×128 nearest-neighbour
+ * resize (ffmpeg, pixel-crisp) lands at <name>.png when ffmpeg is available.
+ */
+import { execFileSync } from "node:child_process";
+import { mkdirSync, writeFileSync, existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const ROOT = join(dirname(fileURLToPath(import.meta.url)), "..");
+const OUT_DIR = join(ROOT, "assets", "avatars-drafts");
+const MODEL = process.env.OPENROUTER_MODEL || "google/gemini-2.5-flash-image";
+const API = "https://openrouter.ai/api/v1/chat/completions";
+const STYLE =
+  "Pixel art avatar icon, chunky blocky pixels, flat solid-color background, single subject, " +
+  "centered composition, clean silhouette, original artwork — must not resemble any existing " +
+  "game character, mob, logo or texture. Square format, no text, no watermark.";
+const AVATARS = [
+  {
+    name: "instance-01",
+    prompt:
+      "A small amber-orange Greek letter π (pi) glyph placed in the BOTTOM-LEFT quarter of the canvas, " +
+      "occupying only about a quarter of the canvas area, on a dark slate-blue block background; " +
+      "the other three quarters stay mostly empty with a few subtle dim dots and a small plus mark as decoration. " + STYLE,
+  },
+  {
+    name: "instance-02",
+    prompt:
+      "A small pale-lavender Greek letter π (pi) glyph placed in the BOTTOM-LEFT quarter of the canvas, " +
+      "occupying only about a quarter of the canvas area, on a deep purple block background with a few " +
+      "tiny gold star sparkles scattered in the empty areas. " + STYLE,
+  },
+  { name: "instance-03", prompt: "A cute friendly robot head, teal/cyan tones, dark outline, square eyes and a small antenna. " + STYLE },
+  { name: "instance-04", prompt: "A cute friendly robot head, warm orange tones, dark outline, vertical slit eyes and two small horns. " + STYLE },
+  { name: "instance-05", prompt: "A shining cyan gem crystal on a gray stone block background. " + STYLE },
+  { name: "instance-06", prompt: "A green circuit board with golden traces, solder dots and a central dark chip. " + STYLE },
+  { name: "instance-07", prompt: "A gray cat face with pink inner ears and green eyes. " + STYLE },
+  { name: "instance-08", prompt: "A brown owl face with big square white eyes, orange beak and ear tufts. " + STYLE },
+  { name: "instance-09", prompt: "A small red-and-white rocket flying diagonally on a dark navy starry night background. " + STYLE },
+  { name: "instance-10", prompt: "A young green sprout with two leaves in a terracotta flower pot. " + STYLE },
+  { name: "instance-11", prompt: "A dark laptop with a glowing green command-line cursor on its screen. " + STYLE },
+  { name: "instance-12", prompt: "A white six-sided die showing the five-face, on a red block background. " + STYLE },
+  { name: "management", prompt: "A golden crown with red and cyan jewels on a dark navy block background. " + STYLE },
+];
+// ---- OpenRouter call --------------------------------------------------------
+function apiKey() {
+  const key = process.env.OPENROUTER_API_KEY;
+  if (!key) {
+    console.error("缺少 OPENROUTER_API_KEY 环境变量(OpenRouter 的 sk-or-... token)");
+    process.exit(1);
+  }
+  return key;
+}
+async function generateImage(key, prompt) {
+  const res = await fetch(API, {
+    method: "POST",
+    headers: { authorization: `Bearer ${key}`, "content-type": "application/json" },
+    body: JSON.stringify({
+      model: MODEL,
+      modalities: ["image", "text"],
+      messages: [{ role: "user", content: prompt }],
+    }),
+  });
+  if (!res.ok) {
+    const body = await res.text();
+    throw new Error(`HTTP ${res.status}: ${body.slice(0, 300)}`);
+  }
+  const data = await res.json();
+  const message = data?.choices?.[0]?.message;
+  const entry = message?.images?.[0];
+  const url = entry?.image_url?.url ?? entry?.url;
+  if (!url) {
+    const text = typeof message?.content === "string" ? message.content : JSON.stringify(message)?.slice(0, 300);
+    throw new Error(`响应中没有图片;模型文本:${text ?? "(空)"}`);
+  }
+  const match = /^data:([^;]+);base64,(.+)$/s.exec(url);
+  if (!match) throw new Error(`图片不是 base64 data URL: ${String(url).slice(0, 80)}...`);
+  return { mime: match[1], bytes: Buffer.from(match[2], "base64") };
+}
+// ---- ffmpeg post-process ----------------------------------------------------
+function hasFfmpeg() {
+  try {
+    execFileSync("ffmpeg", ["-version"], { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+/** Nearest-neighbour resize to 128×128 — keeps the blocky look crisp and the
+ *  file tiny. Falls back to the raw bytes when ffmpeg is unavailable. */
+function toAvatar128(rawPath, outPath) {
+  try {
+    execFileSync(
+      "ffmpeg",
+      ["-y", "-loglevel", "error", "-i", rawPath, "-vf", "scale=128:128:flags=neighbor", outPath],
+      { stdio: "ignore" }
+    );
+    return true;
+  } catch {
+    return false;
+  }
+}
+// ---- run --------------------------------------------------------------------
+const only = (() => {
+  const flag = process.argv.findIndex((a) => a === "--only" || a.startsWith("--only="));
+  if (flag === -1) return null;
+  const value = process.argv[flag].startsWith("--only=")
+    ? process.argv[flag].slice(7)
+    : process.argv[flag + 1] ?? "";
+  return value.split(",").filter(Boolean);
+})();
+const key = apiKey();
+mkdirSync(OUT_DIR, { recursive: true });
+const useFfmpeg = hasFfmpeg();
+if (!useFfmpeg) console.log("⚠ 未找到 ffmpeg,保留原始大图,不做 128×128 缩放");
+const targets = only ? AVATARS.filter((a) => only.includes(a.name)) : AVATARS;
+const missing = only?.filter((n) => !AVATARS.some((a) => a.name === n));
+if (missing?.length) {
+  console.error(`未知头像名: ${missing.join(",")}(可选: ${AVATARS.map((a) => a.name).join(" ")})`);
+  process.exit(1);
+}
+let ok = 0;
+for (const avatar of targets) {
+  const attempts = 3;
+  for (let attempt = 1; attempt <= attempts; attempt++) {
+    try {
+      const { mime, bytes } = await generateImage(key, avatar.prompt);
+      const ext = mime === "image/jpeg" ? "jpg" : mime === "image/webp" ? "webp" : "png";
+      const rawPath = join(OUT_DIR, `${avatar.name}-raw.${ext}`);
+      writeFileSync(rawPath, bytes);
+      const outPath = join(OUT_DIR, `${avatar.name}.png`);
+      const resized = useFfmpeg && toAvatar128(rawPath, outPath) && existsSync(outPath);
+      console.log(`✔ ${avatar.name}(${mime}, ${(bytes.length / 1024).toFixed(0)} KB)→ ${resized ? "128×128" : "仅原图"}`);
+      ok++;
+      break;
+    } catch (err) {
+      console.warn(`✗ ${avatar.name} 第 ${attempt}/${attempts} 次失败: ${err.message ?? err}`);
+      if (attempt === attempts) console.error(`✗✗ ${avatar.name} 放弃,可稍后 --only=${avatar.name} 重试`);
+      else await new Promise((r) => setTimeout(r, 2000));
+    }
+  }
+}
+console.log(`\n完成 ${ok}/${targets.length} → ${OUT_DIR}`);

package/scripts/generate-avatars-seedream.mjs ADDED Viewed

@@ -0,0 +1,164 @@
+#!/usr/bin/env node
+/**
+ * Generate animal-avatar drafts via OpenRouter /api/v1/images (seedream-4.5).
+ *
+ * Human-in-the-loop tool — candidates land in assets/avatars-drafts/ for
+ * review; winners are copied over the same-named file in assets/avatars/ by
+ * hand. Contract per avatar (user-approved template): perfectly symmetrical
+ * front-facing animal HEAD only, cut off at the chin, face filling the frame,
+ * sharp hard pixel edges (no anti-aliasing), solid background, tiny π letter
+ * in the extreme bottom-left corner, 8-bit retro game avatar style.
+ *
+ * Usage:
+ *   export OPENROUTER_API_KEY=sk-or-...   (or configure OpenRouter in ~/.zcode)
+ *   node scripts/generate-avatars-seedream.mjs                # all 13
+ *   node scripts/generate-avatars-seedream.mjs --only instance-01
+ *
+ * Env: OPENROUTER_API_KEY, optional OPENROUTER_IMAGE_MODEL (default
+ * bytedance-seed/seedream-4.5).
+ */
+import { execFileSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const ROOT = join(dirname(fileURLToPath(import.meta.url)), "..");
+const OUT_DIR = join(ROOT, "assets", "avatars-drafts");
+const API = "https://openrouter.ai/api/v1/images";
+const MODEL = process.env.OPENROUTER_IMAGE_MODEL || "bytedance-seed/seedream-4.5";
+/** Per-animal subject line; the rest of the constraint frame is fixed. */
+const ANIMALS = [
+  { name: "instance-01", subject: "an orange tabby cat's head", accent: "vibrant orange fur, symmetrical green eyes" },
+  { name: "instance-02", subject: "a penguin's head", accent: "black and white plumage, symmetrical round eyes, small orange beak" },
+  { name: "instance-03", subject: "a red fox's head", accent: "rust-orange fur, white muzzle, symmetrical amber eyes, pointed ears with dark tips" },
+  { name: "instance-04", subject: "a brown owl's head", accent: "brown feather pattern, big symmetrical round eyes, small sharp beak" },
+  { name: "instance-05", subject: "a white rabbit's head", accent: "soft white fur, long upright ears with pink inner side, symmetrical pink eyes" },
+  { name: "instance-06", subject: "a shiba inu dog's head", accent: "cream and orange fur, symmetrical happy squinting eyes" },
+  { name: "instance-07", subject: "a gray cat's head", accent: "blue-gray fur, symmetrical yellow eyes, unimused half-lidded look" },
+  { name: "instance-08", subject: "a brown bear cub's head", accent: "round fluffy brown fur, small rounded ears, symmetrical sleepy eyes" },
+  { name: "instance-09", subject: "a giant panda's head", accent: "white and black fur, black eye patches, symmetrical curious eyes" },
+  { name: "instance-10", subject: "a green frog's head", accent: "green skin, two bumps on top, symmetrical sleepy half-lidded eyes, wide closed mouth" },
+  { name: "instance-11", subject: "a red squirrel's head", accent: "russet fur, tufted ears, symmetrical bright excited eyes" },
+  { name: "instance-12", subject: "a yellow chick's head", accent: "fluffy yellow, tiny orange beak, symmetrical wide worried eyes" },
+  { name: "management", subject: "an orange cat's head wearing a small golden crown", accent: "vibrant orange fur, symmetrical smug green eyes, tiny golden crown between the ears" },
+];
+const promptFor = (a) =>
+  `A flat 2D pixel art icon of ${a.subject}, perfectly symmetrical front-facing view, looking directly ` +
+  `at the viewer, eyes centered and staring straight ahead. Full frontal face. Head only, no neck, no body, ` +
+  `no chest. Face filling the entire frame, cut off exactly at the chin. ${a.accent}. ` +
+  `Sharp, crisp hard pixel edges, no anti-aliasing, isolated on a pure white solid background. ` +
+  `A small white Greek letter 'π' placed strictly in the extreme bottom left corner, not overlapping the face. ` +
+  `8-bit retro game avatar style.`;
+// 负面提示词:封杀侧脸、偏头、透视、3D、身体与模糊(用户提供的定稿,全动物通用)
+const NEGATIVE =
+  "3D, realistic, side profile, three-quarter view, perspective, angle, rotation, tilt, tilted head, " +
+  "looking away, body, chest, neck, shoulders, torso, blurry, fuzzy edges, soft, smooth, blending, " +
+  "gradient, shadows, depth, watermark, text box, logo background, overlapping, low quality, distorted";
+// ---- key --------------------------------------------------------------------
+function apiKey() {
+  if (process.env.OPENROUTER_API_KEY) return process.env.OPENROUTER_API_KEY;
+  try {
+    const cfg = JSON.parse(readFileSync(join(homedir(), ".zcode", "v2", "config.json"), "utf8"));
+    for (const p of Object.values(cfg.provider ?? {})) {
+      const opts = p.options ?? {};
+      if (String(opts.baseURL ?? "").includes("openrouter.ai") && opts.apiKey) return opts.apiKey;
+    }
+  } catch {
+    // fall through
+  }
+  console.error("缺少 OPENROUTER_API_KEY(或 ~/.zcode 里配置 OpenRouter provider)");
+  process.exit(1);
+}
+// ---- API --------------------------------------------------------------------
+async function generateImage(key, prompt) {
+  const res = await fetch(API, {
+    method: "POST",
+    headers: { authorization: `Bearer ${key}`, "content-type": "application/json" },
+    body: JSON.stringify({ model: MODEL, prompt, negative_prompt: NEGATIVE }),
+    signal: AbortSignal.timeout(180_000), // 挂起的连接最多等 3 分钟,失败进重试
+  });
+  if (!res.ok) throw new Error(`HTTP ${res.status}: ${(await res.text()).slice(0, 250)}`);
+  const data = await res.json();
+  const item = data?.data?.[0];
+  if (item?.b64_json) return Buffer.from(item.b64_json, "base64");
+  if (item?.url) {
+    const img = await fetch(item.url);
+    if (!img.ok) throw new Error(`图片下载失败: HTTP ${img.status}`);
+    return Buffer.from(await img.arrayBuffer());
+  }
+  throw new Error(`响应无图: ${JSON.stringify(data).slice(0, 200)}`);
+}
+// ---- post-process -----------------------------------------------------------
+function hasFfmpeg() {
+  try {
+    execFileSync("ffmpeg", ["-version"], { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function toAvatar128(rawPath, outPath) {
+  execFileSync(
+    "ffmpeg",
+    ["-y", "-loglevel", "error", "-i", rawPath, "-vf", "scale=128:128:flags=neighbor", outPath],
+    { stdio: "ignore" }
+  );
+}
+// ---- run --------------------------------------------------------------------
+const only = (() => {
+  const flag = process.argv.findIndex((a) => a === "--only" || a.startsWith("--only="));
+  if (flag === -1) return null;
+  const value = process.argv[flag].startsWith("--only=") ? process.argv[flag].slice(7) : process.argv[flag + 1] ?? "";
+  return value.split(",").filter(Boolean);
+})();
+const targets = only ? ANIMALS.filter((a) => only.includes(a.name)) : ANIMALS;
+const missing = only?.filter((n) => !ANIMALS.some((a) => a.name === n));
+if (missing?.length) {
+  console.error(`未知头像名: ${missing.join(",")}(可选: ${ANIMALS.map((a) => a.name).join(" ")})`);
+  process.exit(1);
+}
+const key = apiKey();
+mkdirSync(OUT_DIR, { recursive: true });
+const useFfmpeg = hasFfmpeg();
+let ok = 0;
+for (const avatar of targets) {
+  const attempts = 3;
+  for (let attempt = 1; attempt <= attempts; attempt++) {
+    try {
+      const bytes = await generateImage(key, promptFor(avatar));
+      const rawPath = join(OUT_DIR, `${avatar.name}-seedream-raw.png`);
+      writeFileSync(rawPath, bytes);
+      let note = "仅原图";
+      if (useFfmpeg) {
+        const outPath = join(OUT_DIR, `${avatar.name}-seedream.png`);
+        toAvatar128(rawPath, outPath);
+        note = "128×128";
+      }
+      console.log(`✔ ${avatar.name}(${(bytes.length / 1024).toFixed(0)} KB)→ ${note}`);
+      ok++;
+      break;
+    } catch (err) {
+      console.warn(`✗ ${avatar.name} 第 ${attempt}/${attempts} 次失败: ${err.message ?? err}`);
+      if (attempt === attempts) console.error(`✗✗ ${avatar.name} 放弃,可 --only=${avatar.name} 重试`);
+      else await new Promise((r) => setTimeout(r, 2000));
+    }
+  }
+}
+console.log(`\n完成 ${ok}/${targets.length} → ${OUT_DIR}`);

package/scripts/generate-avatars-zhipu.mjs ADDED Viewed

@@ -0,0 +1,171 @@
+#!/usr/bin/env node
+/**
+ * Generate animal-avatar drafts via 智谱 CogView-3-Flash (free tier).
+ *
+ * Human-in-the-loop tool: writes candidates to assets/avatars-drafts/ for
+ * review; winners are copied over the same-named file in assets/avatars/ by
+ * hand (runtime pool contract: same filename, drop-in replacement). Nothing
+ * here runs at pi-courier runtime and no key is shipped.
+ *
+ * Pipeline per avatar: CogView (Minecraft-style chunky pixel animal, ~90% of
+ * canvas, one distinct expression each) → ffmpeg crop of the right strip
+ * (CogView keeps painting garbled mini-text at the bottom-right edge) →
+ * 128×128 nearest-neighbour → drawtext amber π signature in the bottom-left
+ * (DejaVu Sans Bold; the text-model renders the glyph far better than image
+ * models do at tiny sizes).
+ *
+ * Usage:
+ *   node scripts/generate-avatars-zhipu.mjs               # all 13
+ *   node scripts/generate-avatars-zhipu.mjs --only instance-02,management
+ *   node scripts/generate-avatars-zhipu.mjs --only instance-05   # either syntax
+ *
+ * Key resolution: env ZHIPU_API_KEY, else the Bigmodel/GLM provider entry in
+ * ~/.zcode/v2/config.json (local convenience — never printed, never shipped).
+ */
+import { execFileSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const ROOT = join(dirname(fileURLToPath(import.meta.url)), "..");
+const OUT_DIR = join(ROOT, "assets", "avatars-drafts");
+const API = "https://open.bigmodel.cn/api/paas/v4/images/generations";
+const MODEL = process.env.ZHIPU_IMAGE_MODEL || "cogview-3-flash"; // free tier
+const FONT = "/usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf";
+const STYLE =
+  "像游戏皮肤一样的大块平涂像素,整个画面就像低分辨率像素图被放大了很多倍,每个方块颗粒都清晰可见," +
+  "只用少数几种颜色平涂,没有渐变没有细腻阴影,边缘是锯齿方块";
+const ANIMALS = [
+  { name: "instance-01", subject: "橘色小猫", look: "大头圆润,咧嘴大笑吐着舌头,表情夸张开心", bg: "深蓝灰色" },
+  { name: "instance-02", subject: "企鹅", look: "圆滚滚,呆萌好奇地张着小嘴", bg: "淡紫色" },
+  { name: "instance-03", subject: "狐狸", look: "尖耳朵大尾巴,狡黠地眯眼微笑", bg: "薄荷绿色" },
+  { name: "instance-04", subject: "猫头鹰", look: "圆眼睛一丝不苟的严肃表情", bg: "暖橙红色" },
+  { name: "instance-05", subject: "白兔", look: "长耳朵,害羞脸红", bg: "深绿色" },
+  { name: "instance-06", subject: "柴犬", look: "卷尾巴,经典的眯眼狗子微笑", bg: "雾蓝色" },
+  { name: "instance-07", subject: "灰色猫咪", look: "斜眼傲慢嫌弃的表情", bg: "暖米色" },
+  { name: "instance-08", subject: "小棕熊", look: "圆耳朵,困倦地打哈欠", bg: "青绿色" },
+  { name: "instance-09", subject: "熊猫", look: "黑眼圈,惊讶地张大嘴", bg: "天蓝色" },
+  { name: "instance-10", subject: "青蛙", look: "大嘴巴闭着微微上扬,慵懒地半睁着眼,看不到牙齿", bg: "浅粉色" },
+  { name: "instance-11", subject: "松鼠", look: "大尾巴,兴奋地睁大眼睛抱着一颗松果", bg: "淡黄色" },
+  { name: "instance-12", subject: "小鸡", look: "圆圆的黄色身子橙色小嘴,惊慌地张开小翅膀,只有黄白橙三色,配色简单干净", bg: "纯靛蓝色,没有任何景物" },
+  { name: "management", subject: "头顶戴着小小金色皇冠的橘猫", look: "得意的表情", bg: "深紫红色" },
+];
+const promptFor = (a) =>
+  `我的世界游戏生物那样的超粗大方块像素画:一只${a.subject},${a.look},${STYLE};` +
+  `${a.subject}极其大,占据画面约九成,头顶和脚几乎贴到画布边缘,只留很窄的${a.bg}纯色背景边;` +
+  "整张图没有任何文字、字母或水印";
+// ---- key --------------------------------------------------------------------
+function apiKey() {
+  if (process.env.ZHIPU_API_KEY) return process.env.ZHIPU_API_KEY;
+  try {
+    const cfgPath = join(homedir(), ".zcode", "v2", "config.json");
+    const cfg = JSON.parse(readFileSync(cfgPath, "utf8"));
+    for (const p of Object.values(cfg.provider ?? {})) {
+      const opts = p.options ?? {};
+      if (String(opts.baseURL ?? "").includes("open.bigmodel.cn") && opts.apiKey) return opts.apiKey;
+    }
+  } catch {
+    // fall through to the error below
+  }
+  console.error("缺少智谱 API key:设 ZHIPU_API_KEY,或在 ~/.zcode/v2/config.json 配置 Bigmodel/GLM provider");
+  process.exit(1);
+}
+// ---- CogView call -----------------------------------------------------------
+async function generateImage(key, prompt) {
+  const res = await fetch(API, {
+    method: "POST",
+    headers: { authorization: `Bearer ${key}`, "content-type": "application/json" },
+    body: JSON.stringify({ model: MODEL, size: "1024x1024", prompt }),
+  });
+  if (!res.ok) throw new Error(`HTTP ${res.status}: ${(await res.text()).slice(0, 200)}`);
+  const data = await res.json();
+  const item = data?.data?.[0];
+  if (!item) throw new Error(`响应无图: ${JSON.stringify(data).slice(0, 200)}`);
+  if (item.b64_json) return Buffer.from(item.b64_json, "base64");
+  if (item.url) {
+    const img = await fetch(item.url);
+    if (!img.ok) throw new Error(`图片下载失败: HTTP ${img.status}`);
+    return Buffer.from(await img.arrayBuffer());
+  }
+  throw new Error("响应既无 url 也无 b64_json");
+}
+// ---- ffmpeg pipeline --------------------------------------------------------
+function ffmpeg(args, quiet = true) {
+  execFileSync("ffmpeg", ["-y", "-loglevel", "error", ...args], { stdio: quiet ? "ignore" : "inherit" });
+}
+/** Right strip crop kills CogView's garbled corner text, then 128×128
+ *  nearest-neighbour keeps the blocks chunky. */
+function toAvatar128(rawPath, outPath) {
+  ffmpeg(["-i", rawPath, "-vf", "crop=920:1024:0:0,scale=128:128:flags=neighbor", outPath]);
+}
+function stampPi(outPath) {
+  if (!existsSync(FONT)) {
+    console.warn(`⚠ 未找到 ${FONT},跳过 π 签名(仅此一张)`);
+    return false;
+  }
+  ffmpeg([
+    "-i", outPath,
+    "-vf",
+    `drawtext=textfile=${join(OUT_DIR, ".pi.txt")}:fontfile=${FONT}:fontsize=17:fontcolor=0xF6A821:x=8:y=128-th-8`,
+    join(OUT_DIR, ".tmp.png"),
+  ]);
+  execFileSync("mv", [join(OUT_DIR, ".tmp.png"), outPath]);
+  return true;
+}
+// ---- run --------------------------------------------------------------------
+const only = (() => {
+  const flag = process.argv.findIndex((a) => a === "--only" || a.startsWith("--only="));
+  if (flag === -1) return null;
+  const value = process.argv[flag].startsWith("--only=") ? process.argv[flag].slice(7) : process.argv[flag + 1] ?? "";
+  return value.split(",").filter(Boolean);
+})();
+const targets = only ? ANIMALS.filter((a) => only.includes(a.name)) : ANIMALS;
+const missing = only?.filter((n) => !ANIMALS.some((a) => a.name === n));
+if (missing?.length) {
+  console.error(`未知头像名: ${missing.join(",")}(可选: ${ANIMALS.map((a) => a.name).join(" ")})`);
+  process.exit(1);
+}
+const key = apiKey();
+mkdirSync(OUT_DIR, { recursive: true });
+writeFileSync(join(OUT_DIR, ".pi.txt"), "π");
+let ok = 0;
+for (const avatar of targets) {
+  const prompt = promptFor(avatar);
+  const attempts = 3;
+  for (let attempt = 1; attempt <= attempts; attempt++) {
+    try {
+      const bytes = await generateImage(key, prompt);
+      const rawPath = join(OUT_DIR, `${avatar.name}-raw.png`);
+      writeFileSync(rawPath, bytes);
+      const outPath = join(OUT_DIR, `${avatar.name}.png`);
+      toAvatar128(rawPath, outPath);
+      const stamped = stampPi(outPath);
+      console.log(`✔ ${avatar.name}(${avatar.subject},${(bytes.length / 1024).toFixed(0)} KB)${stamped ? " +π" : ""}`);
+      ok++;
+      break;
+    } catch (err) {
+      console.warn(`✗ ${avatar.name} 第 ${attempt}/${attempts} 次失败: ${err.message ?? err}`);
+      if (attempt === attempts) console.error(`✗✗ ${avatar.name} 放弃,可 --only=${avatar.name} 重试`);
+      else await new Promise((r) => setTimeout(r, 2000));
+    }
+  }
+}
+console.log(`\n完成 ${ok}/${targets.length} → ${OUT_DIR}`);

package/scripts/generate-avatars.mjs CHANGED Viewed

@@ -1,5 +1,9 @@
 #!/usr/bin/env node
 /**
+ * ⚠️ RETIRED v1 generator — running this overwrites the current AI-generated
+ * avatar pool (assets/avatars/, made with scripts/generate-avatars-seedream.mjs)
+ * with the old hand-drawn designs. Only run it deliberately to roll back.
+ *
  * Generate the bundled pixel avatars (assets/avatars/*.png) — 12 generic pool
  * images + 1 dedicated management-room image. Blocky pixel style, 16×16 grid
  * rendered at 8× (128×128), zero dependencies (zlib PNG encoder below).