Go to file
XcantloadX e2b1e8802a feat(core): 实现了 wxpusher 消息推送 2025-02-15 11:01:51 +08:00
.vscode docs: 修改 README 2025-02-13 20:53:23 +08:00
bootstrap chore: 完成启动脚本 2025-01-24 19:14:32 +08:00
docs docs: 修改 README 2025-02-13 20:53:23 +08:00
experiments feat(task): 支持了培育中交流事件的处理 2025-02-12 16:27:21 +08:00
kotonebot feat(core): 实现了 wxpusher 消息推送 2025-02-15 11:01:51 +08:00
kotonebot-devtool feat(devtool): 脚本录制器中允许停止执行脚本 2025-02-05 15:35:35 +08:00
res feat(task): 培育支持处理 AP 不足的情况 2025-02-13 20:47:36 +08:00
screenshots feat(task): 支持了培育中交流事件的处理 2025-02-12 16:27:21 +08:00
tests fix(core): 修复 OCR 识别时若传入了 rect/hint 参数,最终结果坐标不正确的问题 2025-02-11 14:23:27 +08:00
tools chore: R.py 文件生成中加入 Image 标题 & 优化注释图片显示 2025-02-13 21:21:33 +08:00
.gitignore feat(core): 实现了 wxpusher 消息推送 2025-02-15 11:01:51 +08:00
MANIFEST.in chore: R.py 构建工具支持新图片类型 2025-02-04 14:11:03 +08:00
README.md chore: pyproject.toml 使用动态版本号 2025-02-15 09:58:32 +08:00
justfile chore: 完成启动脚本 2025-01-24 19:14:32 +08:00
requirements.dev.txt feat(core): 新增 uiautomator2 控制与截图方法 2025-02-12 10:50:24 +08:00
requirements.txt feat(core): 新增 uiautomator2 控制与截图方法 2025-02-12 10:50:24 +08:00
template.env feat(core): 实现了 wxpusher 消息推送 2025-02-15 11:01:51 +08:00

README.md

Kotone's Auto Assistant 琴音小助手

功能

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

1 2 见后文的注意事项

安装

模拟器要求

  • 分辨率:必须是 1280x720
  • 系统版本Android 10+QAPI 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