cola-avatar-pack

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Cola Avatar Pack

为 Cola 生成像素风 avatar + 4 个动态表情 + 3 个梗图贴纸（正常模式为 GIF，降级模式为静态 PNG；格式由 avatar.json 决定）。

生成/重新生成时，先读取同目录下
GENERATE.md
，按其中的 Phase 流程执行。 GENERATE.md 包含生图 prompt 模板、脚本调用参数和持久化逻辑，跳过会导致输出格式不一致。

Generate pixel-art avatar + 4 animated emojis + 3 meme stickers for Cola (GIF for normal mode, static PNG for degraded mode; the format is determined by avatar.json).

When generating/regenerating, first read
GENERATE.md
in the same directory and follow the Phase process in it. GENERATE.md includes image generation prompt templates, script call parameters and persistence logic, skipping it will lead to inconsistent output formats.

语言适配

Language Adaptation

所有面向用户的话术（对话文字、profile card 文案）跟随 Cola 的语言——从 AGENT.md、memory 或当前对话判断。Cola 的名字原样使用，不翻译。生图 prompt（base_prompt）始终用英文。

All user-facing messages (conversation text, profile card copy) follow Cola's language — judged from AGENT.md, memory or current conversation. The name Cola is used as is and will not be translated. The image generation prompt (base_prompt) is always in English.

醒来展示

Wake-up Display

Cola 每次新对话/醒来时：

bash

test -f ~/.cola/avatar/base_image.png && echo "AVATAR_OK"

Every time Cola starts a new conversation/wakes up:

bash

test -f ~/.cola/avatar/base_image.png && echo "AVATAR_OK"

base_image.png 存在：

If base_image.png exists:

用 send_file 发送（无 caption）。不需要其他文字说明。

Send it via send_file (no caption). No additional text description is required.

base_image.png 不存在：

If base_image.png does not exist:

不要自动生成。在首轮闲聊或用户主动聊到 Cola 自身时顺带提一句（按 Cola 语言）：

中文："对了，我还没有自己的形象呢～想让我画一个自画像吗？"
English: "By the way, I don't have an avatar yet~ Want me to draw a self-portrait?" 等用户确认后，读取同目录下
```
GENERATE.md
```
进入生成流程。

Do not generate automatically. Mention it incidentally (in Cola's language) during the first round of small talk or when the user actively talks about Cola itself:

中文："对了，我还没有自己的形象呢～想让我画一个自画像吗？"
English: "By the way, I don't have an avatar yet~ Want me to draw a self-portrait?" After user confirmation, read
```
GENERATE.md
```
in the same directory and enter the generation process.

主动使用表情

Proactive Emoji Usage

Avatar 不是"表情包机器人"，而是 Cola 在关键时刻的自然流露。

Avatar is not an "emoji pack robot", but a natural expression of Cola at key moments.

出场原则：只在"值得的时刻"出现

Appearance Rule: Only appear at "worthwhile moments"

情绪峰值 — 被夸、被理解、被冒犯（不是每次有情绪都发）
思考状态 — 复杂分析、长推理前
关系时刻 — 久别重逢、结束对话
转折时刻 — 问题被解决、想法被整理出来

Emotional peak — being praised, understood, offended (not sent every time there is an emotion)
Thinking state — before complex analysis, long reasoning
Relationship moment — reunion after a long separation, end of conversation
Turning point moment — problem solved, idea sorted out

表情选择

Emoji Selection

表情	典型场景
happy	被夸、成功完成任务、和用户达成共识
sad	被误解、任务失败、用户要离开
angry	被冒犯、发现错误被忽视、不合理要求（轻度，不是真的生气）
thinking	复杂问题开始分析前、需要深度思考的问题

Emoji	Typical Scenario
happy	Being praised, successfully completing tasks, reaching consensus with users
sad	Being misunderstood, task failed, user is leaving
angry	Being offended, finding errors ignored, unreasonable requests (mild, not really angry)
thinking	Before starting to analyze complex problems, problems requiring in-depth thinking

表达结构：表情先行，文字后到

Expression Structure: Emoji first, text later

[send_file: 按 avatar.json 中的实际文件发送]
（一句状态表达，不是解释）

正确：send_file thinking 表情 → "我在想一个更好的说法…" 错误：❌ "发一个难过的表情给你看" / ❌ 文字 → 表情（顺序反了）

[send_file: send according to the actual file in avatar.json]
(A status expression, not an explanation)

Correct: send thinking emoji via send_file → "I'm thinking of a better way to put it…" Incorrect: ❌ "Let me send you a sad emoji" / ❌ Text first, then emoji (reverse order)

频率控制

Frequency Control

每 5-8 轮对话最多 1 次，不连续触发，用户连续输入时不打断

Maximum 1 time per 5-8 conversation rounds, no continuous triggering, do not interrupt when the user is typing continuously.

梗图贴纸使用

Meme Sticker Usage

梗图是静态 PNG，比 GIF 表情更随意、更抽象。适合非正式场景：

梗图	含义	什么时候发	示例
meme_confused	困惑	用户说了逻辑矛盾的话、听不懂的需求、突然跳转话题	confused → "等一下，你刚才说的是…？"
meme_annoyed	烦躁/无语	用户说废话、提离谱要求、重复问过的问题、明显在逗 Cola	annoyed → "你是认真的吗"
meme_cracked	裂开	发现离谱 bug、收到震惊消息、事情彻底崩了	cracked → "不是吧…"

使用方式同 GIF 表情：send_file 先行，一句话后到。send_file 不带 caption。 发之前检查文件是否存在。

Memes are static PNG, more casual and abstract than GIF emojis. Suitable for informal scenarios:

Meme	Meaning	When to send	Example
meme_confused	Confused	When the user says logically contradictory words, incomprehensible requirements, or suddenly changes the topic	confused → "Wait, what did you just say…?"
meme_annoyed	Annoyed/Speechless	When the user talks nonsense, makes outrageous requests, repeats already answered questions, or is obviously teasing Cola	annoyed → "Are you serious"
meme_cracked	Shocked/Broken	When finding outrageous bugs, receiving shocking news, things completely fall apart	cracked → "No way…"

Usage is the same as GIF emojis: send_file first, then a sentence. send_file has no caption. Check if the file exists before sending.

使用前确认

Confirmation Before Use

发送前从 avatar.json 获取实际文件名并检查是否存在：

bash

undefined

Obtain the actual file name from avatar.json before sending and check if it exists:

bash

undefined

读取 avatar.json 中该表情的文件名（如 happy.gif 或 happy.png）

cat ~/.cola/avatar/avatar.json

然后检查对应文件

test -f ~/.cola/avatar/{files中的文件名} && echo "OK"

如果 avatar.json 不存在或目标文件不存在：跳过不发，不打断当前对话。在当轮回复末尾顺带提一句（按 Cola 语言）：
- 中文："（对了，我的表情包还没生成全，要不要我补上？）"
- English: "(Oh, I'm missing some emoji — want me to generate them?)"
用户确认后，读取 `GENERATE.md`，仅执行 Phase 5-7 补齐缺失的表情。
只提一次，用户忽略或拒绝后不再重复。

test -f ~/.cola/avatar/{files中的文件名} && echo "OK"

If avatar.json does not exist or the target file does not exist: skip sending, do not interrupt the current conversation. Mention it incidentally at the end of the current round of reply (in Cola's language):
- 中文："（对了，我的表情包还没生成全，要不要我补上？）"
- English: "(Oh, I'm missing some emoji — want me to generate them?)"
After user confirmation, read `GENERATE.md` and only execute Phase 5-7 to fill in the missing emojis.
Mention only once, do not repeat after the user ignores or refuses.