codepet 1.0.0

package/scripts/animate.py

@@ -0,0 +1,207 @@
+#!/usr/bin/env python3
+"""CodePet 终端动画 — 眨眼、动嘴、摆手"""
+
+import os, sys, time, copy
+
+SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
+sys.path.insert(0, SCRIPT_DIR)
+
+from img2terminal import render_image
+from PIL import Image, ImageDraw
+
+SPRITE_DIR = os.path.join(SCRIPT_DIR, "..", "sprites")
+RESET = "\033[0m"
+BOLD = "\033[1m"
+HIDE_CURSOR = "\033[?25l"
+SHOW_CURSOR = "\033[?25h"
+
+# ── 每个角色的关键区域（基于裁切后的图片坐标）──
+# 格式: { 'eyes': (x1,y1,x2,y2), 'mouth': (x1,y1,x2,y2), 'arm': (x1,y1,x2,y2) }
+# 用 None 表示没有该部位动画
+
+REGIONS = {
+    'bibilabu': {
+        'eyes': (105, 90, 160, 110),     # 猫眼睛区域
+        'mouth': (115, 110, 150, 130),   # 猫嘴区域
+    },
+    'bagayalu': {
+        'eyes': (100, 100, 200, 130),    # 水豚眼
+        'mouth': (120, 140, 200, 175),   # 水豚嘴
+    },
+    'wodedaodun': {
+        'eyes': (60, 80, 140, 110),      # 柴犬眼
+        'mouth': (80, 115, 150, 145),    # 柴犬嘴
+    },
+    'bababoyi': {
+        'eyes': (60, 80, 220, 130),      # 猫球大眼
+        'mouth': (110, 130, 170, 155),   # 猫球嘴
+    },
+    'waibibabu': {
+        'eyes': (100, 75, 190, 100),     # 壮汉眼
+        'mouth': (95, 115, 195, 155),    # 壮汉嘴/胡子
+        'arm':  (50, 170, 250, 250),     # 壮汉手臂
+    },
+    'gugugaga': {
+        'eyes': (80, 120, 210, 155),     # 刘海猫眼
+        'mouth': (120, 160, 185, 185),   # 刘海猫嘴
+    },
+}
+
+def make_blink_frame(img, eye_region):
+    """眨眼：用眼睛区域的平均肤色画一条横线盖住眼睛"""
+    frame = img.copy()
+    x1, y1, x2, y2 = eye_region
+    # 取眼睛周围的肤色（眼睛上方几像素）
+    sample_y = max(0, y1 - 5)
+    colors = []
+    for x in range(x1, min(x2, frame.width)):
+        px = frame.getpixel((x, sample_y))
+        if len(px) >= 3:
+            colors.append(px[:3])
+    if not colors:
+        return frame
+    avg = tuple(sum(c[i] for c in colors) // len(colors) for i in range(3))
+
+    draw = ImageDraw.Draw(frame)
+    # 画一条略粗的线代表闭眼
+    mid_y = (y1 + y2) // 2
+    for dy in range(-1, 2):
+        draw.line([(x1 + 3, mid_y + dy), (x2 - 3, mid_y + dy)], fill=avg + (255,), width=1)
+    return frame
+
+def make_mouth_open(img, mouth_region):
+    """张嘴：把嘴巴区域往下移 2px，露出深色缝隙"""
+    frame = img.copy()
+    x1, y1, x2, y2 = mouth_region
+    # 拷贝嘴巴区域
+    mouth = frame.crop((x1, y1, x2, y2))
+    # 用嘴巴上方的颜色填充原位置（模拟张开）
+    sample_y = max(0, y1 - 2)
+    for x in range(x1, min(x2, frame.width)):
+        px = frame.getpixel((x, sample_y))
+        for y in range(y1, min(y1 + 3, y2)):
+            frame.putpixel((x, y), px)
+    # 嘴巴下移
+    frame.paste(mouth, (x1, y1 + 2))
+    return frame
+
+def make_arm_move(img, arm_region):
+    """摆手：把手臂区域往左/右移 3px"""
+    frame = img.copy()
+    x1, y1, x2, y2 = arm_region
+    arm = frame.crop((x1, y1, x2, y2))
+    # 用背景色填原位
+    bg_color = (255, 255, 255, 0)
+    draw = ImageDraw.Draw(frame)
+    draw.rectangle([x1, y1, x2, y2], fill=bg_color)
+    # 手臂左移
+    frame.paste(arm, (x1 - 3, y1))
+    return frame
+
+def generate_character_frames(name, img):
+    """为每个角色生成动画序列"""
+    regions = REGIONS.get(name, {})
+    frames = [img]  # 帧0: 原图
+
+    eye_r = regions.get('eyes')
+    mouth_r = regions.get('mouth')
+    arm_r = regions.get('arm')
+
+    if name == 'waibibabu':
+        # 歪比巴卜: 原图 → 摆手 → 原图 → 眨眼张嘴
+        if arm_r:
+            frames.append(make_arm_move(img, arm_r))
+        frames.append(img.copy())
+        if eye_r and mouth_r:
+            f = make_blink_frame(img, eye_r)
+            f = make_mouth_open(f, mouth_r)
+            frames.append(f)
+    elif name == 'bababoyi':
+        # 巴巴博一: 原图 → 原图 → 原图 → 眨眼（猫头鹰眨眼慢）
+        frames.append(img.copy())
+        frames.append(img.copy())
+        if eye_r:
+            frames.append(make_blink_frame(img, eye_r))
+    elif name == 'wodedaodun':
+        # 我的刀盾: 基本不动，偶尔张嘴（打哈欠）
+        frames.append(img.copy())
+        frames.append(img.copy())
+        if mouth_r:
+            frames.append(make_mouth_open(img, mouth_r))
+    else:
+        # 其他角色: 原图 → 原图 → 眨眼 → 张嘴
+        frames.append(img.copy())
+        if eye_r:
+            frames.append(make_blink_frame(img, eye_r))
+        if mouth_r:
+            frames.append(make_mouth_open(img, mouth_r))
+
+    return frames
+
+def animate(name, width=45, fps=2, duration=0):
+    img_path = os.path.join(SPRITE_DIR, f"{name}.png")
+    if not os.path.exists(img_path):
+        print(f"图片不存在: {img_path}")
+        return
+
+    names_zh = {
+        'bibilabu': '比比拉布', 'bagayalu': '八嘎呀路',
+        'wodedaodun': '我的刀盾', 'bababoyi': '巴巴博一',
+        'waibibabu': '歪比巴卜', 'gugugaga': '咕咕嘎嘎',
+    }
+
+    img = Image.open(img_path).convert("RGBA")
+
+    # 生成动画帧（图片级别）
+    img_frames = generate_character_frames(name, img)
+
+    # 预渲染所有帧为终端字符串
+    rendered = []
+    for f in img_frames:
+        rendered.append(render_image(f, width))
+
+    delay = 1.0 / fps
+    frame_count = len(rendered)
+    zh = names_zh.get(name, name)
+    line_count = len(rendered[0].splitlines())
+
+    print(HIDE_CURSOR, end="")
+    print(f"\n  {BOLD}{zh}{RESET}（Ctrl+C 退出）\n")
+
+    try:
+        i = 0
+        while True:
+            frame = rendered[i % frame_count]
+            for line in frame.splitlines():
+                print(f"    {line}")
+            sys.stdout.flush()
+            time.sleep(delay)
+            print(f"\033[{line_count}A", end="")
+            i += 1
+            if duration > 0 and i > duration * fps:
+                break
+    except KeyboardInterrupt:
+        pass
+    finally:
+        for line in rendered[0].splitlines():
+            print(f"    {line}")
+        print(SHOW_CURSOR)
+        print()
+
+if __name__ == "__main__":
+    name_map = {
+        '比比拉布': 'bibilabu', '八嘎呀路': 'bagayalu',
+        '我的刀盾': 'wodedaodun', '巴巴博一': 'bababoyi',
+        '歪比巴卜': 'waibibabu', '咕咕嘎嘎': 'gugugaga',
+    }
+
+    if len(sys.argv) < 2:
+        print("用法: python3 animate.py <角色名> [宽度] [fps]")
+        print("例: python3 animate.py 歪比巴卜 45 2")
+        sys.exit(1)
+
+    name = name_map.get(sys.argv[1], sys.argv[1])
+    width = int(sys.argv[2]) if len(sys.argv) > 2 else 45
+    fps = float(sys.argv[3]) if len(sys.argv) > 3 else 1.5
+
+    animate(name, width, fps)

package/scripts/auto_exp.js

@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+/**
+ * auto_exp.js — PostToolUse hook for Write|Edit events
+ *
+ * 从 stdin 读取 JSON（Claude hook 传入的 tool_input），
+ * 为宠物增加经验值：
+ *   - 普通代码写入 +5 exp
+ *   - 包含错误修复关键词 +10 exp
+ * 同时更新 lastInteraction 时间戳。
+ *
+ * Hook 配置示例（settings.json）：
+ * {
+ *   "hooks": {
+ *     "PostToolUse": [
+ *       {
+ *         "matcher": "Write|Edit",
+ *         "command": "cat /dev/stdin | node auto_exp.js"
+ *       }
+ *     ]
+ *   }
+ * }
+ */
+
+const { loadPet, addExp, savePet } = require('../core/index.js');
+
+// 错误修复关键词
+const FIX_KEYWORDS = [
+  'fix', 'bug', 'error', 'patch', 'hotfix', 'repair', 'resolve',
+  'crash', 'issue', 'broken', 'typo', 'workaround', 'correc',
+  '修复', '修正', '错误', 'debug',
+];
+
+function readStdin() {
+  return new Promise((resolve) => {
+    let data = '';
+    process.stdin.setEncoding('utf-8');
+    process.stdin.on('data', (chunk) => { data += chunk; });
+    process.stdin.on('end', () => resolve(data));
+    // 如果 stdin 不是管道（无数据），500ms 后超时
+    if (process.stdin.isTTY) {
+      resolve('');
+    }
+    setTimeout(() => resolve(data), 500);
+  });
+}
+
+async function main() {
+  const pet = loadPet();
+  if (!pet) process.exit(0);
+
+  const raw = await readStdin();
+
+  let toolInput = {};
+  try {
+    const parsed = JSON.parse(raw);
+    // hook JSON 可能在 tool_input 字段或顶层
+    toolInput = parsed.tool_input || parsed;
+  } catch {
+    // JSON 解析失败，仍然给基础经验
+  }
+
+  // 判断是否为错误修复
+  const content = [
+    toolInput.new_string || '',
+    toolInput.content || '',
+    toolInput.old_string || '',
+    toolInput.file_path || '',
+  ].join(' ').toLowerCase();
+
+  const isFix = FIX_KEYWORDS.some((kw) => content.includes(kw));
+  const expAmount = isFix ? 10 : 5;
+
+  // 更新 lastInteraction
+  pet.lastInteraction = new Date().toISOString();
+
+  // 如果宠物在 sleep 或 worry，互动后恢复清醒
+  if (pet.mood === 'sleep' || pet.mood === 'worry') {
+    pet.mood = '清醒';
+  }
+
+  // 加经验（addExp 内部会 savePet）
+  const result = addExp(pet, expAmount);
+
+  // 升级时输出提示到 stderr
+  if (result.leveledUp) {
+    const name = pet.nickname || pet.name;
+    console.error(`\n🎉 ${name} 升级了！现在是 Lv.${result.newLevel}！`);
+  }
+}
+
+main().catch(() => process.exit(0));

package/scripts/crop_all.py

@@ -0,0 +1,46 @@
+#!/usr/bin/env python3
+"""从原图裁切6个角色并转为终端像素画，同时保存单独的PNG"""
+
+import os
+from PIL import Image
+
+SRC = "/Users/akane/Downloads/20260401160756.jpg"
+OUT_DIR = "/Users/akane/Projects/codepet/sprites"
+os.makedirs(OUT_DIR, exist_ok=True)
+
+img = Image.open(SRC)
+W, H = img.size  # 1056 x 840
+
+# 原图布局: 2行3列 + 底部有文字
+# 第一行: 比比拉布, 八嘎呀路, 我的刀盾 (y: 0~400)
+# 第二行: 巴巴博一, 歪比巴卜, 咕咕嘎嘎 (y: 400~800)
+# 每列约 352px 宽
+
+crops = {
+    'bibilabu':    (30,  10,  290, 310),   # 比比拉布 — 去掉底部文字
+    'bagayalu':    (350, 10,  680, 320),   # 八嘎呀路
+    'wodedaodun':  (720, 50,  1040, 300),  # 我的刀盾
+    'bababoyi':    (20,  410, 300, 670),   # 巴巴博一
+    'waibibabu':   (360, 400, 660, 700),   # 歪比巴卜
+    'gugugaga':    (720, 410, 1040, 690),  # 咕咕嘎嘎
+}
+
+names_zh = {
+    'bibilabu': '比比拉布',
+    'bagayalu': '八嘎呀路',
+    'wodedaodun': '我的刀盾',
+    'bababoyi': '巴巴博一',
+    'waibibabu': '歪比巴卜',
+    'gugugaga': '咕咕嘎嘎',
+}
+
+for name, (x1, y1, x2, y2) in crops.items():
+    cropped = img.crop((x1, y1, x2, y2))
+    # 保存 PNG
+    out_path = os.path.join(OUT_DIR, f"{name}.png")
+    cropped.save(out_path)
+    print(f"[OK] {names_zh[name]} -> {out_path} ({cropped.size[0]}x{cropped.size[1]})")
+
+print(f"\n全部保存到 {OUT_DIR}/")
+print("接下来运行:")
+print("  python3 scripts/img2terminal.py sprites/bibilabu.png 25")

package/scripts/crop_expressions.py

@@ -0,0 +1,73 @@
+#!/usr/bin/env python3
+"""从 6 张表情表裁切出 36 张单图，避开方格线和文字"""
+
+import os
+from PIL import Image
+
+SRC_DIR = "/Users/akane/Projects/codepet/sprites/6"
+OUT_DIR = "/Users/akane/Projects/codepet/sprites"
+
+# 文件 → 角色映射
+FILES = {
+    "1.png": "bibilabu",
+    "2.png": "bagayalu",
+    "3.png": "wodedaodun",
+    "4.png": "bababoyi",
+    "5.png": "waibibabu",
+    "6.png": "gugugaga",
+}
+
+# 表情顺序：2行3列
+EXPRESSIONS = [
+    ["normal", "happy", "sleep"],
+    ["eat", "pet", "worry"],
+]
+
+def crop_sheet(src_path, char_id):
+    """从一张 2x3 表情表裁切出 6 张单图"""
+    img = Image.open(src_path)
+    W, H = img.size
+
+    # 每个格子的大小
+    col_w = W // 3
+    row_h = H // 2
+
+    # 大幅内缩：避开边框线和底部英文文字
+    # 顶部缩 5%，底部缩 28%（文字+边框），左右各缩 6%
+    pad_top = int(row_h * 0.05)
+    pad_bottom = int(row_h * 0.28)
+    pad_left = int(col_w * 0.06)
+    pad_right = int(col_w * 0.06)
+
+    char_dir = os.path.join(OUT_DIR, char_id)
+    os.makedirs(char_dir, exist_ok=True)
+
+    for row_idx, row_exprs in enumerate(EXPRESSIONS):
+        for col_idx, expr in enumerate(row_exprs):
+            x1 = col_idx * col_w + pad_left
+            y1 = row_idx * row_h + pad_top
+            x2 = (col_idx + 1) * col_w - pad_right
+            y2 = (row_idx + 1) * row_h - pad_bottom
+
+            cropped = img.crop((x1, y1, x2, y2))
+            out_path = os.path.join(char_dir, f"{expr}.png")
+            cropped.save(out_path)
+            print(f"  ✓ {char_id}/{expr}.png ({cropped.size[0]}x{cropped.size[1]})")
+
+    print()
+
+def main():
+    print("\n  🔪 裁切表情表...\n")
+    for filename, char_id in FILES.items():
+        src = os.path.join(SRC_DIR, filename)
+        if not os.path.exists(src):
+            print(f"  ✗ {filename} 不存在，跳过")
+            continue
+        print(f"  [{char_id}] ← {filename}")
+        crop_sheet(src, char_id)
+
+    print("  ✅ 36 张裁切完成！")
+    print("  查看: ! open ~/Projects/codepet/sprites/\n")
+
+if __name__ == "__main__":
+    main()

package/scripts/gen_expressions.py

@@ -0,0 +1,95 @@
+#!/usr/bin/env python3
+"""用豆包 Seedream API 批量生成 6 角色 × 6 表情 = 36 张图"""
+
+import os, json, time, urllib.request, urllib.error
+
+ARK_API_KEY = os.environ.get("ARK_API_KEY", "YOUR_API_KEY_HERE")
+API_URL = "https://ark.cn-beijing.volces.com/api/v3/images/generations"
+MODEL = "doubao-seedream-5-0-260128"
+OUT_DIR = os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "sprites")
+
+CHARACTERS = {
+    "bibilabu": "比比拉布, a cute cat wearing a yellow banana costume, cat face peeking out from banana peel, small grey paws, meme style",
+    "bagayalu": "八嘎呀路, a shiba inu dog sitting upright, golden brown fur, melancholic zen expression, meme painting style",
+    "wodedaodun": "我的刀盾, a shiba inu dog lying completely flat on belly like a loaf, brown fur, side view, very flat, meme painting style",
+    "bababoyi": "巴巴博一, an extremely round fat cat shaped like a ball, huge dark owl-like eyes, pink nose, grey and cream colored, meme style",
+    "waibibabu": "歪比巴卜, a cartoon muscular man with grey baseball cap, thick brown beard, white polo shirt, cartoon illustration style",
+    "gugugaga": "咕咕嘎嘎, a round chubby cat with thick dark grey bangs hair covering forehead, white face below bangs, small pink mouth, meme style",
+}
+
+EXPRESSIONS = {
+    "normal": "calm default expression, looking forward",
+    "happy": "very happy, big smile, eyes squinting with joy, sparkles around",
+    "sleep": "eyes peacefully closed, sleeping, zzZ floating above head, peaceful",
+    "eat": "mouth wide open eating food, cheeks puffed, holding food, enjoying",
+    "pet": "being gently petted on head, eyes half-closed in pleasure, blushing cheeks, content",
+    "worry": "anxious worried expression, sweat drop on forehead, nervous wide eyes, stressed",
+}
+
+def generate_image(prompt, output_path):
+    """调用豆包 API 生成图片"""
+    data = json.dumps({
+        "model": MODEL,
+        "prompt": prompt + ", white background, high quality, detailed",
+        "response_format": "url",
+        "size": "2K",
+        "stream": False,
+    }).encode('utf-8')
+
+    req = urllib.request.Request(API_URL, data=data, headers={
+        "Content-Type": "application/json",
+        "Authorization": f"Bearer {ARK_API_KEY}",
+    })
+
+    try:
+        with urllib.request.urlopen(req, timeout=120) as resp:
+            result = json.loads(resp.read())
+            url = result["data"][0]["url"]
+            # 下载图片
+            urllib.request.urlretrieve(url, output_path)
+            return True
+    except Exception as e:
+        print(f"    ✗ 失败: {e}")
+        return False
+
+def main():
+    total = 0
+    success = 0
+    failed = []
+
+    print("\n  🎨 开始生成 36 张角色表情图...\n")
+
+    for char_id, char_desc in CHARACTERS.items():
+        char_dir = os.path.join(OUT_DIR, char_id)
+        os.makedirs(char_dir, exist_ok=True)
+
+        print(f"  [{char_id}]")
+        for expr_id, expr_desc in EXPRESSIONS.items():
+            total += 1
+            output_path = os.path.join(char_dir, f"{expr_id}.png")
+
+            prompt = f"{char_desc}, {expr_desc}"
+            print(f"    {expr_id}...", end=" ", flush=True)
+
+            if generate_image(prompt, output_path):
+                size_kb = os.path.getsize(output_path) // 1024
+                print(f"✓ ({size_kb}KB)")
+                success += 1
+            else:
+                failed.append(f"{char_id}/{expr_id}")
+
+            # 间隔避免限流
+            time.sleep(2)
+
+        print()
+
+    print(f"  ──────────────────────")
+    print(f"  完成: {success}/{total} 成功")
+    if failed:
+        print(f"  失败: {', '.join(failed)}")
+    print(f"\n  查看结果:")
+    print(f"  ! open {OUT_DIR}")
+    print()
+
+if __name__ == "__main__":
+    main()

package/scripts/gen_variants.py

@@ -0,0 +1,107 @@
+#!/usr/bin/env python3
+"""从基础图片自动生成 6 个场景变体"""
+
+import os, sys
+from PIL import Image, ImageEnhance, ImageFilter, ImageDraw, ImageFont
+
+SPRITE_DIR = os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "sprites")
+
+CHARACTERS = ['bibilabu', 'bagayalu', 'wodedaodun', 'bababoyi', 'waibibabu', 'gugugaga']
+
+# 6 个场景
+VARIANTS = {
+    'normal':  '普通',
+    'happy':   '开心',
+    'sleep':   '睡觉',
+    'eat':     '吃东西',
+    'pet':     '被撸',
+    'worry':   '焦虑',
+}
+
+def make_happy(img):
+    """开心：提亮 + 暖色调"""
+    enhancer = ImageEnhance.Brightness(img)
+    bright = enhancer.enhance(1.15)
+    # 暖色：增加红黄
+    r, g, b, a = bright.split()
+    r = r.point(lambda x: min(255, int(x * 1.05)))
+    g = g.point(lambda x: min(255, int(x * 1.02)))
+    return Image.merge('RGBA', (r, g, b, a))
+
+def make_sleep(img):
+    """睡觉：变暗 + 轻微模糊"""
+    enhancer = ImageEnhance.Brightness(img)
+    dark = enhancer.enhance(0.8)
+    enhancer2 = ImageEnhance.Color(dark)
+    desat = enhancer2.enhance(0.7)
+    return desat.filter(ImageFilter.GaussianBlur(radius=0.5))
+
+def make_eat(img):
+    """吃东西：微微歪头（旋转 3 度）"""
+    rotated = img.rotate(-3, expand=False, fillcolor=(255, 255, 255, 0))
+    # 稍微提亮（吃东西开心）
+    enhancer = ImageEnhance.Brightness(rotated)
+    return enhancer.enhance(1.08)
+
+def make_pet(img):
+    """被撸：温暖色调 + 轻微放大"""
+    w, h = img.size
+    # 轻微放大 5%
+    new_w, new_h = int(w * 1.05), int(h * 1.05)
+    big = img.resize((new_w, new_h), Image.LANCZOS)
+    # 裁回原尺寸（居中）
+    left = (new_w - w) // 2
+    top = (new_h - h) // 2
+    cropped = big.crop((left, top, left + w, top + h))
+    # 暖色
+    enhancer = ImageEnhance.Color(cropped)
+    warm = enhancer.enhance(1.1)
+    enhancer2 = ImageEnhance.Brightness(warm)
+    return enhancer2.enhance(1.1)
+
+def make_worry(img):
+    """焦虑：冷色调 + 轻微缩小"""
+    # 冷色：增蓝减红
+    r, g, b, a = img.split()
+    r = r.point(lambda x: int(x * 0.92))
+    b = b.point(lambda x: min(255, int(x * 1.08)))
+    cold = Image.merge('RGBA', (r, g, b, a))
+    # 轻微降低饱和
+    enhancer = ImageEnhance.Color(cold)
+    return enhancer.enhance(0.85)
+
+GENERATORS = {
+    'normal': lambda img: img.copy(),
+    'happy':  make_happy,
+    'sleep':  make_sleep,
+    'eat':    make_eat,
+    'pet':    make_pet,
+    'worry':  make_worry,
+}
+
+def generate_all():
+    total = 0
+    for char in CHARACTERS:
+        base_path = os.path.join(SPRITE_DIR, f"{char}.png")
+        if not os.path.exists(base_path):
+            print(f"  [!] 跳过 {char}：基础图片不存在")
+            continue
+
+        base = Image.open(base_path).convert("RGBA")
+        var_dir = os.path.join(SPRITE_DIR, char)
+        os.makedirs(var_dir, exist_ok=True)
+
+        for variant, zh_name in VARIANTS.items():
+            gen = GENERATORS[variant]
+            result = gen(base)
+            out_path = os.path.join(var_dir, f"{variant}.png")
+            result.save(out_path)
+            total += 1
+
+        print(f"  ✓ {char} — {len(VARIANTS)} 个变体")
+
+    print(f"\n  共生成 {total} 张图片，保存到 {SPRITE_DIR}/[角色名]/")
+
+if __name__ == '__main__':
+    print("\n  🎨 生成角色场景变体...\n")
+    generate_all()

package/scripts/img2ascii.py

@@ -0,0 +1,41 @@
+#!/usr/bin/env python3
+"""将角色图片转为小尺寸 ASCII 字符画 — 保证与角色一致"""
+
+import sys
+from PIL import Image
+
+# 亮度到字符映射（从亮到暗）
+CHARS = " .:-=+*#%@█"
+
+def render(img_path, width=20):
+    img = Image.open(img_path).convert("RGBA")
+    aspect = img.height / img.width
+    height = int(width * aspect * 0.5)  # 字符高宽比补偿
+    img = img.resize((width, height), Image.LANCZOS)
+
+    lines = []
+    for y in range(height):
+        line = ""
+        for x in range(width):
+            r, g, b, a = img.getpixel((x, y))
+            if a < 128 or (r > 245 and g > 245 and b > 245):
+                line += " "
+            else:
+                brightness = (r * 299 + g * 587 + b * 114) / 1000
+                idx = int(brightness / 255 * (len(CHARS) - 1))
+                line += CHARS[len(CHARS) - 1 - idx]  # 反转：暗=密字符
+
+        lines.append(line.rstrip())
+
+    # 去首尾空行
+    while lines and not lines[0].strip():
+        lines.pop(0)
+    while lines and not lines[-1].strip():
+        lines.pop()
+
+    return '\n'.join(lines)
+
+if __name__ == '__main__':
+    path = sys.argv[1]
+    width = int(sys.argv[2]) if len(sys.argv) > 2 else 20
+    print(render(path, width))