Kotone's Auto Assistant 琴音小助手

功能

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

^{1 2} 见后文的注意事项

安装

模拟器要求

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

普通用户

TODO

技术用户

琴音小助手通过 pip 分发，因此你可以执行下面的命令来安装：

pip install ksaa

琴音小助手的缩写是“kaa”（Kotone's Auto Assist）， 但是“kaa”已经被其他包占用了， 因此改用“ksaa”（Kotone's Auto Assist）。

不过为了避免依赖冲突，你最好使用 pipx 来安装：

# 安装 pipx
scoop install pipx
pipx ensurepath
# 安装 kaa
pipx install ksaa

（也可以通过 pip 安装 pipx，详见 pipx 文档）

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

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

kaa

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

使用

配置

TODO

注意事项

Note

建议使用 REGULAR 模式， 因为 PRO 模式还没有经过充分测试。

Important

尽管名字叫“琴音小助手”，但是强烈建议你 不要在自动培育中使用琴音。

因为琴音的黄色服饰会严重干扰推荐卡的检测， 导致打出错误的技能卡。

Important

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

开发

见DEVELOPMENT.md

路线图

下面是待实现的功能：

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