ci: use lychee to check dead links (#9675)

* ci: use lychee to check dead links * ci: comment on PR when dead links are found * docs: fix broken links
2026-07-15 17:30:27 +08:00 · 2024-07-17 15:26:17 +01:00
parent 75733e82ec
commit 62ffdc73cb
38 changed files with 167 additions and 143 deletions
--- a/.github/workflows/markdown-checker.yml
+++ b/.github/workflows/markdown-checker.yml
@@ -2,15 +2,21 @@ name: Lint Markdown files

 on:
  push:
+    branches:
+      - dev
    paths:
      - "**/*.md"
-      - ".github/workflows/lint-markdown.yml"
+      - "docs/**"
+      - ".github/workflows/markdown-checker.yml"
  pull_request:
+    branches:
+      - dev
    paths:
      - "**/*.md"
-      - ".github/workflows/lint-markdown.yml"
+      - "docs/**"
+      - ".github/workflows/markdown-checker.yml"
  schedule:
-    - cron: "44 7 * * 2"
+    - cron: "44 7 * * 2" # Every Tuesday at 7:44 AM UTC
  workflow_dispatch:

 jobs:
@@ -31,19 +37,47 @@ jobs:
            README.md
            docs/**/*.md

-#  check-links:
-#    name: Check Dead Links
-#    runs-on: ubuntu-latest
-#    steps:
-#      - name: Check out code
-#        uses: actions/checkout@v4
-#        with:
-#          show-progress: false
-#
-#      - name: Check Dead Link
-#        uses: umbrelladocs/action-linkspector@v1
-#        with:
-#          # Use github-pr-review when triggered by a pull request; otherwise, use github-check
-#          reporter: ${{ github.event_name == 'pull_request' && 'github-pr-review' || 'github-check' }}
-#          filter_mode: nofilter
-#          fail_on_error: true
+  check-links:
+    name: Check Dead Links
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: write
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v4
+        with:
+          show-progress: false
+
+      - name: Cache lychee
+        uses: actions/cache@v4
+        with:
+          path: .lycheecache
+          key: cache-lychee-${{ github.sha }}
+          restore-keys: cache-lychee-
+
+      - name: Check dead links
+        uses: lycheeverse/lychee-action@v1
+        with:
+          # 主要用于检查相对链接，对于 Github Actions 无法访问的网站，或者失效的外部网站，可以通过 --exclude 参数排除
+          args: >
+            --verbose --no-progress --cache --max-cache-age 1d 
+            --exclude 'https://map\.ark-nights\.com/areas' 
+            --exclude 'https://.*\.maa-org\.net/.*' 
+            --exclude 'https://support\.bluestacks\.com/.*' 
+            --exclude 'https://www\.bigfun\.cn/.*' 
+            --exclude 'https://myqqbot\.com/.*' 
+            --exclude 'http://xn--2qqv08bx5e\.com/' 
+            --exclude-path 'docs/zh-tw/manual/introduction/introduction_old.md' 
+            --exclude-path 'docs/ja-jp/manual/introduction/introduction_old.md' 
+            -- './docs/**/*.md' './README.md'
+
+      - name: Comment (only for PR)
+        if: github.event_name == 'pull_request' && env.lychee_exit_code != 0
+        uses: marocchino/sticky-pull-request-comment@v2
+        with:
+          message: |
+            Dead links found in the documentation. Please fix them.
+            Details: https://github.com/MaaAssistantArknights/MaaAssistantArknights/actions/runs/${{ github.run_id }}
+
+      - name: Exit with lychee exit code
+        run: exit ${{ env.lychee_exit_code }}
--- a/.gitignore
+++ b/.gitignore
@@ -448,3 +448,6 @@ enc_temp_folder/*
 # CF 活动关卡（异格夜刀），手动改的地图
 /resource/Arknights-Tile-Pos/act24side_09-activities-act24side-level_act24side_09.json
 /src/MaaWpfGui/FodyWeavers.xml
+
+# 链接检查缓存
+.lycheecache
--- a/.linkspector.yml
+++ b/.linkspector.yml
@@ -1,5 +0,0 @@
-dirs:
-  - .
-useGitIgnore: true
-ignorePatterns:
-  - pattern: "^https?://127.0.0.1(:\\d+)?/"
--- a/docs/en-us/develop/documentation-guidelines.md
+++ b/docs/en-us/develop/documentation-guidelines.md
@@ -9,7 +9,7 @@ icon: jam:write-f
 The purpose of this document is to guide document writers to better utilize the functionalities provided by the theme, thus achieving a more readable effect.
 :::

-Our documentation is built on [vuepress](https://github.com/vuejs/vuepress) and utilizes the [vuepress-theme-hope](https://github.com/vuepress-theme-hope/vuepress-theme-hope) theme. You can also refer to the [official documentation](https://theme-hope.vuejs.press/en/) for more detailed explanations. Here, we only introduce some common functionalities.
+Our documentation is built on [vuepress](https://github.com/vuejs/vuepress) and utilizes the [vuepress-theme-hope](https://github.com/vuepress-theme-hope/vuepress-theme-hope) theme. You can also refer to the [official documentation](https://theme-hope.vuejs.press/) for more detailed explanations. Here, we only introduce some common functionalities.

 ## Deploy Locally

--- a/docs/en-us/develop/linux-tutorial.md
+++ b/docs/en-us/develop/linux-tutorial.md
@@ -77,8 +77,8 @@ Refer to the implementation of `__main__` in [Python demo](https://github.com/Ma

 ### C

-Refer to the implementation of [CppSample](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/src/CppSample/main.cpp)
+Refer to the implementation of [CppSample](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/src/Cpp/main.cpp)

 ### C Sharp

-Refer to the implementation of [MaaWpfGui](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/src/MaaWpfGui/Helper/AsstProxy.cs)
+Refer to the implementation of [MaaWpfGui](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/src/MaaWpfGui/Main/AsstProxy.cs)
--- a/docs/en-us/manual/device/linux.md
+++ b/docs/en-us/manual/device/linux.md
@@ -11,7 +11,7 @@ You can choose one of the following installation methods:

 ### Use maa-cli

-[maa-cli](https://github.com/MaaAssistantArknights/maa-cli) is a simple CLI for MAA made with Rust. Please read installation and usage tutorials in [User Guide for CLI](./1.6-USER_GUIDE_FOR_CLI).
+[maa-cli](https://github.com/MaaAssistantArknights/maa-cli) is a simple CLI for MAA made with Rust. Please read installation and usage tutorials in [User Guide for CLI](../cli/).

 ### Use Wine

@@ -103,7 +103,7 @@ Enable it by placing `MaaDesktopIntegration.so` generated by MAA Wine Bridge in

 #### 3. Tasks Settings

-Customizing tasks: Reference to [AsstAppendTask](https://maa.plus/docs/en-us/3.1-INTEGRATION.html#asstappendtask) and modify [`# 任务及参数请参考 docs/集成文档.md`](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/722f0ddd4765715199a5dc90ea1bec2940322344/src/Python/sample.py#L54) section in `sample.py`.
+Customizing tasks: Reference to [AsstAppendTask](../../protocol/integration.md#asstappendtask) and modify [`# 任务及参数请参考 docs/集成文档.md`](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/722f0ddd4765715199a5dc90ea1bec2940322344/src/Python/sample.py#L54) section in `sample.py`.

 ## Emulator Supports

--- a/docs/en-us/protocol/integration.md
+++ b/docs/en-us/protocol/integration.md
@@ -93,7 +93,7 @@ Appends a task.
 }
 ```

-Supports some of the special stages,Please refer to [autoLocalization example](..\..\..\tools\AutoLocalization\example\en-us.xaml#L260).
+Supports some of the special stages,Please refer to [autoLocalization example](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/tools/AutoLocalization/example/en-us.xaml#L260).

 - `Recruit`  
    Recruitment
--- a/docs/en-us/protocol/sss-schema.md
+++ b/docs/en-us/protocol/sss-schema.md
@@ -67,7 +67,7 @@ As JSON format does not support comments, please remove the comments when using


            "strategies": [                // Required
-                                         // It will deploy the tool_men in each object according to the order. 
+                                         // It will deploy the tool_men in each object according to the order.
                                         // If the current hand does not have any tool_men, it will deploy the next object.
                {
                    "core": "Thorns",
@@ -109,7 +109,7 @@ As JSON format does not support comments, please remove the comments when using
            ],
            "draw_as_possible": true,   // "Deploy Operator" button. Whether to use it when available. Optional, default is true.
            "actions": [                // Optional
-                                        // It reuses the logic of copying homework. 
+                                        // It reuses the logic of copying homework.
                                        // If the condition of the action is met, the action is executed. Otherwise, the strategies above are executed.
                {
                    "type": "Deploy Operator" // New type. Click the "Deploy Operator" button. It is invalid when "draw_as_possible" is true.
@@ -145,6 +145,4 @@ As JSON format does not support comments, please remove the comments when using

 ## Example

-[SSS_阿卡胡拉丛林.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_阿卡胡拉丛林.json)
-
-[SSS_多索雷斯在建地块.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_多索雷斯在建地块.json)
+<https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/>
--- a/docs/ja-jp/develop/development.md
+++ b/docs/ja-jp/develop/development.md
@@ -9,7 +9,7 @@ icon: iconoir:developer

 ### プログラミングの仕方がわからないので、JSONファイルやドキュメントなどを少し変更したいのですが、どうすればいいですか？

-[「パラスちゃん」も理解できるGitHubのPull Requestの使用ガイド](./純WebサイトのPRチュートリアル.md)へようこそ（純WebサイトのPRチュートリアル）
+[「パラスちゃん」も理解できるGitHubのPull Requestの使用ガイド](./pr-tutorial.md)へようこそ（純WebサイトのPRチュートリアル）

 ### プログラミングの仕方を知っていますが、GitHub/C++/...... に触れたことがありません、どうすればいいですか？

@@ -120,4 +120,4 @@ GitHub codespace を作成して C++ 開発環境を自動的に構成する

 [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg?color=green)](https://codespaces.new/MaaAssistantArknights/MaaAssistantArknights)

-次に、 vscode または [Linuxチュートリアル](./Linuxチュートリアル.md) のプロンプトに従って、 GCC 12 および CMake プロジェクトを構成します。
+次に、 vscode または [Linuxチュートリアル](./linux-tutorial.md) のプロンプトに従って、 GCC 12 および CMake プロジェクトを構成します。
--- a/docs/ja-jp/develop/issue-bot-usage.md
+++ b/docs/ja-jp/develop/issue-bot-usage.md
@@ -5,7 +5,9 @@ icon: bxs:bot

 # Issue Botの使う方

-Issue Botのアクションは[issue-checker](https://github.com/zzyyyl/issue-checker)になっており、設定ファイルである[issue-checker.yml](.github/issue-checker.yml)を利用します。
+Issue Botのアクションは[issue-checker](https://github.com/zzyyyl/issue-checker)になっており、設定ファイルである[issue-checker.yml][issue-checker]を利用します。
+
+[issue-checker]: https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/.github/issue-checker.yml

 ::: warning
 Commitizenの仕様でコミットしていない場合、マージリクエストは`ambiguous`とマークされることに注意してください。
@@ -17,7 +19,7 @@ Commitizenの仕様でコミットしていない場合、マージリクエス

 - `module`, `Client`, `ambiguous`, `translation required`などのラベルを Issue および Pull Request に追加します。  
  Issue Botは、キーワードを元にカテゴリーを追加します。  
-  キーワードは[設定ファイル](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/.github/issue-checker.yml)を確認して下さい。
+  キーワードは[設定ファイル][issue-checker]を確認して下さい。
 - 作成者が可視性がパブリックに設定されている MAA メンバーであるの Issue と Pull Request の場合、`MAA Team`ラベルを追加しました。

 #### Issuesとコメント
--- a/docs/ja-jp/develop/linux-tutorial.md
+++ b/docs/ja-jp/develop/linux-tutorial.md
@@ -63,11 +63,11 @@ MAAの構築方法はまだ議論されていますが、このチュートリ
 ## その他のインストール方法

 - AUR: [maa-assistant-arknights](https://aur.archlinux.org/packages/maa-assistant-arknights)
- NUR: [nur.repos.cryolitia.MaaAssistantArknights](https://github.com/nix-community/nur-combined/tree/master/repos/cryolitia/pkgs/MaaAssistantArknights/default.nix#L138)
+- NUR: [nur.repos.cryolitia.MaaAssistantArknights](https://github.com/nix-community/nur-combined/tree/master/repos/cryolitia/pkgs/maa-assistant-arknights/default.nix#L138)

 ## 統合ドキュメント

-[~~ドキュメントとは言えないかもしれません~~](../プロトコルドキュメント/統合ドキュメント.md)
+[~~ドキュメントとは言えないかもしれません~~](../protocol/integration.md)

 ### Python

--- a/docs/ja-jp/develop/overseas-client-adaptation.md
+++ b/docs/ja-jp/develop/overseas-client-adaptation.md
@@ -10,7 +10,7 @@ icon: ri:earth-fill
 このチュートリアルを始める前に、以下の内容を確認してください。

 1. 必要なソフトウェアをインストールし、正しく設定されていること。大陸版クライアントまたは海外版クライアントの `readme.md` に、サポートされている機能が正しく動作するための情報があるはずです。
-2. [タスクAPI](../プロトコルドキュメント/タスクAPI.md) を読み、各フィールドの意味と使い方の基本を理解していること。また、コード中の `@` と `#` の意味と使い方を理解しておくこと。
+2. [タスクAPI](../protocol/task-schema.md) を読み、各フィールドの意味と使い方の基本を理解していること。また、コード中の `@` と `#` の意味と使い方を理解しておくこと。
 3. 大陸版クライアントの `task.json` ファイルとテンプレート画像が海外クライアントに記載されていない、または不足している場合、代替手段として使用されることを理解していること。海外クライアントの `task.json` の内容は、大陸版のタスクのフィールドに合わせて書き換える必要があります。
 4. ある程度の英語力があり、英語のログを読むことができ、ログから不足している画像やその他の情報を見つけることができること。
 5. タスクチェーンに従って、個別に修正を行うことが推奨されることを理解していること。例えば、Awardタスクを修正する場合、`template image`, `text`, `roi` をその `next` フィールドの順序に従って段階的に修正する必要があります。こうすることで、すべてのタスクが修正後に正常に動作することを確認し、エラーを簡単に発見することができます。また、一度に多くのコンテンツを修正した場合に、どのタスクで止まっているのか忘れてしまうといった混乱も防ぐことができます。
@@ -138,4 +138,4 @@ ROIの範囲を変更するには

 ## 変更を送信する

-[Github Pull Requst ガイド](./開発を開始.md#github-pull-request-プロセス概要)を参照してください。
+[Github Pull Requst ガイド](../develop/development.md#github-pull-request-プロセス概要)を参照してください。
--- a/docs/ja-jp/develop/pr-tutorial.md
+++ b/docs/ja-jp/develop/pr-tutorial.md
@@ -11,7 +11,7 @@ icon: mingcute:git-pull-request-fill

 ::: warning
 このガイドでは、多くの概念を簡略化し、より多くの人々が実際に使用できるように、不格好であるが簡単な操作が含まれています。また、正しくない説明もありますので、大変恐れ入りますが、専門家の方々にはお許しください。
-Gitの使用経験とプログラミングの基礎がある場合、[Github Pull Request プロセス概要](./開発を開始.md#github-pull-request-プロセス概要)など、より上級のチュートリアルを見ることができます。
+Gitの使用経験とプログラミングの基礎がある場合、[Github Pull Request プロセス概要](./development.md#github-pull-request-プロセス概要)など、より上級のチュートリアルを見ることができます。
 :::

 ## 基本概念および用語の説明
--- a/docs/ja-jp/manual/device/linux.md
+++ b/docs/ja-jp/manual/device/linux.md
@@ -15,7 +15,7 @@ icon: teenyicons:linux-alt-solid

 ::: tip
 プリコンパイル済みバージョンには、比較的新しいLinuxディストリビューション(Ubuntu 22.04)でコンパイルされた動的ライブラリが含まれており、システムに古いバージョンのlibstdc++がある場合、ABIの非互換性に遭遇する可能性があります
-[Linuxコンパイル・チュートリアル](../../開発関連/Linuxチュートリアル.md) を参照して再コンパイルまたはコンテナを使用して実行できます
+[Linuxコンパイル・チュートリアル](../../develop/linux-tutorial.md) を参照して再コンパイルまたはコンテナを使用して実行できます
 :::

 - Arch Linuxシリーズのリリース版は、aur パッケージ [maa-assistant-arknights](https://aur.archlinux.org/packages/maa-assistant-arknights)を選択する使用し、インストール後のプロンプトに従ってファイルを編集することができる
@@ -54,7 +54,7 @@ icon: teenyicons:linux-alt-solid

 ### 3. タスク構成

-カストムタスク： 必要に応じて [統合ドキュメント](../../プロトコルドキュメント/統合ドキュメント.md) を参照し、 `sample.py` の [`# タスクとパラメーターについては 統合ドキュメント`](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/722f0ddd4765715199a5dc90ea1bec2940322344/src/Python/sample.py#L54) 欄を変更する
+カストムタスク： 必要に応じて [統合ドキュメント](../../protocol/integration.md) を参照し、 `sample.py` の [`# タスクとパラメーターについては 統合ドキュメント`](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/722f0ddd4765715199a5dc90ea1bec2940322344/src/Python/sample.py#L54) 欄を変更する

 ## エミュレータのサポート

--- a/docs/ja-jp/manual/device/macos.md
+++ b/docs/ja-jp/manual/device/macos.md
@@ -6,7 +6,7 @@ icon: basil:apple-solid
 # Mac でのエミューレータ

 ::: tip
-問題が発生した場合は、まず [よくある質問](../よくある質問.md) を参照してください
+問題が発生した場合は、まず [よくある質問](../faq.md) を参照してください
 :::

 ## Apple Silicon チップ
@@ -53,7 +53,7 @@ icon: basil:apple-solid

 ### ✅ [NOX](https://www.yeshen.com/)

-サポートされています。現在、 Ma cの MAAX バージョンはエミュレータの自動適応をサポートしていないため、MAAの `設定` - `接続設定` で、 `adb` に `127.0.0.1：62001`を接続する必要があり、ポートはデフォルトの` 5555 `ではないことに注意し、エミュレータポートに関する詳細な説明は[一般的なエミュレータadbポート](../よくある質問.md#一般的なAndroidエミュレータのadbポート)を参照してください。
+サポートされています。現在、 Ma cの MAAX バージョンはエミュレータの自動適応をサポートしていないため、MAAの `設定` - `接続設定` で、 `adb` に `127.0.0.1：62001`を接続する必要があり、ポートはデフォルトの` 5555 `ではないことに注意し、エミュレータポートに関する詳細な説明は[一般的なエミュレータadbポート](../faq.md#一般的なAndroidエミュレータのadbポート)を参照してください。

 補足：mac の NOX の adb バイナリファイルの場所は `/Applications/NoxAppPlayer.app/Contents/MacOS/adb` 、親ディレクトリ `MacOS` の下で `adb devices` コマンドを使用してadbポートを表示できます。

--- a/docs/ja-jp/manual/faq.md
+++ b/docs/ja-jp/manual/faq.md
@@ -64,7 +64,7 @@ MAA はバージョン 5.0 で .NET 8 に更新され、エンドユーザーに
 ## 接続エラー

 ::: tip
-[エミュレータのサポート](./エミュレータのサポート) を参照して、エミュレータがサポートされていることを確認してください。
+[エミュレータのサポート](./device/) を参照して、エミュレータがサポートされていることを確認してください。
 :::

 ### adbと接続アドレスが正しいことを確認する
@@ -109,7 +109,7 @@ Android Phone Assistant は adb を使用してスマホと通信しますが、

 ### エミュレーターを変更する

-[エミュレータのサポート](./エミュレータのサポート) を参照してください。
+[エミュレータのサポート](./device/) を参照してください。

 ## 接続に成功した後、固まり、全く操作できなくなる

@@ -185,7 +185,7 @@ MAA はレジストリから `bluestacks.conf` の保存場所を読み取ろう

 - `UI調整`を使用している場合は、0に調整してください。
 - CN以外のクライアントをお使いの場合は、`設定` - `対象クライアント` - `クライアントバージョン` の選択でご確認ください。また、非CNクライアントでは全ての機能がサポートされているわけではありませんので、各国語のドキュメントを参照してください。
- 自動ローグを実行している場合、[詳細説明](./詳細説明.md#自動統合戦略-ローグライク)を参照し、`スタート` - `自動ローグ` - `主題`で正しいテーマを選択してください。
+- 自動ローグを実行している場合、[詳細説明](./introduction/integrated-strategy.md)を参照し、`スタート` - `自動ローグ` - `主題`で正しいテーマを選択してください。
 - `Adb Input` のタッチモードで動作が遅いのは正常です。オートバトルなどが必要な場合は他のモードに切り替えてみてください。

 ### スクリーンショットに時間がかかる/長すぎるというメッセージが表示される
--- a/docs/ja-jp/protocol/integrated-strategy-schema.md
+++ b/docs/ja-jp/protocol/integrated-strategy-schema.md
@@ -41,7 +41,7 @@ JSONファイルはコメントをサポートしていません。テキスト

 ### オペレーターの分類

-ゲーム理解に基づいて、オペレーターを異なる **_groups_** （グループ、関連概念は[自動戦闘フロープロトコル](./自動戦闘API.md)を参照）に分類します
+ゲーム理解に基づいて、オペレーターを異なる **_groups_** （グループ、関連概念は[自動戦闘フロープロトコル](./copilot-schema.md)を参照）に分類します

 ::: info 注意

@@ -86,7 +86,7 @@ JSONファイルはコメントをサポートしていません。テキスト
 1. 既存のグループの紹介

   ファントムテーマを例に取ると：主にオペレーターを以下のように分類しています
-   | グループ | 主な考慮事項 | 主に職種を含む | オペレーターの例 |  
+   | グループ | 主な考慮事項 | 主に職種を含む | オペレーターの例 |
   | :--- | :--- | :--- | :--- |
   | **_地面阻挡_** | 場に立つことと雑魚を清掃 | 重装、前衛 | 庇護衛士、基石、ラ・プルマ、マウンテン、M3、リィンとシーンの召喚ユニット、スポット、重装予備隊員 |
   | **_地面单切_** | 一人でエリートモンスターと戦う | 執行者-特殊 | スルト、血掟テキサス、キリンRヤトウ、M3、レッド |
--- a/docs/ja-jp/protocol/integration.md
+++ b/docs/ja-jp/protocol/integration.md
@@ -101,7 +101,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
 }
 ```

-いくつかの特別ステージ名もサポートしています、[組み込み例](..\..\tools\AutoLocalization\example\ja-jp.xaml#L230)をご参照ください
+いくつかの特別ステージ名もサポートしています、[組み込み例](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/tools/AutoLocalization/example/ja-jp.xaml#L230)をご参照ください

 - `Recruit`  
    公開求人
@@ -248,7 +248,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
 }
 ```

-自動操縦JSONの詳細については、[自動戦闘API](./自動戦闘API.md)を参照してください
+自動操縦JSONの詳細については、[自動戦闘API](./copilot-schema.md)を参照してください

 - `SSSCopilot`  
  保全駐在の自動戦闘  
@@ -261,7 +261,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
 }
 ```

-保全駐在の自動操縦JSONの詳細については、[保全駐在API](./保全駐在API.md)
+保全駐在の自動操縦JSONの詳細については、[保全駐在API](./sss-schema.md)

 - `Depot`
    倉庫アイテム認識
--- a/docs/ja-jp/protocol/sss-schema.md
+++ b/docs/ja-jp/protocol/sss-schema.md
@@ -134,6 +134,4 @@ JSONファイルはコメントをサポートしていません。テキスト

 ## サンプルファイル

-[SSS_阿卡胡拉丛林.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_阿卡胡拉丛林.json)
-
-[SSS_多索雷斯在建地块.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_多索雷斯在建地块.json)
+<https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/>
--- a/docs/ja-jp/readme.md
+++ b/docs/ja-jp/readme.md
@@ -31,7 +31,7 @@ MAAは、MAA Assistant Arknightsです。
 ## 機能一覧

 - 自動作戦、ドロップ認識および [PenguinStats](https://penguin-stats.io/) と [Yituliu](https://ark.yituliu.cn/) へデータアップロード。
- 自動基地シフト、オペレーター効率計算、単一設備内に最適なソリューション；[カスタムシフト](./プロトコルドキュメント/基地シフトAPI.md)にも対応しています。
+- 自動基地シフト、オペレーター効率計算、単一設備内に最適なソリューション；[カスタムシフト](./protocol/base-scheduling-schema.md)にも対応しています。
 - 自動公開求人、緊急招集票を使う、使い切るのもサポート。[PenguinStats](https://penguin-stats.io/result/stage/recruit/recruit)と[Yituliu](https://ark.yituliu.cn/survey/maarecruitdata)へ公開求人データのアップロード。
 - 高スターの公開求人を選択するのに便利な公開求人のパネルの手動認識をサポートします。~~（この上級エリートとCost回復はシージかシージか）~~
 - 所持オペレーターを認識し、既存および未所有のオペレーターの記録サポート、公開求人を手動で設定するためのヒントを提供することもできます。（日本サーバーではオペレーターの名前部分のフォントサイズが異なるため認識にややブレがあります）
@@ -83,7 +83,7 @@ UIを見れば使い方もすぐ分かる！

 ### 基本設定

-はじめに[エミュレータのサポート](./manual/device)と[MAA使用説明書](./manual/introduction.md)を参照してください。
+はじめに[エミュレータのサポート](./manual/device)と[MAA使用説明書](./manual/introduction/)を参照してください。

 ## よくある質問

@@ -138,11 +138,11 @@ MAA は中国語（簡体字）を第一言語とし、翻訳見出しはすべ
 2. Visual Studio 2022 で `MAA.sln` を開き、`MaaWpfGui` を右クリックして、スタートアップ プロジェクトとして設定します。
 3. VS 上記の設定で 'RelWithDebInfo' 'x64' を選択します （Release パッケージまたは ARM プラットフォームをコンパイルしている場合は、この手順を無視してください）
 4. `MaaWpfGui` を右クリックし、[プロパティ] - [デバッグ] - [ローカル デバッグを有効にする] を選択します (これにより、C++ コアにブレークポイントを掛けることができます)。
-5. (オプション) PR を送信する場合は、[clang-formatを有効にする](./開発関連/開発を開始.md#visual-studioでclang-formatを有効にする)を有効にすることをお勧めします。
+5. (オプション) PR を送信する場合は、[clang-formatを有効にする](./develop/development.md#visual-studioでclang-formatを有効にする)を有効にすることをお勧めします。

 ### Linux | macOS

-[Linuxチュートリアル](./開発関連/Linuxチュートリアル.md)を参照してください。
+[Linuxチュートリアル](./develop/linux-tutorial.md)を参照してください。

 ### API

@@ -154,23 +154,23 @@ MAA は中国語（簡体字）を第一言語とし、翻訳見出しはすべ
 - [Java HTTPインターフェース](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/src/Java/Readme.md)
 - [Rustインターフェース](https://github.com/MaaAssistantArknights/MaaAssistantArknights/tree/master/src/Rust/src/maa_sys)：[HTTPインターフェース](https://github.com/MaaAssistantArknights/MaaAssistantArknights/tree/master/src/Rust)
 - [TypeScriptインターフェース](https://github.com/MaaAssistantArknights/MaaAsstElectronUI/tree/main/packages/main/coreLoader)
- [Woolangインターフェース](src/Woolang/maa.wo)：[統合例](src/Woolang/main.wo)
- [統合ドキュメント](./プロトコルドキュメント/統合ドキュメント.md)
- [コールバックAPI](./プロトコルドキュメント/コールバックAPI.md)
- [タスクAPI](./プロトコルドキュメント/タスクAPI.md)
- [自動戦闘API](./プロトコルドキュメント/自動戦闘API.md)
+- [Woolangインターフェース](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/src/Woolang/maa.wo)：[統合例](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/src/Woolang/demo.wo)
+- [統合ドキュメント](./protocol/integration.md)
+- [コールバックAPI](./protocol/callback-schema.md)
+- [タスクAPI](./protocol/task-schema.md)
+- [自動戦闘API](./protocol/copilot-schema.md)

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

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

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

-[Githubプルリクエストのプロセス](./開発関連/開発を開始.md)
+[Githubプルリクエストのプロセス](./develop/development.md#introduction-to-github-pull-request-flow)

 ### Issue bot

-詳細については[Issue bot 使用方法](./開発関連/IssueBotの使う方.md)を参照してください。
+詳細については[Issue bot 使用方法](./develop/issue-bot-usage.md)を参照してください。

 ## 謝辞

--- a/docs/ko-kr/develop/linux-tutorial.md
+++ b/docs/ko-kr/develop/linux-tutorial.md
@@ -70,8 +70,8 @@ MAA의 빌드 방법은 여전히 논의 중입니다. 이 튜토리얼의 내

 ### C

-[CppSample](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/src/CppSample/main.cpp)의 구현을 참조하세요.
+[CppSample](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/src/Cpp/main.cpp)의 구현을 참조하세요.

 ### C\#

-[MaaWpfGui](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/src/MaaWpfGui/Helper/AsstProxy.cs)의 구현을 참조하세요.
+[MaaWpfGui](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/src/MaaWpfGui/Main/AsstProxy.cs)의 구현을 참조하세요.
--- a/docs/ko-kr/manual/cli/install.md
+++ b/docs/ko-kr/manual/cli/install.md
@@ -55,10 +55,10 @@ Homebrew 사용자는 비공식 [tap](https://github.com/MaaAssistantArknights/h

 지원되지 않는 시스템을 사용하거나 패키지 관리자를 사용하지 않으려는 경우, 아래 링크를 통해 해당 플랫폼의 사전 컴파일된 바이너리 파일을 다운로드하고, 압축을 풀어 실행 파일을 `PATH`에 추가하여 사용할 수 있습니다.

- [macOS](https://github.com/MaaAssistantArknights/maa-cli/releases/latest/download/maa_cli-v0.4.5-universal-apple-darwin.zip)
- [Linux x86_64 (x64, amd64)](https://github.com/MaaAssistantArknights/maa-cli/releases/latest/download/maa_cli-v0.4.5-x86_64-unknown-linux-gnu.tar.gz)
- [Linux aarch64 (arm64)](https://github.com/MaaAssistantArknights/maa-cli/releases/latest/download/maa_cli-v0.4.5-aarch64-unknown-linux-gnu.tar.gz)
- [Windows x86_64 (x64, amd64)](https://github.com/MaaAssistantArknights/maa-cli/releases/latest/download/maa_cli-v0.4.5-x86_64-pc-windows-msvc.zip)
+- [macOS](https://github.com/MaaAssistantArknights/maa-cli/releases/latest/download/maa_cli-universal-apple-darwin.zip)
+- [Linux x86_64 (x64, amd64)](https://github.com/MaaAssistantArknights/maa-cli/releases/latest/download/maa_cli-x86_64-unknown-linux-gnu.tar.gz)
+- [Linux aarch64 (arm64)](https://github.com/MaaAssistantArknights/maa-cli/releases/latest/download/maa_cli-aarch64-unknown-linux-gnu.tar.gz)
+- [Windows x86_64 (x64, amd64)](https://github.com/MaaAssistantArknights/maa-cli/releases/latest/download/maa_cli-x86_64-pc-windows-msvc.zip)

 위의 목록에 없는 플랫폼의 경우, 직접 컴파일하여 설치할 수 있습니다(아래 참조).

--- a/docs/ko-kr/protocol/integration.md
+++ b/docs/ko-kr/protocol/integration.md
@@ -92,7 +92,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
 }
 ```

-특수 스테이지의 일부를 지원합니다. 자세한 내용은 [자동 현지화 예제](..\..\..\tools\AutoLocalization\example\ko-kr.xaml)를 참고하세요.
+특수 스테이지의 일부를 지원합니다. 자세한 내용은 [자동 현지화 예제](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/tools/AutoLocalization/example/ko-kr.xaml#L233)를 참고하세요.

 - `Recruit`  
  공개모집
--- a/docs/ko-kr/protocol/sss-schema.md
+++ b/docs/ko-kr/protocol/sss-schema.md
@@ -66,7 +66,7 @@ icon: game-icons:prisoner


            "strategies": [                // 필수
-                                         // 순서대로 각 객체의 tool_men에 따라 배치될 것입니다. 
+                                         // 순서대로 각 객체의 tool_men에 따라 배치될 것입니다.
                                         // 현재 핸드에 tool_men이 없는 경우 다음 객체를 배치합니다.
                {
                    "core": "棘刺",
@@ -108,7 +108,7 @@ icon: game-icons:prisoner
            ],
            "draw_as_possible": true,   // "오퍼레이터 배치" 버튼. 가능할 때 사용할지 여부. 선택 사항, 기본값은 true입니다.
            "actions": [                // 선택 사항
-                                        // 숙제 복사의 논리를 재사용합니다. 
+                                        // 숙제 복사의 논리를 재사용합니다.
                                        // 조건이 해당 액션을 충족하면 액션을 실행합니다. 그렇지 않으면 위의 전략들이 실행됩니다.
                {
                    "type": "调配干员"   // 새로운 타입. "오퍼레이터 배치" 버튼을 클릭합니다. "draw_as_possible"가 true일 때는 무효화됩니다.
@@ -144,6 +144,4 @@ icon: game-icons:prisoner

 ## 예시

-[SSS_阿卡胡拉丛林.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_阿卡胡拉丛林.json) 아카후알라 정글
-
-[SSS_多索雷斯在建地块.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_多索雷斯在建地块.json) 도솔레스 건설부지
+<https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/>
--- a/docs/ko-kr/readme.md
+++ b/docs/ko-kr/readme.md
@@ -179,7 +179,7 @@ MAA는 중국어(간체)를 기본 언어로 하며, 번역 단어는 중국어(

 ### 개발에 기여를 원하지만, GitHub 사용이 어려운 경우?

-[GitHub Pull Request 가이드](./develop/pr-tutorial.md)
+[GitHub Pull Request 가이드](./develop/development.md#introduction-to-github-pull-request-flow)

 ### Issue bot

--- a/docs/zh-cn/protocol/integration.md
+++ b/docs/zh-cn/protocol/integration.md
@@ -97,7 +97,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
 }
 ```

-另支持少部分资源关卡名请参考[集成示例](..\..\..\tools\AutoLocalization\example\zh-cn.xaml#L260)
+另支持少部分资源关卡名请参考[集成示例](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/tools/AutoLocalization/example/zh-cn.xaml#L260)

 - `Recruit`  
  公开招募
--- a/docs/zh-cn/protocol/sss-schema.md
+++ b/docs/zh-cn/protocol/sss-schema.md
@@ -154,6 +154,4 @@ icon: game-icons:prisoner

 ## 示例文件

-[SSS\_阿卡胡拉丛林.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_阿卡胡拉丛林.json)
-
-[SSS\_多索雷斯在建地块.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_多索雷斯在建地块.json)
+<https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/>
--- a/docs/zh-tw/develop/linux-tutorial.md
+++ b/docs/zh-tw/develop/linux-tutorial.md
@@ -57,7 +57,7 @@ MAA 的構建方法仍在討論中, 本教程的內容可能過時, 請以 [GitH

 ## 集成文件

-[~~或許算不上文件~~](3.1-集成文件.md)
+[~~或許算不上文件~~](../protocol/integration.md)

 ### Python

--- a/docs/zh-tw/develop/overseas-client-adaptation.md
+++ b/docs/zh-tw/develop/overseas-client-adaptation.md
@@ -147,4 +147,4 @@ amplified roi: 426, 272, 177, 201

 ## 提交你的修改

-請參考 [Github Pull Requst 說明](2.2-開發相關.md)
+請參考 [Github Pull Request 說明](../develop/pr-tutorial.md)。
--- a/docs/zh-tw/develop/pr-tutorial.md
+++ b/docs/zh-tw/develop/pr-tutorial.md
@@ -8,7 +8,7 @@ icon: mingcute:git-pull-request-fill

 ::: warning
 本教學中對很多概念進行了簡化，為了讓更多朋友能實際用起來，甚至有一些很不優雅~~但是簡單~~的操作，還有一些不那麽正確的解釋，還請大佬們輕噴。  
-若您有一定的 git 使用經驗及程式基礎，~~那你還看個~~🔨，可以看稍微進階一點的教學 [Github Pull Request 流程簡述](2.2-開發相關.md)
+若您有一定的 git 使用經驗及程式基礎，~~那你還看個~~🔨，可以看稍微進階一點的教學 [Github Pull Request 流程簡述](development.md)
 :::

 ## 基本概念及名詞解釋
--- a/docs/zh-tw/manual/device/linux.md
+++ b/docs/zh-tw/manual/device/linux.md
@@ -10,7 +10,7 @@ icon: teenyicons:linux-alt-solid

 ### 使用 maa-cli

-[maa-cli](https://github.com/MaaAssistantArknights/maa-cli) 是一個使用 Rust 編寫的簡單 MAA 命令列工具。相關安裝與使用教程請閱讀[CLI 使用指南](./1.6-CLI使用說明)。
+[maa-cli](https://github.com/MaaAssistantArknights/maa-cli) 是一個使用 Rust 編寫的簡單 MAA 命令列工具。相關安裝與使用教程請閱讀[CLI 使用指南](../cli)。

 ### 使用 Python

@@ -25,7 +25,7 @@ icon: teenyicons:linux-alt-solid

 ::: tip
 預編譯的版本包含在相對較新的 Linux 發行版 (Ubuntu 22.04) 中編譯的動態庫，如果您系統中的 libstdc++ 版本較老，可能遇到 ABI 不兼容的問題
-可以參考 [2.1-Linux編譯教學](./2.1-Linux編譯教學.md) 重新編譯或使用容器執行
+可以參考 [Linux編譯教學](../../develop/linux-tutorial.md) 重新編譯或使用容器執行
 :::

 #### 2. `adb` 配置
@@ -62,7 +62,7 @@ icon: teenyicons:linux-alt-solid

 #### 3. 任務配置

-自定義任務： 根據需要參考 [3.x 集成文件](https://maa.plus/docs/zh-tw/3.1-%E9%9B%86%E6%88%90%E6%96%87%E4%BB%B6.html) 對 `sample.py` 的 [`# 任務及參數請參考 docs/集成文件.md`](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/722f0ddd4765715199a5dc90ea1bec2940322344/src/Python/sample.py#L54) 一欄進行修改
+自定義任務： 根據需要參考 [集成文件](../../protocol/integration.md) 對 `sample.py` 的 [`# 任務及參數請參考 docs/集成文件.md`](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/722f0ddd4765715199a5dc90ea1bec2940322344/src/Python/sample.py#L54) 一欄進行修改

 ## 模擬器支援

--- a/docs/zh-tw/manual/device/macos.md
+++ b/docs/zh-tw/manual/device/macos.md
@@ -5,7 +5,7 @@ icon: basil:apple-solid
 # Mac 模擬器

 ::: tip
-遇到問題請先參考 [1.2-常見問題](1.2-常見問題.md)
+遇到問題請先參考 [常見問題](../faq.md)
 :::

 ## Apple Silicon 晶片
@@ -48,7 +48,7 @@ icon: basil:apple-solid

 ### ✅ [夜神模擬器](https://www.yeshen.com/)

-完美支援。目前 mac 上 MAAX 版本還不支援模擬器自動適配，需要在 MAA `設定` - `連接設定` 中使用 `adb` 連接 `127.0.0.1:62001` ，注意通訊埠不是預設的 `5555` ，關於模擬器通訊埠的詳細說明，請參考 [常見模擬器 adb 通訊埠](1.2-常見問題.md#常見安卓模擬器adb通訊埠)。
+完美支援。目前 mac 上 MAAX 版本還不支援模擬器自動適配，需要在 MAA `設定` - `連接設定` 中使用 `adb` 連接 `127.0.0.1:62001` ，注意通訊埠不是預設的 `5555` ，關於模擬器通訊埠的詳細說明，請參考 [常見模擬器 adb 通訊埠](../faq.md#常見安卓模擬器adb通訊埠)。

 補充：mac 下夜神模擬器的 adb 二進制檔案的位置為 `/Applications/NoxAppPlayer.app/Contents/MacOS/adb`，在父目錄 `MacOS` 下可使用 `adb devices` 命令查看 adb 通訊埠。

--- a/docs/zh-tw/manual/faq.md
+++ b/docs/zh-tw/manual/faq.md
@@ -49,7 +49,7 @@ icon: ph:question-fill

 ## 連接錯誤

- 提示：請參考 [模擬器支援](1.3-模擬器支援.md) 確定正在使用的模擬器通過了支援性測試。
+- 提示：請參考 [模擬器支援](./device/) 確定正在使用的模擬器通過了支援性測試。
 - 若使用了遊戲加速器等軟體，請關閉軟體並 **重開電腦** 後再次嘗試。
 - 請檢查您的解壓縮軟體 — 部分情況下使用如 `7z` 或 _其他小眾解壓縮軟體_ 會導致 `Minitouch` 相關檔案出錯

@@ -95,7 +95,7 @@ icon: ph:question-fill

 ### 方式 4 : 換模擬器

- 請參考 [模擬器支援](1.3-模擬器支援.md)。
+- 請參考 [模擬器支援](./device/)

 ## 連接正常，但是無操作

@@ -172,7 +172,7 @@ MAA 現在會嘗試從註冊表中讀取 `bluestacks.conf` 的儲存位置，當

 - 若使用了 `異形螢幕 UI 適配`，請將其調整為 0。
 - 若正在遊玩非陸服用戶端，請先在 `設定` - `遊戲設定` - `用戶端類型` 中選擇用戶端版本。非陸服部分功能可能並非完全適配，請參考對應的外服使用文件。
- 若正在進行自動肉鴿，請參考 [文件](1.1-詳細介紹.md#一鍵長草：自動肉鴿)，並在 `任務設定` - `自動肉鴿` - `肉鴿主題` 中正確選擇主題。
+- 若正在進行自動肉鴿，請參考 [文件](./introduction/integrated-strategy.md)，並在 `任務設定` - `自動肉鴿` - `肉鴿主題` 中正確選擇主題。
 - `Adb Input` 觸控模式操作緩慢為正常情況，如需自動戰鬥等請嘗試切換其他模式。

 ### 提示截圖用時較長 / 過長
--- a/docs/zh-tw/protocol/callback-schema.md
+++ b/docs/zh-tw/protocol/callback-schema.md
@@ -5,7 +5,7 @@ icon: material-symbols:u-turn-left
 # 回呼訊息協議

 ::: info 注意
-回呼訊息隨版本更新快速迭代中，本檔案可能過時。如需獲取最新内容可参考 [簡中檔案](../3.2-回调消息协议.md) 或 [C# 集成源碼](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/dev/src/MaaWpfGui/Main/AsstProxy.cs)
+回呼訊息隨版本更新快速迭代中，本檔案可能過時。如需獲取最新内容可参考 [簡中檔案](../../zh-cn/protocol/callback-schema.md) 或 [C# 集成源碼](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/dev/src/MaaWpfGui/Main/AsstProxy.cs)
 :::

 ## 回調函數原型
--- a/docs/zh-tw/protocol/integrated-strategy-schema.md
+++ b/docs/zh-tw/protocol/integrated-strategy-schema.md
@@ -33,44 +33,44 @@ icon: ri:game-fill
    "team_complete_condition": [     //陣容完備度檢測
             ...
        ]
-} 
+}
 ```

 ### 幹員分類

-按照你的遊戲理解將幹員分成不同的 ***groups*** （群組，相關概念參考 [戰鬥流程協議](3.3-戰鬥流程協議.md)）
+按照你的遊戲理解將幹員分成不同的 ***groups*** （群組，相關概念參考 [戰鬥流程協議](../protocol/copilot-schema.md)

 ::: info 注意

  1. 同一 group 內的幹員和召喚物必須部署方式一致（即同為近戰或者同為高台）
-  
+
  2. 允許同一幹員或者召喚物根據用法不同，被分類至不同的 group
-  
+
  3. 請不要修改已經存在的 group 名稱，以免在 MAA 更新時導致之前版本的作業無法使用
-  
+
  4. 請盡量不要新增 group，盡量將新增進作業的單位按照用法納入已經存在的 group

 :::

 ```json
 {
-    "theme": "Phantom",              
+    "theme": "Phantom",
    "priority": [                     // 群組，有序
        {
            "name": "棘刺",           // 群組名（這個群組名是棘刺）
            "opers": [                // 群組包含的幹員，有序，代表部署優先度，
                                      // （比如需要部署該組幹員時，先檢測有沒有棘刺，有棘刺就部署棘刺，沒有棘刺再檢測有沒有號角）
                {
-                    "name": "棘刺",   // 幹員名 
+                    "name": "棘刺",   // 幹員名
                    ...
                },
                {
-                    "name": "號角",                  
+                    "name": "號角",
                    ...
                }
            ]
        },
-       "team_complete_condition": [     
+       "team_complete_condition": [
             ...
        ]
    ]
@@ -80,7 +80,7 @@ icon: ri:game-fill
 1. 已有群組介紹

    以傀影肉鴿的作業為例：主要將幹員分為了
-    | 分組  | 主要考量 | 主要包括職業 | 舉例幹員 |  
+    | 分組  | 主要考量 | 主要包括職業 | 舉例幹員 |
    | :--- | :--- | :--- | :--- |
    | ***地面阻擋***  | 站場和清雜  | 重裝、近衛 | 奶盾、基石、羽毛筆、山、M3、令和稀音的召喚物、斑點、重裝預備幹員 |
    | ***地面單切***  | 單獨對戰精英怪  | 處決者特種 | 史爾特爾、異德、麒麟R夜刀、M3、紅 |
@@ -142,7 +142,7 @@ icon: ri:game-fill
        },
        ...
        ]
-} 
+}
 ```

 ### 調整幹員招募參數
@@ -153,7 +153,7 @@ icon: ri:game-fill

    ```json
    {
-    "theme": "Phantom",              
+    "theme": "Phantom",
    "priority": [
            "name": "地面阻擋",                                // 群組名（這裡是地面阻擋組）
            "doc": "標準線為 1 檔（清雜能力或者站場能力比山強）> 山 > 2 檔（阻擋 >2，可自回）> 斑點，站場能力小於斑點放到單切或者炮灰組",
@@ -171,11 +171,11 @@ icon: ri:game-fill
                    "promote_priority": 600,                  // 進階優先級，數字越大優先級越高，900 以上屬於有希望就精二，400 以下招募優先級低於招募普通三星幹員
                    "is_key": true,                           // true 為 key（關鍵）幹員，false 或省略為非 key 幹員。在陣容完備檢測未通過時，僅招募 key 幹員與 0 希望幹員，保留希望。
                    "is_start": true,                         // true 為開局選擇幹員，false 或省略為非開局幹員。在隊伍中沒有 start 幹員時，僅招募 start 幹員與 0 希望幹員，用戶填寫的幹員會強制為 start 幹員
-                    "promote_priority_when_team_full": 850,   
+                    "promote_priority_when_team_full": 850,
                    "recruit_priority_offsets": [             // 按當前陣容調控招募優先級
                            {
                            "groups": [                       // 需要哪些組滿足條件
-                                "凱爾希",                      
+                                "凱爾希",
                                "地面阻擋",
                                "棘刺"
                            ],
@@ -185,10 +185,10 @@ icon: ri:game-fill
                                                              // （這裡表示當 凱爾希、地面阻擋、棘刺 這三個群組中有2名以上幹員時，百煉嘉維爾的招募優先級減 300）
                        }
                    ]
-                },                   
+                },
             ...
        ],
-    "team_complete_condition": [     
+    "team_complete_condition": [
             ...
        ]
    }
@@ -242,7 +242,7 @@ icon: ri:game-fill
    "replacement_home": [         // 重要防守點（藍門替代點），至少需要填寫 1 個
        {
            "location": [         // 格子坐標，從地圖 wiki 獲得
-                6,           
+                6,
                4
            ],
            "direction_Doc1": "優先朝向，但並不代表絕對是這個方向（算法自行判斷）",
@@ -295,7 +295,7 @@ icon: ri:game-fill

 有時候不需要設定太多的定制策略，完成關鍵步驟後再交給 MAA，兩者結合可能效果更好

-1. 使用各個群組部署幹員  
+1. 使用各個群組部署幹員

    ```json
     "deploy_plan": [ // 部署邏輯，按從上到下、從左到右的順序進行檢索，並嘗試部署找到的第一個幹員，如果沒有就跳過
@@ -305,7 +305,7 @@ icon: ri:game-fill
                "direction": "left"               //將找到的第一個幹員部署到 6,4 這個坐標上並朝向左邊
            },                                    //沒找到就進行下一個部署操作
            {
-                "groups": [ "召喚" ],          
+                "groups": [ "召喚" ],
                "location": [ 6, 3 ],
                "direction": "left"
            },
@@ -315,7 +315,7 @@ icon: ri:game-fill
                "direction": "down"
            }
        ]
-    
+
    ```

 2. 在某個時間點部署幹員
@@ -335,7 +335,7 @@ icon: ri:game-fill
                "groups": [ "異德", "刺客", "擋人先鋒", "其他地面" ],
                "location": [ 5, 3 ],
                "direction": "left",
-                "condition": [ 6, 10 ]  
+                "condition": [ 6, 10 ]
            },
            ...
        ]
@@ -480,7 +480,7 @@ OCR 辨識不期而遇事件，但是選項是操作固定的位置
            "effect": "每有5源石錠，所有我方單位的攻擊速度+7",    //藏品效果
            "no": 167                                          //藏品編號，wiki 可查
        },
-        
+
        ...
        {
            "name": "擴散之手",
@@ -488,7 +488,7 @@ OCR 辨識不期而遇事件，但是選項是操作固定的位置
                "異客"                                         //（這裡表示隊伍中有異客時，遇到擴散之手，就會嘗試購買）
            ],
            "effect": "【擴散術師】、【鏈術師】和【轟擊術師】每對一個單位造成傷害就回覆2點技力值",
-            "no": 136                                          
+            "no": 136
        },
        ...

@@ -498,7 +498,7 @@ OCR 辨識不期而遇事件，但是選項是操作固定的位置
                "WARRIOR"                                      //（這裡表示隊伍中有近衛幹員時，遇到折戟-破釜沈舟，就會嘗試購買）
            ],
            "effect": "所有【近衛】幹員的防禦力-40%，但攻擊力+40%，攻擊速度+30",
-            "no": 16                                           
+            "no": 16
        },
        ...

--- a/docs/zh-tw/protocol/integration.md
+++ b/docs/zh-tw/protocol/integration.md
@@ -96,7 +96,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
 }
 ```

-另支援少部分資源關卡名請參考[集成範例](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/dev/tools/AutoLocalization/example/zh-cn.xaml#L260)
+另支援少部分資源關卡名請參考[集成範例](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/tools/AutoLocalization/example/zh-tw.xaml#L219)

 - `Recruit`  
    公開招募
@@ -245,7 +245,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
 }
 ```

-作業 JSON 請參考 [3.3-戰鬥流程協議](./3.3-戰鬥流程協議.md)
+作業 JSON 請參考 [3.3-戰鬥流程協議](./copilot-schema.md)

 - `SSSCopilot`  
    自動抄保全作業
@@ -258,7 +258,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
 }
 ```

-保全作業 JSON 請參考 [3.7-保全派駐協議](./3.7-保全派駐協議.md)
+保全作業 JSON 請參考 [3.7-保全派駐協議](./sss-schema.md)

 - `Depot`  
    倉庫辨識
--- a/docs/zh-tw/protocol/sss-schema.md
+++ b/docs/zh-tw/protocol/sss-schema.md
@@ -140,6 +140,4 @@ icon: game-icons:prisoner

 ## 範例檔案

-[SSS_阿卡胡拉叢林.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_阿卡胡拉丛林.json)
-
-[SSS_多索雷斯在建地塊.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_多索雷斯在建地块.json)
+<https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/>
--- a/docs/zh-tw/readme.md
+++ b/docs/zh-tw/readme.md
@@ -31,7 +31,7 @@ MAA 的意思是 MAA Assistant Arknights
 ## 亮點功能

 - 刷理智，掉落辨識及上傳 [企鵝物流數據統計](https://penguin-stats.io/)；
- 智能基建換班，自動計算幹員效率，單設施內最優解；同時也支援 [自定義排班](./3.6-基建排班協議.md)；
+- 智能基建換班，自動計算幹員效率，單設施內最優解；同時也支援 [自定義排班](./protocol/base-scheduling-schema.md)；
 - 自動公招，可選使用加急許可，一次全部刷完！公招數據上傳 [企鵝物流數據統計](https://penguin-stats.io/result/stage/recruit/recruit) ， [一圖流](https://ark.yituliu.cn/survey/maarecruitdata) ；
 - 支援手動辨識公招介面，方便對高星公招做出選擇 ~~（你的這個高資回費出的是推王呢還是推王呢）~~
 - 支援辨識幹員列表，統計已有和未有幹員（還能為手動辨識公招介面提供已有潛能數據提示）；
@@ -76,12 +76,12 @@ MAA 的意思是 MAA Assistant Arknights

 ### 基本說明

-1. 請根據 [模擬器支援情況](./1.3-模擬器支援.md)，進行對應的操作。
+1. 請根據 [模擬器支援情況](./manual/device/)，進行對應的操作。
 2. 修改模擬器解析度為 `16:9` 比例，最低 `1280 * 720`，最高 `2K`。  
   對於國際服（美服）玩家，由於介面佈局問題，我們則建議您將解析度修改為 `1920 * 1080`。
 3. 開始使用吧！

-更多使用說明請參考 [詳細介紹](./1.1-詳細介紹.md)
+更多使用說明請參考 [詳細介紹](./manual/introduction/).

 ## 常見問題

@@ -93,7 +93,7 @@ MAA 的意思是 MAA Assistant Arknights
 - 下載到一半提示 “登錄” / “鑒權”
 - 連接正常，任務開始了，但是沒反應

-請參考 [常見問題](./1.2-常見問題.md)
+請參考 [常見問題](./manual/faq.md)

 ## 外服支援

@@ -161,11 +161,11 @@ MAA 的意思是 MAA Assistant Arknights
 2. 使用 Visual Studio 2022 打開 `MAA.sln`，右鍵 `MaaWpfGui`，設為啟動項目
 3. VS 上方配置選擇 `RelWithDebInfo`, `x64` （如果編譯 Release 包 或 ARM 平台，請忽略這步）
 4. 右鍵 `MaaWpfGui` - 屬性 - 偵錯 - 啟用本地偵錯（這樣就能把斷點掛到 C++ Core 那邊了）
-5. （可選）若準備提交 PR，建議啟用 [clang-format 支援](./2.2-開發相關.md#在-visual-studio-中啟用-clang-format)
+5. （可選）若準備提交 PR，建議啟用 [clang-format 支援](./develop/development.md#在-visual-studio-中啟用-clang-format)

 ### Linux | macOS

-請參考 [Linux 編譯教學](./2.1-Linux編譯教學.md)
+請參考 [Linux 編譯教學](./develop/linux-tutorial.md)

 ### API

@@ -177,22 +177,22 @@ MAA 的意思是 MAA Assistant Arknights
 - [Java HTTP 接口](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/src/Java/Readme.md)
 - [Rust 接口](https://github.com/MaaAssistantArknights/MaaAssistantArknights/tree/master/src/Rust/src/maa_sys) ： [HTTP 接口](https://github.com/MaaAssistantArknights/MaaAssistantArknights/tree/master/src/Rust)
 - [TypeScript 接口](https://github.com/MaaAssistantArknights/MaaAsstElectronUI/tree/main/packages/main/coreLoader)
- [集成文件](./3.1-集成文件.md)
- [回呼訊息協議](./3.2-回呼訊息協議.md)
- [任務流程協議](./3.4-任務流程協議.md)
- [自動抄作業協議](./3.3-戰鬥流程協議.md)
+- [集成文件](./protocol/integration.md)
+- [回呼訊息協議](./protocol/callback-schema.md)
+- [任務流程協議](./protocol/task-schema.md)
+- [自動抄作業協議](./protocol/copilot-schema.md)

 ### 外服適配

-請參考 [外服適配教學](./2.5-外服適配教學.md)，對於陸服已支援的功能，絕大部分的外服適配工作僅需要截圖 + 簡單的 JSON 修改即可。
+請參考 [外服適配教學](./develop/overseas-client-adaptation.md)，對於陸服已支援的功能，絕大部分的外服適配工作僅需要截圖 + 簡單的 JSON 修改即可。

 ### 想參與開發，但不太會用 Github?

-[Github Pull Request 流程簡述](./2.2-開發相關.md#github-pull-request-流程簡述)
+[Github Pull Request 流程簡述](./develop/development.md#introduction-to-github-pull-request-flow)

 ### Issue bot

-請參考 [Issue bot 使用方法](./2.3-IssueBot使用方法.md)
+請參考 [Issue bot 使用方法](./develop/issue-bot-usage.md)

 ## 聲明