Aemeath Claude Code Pet

Q 版像素爱弥斯桌宠，通过 HTTP hooks 与 MCP 与 Claude Code 实时联动。基于 MIT 像素小人素材制作，参考《鸣潮》爱弥斯官方视觉设定。

这是粉丝制作的桌宠项目，不是库洛游戏或《鸣潮》的官方项目。

功能

• 15 种像素动画状态，随 Claude Code 操作实时切换
• 气泡消息精准反馈 Claude 当前行为，工具间保持最小停留时间不闪烁
• 空闲时随机展示动画（跳跃 / 招手 / 待机变体）
• 透明无边框桌面悬浮窗，始终置顶，可拖拽，不占任务栏
• 系统托盘驻留，左键切换显隐，右键菜单
• 随 Claude Code 自动启动，不重复创建实例
• 双向交互：通过 MCP 工具让 Claude 向用户发起输入请求（文本/确认/下拉选择）
• 消息同步：右键精灵 → 发消息，内容自动粘贴到 Claude Code 对话中
• 右键快捷菜单：发消息 / 休眠 / 关机

联动效果

MCP 工具

通过 MCP 协议，Claude 可以：

示例：让 Claude 向用户请求确认

用户: 删除这个文件
Claude: 调用 aemeath_get_user_input(type="confirm", prompt="确定要删除吗？")
宠物: 显示是/否按钮
用户: 点击"是"
Claude: 执行删除操作

详细 API 文档见 docs/API.md

架构

Claude Code
  ├── HTTP hooks → POST :9527/api/hook/*
  └── MCP Client → :9528/mcp

Aemeath Pet (Tauri Desktop App)
  ├── HTTP Server (:9527)   → 接收 hook 推送 + 前端轮询
  ├── MCP Server (:9528)    → 富交互（tools / resources）
  ├── State Manager (Rust)  → 状态机 + 气泡锁
  └── WebView Frontend      → CSS sprite 动画 + 气泡 + 输入 UI

安装

1. 启动桌宠

从 Releases 下载 aemeath-claude.exe，或自己构建：

npm install
cargo build --manifest-path src-tauri/Cargo.toml --release

产出在 src-tauri/target/release/ 。

2. 配置 Claude Code

将 docs/hooks.json 合并到 ~/.claude/settings.json，将 docs/mcp.json 写入 ~/.claude/.mcp.json，然后重启 Claude Code。注意替换 hooks.json 中 SessionStart 里 aemeath-claude.exe 的实际路径。

端口

构建

前置要求

• Rust stable toolchain（需 windows-gnu + MinGW-w64）
• Node.js >= 18
• Windows 10+

命令

npm install
cargo build --manifest-path src-tauri/Cargo.toml --release

目录结构

aemeath-claude/
├── src-tauri/        # Rust 后端 (Tauri + axum)
├── src/              # WebView 前端 (HTML/CSS/JS)
├── docs/             # hooks 与 MCP 配置模板 + API 文档
├── CLAUDE.md         # 项目指南
├── LICENSE
└── package.json

详细文件说明见 CLAUDE.md。

来源与授权

• 像素小人素材来源：lzy-buaa-jdi/ameath，MIT License
• 爱弥斯、《鸣潮》及相关官方视觉设定归其权利方所有
• 本仓库仅包含整理后的桌宠代码、精灵图集，不含官方立绘原图