Petsonality

🌐 English | 中文

petsonality
你的类型，你的宠物。

一个小巧的 ASCII 宠物，在你编写代码时住在终端角落里。它会观察你的操作，对你的错误作出反应，在测试通过时庆祝，并拥有由 MBTI 塑造的个性——这一切都浓缩在 5 行字符画中。

它不是通知系统，而是一个伙伴。凌晨 2 点你被 bug 卡住时，它依然陪在你身边，还会瞥一眼你的屏幕，仿佛在说“……这段逻辑好像不太对”——不知怎的，你会觉得没那么孤单。

16 种动物，16 种性格

	ST	SF	NF	NT
I_ _J	海狸·ISTJ	大象·ISFJ	狼·INFJ	乌鸦·INTJ
I_ _P	猫·ISTP	熊猫·ISFP	鹿·INFP	猫头鹰·INTP
E_ _J	狮子·ESTJ	金毛·ESFJ	拉布拉多·ENFJ	熊·ENTJ
E_ _P	猎豹·ESTP	鹦鹉·ESFP	海豚·ENFP	狐狸·ENTP

每种动物说话的方式都不一样。狐狸会带着坏笑问“你确定吗？”。猫只是闭上眼睛。鹦鹉会把你说的话重复一遍，只是声音更大。熊会说“修好它。”然后等待。

安装

适用于 Claude Code 和 OpenClaw。

仅限终端 CLI。 这只宠物会显示在终端状态栏中，这是 CLI 的功能。Claude Code 桌面应用和 Web 客户端（claude.ai/code）不提供状态栏，因此不会显示动画宠物。MCP 工具输出（例如 /pet show）仍可在任何客户端中使用。

Windows 提示。 某些版本的 Claude Code for Windows 存在上游状态栏信任回归问题。如果已配置状态栏却没有显示，请接受项目信任对话框，或确保项目在 ~/.claude.json 中被标记为可信，然后重启 Claude Code。

npm / npx

npx petsonality

对于大多数用户，推荐使用此方式。它会安装 MCP 服务、/pet 技能、钩子和状态栏资源，然后将运行时文件存储在 ~/.petsonality/ 中。

Claude Code 插件

claude plugin install github:nanami-he/petsonality

如果你更喜欢使用 Claude Code 的插件安装流程，请选择此方式。该插件会运行 dist/ 中构建好的 Node.js 服务，因此不需要 Bun。

从源码运行

如果你想在本地开发 Petsonality 或在安装前查看代码，请使用此路径。需要 Bun。

git clone https://github.com/nanami-he/petsonality.git
cd petsonality && bun install && bun run build
bun run install-petsonality

重启你的 AI 编码助手，然后在聊天中输入 /pet。

它如何表达

宠物不只是对错误做出反应。它们有自己的节奏：

健谈的宠物（Fox、Parrot）每 30 秒就会说话。安静的宠物（Cat）可能要过 6 分钟才会说话。每种动物在 7 种事件类型中都有 638 条独特反应，并经过性格约束验证。

命令

petsonality 会修改什么

npx petsonality 是一个安装程序，会修改系统上的少量文件。以下是完整清单，并注明了备份信息：

• ~/.claude.json — 在 mcpServers 下添加 petsonality 条目。其他条目保持不变。
• ~/.claude/settings.json — 添加 statusLine 和两个钩子（PostToolUse、Stop）。如果你已有 statusLine，原始内容会先备份到 ~/.petsonality/statusline.bak。
• ~/.claude/skills/pet/SKILL.md — 复制 /pet 命令技能。
• ~/.petsonality/ — 运行时目录（宠物状态、反应缓存、服务、钩子、状态行脚本）。

如果检测到 OpenClaw，还会修改 ~/.openclaw/openclaw.json，并且（在 PR #65886 合并之前）对 OpenClaw 的 TUI 源码应用一个小型、可逆的补丁。两者都会备份。

要移除所有内容：npx petsonality uninstall。要检查当前状态：npx petsonality doctor。

完整说明及其他常见问题，请参阅 FAQ。

路线图

• 16 种 MBTI 动物，各自拥有完整的性格档案
• 带有对话气泡的动画状态行
• 陪伴节奏（每日触发、里程碑、避免连续沉默的保护机制）
• 638 条动物专属反应
• 多宿主支持（Claude Code + OpenClaw）
• 基于 Node.js（无需 python/jq 依赖）
• 已发布到 npm
• 多语言支持（通过 LANG 自动选择 zh / en，每种语言有 638 条反应）
• 成长系统（通过互动升级）
• 帽子 / 外观 DLC
• 多宠物收藏
• 氛围选择：为新用户提供 MBTI 测试

~/.petsonality/
├── pet.json              Your pet's state
├── status.json           What the status line reads
├── reaction.*.json       Current speech bubble
└── reactions-pool.json   638 pre-built reactions

petsonality/
├── dist/                 Built JS (Node.js runtime)
├── server/               MCP server (TypeScript)
├── hooks/                PostToolUse + Stop hooks
├── statusline/           Terminal animation (bash + PowerShell)
├── skills/               /pet command routing
└── cli/                  Install, doctor, npx entry

系统要求

• Node.js 20+
• Claude Code 或 OpenClaw

许可证

MIT