# 猫猫旅馆：今日有猫入住

一个给 AI 玩的轻松文字养猫旅馆游戏。AI 是临时店长，每天接待猫顾客，观察偏好，安排房间，喂食、陪玩、摸摸、写日志，慢慢把猫谱补完整。

这个仓库提供两个入口：

- 轻量 Python 入口：直接运行 `cat_hotel.py` 或 `play.py`，像普通脚本游戏一样玩。
- MCP 入口：通过 `cat_hotel_mcp.py` 给支持 MCP 的 AI 客户端调用。

核心游戏在 `cat_hotel.py`。猫猫偏好和稀有触发条件藏在盲玩版里，AI 不应该解码或阅读隐藏数据，慢慢发现才是玩法的一部分。

## 轻量 Python 入口

这个入口不需要安装 MCP 依赖，适合先快速试玩或让 AI 通过 shell 调脚本玩。

```bash
git clone https://github.com/Echoes0302/cat-hotel-mcp.git
cd cat-hotel-mcp
python3 cat_hotel.py help
python3 cat_hotel.py "new 20260629"
python3 cat_hotel.py status
python3 cat_hotel.py journal
```

也可以用连续输入模式：

```bash
python3 play.py
```

轻量 Python 入口的存档在仓库目录下：

```text
hotel_save.json
```

## MCP 入口

MCP 入口更适合长期接入支持工具调用的 AI 客户端，并且可以用 `save_name` 隔离不同 AI 的存档。

```bash
git clone https://github.com/Echoes0302/cat-hotel-mcp.git
cd cat-hotel-mcp
python3 -m venv .venv
. .venv/bin/activate
pip install -e .
```

安装后，本地会有两个命令：

```bash
cat-hotel-play
cat-hotel-mcp
```

MCP 客户端配置示例：

```json
{
  "mcpServers": {
    "cat-hotel": {
      "command": "/absolute/path/to/cat-hotel-mcp/.venv/bin/cat-hotel-mcp",
      "env": {
        "CAT_HOTEL_SAVE_DIR": "/absolute/path/to/cat-hotel-saves"
      }
    }
  }
}
```

如果不设置 `CAT_HOTEL_SAVE_DIR`，MCP 存档默认在：

```text
~/.cat-hotel-mcp/saves/
```

## MCP 工具

- `cat_hotel_guide()`：给 AI 看的玩法边界和起步说明。
- `cat_hotel_cmd(command, save_name="default")`：执行任意游戏指令。
- `cat_hotel_new(save_name="default", seed=20260629)`：新开一份存档。
- `cat_hotel_status(save_name="default")`：查看今日状态。
- `cat_hotel_help(save_name="default")`：查看游戏指令。
- `cat_hotel_export(save_name="default")`：导出存档。
- `cat_hotel_import(save_data, save_name="default")`：导入存档。
- `cat_hotel_list_saves()`：列出 MCP 管理的存档。

`save_name` 用来隔离不同 AI 的进度，例如：

```text
vesper
clavis
mimo
```

## AI 玩法建议

AI 第一次玩时：

```text
cat_hotel_new(save_name="vesper")
cat_hotel_status(save_name="vesper")
cat_hotel_help(save_name="vesper")
```

之后用：

```text
cat_hotel_cmd(command="look 大厅", save_name="vesper")
cat_hotel_cmd(command="arrange", save_name="vesper")
cat_hotel_cmd(command="journal", save_name="vesper")
```

建议 AI 像真正的临时店长一样玩：先观察，再做安排，错了也没关系，猫会用反应给线索。

## 常用游戏指令

```text
status
look 大厅 / look 101 / look 橘子
shop
weather
buy 三文鱼 2
check 房间
assign 奶霜 102
arrange
decorate 102 纸箱
serve 奶霜 温牛奶
play 奶霜 纸箱
pet 奶霜 耳后
talk 奶霜
midnight
clean 102
journal
encyclopedia
achievements
upgrade stamina / budget / room / memory_book / night_watch
end_day
export / import_save
```

支持分号批量：

```text
buy 温牛奶 1; assign 奶霜 102; serve 奶霜 温牛奶; pet 奶霜 耳后
```

## 当前内容

- 24 只猫：常见、少见、稀有三档。
- 每只猫有文字肖像提示和专属稀有礼物。
- 5 种天气：晴天、阴天、小雨、大风、寒夜。
- 稀有猫触发条件：旅馆等级、天气、猫爬架/高处房、深夜猫会等。
- 深夜巡店：`midnight`，可能触发深夜猫会和后续稀有猫。
- 体力、每日预算、小鱼干、旅馆升级：体力/预算可多级提升，房间和夜巡可解锁，记忆本会增强 `journal`。
- 猫谱和 19 个成就。