Metadata-Version: 2.4
Name: ErisPulse-NekoCare
Version: 3.1.0
Summary: NekoCare 3.1 —— 喵喵小镇：猫猫养成 + 动态物价经济 + 股市 K 线，全 GIF 交互，四语界面 —— NekoCare 3.1: ASCII cat life sim with dynamic pricing economy, stocks, charts and 4-language UI, all-GIF interactions
Author: wsu2059q
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: ErisPulse>=2.9.0
Provides-Extra: test
Requires-Dist: pytest>=7.0; extra == "test"
Requires-Dist: pytest-asyncio>=0.21; extra == "test"
Requires-Dist: ErisPulse-Testing; extra == "test"
Dynamic: license-file

<div align="center">

<img src=".github/assets/ErisPulseLogo.png" width="180" alt="ErisPulse NekoCare" />

# ErisPulse NekoCare

**喵喵小镇 —— 猫猫养成 · 动态物价 · 股市 K 线，全 GIF 交互。**

基于 ErisPulse 的虚拟猫猫养成模块 3.0：领养一只专属猫猫，喂食互动、打工赚喵币、炒股票、去银行存贷， 全GIF渲染。

<p>
  <a href="https://pypi.org/project/ErisPulse-NekoCare/"><img src="https://img.shields.io/pypi/v/ErisPulse-NekoCare?style=for-the-badge&logo=pypi&logoColor=white" alt="PyPI"></a>
  <a href="https://pypi.org/project/ErisPulse-NekoCare/"><img src="https://img.shields.io/badge/Python-3.10+-FFD43B?style=for-the-badge&logo=python&logoColor=blue" alt="Python"></a>
  <a href="./LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue?style=for-the-badge" alt="License"></a>
  <a href="https://github.com/ErisPulse/ErisPulse-NekoCare"><img src="https://img.shields.io/github/stars/ErisPulse/ErisPulse-NekoCare?style=for-the-badge&logo=github&color=brightgreen" alt="Stars"></a>
  <a href="https://pepy.tech/project/ErisPulse-NekoCare"><img src="https://img.shields.io/pepy/dt/ErisPulse-NekoCare?style=for-the-badge&color=blue" alt="Downloads"></a>
  <a href="https://github.com/ErisPulse/ErisPulse"><img src="https://img.shields.io/badge/Powered_by-ErisPulse-FF6B9D?style=for-the-badge&logo=bookstack&logoColor=white" alt="ErisPulse"></a>
</p>

<p>
  <a href="./README.md">简体中文</a> | <a href="./README.en.md">English</a>
</p>

</div>

---

## 效果展示

| 主菜单 | 猫猫状态 | 股市行情 |
|:---:|:---:|:---:|
| ![](.github/assets/demo/menu.gif) | ![](.github/assets/demo/status.gif) | ![](.github/assets/demo/cat-stocks.gif) |

| 打工喵 | 银行喵 | 排行榜 | 今日物价 |
|:---:|:---:|:---:|:---:|
| ![](.github/assets/demo/cat-work.gif) | ![](.github/assets/demo/cat-bank.gif) | ![](.github/assets/demo/cat-rank.gif) | ![](.github/assets/demo/cat-prices.gif) |

结果动画（每种事件都有不同的动作）：签到、转账、打劫得手、扑空、被猫警抓、哭穷……

| 签到 | 转账 | 打劫扑空 |
|:---:|:---:|:---:|
| ![](.github/assets/demo/act-sign.gif) | ![](.github/assets/demo/act-transfer.gif) | ![](.github/assets/demo/act-pounce.gif) |

---

## 简介

NekoCare 3.0 是 NekoCare 2.x 的完全重写版：

- **猫猫形象**：5 个品种（白/橘/奶牛/黑/三花），表情与动作随心情和场景变化，全部渲染为 GIF
- **动态物价 CPI**：商品基准价 × 全服物价指数，大家越富东西越贵；随机事件（喵粮歉收、港口罢工、喵星文化节……）同时冲击物价与股市
- **股市**：8 只股票、5 分钟刷新、牛熊周期、事件驱动，支持 K 线图（需要 Takumi）
- **通胀治理**：累进所得税（0/5/10/15% 分档）+ 每日财产税（净资产超全服中位数 5 倍部分征 2%）+ 高净值边际收益递减
- **银行**：活期利率随牛熊市浮动、定期、贷款；转账带阶梯手续费与银行安全系统（24h 滚动窗口识别多账户异常流水并拦截）
- **打劫**：路上随机劫（NPC/路人/被反抢/遇猫警），或 `/猫猫 打劫 @某人` 预谋打劫
- **全部回应均为手绘涂鸦风循环 GIF**（奶白纸底 + 虚线边框 + 标记笔配色 + 硬偏移阴影），未安装 Takumi 时降级文本

> **2.x 老玩家**：首次启动自动迁移——旧喵币按对数压缩折算为新币（抑制通胀，保住排名逻辑），猫、学历、股票持仓全部平移；旧数据只读不删。

要求 ErisPulse >= 2.9.0。

---

## 安装

```bash
epsdk install ErisPulse-NekoCare
# 可选：安装 Takumi 后全部回应渲染为 GIF 动图
epsdk install ErisPulse-Takumi
```

---

## 效果展示（结果动画）

| 签到 | 转账 | 打劫得手 | 扑空 |
|:---:|:---:|:---:|:---:|
| ![](.github/assets/demo/act-sign.gif) | ![](.github/assets/demo/act-transfer.gif) | ![](.github/assets/demo/act-coins.gif) | ![](.github/assets/demo/act-pounce.gif) |

| 哭穷 | 被猫警抓 | 摸摸 | 吃饭 |
|:---:|:---:|:---:|:---:|
| ![](.github/assets/demo/act-weep.gif) | ![](.github/assets/demo/act-flinch.gif) | ![](.github/assets/demo/act-purr.gif) | ![](.github/assets/demo/act-eat.gif) |

| 学习成功 | 搜索 | 银行喵 | 睡觉 |
|:---:|:---:|:---:|:---:|
| ![](.github/assets/demo/act-hop.gif) | ![](.github/assets/demo/act-search.gif) | ![](.github/assets/demo/cat-bank.gif) | ![](.github/assets/demo/cat-sleep.gif) |

---

## 快捷命令

所有功能经 `/猫猫` 单入口进入交互菜单，常用操作也有快捷方式：

| 命令 | 说明 |
|------|------|
| `/猫猫` | 交互主菜单 |
| `/猫猫 帮助` | 查看全部快捷命令 |
| `/猫猫 签到` | 每日签到（连签奖励递增） |
| `/猫猫 早安` / `/猫猫 晚安` | 问候猫猫 |
| `/猫猫 状态` / `/猫猫 资产` / `/猫猫 排行` / `/猫猫 物价` | 查询类 |
| `/猫猫 银行` / `/猫猫 股市` / `/猫猫 商店` / `/猫猫 学习` / `/猫猫 打工` / `/猫猫 喂食` | 功能类 |
| `/猫猫 打劫` | 路上随机打劫（NPC / 路人 / 小混混 / 猫警……） |
| `/猫猫 打劫 @某人` | 预谋打劫该玩家（高风险高回报） |
| `/猫猫 转账 @某人 金额` | 银行转账（阶梯手续费 + 安全系统） |

菜单内按编号选择；输错或超时会**悄悄结束**，重新 `/猫猫` 即可。

---

## 玩法

- **养成**：饱食度随时间衰减，长期归零猫会离家出走（花钱寻回，不会死）
- **打工**：学历越高工作越赚；亲密度 ≥60 有 15% 加成；收入交累进所得税
- **学习**：升学解锁高薪工作，学费随 CPI 浮动
- **股票**：低买高卖赚差价（资本利得税）；买卖量本身会推动股价
- **银行**：牛市降息/熊市加息；定期 4%/日；贷款额度随学历
- **打劫**：声望越低越容易被猫警盯上

---

## 配置说明

```toml
[NekoCare]
migrate_tiers = "10000:1,1000000:0.1,100000000:0.01"  # 迁移阶梯
income_baseline = 200.0        # 人均日收入基准线（CPI 锚点）
cpi_smoothing = 0.3            # CPI 平滑系数
cpi_min = 0.5                  # CPI 下限
cpi_max = 4.0                  # CPI 上限
wealth_tax_threshold_mult = 5.0  # 财产税起征（中位数倍数）
wealth_tax_rate = 0.02         # 财产税税率
diminishing_floor = 0.3        # 高净值边际收益下限
stock_interval_secs = 300      # 股价刷新间隔
work_cooldown_secs = 1800      # 打工冷却
away_grace_hours = 48.0        # 归零后多久离家出走
reply_timeout = 60             # 菜单交互超时（静默退出）
gif_width = 0                  # GIF 画布宽度（0 = 按内容自适应）
render_card = true             # 全 GIF 回应
theme = "doodle"               # 卡片风格 (doodle/editorial)
```

---

## 注意事项

1. 旧版（2.x）数据在首次启动时自动迁移，`/猫猫` 任意操作前完成；旧 KV 只读不删
2. GIF 渲染需要 Takumi 模块；未安装时全部降级为文本
3. K 线图为静态 PNG，同样需要 Takumi
4. 物价、税率、迁移系数均可在配置中调整

---

## 参考链接

- [ErisPulse 主库](https://github.com/ErisPulse/ErisPulse/)
- [ErisPulse-Takumi](https://github.com/ErisPulse/ErisPulse-Takumi)
