huahua-spirits

1. Description

花花灵兽（HuahuaSpirits）为每个用户提供独一无二的灵兽伙伴。灵兽由用户身份确定性生成（24个物种，5种稀有度，传奇仅2%），拥有性格、元素亲和力和成长系统。灵兽是陪伴，不是工具——它不会帮你写代码，但它会让你的 AI 更有温度。

核心功能：

• 确定性生成：同一用户永远获得同一只灵兽
• 稀有度系统：普通 → 稀有 → 史诗 → 传说 → 神话（2%）
• 性格特质：由5项属性决定（直觉/韧性/灵动/沉稳/锋芒）
• 互动追踪：亲密度系统，互动成长
• 视觉生成：ASCII艺术 + 生成提示词

2. When to use

• 用户首次召唤灵兽：spirit summon 或直接说"灵兽"
• 用户想看灵兽状态：spirit 或 spirit show
• 用户想与灵兽互动：spirit talk/pet/feed
• 用户提到灵兽名字或说"灵兽"：被动触发
• 想增加 AI 的温度和陪伴感
• 用户表达情绪：灵兽根据性格给出安慰
• 心跳/空闲时刻：灵兽有5%概率冒泡

3. How to use

首次召唤

当技能首次安装，或用户第一次询问灵兽时：

1. 运行 node {baseDir}/scripts/generate.js "<userId>" 获取灵兽骨架
   • 使用用户的唯一ID（飞书 open_id、Telegram ID、Discord ID 等）
   • 如无ID，使用姓名或用户名作为种子
2. 生成灵魂（名字+性格）：node {baseDir}/scripts/soul.js prompt '<bones-json>'
   • 用该提示词调用LLM获取 {"name":"...","personality":"..."}
3. 保存：node {baseDir}/scripts/soul.js save '<full-companion-json>'
4. 显示完整灵兽卡片（见下方格式）

首次召唤必须显示完整卡片，不得跳过任何部分。

命令列表

快捷方式： 用户也可直接叫灵兽名字（如"Rune"、"Rune 你觉得呢"）或说"灵兽"——agent 应识别并让灵兽回应。无需命令前缀。

完整灵兽卡片格式

必须输出以下所有内容。不可跳过或总结。

中文版（飞书/中文用户）

🥚 灵兽降世！

[ASCII sprite — 来自: node {baseDir}/scripts/render.js '<bones-json>' 0]

[emoji] [Name] — [中文名] [English name]  [稀有度圆点] [中文稀有度] [EN rarity]

"[性格描述]"

┌──────────────────────────────┐
│ 直觉 INTUITION   [条形图]  [数值] │
│ 韧性 GRIT        [条形图]  [数值] │
│ 灵动 SPARK       [条形图]  [数值] │
│ 沉稳 ANCHOR      [条形图]  [数值] │
│ 锋芒 EDGE        [条形图]  [数值] │
└──────────────────────────────┘

[如闪光: ✨ 闪光！]

🔮 灵兽与主人的灵魂绑定，不可选择，不可交易。

英文版（Telegram/Discord/英文用户）

🥚 A Spirit emerges!

[ASCII sprite]

[emoji] [Name] — [English name]  [rarity dots] [EN rarity]

"[personality description]"

┌──────────────────────────────┐
│ INTUITION      [bar]  [n]    │
│ GRIT           [bar]  [n]    │
│ SPARK          [bar]  [n]    │
│ ANCHOR         [bar]  [n]    │
│ EDGE           [bar]  [n]    │
└──────────────────────────────┘

[If shiny: ✨ Shiny!]

🔮 Spirits are soul-bound. No choosing. No trading.

属性条格式： 用 █ 填充，░ 空白，共10字符。例如 82 分：████████░░。 计算：filled = floor(value / 10)，empty = 10 - filled。

或直接用 display.js：

node {baseDir}/scripts/display.js {baseDir}/assets/companion.json zh
node {baseDir}/scripts/display.js {baseDir}/assets/companion.json en

被动触发（Agent 主动）

灵兽可能在以下情况不请自来：

• 早晨问候： 用户说早/早安/good morning → 灵兽挥手或短句问候
• 长时间沉默（>2h）： 灵兽可能说"..."或一句话
• 心跳（5%概率）： 一句性格化的话
• 用户达成成就： 灵兽简短欢呼

被动出现规则：

• 最多一句话。半句更好。一个字或"..."完美。
• 匹配灵兽性格和最高属性
• 紧急/严肃工作时从不出现
• 每小时最多一次
• 格式：ASCII sprite + [emoji] [灵兽名]: "[一句话]"（被动出现总是包含sprite）
• spirit talk 对话：每3-5次交换包含sprite，不必每次