fz-mirrors/MaaAssistantArknights
0
0
Fork 0
mirror of https://github.com/MaaAssistantArknights/MaaAssistantArknights.git synced 2026-07-18 10:10:45 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
2973ebbbdb79fc4958d7e75414b51057af8414bb
MaaAssistantArknights/docs/ja-jp
History
Lucien Shaw e461208bf9 chore: 完善容器配置及依赖安装 (#14208) 
格式化工具部分：
1. pre-commit 引入 python 的格式化工具，包括 black（代码格式化）和 isort（对“包导入顺序”的规范）
2. 允许 prettier 对文档站的 markdown 文件格式化
3. 不允许 prettier 对 markdown 文件中的代码块的代码本身进行格式化
4. 升级了 pre-commit 的各个 hook 的版本
5. 优化了 pre-commit 的日志文本显示

容器总览部分：
1. 由原来的单一轻量环境转为区分空环境、轻量环境和全量环境
2. 空环境是裸 Linux 镜像（Ubuntu），为默认环境
3. 轻量环境适合开发文档站前端
4. 全量环境适合开发 MaaCore
5. 目前，全量环境完整包含了轻量环境，轻量环境完整包含了空环境
6. 在仓库 README.md 中更新了三个环境的描述，并将链接分别设置为对应环境的创建链接
   **注意：没有修改文档站中的对应文件**
7. 在各个语言的开发指南的最后，移除了 Codespace 部分的“安装额外依赖”相关描述，且将链接设置为全量环境的创建链接
   **注意：没有添加“开发文档站”的指南和对应 codespace 的使用方式**

容器的轻量环境和全量环境共有部分：
1. 安装 black 和 isort 包
2. 调整 VS Code 设置，取消先前（对 markdown 文件单独指定 markdownlint 扩展作为格式化工具）的错误设置，现在 markdown 文件仍然使用默认的 prettier 扩展作为格式化工具
3. 引入 markdown-all-in-one 扩展作为语法提示工具
4. 将 node_modules 和 3rdparty 排除在 VS Code 的文本的搜索路径之外

容器的全量环境部分：
1. 为 tools 下的所有 python 脚本安装依赖
2. 使用 tools/maadeps-download.py 下载 maadeps，且将必要二进制文件软链接到 /usr/local/bin/
3. 使用 apt 安装 cmake 和 clangd-20，将后者通过 update-alternatives 设置为系统 clangd 的默认版本
4. 使用 cmake tools 扩展，并按照 Linux 编译方法进行配置
5. 使用 clang-format 作为 c/cpp 的格式化工具，clang-format 程序主体来自 maadeps（已经软链接到 /usr/local/bin/）
6. 使用 clangd 作为 c/cpp 的语法提示工具
7. 将 MaaDeps、install 和 build 排除在 VS Code 的文本搜索路径之外

其它手动调整：
1. 更新文档站的 package.json，指定 pnpm 包管理器的版本
2. 手动保证 markdown 文件中的列表前后有空行（注意到 MarkdownLint 官方规则不一定能精准定位所有“列表前后空行”的问题，详见：https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md032---lists-should-be-surrounded-by-blank-lines ）
3. 修改了部分 markdown 文件中的 json 代码块的语法问题
   **注意：相同的问题并未全部发现，仅修改了两处**
4. 在 tools 目录中，一处 python 脚本的包名误用（本地包名和某个 pip 包重名），这里修改了相应代码
5. 在 tools 目录中，一处 python 脚本使用了弃用的包 cchardet 的问题，这里更换了推荐使用的功能相近的包并修改了相应代码

自动化脚本提交的修改：
1. 自动格式化了大量 tools 中的 python 脚本
2. 自动格式化了大量 docs 中的 markdown 文件

Commits:

* chore: pre-commit引入black和isort规范py文件

* chore: Auto update by pre-commit hooks [skip changelog]

* chore: devcontainer添加isort扩展，排序python导入

* chore: pre-commit任务命名及更名

* style: isort fix

* chore: Auto update by pre-commit hooks [skip changelog]

* chore: 更新pre-commit的hook版本

* fix: 模块名与第三方库重名，大忌

* chore: 容器构建时额外安装isort

* docs: md -> markdown

* chore: 容器安装python包和maadeps

* fix: 修复过时python包

* chore: 指定pnpm版本

* chore: container支持选择轻量环境

* chore: 去掉rust

* chore: add plain env

* chore: 使用clangd语言服务器

* chore: 无需单独设置markdown的格式化工具

* chore: 更新安装的clangd版本

* docs: 简易文档适配

* docs: 在仓库README中重新编排codespaces相关指引

* chore: Auto update by pre-commit hooks [skip changelog]

* style: 调整缩进

* chore: 格式化工具不用特意排除被gitignore忽略的文件

* chore: sh文件在gitattributes中单列一类

* chore: 格式化docs下的markdown文件

* chore: 暂时不修改md文件中的代码块

* style: 人为明确markdown中的部分列表相关格式

* docs: 补上部分markdown的json代码块中缺失的逗号

* chore: Auto update by pre-commit hooks [skip changelog]

* chore: Auto update by pre-commit hooks [skip changelog]

* fix: 补上tools的服务器排序相关代码中缺失的逗号

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* chore: 使用maadeps的clangd

* build: 更新maadeps工具链版本

* style: prettier fix

* revert: 还原maadeps版本

* revert: 取消使用maadeps的clangd依赖，改用系统apt安装

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2025-09-30 19:39:48 +08:00
..
develop
chore: 完善容器配置及依赖安装 (#14208)
2025-09-30 19:39:48 +08:00
manual
chore: 完善容器配置及依赖安装 (#14208)
2025-09-30 19:39:48 +08:00
protocol
chore: 完善容器配置及依赖安装 (#14208)
2025-09-30 19:39:48 +08:00
readme.md
chore: 完善容器配置及依赖安装 (#14208)
2025-09-30 19:39:48 +08:00

readme.md

icon, index, dir
icon index dir
ic:round-home true
order
0

::: center

MAA Logo =256x256

MAA

C++
platform
license commit
stars GitHub all releases

MAAは、MAA Assistant Arknightsです。

アークナイツゲームアシスタント

画像認識技術に基づいて、ワンクリックですべてのデイリーリクエストを完了します！

絶賛開発中 ✿✿ヽ(°▽°)ノ✿

:::

ダウンロードとインストール

ドキュメント を読んでから、公式サイト または リリース にアクセスしてダウンロードしてください。新規ユーザーガイド を参考にインストールを行ってください。

機能一覧

  • 自動作戦、ドロップ認識および PenguinStats と Yituliu へデータアップロード。
  • 自動基地シフト、オペレーター効率計算、単一設備内に最適なソリューション；カスタムシフトにも対応しています。
  • 自動公開求人、緊急招集票を使う、使い切るのもサポート。PenguinStatsとYituliuへ公開求人データのアップロード。
  • 高スターの公開求人を選択するのに便利な公開求人のパネルの手動認識をサポートします。（この上級エリートとCost回復はシージかシージか）
  • 所持オペレーターを認識し、既存および未所有のオペレーターの記録サポート、公開求人を手動で設定するためのヒントを提供することもできます。
  • 倉庫のアイテム認識機能 Arkplanner/ARK-NIGHTS.comとアークナイツ ツールボックスへ出力可能！使用方法はツール内文章を参照してください。
  • 戦友訪問、FP収集、買い物、デイリーリワード収集、ワンクリックして全自動操作！
  • 統合戦略自動作戦、オペレーターとレベルの自動認識、源石錐とキャンドルの自動収集、電気ケトルを獲得！
  • 作業JSONファイルをインポートし、自動操作も可能！ ビデオデモ（中文）
  • C、Python、Java、Rust、Golang、Java HTTP、Rust HTTPなどの多種多様なインターフェースに対応、統合や呼び出しが簡単で、自分好みにMAAをカスタマイズできます!

UIを見れば使い方もすぐ分かる！

マニュアル

機能紹介

ユーザーマニュアルをご参照ください。

サーバーに応じてサポートされる機能

現在、国際クライアント（英語クライアント）、日本語クライアント、韓国語クライアント、繁体字中国語クライアントのほとんどの機能がサポートされています。 ただし、海外ユーザーの少なさとプロジェクト要員不足により、十分に検証できていない機能も多いので、ぜひ体験してみてください。
バグに遭遇した場合、または特定の機能に対する強い要望がある場合は、Issues and Discussions で質問してください。 MAA の構築にご参加ください。海外クライアント対応 を参照してください

CLI支持

MAA はコマンドラインインタフェース（CLI）操作をサポートし、LinuxとmacOSをサポートし、自動スクリプトやグラフィックインタフェースのないサーバで使用することができる。CLI使用ガイドを参照してください。

一緒に参加しよう

主な関連プロジェクト

現在、プロジェクトチームにはフロントエンドの専門家が非常に不足しています。経験があれば、私たちに参加してください！

多言語 (i18n)

MAA は中国語（簡体字）を第一言語とし、翻訳見出しはすべて中国語（簡体字）を基準としています。

開発への参加

Windows

開発関連を参照してください。

Linux | macOS

Linuxチュートリアルを参照してください。

API

グローバル版を含む海外クライアントの対応について

海外版クライアントの対応についてをご覧ください。大陸版で既にサポートされている機能を他地域クライアントへ移植するための必要作業の大半は、簡単なJSONの修正と（作業に必要な）スクリーンショットの提出で済みます。。

開発に参加したいがGitHubの使い方がよくわかりません

Githubプルリクエストのプロセス

Issue bot

詳細についてはIssue bot 使用方法を参照してください。

謝辞

オープンソースライブラリ

データソース

貢献/協力者

MAAをより良くするために開発・テストに貢献してくれたすべての方々に感謝します！ (*´▽｀)ノノ

Contributors

免責事項

  • 本ソフトウェアは GNU Affero General Public License v3.0 only オープンソースライセンスを使用しています、また追加の ユーザー規約 が付属しています。
  • 本ソフトウェアのロゴはAGPL 3.0ライセンスを使用しており、オープンソースではなく、耗毛とVie、2人のアーティストと開発者がすべての権利を留保しています。「AGPL 3.0ライセンスに基づいて許可されている」という理由で、許可がない場合に本ソフトウェアのロゴを無断で使用することは禁止しております。また、許可なく商業目的で本ソフトウェアのロゴを無断で使用することも禁止しております。
  • 本ソフトウェアはオープンソースで無料であり、学習と研究のみの目的としています。販売者が本ソフトウェアの料金を請求する場合は、デバイスや時間の料金である可能性があります。発生した問題と結果は、本ソフトウェアとは一切関係ありません。

DirectML サポート説明

このソフトウェアは、Windows プラットフォームで Microsoft が提供する独立したコンポーネント DirectML に依存する GPU アクセラレーションをサポートしています。DirectML はこのプロジェクトのオープン ソース部分ではなく、AGPL 3.0 の対象ではありません。ユーザーの利便性のために、インストール パッケージには変更されていない DirectML.dll ファイルが含まれています。GPU アクセラレーションが不要な場合は、DLL ファイルを安全に削除しても、ソフトウェアのコア機能は正常に実行されます。

広告

ユーザー研究グループQQグループ：QQグループ
Discord サーバー: Discord 招待リンク
ユーザー研究グループTGグループ：Telegram
自動作戦JSON作業シェア：prts.plus
Bilibili ライブ配信: MrEO ライブ配信 コーディング & MAA-Official ライブ配信 ゲーム/雑談

技術研究(アークナイツ無関係)：インボリューション・ヘル！(QQグループ)
開発者グループ：QQグループ

ソフトウェアが役立つと思うなら、Star（ページの右上隅にある星）をクリックしてください。私たちにとって最高のサポートです！

Reference in New Issue View Git Blame Copy Permalink