feat(docs): 文档大升级 (#5885)

+ 迁移到[vuepress-hope](https://theme-hope.vuejs.press/zh/)主题该主题有很多好用的特性，包括但不限于mermaid流程图，charts/echarts图表，更美观的提示卡片等 + 优化的侧边栏和导航栏 + 内置图标支持 + 使用卡片来优化阅读体验 + 修复了jsonc和cpp的高亮问题
2026-07-19 02:23:01 +08:00 · 2023-08-10 09:53:28 +08:00
parent edb7224594
commit 902bcc4a6e
69 changed files with 13690 additions and 3325 deletions
--- a/docs/ko-kr/1.3-에뮬레이터_지원.md
+++ b/docs/ko-kr/1.3-에뮬레이터_지원.md
@@ -20,7 +20,7 @@
    3. MAA를 **종료하고 나서**, `gui.json` 파일을 열고, `Bluestacks.Config.Path` 필드를 추가하세요. 값은 `bluestacks.conf`의 절대 경로로 설정합니다. (백슬래시는 `\\`와 같이 이스케이프되어야 합니다).
    예시: (파일이 `C:\ProgramData\BlueStacks_nxt\bluestacks.conf`에 위치해 있음을 가정함)

-        ```jsonc
+        ```json
        {
            "Configurations": {
                "Default": {
@@ -37,7 +37,7 @@
    `Bluestacks.Config.Keyword` 필드를 추가로 입력해주세요
    예시:

-    ```jsonc
+    ```json
    "Bluestacks.Config.Keyword":"bst.instance.Nougat64.status.adb_port",
    ```

--- a/docs/ko-kr/3.1-연동.md
+++ b/docs/ko-kr/3.1-연동.md
@@ -6,7 +6,7 @@

 #### 프로토타입

-```c++
+```cpp
 TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* params);
 ```

@@ -34,7 +34,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
 - `StartUp <br>`
  게임 시작

-```jsonc
+```json
 // 해당 작업 매개변수
 {
    "enable": bool,              // 이 작업을 활성화할지 여부, 선택 사항, 기본값은 true
@@ -47,7 +47,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
 - `CloseDown <br>`
  게임 종료

-```jsonc
+```json
 // 해당 작업 매개변수
 {
    "enable": bool,              // 이 작업을 활성화할지 여부, 선택 사항, 기본값은 true
@@ -57,7 +57,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
 - `Fight <br>`
  작전

-```jsonc
+```json
 // 해당 작업 매개변수
 {
    "enable": bool,             // 이 작업을 활성화할지 여부, 선택 사항, 기본값은 true
@@ -89,7 +89,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
 - `Recruit <br>`
  공개모집

-```jsonc
+```json
 // 해당 작업 매개변수
 {
    "enable": bool,             // 이 작업을 활성화할지 여부, 선택 사항, 기본값은 true
@@ -125,7 +125,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
 - `Infrast <br>`
  기반시설 교대

-```jsonc
+```json
 {
    "enable": bool,             // 이 작업을 활성화할지 여부, 선택 사항, 기본값은 true
    "mode": int,            // 전환 모드, 선택 사항입니다. 실행 중에는 편집할 수 없습니다.
@@ -152,7 +152,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
  크레딧 수집 및 자동 구매
  "구매 우선 항목" 목록에 따라 순서대로 아이템을 구매하며 "무시 항목"에 있는 항목을 무시하고 크레딧이 넘칠 때까지 다른 항목을 순서대로 구매합니다.

-```jsonc
+```json
 // 해당 작업 매개변수
 {
    "enable": bool,         // 이 작업을 활성화할지 여부, 선택 사항, 기본값은 true
@@ -172,7 +172,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
 - `Award <br>`
  임무 보상 수령

-```jsonc
+```json
 // 해당 작업 매개변수
 {
    "enable": bool          // 이 작업을 활성화할지 여부, 선택 사항, 기본값은 true
@@ -182,7 +182,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
 - `Roguelike <br>`
  통합전략

-```jsonc
+```json
 {
    "enable": bool,         // 이 작업을 활성화할지 여부, 선택 사항, 기본값은 true
    "theme": string,        // 테마 이름, 선택 사항, 기본값은 "Phantom"입니다.
@@ -211,7 +211,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
 - `Copilot <br>`
  Copilot 기반 자동 전투 기능

-```jsonc
+```json
 {
    "enable": bool,             // 이 작업을 활성화할지 여부, 선택 사항, 기본값은 true
    "filename": string,         // 작업 JSON의 파일명과 경로, 절대/상대 경로를 지원합니다. 실행 중에 편집할 수 없습니다.
@@ -224,7 +224,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
 - `SSSCopilot <br>`
  보안파견용 AI 동반(Copilot 기반) 자동 전투 기능

-```jsonc
+```json
 {
    "enable": bool,             // 이 작업을 활성화할지 여부, 선택 사항, 기본값은 true
    "filename": string,         // 작업 JSON의 파일명과 경로, 절대/상대 경로를 지원합니다. 실행 중에 편집할 수 없습니다.
@@ -237,7 +237,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
 - `Depot`
  창고 인식

-```jsonc
+```json
 // 해당 작업 매개변수
 {
    "enable": bool          // 이 작업을 활성화할지 여부, 선택 사항, 기본값은 true
@@ -247,7 +247,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
 - `OperBox <br>`
  오퍼레이터 보유 목록 인식 결과

-```jsonc
+```json
 // 해당 작업 매개변수
 {
    "enable": bool          // 이 작업을 활성화할지 여부, 선택 사항, 기본값은 true
@@ -257,7 +257,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
 - `ReclamationAlgorithm <br>`
  생명연산

-```jsonc
+```json
 {
    "enable": bool,
    "mode": int             // 모드，선택사항, 기본값은 0
@@ -270,7 +270,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p

  사용자 정의 태스크

-```jsonc
+```json
 {
    "enable": bool,
    "task_names": [     // 배열에서 첫 번째 일치하는 항목부터 실행 (이후 next 등 순차적으로 진행)
@@ -285,7 +285,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p

  단일 단계 태스크 (현재로서는 Copilot만 지원)

-```jsonc
+```json
 {
    "enable": bool,
    "type": string,     // 현재로서는 "copilot"만 지원합니다.
@@ -304,7 +304,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p

  비디오 인식, 현재로서는 전투 비디오만 지원합니다.

-```jsonc
+```json
 {
    "enable": bool,
    "filename": string,
@@ -315,7 +315,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p

 #### 프로토타입

-```c++
+```cpp
 bool ASSTAPI AsstSetTaskParams(AsstHandle handle, TaskId id, const char* params);
 ```

@@ -342,7 +342,7 @@ bool ASSTAPI AsstSetTaskParams(AsstHandle handle, TaskId id, const char* params)

 #### 프로토타입

-```c++
+```cpp
 bool ASSTAPI AsstSetStaticOption(AsstStaticOptionKey key, const char* value);
 ```

@@ -370,7 +370,7 @@ bool ASSTAPI AsstSetStaticOption(AsstStaticOptionKey key, const char* value);

 #### 프로토타입

-```c++
+```cpp
 bool ASSTAPI AsstSetInstanceOption(AsstHandle handle, AsstInstanceOptionKey key, const char* value);
 ```

@@ -394,7 +394,7 @@ bool ASSTAPI AsstSetInstanceOption(AsstHandle handle, AsstInstanceOptionKey key,

 ##### 키와 값 목록

-```jsonc
+```json
    enum InstanceOptionKey
    {
        Invalid = 0,
--- a/docs/ko-kr/3.2-콜백_스키마.md
+++ b/docs/ko-kr/3.2-콜백_스키마.md
@@ -4,7 +4,7 @@

 ## 프로토타입

-```c++
+```cpp
 typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom_arg);
 ```

@@ -13,7 +13,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
 - `int msg <br>`
  메시지 유형입니다.

-  ```c++
+  ```cpp
  enum class AsstMsg
  {
      /* 전역 정보 */
@@ -49,7 +49,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom

 ### InitFailed

-```jsonc
+```json
 {
    "what": string,     // 오류 유형
    "why": string,      // 오류 원인
@@ -59,7 +59,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom

 ### ConnectionInfo

-```jsonc
+```json
 {
    "what": string,     // 정보 유형
    "why": string,      // 정보 원인
@@ -97,7 +97,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom

 ### AsyncCallInfo

-```jsonc
+```json
 {
    "uuid": string,             // UUID
    "what": string,             // 호출 유형, "Connect" | "Click" | "Screencap" | ...
@@ -111,7 +111,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom

 ### AllTasksCompleted

-```jsonc
+```json
 {
    "taskchain": string,            // 마지막 태스크 체인
    "uuid": string,                 // UUID
@@ -161,7 +161,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom

 ### TaskChain과 관련된 정보

-```jsonc
+```json
 {
    "taskchain": string,            // 현재 Task Chain
    "taskid": int,                  // 현재 Task ID
@@ -175,7 +175,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom

 ### SubTask와 관련된 정보

-```jsonc
+```json
 {
    "subtask": string,             // 서브태스크 이름
    "class": string,               // 서브태스크 클래스
@@ -189,7 +189,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
 #### 자주 사용되는 `subtask` 필드 값

 - `ProcessTask <br>`
-  ```jsonc
+  ```json
  // 상세 정보에 대한 예시
  {
      "task": "StartButton2",     // 태스크 이름
@@ -251,7 +251,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom

 ### SubTaskExtraInfo

-```jsonc
+```json
 {
    "taskchain": string,           // 현재 Task Chain
    "class": string,               // 서브태스크 클래스
@@ -266,7 +266,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
 - `StageDrops <br>`
  스테이지 드롭 정보

-  ```jsonc
+  ```json
  // 상세 정보에 대한 예시
  {
      "drops": [              // 획득한 아이템들
@@ -313,7 +313,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
 - `RecruitTagsDetected <br>`
  공개모집 태그 감지

-  ```jsonc
+  ```json
  // 상세 정보에 대한 예시
  {
      "tags": [
@@ -338,7 +338,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
 - `RecruitResult <br>`
  공개모집 결과

-  ```jsonc
+  ```json
  // 상세 정보에 대한 예시
  {
      "tags": [                   // 모든 태그들, 반드시 5개여야 함
@@ -414,7 +414,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
 - `RecruitTagsRefreshed <br>`
  공개모집 태그 갱신 완료

-  ```jsonc
+  ```json
  // 상세 정보에 대한 예시
  {
      "count": 1,               // 갱신된 슬롯의 횟수
@@ -424,7 +424,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
 - `RecruitTagsSelected <br>`
  공개모집 태그 선택 완료

-  ```jsonc
+  ```json
  // 상세 정보에 대한 예시
  {
      "tags": [
@@ -440,7 +440,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
 - `EnterFacility <br>`
  기반시설 입장

-  ```jsonc
+  ```json
  // 상세 정보에 대한 예시
  {
      "facility": "Mfg",  // 시설 이름
@@ -450,7 +450,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
 - `NotEnoughStaff <br>`
  사용 가능한 오퍼레이터가 부족함

-  ```jsonc
+  ```json
  // 상세 정보에 대한 예시
  {
      "facility": "Mfg",  // 시설 이름
@@ -460,7 +460,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
 - `ProductOfFacility <br>`
  시설의 생산물

-  ```jsonc
+  ```json
  // 상세 정보에 대한 예시
  {
      "product": "Money", // 생산물
@@ -471,7 +471,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
 - `StageInfo <br>`
  자동 전투 스테이지 정보

-  ```jsonc
+  ```json
  // 상세 정보에 대한 예시
  {
      "name": string  // 스테이지 이름
@@ -482,7 +482,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
 - `PenguinId <br>`
  PenguinStats ID

-  ```jsonc
+  ```json
  // 상세 정보에 대한 예시
  {
      "id": string
@@ -491,7 +491,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
 - `DepotInfo <br>`
  창고 인식 결과

-  ```jsonc
+  ```json
  // 상세 정보에 대한 예시
  // ArkPlanner 포맷만 지원합니다. 더 많은 포맷이 나중에 지원될 수 있습니다.
  "arkplanner": {
@@ -532,7 +532,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
 - `OperBoxInfo <br>`
  오퍼레이터 보유 목록 인식 결과

-  ```jsonc
+  ```json
  // 상세 정보에 대한 예시
  "done": bool,       // 인식 완료 여부, false는 아직 진행 중임을 의미합니다 (진행 중인 데이터)
  "all_oper": [
--- a/docs/ko-kr/3.3-전투_스키마.md
+++ b/docs/ko-kr/3.3-전투_스키마.md
@@ -4,7 +4,7 @@

 ## 개요

-```jsonc
+```json
 {
    "stage_name": "暴君",           // 스테이지 이름, 필수 입력 항목입니다. 레벨, 코드, stageId, levelId 등 중복되지 않는 중국어 이름이면 어떤 것이든 사용 가능합니다.
    "opers": [                      // 오퍼레이터 목록
--- a/docs/ko-kr/3.4-작업_스키마.md
+++ b/docs/ko-kr/3.4-작업_스키마.md
@@ -4,7 +4,7 @@

 ## 개요

-```jsonc
+```json
 {
    "작업이름": {                          // 작업 이름

--- a/docs/ko-kr/3.5-통합전략_스키마.md
+++ b/docs/ko-kr/3.5-통합전략_스키마.md
@@ -4,7 +4,7 @@

 ## 개요

-```jsonc
+```json
 [
    {
        "stage_name": "驯兽小屋",       // 스테이지 이름, 필수 항목
--- a/docs/ko-kr/3.6-기반시설_예약_스키마.md
+++ b/docs/ko-kr/3.6-기반시설_예약_스키마.md
@@ -10,7 +10,7 @@

 ## 완전한 필드 목록

-```jsonc
+```json
 {
    "title": "小号的换班方案",       // 구성 제목, 선택 사항
    "description": "哈哈哈哈",       // 구성 설명, 선택 사항
--- a/docs/ko-kr/3.7-보안파견_스키마.md
+++ b/docs/ko-kr/3.7-보안파견_스키마.md
@@ -4,7 +4,7 @@

 **주의: JSON 형식은 주석을 지원하지 않으므로 아래의 예시에서 주석은 제거해주시기 바랍니다.**

-```jsonc
+```json
 {
    "type": "SSS",                         // 프로토콜 유형, SSS는 보안파견 의미함, 필수, 변경 불가
    "stage_name": "多索雷斯在建地块",       // 구역 위치의 이름(도솔레스 건설부지), 필수