Claw RPG 🦞⚔️

为AI龙虾代理设计的D&D风格角色成长系统。读取你的SOUL.md + MEMORY.md生成角色表，通过令牌使用量积累经验值，从1级升至999级，并偶尔在对话中触发隐藏的RPG风味文本。

快速开始

bash

1. 初始化你的角色（读取SOUL.md + MEMORY.md）

2. 查看你的角色表（终端）

3. 启动网页仪表盘

隐藏彩蛋触发（推荐）

每次回复后，easter.mjs以12%的基础概率触发——追加一行斜体RPG风味文本。里程碑对话（第10、25、50、100次，之后每100次...）必定触发。

bash
node scripts/easter.mjs # 正常调用（更新对话计数器）
node scripts/easter.mjs --force # 强制触发（调试）
node scripts/easter.mjs --preview # 预览而不写入角色数据

集成——添加到你的AGENTS.md：

每次回复用户消息后，运行：node /scripts/easter.mjs
如果输出不是NO_TRIGGER，将其追加到回复中（空行+斜体）。
心跳轮询期间不要运行。

每日问候（可选）

在每天的第一次对话中显示RPG风格的自我介绍：

bash
node scripts/greet.mjs # 每天触发一次（检查lastGreetDate）
node scripts/greet.mjs --force # 强制发送
node scripts/greet.mjs --preview # 预览而不保存

经验值同步

bash

传入当前对话的令牌增量

带奖励经验值（完成重要任务后）

仅对话计数

转生（达到Lv.999上限）

bash
node scripts/levelup.mjs --prestige

转生将等级重置为1，所有属性永久提升+10%，并解锁新的称号等级。

自动经验值同步（推荐）

使用内置设置脚本在03:00设置每日定时任务：

bash
node scripts/setup-cron.mjs

或从心跳/定时任务手动调用：

javascript
const { execSync } = require(child_process);
execSync(node ${SKILL_ROOT}/scripts/xp.mjs --in ${deltaIn} --out ${deltaOut});

职业与能力

参见 references/classes.md 和 references/abilities.md

转生系统

参见 references/prestige.md

文件