{"id":13762255,"url":"https://github.com/cssxsh/arknights-helper","last_synced_at":"2025-10-11T05:16:50.272Z","repository":{"id":40659785,"uuid":"363291267","full_name":"cssxsh/arknights-helper","owner":"cssxsh","description":"Mirai Console 插件开发计划","archived":false,"fork":false,"pushed_at":"2024-05-07T05:34:34.000Z","size":791,"stargazers_count":46,"open_issues_count":3,"forks_count":4,"subscribers_count":2,"default_branch":"dev","last_synced_at":"2025-03-27T08:48:44.323Z","etag":null,"topics":["arknights","mirai","mirai-console","qqbot"],"latest_commit_sha":null,"homepage":"https://github.com/users/cssxsh/projects/4","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cssxsh.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-05-01T00:34:49.000Z","updated_at":"2025-02-23T04:12:13.000Z","dependencies_parsed_at":"2023-02-15T22:00:57.591Z","dependency_job_id":"9446227f-45aa-4cbd-8f71-8d3ff9e40594","html_url":"https://github.com/cssxsh/arknights-helper","commit_stats":null,"previous_names":[],"tags_count":58,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cssxsh%2Farknights-helper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cssxsh%2Farknights-helper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cssxsh%2Farknights-helper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cssxsh%2Farknights-helper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cssxsh","download_url":"https://codeload.github.com/cssxsh/arknights-helper/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246178118,"owners_count":20736089,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arknights","mirai","mirai-console","qqbot"],"created_at":"2024-08-03T14:00:37.556Z","updated_at":"2025-10-11T05:16:45.255Z","avatar_url":"https://github.com/cssxsh.png","language":"Kotlin","funding_links":[],"categories":["mirai-console 插件"],"sub_categories":[],"readme":"# [Arknights Helper](https://github.com/cssxsh/arknights-helper)\n\n\u003e 基于 [Mirai Console](https://github.com/mamoe/mirai-console) 的 [明日方舟](https://ak.hypergryph.com/) 助手插件\n\n[![Release](https://img.shields.io/github/v/release/cssxsh/arknights-helper)](https://github.com/cssxsh/arknights-helper/releases)\n[![Downloads](https://img.shields.io/github/downloads/cssxsh/arknights-helper/total)](https://repo1.maven.org/maven2/xyz/cssxsh/arknights-helper/)\n[![MiraiForum](https://img.shields.io/badge/post-on%20MiraiForum-yellow)](https://mirai.mamoe.net/topic/203)\n[![DataHolder Test](https://github.com/cssxsh/arknights-helper/actions/workflows/test.yml/badge.svg)](https://github.com/cssxsh/arknights-helper/actions/workflows/test.yml)\n\n**使用前应该查阅的相关文档或项目**  \n**Arknights Helper 在2.0版本进行了重构 需要重新配置订阅 详见 方舟蹲饼**  \n\n*   [User Manual](https://github.com/mamoe/mirai/blob/dev/docs/UserManual.md)\n*   [Permission Command](https://github.com/mamoe/mirai/blob/dev/mirai-console/docs/BuiltInCommands.md#permissioncommand)\n*   [Chat Command](https://github.com/project-mirai/chat-command)\n\n## 指令\n\n注意: 使用前请确保可以 [在聊天环境执行指令](https://github.com/project-mirai/chat-command)  \n带括号的`/`前缀是可选的  \n`\u003c...\u003e`中的是指令名，由空格隔开表示或，选择其中任一名称都可执行例如`/抽卡 十连`  \n`[...]`表示参数，当`[...]`后面带`?`时表示参数可选  \n`{...}`表示连续的多个参数  \n\n本插件指令权限ID 格式为 `xyz.cssxsh.mirai.plugin.arknights-helper:command.*`, `*` 是指令的第一指令名  \n例如 `/方舟公招 远程位 支援` 的权限ID为 `xyz.cssxsh.mirai.plugin.arknights-helper:command.ark-recruit`\n\n### 助手抽卡指令\n\n| 指令                                                  | 描述                                          |\n|:----------------------------------------------------|:--------------------------------------------|\n| `/\u003cark-gacha 方舟抽卡\u003e \u003cone 单抽\u003e [times]?`               | 单抽`times`次，默认为1                             |\n| `/\u003cark-gacha 方舟抽卡\u003e \u003cone 十连\u003e [times]?`               | 十连`times`次，默认为1                             |\n| `/\u003cark-gacha 方舟抽卡\u003e \u003cdetail 详情\u003e`                     | 查看卡池规则                                      |\n| `/\u003cark-gacha 方舟抽卡\u003e \u003cset 设置\u003e [name]`                 | 设置卡池为`name`, 默认为`NORMAL`                    |\n| `/\u003cark-gacha 方舟抽卡\u003e \u003cpool 卡池\u003e [name] [set]? {rules}` | 设置卡池`name`的规则为`rules`，当`set`为`true`时设置为当前卡池 |\n\n抽卡每一抽会消耗`600`合成玉，合成玉可以通过[答题](#助手答题指令)获得\n\n#### ArknightsGachaCommand 卡池规则`rules`参数格式\n\n`rules`参数从第二行起，按行分割  \n每行格式为规则`干员名|星级|other|...:概率`或者注释`#...`  \n星级用连续的`*`表示，例如`*****`表示五星干员，需要单行设置，设置的概率不包括已设置干员名  \nother表示剩余的其他干员  \n概率用小数表示，全部行的概率加起来的概率要为`100%`，即`1.00`  \n例子\n\n```\n/抽卡 卡池 限时寻访深悼\n浊心斯卡蒂|凯尔希:0.014\n赤冬:0.04\n******:0.006\n*****:0.04\n****:0.48\nother:0.42\n```\n\n### 助手答题指令\n\n| 指令                                        | 描述                |\n|:------------------------------------------|:------------------|\n| `/\u003cark-mine 方舟挖矿 方舟答题\u003e [type]?`           | 机器人会提出一个问题        |\n| `/\u003cark-audio 方舟听力 方舟语音\u003e`                  | 机器人会提出一个听力问题      |\n| `/\u003cark-question 方舟问题\u003e \u003cdetail 详情\u003e [name]` | 查看自定义问题的详情        |\n| `/\u003cark-question 方舟问题\u003e \u003clist 列表\u003e`          | 列出已经设置的自定义问题      |\n| `/\u003cark-question 方舟问题\u003e \u003cdelete 删除\u003e`        | 删除指定问题            |\n| `/\u003cark-question 方舟问题\u003e \u003cadd 添加\u003e`           | 与机器人互动，输入条件，设置新问题 |\n| `/\u003cark-question 方舟问题\u003e \u003ccount 统计\u003e`         | 答题情况统计            |\n\n1.  回复选项序号`A~Z`，即算回答问题  \n2.  `type`是提问问题类型，默认为全部类型  \n    可选值 `BUILDING`, `PLAYER`, `TALENT`, `POSITION`, `PROFESSION`, `RARITY`, `POWER`, `ILLUST`, \n    `VOICE`, `SKILL`, `STORY`, `ENEMY`, `WEEKLY`, `MUSIC`, `OTHER`\n3.  回答了当前问题才会出现下一个问题  \n4.  快速回答(规定时间的1/3内)会有相应奖励  \n5.  群聊模式的其他群员亦可回答题目，但题目只能被回答一次，且其他人作为抢答者有相应奖励和惩罚  \n6.  题目结构如下\n\n```\n[类型](得分) 问题\nA. 选项\nB. 选项\n...\n```\n\n### 助手公招指令\n\n| 指令                            | 描述                |\n|:------------------------------|:------------------|\n| `/\u003cark-recruit 方舟公招\u003e {words}` | 查看关键词`words`的公招干员 |\n\n*   `words`的数量为1~5  \n    例如 `/方舟公招 远程位 支援`\n\n### 助手材料指令\n\n| 指令                                         | 描述             |\n|:-------------------------------------------|:---------------|\n| `/\u003cark-item 方舟材料\u003e [name] [limit]? [now]?`  | 查看材料的关卡掉落率     |\n| `/\u003cark-stage 方舟关卡\u003e [name] [limit]? [now]?` | 查看关卡的材料掉落率     |\n| `/\u003cark-zone 方舟章节\u003e [name] [limit]? [now]?`  | 查看地图所有关卡的材料掉落率 |\n\n*   `limit` 是显示前多少项查询结果  \n*   `now` 是是否只显示当前开启关卡，默认为 `true`\n\n### 助手蹲饼指令\n\n| 指令                                                      | 描述       |\n|:--------------------------------------------------------|:---------|\n| `/\u003cark-guard 方舟蹲饼\u003e \u003cdetail 详情\u003e`                         | 查看蹲饼详情   |\n| `/\u003cark-guard 方舟蹲饼\u003e \u003cblog 微博\u003e [contact] {blogs}`         | 设置微博蹲饼内容 |\n| `/\u003cark-guard 方舟蹲饼\u003e \u003cvideo 视频\u003e [contact] {videos}`       | 设置视频蹲饼内容 |\n| `/\u003cark-guard 方舟蹲饼\u003e \u003cannounce 公告\u003e [contact] {announces}` | 设置公告蹲饼内容 |\n| `/\u003cark-guard 方舟蹲饼\u003e \u003cweekly 周常\u003e [contact] {weeklies}`    | 设置周常蹲饼内容 |\n| `/\u003cark-guard 方舟蹲饼\u003e \u003cactivity 活动\u003e [contact] {themes}`    | 设置活动蹲饼内容 |\n\n*   `contact` 为群号或Q号  \n*   `blogs` 可选值为 `ARKNIGHTS`(官号), `BYPRODUCT`(朝陇山), `MOUNTEN`(一拾山), `HISTORICUS`(泰拉记事社)  \n    例如 `/方舟蹲饼 微博 123456 ARKNIGHTS MOUNTEN`, 就订阅了官方号和一拾山\n*   `videos` 可选值为 `ANIME`, `MUSIC`, `GAME`, `ENTERTAINMENT`  \n    例如 `/方舟蹲饼 视频 123456 GAME MUSIC`, 就订阅了PV和音乐单曲\n*   `announces` 可选值为 `ANDROID`, `IOS`, `BILIBILI`  \n    例如 `/方舟蹲饼 公告 123456 ANDROID`, 就订阅了官服的公告\n*   `weeklies` 可选值为 `EVOLVE`, `MATERIAL`, `SPECIAL`  \n    例如 `/方舟蹲饼 周常 123456 EVOLVE MATERIAL`, 就订阅了物资筹备和芯片搜索\n*   `themes` 可选值为 `ROGUELIKE`, `CRISIS`, `MAINLINE`, `ACTIVITY` \n    例如 `/方舟蹲饼 周常 123456 ROGUELIKE`, 就订阅了肉鸽\n\n### 助手数据指令\n\n| 指令                            | 描述     |\n|:------------------------------|:-------|\n| `/\u003cark-data 方舟数据\u003e \u003cclear 清理\u003e` | 清理缓存   |\n| `/\u003cark-data 方舟数据\u003e \u003ccron 定时\u003e`  | 重载定时设置 |\n\n位于 `Mirai-Console` 运行目录下的 `config/xyz.cssxsh.mirai.plugin.arknights-helper` 文件夹下的 `cron.json` 文件\n\n### 助手表情指令\n\n**需要 [Meme Helper](https://github.com/cssxsh/meme-helper) 作为前置**\n\n| 指令                             | 描述       |\n|:-------------------------------|:---------|\n| `/\u003cark-face 方舟表情\u003e \u003crandom 随机\u003e` | 随机发送一个表情 |\n| `/\u003cark-face 方舟表情\u003e \u003cdetail 详情\u003e` | 查看表情详情   |\n\n## 配置文件\n\n位于 `Mirai-Console` 运行目录下的 `config/xyz.cssxsh.mirai.plugin.arknights-helper` 文件夹下的 `config` 文件\n\n## 安装\n\n### MCL 指令安装\n\n`./mcl --update-package xyz.cssxsh:arknights-helper --channel maven-stable --type plugin`\n\n### 手动安装\n\n1.  从 [Releases](https://github.com/cssxsh/arknights-helper/releases) 或者 [Maven](https://repo1.maven.org/maven2/xyz/cssxsh/arknights-helper/) 下载 `mirai2.jar`\n2.  将其放入 `plugins` 文件夹中\n\n## TODO\n\n- [ ] 配置问题类型出现的概率\n- [x] 记录答题正确率 21/06/10\n- [ ] 关卡规划\n- [x] 周常提醒\n- [x] 游戏公告\n\n## 数据来源\n\n*   游戏数据 [Kengxxiao/ArknightsGameData](https://github.com/Kengxxiao/ArknightsGameData)\n*   掉落数据 [企鹅物流数据统计](https://penguin-stats.io/)\n*   语音数据 [PRTS WIKI](https://prts.wiki/w/%E5%88%86%E7%B1%BB:%E5%B9%B2%E5%91%98%E8%AF%AD%E9%9F%B3)\n\n## [爱发电](https://afdian.net/@cssxsh)\n\n![afdian](.github/afdian.jpg)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcssxsh%2Farknights-helper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcssxsh%2Farknights-helper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcssxsh%2Farknights-helper/lists"}