@mingxy/opencode-mascot 0.2.0 → 0.2.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mingxy/opencode-mascot",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "OpenCode TUI mascot plugin framework - customizable ASCII mascots for your terminal",
   "author": "mingxy",
   "license": "MIT",
@@ -15,18 +15,27 @@
     "tui.tsx",
     "src/"
   ],
-  "oc-plugin": ["tui"],
+  "oc-plugin": [
+    "tui"
+  ],
   "scripts": {
     "typecheck": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@opentui/solid": ">=0.0.1",
-    "@opencode-ai/plugin": ">=0.1.0"
+    "@opencode-ai/plugin": ">=0.1.0",
+    "@opentui/solid": ">=0.0.1"
   },
   "devDependencies": {
+    "@types/node": "^25.9.3",
     "typescript": "^5.7.0"
   },
-  "keywords": ["opencode", "tui", "mascot", "plugin", "ascii-art"],
+  "keywords": [
+    "opencode",
+    "tui",
+    "mascot",
+    "plugin",
+    "ascii-art"
+  ],
   "repository": {
     "type": "git",
     "url": "https://github.com/mengfanbo123/opencode-mascot"

package/src/builtins/baozi/index.ts

@@ -8,7 +8,11 @@ const STEAM_PATTERNS = [
   "   ◦∘~   ",
 ];
 
-const BUBBLE_TEXTS = ["ᵃⁿᵍ~", "ˣᶦᵃⁿ!", "ᵏᵘᵃⁱ", "ᶠᵃⁱ"];
+const BUBBLE_TEXTS = [
+  "ᵃⁿᵍ~", "ˣᶦᵃⁿ!", "ᵏᵘᵃⁱ", "ᶠᵃⁱ",
+  "ʳᵉⁿ~..", "ᵖᵃⁿ~", "ᵗᵃⁿᵍ!", "ʸᵉ~..",
+  "ᵐⁱᵃⁿ~", "ᵍᵘᵒ!", "ˢʰᵘ~..", "ʰᵘᵒ~",
+];
 
 const baoziEffects: MascotPack["effects"] = {
   signals: [

package/src/components/home-mascot.tsx

@@ -0,0 +1,103 @@
+/** @jsxImportSource @opentui/solid */
+
+import { createSignal } from "solid-js";
+import type { JSX } from "@opentui/solid";
+import type { MascotPack } from "../core/types";
+import { createAnimatedRenderer } from "../core/ascii-renderer";
+import { onCelebrate } from "../core/celebration-bus";
+
+interface HomeMascotProps {
+  mascots: Record<string, MascotPack>;
+  api: {
+    renderer: {
+      clearSelection(): void;
+    };
+  };
+}
+
+export function HomeMascot(props: HomeMascotProps): JSX.Element {
+  const names = Object.keys(props.mascots);
+  const initialName = names[Math.floor(Math.random() * names.length)];
+
+  const [currentName, setCurrentName] = createSignal(initialName);
+  const [posX, setPosX] = createSignal(0);
+  const [posY, setPosY] = createSignal(0);
+  let dragStartX = 0;
+  let dragStartY = 0;
+  let dragAnchorX = 0;
+  let dragAnchorY = 0;
+  let lastClickTime = 0;
+  let isDragging = false;
+
+  const renderers: Record<string, ReturnType<typeof createAnimatedRenderer>> = {};
+  for (const [name, pack] of Object.entries(props.mascots)) {
+    renderers[name] = createAnimatedRenderer(pack);
+  }
+
+  const switchTo = (name: string) => {
+    if (props.mascots[name] && name !== currentName()) {
+      setCurrentName(name);
+    }
+  };
+
+  onCelebrate((newVersion) => {
+    renderers[currentName()].celebrateUpdate(newVersion);
+  });
+
+  return (
+    <box
+      left={posX()}
+      top={posY()}
+      alignItems="center"
+      zIndex={100}
+      flexDirection="column"
+      onMouseDown={(e: any) => {
+        const now = Date.now();
+        if (now - lastClickTime < 300) {
+          const cur = currentName();
+          const idx = names.indexOf(cur);
+          const next = names[(idx + 1) % names.length];
+          switchTo(next);
+          lastClickTime = 0;
+          return;
+        }
+        lastClickTime = now;
+
+        if (e.modifiers?.alt) {
+          dragStartX = e.x;
+          dragStartY = e.y;
+          dragAnchorX = posX();
+          dragAnchorY = posY();
+          isDragging = true;
+          renderers[currentName()].setDragging(true);
+          e.preventDefault();
+          e.stopPropagation();
+          props.api.renderer.clearSelection();
+        }
+      }}
+      onMouseDrag={(e: any) => {
+        if (e.modifiers?.alt && isDragging) {
+          setPosX(dragAnchorX + (e.x - dragStartX));
+          setPosY(dragAnchorY + (e.y - dragStartY));
+          e.preventDefault();
+          e.stopPropagation();
+          props.api.renderer.clearSelection();
+        }
+      }}
+      onMouseUp={() => {
+        if (isDragging) {
+          isDragging = false;
+          renderers[currentName()].setDragging(false);
+        }
+      }}
+      onMouseDragEnd={() => {
+        if (isDragging) {
+          isDragging = false;
+          renderers[currentName()].setDragging(false);
+        }
+      }}
+    >
+      {renderers[currentName()]?.element() ?? null}
+    </box>
+  );
+}

package/src/components/sidebar-mascot.tsx

@@ -4,6 +4,7 @@ import { createSignal } from "solid-js";
 import type { JSX } from "@opentui/solid";
 import type { MascotPack, MascotState, SwitchConfig } from "../core/types";
 import { createAnimatedRenderer } from "../core/ascii-renderer";
+import { onCelebrate } from "../core/celebration-bus";
 
 interface SidebarMascotProps {
   mascots: Record<string, MascotPack>;
@@ -100,6 +101,10 @@ export function SidebarMascot(props: SidebarMascotProps): JSX.Element {
     renderers[currentName()].toggleWalk();
   });
 
+  onCelebrate((newVersion) => {
+    renderers[currentName()].celebrateUpdate(newVersion);
+  });
+
   return (
     <box
       position="absolute"

package/src/core/ascii-renderer.tsx

@@ -47,6 +47,7 @@ export function createAnimatedRenderer(pack: MascotPack): {
   setState: (s: MascotState) => void;
   toggleWalk: () => void;
   setDragging: (v: boolean) => void;
+  celebrateUpdate: (newVersion: string) => void;
 } {
   const anim = { ...DEFAULT_ANIM, ...pack.animations };
   const fg = pack.colors?.defaultFg || undefined;
@@ -59,6 +60,7 @@ export function createAnimatedRenderer(pack: MascotPack): {
   const [jumpOffset, setJumpOffset] = createSignal(0);
   const [walkEnabled, setWalkEnabled] = createSignal(anim.walkEnabled ?? true);
   const [dragging, setDraggingSignal] = createSignal(false);
+  const [celebrate, setCelebrate] = createSignal<{ text: string; count: number } | null>(null);
 
   let idleSleepTimeout: ReturnType<typeof setTimeout> | null = null;
 
@@ -227,6 +229,7 @@ export function createAnimatedRenderer(pack: MascotPack): {
     frameOverride();
     currentState();
     dragging();
+    celebrate();
 
     for (const [, [get]] of extraSignals) {
       get();
@@ -261,10 +264,12 @@ export function createAnimatedRenderer(pack: MascotPack): {
 
     const top = jumpOffset();
     const left = offset > 0 ? offset : 0;
+    const cel = celebrate();
 
     return (
       <box flexDirection="column" left={left} top={top}>
         {renderLines(lines, fg)}
+        {cel ? <text fg={fg}>{cel.text}</text> : null}
       </box>
     );
   };
@@ -296,11 +301,37 @@ export function createAnimatedRenderer(pack: MascotPack): {
   const setDragging = (v: boolean) => {
     setDraggingSignal(v);
     if (v) {
+      // 睡着时被拖拽 → 惊醒到 idle，切回 default 帧后手臂 ┃███┃ 才能被扇手渲染匹配
+      if (currentState() === "sleeping") {
+        setState("idle");
+      }
       setJumpOffset(-1);
     } else {
       setJumpOffset(0);
     }
   };
 
-  return { element, setState, toggleWalk, setDragging };
+  // 连续跳跃 + 吐火星文泡泡庆祝更新成功
+  const celebrateUpdate = (newVersion: string) => {
+    const bubbles = pack.bubbleTexts ?? ["ᵘᵖ~"];
+    if (currentState() === "sleeping") setState("idle");
+
+    let step = 0;
+    const JUMPS = 3;
+    const tick = () => {
+      if (step >= JUMPS) {
+        setJumpOffset(0);
+        setCelebrate(null);
+        return;
+      }
+      setJumpOffset(step % 2 === 0 ? -2 : 0);
+      const word = bubbles[Math.floor(Math.random() * bubbles.length)];
+      setCelebrate({ text: `${word} ᵘᵖ→ᵛ${newVersion}`, count: step });
+      step++;
+      setTimeout(tick, 600);
+    };
+    tick();
+  };
+
+  return { element, setState, toggleWalk, setDragging, celebrateUpdate };
 }

package/src/core/celebration-bus.ts

@@ -0,0 +1,16 @@
+const bus = new EventTarget();
+
+const CELEBRATE_EVENT = "mascot:celebrate";
+
+export function emitCelebrate(newVersion: string): void {
+  bus.dispatchEvent(new CustomEvent(CELEBRATE_EVENT, { detail: { newVersion } }));
+}
+
+export function onCelebrate(handler: (newVersion: string) => void): () => void {
+  const listener = (e: Event) => {
+    const detail = (e as CustomEvent).detail as { newVersion: string };
+    handler(detail.newVersion);
+  };
+  bus.addEventListener(CELEBRATE_EVENT, listener);
+  return () => bus.removeEventListener(CELEBRATE_EVENT, listener);
+}

package/src/core/updater.ts

@@ -0,0 +1,125 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { createRequire } from "node:module";
+import { join, dirname } from "node:path";
+import { homedir, tmpdir } from "node:os";
+import { openSync, closeSync, unlinkSync, statSync, writeSync, mkdtempSync, readdirSync, rmSync, readFileSync, writeFileSync } from "node:fs";
+
+const execFileAsync = promisify(execFile);
+const require = createRequire(import.meta.url);
+
+const PKG_NAME = "@mingxy/opencode-mascot";
+const LOCK_FILE = join(tmpdir(), "mascot-update.lock");
+const STALE_LOCK_MS = 5 * 60 * 1000;
+let lockFd: number | null = null;
+
+async function getLatestVersion(): Promise<string | null> {
+  try {
+    const { stdout } = await execFileAsync("npm", ["view", PKG_NAME, "version"], { timeout: 10000 });
+    return stdout.trim();
+  } catch {
+    return null;
+  }
+}
+
+function compareVersions(a: string, b: string): number {
+  const pa = a.replace(/^v/, "").split(".").map(Number);
+  const pb = b.replace(/^v/, "").split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((pa[i] ?? 0) > (pb[i] ?? 0)) return 1;
+    if ((pa[i] ?? 0) < (pb[i] ?? 0)) return -1;
+  }
+  return 0;
+}
+
+function getInstallDir(): string {
+  try {
+    const pkgPath = require.resolve(`${PKG_NAME}/package.json`);
+    return dirname(pkgPath);
+  } catch {
+    return join(homedir(), ".cache", "opencode", "packages", "@mingxy", "opencode-mascot");
+  }
+}
+
+async function installUpdate(targetDir: string, newVersion: string): Promise<boolean> {
+  const tmpDir = mkdtempSync(join(tmpdir(), "mascot-update-"));
+  try {
+    await execFileAsync("npm", ["pack", `${PKG_NAME}@latest`, "--pack-destination", tmpDir], { timeout: 60000 });
+    const files = readdirSync(tmpDir);
+    const tgz = files.find(f => f.endsWith(".tgz"));
+    if (!tgz) return false;
+    await execFileAsync(
+      "tar",
+      ["-xzf", join(tmpDir, tgz), "-C", targetDir, "--strip-components=1", "--no-same-owner", "--no-same-permissions"],
+      { timeout: 30000 },
+    );
+
+    // 更新 opencode 插件管理清单的版本号，防止重启时回滚
+    let dir = targetDir;
+    for (let i = 0; i < 5; i++) {
+      dir = dirname(dir);
+      const manifestPath = join(dir, "package.json");
+      try {
+        const manifest = JSON.parse(readFileSync(manifestPath, "utf-8"));
+        if (manifest.dependencies && PKG_NAME in manifest.dependencies) {
+          manifest.dependencies[PKG_NAME] = newVersion;
+          writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + "\n");
+          break;
+        }
+      } catch {}
+    }
+
+    return true;
+  } catch {
+    return false;
+  } finally {
+    try { rmSync(tmpDir, { recursive: true }); } catch {}
+  }
+}
+
+function acquireLock(): boolean {
+  try {
+    try {
+      const s = statSync(LOCK_FILE);
+      if (Date.now() - s.mtimeMs > STALE_LOCK_MS) unlinkSync(LOCK_FILE);
+    } catch {}
+    lockFd = openSync(LOCK_FILE, "wx");
+    writeSync(lockFd, String(process.pid));
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function releaseLock(): void {
+  if (lockFd !== null) {
+    try { closeSync(lockFd); } catch {}
+    lockFd = null;
+    try { unlinkSync(LOCK_FILE); } catch {}
+  }
+}
+
+/**
+ * 更新成功后的回调：把新版本号交给调用方，由其触发吉祥物庆祝动画
+ */
+export async function checkAndUpdate(
+  currentVersion: string,
+  onSuccess: (newVersion: string) => void,
+): Promise<void> {
+  const latest = await getLatestVersion();
+  if (!latest) return;
+
+  if (compareVersions(latest, currentVersion) <= 0) return;
+
+  if (!acquireLock()) return;
+
+  try {
+    const targetDir = getInstallDir();
+    const success = await installUpdate(targetDir, latest);
+    if (success) {
+      onSuccess(latest);
+    }
+  } finally {
+    releaseLock();
+  }
+}

package/tui.tsx

@@ -1,13 +1,27 @@
 /** @jsxImportSource @opentui/solid */
 import type { TuiPlugin, TuiPluginModule } from "@opencode-ai/plugin/tui"
-import { loadAllMascots, getRandomMascot } from "./src/core/mascot-loader"
+import { readFileSync } from "node:fs"
+import { join, dirname } from "node:path"
+import { fileURLToPath } from "node:url"
+import { loadAllMascots } from "./src/core/mascot-loader"
 import { SidebarMascot } from "./src/components/sidebar-mascot"
-import { createAnimatedRenderer } from "./src/core/ascii-renderer"
+import { HomeMascot } from "./src/components/home-mascot"
+import { checkAndUpdate } from "./src/core/updater"
+import { emitCelebrate } from "./src/core/celebration-bus"
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+let pluginVersion = "unknown";
+try {
+  const pkg = JSON.parse(readFileSync(join(__dirname, "package.json"), "utf-8"));
+  if (pkg?.version && typeof pkg.version === "string") {
+    pluginVersion = pkg.version;
+  }
+} catch {}
 
 const tui: TuiPlugin = async (api, _options) => {
   const mascots = loadAllMascots()
-  const homeMascot = getRandomMascot()
-  const homeRenderer = createAnimatedRenderer(homeMascot)
 
   api.slots.register({
     slots: {
@@ -15,14 +29,14 @@ const tui: TuiPlugin = async (api, _options) => {
         return <SidebarMascot mascots={mascots} api={api} />
       },
       home_bottom() {
-        return (
-          <box flexDirection="column" alignItems="center">
-            {homeRenderer.element()}
-          </box>
-        )
+        return <HomeMascot mascots={mascots} api={api} />
       }
     }
   })
+
+  checkAndUpdate(pluginVersion, (newVersion) => {
+    emitCelebrate(newVersion);
+  }).catch(() => {});
 }
 
 const plugin: TuiPluginModule = {