Metadata-Version: 2.2
Name: ksaa
Version: 2025.3.9.4
Summary: Kotones Auto Assistant(kaa) is a script for game 'Gakuen Idol M@ster' that automates the dailies and produces.
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: opencv-python==4.10.0.84
Requires-Dist: rapidocr_onnxruntime==1.4.3
Requires-Dist: av==14.0.1
Requires-Dist: scikit-image==0.25.0
Requires-Dist: thefuzz==0.22.1
Requires-Dist: adbutils==2.8.0
Requires-Dist: uiautomator2==3.2.8
Requires-Dist: fastapi==0.115.6
Requires-Dist: uvicorn==0.34.0
Requires-Dist: python-multipart==0.0.20
Requires-Dist: websockets==14.1
Requires-Dist: psutil==6.1.1
Requires-Dist: gradio==5.12.0
Requires-Dist: pydantic==2.10.4
Requires-Dist: ksaa-res==0.1.0
Requires-Dist: typing-extensions==4.12.2
Requires-Dist: python-dotenv==1.0.1
Requires-Dist: onnxruntime==1.14.0
Requires-Dist: numpy<2.0

# Kotone's Auto Assistant 琴音小助手
## 功能
* 自动日常，包括
    * 领取礼物（邮件）
    * 领取活动费
    * 领取工作奖励并自动重新安排工作
    * 竞赛挑战
    * 领取任务奖励
    * 清理商店
        * 包括 AP 商店和金币商店
        * 可以购买推荐商品，或者指定要购买的物品
* 低配版自动培育
    * 支持 REGULAR 和 PRO 模式<sup>1</sup>
    * 支持指定 P 偶像<sup>2</sup>
    * 支持指定使用增强道具（笔记数量和 Pt 数量提升）
    * 暂时**只能使用自动编成**回忆和支援卡
    * 对于非练习周，如果没有推荐休息，暂时只会按顺序执行活动支给（活動支給）、文化课（授業）、休息这三种，不支持外出（おでかけ）和咨询（相談）
    * 领取技能卡和 P 饮料时，固定领取第一个。若 P 饮料溢出，则不领取

<sup>1 2</sup> 见后文的注意事项

## 安装
### 模拟器要求
* 分辨率：必须是 1280x720
* 系统版本：Android 10+（Q，API 29），这是游戏的要求
* 已开启游戏加速器或代理且网络通畅

### 普通用户
TODO

### 技术用户
琴音小助手通过 pip 分发，因此你可以执行下面的命令来安装：
```bash
pip install ksaa
```

> 琴音小助手的缩写是“kaa”（**K**otone's **A**uto **A**ssist），
> 但是“kaa”已经被其他包占用了，
> 因此改用“ksaa”（**K**otone'**s** **A**uto **A**ssist）。

不过为了避免依赖冲突，你最好使用 pipx 来安装：
```bash
# 安装 pipx
scoop install pipx
pipx ensurepath
# 安装 kaa
pipx install ksaa
```
（也可以通过 pip 安装 pipx，详见 [pipx 文档](https://github.com/pypa/pipx#on-windows)）

如果你不想使用 pipx，也可以手动创建虚拟环境，并使用普通的 pip 安装。

安装完成后，只需要运行 `kaa` 命令即可启动 GUI 界面：
```bash
kaa
```

需要注意的是，配置文件 `config.json` 会自动在工作目录下生成。
因此你最好每次都在同一个地方运行 kaa，否则可能会出现找不到配置文件的情况。

## 使用
### 配置
TODO

### 注意事项
> [!NOTE]
> 建议使用 **REGULAR 模式**，
> 因为 PRO 模式还没有经过充分测试。

> [!IMPORTANT]
> 尽管名字叫“琴音小助手”，但是强烈建议你
> **不要在自动培育中使用琴音**。
>
> 因为琴音的黄色服饰会严重干扰推荐卡的检测，
> 导致打出错误的技能卡。

> [!IMPORTANT]
> 建议**使用亲密度至少为 7 的偶像**进行培育，
> 因为琴音小助手暂时无法处理亲密度提升事件。

## 开发
见[DEVELOPMENT.md](./docs/DEVELOPMENT.md)

## 路线图
下面是待实现的功能：
* 培育
    * 允许指定领取 P 饮料、P 物品、技能卡的领取选择优先级
    * 允许指定行动优先级
    * 自动使用 P 饮料
    * 支持非凡（アノマリーノート）属性偶像的自动培育
    * 支持琴音的自动培育
    * 允许优先选择活动加成高的偶像进行培育
    * 支持 MASTER 培育、NIA 培育
* 竞赛
    * 按分数差距优先选择
* 自动硬币扭蛋（コインガシャ）
* 模拟器启停
* 常驻运行与自动运行
