feat: 增加从 GitHub 直接获取资源文件的方式，并优先尝试从 GitHub 获取

github raw 没有 dynamic_list.txt

.clang-format

@@ -1,35 +1,45 @@
+# https://clang.llvm.org/docs/ClangFormatStyleOptions.html
+# for clang-format 17.0.1
 Language: Json
-ColumnLimit: 1000
 IndentWidth: 4
 ---
 Language: Cpp
-AccessModifierOffset: -4
-AlignAfterOpenBracket: Align
+BasedOnStyle: 'WebKit'
+# AccessModifierOffset: 2
+AlignAfterOpenBracket: 'AlwaysBreak'
 AlignArrayOfStructures: None
-AlignConsecutiveMacros: None
 AlignConsecutiveAssignments: None
 AlignConsecutiveBitFields: None
 AlignConsecutiveDeclarations: None
+AlignConsecutiveMacros: None
+# AlignConsecutiveShortCaseStatements: None
 AlignEscapedNewlines: Left
 AlignOperands: Align
-AlignTrailingComments: true
-AllowAllArgumentsOnNextLine: true
-AllowAllParametersOfDeclarationOnNextLine: true
-AllowShortEnumsOnASingleLine: false
-AllowShortBlocksOnASingleLine: Empty
+AlignTrailingComments:
+  Kind: Always
+  OverEmptyLines: 1
+AllowAllArgumentsOnNextLine: false
+AllowAllParametersOfDeclarationOnNextLine: false
+AllowShortBlocksOnASingleLine: Never
 AllowShortCaseLabelsOnASingleLine: false
-AllowShortFunctionsOnASingleLine: Inline
-AllowShortLambdasOnASingleLine: All
-AllowShortIfStatementsOnASingleLine: WithoutElse
+# AllowShortCompoundRequirementOnASingleLine: true
+AllowShortEnumsOnASingleLine: false
+AllowShortFunctionsOnASingleLine: InlineOnly
+AllowShortIfStatementsOnASingleLine: Never
+AllowShortLambdasOnASingleLine: Inline
 AllowShortLoopsOnASingleLine: false
 AlwaysBreakAfterDefinitionReturnType: None
 AlwaysBreakAfterReturnType: None
-AlwaysBreakBeforeMultilineStrings: false
-AlwaysBreakTemplateDeclarations: true
-AttributeMacros:
-  - __capability
-BinPackArguments: true
-BinPackParameters: true
+AlwaysBreakBeforeMultilineStrings: true
+AlwaysBreakTemplateDeclarations: Yes
+# AttributeMacros:
+#   - __pragma
+#   - _Pragma
+#   - __attribute__
+#   - __declspec
+BinPackArguments: false
+BinPackParameters: false
+BitFieldColonSpacing: After
 BraceWrapping:
   AfterCaseLabel: false
   AfterClass: true
@@ -37,159 +47,147 @@ BraceWrapping:
   AfterEnum: true
   AfterFunction: true
   AfterNamespace: true
-  AfterObjCDeclaration: true
+  # AfterObjCDeclaration: true
   AfterStruct: true
-  AfterUnion: false
+  AfterUnion: true
   AfterExternBlock: true
   BeforeCatch: true
   BeforeElse: true
   BeforeLambdaBody: false
   BeforeWhile: false
   IndentBraces: false
-  SplitEmptyFunction: false
-  SplitEmptyRecord: false
-  SplitEmptyNamespace: false
-BreakBeforeBinaryOperators: None
-BreakBeforeConceptDeclarations: true
+  SplitEmptyFunction: true
+  SplitEmptyRecord: true
+  SplitEmptyNamespace: true
+# BracedInitializerIndentWidth: 4
+BreakAfterAttributes: Never
+BreakAfterJavaFieldAnnotations: true
+BreakArrays: true
+BreakBeforeBinaryOperators: NonAssignment
 BreakBeforeBraces: Custom
-BreakBeforeInheritanceComma: false
-BreakInheritanceList: BeforeColon
+BreakBeforeConceptDeclarations: Always
+BreakBeforeInlineASMColon: OnlyMultiline
 BreakBeforeTernaryOperators: true
-BreakConstructorInitializersBeforeComma: false
-BreakConstructorInitializers: BeforeColon
-BreakAfterJavaFieldAnnotations: false
+BreakConstructorInitializers: BeforeComma
+BreakInheritanceList: BeforeComma
 BreakStringLiterals: true
-ColumnLimit: 120
-CommentPragmas: '^ IWYU pragma:'
-QualifierAlignment: Leave
+ColumnLimit: 100
+# CommentPragmas: '^ MEO pragma:'
 CompactNamespaces: false
 ConstructorInitializerIndentWidth: 4
 ContinuationIndentWidth: 4
 Cpp11BracedListStyle: false
-DeriveLineEnding: true
 DerivePointerAlignment: false
 DisableFormat: false
 EmptyLineAfterAccessModifier: Never
 EmptyLineBeforeAccessModifier: LogicalBlock
-ExperimentalAutoDetectBinPacking: false
-PackConstructorInitializers: BinPack
-BasedOnStyle: ''
-ConstructorInitializerAllOnOneLineOrOnePerLine: false
-AllowAllConstructorInitializersOnNextLine: true
+# ExperimentalAutoDetectBinPacking: true
 FixNamespaceComments: true
-ForEachMacros:
-  - foreach
-  - Q_FOREACH
-  - BOOST_FOREACH
-IfMacros:
-  - KJ_IF_MAYBE
+# ForEachMacros:
+#   - foreach
+#   - Q_FOREACH
+#   - BOOST_FOREACH
+# IfMacros: 
+#   - 'KJ_IF_MAYBE'
 IncludeBlocks: Preserve
-IncludeCategories:
-  - Regex: '^"(llvm|llvm-c|clang|clang-c)/'
-    Priority: 2
-    SortPriority: 0
-    CaseSensitive: false
-  - Regex: '^(<|"(gtest|gmock|isl|json)/)'
-    Priority: 3
-    SortPriority: 0
-    CaseSensitive: false
-  - Regex: '.*'
-    Priority: 1
-    SortPriority: 0
-    CaseSensitive: false
-IncludeIsMainRegex: '(Test)?$'
-IncludeIsMainSourceRegex: ''
+# IncludeCategories:
+# IncludeIsMainRegex: 
+# IncludeIsMainSourceRegex: 
 IndentAccessModifiers: false
-IndentCaseLabels: false
 IndentCaseBlocks: false
-IndentGotoLabels: true
-IndentPPDirectives: None
+IndentCaseLabels: false
 IndentExternBlock: AfterExternBlock
+IndentGotoLabels: false
+IndentPPDirectives: None
 IndentRequiresClause: false
 IndentWidth: 4
-IndentWrappedFunctionNames: false
-InsertTrailingCommas: None
-JavaScriptQuotes: Leave
-JavaScriptWrapImports: true
-KeepEmptyLinesAtTheStartOfBlocks: true
+IndentWrappedFunctionNames: true
+InsertBraces: true
+InsertNewlineAtEOF: true
+InsertTrailingCommas: Wrapped
+IntegerLiteralSeparator:
+  Binary: 4
+  BinaryMinDigits: 9
+  Decimal: 3
+  DecimalMinDigits: 7
+  Hex: -1
+# JavaImportGroups:
+# JavaScriptQuotes:
+# JavaScriptWrapImports:
+KeepEmptyLinesAtEOF: true
+KeepEmptyLinesAtTheStartOfBlocks: false
 LambdaBodyIndentation: Signature
-MacroBlockBegin: ''
-MacroBlockEnd: ''
+# LineEnding: LF
+# MacroBlockBegin: "MAA.*_NS_BEGIN$"
+# MacroBlockEnd: "MAA.*_NS_END$"
+# Macros:
 MaxEmptyLinesToKeep: 1
-NamespaceIndentation: All
-ObjCBinPackProtocolList: Auto
-ObjCBlockIndentWidth: 2
-ObjCBreakBeforeNestedBlockParam: true
-ObjCSpaceAfterProperty: false
-ObjCSpaceBeforeProtocolList: true
-PenaltyBreakAssignment: 2
-PenaltyBreakBeforeFirstCallParameter: 19
-PenaltyBreakComment: 300
-PenaltyBreakFirstLessLess: 120
-PenaltyBreakOpenParenthesis: 0
-PenaltyBreakString: 1000
-PenaltyBreakTemplateDeclaration: 10
-PenaltyExcessCharacter: 1000000
-PenaltyReturnTypeOnItsOwnLine: 1000
-PenaltyIndentedWhitespace: 0
+NamespaceIndentation: None
+# NamespaceMacros:
+# ObjCBinPackProtocolList:
+# ObjCBlockIndentWidth:
+# ObjCBreakBeforeNestedBlockParam:
+# ObjCSpaceAfterProperty:
+# ObjCSpaceBeforeProtocolList:
+PackConstructorInitializers: Never
+# PenaltyBreakAssignment: 
+# PenaltyBreakBeforeFirstCallParameter:
+# PenaltyBreakComment:
+# PenaltyBreakFirstLessLess:
+# PenaltyBreakOpenParenthesis:
+# PenaltyBreakTemplateDeclaration:
+# PenaltyExcessCharacter:
+# PenaltyIndentedWhitespace:
+# PenaltyReturnTypeOnItsOwnLine:
 PointerAlignment: Left
-PPIndentWidth: -1
-ReferenceAlignment: Pointer
+# QualifierAlignment: Custom
+# QualifierOrder:
+#  - inline
+#  - static
+#  - const
+#  - constexpr
+#  - type
+ReferenceAlignment: Left
 ReflowComments: true
 RemoveBracesLLVM: false
+RemoveParentheses: Leave
+RemoveSemicolon: false
 RequiresClausePosition: OwnLine
-SeparateDefinitionBlocks: Leave
-ShortNamespaceLines: 50
+RequiresExpressionIndentation: OuterScope
+SeparateDefinitionBlocks: Always
+ShortNamespaceLines: 1000
 SortIncludes: CaseSensitive
-SortJavaStaticImport: Before
-SortUsingDeclarations: true
+# SortJavaStaticImport:
+SortUsingDeclarations: Lexicographic
 SpaceAfterCStyleCast: false
 SpaceAfterLogicalNot: false
 SpaceAfterTemplateKeyword: true
+SpaceAroundPointerQualifiers: Default
 SpaceBeforeAssignmentOperators: true
 SpaceBeforeCaseColon: false
 SpaceBeforeCpp11BracedList: true
 SpaceBeforeCtorInitializerColon: true
-SpaceBeforeInheritanceColon: true
+SpaceBeforeJsonColon: false
 SpaceBeforeParens: ControlStatements
-SpaceBeforeParensOptions:
-  AfterControlStatements: true
-  AfterForeachMacros: true
-  AfterFunctionDefinitionName: false
-  AfterFunctionDeclarationName: false
-  AfterIfMacros: true
-  AfterOverloadedOperator: false
-  AfterRequiresInClause: true
-  AfterRequiresInExpression: true
-  BeforeNonEmptyParentheses: false
-SpaceAroundPointerQualifiers: Default
+# SpaceBeforeParensOptions:
 SpaceBeforeRangeBasedForLoopColon: true
+SpaceBeforeSquareBrackets: false
 SpaceInEmptyBlock: false
 SpaceInEmptyParentheses: false
 SpacesBeforeTrailingComments: 1
 SpacesInAngles: Never
-SpacesInConditionalStatement: false
 SpacesInContainerLiterals: true
-SpacesInCStyleCastParentheses: false
 SpacesInLineCommentPrefix:
   Minimum: 1
   Maximum: -1
-SpacesInParentheses: false
+SpacesInParens: Never
 SpacesInSquareBrackets: false
-SpaceBeforeSquareBrackets: false
-BitFieldColonSpacing: Both
 Standard: c++20
-StatementAttributeLikeMacros:
-  - Q_EMIT
-StatementMacros:
-  - Q_UNUSED
-  - QT_REQUIRE_VERSION
+# StatementAttributeLikeMacros: 
+# StatementMacros:
 TabWidth: 4
-UseCRLF: false
+# TypeNames:
+# TypenameMacros:
 UseTab: Never
-WhitespaceSensitiveMacros:
-  - STRINGIZE
-  - PP_STRINGIZE
-  - BOOST_PP_STRINGIZE
-  - NS_SWIFT_NAME
-  - CF_SWIFT_NAME
+# VerilogBreakBetweenInstancePorts:
+# WhitespaceSensitiveMacros:

.devcontainer/devcontainer.json

@@ -0,0 +1,16 @@
+{
+    "image": "mcr.microsoft.com/devcontainers/cpp:ubuntu-22.04",
+    "features": {
+        "ghcr.io/devcontainers/features/python:1": {},
+        "ghcr.io/devcontainers/features/sshd:1": {}
+    },
+    "postCreateCommand": "sudo sh -ce 'apt update && apt install g++-12 -y && echo export CC=gcc-12 CXX=g++-12 >> /etc/profile.d/set-compiler.sh'",
+    "customizations": {
+        "vscode": {
+            "extensions": [
+                "llvm-vs-code-extensions.vscode-clangd",
+                "DavidAnson.vscode-markdownlint"
+            ]
+        }
+    }
+}

.editorconfig

@@ -10,72 +10,3 @@ end_of_line = lf
 [*.json]
 
 indent_size = 4
-
-[*.{c++,cc,cpp,cppm,cxx,h,h++,hh,hpp,hxx,inl,ipp,ixx,tlh,tli}]
-
-indent_size = 4
-
-# Visual C++ Code Style settings
-
-cpp_generate_documentation_comments = xml
-
-# Visual C++ Formatting settings
-
-cpp_indent_braces = false
-cpp_indent_multi_line_relative_to = innermost_parenthesis
-cpp_indent_within_parentheses = indent
-cpp_indent_preserve_within_parentheses = true
-cpp_indent_case_contents = true
-cpp_indent_case_labels = false
-cpp_indent_case_contents_when_block = false
-cpp_indent_lambda_braces_when_parameter = true
-cpp_indent_goto_labels = one_left
-cpp_indent_preprocessor = leftmost_column
-cpp_indent_access_specifiers = false
-cpp_indent_namespace_contents = true
-cpp_indent_preserve_comments = false
-cpp_new_line_before_open_brace_namespace = new_line
-cpp_new_line_before_open_brace_type = new_line
-cpp_new_line_before_open_brace_function = new_line
-cpp_new_line_before_open_brace_block = same_line
-cpp_new_line_before_open_brace_lambda = same_line
-cpp_new_line_scope_braces_on_separate_lines = false
-cpp_new_line_close_brace_same_line_empty_type = false
-cpp_new_line_close_brace_same_line_empty_function = false
-cpp_new_line_before_catch = true
-cpp_new_line_before_else = true
-cpp_new_line_before_while_in_do_while = false
-cpp_space_before_function_open_parenthesis = remove
-cpp_space_within_parameter_list_parentheses = false
-cpp_space_between_empty_parameter_list_parentheses = false
-cpp_space_after_keywords_in_control_flow_statements = true
-cpp_space_within_control_flow_statement_parentheses = false
-cpp_space_before_lambda_open_parenthesis = false
-cpp_space_within_cast_parentheses = false
-cpp_space_after_cast_close_parenthesis = false
-cpp_space_within_expression_parentheses = false
-cpp_space_before_block_open_brace = true
-cpp_space_between_empty_braces = false
-cpp_space_before_initializer_list_open_brace = false
-cpp_space_within_initializer_list_braces = true
-cpp_space_preserve_in_initializer_list = true
-cpp_space_before_open_square_bracket = false
-cpp_space_within_square_brackets = false
-cpp_space_before_empty_square_brackets = false
-cpp_space_between_empty_square_brackets = false
-cpp_space_group_square_brackets = true
-cpp_space_within_lambda_brackets = false
-cpp_space_between_empty_lambda_brackets = false
-cpp_space_before_comma = false
-cpp_space_after_comma = true
-cpp_space_remove_around_member_operators = true
-cpp_space_before_inheritance_colon = true
-cpp_space_before_constructor_colon = true
-cpp_space_remove_before_semicolon = true
-cpp_space_after_semicolon = false
-cpp_space_remove_around_unary_operator = true
-cpp_space_around_binary_operator = insert
-cpp_space_around_assignment_operator = insert
-cpp_space_pointer_reference_alignment = left
-cpp_space_around_ternary_operator = insert
-cpp_wrap_preserve_blocks = one_liners

.github/ISSUE_TEMPLATE/cn-bug-report.yaml

@@ -9,15 +9,29 @@ body:
       options:
       - label: 我理解 Issue 是用于反馈和解决问题的，而非吐槽评论区，将尽可能提供更多信息帮助问题解决
         required: true
-      - label: 我填写了简短且清晰明确的标题，以便开发者在翻阅 issue 列表时能快速确定大致问题。而不是“一个建议”、“卡住了”等
+      - label: 我填写了简短且清晰明确的标题，以便开发者在翻阅 Issue 列表时能快速确定大致问题。而不是“一个建议”、“卡住了”等
         required: true
-      - label: 我已查看最新测试版本的更新内容，并未提及该 bug 已被修复的情况
+      - label: 我已查看最新测试版本的更新内容，并未提及该 Bug 已被修复的情况
+        required: true
+      - label: 我已检查了置顶议题（pinned issue），确认我的问题未被提及
         required: true
   - type: textarea
     id: describe
     attributes:
       label: 问题描述
-      description: 尽可能详细描述你的问题
+      description: 描述问题时请尽可能详细
+    validations:
+      required: true
+  - type: textarea
+    id: version
+    attributes:
+      label: Version
+      description: >-
+        请提供 MAA 版本。可在 MAA -> 设置 -> 软件更新中找到（点击图标可复制）。
+      placeholder: |
+        Resource Version:
+        UI Version:
+        Core Version:
     validations:
       required: true
   - type: textarea
@@ -25,7 +39,7 @@ body:
     attributes:
       label: 日志文件
       description: |
-        **上传 `debug` 文件夹中的 `asst.log` 和 `gui.log` 日志文件，并说明问题出现的大致时间点**
+        **请在关闭MAA后，上传 `debug` 文件夹中的 `asst.log` 和 `gui.log` 日志文件，并说明问题出现的大致时间点**
         **请直接将完整的文件拖拽进来，而非自己裁切或复制的片段；若文件体积过大可压缩后再上传**
     validations:
       required: true

.github/ISSUE_TEMPLATE/cn-feature-request.yaml

@@ -7,9 +7,9 @@ body:
     attributes:
       label: 在提问之前...
       options:
-      - label: 我填写了简短且清晰明确的标题，以便开发者在翻阅 issue 列表时能快速确定大致问题。而不是“一个建议”、“卡住了”等
+      - label: 我填写了简短且清晰明确的标题，以便开发者在翻阅 Issue 列表时能快速确定大致问题。而不是“一个建议”、“卡住了”等
         required: true
-      - label: 我基本确定这是一个新功能/建议，而不是遇到了 bug（不确定的话请附上日志）
+      - label: 我基本确定这是一个新功能/建议，而不是遇到了 Bug（不确定的话请附上日志）
         required: true
   - type: textarea
     id: describe

.github/ISSUE_TEMPLATE/cn-mumu-report.yaml

@@ -0,0 +1,81 @@
+name: MuMu 截图增强反馈（使用中文）
+description: 有关 MuMu 截图增强功能的集中反馈
+labels: ['mumu api']
+body:
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: 在提问之前...
+      options:
+      - label: 我理解 Issue 是用于反馈和解决问题的，而非吐槽评论区，将尽可能提供更多信息帮助问题解决
+        required: true
+      - label: 我填写了简短且清晰明确的标题，以便开发者在翻阅 Issue 列表时能快速确定大致问题。而不是“一个建议”、“卡住了”等
+        required: true
+      - label: 我已检查了置顶议题（Pinned Issue），确认我的问题未被提及
+        required: true
+      - label: 我正在使用最新的 MAA 内测版本和最新的**官版** MuMu 模拟器
+        required: true
+      - label: 我已参考文档确定安装路径、实例编号、屏幕编号填写正确，并确认在关闭截图增强模式后问题消失
+        required: true
+      - label: 我未开启高帧率模式，且显存使用策略为“画面表现更好”
+        required: false
+      - label: 我正在使用后台保活功能，并确定该问题仅在开启后台保活时出现
+        required: false
+  - type: textarea
+    id: describe
+    attributes:
+      label: 问题描述
+      description: 描述问题时请尽可能详细
+    validations:
+      required: true
+  - type: textarea
+    id: version
+    attributes:
+      label: Version
+      description: >-
+        请提供 MAA 版本和 MuMu 版本。MAA 版本可在 MAA -> 设置 -> 软件更新中找到（点击图标可复制）。MuMu 版本可在右上角菜单按钮 -> 关于 MuMu 中找到。
+      placeholder: |
+        Resource Version: 
+        UI Version: 
+        Core Version: 
+        MuMu 版本号: 
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: MAA 日志文件
+      description: |
+        **上传 `debug` 文件夹中的 `asst.log` 和 `gui.log` 日志文件，并说明问题出现的大致时间点**
+        **请直接将完整的文件拖拽进来，而非自己裁切或复制的片段；若文件体积过大可压缩后再上传**
+    validations:
+      required: true
+  - type: textarea
+    id: mumulogs
+    attributes:
+      label: MuMu 问题诊断
+      description: |
+        **在 MuMu 右上角菜单按钮 -> 问题诊断 中点击 复制配置信息，并将全部内容粘贴进来。**
+        **注意隐去 电脑出口IP地址 等以保护个人隐私**
+    validations:
+      required: true
+  - type: textarea
+    id: screenshots
+    attributes:
+      label: 截图
+      description: |
+        如果有，添加屏幕截图以帮助解释你的问题，包括但不限于 MAA 软件截图、游戏画面截图
+        若是**识别相关问题**，请尽可能提供模拟器自带的截图工具截取的无遮挡的**原图**（或通过 adb 截取原图）
+        用其他的工具（如QQ）截取的图片包含窗口边框，不利于我们排除bug
+        `debug` 文件夹下有一些自动截图的错误图片，若有相关的，请一并打包上传
+    validations:
+      required: false
+  - type: textarea
+    id: others
+    attributes:
+      label: 还有别的吗？
+      description: |
+        操作系统？相关的配置？链接？参考资料？
+        任何能让我们对你所遇到的问题有更多了解的东西
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/cn-others.yaml

@@ -1,5 +1,5 @@
 name: 其他议题（使用中文）
-description: 提出问题，而不是 bug 反馈或需求建议
+description: 提出问题，而不是 Bug 反馈或需求建议
 labels: ['question']
 body:
   - type: textarea

.github/ISSUE_TEMPLATE/en-bug-report.yaml

@@ -24,11 +24,27 @@ body:
           I have checked the latest beta update and there is no mention
           of the bug being fixed.
         required: true
+      - label: >-
+          I have reviewed the pinned issues and confirmed that my issue
+          is not mentioned.
+        required: true
   - type: textarea
     id: describe
     attributes:
       label: Description
-      description: Describe your problem in as much detail as possible.
+      description: Please provide a detailed description of your issue.
+    validations:
+      required: true
+  - type: textarea
+    id: version
+    attributes:
+      label: Version
+      description: >-
+        Please provide the MAA version. Can be found in MAA -> Settings -> Update. (Click to copy)
+      placeholder: |
+        Resource Version:
+        UI Version:
+        Core Version:
     validations:
       required: true
   - type: textarea
@@ -36,7 +52,7 @@ body:
     attributes:
       label: Log files
       description: >-
-        **Upload the `asst.log` and `gui.log` log file in the `debug` folder and**
+        **After closing the MAA, upload the `asst.log` and `gui.log` log file in the `debug` folder and**
         **indicate the approximate point in time when the problem occurred.**
 
         **Please drag and drop the full file in, not your own cuttings or copies;**

.github/issue-checker.yml

@@ -5,85 +5,118 @@ labels:
 # <!-- [Ss]kip `LABEL` --> 跳过一个 label
 # <!-- [Rr]emove `LABEL` --> 去掉一个 label
 
-# skip and remove
+# skips and removes
 - name: skip all
   content:
   regexes: '[Ss]kip (?:[Aa]ll |)[Ll]abels?'
 - name: remove all
   content:
   regexes: '[Rr]emove (?:[Aa]ll |)[Ll]abels?'
+
 - name: skip module
   content:
   regexes: '[Ss]kip [Mm]odule [Ll]abels?'
 - name: remove module
   content:
   regexes: '[Rr]emove [Mm]odule [Ll]abels?'
-- name: skip client
-  content:
-  regexes: '[Ss]kip [Cc]lient [Ll]abels?'
-- name: remove client
-  content:
-  regexes: '[Rr]emove [Cc]lient [Ll]abels?'
 - name: skip copilot
   content:
-  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)(?:module: |)copilot(?:`|)'
+  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)(?:[Mm]odule: |)copilot(?:`|)'
 - name: remove copilot
   content:
-  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)(?:module: |)copilot(?:`|)'
-- name: skip core
-  content:
-  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)(?:module: |)core(?:`|)'
-- name: remove core
-  content:
-  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)(?:module: |)core(?:`|)'
+  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)(?:[Mm]odule: |)copilot(?:`|)'
 - name: skip depot
   content:
-  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)(?:module: |)depot(?:`|)'
+  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)(?:[Mm]odule: |)depot(?:`|)'
 - name: remove depot
   content:
-  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)(?:module: |)depot(?:`|)'
+  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)(?:[Mm]odule: |)depot(?:`|)'
 - name: skip drop
   content:
-  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)(?:module: |)drop(?:`|)'
+  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)(?:[Mm]odule: |)drop(?:`|)'
 - name: remove drop
   content:
-  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)(?:module: |)drop(?:`|)'
+  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)(?:[Mm]odule: |)drop(?:`|)'
 - name: skip fight
   content:
-  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)(?:module: |)fight(?:`|)'
+  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)(?:[Mm]odule: |)fight(?:`|)'
 - name: remove fight
   content:
-  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)(?:module: |)fight(?:`|)'
-- name: skip GUI
-  content:
-  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)(?:module: |)GUI(?:`|)'
-- name: remove GUI
-  content:
-  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)(?:module: |)GUI(?:`|)'
+  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)(?:[Mm]odule: |)fight(?:`|)'
 - name: skip infrast
   content:
-  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)(?:module: |)infrast(?:`|)'
+  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)(?:[Mm]odule: |)infrast(?:`|)'
 - name: remove infrast
   content:
-  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)(?:module: |)infrast(?:`|)'
+  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)(?:[Mm]odule: |)infrast(?:`|)'
 - name: skip others
   content:
-  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)(?:module: |)others(?:`|)'
+  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)(?:[Mm]odule: |)others(?:`|)'
 - name: remove others
   content:
-  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)(?:module: |)others(?:`|)'
+  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)(?:[Mm]odule: |)others(?:`|)'
 - name: skip recruit
   content:
-  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)(?:module: |)recruit(?:`|)'
+  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)(?:[Mm]odule: |)recruit(?:`|)'
 - name: remove recruit
   content:
-  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)(?:module: |)recruit(?:`|)'
+  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)(?:[Mm]odule: |)recruit(?:`|)'
 - name: skip roguelike
   content:
-  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)(?:module: |)roguelike(?:`|)'
+  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)(?:[Mm]odule: |)roguelike(?:`|)'
 - name: remove roguelike
   content:
-  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)(?:module: |)roguelike(?:`|)'
+  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)(?:[Mm]odule: |)roguelike(?:`|)'
+- name: skip reclamation
+  content:
+  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)(?:[Mm]odule: |)reclamation(?:`|)'
+- name: remove reclamation
+  content:
+  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)(?:[Mm]odule: |)reclamation(?:`|)'
+
+- name: skip client
+  content:
+  regexes: '[Ss]kip [Cc]li(?:ent|) [Ll]abels?'
+- name: remove client
+  content:
+  regexes: '[Rr]emove [Cc]li(?:ent|) [Ll]abels?'
+- name: skip WpfGui
+  content:
+  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)(?:[Cc]li(?:ent|): |)[Ww][Pp][Ff][Gg][Uu][Ii](?:`|)'
+- name: remove WpfGui
+  content:
+  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)(?:[Cc]li(?:ent|): |)[Ww][Pp][Ff][Gg][Uu][Ii](?:`|)'
+- name: skip MacGui
+  content:
+  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)(?:[Cc]li(?:ent|): |)[Mm][Aa][Cc][Gg][Uu][Ii](?:`|)'
+- name: remove MacGui
+  content:
+  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)(?:[Cc]li(?:ent|): |)[Mm][Aa][Cc][Gg][Uu][Ii](?:`|)'
+- name: skip client-JP
+  content:
+  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)(?:[Cc]li(?:ent|): |)JP(?:`|)'
+- name: remove client-JP
+  content:
+  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)(?:[Cc]li(?:ent|): |)JP(?:`|)'
+- name: skip client-EN
+  content:
+  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)(?:[Cc]li(?:ent|): |)EN(?:`|)'
+- name: remove client-EN
+  content:
+  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)(?:[Cc]li(?:ent|): |)EN(?:`|)'
+- name: skip client-KR
+  content:
+  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)(?:[Cc]li(?:ent|): |)KR(?:`|)'
+- name: remove client-KR
+  content:
+  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)(?:[Cc]li(?:ent|): |)KR(?:`|)'
+- name: skip client-ZH_TW
+  content:
+  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)(?:[Cc]li(?:ent|): |)ZH_TW(?:`|)'
+- name: remove client-ZH_TW
+  content:
+  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)(?:[Cc]li(?:ent|): |)ZH_TW(?:`|)'
+
 - name: skip ambiguous
   content:
   regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)ambiguous(?:`|)'
@@ -98,46 +131,16 @@ labels:
   regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)release(?:`|)'
 - name: skip documentation
   content:
-  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)documentation(?:`|)'
+  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)doc(?:umentation|)(?:`|)'
 - name: remove documentation
   content:
-  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)documentation(?:`|)'
+  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)doc(?:umentation|)(?:`|)'
 - name: skip translation required
   content:
   regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)translation required(?:`|)'
 - name: remove translation required
   content:
   regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)translation required(?:`|)'
-- name: skip client-JP
-  content:
-  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)Client: JP(?:`|)'
-- name: remove client-JP
-  content:
-  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)Client: JP(?:`|)'
-- name: skip client-EN
-  content:
-  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)Client: EN(?:`|)'
-- name: remove client-EN
-  content:
-  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)Client: EN(?:`|)'
-- name: skip client-KR
-  content:
-  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)Client: KR(?:`|)'
-- name: remove client-KR
-  content:
-  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)Client: KR(?:`|)'
-- name: skip client-ZH_TW
-  content:
-  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)Client: ZH_TW(?:`|)'
-- name: remove client-ZH_TW
-  content:
-  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)Client: ZH_TW(?:`|)'
-- name: skip macOS
-  content:
-  regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)macOS(?:`|)'
-- name: remove macOS
-  content:
-  regexes: '[Rr]emove (?:[Ll]abels? |)(?:`|)macOS(?:`|)'
 - name: skip incomplete
   content:
   regexes: '[Ss]kip (?:[Ll]abels? |)(?:`|)incomplete(?:`|)'
@@ -156,7 +159,7 @@ labels:
 - name: infrast
   content: "module: infrast"
   regexes:
-    "基建|换班|贸易站|制造站|发电站|加工站|会客室|训练室|办公室|控制中枢|宿舍|基地|[Ii]nfrast|[Dd]orm"
+    "基建|换班|贸易站|制造站|发电站|加工站|会客室|训练室|办公室|控制中枢|宿舍|基地|送线索|排班表|[Ii]nfrast|[Dd]orm"
   skip-if:
   - skip all
   - skip module
@@ -170,7 +173,7 @@ labels:
 - name: roguelike
   content: "module: roguelike"
   regexes:
-    "肉[鸽鴿]|集成战略|[Rr]ogue|ローグ"
+    "肉[鸽鴿]|集成战略|[Rr]ogue|[Ii]ntegrated [Ss]tategy|I\\.S\\.|ローグ"
   skip-if:
   - skip all
   - skip module
@@ -180,10 +183,24 @@ labels:
   - remove module
   - remove roguelike
 
+# `module: reclamation`
+- name: reclamation
+  content: "module: reclamation"
+  regexes:
+    "生息|演算|沙洲遗闻|[Ff]ire [Ww]ithin|[Rr]eclamation"
+  skip-if:
+  - skip all
+  - skip module
+  - skip reclamation
+  remove-if:
+  - remove all
+  - remove module
+  - remove reclamation
+
 # `module: copilot`
 - name: copilot1
   content: "module: copilot"
-  regexes: '自动(?:作战|战斗|编队)|自動[戰戦][鬥闘]|[Cc]opilot'
+  regexes: '自动(?:作战|战斗|编队)|自動[戰戦][鬥闘]|保全|[Cc]opilot'
   mode: add
   skip-if:
   - skip all
@@ -259,7 +276,7 @@ labels:
 - name: others
   content: "module: others"
   regexes:
-    "信用|拜访|登录|开始唤醒|连接模拟器|[Vv]isit|[Ll]ogin|[Ss]tartup"
+    "信用|拜访|登录|开始唤醒|连接模拟器|账号切换|远程控制|干员识别|[Vv]isit|[Ll]ogin|[Ss]tartup|MaaCore(?!.dll)"
   skip-if:
   - skip all
   - skip module
@@ -284,25 +301,87 @@ labels:
   - remove module
   - remove recruit
 
-# `module: GUI`
-- name: GUI
-  content: "module: GUI"
+# `MacGui`
+- name: MacGui
+  content: "client: MacGui"
+  regexes: '[Mm]ac(?:(?:book|os|OS)|\s*(?:(?:操作|)系统|电脑|版))|[Pp]laycover'
+  skip-if:
+  - skip all
+  - skip client
+  - skip MacGui
+  remove-if:
+  - remove all
+  - remove client
+  - remove MacGui
+
+# `WpfGui`
+- name: WpfGui
+  content: "client: WpfGui"
   regexes:
     '软件更新|自动下载|图形化?界面|gui(?!\.)|GUI|Gui'
   skip-if:
   - skip all
-  - skip module
-  - skip GUI
+  - skip client
+  - skip WpfGui
+  - MacGui
   remove-if:
   - remove all
-  - remove module
-  - remove GUI
+  - remove client
+  - remove WpfGui
+
+# `client: JP`
+- name: "client: JP"
+  regexes: '(?:日[文语本]?服|[Yy]o[Ss]tar\-?(?:JP|jp)|(?:JP|jp)[\- ]*(?:[Yy]o[Ss]tar|服|[Cc]lient))'
+  skip-if:
+  - skip all
+  - skip client
+  - skip client-JP
+  remove-if:
+  - remove all
+  - remove client
+  - remove client-JP
+
+# `client: EN`
+- name: "client: EN"
+  regexes: '(?:英[文语]?服|国际服|美服|[Yy]o[Ss]tar\-?(?:EN|en)|(?:EN|en)[\- ]*(?:[Yy]o[Ss]tar|服|[Cc]lient))'
+  skip-if:
+  - skip all
+  - skip client
+  - skip client-EN
+  remove-if:
+  - remove all
+  - remove client
+  - remove client-EN
+
+# `client: KR`
+- name: "client: KR"
+  regexes: '(?:韩[文语国]?服|[Yy]o[Ss]tar\-?(?:KR|kr)|(?:KR|kr)[\- ]*(?:[Yy]o[Ss]tar|服|[Cc]lient))'
+  skip-if:
+  - skip all
+  - skip client
+  - skip client-KR
+  remove-if:
+  - remove all
+  - remove client
+  - remove client-KR
+
+# `client: ZH_TW`
+- name: "client: ZH_TW"
+  regexes: '(?:繁中服|台(?:湾|灣|)服|繁体中文服|[龙龍]成|天下网游|txwy)'
+  skip-if:
+  - skip all
+  - skip client
+  - skip client-ZH_TW
+  remove-if:
+  - remove all
+  - remove client
+  - remove client-ZH_TW
 
 # `ambiguous`
 - name: pr-ambiguous
   # 不符合 commitizen 的 PR
   content: ambiguous
-  regexes: '^(?!(?:build|chore|ci|docs?|feat|fix|perf|refactor|rft|style|test)[\:\.\(\,]|[Mm]erge|[Rr]evert|[Rr]elease)'
+  regexes: '^(?!(?:build|chore|ci|docs?|feat!?|fix|i18n|perf|refactor|rft|style|test)[\:\.\(\,]|[Rr]evert|[Rr]elease)'
   mode:
     pull_request_target:
   skip-if:
@@ -326,15 +405,16 @@ labels:
   - remove ambiguous
   - copilot1
   - copilot2
-  - core
   - depot
   - drop
   - fight
-  - GUI
+  - WpfGui
+  - MacGui
   - infrast
   - others
   - recruit
   - roguelike
+  - reclamation
 
 # `release`
 - name: release
@@ -378,64 +458,6 @@ labels:
   - remove all
   - remove translation required
 
-# `Client: JP`
-- name: "Client: JP"
-  regexes: '(?:日[文语本]?服|[Yy]o[Ss]tar\-?(?:JP|jp)|(?:JP|jp)[\- ]*(?:[Yy]o[Ss]tar|服|[Cc]lient))'
-  skip-if:
-  - skip all
-  - skip client
-  - skip client-JP
-  remove-if:
-  - remove all
-  - remove client
-  - remove client-JP
-
-# `Client: EN`
-- name: "Client: EN"
-  regexes: '(?:英[文语]?服|国际服|美服|[Yy]o[Ss]tar\-?(?:EN|en)|(?:EN|en)[\- ]*(?:[Yy]o[Ss]tar|服|[Cc]lient))'
-  skip-if:
-  - skip all
-  - skip client
-  - skip client-EN
-  remove-if:
-  - remove all
-  - remove client
-  - remove client-EN
-
-# `Client: KR`
-- name: "Client: KR"
-  regexes: '(?:韩[文语国]?服|[Yy]o[Ss]tar\-?(?:KR|kr)|(?:KR|kr)[\- ]*(?:[Yy]o[Ss]tar|服|[Cc]lient))'
-  skip-if:
-  - skip all
-  - skip client
-  - skip client-KR
-  remove-if:
-  - remove all
-  - remove client
-  - remove client-KR
-
-# `Client: ZH_TW`
-- name: "Client: ZH_TW"
-  regexes: '(?:繁中服|台(?:湾|灣|)服|繁体中文服|[龙龍]成|天下网游|txwy)'
-  skip-if:
-  - skip all
-  - skip client
-  - skip client-ZH_TW
-  remove-if:
-  - remove all
-  - remove client
-  - remove client-ZH_TW
-
-# `macOS`
-- name: macOS
-  regexes: '[Mm]ac(?:(?:book|os|OS)|\s*(?:(?:操作|)系统|电脑|版))'
-  skip-if:
-  - skip all
-  - skip macOS
-  remove-if:
-  - remove all
-  - remove macOS
-
 # `fixed`
 - name: fixed
   regexes:

.github/release_reviewers.yaml

@@ -0,0 +1,17 @@
+# Set to true to add reviewers to pull requests
+addReviewers: true
+
+# Set to true to add assignees to pull requests
+addAssignees: false
+
+# A list of reviewers to be added to pull requests (GitHub user name)
+reviewers:
+  - AnnAngela
+
+# A list of assignees to be added to pull requests (GitHub user name)
+assignees:
+  - AnnAngela
+
+# A list of keywords to be skipped the process that add reviewers if pull requests include it
+# skipKeywords:
+#   - wip

.github/workflows/ci.yml

@@ -3,40 +3,44 @@ name: ci
 on:
   push:
     tags:
-      - 'v*'
+      - "v*"
     branches-ignore:
-      - 'master'
+      - "master"
     paths:
-      - '3rdparty/include/**'
-      - 'include/**'
-      - 'src/**'
-      - 'cmake/**'
-      - 'CMakeLists.txt'
-      - 'MAA.sln'
-      - '.github/workflows/ci.yml'
+      - "3rdparty/include/**"
+      - "include/**"
+      - "src/**"
+      - "cmake/**"
+      - "CMakeLists.txt"
+      - "MAA.sln"
+      - ".github/workflows/ci.yml"
+      - "!**/*.md"
   pull_request:
     branches:
-      - 'dev'
+      - "dev"
     paths:
-      - '3rdparty/include/**'
-      - 'include/**'
-      - 'src/**'
-      - 'cmake/**'
-      - 'CMakeLists.txt'
-      - 'MAA.sln'
+      - "3rdparty/include/**"
+      - "include/**"
+      - "src/**"
+      - "cmake/**"
+      - "CMakeLists.txt"
+      - "MAA.sln"
+      - "!**/*.md"
   workflow_dispatch:
 
 jobs:
-
   meta:
     runs-on: ubuntu-latest
     outputs:
       tag: ${{ steps.set_tag.outputs.tag }}
       prerelease: ${{ steps.set_pre.outputs.prerelease }}
     steps:
-      - uses: actions/checkout@v3
+      - name: Checkout code
+        uses: actions/checkout@v4
         with:
           path: temp
+          show-progress: false
+
       - name: Fetch history
         if: ${{ !startsWith(github.ref, 'refs/pull/') }}
         run: |
@@ -48,13 +52,15 @@ jobs:
           git reset --hard origin/$(git branch --show-current) || true
           git checkout ${{ github.ref_name }}
 
-      - id: set_tag
+      - name: Set tag
+        id: set_tag
         run: |
           ${{ startsWith(github.ref, 'refs/pull/') && 'cd temp' || '' }}
           echo tag=$(git describe --tags --match "v*" ${{ github.ref }} || git rev-parse --short HEAD) | tee -a $GITHUB_OUTPUT
           exit ${PIPESTATUS[0]}
 
-      - id: set_pre
+      - name: Judge pre-release
+        id: set_pre
         if: ${{ startsWith(github.ref, 'refs/tags/v') }}
         run: |
           if [[ '${{ steps.set_tag.outputs.tag }}' =~ ^v[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
@@ -62,7 +68,9 @@ jobs:
           else
             echo prerelease=true | tee -a $GITHUB_OUTPUT
           fi
-      - if: ${{ startsWith(github.ref, 'refs/tags/v') }}
+
+      - name: Generate changelog
+        if: ${{ startsWith(github.ref, 'refs/tags/v') }}
         run: |
           this_tag=${{ steps.set_tag.outputs.tag }}
           if [[ '${{ steps.set_pre.outputs.prerelease }}' != 'false' ]]; then
@@ -72,7 +80,9 @@ jobs:
           fi
           echo >> CHANGELOG.md
           echo "**Full Changelog**: [$last_tag -> $this_tag](https://github.com/MaaAssistantArknights/MaaAssistantArknights/compare/${last_tag}...${this_tag})" >> CHANGELOG.md
-      - uses: actions/upload-artifact@v3
+
+      - name: Upload changelog to Github
+        uses: actions/upload-artifact@v4
         if: ${{ startsWith(github.ref, 'refs/tags/v') }}
         with:
           name: changelog
@@ -92,16 +102,25 @@ jobs:
     runs-on: windows-latest
 
     steps:
-      - uses: actions/checkout@v3
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          show-progress: false
+          submodules: recursive
 
       - name: Cache .nuke/temp, ~/.nuget/packages
-        uses: actions/cache@v3
+        id: cache-nuget
+        uses: actions/cache@v4
         with:
           path: |
             .nuke/temp
             ~/.nuget/packages
           key: ${{ runner.os }}-${{ matrix.msbuild_target }}-${{ hashFiles('**/global.json', '**/*.csproj') }}
 
+      - name: Restore dependencies
+        if: steps.cache-nuget.outputs.cache-hit != 'true'
+        run: dotnet restore
+
       - name: Bootstrap MaaDeps
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -111,10 +130,12 @@ jobs:
       - name: Create fake event file
         shell: bash
         run: cp -v "$GITHUB_EVENT_PATH" ./event.json
-      - if: startsWith(github.ref, 'refs/tags/v')
+
+      - name: Merge Event Data with Inputs
+        if: startsWith(github.ref, 'refs/tags/v')
         shell: bash
         run: |
-          cat "$GITHUB_EVENT_PATH" | jq '. + { "inputs": {"ReleaseSimulation": "${{ needs.meta.outputs.tag }}"} }' | tee ./event.json	
+          cat "$GITHUB_EVENT_PATH" | jq '. + { "inputs": {"ReleaseSimulation": "${{ needs.meta.outputs.tag }}"} }' | tee ./event.json
 
       - name: Taggify Version
         run: |
@@ -127,7 +148,7 @@ jobs:
               $match = "0.0.1"
           }
           [xml]$csproj = Get-Content -Path $csprojPath
-          $node = $csproj.Project.PropertyGroup | where {$_.AssemblyName -ne $null}
+          $node = $csproj.Project.PropertyGroup | where {$_.ApplicationVersion -ne $null}
           $node.InformationalVersion = $tag
           $node.Version = $match
           $node.FileVersion = $match
@@ -145,10 +166,14 @@ jobs:
           ./build.cmd DevBuild
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-      - run: |
+
+      - name: Cleanup checksum file
+        run: |
           rm -vf ./artifacts/checksum.json
         shell: bash
-      - uses: actions/upload-artifact@v3
+
+      - name: Upload MAA to Github
+        uses: actions/upload-artifact@v4
         with:
           name: MAA-win-${{ matrix.lowercase_target }}
           path: artifacts
@@ -160,8 +185,10 @@ jobs:
       matrix:
         arch: [aarch64, x86_64]
     steps:
-      - uses: actions/checkout@v3
+      - name: Checkout code
+        uses: actions/checkout@v4
         with:
+          show-progress: false
           submodules: recursive
 
       - name: Install cross compile toolchains
@@ -182,9 +209,6 @@ jobs:
           python3 maadeps-download.py ${{ matrix.arch == 'x86_64' && 'x64' || 'arm64' }}-linux
 
       - name: Build MAA
-        env:
-          CC: ${{ matrix.arch == 'x86_64' && 'ccache gcc-12' || 'ccache aarch64-linux-gnu-gcc-12' }}
-          CXX: ${{ matrix.arch == 'x86_64' && 'ccache g++-12' || 'ccache aarch64-linux-gnu-g++-12' }}
         run: |
           mkdir -p build
           cmake -B build \
@@ -197,124 +221,193 @@ jobs:
 
           mkdir -p install
           cmake --install build --prefix install
+        env:
+          CC: ${{ matrix.arch == 'x86_64' && 'ccache gcc-12' || 'ccache aarch64-linux-gnu-gcc-12' }}
+          CXX: ${{ matrix.arch == 'x86_64' && 'ccache g++-12' || 'ccache aarch64-linux-gnu-g++-12' }}
 
-      - name: Install cross compile tool (CLI)
-        if: ${{ matrix.arch != 'x86_64' }}
-        uses: taiki-e/install-action@v2
+      - name: Setup Cross Compile Toolchains for CLI
+        uses: ./src/maa-cli/.github/actions/setup
         with:
-          tool: cross
+          os: ubuntu-latest
+          target_arch: ${{ matrix.arch }}
 
       - name: Build CLI
-        working-directory: src/maa-cli
-        env:
-          CARGO_CMD: ${{ matrix.arch == 'x86_64' && 'cargo' || 'cross' }}
-          CARGO_BUILD_TARGET: ${{ matrix.arch }}-unknown-linux-gnu
         run: |
-          $CARGO_CMD build --release --locked --package maa-cli
+          cargo build --release --locked --package maa-cli --features vendored-openssl
           cp -v target/$CARGO_BUILD_TARGET/release/maa $GITHUB_WORKSPACE/install/maa
+          cargo build --release --locked --package maa-cli --no-default-features \
+            --features git2,vendored-openssl
+          cp -v target/$CARGO_BUILD_TARGET/release/maa $GITHUB_WORKSPACE/appimage-maa
+        working-directory: src/maa-cli
 
-      - name: tar files
+      - name: Build Appimage
+        run: |
+          sudo add-apt-repository universe
+          sudo apt update
+          sudo apt install libfuse2
+          mkdir -pv release
+          mkdir -pv Maa.AppDir/usr/share/maa
+          cp -r install/* Maa.AppDir/usr/share/maa/
+          wget -c https://raw.githubusercontent.com/MaaAssistantArknights/design/main/logo/maa-logo_512x512.png -O Maa.AppDir/maa.png
+          mkdir -pv Maa.AppDir/usr/share/icons/hicolor/512x512/apps/
+          cp -v Maa.AppDir/maa.png Maa.AppDir/usr/share/icons/hicolor/512x512/apps/
+          cp -v appimage-maa Maa.AppDir/usr/share/maa/maa
+          chmod a+x Maa.AppDir/usr/share/maa/maa
+
+          cat > Maa.AppDir/maa.desktop <<EOF
+          [Desktop Entry]
+          Type=Application
+          Name=MaaAssistantArknights
+          Icon=maa
+          Exec=AppRun
+          Terminal=true
+          Categories=Game;StrategyGame;
+          Comment=An Arknights assistant
+          EOF
+
+          ln -sv usr/share/maa/maa Maa.AppDir/AppRun
+          mkdir -pv Maa.AppDir/usr/share/metainfo/
+          cp -v tools/AppImage/io.github.maaassistantarknights.maaassistantarknights.metainfo.xml Maa.AppDir/usr/share/metainfo/
+          wget "https://github.com/AppImage/AppImageKit/releases/download/continuous/appimagetool-x86_64.AppImage"
+          # appimagetool with embedded runtime does not support cross build, till AppImage/appimagetool 7a10b8
+          wget "https://github.com/AppImage/type2-runtime/releases/download/continuous/runtime-${{ matrix.arch }}"
+          chmod a+x appimagetool-x86_64.AppImage
+          ARCH=${{ matrix.arch }} ./appimagetool-x86_64.AppImage --runtime-file runtime-${{ matrix.arch }} Maa.AppDir
+          chmod a+x MaaAssistantArknights-${{ matrix.arch }}.AppImage
+          mv -v MaaAssistantArknights-${{ matrix.arch }}.AppImage $GITHUB_WORKSPACE/release/MAA-${{ needs.meta.outputs.tag }}-linux-${{ matrix.arch }}.AppImage
+
+      - name: Tar files
         run: |
           mkdir -p release
           cd install
           tar czvf $GITHUB_WORKSPACE/release/MAA-${{ needs.meta.outputs.tag }}-linux-${{ matrix.arch }}.tar.gz .
 
-      - uses: actions/upload-artifact@v3
+      - name: Upload MAA to Github
+        uses: actions/upload-artifact@v4
         with:
           name: MAA-linux-${{ matrix.arch }}
-          path: 'release/*.tar.gz'
+          path: |
+            release/*.AppImage
+            release/*.tar.gz
 
   macOS-Core:
     needs: meta
-    runs-on: macos-13
+    runs-on: macos-14
     strategy:
       matrix:
         arch: [arm64, x86_64]
     steps:
-      - uses: actions/checkout@v3
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          show-progress: false
+
       - name: Install Dependencies
-        run: brew install ninja
+        run: |
+          brew install ninja
+
       - name: Bootstrap MaaDeps
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           [[ ${{ matrix.arch }} = "arm64" ]] && triplet="arm64-osx" || triplet="x64-osx"
           python3 maadeps-download.py ${triplet}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
       - name: Configure MaaCore
         run: |
           cmake -B build -GNinja -DCMAKE_BUILD_TYPE=Release -DCMAKE_OSX_ARCHITECTURES='${{ matrix.arch }}' -DMAA_VERSION='${{ needs.meta.outputs.tag }}'
+
       - name: Build MaaCore
         run: |
           cmake --build build
           cmake --install build --prefix install
-      - uses: actions/upload-artifact@v3
+
+      - name: Upload MAA to Github
+        uses: actions/upload-artifact@v4
         with:
           name: MAACore-macos-${{ matrix.arch }}
-          path: 'install/*.dylib'
+          path: "install/*.dylib"
 
   macOS-GUI:
     needs: [meta, macOS-Core]
-    runs-on: macos-13
+    runs-on: macos-14
     steps:
-      - uses: actions/checkout@v3
+      - name: Checkout code
+        uses: actions/checkout@v4
         with:
+          show-progress: false
           submodules: recursive
-      - uses: actions/download-artifact@v3
+
+      - name: Download Arm64 MAA from Github
+        uses: actions/download-artifact@v4
         with:
           name: MAACore-macos-arm64
           path: install-arm64
-      - uses: actions/download-artifact@v3
+
+      - name: Download x64 MAA from Github
+        uses: actions/download-artifact@v4
         with:
           name: MAACore-macos-x86_64
           path: install-x86_64
+
       - name: Install Developer ID Certificate
         if: startsWith(github.ref, 'refs/tags/v')
         uses: ssrobins/import-codesign-certs@v2
         with:
           p12-file-base64: ${{ secrets.HGUANDL_SIGN_CERT_P12 }}
           p12-password: ${{ secrets.HGUANDL_SIGN_CERT_PASSWD }}
+
       - name: Build Universal Binaries
         run: |
           mkdir build
           for LIB_NAME in $(ls install-arm64); do
             lipo -create install-arm64/$LIB_NAME install-x86_64/$LIB_NAME -output build/$LIB_NAME
           done
+
       - name: Build XCFramework
-        working-directory: build
         run: |
           xcodebuild -create-xcframework -library libMaaCore.dylib -headers ../include -output MaaCore.xcframework
-          xcodebuild -create-xcframework -library libMaaDerpLearning.dylib -output MaaDerpLearning.xcframework
+          xcodebuild -create-xcframework -library libfastdeploy_ppocr.dylib -output fastdeploy_ppocr.xcframework
           xcodebuild -create-xcframework -library libonnxruntime.*.dylib -output ONNXRuntime.xcframework
           xcodebuild -create-xcframework -library libopencv*.dylib -output OpenCV.xcframework
+        working-directory: build
+
       - name: Setup GUI Version
         run: |
           RELEASE_COUNT=$(git ls-remote --tags origin | grep refs/tags/v | awk 'END{print NR}')
           echo 'MARKETING_VERSION = ${{ needs.meta.outputs.tag }}' | tee src/MaaMacGui/Version.xcconfig
           echo 'CURRENT_PROJECT_VERSION = '"${RELEASE_COUNT}" | tee -a src/MaaMacGui/Version.xcconfig
+
       - name: Build MAA
-        working-directory: src/MaaMacGui
         run: |
           if ${{ startsWith(github.ref, 'refs/tags/v') }}; then
             xcodebuild -project MeoAsstMac.xcodeproj -scheme MAA archive -archivePath MAA.xcarchive -configuration Release
           else
             xcodebuild CODE_SIGN_IDENTITY="-" DEVELOPMENT_TEAM="-" ONLY_ACTIVE_ARCH=NO -project MeoAsstMac.xcodeproj -scheme MAA archive -archivePath MAA.xcarchive -configuration Debug
           fi
+        working-directory: src/MaaMacGui
+
       - name: Export MAA
         if: startsWith(github.ref, 'refs/tags/v')
+        run: |
+          xcodebuild -exportArchive -archivePath MAA.xcarchive -exportOptionsPlist ExportOptions.plist -exportPath Export
         working-directory: src/MaaMacGui
-        run: xcodebuild -exportArchive -archivePath MAA.xcarchive -exportOptionsPlist ExportOptions.plist -exportPath Export
+
       - name: Create Disk Image
         if: startsWith(github.ref, 'refs/tags/v')
-        working-directory: src/MaaMacGui
         run: |
           mkdir Image
           mv Export/MAA.app Image/
           ln -s /Applications Image/
           hdiutil create -volname MAA -srcfolder Image -ov -fs APFS -format ULMO MAA.dmg
+        working-directory: src/MaaMacGui
+
       - name: Archive Debug Symbols
         if: startsWith(github.ref, 'refs/tags/v')
+        run: |
+          ditto -c -k --keepParent MAA.app.dSYM MAA.app.dSYM.zip
         working-directory: src/MaaMacGui/MAA.xcarchive/dSYMs
-        run: ditto -c -k --keepParent MAA.app.dSYM MAA.app.dSYM.zip
+
       - name: Place Packages
         if: startsWith(github.ref, 'refs/tags/v')
         run: |
@@ -324,20 +417,23 @@ jobs:
           mkdir -p release
           mv src/MaaMacGui/MAA.dmg release/${APP_DMG}
           mv src/MaaMacGui/MAA.xcarchive/dSYMs/MAA.app.dSYM.zip release/${APP_SYM}
+
       - name: Notarize Image
         if: startsWith(github.ref, 'refs/tags/v')
-        env:
-          NOTARY_USER: ${{ secrets.HGUANDL_NOTARY_AAPL_ID }}
-          NOTARY_PASSWD: ${{ secrets.HGUANDL_NOTARY_PASSWD }}
-          NOTARY_TEAM: ${{ secrets.HGUANDL_SIGN_IDENTITY }}
-        working-directory: release
         run: |
           find . -name "*.dmg" | while read dmg; do
             codesign -s "$NOTARY_TEAM" --timestamp ${dmg}
             xcrun notarytool submit --apple-id "$NOTARY_USER" --password "$NOTARY_PASSWD" --team-id "$NOTARY_TEAM" --wait ${dmg}
             xcrun stapler staple ${dmg}
           done
-      - uses: actions/upload-artifact@v3
+        env:
+          NOTARY_USER: ${{ secrets.HGUANDL_NOTARY_AAPL_ID }}
+          NOTARY_PASSWD: ${{ secrets.HGUANDL_NOTARY_PASSWD }}
+          NOTARY_TEAM: ${{ secrets.HGUANDL_SIGN_IDENTITY }}
+        working-directory: release
+
+      - name: Upload MAA to Github
+        uses: actions/upload-artifact@v4
         with:
           name: MAA-macos-universal
           path: ${{ startsWith(github.ref, 'refs/tags/v') && 'release/MAA*' || 'src/MaaMacGui/MAA.xcarchive/**' }}
@@ -347,23 +443,29 @@ jobs:
     needs: [meta, windows, ubuntu, macOS-GUI]
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/download-artifact@v3
+      - name: Download MAA from Github
+        uses: actions/download-artifact@v4
         with:
           path: assets
-      - run: |
+
+      - name: Cleanup files
+        run: |
           mv -vf assets/changelog/* .
           rm -rf assets/MAACore-macos-*
           cd assets
           # find . -type f | xargs mv -fvt .
           find . -type f | while read f; do mv -fvt . $f; done
-      - uses: softprops/action-gh-release@v1
+
+      - name: Release to Github
+        uses: softprops/action-gh-release@v1
         with:
           body_path: CHANGELOG.md
           files: |
             assets/*
           prerelease: ${{ needs.meta.outputs.prerelease != 'false' }}
+
       - name: Trigger secondary workflows # ref: https://docs.github.com/en/actions/using-workflows/triggering-a-workflow#triggering-a-workflow-from-a-workflow
         run: |
           gh workflow run --repo $GITHUB_REPOSITORY release-ota
         env:
-            GH_TOKEN: ${{ secrets.MISTEOWORKFLOW }}
+          GH_TOKEN: ${{ secrets.MISTEOWORKFLOW }}

.github/workflows/gen-changelog.yml

@@ -2,38 +2,75 @@ name: gen-changelog
 
 on:
   pull_request:
-    types: [opened, reopened, ready_for_review]
+    types: 
+      - opened
+      - reopened
+      - ready_for_review
   workflow_dispatch:
 
 jobs:
   gen:
-    if: github.event.pull_request.draft == false && (startsWith(github.event.pull_request.title, 'Release v') || startsWith(github.event.pull_request.title, 'release v'))
+    # startsWith 表达式不区分大小写
+    if: github.event.pull_request.draft == false && startsWith(github.event.pull_request.title, 'Release v')
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - name: Checkout code
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
+          show-progress: false
 
       - name: Extract tag name
         id: extract_tag
+        env:
+          PR_BODY: ${{ format('{0}/{1}', runner.temp, 'output' ) }}
         run: |
           tag_name=$(echo "${{ github.event.pull_request.title }}" | sed -E 's/(Release|release)//' | sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//')
           echo "tag_name=$tag_name" >> $GITHUB_OUTPUT
-          
+
           pr_title="docs: Auto Update Changelogs of "$tag_name
           echo "pr_title=$pr_title" >> $GITHUB_OUTPUT
 
+          latest_stable_tag=$(git tag -l 'v*' | grep -v '-' | sort -V | tail -n 1) # 上一个 stable 版本
+          newest_tag=$(git describe --tags --match "v*" --abbrev=0) # 最新版本
+          echo "latest_stable_tag=$latest_stable_tag" >> $GITHUB_OUTPUT
+          echo "newest_tag=$newest_tag" >> $GITHUB_OUTPUT
+
+          if [[ $tag_name == *-* ]]; then # 判断新版本是否为 beta 版本
+            latest=$newest_tag            # 若是，则将 latest 参数设置为最新版本
+          else
+            latest=$latest_stable_tag     # 若否，则设置为上一个 stable 版本
+          fi
+
+          echo "latest=$latest" >> $GITHUB_OUTPUT
+
+          cat $GITHUB_OUTPUT
+
+          echo '======='
+
+          echo 'Target RP: ${{ github.event.pull_request.html_url }}' >> $PR_BODY
+          echo '' >> $PR_BODY
+          echo '<details><summary>Debug info</summary>' >> $PR_BODY
+          echo '' >> $PR_BODY
+          echo '```' >> $PR_BODY
+          sed 's/=/: /1' $GITHUB_OUTPUT >> $PR_BODY
+          echo '```' >> $PR_BODY
+          echo '' >> $PR_BODY
+          echo '</details>' >> $PR_BODY
+
+          cat $PR_BODY
+
       - name: Generate Changelog
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           git switch dev
-          python3 tools/ChangelogGenerator/changelog_generator.py --tag "${{ steps.extract_tag.outputs.tag_name }}"
+          python3 tools/ChangelogGenerator/changelog_generator.py --tag "${{ steps.extract_tag.outputs.tag_name }}" --latest "${{ steps.extract_tag.outputs.latest }}"
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Add files to git
         run: |
           git status
-          
+
           git config user.name "$GITHUB_ACTOR"
           git config user.email "$GITHUB_ACTOR@users.noreply.github.com"
           git add .
@@ -46,7 +83,16 @@ jobs:
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           title: ${{ steps.extract_tag.outputs.pr_title }}
-          body: ${{ github.event.pull_request.html_url }}
-          base: 'dev'
-          branch: 'changelog'
+          body-path: ${{ format('{0}/{1}', runner.temp, 'output' ) }}
+          base: "dev"
+          branch: "changelog"
           delete-branch: true
+          reviewers: |
+            AnnAngela
+          assignees: |
+            AnnAngela
+
+      - name: Add reviewers to release PR
+        uses: kentaro-m/auto-assign-action@v1.2.5
+        with:
+          configuration-path: ".github/release_reviewers.yaml"

.github/workflows/issue-checker.yml

@@ -16,9 +16,9 @@ jobs:
   triage:
     runs-on: ubuntu-latest
     steps:
-    - uses: zzyyyl/issue-checker@v1.7
-      with:
-        repo-token: "${{ secrets.GITHUB_TOKEN }}"
-        configuration-path: .github/issue-checker.yml
-        not-before: 2022-08-05T00:00:00Z
-        include-title: 1
+      - uses: zzyyyl/issue-checker@v1.8
+        with:
+          repo-token: "${{ secrets.GITHUB_TOKEN }}"
+          configuration-path: .github/issue-checker.yml
+          not-before: 2022-08-05T00:00:00Z
+          include-title: 1

.github/workflows/markdown-checker.yml

@@ -0,0 +1,49 @@
+name: Lint Markdown files
+
+on:
+  push:
+    paths:
+      - "**/*.md"
+      - ".github/workflows/lint-markdown.yml"
+  pull_request:
+    paths:
+      - "**/*.md"
+      - ".github/workflows/lint-markdown.yml"
+  schedule:
+    - cron: "44 7 * * 2"
+  workflow_dispatch:
+
+jobs:
+  lint:
+    name: Lint Markdown
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v4
+        with:
+          show-progress: false
+
+      - name: Lint Markdown
+        uses: DavidAnson/markdownlint-cli2-action@v16
+        with:
+          config: docs/.markdownlint.yaml
+          globs: |
+            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

.github/workflows/pr-auto-tag.yml

@@ -18,10 +18,12 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v3
+      - name: Checkout code
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
           token: ${{ secrets.MAARELEASE_RELEASE }}
+
       - name: Git config
         run: |
           git config user.name "$GITHUB_ACTOR"

.github/workflows/pr-checker.yml

@@ -0,0 +1,59 @@
+name: PR Checker
+
+on:
+  pull_request_target:
+    types: [opened, edited, ready_for_review, reopened, synchronize]
+
+
+jobs:
+  check_commit_name_in_pr:
+    if: ${{ !github.event.pull_request.merged && github.base_ref != 'master' }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Cleanup Previous Comment
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const { data: comments } = await github.rest.issues.listComments({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.payload.pull_request.number
+            });
+
+            const previousComment = comments.find(comment => comment.user.login === 'github-actions[bot]' && comment.body.includes('invalid commit(s)'));
+            if (previousComment) {
+              await github.rest.issues.deleteComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                comment_id: previousComment.id
+              });
+            }
+      - name: Check Commits
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const { data: commits } = await github.rest.pulls.listCommits({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              pull_number: context.payload.pull_request.number,
+              per_page: 100
+            });
+
+            const regex = /^((build|chore|ci|docs?|feat!?|fix|perf|refactor|rft|style|test|i18n|typo)[\:\.\(\,]|[Rr]evert|[Rr]elease)/;
+            const invalidCommits = commits.filter(commit => !regex.test(commit.commit.message) || commit.parents.length > 1);
+
+            console.log(`Checked ${commits.length} commit(s)`);
+
+            if (invalidCommits.length > 0) {
+              const invalidCommitNames = invalidCommits.map(commit => commit.commit.message);
+              const invalidCommitInfoList = invalidCommits.map(commit => `- ${commit.commit.message.split("\n")[0]} [\`${commit.sha.substring(0, 7)}\`](${commit.html_url})`).join("\n");
+
+              github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: context.payload.pull_request.number,
+                body: `## ⚠️ Found ${invalidCommits.length} invalid commit(s):\n\n${invalidCommitInfoList}\n\n---\nPlease follow the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) format.`
+              });
+
+              core.setFailed(`Found ${invalidCommits.length} invalid commit(s):\n${invalidCommitNames.join("\n-------------------\n")}`);
+            }

.github/workflows/qodana.yml

@@ -1,39 +0,0 @@
-name: 'static-analysis-qodana'
-on:
-  workflow_dispatch:
-  pull_request: # 在 PR 更新的场合进行扫描
-    paths:
-      - '.github/workflows/qodana.yml'
-      - 'src/MaaWpfGui/*'
-      - 'qodana.yaml'
-      - 'src/MaaWpfGui/**'
-      - 'MAA.sln'
-  push:  # 在主分支推送代码的场合进行扫描
-    branches:
-      - master
-      - 'releases/*'
-      - dev
-    paths:
-      - '.github/workflows/qodana.yml'
-      - 'src/MaaWpfGui/**'
-      - 'qodana.yaml'
-jobs:
-  qodana:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      pull-requests: write
-      checks: write
-    steps:
-      - uses: actions/checkout@v3
-        with:
-          ref: ${{ github.event.pull_request.head.sha }}  # to check out the actual pull request commit, not the merge commit
-          fetch-depth: 0  # a full history is required for pull request analysis
-      - name: 'Qodana Scan'
-        uses: JetBrains/qodana-action@main
-        with:
-          pr-mode: false
-          post-pr-comment: true
-          args: --baseline,.github/qodana.sarif.json
-        env:
-          QODANA_TOKEN: ${{ secrets.QODANA_TOKEN }}

.github/workflows/release-nightly-ota.yml

@@ -4,26 +4,25 @@ on:
   workflow_dispatch:
     inputs:
       release_body:
-        description: 'Release note'
+        description: "Release note"
         type: string
         required: false
       ref:
-        description: 'Commit to build (git checkout)'
+        description: "Commit to build (git checkout)"
         type: string
         required: false
       limit:
-        description: 'Number of releases to fetch from MaaAssistantArknights'
+        description: "Number of releases to fetch from MaaAssistantArknights"
         required: true
         default: 30
         type: number
       limit_2:
-        description: 'Number of releases to fetch from MaaRelease'
+        description: "Number of releases to fetch from MaaRelease"
         required: true
         default: 30
         type: number
 
 jobs:
-
   build-win-nightly:
     runs-on: windows-latest
     strategy:
@@ -38,25 +37,32 @@ jobs:
       tag: ${{ steps.set_tag.outputs.tag }}
       pre_version: ${{ steps.set_tag.outputs.pre_version }}
       main_tag_name: ${{ steps.push_main_tag.outputs.main_tag_name }}
+      changelog: ${{ steps.generate_changelog.outputs.changelog }}
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           # repository: 'MaaAssistantArknights/MaaAssistantArknights'
           submodules: recursive
           #ref: ${{ inputs.ref }}
           fetch-depth: 0
           token: ${{ secrets.GITHUB_TOKEN }}
+
       - name: Checkout ref
         run: |
           if ("${{ inputs.ref }}" -ne "") {
             git checkout --progress --recurse-submodules ${{ inputs.ref || 'dev' }}
           }
-      - run: |
+
+      - name: Install semver
+        run: |
           npm install --global --progress semver
 
       - name: Set tag
         id: set_tag
         run: |
+          # pre_version是上一个公版，这里需要拉上一个tag，避免堆积过多commit
+          $latest_tag=$(git describe --tags --abbrev=0)
+          echo "latest_tag=$latest_tag" >> $env:GITHUB_OUTPUT
           $described = $(git describe --tags --long --match 'v*')
           $ids = $($described -split "-")
           if ($ids.length -eq 3) {
@@ -81,24 +87,64 @@ jobs:
         run: |
           git config user.name 'github-actions[bot]'
           git config user.email 'github-actions[bot]@users.noreply.github.com'
-          
+
           $main_tag_name=$(echo "alpha/${{ steps.set_tag.outputs.tag }}")
           git tag $main_tag_name -f
           git push --tags origin HEAD:refs/tags/$main_tag_name -f
           echo "main_tag_name=$main_tag_name" >> $env:GITHUB_OUTPUT
 
+      - name: Generate Changelog
+        id: generate_changelog
+        run: |
+          python3 tools/ChangelogGenerator/changelog_generator.py --latest "${{ steps.set_tag.outputs.latest_tag }}" --tag "${{ steps.set_tag.outputs.tag }}"
+          $content=$(((Get-Content .\changelog.md) | Select-Object -Skip 2) -join "\n\n") 
+          echo "changelog=$content" >> $env:GITHUB_OUTPUT
+          echo $content
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          PYTHONIOENCODING: "utf-8"
+
       - name: Cache .nuke/temp, ~/.nuget/packages
-        uses: actions/cache@v3
+        id: cache-nuget
+        uses: actions/cache@v4
         with:
           path: |
             .nuke/temp
             ~/.nuget/packages
           key: ${{ runner.os }}-${{ hashFiles('**/global.json', '**/*.csproj') }}
+
+      - name: Restore dependencies
+        if: steps.cache-nuget.outputs.cache-hit != 'true'
+        run: dotnet restore
+
       - name: Bootstrap MaaDeps
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           python3 maadeps-download.py ${{ matrix.lowercase_target }}-windows
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Taggify Version
+        run: |
+          $csprojPath = "src/MaaWpfGui/MaaWpfGui.csproj"
+          $csprojPath = Resolve-Path -Path $csprojPath
+          $tag = '${{ steps.set_tag.outputs.tag }}' -replace '.*?/', ''
+          if ($tag -match '\d+(\.\d+){1,3}') {
+              $match = $Matches[0]
+          } else {
+              $match = "0.0.1"
+          }
+          echo "Tag value: $tag"
+          echo "Version value: $match"
+          [xml]$csproj = Get-Content -Path $csprojPath
+          $node = $csproj.Project.PropertyGroup | where {$_.ApplicationVersion -ne $null}
+          $node.InformationalVersion = $tag
+          $node.Version = $match
+          $node.FileVersion = $match
+          $node.AssemblyVersion = $match
+          $csproj.Save($csprojPath)
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
       - name: Run './build.cmd DevBuild'
         run: |
           $env:GITHUB_WORKFLOW = 'dev-build-win' # pretend this is a dev-build-win workflow
@@ -107,24 +153,27 @@ jobs:
 
           ./build.cmd DevBuild
         env:
-          Reason: 'Build nightly version'
+          Reason: "Build nightly version"
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-      - uses: actions/upload-artifact@v3
+
+      - name: Upload MAA to Github
+        uses: actions/upload-artifact@v4
         with:
           name: MAA-win-${{ matrix.lowercase_target }}
           path: artifacts
 
-
   push-tag:
     needs: build-win-nightly
     runs-on: ubuntu-latest
     steps:
       - name: Fetch MaaRelease
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           repository: ${{ format('{0}/{1}', github.repository_owner, 'MaaRelease') }}
           fetch-depth: 0
           token: ${{ secrets.MAARELEASE_RELEASE }}
+          show-progress: false
+
       - name: Commit and setup tag
         run: |
           git config user.name 'github-actions[bot]'
@@ -142,22 +191,27 @@ jobs:
         target: [x64]
     runs-on: ubuntu-latest
     steps:
-      - run: echo ${{ needs.build-win-nightly.outputs.tag }}
-      - uses: actions/checkout@v3
+      - name: Echo tag version
+        run: |
+          echo ${{ needs.build-win-nightly.outputs.tag }}
+
+      - name: Checkout code
+        uses: actions/checkout@v4
         with:
           path: MaaAssistantArknights
           token: ${{ secrets.MAARELEASE_RELEASE }}
-      - uses: actions/download-artifact@v3
+          show-progress: false
+
+      - name: Download MAA from Github
+        uses: actions/download-artifact@v4
         with:
           name: MAA-win-${{ matrix.target }}
           path: ${{ format('{0}/{1}', 'build-ota', needs.build-win-nightly.outputs.tag) }}
+
       - name: Fetch release info
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           mkdir -pv build-ota && cd build-ota
 
-
           gh release list --repo 'MaaAssistantArknights/MaaAssistantArknights' --limit ${{ inputs.limit || 30 }} | tee ./release_maa.txt
           gh release list --repo "${{ github.repository_owner }}/MaaRelease" --limit ${{ inputs.limit_2 || 30 }} | tee ./release_mr.txt
           echo ${{ needs.build-win-nightly.outputs.tag }} > ./config
@@ -171,9 +225,10 @@ jobs:
           cat ./config
 
           echo "release_tag=$(head -n 1 ./config)" >> $GITHUB_ENV
-      - name: Build OTA
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build OTA
         run: |
           cd build-ota
 
@@ -184,6 +239,8 @@ jobs:
 
           $GITHUB_WORKSPACE/MaaAssistantArknights/tools/OTAPacker/build.sh 'MaaAssistantArknights/MaaAssistantArknights' ./config ${{ matrix.target }} "${{ github.repository_owner }}/MaaRelease"
           mv -v ${{ needs.build-win-nightly.outputs.tag }}/*.zip ./MAA-${{ env.release_tag }}-win-${{ matrix.target }}.zip
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Make release body
         id: make_release_body
@@ -191,9 +248,9 @@ jobs:
         run: |
           pre_version=${{ needs.build-win-nightly.outputs.pre_version }}
           cur_version=${{ needs.build-win-nightly.outputs.main_tag_name }}
-          echo -e "${{ inputs.release_body || '' }}\n\n**Full Changelog**: [$pre_version -> $cur_version](https://github.com/$GITHUB_REPOSITORY/compare/$pre_version...$cur_version)" > alpha_changelog.md
+          echo -e "${{ inputs.release_body || '' }}\n\n${{ needs.build-win-nightly.outputs.changelog }}\n\n**Full Changelog**: [$pre_version -> $cur_version](https://github.com/$GITHUB_REPOSITORY/compare/$pre_version...$cur_version)" > alpha_changelog.md
           export r=$(cat alpha_changelog.md)
-          
+
           # https://github.com/svenstaro/upload-release-action
           r="${r//'%'/'%25'}"                               # Multiline escape sequences for %
           r="${r//$'\n'/'%0A'}"                             # Multiline escape sequences for '\n'
@@ -215,6 +272,6 @@ jobs:
 
       - name: Setup release mirror
         run: |
-            gh workflow --repo MaaAssistantArknights/MaaRelease run release-mirrors.yml
+          gh workflow --repo MaaAssistantArknights/MaaRelease run release-mirrors.yml
         env:
-            GH_TOKEN: ${{ secrets.MISTEOWORKFLOW }}
+          GH_TOKEN: ${{ secrets.MISTEOWORKFLOW }}

.github/workflows/release-ota.yml

@@ -2,19 +2,19 @@ name: release-ota
 
 on:
   release:
-    types: 
+    types:
       - published
   workflow_dispatch:
     inputs:
       limit:
         description: Number of releases to fetch from MaaAssistantArknights, 2 at least
         required: false
-        default: 31
+        default: '31'
         type: number
       limit_2:
         description: Number of releases to fetch from MaaRelease
         required: false
-        default: 30
+        default: '30'
         type: number
 
 env:
@@ -25,12 +25,14 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Fetch MaaRelease
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
+          show-progress: false
           repository: ${{ format('{0}/{1}', github.repository_owner, 'MaaRelease') }}
           path: MaaRelease
           fetch-depth: 0
           token: ${{ secrets.MAARELEASE_RELEASE }}
+
       - name: Fetch release info
         id: fetchReleaseInfo
         run: |
@@ -49,6 +51,7 @@ jobs:
 
           echo "prerelease=$([ $(head -n 1 release_maa.txt | awk '{ print $2}') = 'Pre-release' ] && echo true || echo false)" >> $GITHUB_OUTPUT
           echo "release_tag=$(head -n 1 ./config)" >> $GITHUB_OUTPUT
+
       - name: Commit and setup tag
         run: |
           cd MaaRelease
@@ -61,10 +64,13 @@ jobs:
           git push --tags
         env:
           PUSH_REMOTE: https://github-actions[bot]:${{ secrets.MAARELEASE_RELEASE }}@github.com/${{ github.repository_owner }}/MaaRelease
-      - uses: actions/upload-artifact@v3
+
+      - name: Upload release config to GitHub
+        uses: actions/upload-artifact@v4
         with:
           name: MaaReleaseConfig
           path: ./build-ota/config
+
     outputs:
       prerelease: ${{ steps.fetchReleaseInfo.outputs.prerelease }}
       release_tag: ${{ steps.fetchReleaseInfo.outputs.release_tag }}
@@ -73,31 +79,40 @@ jobs:
     needs: create-tag
     runs-on: ubuntu-latest
     strategy:
-      matrix: 
-        target: 
+      matrix:
+        target:
           - x64
     steps:
-      - uses: actions/download-artifact@v3
+      - name: Download release config
+        uses: actions/download-artifact@v4
+
       - name: Fetch MaaRelease
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
+          show-progress: false
           repository: ${{ format('{0}/{1}', github.repository_owner, 'MaaRelease') }}
           path: MaaRelease
           fetch-depth: 0
           token: ${{ secrets.MAARELEASE_RELEASE }}
-      - uses: actions/checkout@v3
+
+      - name: Checkout code
+        uses: actions/checkout@v4
         with:
+          show-progress: false
           path: MaaAssistantArknights
+
       - name: Download latest version for server
         run: |
           mkdir -pv build-ota/${{ needs.create-tag.outputs.release_tag }}
           cd build-ota/${{ needs.create-tag.outputs.release_tag }}
           gh release download ${{ needs.create-tag.outputs.release_tag }} --repo 'MaaAssistantArknights/MaaAssistantArknights' --pattern "MAA-${{ needs.create-tag.outputs.release_tag }}-win-${{ matrix.target }}.zip" --clobber
           cp *.zip ..
+
       - name: Build OTA
         run: |
           cd build-ota
           $GITHUB_WORKSPACE/MaaAssistantArknights/tools/OTAPacker/build.sh 'MaaAssistantArknights/MaaAssistantArknights' ../MaaReleaseConfig/config ${{ matrix.target }} 'MaaAssistantArknights/MaaRelease'
+
       - name: Upload to MaaRelease
         uses: svenstaro/upload-release-action@v2
         with:
@@ -111,10 +126,11 @@ jobs:
 
   make-ota-mac:
     needs: create-tag
-    runs-on: macos-13
+    runs-on: macos-14
     steps:
       - name: Fetch release info
         run: gh release list --repo 'MaaAssistantArknights/MaaAssistantArknights' --limit ${{ inputs.limit || 31 }} | tee ./release_maa.txt
+
       - name: Download release packages
         run: |
           cat ./release_maa.txt | awk '{ print $1 }' | while read tag; do
@@ -123,8 +139,11 @@ jobs:
             gh api /markdown -f text="$RELEASE_NOTES" | tee ./packages/MAA-"$tag"-macos-universal.html
           done
           curl -fsSL -o packages/appcast.xml https://maa-release.hguandl.com/macos/appcast.xml
+
       - name: Setup Sparkle
-        run: gh release download --repo 'sparkle-project/Sparkle' --clobber -O - -p 'Sparkle-*.tar.xz' | tar xf -
+        run: |
+          gh release download --repo 'sparkle-project/Sparkle' --clobber -O - -p 'Sparkle-*.tar.xz' | tar xf -
+
       - name: Generate Update Packages
         run: |
           if [ $(head -n 1 release_maa.txt | awk '{ print $2 }') = 'Pre-release' ]; then
@@ -132,8 +151,11 @@ jobs:
           else
             echo ${{ secrets.SPARKLE_PRIV_KEY }} | ./bin/generate_appcast --ed-key-file - ./packages
           fi
+
       - name: Cleanup files
-        run: find ./packages -type f ! \( -name 'MAA-${{ needs.create-tag.outputs.release_tag }}-macos-universal.dmg' -o -name '*.delta' -o -name '*.xml' \) -print -delete
+        run: |
+          find ./packages -type f ! \( -name 'MAA-${{ needs.create-tag.outputs.release_tag }}-macos-universal.dmg' -o -name '*.delta' -o -name '*.xml' \) -print -delete
+
       - name: Unpack the .dmg files for .dylib
         run: |
           cd ${{ runner.temp }}
@@ -158,6 +180,7 @@ jobs:
           echo ::group::Detaching release package...
           hdiutil detach /Volumes/MAA
           echo ::endgroup::
+
       - name: Upload to MaaRelease
         uses: svenstaro/upload-release-action@v2
         with:
@@ -170,7 +193,7 @@ jobs:
           overwrite: true
 
   release:
-    needs: 
+    needs:
       - make-ota
       - make-ota-mac
     runs-on: ubuntu-latest
@@ -180,29 +203,3 @@ jobs:
       - name: Setup release mirror
         run: |
           gh workflow --repo MaaAssistantArknights/MaaRelease run release-mirrors.yml
-      - name: Deploy docs
-        run: |
-          mkdir -p ${{ runner.temp }}/new
-          mkdir -p ${{ runner.temp }}/old
-          gh api /repos/MaaAssistantArknights/MaaAssistantArknights/tags --jq '.[].name' > ${{ runner.temp }}/release_maa.txt
-          export NEW_VERSION=$(sed -n '1p' ${{ runner.temp }}/release_maa.txt)
-          echo "NEW_VERSION: $NEW_VERSION"
-          export OLD_VERSION=$(sed -n '2p' ${{ runner.temp }}/release_maa.txt)
-          echo "OLD_VERSION: $OLD_VERSION"
-          gh api "/repos/MaaAssistantArknights/MaaAssistantArknights/tarball/$NEW_VERSION" > ${{ runner.temp }}/new.tar.gz
-          gh api "/repos/MaaAssistantArknights/MaaAssistantArknights/tarball/$OLD_VERSION" > ${{ runner.temp }}/old.tar.gz
-          tar -xzf ${{ runner.temp }}/new.tar.gz -C ${{ runner.temp }}/new
-          tar -xzf ${{ runner.temp }}/old.tar.gz -C ${{ runner.temp }}/old
-          export NEW_PATH="${{ runner.temp }}/new/$(ls ${{ runner.temp }}/new)/docs"
-          echo "NEW_PATH: $NEW_PATH"
-          export OLD_PATH="${{ runner.temp }}/old/$(ls ${{ runner.temp }}/old)/docs"
-          echo "OLD_PATH: $OLD_PATH"
-          export DOCS_DIFF=$(diff -aqr $NEW_PATH $OLD_PATH)
-          if [ -n "$DOCS_DIFF" ]; then
-            echo "Found changes, start to deploy the docs:"
-            echo "$DOCS_DIFF"
-            gh workflow --repo MaaAssistantArknights/maa-website run azure-deploy.yaml
-            echo "Deploying the docs."
-          else
-            echo "Nothing changed, exit."
-          fi

.github/workflows/res-update-game.yml

@@ -17,25 +17,93 @@ jobs:
     env:
       GH_TOKEN: ${{ secrets.MISTEOWORKFLOW }}
     steps:
-      - uses: actions/checkout@v3
+      - name: Checkout MAA
+        uses: actions/checkout@v4
         with:
+          show-progress: false
           token: ${{ secrets.MISTEOWORKFLOW }}
+
       - name: Bootstrap MaaDeps
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           python3 maadeps-download.py x64-windows
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
       - name: Add msbuild to PATH
         uses: microsoft/setup-msbuild@v1
+
       - name: Build Resource Updater
         run: |
           MSBUILD tools/ResourceUpdater/ResourceUpdater.vcxproj /t:rebuild /p:Configuration="Release" /p:Platform="x64" /p:BuildProjectReferences=false /m
+
+      - name: Clone ArknightsGameResource for Official
+        uses: actions/checkout@v4
+        with:
+          show-progress: false
+          repository: yuanyan3060/ArknightsGameResource
+          ref: main
+          path: .\tools\ResourceUpdater\x64\Release\Official
+          sparse-checkout: |
+            /levels.json
+            /item
+            /building_skill
+            /gamedata/excel/item_table.json
+            /gamedata/excel/building_data.json
+            /gamedata/excel/range_table.json
+            /gamedata/excel/character_table.json
+            /gamedata/excel/gacha_table.json
+            /gamedata/excel/roguelike_topic_table.json
+            /gamedata/excel/activity_table.json
+          sparse-checkout-cone-mode: false
+
+      - name: Clone ArknightsGameResource_Yostar for Overseas
+        uses: actions/checkout@v4
+        with:
+          show-progress: false
+          repository: Kengxxiao/ArknightsGameData_Yostar
+          ref: main
+          path: .\tools\ResourceUpdater\x64\Release\Overseas
+          sparse-checkout: |
+            /en_US/gamedata/excel/item_table.json
+            /en_US/gamedata/excel/building_data.json
+            /en_US/gamedata/excel/range_table.json
+            /en_US/gamedata/excel/character_table.json
+            /en_US/gamedata/excel/gacha_table.json
+            /en_US/gamedata/excel/roguelike_topic_table.json
+            /en_US/gamedata/excel/activity_table.json
+            /ja_JP/gamedata/excel/item_table.json
+            /ja_JP/gamedata/excel/building_data.json
+            /ja_JP/gamedata/excel/range_table.json
+            /ja_JP/gamedata/excel/character_table.json
+            /ja_JP/gamedata/excel/gacha_table.json
+            /ja_JP/gamedata/excel/roguelike_topic_table.json
+            /ja_JP/gamedata/excel/activity_table.json
+            /ko_KR/gamedata/excel/item_table.json
+            /ko_KR/gamedata/excel/building_data.json
+            /ko_KR/gamedata/excel/range_table.json
+            /ko_KR/gamedata/excel/character_table.json
+            /ko_KR/gamedata/excel/gacha_table.json
+            /ko_KR/gamedata/excel/roguelike_topic_table.json
+            /ko_KR/gamedata/excel/activity_table.json
+          sparse-checkout-cone-mode: false
+
+      - name: Clone arknights-toolbox-update for Taiwan
+        uses: actions/checkout@v4
+        with:
+          show-progress: false
+          repository: arkntools/arknights-toolbox-update
+          ref: data-tw
+          path: .\tools\ResourceUpdater\x64\Release\Overseas\zh_TW\gamedata\excel
+          token: ${{ secrets.ARKNTOOLS_MAA_RESOURCE_UPDATER}}
+
       - name: Run Resource Updater
         run: |
           .\tools\ResourceUpdater\x64\Release\ResourceUpdater.exe
+
       - name: Overseas Tasks Ordering
         run: |
-          python3 tools/ResourceUpdater/Tasks_Sorter.py
+          python3 tools/TaskSorter/TaskSorter.py
+
       - name: Check if only sorted
         id: check_only_sorted
         run: |
@@ -53,18 +121,23 @@ jobs:
           echo "numbers: "$numbers
 
           $length = $numbers.Length
-          $isAllEqual = $true
+          $noDiff = $true
           for ($i = 0; $i -lt $length; $i += 2) {
-              $firstNumber = $numbers[$i]
-              $secondNumber = $numbers[$i+1]
+            $firstNumber = $numbers[$i]
+            $secondNumber = $numbers[$i+1]
 
-              if ($firstNumber -ne $secondNumber) {
-                  $isAllEqual = $false
-                  break
-              }
+            if ($firstNumber -gt 1) {
+              $noDiff = $false
+              break
+            }
+            
+            if ($firstNumber -ne $secondNumber) {
+                $noDiff = $false
+                break
+            }
           }
-          echo "isAllEqual: "$isAllEqual
-          echo "only_sorted=$isAllEqual" >> $env:GITHUB_OUTPUT
+          echo "noDiff: "$noDiff
+          echo "only_sorted=$noDiff" >> $env:GITHUB_OUTPUT
 
       - name: Cancelling
         if: steps.check_only_sorted.outputs.only_sorted == 'True'
@@ -86,7 +159,7 @@ jobs:
           } else {
             $commit_msg = "chore: Auto Update Game Resources - $(Get-Date -Format 'yyyy-MM-dd')"
           }
-          git commit -m "$commit_msg"
+          git commit -m "$commit_msg" -m "[skip changelog]"
           if ($LASTEXITCODE -eq 0) {
             echo "have_commits=True" >> $env:GITHUB_OUTPUT
           }
@@ -104,6 +177,7 @@ jobs:
           github_token: ${{ secrets.MISTEOWORKFLOW }}
 
       - name: Update OTA resource
+        if: steps.add_files.outputs.have_commits == 'True'
         run: |
           gh workflow --repo MaaAssistantArknights/MaaRelease run update-resource.yml
 

.github/workflows/smoke-testing.yml

@@ -3,57 +3,76 @@ name: test
 on:
   push:
     paths:
-      - '3rdparty/include/**'
-      - 'include/**'
-      - 'src/**'
-      - 'cmake/**'
-      - 'CMakeLists.txt'
-      - 'MAA.sln'
-      - 'resource/**'
-      - 'MaaDeps/**'
+      - "3rdparty/include/**"
+      - "include/**"
+      - "src/**"
+      - "cmake/**"
+      - "CMakeLists.txt"
+      - "MAA.sln"
+      - "resource/**"
+      - "MaaDeps/**"
+      - "!**/*.md"
   pull_request:
     paths:
-      - '3rdparty/include/**'
-      - 'include/**'
-      - 'src/**'
-      - 'cmake/**'
-      - 'CMakeLists.txt'
-      - 'MAA.sln'
-      - 'resource/**'
-      - 'MaaDeps/**'
+      - "3rdparty/include/**"
+      - "include/**"
+      - "src/**"
+      - "cmake/**"
+      - "CMakeLists.txt"
+      - "MAA.sln"
+      - "resource/**"
+      - "MaaDeps/**"
+      - "!**/*.md"
   workflow_dispatch:
 
 jobs:
   smoke-testing:
     runs-on: windows-latest
     steps:
-      - uses: actions/checkout@v3
-      
-      - uses: NuGet/setup-nuget@v1.2.0
-      - run: |
-          nuget restore MAA.sln
-          if ($LASTEXITCODE) { nuget restore MAA.sln }
-          if ($LASTEXITCODE) { nuget restore MAA.sln }
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          show-progress: false
+          submodules: recursive
+          
+      - name: Restore dependencies
+        run: dotnet restore
       
       - name: Bootstrap MaaDeps
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           python3 maadeps-download.py x64-windows
-          
+
       - name: Add msbuild to PATH
         uses: microsoft/setup-msbuild@v1
       - name: Build MaaSample
         run: |
           MSBUILD src/Cpp/MaaSample.slnf /t:rebuild /p:Configuration="Debug" /p:Platform="x64" /m
 
-      - name: Run tests
+      - name: Run tests - Official #用来判断是不是国服资源出错导致外服全炸
         run: |
           .\x64\Debug\Sample.exe
 
+      - name: Run tests - YostarJP
+        run: |
+          .\x64\Debug\Sample.exe YostarJP
+          
+      - name: Run tests - YostarEN
+        run: |
+          .\x64\Debug\Sample.exe YostarEN
+        
+      - name: Run tests - YostarKR
+        run: |
+          .\x64\Debug\Sample.exe YostarKR
+        
+      - name: Run tests - txwy
+        run: |
+          .\x64\Debug\Sample.exe txwy
+
       - name: Upload logs
         if: always()
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: log
           path: .\x64\Debug\debug

.github/workflows/sync-resource.yml

@@ -0,0 +1,56 @@
+name: sync-resource
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - dev
+    paths:
+      - "resource/**"
+      - ".github/workflows/sync-resource.yml"
+
+jobs:
+  sync-reource:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout MaaAssistantArknights
+        uses: actions/checkout@v4
+        with:
+          show-progress: false
+
+      - name: Setup Git
+        run: |
+          git config --global user.name "$GITHUB_ACTOR"
+          git config --global user.email "$GITHUB_ACTOR@users.noreply.github.com"
+          git show -s
+
+      - name: Checkout MaaResource
+        uses: actions/checkout@v4
+        with:
+          repository: MaaAssistantArknights/MaaResource
+          show-progress: false
+          ssh-key: ${{secrets.MAA_RESOURCE_DEPLOY}}
+          path: MaaResource
+
+      - name: Update MaaResource
+        run: |
+          export commit_msg=$(git show -s --format=%s)
+          cd MaaResource
+          shopt -s extglob
+
+          cd resource
+          rm -rf !(".gitignore")
+          cp -rf ../../resource/* .
+          cd ..
+
+          git add .
+          git status
+          git commit -m "$commit_msg" || exit 0
+          git push
+
+      - name: Setup resource update
+        env:
+          GH_TOKEN: ${{ secrets.MISTEOWORKFLOW }}
+        run: |
+          gh workflow --repo MaaAssistantArknights/MaaRelease run update-resource.yml

.github/workflows/website-workflow.yml

@@ -0,0 +1,109 @@
+name: MaaWebsite Workflow
+
+on:
+  push:
+    branches:
+      - "master"
+      - "dev"
+    paths:
+      - ".github/workflows/website-workflow.yml"
+      - "docs/**"
+      - "website/**"
+  pull_request:
+    paths:
+      - ".github/workflows/website-workflow.yml"
+      - "docs/**"
+      - "website/**"
+  workflow_dispatch:
+    inputs:
+      deploy-to-prod-env:
+        description: "Deploy to production environment"
+        default: false
+        required: true
+        type: boolean
+
+jobs:
+  build:
+    timeout-minutes: 20
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v4
+        with:
+          show-progress: false
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+          run_install: false
+
+      - name: Setup Node.js environment
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+          cache-dependency-path: './website/pnpm-lock.yaml'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+        working-directory: "./website"
+
+      - name: Build
+        run: pnpm run build
+        working-directory: "./website"
+
+      - name: Upload artifact to GitHub
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: "./website/dist"
+
+  publish:
+    runs-on: ubuntu-latest
+    needs: build
+    if: github.event_name != 'pull_request'
+    steps:
+      - name: Download website artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+
+      - name: Set deployment environment
+        id: set-deployment-env
+        run: |
+          if [[ "${{ github.event_name }}" != "workflow_dispatch" && "${{ github.ref }}" == "refs/heads/master" ]] || [[ "${{ github.event.inputs.deploy-to-prod-env }}" == "true" ]]; then
+            echo "AZURE_TARGET_ENV=prod" >> $GITHUB_ENV
+          else
+            echo "AZURE_TARGET_ENV=dev" >> $GITHUB_ENV
+          fi
+
+      - name: Show environment
+        run: echo ${{ env.AZURE_TARGET_ENV }}
+
+      - name: Deploy to Azure (prod)
+        id: deploy-prod
+        uses: Azure/static-web-apps-deploy@v1
+        if: env.AZURE_TARGET_ENV == 'prod'
+        with:
+          azure_static_web_apps_api_token: ${{ secrets.AZURE_STATIC_WEB_APPS_MAA_WEBSITE }}
+          repo_token: ${{ secrets.GITHUB_TOKEN }}
+          action: "upload"
+          app_location: "."
+          api_location: ""
+          skip_app_build: true
+          skip_api_build: true
+
+      - name: Deploy to Azure (dev)
+        id: deploy-dev
+        uses: Azure/static-web-apps-deploy@v1
+        if: env.AZURE_TARGET_ENV == 'dev'
+        with:
+          azure_static_web_apps_api_token: ${{ secrets.AZURE_STATIC_WEB_APPS_MAA_WEBSITE }}
+          repo_token: ${{ secrets.GITHUB_TOKEN }}
+          action: "upload"
+          deployment_environment: dev
+          app_location: "."
+          api_location: ""
+          skip_app_build: true
+          skip_api_build: true

.gitignore

@@ -447,3 +447,4 @@ enc_temp_folder/*
 /resource/Arknights-Tile-Pos/act2bossrush_04-activities-act2bossrush-level_bossrush2_04.json
 # CF 活动关卡（异格夜刀），手动改的地图
 /resource/Arknights-Tile-Pos/act24side_09-activities-act24side-level_act24side_09.json
+/src/MaaWpfGui/FodyWeavers.xml

.gitmodules

@@ -12,3 +12,6 @@
 [submodule "src/maa-cli"]
 	path = src/maa-cli
 	url = https://github.com/MaaAssistantArknights/maa-cli.git
+[submodule "3rdparty/EmulatorExtras"]
+	path = 3rdparty/EmulatorExtras
+	url = https://github.com/MaaXYZ/EmulatorExtras.git

.linkspector.yml

@@ -0,0 +1,5 @@
+dirs:
+  - .
+useGitIgnore: true
+ignorePatterns:
+  - pattern: "^https?://127.0.0.1(:\\d+)?/"

3rdparty/include/Arknights-Tile-Pos/TileCalc.hpp

@@ -1,172 +0,0 @@
-#pragma once
-
-#include <cmath>
-#include <fstream>
-#include <iostream>
-#include <string>
-#include <vector>
-
-#include <meojson/json.hpp>
-#include <opencv2/core.hpp>
-
-#include "TileDef.hpp"
-
-namespace Map
-{
-    struct Tile
-    {
-        int heightType = 0;
-        int buildableType = 0;
-        std::string tileKey;
-    };
-
-    class Level
-    {
-    public:
-        Level(const json::value& data);
-        int get_width() const { return width; }
-        int get_height() const { return height; }
-        Tile get_item(int y, int x) const { return tiles[y][x]; }
-        std::vector<cv::Point3d> view;
-        LevelKey key;
-
-    private:
-        int height = 0;
-        int width = 0;
-        std::vector<std::vector<Tile>> tiles;
-    };
-
-    class TileCalc
-    {
-    public:
-        TileCalc(int width, int height);
-
-        bool run(const Level& level, bool side, std::vector<std::vector<cv::Point2d>>& out_pos,
-                 std::vector<std::vector<Tile>>& out_tiles, double shift_x = 0, double shift_y = 0) const;
-
-    private:
-        bool adapter(double& x, double& y) const;
-
-        int width = 0;
-        int height = 0;
-        const double degree = atan(1.0) * 4 / 180;
-        std::vector<Level> levels;
-        cv::Mat MatrixP = cv::Mat(4, 4, CV_64F);
-        cv::Mat MatrixX = cv::Mat(4, 4, CV_64F);
-        cv::Mat MatrixY = cv::Mat(4, 4, CV_64F);
-    };
-
-    inline void InitMat4x4(cv::Mat& m, double (*num)[4])
-    {
-        for (int i = 0; i < m.rows; i++)
-            for (int j = 0; j < m.cols; j++)
-                m.at<double>(i, j) = num[i][j];
-    }
-
-    inline Level::Level(const json::value& data)
-    {
-        key.stageId = data.at("stageId").as_string();
-        key.code = data.at("code").as_string();
-        key.levelId = data.at("levelId").as_string();
-        key.name = data.get("name", "null");
-        this->height = data.at("height").as_integer();
-        this->width = data.at("width").as_integer();
-        for (const json::value& point_data : data.at("view").as_array()) {
-            cv::Point3d tmp;
-            auto point_array = point_data.as_array();
-            tmp.x = point_array[0].as_double();
-            tmp.y = point_array[1].as_double();
-            tmp.z = point_array[2].as_double();
-            this->view.emplace_back(std::move(tmp));
-        }
-        for (const json::value& row : data.at("tiles").as_array()) {
-            std::vector<Tile> tmp;
-            tmp.reserve(this->width);
-            for (const json::value& tile : row.as_array()) {
-                tmp.emplace_back(Tile { tile.at("heightType").as_integer(), tile.at("buildableType").as_integer(),
-                                        tile.get("tileKey", std::string()) });
-            }
-            tiles.emplace_back(std::move(tmp));
-        }
-    }
-
-    inline TileCalc::TileCalc(int width, int height)
-    {
-        this->width = width;
-        this->height = height;
-        double ratio = static_cast<double>(height) / width;
-        double matrixP[4][4] { { ratio / tan(20 * degree), 0, 0, 0 },
-                               { 0, 1 / tan(20 * degree), 0, 0 },
-                               { 0, 0, -(1000 + 0.3) / (1000 - 0.3), -(1000 * 0.3 * 2) / (1000 - 0.3) },
-                               { 0, 0, -1, 0 } };
-        InitMat4x4(this->MatrixP, matrixP);
-        double matrixX[4][4] { { 1, 0, 0, 0 },
-                               { 0, cos(30 * degree), -sin(30 * degree), 0 },
-                               { 0, -sin(30 * degree), -cos(30 * degree), 0 },
-                               { 0, 0, 0, 1 } };
-        InitMat4x4(this->MatrixX, matrixX);
-        double matrixY[4][4] { { cos(10 * degree), 0, sin(10 * degree), 0 },
-                               { 0, 1, 0, 0 },
-                               { -sin(10 * degree), 0, cos(10 * degree), 0 },
-                               { 0, 0, 0, 1 } };
-        InitMat4x4(this->MatrixY, matrixY);
-    }
-
-    inline bool TileCalc::run(const Level& level, bool side, std::vector<std::vector<cv::Point2d>>& out_pos,
-                              std::vector<std::vector<Tile>>& out_tiles, double shift_x, double shift_y) const
-    {
-        auto [x, y, z] = level.view[side ? 1 : 0];
-        double adapter_y = 0, adapter_z = 0;
-        this->adapter(adapter_y, adapter_z);
-        double matrix[4][4] {
-            { 1, 0, 0, -x }, { 0, 1, 0, -y - adapter_y }, { 0, 0, 1, -z - adapter_z }, { 0, 0, 0, 1 }
-        };
-        auto raw = cv::Mat(cv::Size(4, 4), CV_64F);
-        auto Finall_Matrix = cv::Mat(cv::Size(4, 4), CV_64F);
-        InitMat4x4(raw, matrix);
-        if (side) {
-            Finall_Matrix = this->MatrixP * this->MatrixX * this->MatrixY * raw;
-        }
-        else {
-            Finall_Matrix = this->MatrixP * this->MatrixX * raw;
-        }
-        int h = level.get_height();
-        int w = level.get_width();
-        auto map_point = cv::Mat(cv::Size(1, 4), CV_64F);
-        map_point.at<double>(3, 0) = 1;
-        auto tmp_pos = std::vector<cv::Point2d>(w);
-        auto tmp_tiles = std::vector<Tile>(w);
-        for (int i = 0; i < h; i++) {
-            for (int j = 0; j < w; j++) {
-                tmp_tiles[j] = level.get_item(i, j);
-                map_point.at<double>(0, 0) = j - (w - 1) / 2.0 + shift_x;
-                map_point.at<double>(1, 0) = (h - 1) / 2.0 - i + shift_y;
-                map_point.at<double>(2, 0) = tmp_tiles[j].heightType * -0.4;
-                cv::Mat view_point = Finall_Matrix * map_point;
-                view_point = view_point / view_point.at<double>(3, 0);
-                view_point = (view_point + 1) / 2;
-                tmp_pos[j] = cv::Point2d(view_point.at<double>(0, 0) * this->width,
-                                         (1 - view_point.at<double>(1, 0)) * this->height);
-            }
-            out_pos.emplace_back(tmp_pos);
-            out_tiles.emplace_back(tmp_tiles);
-        }
-        return true;
-    }
-
-    inline bool TileCalc::adapter(double& x, double& y) const
-    {
-        const double fromRatio = 9.0 / 16;
-        const double toRatio = 3.0 / 4;
-        double ratio = static_cast<double>(height) / width;
-        if (ratio < fromRatio - 0.00001) {
-            x = 0;
-            y = 0;
-            return false;
-        }
-        double t = (ratio - fromRatio) / (toRatio - fromRatio);
-        x = -1.4 * t;
-        y = -2.8 * t;
-        return true;
-    }
-} // namespace Map

3rdparty/include/Arknights-Tile-Pos/TileCalc2.hpp

@@ -0,0 +1,137 @@
+#pragma once
+
+#include <meojson/json.hpp>
+#include <numbers>
+#include <opencv2/core/matx.hpp>
+#include <opencv2/core/types.hpp>
+
+#include "TileDef.hpp"
+
+namespace Map::TileCalc2
+{
+using vec3d = cv::Vec3d;
+using matrix4x4 = cv::Matx44d;
+static constexpr double degree = std::numbers::pi / 180;
+
+inline vec3d camera_pos(const Level& level, bool side = false, int width = 1280, int height = 720)
+{
+    const auto [x, y, z] = level.view[side ? 1 : 0];
+
+    static constexpr double fromRatio = 9. / 16;
+    static constexpr double toRatio = 3. / 4;
+    const double ratio = static_cast<double>(height) / width;
+    const double t = (fromRatio - ratio) / (fromRatio - toRatio);
+    const vec3d pos_adj = { -1.4 * t, -2.8 * t, 0 };
+    return { x + pos_adj[0], y + pos_adj[1], z + pos_adj[2] };
+}
+
+inline vec3d camera_euler_angles_yxz(const Level& /*level*/, bool side = false)
+{
+    if (side) {
+        return { 10 * degree, 30 * degree, 0 };
+    }
+
+    return { 0, 30 * degree, 0 };
+}
+
+inline matrix4x4 camera_matrix_from_trans(
+    const vec3d& pos,
+    const vec3d& euler,
+    double ratio,
+    double fov_2_y = 20 * degree,
+    double far = 1000,
+    double near = 0.3)
+{
+    const double cos_y = std::cos(euler[0]);
+    const double sin_y = std::sin(euler[0]);
+    const double cos_x = std::cos(euler[1]);
+    const double sin_x = std::sin(euler[1]);
+    const double tan_f = std::tan(fov_2_y);
+
+    const matrix4x4 translate = {
+        1, 0, 0, -pos[0], //
+        0, 1, 0, -pos[1], //
+        0, 0, 1, -pos[2], //
+        0, 0, 0, 1,
+    };
+    const matrix4x4 matrixY = {
+        cos_y,  0, sin_y, 0, //
+        0,      1, 0,     0, //
+        -sin_y, 0, cos_y, 0, //
+        0,      0, 0,     1,
+    };
+    const matrix4x4 matrixX = {
+        1, 0,      0,      0, //
+        0, cos_x,  -sin_x, 0, //
+        0, -sin_x, -cos_x, 0, //
+        0, 0,      0,      1,
+    };
+    const matrix4x4 proj = {
+        // clang-format off
+        ratio / tan_f,  0,         0, 0,
+        0,              1 / tan_f, 0, 0,
+        0,              0,         -(far + near) / (far - near), -(far * near * 2) / (far - near),
+        0,              0,         -1, 0,
+        // clang-format on
+    };
+
+    return proj * matrixX * matrixY * translate;
+}
+
+inline cv::Point
+    world_to_screen(const Level& level, const vec3d& world_pos, bool side, const vec3d& offset = {})
+{
+    static constexpr double width = 1280;
+    static constexpr double height = 720;
+    const vec3d pos_cam = camera_pos(level, side, width, height) + offset;
+    const vec3d euler = camera_euler_angles_yxz(level, side);
+    const matrix4x4 matrix = camera_matrix_from_trans(pos_cam, euler, height / width);
+    auto result = matrix * cv::Point3d(world_pos);
+    result = result / result(3);
+    result = (result + cv::Vec4d::ones()) / 2.;
+    return {
+        static_cast<int>(std::round(result(0) * width)),
+        static_cast<int>(std::round((1 - result(1)) * height)),
+    };
+}
+
+inline vec3d get_tile_world_pos(const Level& level, int tile_y, int tile_x)
+{
+    const int h = level.get_height();
+    const int w = level.get_width();
+    const auto& tile = level.get_item(tile_y, tile_x);
+    return {
+        tile_x - (w - 1) / 2.,
+        (h - 1) / 2. - tile_y,
+        tile.heightType * -0.4,
+    };
+}
+
+inline auto get_tile_screen_pos(
+    const Level& level,
+    int tile_y,
+    int tile_x,
+    bool side = false,
+    const vec3d& offset = {})
+{
+    return world_to_screen(level, get_tile_world_pos(level, tile_y, tile_x), side, offset);
+}
+
+static constexpr double rel_pos_x = 1.3143386840820312;
+static constexpr double rel_pos_y = 1.314337134361267;
+static constexpr double rel_pos_z = -0.3967874050140381;
+
+inline auto get_retreat_screen_pos(const Level& level)
+{
+    const vec3d relative_pos = { -rel_pos_x, +rel_pos_y, rel_pos_z };
+    return world_to_screen(level, relative_pos, true);
+}
+
+inline auto get_skill_screen_pos(const Level& level)
+{
+    const vec3d relative_pos = { +rel_pos_x, -rel_pos_y, rel_pos_z };
+    return world_to_screen(level, relative_pos, true);
+}
+
+} // namespace Map::TileCalc2
+

3rdparty/include/Arknights-Tile-Pos/TileDef.hpp

@@ -1,32 +1,94 @@
 #pragma once
 
 #include <string>
+#include <vector>
+
+#include <meojson/json.hpp>
+#include <opencv2/core.hpp>
 
 namespace Map
 {
-    struct LevelKey
-    {
-        std::string stageId;
-        std::string code;
-        std::string levelId;
-        std::string name;
+struct LevelKey
+{
+    std::string stageId;
+    std::string code;
+    std::string levelId;
+    std::string name;
 
-        bool empty_or_equal(const std::string& lhs, const std::string& rhs) const noexcept
-        {
-            return (lhs.empty() || rhs.empty()) ? true : lhs == rhs;
+    bool empty_or_equal(const std::string& lhs, const std::string& rhs) const noexcept
+    {
+        return (lhs.empty() || rhs.empty()) ? true : lhs == rhs;
+    }
+
+    bool operator==(const LevelKey& other) const noexcept
+    {
+        return empty_or_equal(stageId, other.stageId) && empty_or_equal(code, other.code)
+               && empty_or_equal(levelId, other.levelId) && empty_or_equal(name, other.name);
+    }
+
+    bool operator==(const std::string& any_key) const noexcept
+    {
+        if (any_key.empty()) {
+            return false;
         }
-        bool operator==(const LevelKey& other) const noexcept
-        {
-            return empty_or_equal(stageId, other.stageId) && empty_or_equal(code, other.code) &&
-                   empty_or_equal(levelId, other.levelId) && empty_or_equal(name, other.name);
+        return empty_or_equal(stageId, any_key) || empty_or_equal(code, any_key)
+               || empty_or_equal(levelId, any_key) || empty_or_equal(name, any_key);
+    }
+};
+
+struct Tile
+{
+    int heightType = 0;
+    int buildableType = 0;
+    std::string tileKey;
+};
+
+class Level
+{
+public:
+    explicit Level(const json::value& data);
+    Level() = default;
+
+    int get_width() const { return width; }
+
+    int get_height() const { return height; }
+
+    Tile get_item(int y, int x) const { return tiles[y][x]; }
+
+    std::vector<cv::Point3d> view {};
+    LevelKey key {};
+
+private:
+    int height = 0;
+    int width = 0;
+    std::vector<std::vector<Tile>> tiles;
+};
+
+inline Level::Level(const json::value& data)
+{
+    key.stageId = data.at("stageId").as_string();
+    key.code = data.at("code").as_string();
+    key.levelId = data.at("levelId").as_string();
+    key.name = data.get("name", "null");
+    this->height = data.at("height").as_integer();
+    this->width = data.at("width").as_integer();
+    for (const json::value& point_data : data.at("view").as_array()) {
+        cv::Point3d tmp;
+        auto point_array = point_data.as_array();
+        tmp.x = point_array[0].as_double();
+        tmp.y = point_array[1].as_double();
+        tmp.z = point_array[2].as_double();
+        this->view.emplace_back(tmp);
+    }
+    for (const json::value& row : data.at("tiles").as_array()) {
+        std::vector<Tile> tmp;
+        tmp.reserve(this->width);
+        for (const json::value& tile : row.as_array()) {
+            tmp.emplace_back(Tile { tile.at("heightType").as_integer(),
+                                    tile.at("buildableType").as_integer(),
+                                    tile.get("tileKey", std::string()) });
         }
-        bool operator==(const std::string& any_key) const noexcept
-        {
-            if (any_key.empty()) {
-                return false;
-            }
-            return empty_or_equal(stageId, any_key) || empty_or_equal(code, any_key) ||
-                   empty_or_equal(levelId, any_key) || empty_or_equal(name, any_key);
-        }
-    };
+        tiles.emplace_back(std::move(tmp));
+    }
 }
+} // namespace Map

3rdparty/include/meojson/.clang-format

@@ -1,195 +0,0 @@
-Language: Json
-ColumnLimit: 1000
-IndentWidth: 4
----
-Language: Cpp
-AccessModifierOffset: -4
-AlignAfterOpenBracket: Align
-AlignArrayOfStructures: None
-AlignConsecutiveMacros: None
-AlignConsecutiveAssignments: None
-AlignConsecutiveBitFields: None
-AlignConsecutiveDeclarations: None
-AlignEscapedNewlines: Left
-AlignOperands: Align
-AlignTrailingComments: true
-AllowAllArgumentsOnNextLine: true
-AllowAllParametersOfDeclarationOnNextLine: true
-AllowShortEnumsOnASingleLine: false
-AllowShortBlocksOnASingleLine: Empty
-AllowShortCaseLabelsOnASingleLine: false
-AllowShortFunctionsOnASingleLine: Inline
-AllowShortLambdasOnASingleLine: All
-AllowShortIfStatementsOnASingleLine: WithoutElse
-AllowShortLoopsOnASingleLine: false
-AlwaysBreakAfterDefinitionReturnType: None
-AlwaysBreakAfterReturnType: None
-AlwaysBreakBeforeMultilineStrings: false
-AlwaysBreakTemplateDeclarations: true
-AttributeMacros:
-  - __capability
-BinPackArguments: true
-BinPackParameters: true
-BraceWrapping:
-  AfterCaseLabel: false
-  AfterClass: true
-  AfterControlStatement: Never
-  AfterEnum: true
-  AfterFunction: true
-  AfterNamespace: true
-  AfterObjCDeclaration: true
-  AfterStruct: true
-  AfterUnion: false
-  AfterExternBlock: true
-  BeforeCatch: true
-  BeforeElse: true
-  BeforeLambdaBody: false
-  BeforeWhile: false
-  IndentBraces: false
-  SplitEmptyFunction: false
-  SplitEmptyRecord: false
-  SplitEmptyNamespace: false
-BreakBeforeBinaryOperators: None
-BreakBeforeConceptDeclarations: true
-BreakBeforeBraces: Custom
-BreakBeforeInheritanceComma: false
-BreakInheritanceList: BeforeColon
-BreakBeforeTernaryOperators: true
-BreakConstructorInitializersBeforeComma: false
-BreakConstructorInitializers: BeforeColon
-BreakAfterJavaFieldAnnotations: false
-BreakStringLiterals: true
-ColumnLimit: 120
-CommentPragmas: '^ IWYU pragma:'
-QualifierAlignment: Leave
-CompactNamespaces: false
-ConstructorInitializerIndentWidth: 4
-ContinuationIndentWidth: 4
-Cpp11BracedListStyle: false
-DeriveLineEnding: true
-DerivePointerAlignment: false
-DisableFormat: false
-EmptyLineAfterAccessModifier: Never
-EmptyLineBeforeAccessModifier: LogicalBlock
-ExperimentalAutoDetectBinPacking: false
-PackConstructorInitializers: BinPack
-BasedOnStyle: ''
-ConstructorInitializerAllOnOneLineOrOnePerLine: false
-AllowAllConstructorInitializersOnNextLine: true
-FixNamespaceComments: true
-ForEachMacros:
-  - foreach
-  - Q_FOREACH
-  - BOOST_FOREACH
-IfMacros:
-  - KJ_IF_MAYBE
-IncludeBlocks: Preserve
-IncludeCategories:
-  - Regex: '^"(llvm|llvm-c|clang|clang-c)/'
-    Priority: 2
-    SortPriority: 0
-    CaseSensitive: false
-  - Regex: '^(<|"(gtest|gmock|isl|json)/)'
-    Priority: 3
-    SortPriority: 0
-    CaseSensitive: false
-  - Regex: '.*'
-    Priority: 1
-    SortPriority: 0
-    CaseSensitive: false
-IncludeIsMainRegex: '(Test)?$'
-IncludeIsMainSourceRegex: ''
-IndentAccessModifiers: false
-IndentCaseLabels: false
-IndentCaseBlocks: false
-IndentGotoLabels: true
-IndentPPDirectives: None
-IndentExternBlock: AfterExternBlock
-IndentRequiresClause: false
-IndentWidth: 4
-IndentWrappedFunctionNames: false
-InsertTrailingCommas: None
-JavaScriptQuotes: Leave
-JavaScriptWrapImports: true
-KeepEmptyLinesAtTheStartOfBlocks: true
-LambdaBodyIndentation: Signature
-MacroBlockBegin: ''
-MacroBlockEnd: ''
-MaxEmptyLinesToKeep: 1
-NamespaceIndentation: Inner
-ObjCBinPackProtocolList: Auto
-ObjCBlockIndentWidth: 2
-ObjCBreakBeforeNestedBlockParam: true
-ObjCSpaceAfterProperty: false
-ObjCSpaceBeforeProtocolList: true
-PenaltyBreakAssignment: 2
-PenaltyBreakBeforeFirstCallParameter: 19
-PenaltyBreakComment: 300
-PenaltyBreakFirstLessLess: 120
-PenaltyBreakOpenParenthesis: 0
-PenaltyBreakString: 1000
-PenaltyBreakTemplateDeclaration: 10
-PenaltyExcessCharacter: 1000000
-PenaltyReturnTypeOnItsOwnLine: 1000
-PenaltyIndentedWhitespace: 0
-PointerAlignment: Left
-PPIndentWidth: -1
-ReferenceAlignment: Pointer
-ReflowComments: true
-RemoveBracesLLVM: false
-RequiresClausePosition: OwnLine
-SeparateDefinitionBlocks: Leave
-ShortNamespaceLines: 50
-SortIncludes: CaseSensitive
-SortJavaStaticImport: Before
-SortUsingDeclarations: true
-SpaceAfterCStyleCast: false
-SpaceAfterLogicalNot: false
-SpaceAfterTemplateKeyword: true
-SpaceBeforeAssignmentOperators: true
-SpaceBeforeCaseColon: false
-SpaceBeforeCpp11BracedList: true
-SpaceBeforeCtorInitializerColon: true
-SpaceBeforeInheritanceColon: true
-SpaceBeforeParens: ControlStatements
-SpaceBeforeParensOptions:
-  AfterControlStatements: true
-  AfterForeachMacros: true
-  AfterFunctionDefinitionName: false
-  AfterFunctionDeclarationName: false
-  AfterIfMacros: true
-  AfterOverloadedOperator: false
-  AfterRequiresInClause: true
-  AfterRequiresInExpression: true
-  BeforeNonEmptyParentheses: false
-SpaceAroundPointerQualifiers: Default
-SpaceBeforeRangeBasedForLoopColon: true
-SpaceInEmptyBlock: false
-SpaceInEmptyParentheses: false
-SpacesBeforeTrailingComments: 1
-SpacesInAngles: Never
-SpacesInConditionalStatement: false
-SpacesInContainerLiterals: true
-SpacesInCStyleCastParentheses: false
-SpacesInLineCommentPrefix:
-  Minimum: 1
-  Maximum: -1
-SpacesInParentheses: false
-SpacesInSquareBrackets: false
-SpaceBeforeSquareBrackets: false
-BitFieldColonSpacing: Both
-Standard: c++20
-StatementAttributeLikeMacros:
-  - Q_EMIT
-StatementMacros:
-  - Q_UNUSED
-  - QT_REQUIRE_VERSION
-TabWidth: 4
-UseCRLF: false
-UseTab: Never
-WhitespaceSensitiveMacros:
-  - STRINGIZE
-  - PP_STRINGIZE
-  - BOOST_PP_STRINGIZE
-  - NS_SWIFT_NAME
-  - CF_SWIFT_NAME

3rdparty/include/meojson/bitops.hpp

@@ -1,88 +0,0 @@
-#pragma once
-
-#if __cplusplus >= 202002L || (defined(_MSVC_LANG) && _MSVC_LANG >= 202002L)
-#include <bit>
-namespace json::__bitops {
-    using std::countl_one;
-    using std::countr_one;
-    using std::countl_zero;
-    using std::countr_zero;
-    inline constexpr bool is_little_endian() {
-        return std::endian::native == std::endian::little;
-    }
-}
-#else
-#include <cstdint>
-namespace json::__bitops {
-#if defined(__GNUC__) || defined(__clang__)
-    inline constexpr int countl_zero(uint32_t x) {
-        if constexpr (sizeof(uint32_t) == sizeof(unsigned int))
-            return x == 0 ? 32 : __builtin_clz(x);
-        if constexpr (sizeof(uint32_t) == sizeof(unsigned long))
-            return x == 0 ? 32 : __builtin_clzl(x);
-        return x == 0 ? 32 : __builtin_clzll(x);
-    }
-    inline constexpr int countr_zero(uint32_t x) {
-        if constexpr (sizeof(uint32_t) == sizeof(unsigned int))
-            return x == 0 ? 32 : __builtin_ctz(x);
-        if constexpr (sizeof(uint32_t) == sizeof(unsigned long))
-            return x == 0 ? 32 : __builtin_ctzl(x);
-        return x == 0 ? 32 : __builtin_ctzll(x);
-    }
-    inline constexpr int countl_zero(uint64_t x) {
-        return x == 0 ? 64 : __builtin_clzll(x);
-    }
-    inline constexpr int countr_zero(uint64_t x) {
-        return x == 0 ? 64 : __builtin_ctzll(x);
-    }
-#elif defined(_MSC_VER)
-#ifdef __AVX2__
-    // lzcnt intrinsics is not constexpr
-    inline int countl_zero(uint32_t x) {
-        return __lzcnt(x);
-    }
-    inline int countr_zero(uint32_t x) {
-        return _tzcnt_u32(x);
-    }
-    inline int countl_zero(uint64_t x) {
-        return (int)__lzcnt64(x);
-    }
-    inline int countr_zero(uint64_t x) {
-        return (int)_tzcnt_u64(x);
-    }
-#else
-    inline constexpr int countl_zero(uint32_t x) {
-        unsigned long index = 0;
-        return _BitScanReverse(&index, x) ? 31 - index : 32;
-    }
-    inline constexpr int countr_zero(uint32_t x) {
-        unsigned long index = 0;
-        return _BitScanForward(&index, x) ? index : 32;
-    }
-    inline constexpr int countl_zero(uint64_t x) {
-        unsigned long index = 0;
-        return _BitScanReverse64(&index, x) ? 63 - index : 64;
-    }
-    inline constexpr int countr_zero(uint64_t x) {
-        unsigned long index = 0;
-        return _BitScanForward64(&index, x) ? index : 64;
-    }
-#endif // __AVX2__
-#else // compiler
-#error "bring your own bit counting implementation"
-#endif
-    inline int countl_one(uint32_t x) { return countl_zero(~x); }
-    inline int countr_one(uint32_t x) { return countr_zero(~x); }
-    inline int countl_one(uint64_t x) { return countl_zero(~x); }
-    inline int countr_one(uint64_t x) { return countr_zero(~x); }
-
-    // no constexpr endian awareness before C++20
-    inline bool is_little_endian() {
-        union {
-            uint32_t u32;
-            uint8_t u8;
-        } u = { 0x01020304 };
-        return u.u8 == 4;
-    }
-}
-#endif // C++20

3rdparty/include/meojson/common/array.hpp

@@ -0,0 +1,533 @@
+#pragma once
+
+#include <initializer_list>
+#include <optional>
+#include <ostream>
+#include <string>
+#include <tuple>
+#include <vector>
+
+#include "exception.hpp"
+#include "utils.hpp"
+
+namespace json
+{
+template <typename string_t>
+class basic_array
+{
+    friend class basic_value<string_t>;
+    friend class basic_object<string_t>;
+
+public:
+    using raw_array = std::vector<basic_value<string_t>>;
+    using value_type = typename raw_array::value_type;
+    using iterator = typename raw_array::iterator;
+    using const_iterator = typename raw_array::const_iterator;
+    using reverse_iterator = typename raw_array::reverse_iterator;
+    using const_reverse_iterator = typename raw_array::const_reverse_iterator;
+    using char_t = typename string_t::value_type;
+
+public:
+    basic_array() = default;
+    basic_array(const basic_array<string_t>& rhs) = default;
+    basic_array(basic_array<string_t>&& rhs) noexcept = default;
+    basic_array(std::initializer_list<value_type> init_list);
+    basic_array(typename raw_array::size_type size);
+
+    // explicit basic_array(const basic_value<string_t>& val);
+    // explicit basic_array(basic_value<string_t>&& val);
+
+    template <typename collection_t,
+              std::enable_if_t<_utils::is_collection<collection_t> &&
+                                   std::is_constructible_v<value_type, _utils::range_value_t<collection_t>>,
+                               bool> = true>
+    basic_array(collection_t arr)
+        : _array_data(std::make_move_iterator(arr.begin()), std::make_move_iterator(arr.end()))
+    {}
+    template <typename jsonization_t,
+              std::enable_if_t<_utils::has_to_json_in_member<jsonization_t>::value, bool> = true>
+    basic_array(const jsonization_t& value) : basic_array(value.to_json())
+    {}
+    template <typename jsonization_t,
+              std::enable_if_t<_utils::has_to_json_in_templ_spec<jsonization_t>::value, bool> = true>
+    basic_array(const jsonization_t& value) : basic_array(ext::jsonization<jsonization_t>().to_json(value))
+    {}
+
+    ~basic_array() noexcept = default;
+
+    bool empty() const noexcept { return _array_data.empty(); }
+    size_t size() const noexcept { return _array_data.size(); }
+    bool contains(size_t pos) const { return pos < _array_data.size(); }
+    bool exists(size_t pos) const { return contains(pos); }
+    const basic_value<string_t>& at(size_t pos) const;
+
+    string_t dumps(std::optional<size_t> indent = std::nullopt) const { return indent ? format(*indent) : to_string(); }
+    string_t to_string() const;
+    string_t format(size_t indent = 4) const { return format(indent, 0); }
+    template <typename value_t>
+    bool all() const;
+    template <typename value_t, template <typename...> typename collection_t = std::vector>
+    collection_t<value_t> as_collection() const;
+
+    // Usage: get(key_1, key_2, ..., default_value);
+    template <typename... key_then_default_value_t>
+    auto get(key_then_default_value_t&&... keys_then_default_value) const;
+
+    template <typename value_t = basic_value<string_t>>
+    std::optional<value_t> find(size_t pos) const;
+
+    template <typename... args_t>
+    decltype(auto) emplace_back(args_t&&... args);
+    template <typename... args_t>
+    decltype(auto) push_back(args_t&&... args);
+
+    void clear() noexcept;
+    bool erase(size_t pos);
+    bool erase(iterator iter);
+
+    iterator begin() noexcept;
+    iterator end() noexcept;
+    const_iterator begin() const noexcept;
+    const_iterator end() const noexcept;
+    const_iterator cbegin() const noexcept;
+    const_iterator cend() const noexcept;
+
+    reverse_iterator rbegin() noexcept;
+    reverse_iterator rend() noexcept;
+    const_reverse_iterator rbegin() const noexcept;
+    const_reverse_iterator rend() const noexcept;
+    const_reverse_iterator crbegin() const noexcept;
+    const_reverse_iterator crend() const noexcept;
+
+    const basic_value<string_t>& operator[](size_t pos) const;
+    basic_value<string_t>& operator[](size_t pos);
+
+    basic_array<string_t> operator+(const basic_array<string_t>& rhs) const&;
+    basic_array<string_t> operator+(basic_array<string_t>&& rhs) const&;
+    basic_array<string_t> operator+(const basic_array<string_t>& rhs) &&;
+    basic_array<string_t> operator+(basic_array<string_t>&& rhs) &&;
+
+    basic_array<string_t>& operator+=(const basic_array<string_t>& rhs);
+    basic_array<string_t>& operator+=(basic_array<string_t>&& rhs);
+
+    basic_array<string_t>& operator=(const basic_array<string_t>&) = default;
+    basic_array<string_t>& operator=(basic_array<string_t>&&) noexcept = default;
+    template <typename value_t, std::enable_if_t<std::is_convertible_v<value_t, basic_array<string_t>>, bool> = true>
+    basic_array<string_t>& operator=(value_t rhs)
+    {
+        return *this = basic_array<string_t>(std::move(rhs));
+    }
+
+    bool operator==(const basic_array<string_t>& rhs) const;
+    bool operator!=(const basic_array<string_t>& rhs) const { return !(*this == rhs); }
+
+    template <typename value_t, template <typename...> typename collection_t = std::vector,
+              std::enable_if_t<_utils::is_collection<collection_t<value_t>>, bool> = true>
+    explicit operator collection_t<value_t>() const
+    {
+        return as_collection<value_t, collection_t>();
+    }
+    template <typename jsonization_t,
+              std::enable_if_t<_utils::has_from_json_in_member<jsonization_t, string_t>::value, bool> = true>
+    explicit operator jsonization_t() const
+    {
+        jsonization_t dst {};
+        if (!dst.from_json(*this)) {
+            throw exception("Wrong JSON");
+        }
+        return dst;
+    }
+    template <typename jsonization_t,
+              std::enable_if_t<_utils::has_from_json_in_templ_spec<jsonization_t, string_t>::value, bool> = true>
+    explicit operator jsonization_t() const
+    {
+        jsonization_t dst {};
+        if (!ext::jsonization<jsonization_t>().from_json(*this, dst)) {
+            throw exception("Wrong JSON");
+        }
+        return dst;
+    }
+
+private:
+    template <typename... key_then_default_value_t, size_t... keys_indexes_t>
+    auto get(std::tuple<key_then_default_value_t...> keys_then_default_value,
+             std::index_sequence<keys_indexes_t...>) const;
+    template <typename value_t, typename... rest_keys_t>
+    auto get_helper(const value_t& default_value, size_t pos, rest_keys_t&&... rest) const;
+    template <typename value_t>
+    auto get_helper(const value_t& default_value, size_t pos) const;
+
+    string_t format(size_t indent, size_t indent_times) const;
+
+private:
+    raw_array _array_data;
+};
+
+template <typename string_t>
+inline basic_array<string_t>::basic_array(std::initializer_list<value_type> init_list) : _array_data(init_list)
+{}
+
+template <typename string_t>
+inline basic_array<string_t>::basic_array(typename raw_array::size_type size) : _array_data(size)
+{}
+
+// template <typename string_t>
+// inline basic_array<string_t>::basic_array(const basic_value<string_t>& val) : basic_array<string_t>(val.as_array())
+//{}
+//
+// template <typename string_t>
+// inline basic_array<string_t>::basic_array(basic_value<string_t>&& val)
+//     : basic_array<string_t>(std::move(val.as_array()))
+//{}
+
+template <typename string_t>
+inline void basic_array<string_t>::clear() noexcept
+{
+    _array_data.clear();
+}
+
+template <typename string_t>
+inline bool basic_array<string_t>::erase(size_t pos)
+{
+    return erase(_array_data.begin() + pos);
+}
+
+template <typename string_t>
+inline bool basic_array<string_t>::erase(iterator iter)
+{
+    return _array_data.erase(iter) != _array_data.end();
+}
+
+template <typename string_t>
+template <typename... args_t>
+inline decltype(auto) basic_array<string_t>::emplace_back(args_t&&... args)
+{
+    static_assert(std::is_constructible_v<value_type, args_t...>,
+                  "Parameter can't be used to construct a raw_array::value_type");
+    return _array_data.emplace_back(std::forward<args_t>(args)...);
+}
+
+template <typename string_t>
+template <typename... args_t>
+inline decltype(auto) basic_array<string_t>::push_back(args_t&&... args)
+{
+    return emplace_back(std::forward<args_t>(args)...);
+}
+
+template <typename string_t>
+inline const basic_value<string_t>& basic_array<string_t>::at(size_t pos) const
+{
+    return _array_data.at(pos);
+}
+
+template <typename string_t>
+inline string_t basic_array<string_t>::to_string() const
+{
+    string_t str { '[' };
+    for (auto iter = _array_data.cbegin(); iter != _array_data.cend();) {
+        str += iter->to_string();
+        if (++iter != _array_data.cend()) {
+            str += ',';
+        }
+    }
+    str += char_t(']');
+    return str;
+}
+
+template <typename string_t>
+inline string_t basic_array<string_t>::format(size_t indent, size_t indent_times) const
+{
+    const string_t tail_indent(indent * indent_times, ' ');
+    const string_t body_indent(indent * (indent_times + 1), ' ');
+
+    string_t str { '[', '\n' };
+    for (auto iter = _array_data.cbegin(); iter != _array_data.cend();) {
+        str += body_indent + iter->format(indent, indent_times + 1);
+        if (++iter != _array_data.cend()) {
+            str += ',';
+        }
+        str += '\n';
+    }
+    str += tail_indent + char_t(']');
+    return str;
+}
+
+template <typename string_t>
+template <typename value_t>
+inline bool basic_array<string_t>::all() const
+{
+    for (const auto& elem : _array_data) {
+        if (!elem.template is<value_t>()) {
+            return false;
+        }
+    }
+    return true;
+}
+
+namespace _as_collection_helper
+{
+    template <typename T>
+    class has_emplace_back
+    {
+        template <typename U>
+        static auto test(int) -> decltype(std::declval<U>().emplace_back(), std::true_type());
+
+        template <typename U>
+        static std::false_type test(...);
+
+    public:
+        static constexpr bool value = decltype(test<T>(0))::value;
+    };
+}
+
+template <typename string_t>
+template <typename value_t, template <typename...> typename collection_t>
+inline collection_t<value_t> basic_array<string_t>::as_collection() const
+{
+    collection_t<value_t> result;
+    if constexpr (_as_collection_helper::has_emplace_back<collection_t<value_t>>::value) {
+        for (const auto& elem : _array_data) {
+            result.emplace_back(elem.template as<value_t>());
+        }
+    }
+    else {
+        for (const auto& elem : _array_data) {
+            result.emplace(elem.template as<value_t>());
+        }
+    }
+    return result;
+}
+
+template <typename string_t>
+template <typename... key_then_default_value_t>
+inline auto basic_array<string_t>::get(key_then_default_value_t&&... keys_then_default_value) const
+{
+    return get(std::forward_as_tuple(keys_then_default_value...),
+               std::make_index_sequence<sizeof...(keys_then_default_value) - 1> {});
+}
+
+template <typename string_t>
+template <typename... key_then_default_value_t, size_t... keys_indexes_t>
+inline auto basic_array<string_t>::get(std::tuple<key_then_default_value_t...> keys_then_default_value,
+                                       std::index_sequence<keys_indexes_t...>) const
+{
+    constexpr unsigned long default_value_index = sizeof...(key_then_default_value_t) - 1;
+    return get_helper(std::get<default_value_index>(keys_then_default_value),
+                      std::get<keys_indexes_t>(keys_then_default_value)...);
+}
+
+template <typename string_t>
+template <typename value_t, typename... rest_keys_t>
+inline auto basic_array<string_t>::get_helper(const value_t& default_value, size_t pos, rest_keys_t&&... rest) const
+{
+    constexpr bool is_json = std::is_same_v<basic_value<string_t>, value_t> ||
+                             std::is_same_v<basic_array<string_t>, value_t> ||
+                             std::is_same_v<basic_object<string_t>, value_t>;
+    constexpr bool is_string = std::is_constructible_v<string_t, value_t> && !is_json;
+
+    if (!contains(pos)) {
+        if constexpr (is_string) {
+            return string_t(default_value);
+        }
+        else {
+            return value_t(default_value);
+        }
+    }
+
+    return at(pos).get_helper(default_value, std::forward<rest_keys_t>(rest)...);
+}
+
+template <typename string_t>
+template <typename value_t>
+inline auto basic_array<string_t>::get_helper(const value_t& default_value, size_t pos) const
+{
+    constexpr bool is_json = std::is_same_v<basic_value<string_t>, value_t> ||
+                             std::is_same_v<basic_array<string_t>, value_t> ||
+                             std::is_same_v<basic_object<string_t>, value_t>;
+    constexpr bool is_string = std::is_constructible_v<string_t, value_t> && !is_json;
+
+    if (!contains(pos)) {
+        if constexpr (is_string) {
+            return string_t(default_value);
+        }
+        else {
+            return value_t(default_value);
+        }
+    }
+
+    auto val = _array_data.at(pos);
+    if (val.template is<value_t>()) {
+        if constexpr (is_string) {
+            return val.template as<string_t>();
+        }
+        else {
+            return val.template as<value_t>();
+        }
+    }
+    else {
+        if constexpr (is_string) {
+            return string_t(default_value);
+        }
+        else {
+            return value_t(default_value);
+        }
+    }
+}
+
+template <typename string_t>
+template <typename value_t>
+inline std::optional<value_t> basic_array<string_t>::find(size_t pos) const
+{
+    if (!contains(pos)) {
+        return std::nullopt;
+    }
+    const auto& val = _array_data.at(pos);
+    return val.template is<value_t>() ? std::optional<value_t>(val.template as<value_t>()) : std::nullopt;
+}
+
+template <typename string_t>
+inline typename basic_array<string_t>::iterator basic_array<string_t>::begin() noexcept
+{
+    return _array_data.begin();
+}
+
+template <typename string_t>
+inline typename basic_array<string_t>::iterator basic_array<string_t>::end() noexcept
+{
+    return _array_data.end();
+}
+
+template <typename string_t>
+inline typename basic_array<string_t>::const_iterator basic_array<string_t>::begin() const noexcept
+{
+    return _array_data.begin();
+}
+
+template <typename string_t>
+inline typename basic_array<string_t>::const_iterator basic_array<string_t>::end() const noexcept
+{
+    return _array_data.end();
+}
+
+template <typename string_t>
+inline typename basic_array<string_t>::const_iterator basic_array<string_t>::cbegin() const noexcept
+{
+    return _array_data.cbegin();
+}
+
+template <typename string_t>
+inline typename basic_array<string_t>::const_iterator basic_array<string_t>::cend() const noexcept
+{
+    return _array_data.cend();
+}
+
+template <typename string_t>
+inline typename basic_array<string_t>::reverse_iterator basic_array<string_t>::rbegin() noexcept
+{
+    return _array_data.rbegin();
+}
+
+template <typename string_t>
+inline typename basic_array<string_t>::reverse_iterator basic_array<string_t>::rend() noexcept
+{
+    return _array_data.rend();
+}
+
+template <typename string_t>
+inline typename basic_array<string_t>::const_reverse_iterator basic_array<string_t>::rbegin() const noexcept
+{
+    return _array_data.rbegin();
+}
+
+template <typename string_t>
+inline typename basic_array<string_t>::const_reverse_iterator basic_array<string_t>::rend() const noexcept
+{
+    return _array_data.rend();
+}
+
+template <typename string_t>
+inline typename basic_array<string_t>::const_reverse_iterator basic_array<string_t>::crbegin() const noexcept
+{
+    return _array_data.crbegin();
+}
+
+template <typename string_t>
+inline typename basic_array<string_t>::const_reverse_iterator basic_array<string_t>::crend() const noexcept
+{
+    return _array_data.crend();
+}
+
+template <typename string_t>
+inline basic_value<string_t>& basic_array<string_t>::operator[](size_t pos)
+{
+    return _array_data[pos];
+}
+
+template <typename string_t>
+inline const basic_value<string_t>& basic_array<string_t>::operator[](size_t pos) const
+{
+    return _array_data[pos];
+}
+
+template <typename string_t>
+inline basic_array<string_t> basic_array<string_t>::operator+(const basic_array<string_t>& rhs) const&
+{
+    basic_array<string_t> temp = *this;
+    temp._array_data.insert(_array_data.end(), rhs.begin(), rhs.end());
+    return temp;
+}
+
+template <typename string_t>
+inline basic_array<string_t> basic_array<string_t>::operator+(basic_array<string_t>&& rhs) const&
+{
+    basic_array<string_t> temp = *this;
+    temp._array_data.insert(_array_data.end(), std::make_move_iterator(rhs.begin()),
+                            std::make_move_iterator(rhs.end()));
+    return temp;
+}
+
+template <typename string_t>
+inline basic_array<string_t> basic_array<string_t>::operator+(const basic_array<string_t>& rhs) &&
+{
+    _array_data.insert(_array_data.end(), rhs.begin(), rhs.end());
+    return std::move(*this);
+}
+
+template <typename string_t>
+inline basic_array<string_t> basic_array<string_t>::operator+(basic_array<string_t>&& rhs) &&
+{
+    _array_data.insert(_array_data.end(), std::make_move_iterator(rhs.begin()), std::make_move_iterator(rhs.end()));
+    return std::move(*this);
+}
+
+template <typename string_t>
+inline basic_array<string_t>& basic_array<string_t>::operator+=(const basic_array<string_t>& rhs)
+{
+    _array_data.insert(_array_data.end(), rhs.begin(), rhs.end());
+    return *this;
+}
+
+template <typename string_t>
+inline basic_array<string_t>& basic_array<string_t>::operator+=(basic_array<string_t>&& rhs)
+{
+    _array_data.insert(_array_data.end(), std::make_move_iterator(rhs.begin()), std::make_move_iterator(rhs.end()));
+    return *this;
+}
+
+template <typename string_t>
+inline bool basic_array<string_t>::operator==(const basic_array<string_t>& rhs) const
+{
+    return _array_data == rhs._array_data;
+}
+
+template <typename ostream_t, typename string_t,
+          typename std_ostream_t =
+              std::basic_ostream<typename string_t::value_type, std::char_traits<typename string_t::value_type>>,
+          typename enable_t =
+              std::enable_if_t<std::is_same_v<std_ostream_t, ostream_t> || std::is_base_of_v<std_ostream_t, ostream_t>>>
+ostream_t& operator<<(ostream_t& out, const basic_array<string_t>& arr)
+{
+    out << arr.format();
+    return out;
+}
+} // namespace json

3rdparty/include/meojson/common/exception.hpp

@@ -0,0 +1,26 @@
+#pragma once
+
+#include <exception>
+#include <string>
+
+namespace json
+{
+class exception : public std::exception
+{
+public:
+    exception() = default;
+    exception(const std::string& msg) : _what(msg) {}
+
+    exception(const exception&) = default;
+    exception& operator=(const exception&) = default;
+    exception(exception&&) = default;
+    exception& operator=(exception&&) = default;
+
+    virtual ~exception() noexcept override = default;
+
+    virtual const char* what() const noexcept override { return _what.empty() ? "Unknown exception" : _what.c_str(); }
+
+protected:
+    std::string _what;
+};
+}

3rdparty/include/meojson/common/object.hpp

@@ -0,0 +1,474 @@
+#pragma once
+
+#include <initializer_list>
+#include <map>
+#include <optional>
+#include <ostream>
+#include <string>
+#include <tuple>
+
+#include "exception.hpp"
+#include "utils.hpp"
+
+namespace json
+{
+template <typename string_t>
+class basic_object
+{
+    friend class basic_value<string_t>;
+    friend class basic_array<string_t>;
+
+public:
+    using raw_object = std::map<string_t, basic_value<string_t>>;
+    using key_type = typename raw_object::key_type;
+    using mapped_type = typename raw_object::mapped_type;
+    using value_type = typename raw_object::value_type;
+    using iterator = typename raw_object::iterator;
+    using const_iterator = typename raw_object::const_iterator;
+    using char_t = typename string_t::value_type;
+
+public:
+    basic_object() = default;
+    basic_object(const basic_object<string_t>& rhs) = default;
+    basic_object(basic_object<string_t>&& rhs) noexcept = default;
+    basic_object(std::initializer_list<value_type> init_list);
+
+    // explicit basic_object(const basic_value<string_t>& val);
+    // explicit basic_object(basic_value<string_t>&& val);
+
+    template <typename map_t, std::enable_if_t<_utils::is_map<map_t> &&
+                                                   std::is_constructible_v<value_type, _utils::range_value_t<map_t>>,
+                                               bool> = true>
+    basic_object(map_t map) : _object_data(std::make_move_iterator(map.begin()), std::make_move_iterator(map.end()))
+    {}
+    template <typename jsonization_t,
+              std::enable_if_t<_utils::has_to_json_in_member<jsonization_t>::value, bool> = true>
+    basic_object(const jsonization_t& value) : basic_object(value.to_json())
+    {}
+    template <typename jsonization_t,
+              std::enable_if_t<_utils::has_to_json_in_templ_spec<jsonization_t>::value, bool> = true>
+    basic_object(const jsonization_t& value) : basic_object(ext::jsonization<jsonization_t>().to_json(value))
+    {}
+
+    ~basic_object() = default;
+
+    bool empty() const noexcept { return _object_data.empty(); }
+    size_t size() const noexcept { return _object_data.size(); }
+    bool contains(const string_t& key) const;
+    bool exists(const string_t& key) const { return contains(key); }
+    const basic_value<string_t>& at(const string_t& key) const;
+
+    string_t dumps(std::optional<size_t> indent = std::nullopt) const { return indent ? format(*indent) : to_string(); }
+    string_t to_string() const;
+    string_t format(size_t indent = 4) const { return format(indent, 0); }
+    template <typename value_t>
+    bool all() const;
+    template <typename value_t, template <typename...> typename map_t = std::map>
+    map_t<string_t, value_t> as_map() const;
+
+    // Usage: get(key_1, key_2, ..., default_value);
+    template <typename... key_then_default_value_t>
+    auto get(key_then_default_value_t&&... keys_then_default_value) const;
+
+    template <typename value_t = basic_value<string_t>>
+    std::optional<value_t> find(const string_t& key) const;
+
+    template <typename... args_t>
+    decltype(auto) emplace(args_t&&... args);
+    template <typename... args_t>
+    decltype(auto) insert(args_t&&... args);
+
+    void clear() noexcept;
+    bool erase(const string_t& key);
+    bool erase(iterator iter);
+
+    iterator begin() noexcept;
+    iterator end() noexcept;
+    const_iterator begin() const noexcept;
+    const_iterator end() const noexcept;
+    const_iterator cbegin() const noexcept;
+    const_iterator cend() const noexcept;
+
+    basic_value<string_t>& operator[](const string_t& key);
+    basic_value<string_t>& operator[](string_t&& key);
+
+    basic_object<string_t> operator|(const basic_object<string_t>& rhs) const&;
+    basic_object<string_t> operator|(basic_object<string_t>&& rhs) const&;
+    basic_object<string_t> operator|(const basic_object<string_t>& rhs) &&;
+    basic_object<string_t> operator|(basic_object<string_t>&& rhs) &&;
+
+    basic_object<string_t>& operator|=(const basic_object<string_t>& rhs);
+    basic_object<string_t>& operator|=(basic_object<string_t>&& rhs);
+
+    basic_object<string_t>& operator=(const basic_object<string_t>&) = default;
+    basic_object<string_t>& operator=(basic_object<string_t>&&) = default;
+    template <typename value_t, std::enable_if_t<std::is_convertible_v<value_t, basic_object<string_t>>, bool> = true>
+    basic_object<string_t>& operator=(value_t rhs)
+    {
+        return *this = basic_object<string_t>(std::move(rhs));
+    }
+
+    bool operator==(const basic_object<string_t>& rhs) const;
+    bool operator!=(const basic_object<string_t>& rhs) const { return !(*this == rhs); }
+
+    template <typename value_t, template <typename...> typename map_t = std::map,
+              std::enable_if_t<_utils::is_map<map_t<string_t, value_t>>, bool> = true>
+    explicit operator map_t<string_t, value_t>() const
+    {
+        return as_map<value_t, map_t>();
+    }
+    template <typename jsonization_t,
+              std::enable_if_t<_utils::has_from_json_in_member<jsonization_t, string_t>::value, bool> = true>
+    explicit operator jsonization_t() const
+    {
+        jsonization_t dst {};
+        if (!dst.from_json(*this)) {
+            throw exception("Wrong JSON");
+        }
+        return dst;
+    }
+    template <typename jsonization_t,
+              std::enable_if_t<_utils::has_from_json_in_templ_spec<jsonization_t, string_t>::value, bool> = true>
+    explicit operator jsonization_t() const
+    {
+        jsonization_t dst {};
+        if (!ext::jsonization<jsonization_t>().from_json(*this, dst)) {
+            throw exception("Wrong JSON");
+        }
+        return dst;
+    }
+
+private:
+    template <typename... key_then_default_value_t, size_t... keys_indexes_t>
+    auto get(std::tuple<key_then_default_value_t...> keys_then_default_value,
+             std::index_sequence<keys_indexes_t...>) const;
+    template <typename value_t, typename... rest_keys_t>
+    auto get_helper(const value_t& default_value, const string_t& key, rest_keys_t&&... rest) const;
+    template <typename value_t>
+    auto get_helper(const value_t& default_value, const string_t& key) const;
+
+    string_t format(size_t indent, size_t indent_times) const;
+
+private:
+    raw_object _object_data;
+};
+
+template <typename string_t>
+inline basic_object<string_t>::basic_object(std::initializer_list<value_type> init_list)
+    : _object_data(std::make_move_iterator(init_list.begin()), std::make_move_iterator(init_list.end()))
+{}
+
+// template <typename string_t>
+// inline basic_object<string_t>::basic_object(const basic_value<string_t>& val) :
+// basic_object<string_t>(val.as_object())
+//{}
+//
+// template <typename string_t>
+// inline basic_object<string_t>::basic_object(basic_value<string_t>&& val)
+//     : basic_object<string_t>(std::move(val.as_object()))
+//{}
+
+template <typename string_t>
+inline bool basic_object<string_t>::contains(const string_t& key) const
+{
+    return _object_data.find(key) != _object_data.cend();
+}
+
+template <typename string_t>
+inline const basic_value<string_t>& basic_object<string_t>::at(const string_t& key) const
+{
+    return _object_data.at(key);
+}
+
+template <typename string_t>
+inline void basic_object<string_t>::clear() noexcept
+{
+    _object_data.clear();
+}
+
+template <typename string_t>
+inline bool basic_object<string_t>::erase(const string_t& key)
+{
+    return _object_data.erase(key) > 0 ? true : false;
+}
+
+template <typename string_t>
+inline bool basic_object<string_t>::erase(iterator iter)
+{
+    return _object_data.erase(iter) != _object_data.end();
+}
+
+template <typename string_t>
+template <typename... args_t>
+inline decltype(auto) basic_object<string_t>::emplace(args_t&&... args)
+{
+    static_assert(std::is_constructible_v<value_type, args_t...>,
+                  "Parameter can't be used to construct a raw_object::value_type");
+    return _object_data.emplace(std::forward<args_t>(args)...);
+}
+
+template <typename string_t>
+template <typename... args_t>
+inline decltype(auto) basic_object<string_t>::insert(args_t&&... args)
+{
+    return emplace(std::forward<args_t>(args)...);
+}
+
+template <typename string_t>
+inline string_t basic_object<string_t>::to_string() const
+{
+    string_t str { '{' };
+    for (auto iter = _object_data.cbegin(); iter != _object_data.cend();) {
+        const auto& [key, val] = *iter;
+        str += char_t('"') + _utils::unescape_string(key) + string_t { '\"', ':' } + val.to_string();
+        if (++iter != _object_data.cend()) {
+            str += ',';
+        }
+    }
+    str += char_t('}');
+    return str;
+}
+
+template <typename string_t>
+inline string_t basic_object<string_t>::format(size_t indent, size_t indent_times) const
+{
+    const string_t tail_indent(indent * indent_times, ' ');
+    const string_t body_indent(indent * (indent_times + 1), ' ');
+
+    string_t str { '{', '\n' };
+    for (auto iter = _object_data.cbegin(); iter != _object_data.cend();) {
+        const auto& [key, val] = *iter;
+        str += body_indent + char_t('"') + _utils::unescape_string(key) + string_t { '\"', ':', ' ' } +
+               val.format(indent, indent_times + 1);
+        if (++iter != _object_data.cend()) {
+            str += ',';
+        }
+        str += '\n';
+    }
+    str += tail_indent + char_t('}');
+    return str;
+}
+
+template <typename string_t>
+template <typename value_t>
+inline bool basic_object<string_t>::all() const
+{
+    for (const auto& [_, val] : _object_data) {
+        if (!val.template is<value_t>()) {
+            return false;
+        }
+    }
+    return true;
+}
+
+template <typename string_t>
+template <typename value_t, template <typename...> typename map_t>
+inline map_t<string_t, value_t> basic_object<string_t>::as_map() const
+{
+    map_t<string_t, value_t> result;
+    for (const auto& [key, val] : _object_data) {
+        result.emplace(key, val.template as<value_t>());
+    }
+    return result;
+}
+
+template <typename string_t>
+template <typename... key_then_default_value_t>
+inline auto basic_object<string_t>::get(key_then_default_value_t&&... keys_then_default_value) const
+{
+    return get(std::forward_as_tuple(keys_then_default_value...),
+               std::make_index_sequence<sizeof...(keys_then_default_value) - 1> {});
+}
+
+template <typename string_t>
+template <typename... key_then_default_value_t, size_t... keys_indexes_t>
+inline auto basic_object<string_t>::get(std::tuple<key_then_default_value_t...> keys_then_default_value,
+                                        std::index_sequence<keys_indexes_t...>) const
+{
+    constexpr unsigned long default_value_index = sizeof...(key_then_default_value_t) - 1;
+    return get_helper(std::get<default_value_index>(keys_then_default_value),
+                      std::get<keys_indexes_t>(keys_then_default_value)...);
+}
+
+template <typename string_t>
+template <typename value_t, typename... rest_keys_t>
+inline auto basic_object<string_t>::get_helper(const value_t& default_value, const string_t& key,
+                                               rest_keys_t&&... rest) const
+{
+    constexpr bool is_json = std::is_same_v<basic_value<string_t>, value_t> ||
+                             std::is_same_v<basic_array<string_t>, value_t> ||
+                             std::is_same_v<basic_object<string_t>, value_t>;
+    constexpr bool is_string = std::is_constructible_v<string_t, value_t> && !is_json;
+
+    if (!contains(key)) {
+        if constexpr (is_string) {
+            return string_t(default_value);
+        }
+        else {
+            return value_t(default_value);
+        }
+    }
+
+    return at(key).get_helper(default_value, std::forward<rest_keys_t>(rest)...);
+}
+
+template <typename string_t>
+template <typename value_t>
+inline auto basic_object<string_t>::get_helper(const value_t& default_value, const string_t& key) const
+{
+    constexpr bool is_json = std::is_same_v<basic_value<string_t>, value_t> ||
+                             std::is_same_v<basic_array<string_t>, value_t> ||
+                             std::is_same_v<basic_object<string_t>, value_t>;
+    constexpr bool is_string = std::is_constructible_v<string_t, value_t> && !is_json;
+
+    if (!contains(key)) {
+        if constexpr (is_string) {
+            return string_t(default_value);
+        }
+        else {
+            return value_t(default_value);
+        }
+    }
+
+    auto val = _object_data.at(key);
+    if (val.template is<value_t>()) {
+        if constexpr (is_string) {
+            return val.template as<string_t>();
+        }
+        else {
+            return val.template as<value_t>();
+        }
+    }
+    else {
+        if constexpr (is_string) {
+            return string_t(default_value);
+        }
+        else {
+            return value_t(default_value);
+        }
+    }
+}
+
+template <typename string_t>
+template <typename value_t>
+inline std::optional<value_t> basic_object<string_t>::find(const string_t& key) const
+{
+    auto iter = _object_data.find(key);
+    if (iter == _object_data.end()) {
+        return std::nullopt;
+    }
+    const auto& val = iter->second;
+    return val.template is<value_t>() ? std::optional<value_t>(val.template as<value_t>()) : std::nullopt;
+}
+
+template <typename string_t>
+inline typename basic_object<string_t>::iterator basic_object<string_t>::begin() noexcept
+{
+    return _object_data.begin();
+}
+
+template <typename string_t>
+inline typename basic_object<string_t>::iterator basic_object<string_t>::end() noexcept
+{
+    return _object_data.end();
+}
+
+template <typename string_t>
+inline typename basic_object<string_t>::const_iterator basic_object<string_t>::begin() const noexcept
+{
+    return _object_data.begin();
+}
+
+template <typename string_t>
+inline typename basic_object<string_t>::const_iterator basic_object<string_t>::end() const noexcept
+{
+    return _object_data.end();
+}
+
+template <typename string_t>
+inline typename basic_object<string_t>::const_iterator basic_object<string_t>::cbegin() const noexcept
+{
+    return _object_data.cbegin();
+}
+
+template <typename string_t>
+inline typename basic_object<string_t>::const_iterator basic_object<string_t>::cend() const noexcept
+{
+    return _object_data.cend();
+}
+
+template <typename string_t>
+inline basic_value<string_t>& basic_object<string_t>::operator[](const string_t& key)
+{
+    return _object_data[key];
+}
+
+template <typename string_t>
+inline basic_value<string_t>& basic_object<string_t>::operator[](string_t&& key)
+{
+    return _object_data[std::move(key)];
+}
+
+template <typename string_t>
+inline basic_object<string_t> basic_object<string_t>::operator|(const basic_object<string_t>& rhs) const&
+{
+    basic_object<string_t> temp = *this;
+    temp._object_data.insert(rhs.begin(), rhs.end());
+    return temp;
+}
+
+template <typename string_t>
+inline basic_object<string_t> basic_object<string_t>::operator|(basic_object<string_t>&& rhs) const&
+{
+    basic_object<string_t> temp = *this;
+    // temp._object_data.merge(std::move(rhs._object_data));
+    temp._object_data.insert(std::make_move_iterator(rhs.begin()), std::make_move_iterator(rhs.end()));
+    return temp;
+}
+
+template <typename string_t>
+inline basic_object<string_t> basic_object<string_t>::operator|(const basic_object<string_t>& rhs) &&
+{
+    _object_data.insert(rhs.begin(), rhs.end());
+    return std::move(*this);
+}
+
+template <typename string_t>
+inline basic_object<string_t> basic_object<string_t>::operator|(basic_object<string_t>&& rhs) &&
+{
+    //_object_data.merge(std::move(rhs._object_data));
+    _object_data.insert(std::make_move_iterator(rhs.begin()), std::make_move_iterator(rhs.end()));
+    return std::move(*this);
+}
+
+template <typename string_t>
+inline basic_object<string_t>& basic_object<string_t>::operator|=(const basic_object<string_t>& rhs)
+{
+    _object_data.insert(rhs.begin(), rhs.end());
+    return *this;
+}
+
+template <typename string_t>
+inline basic_object<string_t>& basic_object<string_t>::operator|=(basic_object<string_t>&& rhs)
+{
+    _object_data.insert(std::make_move_iterator(rhs.begin()), std::make_move_iterator(rhs.end()));
+    return *this;
+}
+
+template <typename string_t>
+inline bool basic_object<string_t>::operator==(const basic_object<string_t>& rhs) const
+{
+    return _object_data == rhs._object_data;
+}
+
+template <typename ostream_t, typename string_t,
+          typename std_ostream_t =
+              std::basic_ostream<typename string_t::value_type, std::char_traits<typename string_t::value_type>>,
+          typename enable_t =
+              std::enable_if_t<std::is_same_v<std_ostream_t, ostream_t> || std::is_base_of_v<std_ostream_t, ostream_t>>>
+ostream_t& operator<<(ostream_t& out, const basic_object<string_t>& obj)
+{
+    out << obj.format();
+    return out;
+}
+} // namespace json

3rdparty/include/meojson/common/serialization.hpp

@@ -0,0 +1,170 @@
+#pragma once
+
+#include <type_traits>
+
+#include "types.hpp"
+#include "utils.hpp"
+
+namespace json
+{
+namespace _serialization_helper
+{
+    template <typename in_t, typename serializer_t>
+    class is_serializable
+    {
+        template <typename U>
+        static auto test(int) -> decltype(std::declval<serializer_t>()(std::declval<U>()), std::true_type());
+
+        template <typename U>
+        static std::false_type test(...);
+
+    public:
+        static constexpr bool value = decltype(test<in_t>(0))::value;
+    };
+
+    struct empty_serializer
+    {
+        // sample:
+        // json::value operator()(const type_1&) const { return ...; }
+        // json::value operator()(const type_2&) const { return ...; }
+        // json::value operator()(const type_3&) const { return ...; }
+    };
+
+    template <typename T>
+    void unable_to_serialize()
+    {
+        static_assert(!sizeof(T), "Unable to serialize T. "
+#ifdef _MSC_VER
+                                  "See T below: " __FUNCSIG__
+#else
+        // "See T below: " __PRETTY_FUNCTION__
+
+#endif
+        );
+    }
+}
+
+namespace _serialization_helper
+{
+    template <typename out_t, typename deserializer_t, typename string_t = default_string_t>
+    class is_deserializable
+    {
+        template <typename U>
+        static auto test(int)
+            -> decltype(std::declval<deserializer_t>()(std::declval<basic_value<string_t>>(), std::declval<U&>()),
+                        std::true_type());
+
+        template <typename U>
+        static std::false_type test(...);
+
+    public:
+        static constexpr bool value = decltype(test<out_t>(0))::value;
+    };
+
+    struct empty_deserializer
+    {
+        // sample:
+        // bool operator()(const json::value&, type_1&) const { return ...; }
+        // bool operator()(const json::value&, type_2&) const { return ...; }
+        // bool operator()(const json::value&, type_3&) const { return ...; }
+    };
+
+    template <typename T>
+    void unable_to_deserialize()
+    {
+        static_assert(!sizeof(T), "Unable to deserialize T. "
+#ifdef _MSC_VER
+                                  "See T below: " __FUNCSIG__
+#else
+        // "See T below: " __PRETTY_FUNCTION__
+
+#endif
+        );
+    }
+}
+
+template <typename in_t, typename serializer_t = _serialization_helper::empty_serializer,
+          typename string_t = default_string_t>
+basic_value<string_t> serialize(in_t&& in, const serializer_t& serializer = {})
+{
+    if constexpr (_serialization_helper::is_serializable<in_t, serializer_t>::value) {
+        return serializer(std::forward<in_t>(in));
+    }
+    else if constexpr (std::is_constructible_v<basic_value<string_t>, in_t>) {
+        return basic_value<string_t>(std::forward<in_t>(in));
+    }
+    else if constexpr (_utils::is_collection<std::decay_t<in_t>>) {
+        basic_array<string_t> arr;
+        for (auto&& elem : in) {
+            using elem_t = decltype(elem);
+
+            auto j_elem = serialize<elem_t, serializer_t, string_t>(std::forward<elem_t>(elem), serializer);
+            arr.emplace_back(std::move(j_elem));
+        }
+        return arr;
+    }
+    else if constexpr (_utils::is_map<std::decay_t<in_t>>) {
+        basic_object<string_t> obj;
+        for (auto&& [key, elem] : in) {
+            using key_t = decltype(key);
+            using elem_t = decltype(elem);
+
+            auto j_elem = serialize<elem_t, serializer_t, string_t>(std::forward<elem_t>(elem), serializer);
+            obj.emplace(std::forward<key_t>(key), std::move(j_elem));
+        }
+        return obj;
+    }
+    else {
+        _serialization_helper::unable_to_serialize<in_t>();
+    }
+}
+
+template <typename out_t, typename deserializer_t = _serialization_helper::empty_deserializer,
+          typename string_t = default_string_t>
+bool deserialize(const basic_value<string_t>& in, out_t& out, const deserializer_t& deserializer = {})
+{
+    if constexpr (_serialization_helper::is_deserializable<out_t, deserializer_t>::value) {
+        return deserializer(in, out);
+    }
+    else if constexpr (std::is_constructible_v<out_t, basic_value<string_t>>) {
+        out = out_t(in);
+        return true;
+    }
+    else if constexpr (_utils::is_collection<std::decay_t<out_t>>) {
+        if (!in.is_array()) {
+            return false;
+        }
+        for (auto&& j_elem : in.as_array()) {
+            using elem_t = typename out_t::value_type;
+            elem_t elem {};
+            if (!deserialize<elem_t, deserializer_t, string_t>(j_elem, elem, deserializer)) {
+                return false;
+            }
+            if constexpr (_as_collection_helper::has_emplace_back<out_t>::value) {
+                out.emplace_back(std::move(elem));
+            }
+            else {
+                out.emplace(std::move(elem));
+            }
+        }
+        return true;
+    }
+    else if constexpr (_utils::is_map<std::decay_t<out_t>>) {
+        if (!in.is_object()) {
+            return false;
+        }
+        for (auto&& [key, j_elem] : in.as_object()) {
+            using elem_t = typename out_t::value_type;
+            elem_t elem {};
+            if (!deserialize<elem_t, deserializer_t, string_t>(j_elem, elem, deserializer)) {
+                return false;
+            }
+            out.emplace(std::move(elem));
+        }
+        return true;
+    }
+    else {
+        _serialization_helper::unable_to_deserialize<out_t>();
+    }
+}
+} // namespace json

3rdparty/include/meojson/common/types.hpp

@@ -0,0 +1,5 @@
+#pragma once
+
+#include "array.hpp"
+#include "object.hpp"
+#include "value.hpp"

3rdparty/include/meojson/common/utils.hpp

@@ -0,0 +1,235 @@
+#pragma once
+
+#include <string>
+#include <type_traits>
+
+namespace json
+{
+template <typename string_t>
+class basic_value;
+template <typename string_t>
+class basic_array;
+template <typename string_t>
+class basic_object;
+
+using default_string_t = std::string;
+
+using value = basic_value<default_string_t>;
+using array = basic_array<default_string_t>;
+using object = basic_object<default_string_t>;
+
+using wvalue = basic_value<std::wstring>;
+using warray = basic_array<std::wstring>;
+using wobject = basic_object<std::wstring>;
+}
+
+namespace json::ext
+{
+template <typename T>
+class jsonization
+{
+public:
+    // json::value to_json(const T&) const;
+    // bool check_json(const json::value&) const;
+    // bool from_json(const json::value&, T&) const;
+};
+}
+
+namespace json::_utils
+{
+template <typename T>
+using iterator_t = decltype(std::declval<T&>().begin());
+template <typename T>
+using remove_cvref_t = std::remove_cv_t<std::remove_reference_t<T>>;
+template <typename T>
+using iter_value_t = typename std::iterator_traits<remove_cvref_t<T>>::value_type;
+template <typename R>
+using range_value_t = iter_value_t<iterator_t<R>>;
+
+template <typename T, typename = void>
+constexpr bool is_string = false;
+template <typename T>
+constexpr bool is_string<T, std::void_t<typename T::traits_type>> =
+    std::is_same_v<typename T::traits_type, std::char_traits<typename T::value_type>>;
+
+template <typename T, typename = void>
+constexpr bool is_container = false;
+template <typename T>
+constexpr bool is_container<T, std::void_t<typename T::value_type, range_value_t<T>>> =
+    std::is_same_v<typename T::value_type, range_value_t<T>> && !is_string<T>;
+
+template <typename T, typename = void>
+constexpr bool is_map = false;
+template <typename T>
+constexpr bool is_map<T, std::void_t<typename T::key_type, typename T::mapped_type>> = is_container<T>;
+
+template <typename T, typename = void>
+constexpr bool is_collection = false;
+template <typename T>
+constexpr bool is_collection<T> = is_container<T> && !is_map<T>;
+
+template <typename T>
+class has_to_json_in_member
+{
+    template <typename U>
+    static auto test(int) -> decltype(std::declval<U>().to_json(), std::true_type());
+
+    template <typename U>
+    static std::false_type test(...);
+
+public:
+    static constexpr bool value = decltype(test<T>(0))::value;
+};
+
+template <typename T>
+class has_to_json_in_templ_spec
+{
+    template <typename U>
+    static auto test(int) -> decltype(std::declval<ext::jsonization<U>>().to_json(std::declval<U>()), std::true_type());
+
+    template <typename U>
+    static std::false_type test(...);
+
+public:
+    static constexpr bool value = decltype(test<T>(0))::value;
+};
+
+template <typename T, typename string_t>
+class has_check_json_in_member
+{
+    template <typename U>
+    static auto test(int)
+        -> decltype(std::declval<U>().check_json(std::declval<json::basic_value<string_t>>()), std::true_type());
+
+    template <typename U>
+    static std::false_type test(...);
+
+public:
+    static constexpr bool value = decltype(test<T>(0))::value;
+};
+
+template <typename T, typename string_t>
+class has_check_json_in_templ_spec
+{
+    template <typename U>
+    static auto test(int)
+        -> decltype(std::declval<ext::jsonization<U>>().check_json(std::declval<json::basic_value<string_t>>()),
+                    std::true_type());
+
+    template <typename U>
+    static std::false_type test(...);
+
+public:
+    static constexpr bool value = decltype(test<T>(0))::value;
+};
+
+template <typename T, typename string_t>
+class has_from_json_in_member
+{
+    template <typename U>
+    static auto test(int)
+        -> decltype(std::declval<U>().from_json(std::declval<json::basic_value<string_t>>()), std::true_type());
+
+    template <typename U>
+    static std::false_type test(...);
+
+public:
+    static constexpr bool value = decltype(test<T>(0))::value;
+};
+
+template <typename T, typename string_t>
+class has_from_json_in_templ_spec
+{
+    template <typename U>
+    static auto test(int)
+        -> decltype(std::declval<ext::jsonization<U>>().from_json(std::declval<json::basic_value<string_t>>(),
+                                                                  std::declval<U&>()),
+                    std::true_type());
+
+    template <typename U>
+    static std::false_type test(...);
+
+public:
+    static constexpr bool value = decltype(test<T>(0))::value;
+};
+
+template <typename string_t>
+static constexpr string_t unescape_string(const string_t& str)
+{
+    using char_t = typename string_t::value_type;
+
+    string_t result {};
+    auto cur = str.cbegin();
+    auto end = str.cend();
+    auto no_escape_beg = cur;
+    char_t escape = 0;
+
+    for (; cur != end; ++cur) {
+        switch (*cur) {
+        case '"':
+            escape = '"';
+            break;
+        case '\\':
+            escape = '\\';
+            break;
+        case '\b':
+            escape = 'b';
+            break;
+        case '\f':
+            escape = 'f';
+            break;
+        case '\n':
+            escape = 'n';
+            break;
+        case '\r':
+            escape = 'r';
+            break;
+        case '\t':
+            escape = 't';
+            break;
+        default:
+            break;
+        }
+        if (escape) {
+            result += string_t(no_escape_beg, cur) + char_t('\\') + escape;
+            no_escape_beg = cur + 1;
+            escape = 0;
+        }
+    }
+    result += string_t(no_escape_beg, cur);
+
+    return result;
+}
+
+template <typename string_t>
+static constexpr string_t true_string()
+{
+    return { 't', 'r', 'u', 'e' };
+}
+
+template <typename string_t>
+static constexpr string_t false_string()
+{
+    return { 'f', 'a', 'l', 's', 'e' };
+}
+
+template <typename string_t>
+static constexpr string_t null_string()
+{
+    return { 'n', 'u', 'l', 'l' };
+}
+
+template <typename string_t, typename any_t>
+string_t to_basic_string(any_t&& arg)
+{
+    if constexpr (std::is_same_v<string_t, std::string>) {
+        return std::to_string(std::forward<any_t>(arg));
+    }
+    else if constexpr (std::is_same_v<string_t, std::wstring>) {
+        return std::to_wstring(std::forward<any_t>(arg));
+    }
+    else {
+        static_assert(!sizeof(any_t), "Unsupported type");
+    }
+}
+} // namespace json::_utils

3rdparty/include/meojson/common/value.hpp

@@ -0,0 +1,994 @@
+#pragma once
+
+#include <cstddef>
+#include <initializer_list>
+#include <memory>
+#include <optional>
+#include <ostream>
+#include <string>
+#include <tuple>
+#include <variant>
+
+#include "exception.hpp"
+#include "utils.hpp"
+
+namespace json
+{
+template <typename string_t>
+class basic_value
+{
+    using array_ptr = std::unique_ptr<basic_array<string_t>>;
+    using object_ptr = std::unique_ptr<basic_object<string_t>>;
+
+public:
+    enum class value_type : char
+    {
+        invalid,
+        null,
+        boolean,
+        string,
+        number,
+        array,
+        object
+    };
+
+    using var_t = std::variant<string_t, array_ptr, object_ptr>;
+    using char_t = typename string_t::value_type;
+
+public:
+    basic_value();
+    basic_value(const basic_value<string_t>& rhs);
+    basic_value(basic_value<string_t>&& rhs) noexcept;
+
+    basic_value(bool b);
+
+    basic_value(int num);
+    basic_value(unsigned num);
+    basic_value(long num);
+    basic_value(unsigned long num);
+    basic_value(long long num);
+    basic_value(unsigned long long num);
+    basic_value(float num);
+    basic_value(double num);
+    basic_value(long double num);
+
+    basic_value(const char_t* str);
+    basic_value(string_t str);
+    basic_value(std::nullptr_t);
+
+    basic_value(basic_array<string_t> arr);
+    basic_value(basic_object<string_t> obj);
+    basic_value(std::initializer_list<typename basic_object<string_t>::value_type> init_list);
+
+    // Constructed from raw data
+    template <typename... args_t>
+    basic_value(value_type type, args_t&&... args);
+
+    template <typename collection_t,
+              std::enable_if_t<_utils::is_collection<collection_t> &&
+                                   std::is_constructible_v<typename basic_array<string_t>::value_type,
+                                                           _utils::range_value_t<collection_t>>,
+                               bool> = true>
+    basic_value(collection_t&& collection) : basic_value(basic_array<string_t>(std::forward<collection_t>(collection)))
+    {}
+    template <typename map_t, std::enable_if_t<_utils::is_map<map_t> &&
+                                                   std::is_constructible_v<typename basic_object<string_t>::value_type,
+                                                                           _utils::range_value_t<map_t>>,
+                                               bool> = true>
+    basic_value(map_t&& map) : basic_value(basic_object<string_t>(std::forward<map_t>(map)))
+    {}
+
+    template <typename jsonization_t,
+              std::enable_if_t<_utils::has_to_json_in_member<jsonization_t>::value, bool> = true>
+    basic_value(const jsonization_t& value) : basic_value(value.to_json())
+    {}
+    template <typename jsonization_t,
+              std::enable_if_t<_utils::has_to_json_in_templ_spec<jsonization_t>::value, bool> = true>
+    basic_value(const jsonization_t& value) : basic_value(ext::jsonization<jsonization_t>().to_json(value))
+    {}
+
+    template <typename value_t, std::enable_if_t<!std::is_convertible_v<value_t, basic_value<string_t>>, bool> = true>
+    basic_value(value_t) = delete;
+
+    // I don't know if you want to convert char to string or number, so I delete these constructors.
+    basic_value(char) = delete;
+    basic_value(wchar_t) = delete;
+    basic_value(char16_t) = delete;
+    basic_value(char32_t) = delete;
+
+    ~basic_value();
+
+    bool valid() const noexcept { return _type != value_type::invalid; }
+    bool empty() const noexcept { return is_null(); }
+    bool is_null() const noexcept { return _type == value_type::null; }
+    bool is_number() const noexcept { return _type == value_type::number; }
+    bool is_boolean() const noexcept { return _type == value_type::boolean; }
+    bool is_string() const noexcept { return _type == value_type::string; }
+    bool is_array() const noexcept { return _type == value_type::array; }
+    bool is_object() const noexcept { return _type == value_type::object; }
+    template <typename value_t>
+    bool is() const noexcept;
+
+    template <typename value_t>
+    bool all() const;
+
+    bool contains(const string_t& key) const;
+    bool contains(size_t pos) const;
+    bool exists(const string_t& key) const { return contains(key); }
+    bool exists(size_t pos) const { return contains(pos); }
+    value_type type() const noexcept { return _type; }
+    const basic_value<string_t>& at(size_t pos) const;
+    const basic_value<string_t>& at(const string_t& key) const;
+
+    bool erase(size_t pos);
+    bool erase(const string_t& key);
+
+    // Usage: get(key_1, key_2, ..., default_value);
+    template <typename... key_then_default_value_t>
+    auto get(key_then_default_value_t&&... keys_then_default_value) const;
+
+    template <typename value_t = basic_value<string_t>>
+    std::optional<value_t> find(size_t pos) const;
+    template <typename value_t = basic_value<string_t>>
+    std::optional<value_t> find(const string_t& key) const;
+
+    bool as_boolean() const;
+    int as_integer() const;
+    unsigned as_unsigned() const;
+    long as_long() const;
+    unsigned long as_unsigned_long() const;
+    long long as_long_long() const;
+    unsigned long long as_unsigned_long_long() const;
+    float as_float() const;
+    double as_double() const;
+    long double as_long_double() const;
+    string_t as_string() const;
+    const basic_array<string_t>& as_array() const;
+    const basic_object<string_t>& as_object() const;
+
+    template <typename value_t, template <typename...> typename collection_t = std::vector>
+    collection_t<value_t> as_collection() const;
+    template <typename value_t, template <typename...> typename map_t = std::map>
+    map_t<string_t, value_t> as_map() const;
+
+    template <typename value_t>
+    value_t as() const;
+
+    basic_array<string_t>& as_array();
+    basic_object<string_t>& as_object();
+
+    template <typename... args_t>
+    decltype(auto) emplace(args_t&&... args);
+
+    void clear() noexcept;
+
+    string_t dumps(std::optional<size_t> indent = std::nullopt) const { return indent ? format(*indent) : to_string(); }
+    // return raw string
+    string_t to_string() const;
+    string_t format(size_t indent = 4) const { return format(indent, 0); }
+
+    basic_value<string_t>& operator=(const basic_value<string_t>& rhs);
+    basic_value<string_t>& operator=(basic_value<string_t>&&) noexcept;
+    template <typename value_t, std::enable_if_t<std::is_convertible_v<value_t, basic_value<string_t>>, bool> = true>
+    basic_value<string_t>& operator=(value_t rhs)
+    {
+        return *this = basic_value<string_t>(std::move(rhs));
+    }
+
+    bool operator==(const basic_value<string_t>& rhs) const;
+    bool operator!=(const basic_value<string_t>& rhs) const { return !(*this == rhs); }
+
+    const basic_value<string_t>& operator[](size_t pos) const;
+    basic_value<string_t>& operator[](size_t pos);
+    basic_value<string_t>& operator[](const string_t& key);
+    basic_value<string_t>& operator[](string_t&& key);
+
+    basic_value<string_t> operator|(const basic_object<string_t>& rhs) const&;
+    basic_value<string_t> operator|(basic_object<string_t>&& rhs) const&;
+    basic_value<string_t> operator|(const basic_object<string_t>& rhs) &&;
+    basic_value<string_t> operator|(basic_object<string_t>&& rhs) &&;
+
+    basic_value<string_t>& operator|=(const basic_object<string_t>& rhs);
+    basic_value<string_t>& operator|=(basic_object<string_t>&& rhs);
+
+    basic_value<string_t> operator+(const basic_array<string_t>& rhs) const&;
+    basic_value<string_t> operator+(basic_array<string_t>&& rhs) const&;
+    basic_value<string_t> operator+(const basic_array<string_t>& rhs) &&;
+    basic_value<string_t> operator+(basic_array<string_t>&& rhs) &&;
+
+    basic_value<string_t>& operator+=(const basic_array<string_t>& rhs);
+    basic_value<string_t>& operator+=(basic_array<string_t>&& rhs);
+
+    explicit operator bool() const { return as_boolean(); }
+    explicit operator int() const { return as_integer(); }
+    explicit operator unsigned() const { return as_unsigned(); }
+    explicit operator long() const { return as_long(); }
+    explicit operator unsigned long() const { return as_unsigned_long(); }
+    explicit operator long long() const { return as_long_long(); }
+    explicit operator unsigned long long() const { return as_unsigned_long_long(); }
+    explicit operator float() const { return as_float(); }
+    explicit operator double() const { return as_double(); }
+    explicit operator long double() const { return as_long_double(); }
+    explicit operator string_t() const { return as_string(); }
+
+    explicit operator basic_array<string_t>() const { return as_array(); }
+    explicit operator basic_object<string_t>() const { return as_object(); }
+
+    template <typename value_t, template <typename...> typename collection_t = std::vector,
+              std::enable_if_t<_utils::is_collection<collection_t<value_t>>, bool> = true>
+    explicit operator collection_t<value_t>() const
+    {
+        return as_collection<value_t, collection_t>();
+    }
+    template <typename value_t, template <typename...> typename map_t = std::map,
+              std::enable_if_t<_utils::is_map<map_t<string_t, value_t>>, bool> = true>
+    explicit operator map_t<string_t, value_t>() const
+    {
+        return as_map<value_t, map_t>();
+    }
+    template <typename jsonization_t,
+              std::enable_if_t<_utils::has_from_json_in_member<jsonization_t, string_t>::value, bool> = true>
+    explicit operator jsonization_t() const
+    {
+        jsonization_t dst {};
+        if (!dst.from_json(*this)) {
+            throw exception("Wrong JSON");
+        }
+        return dst;
+    }
+    template <typename jsonization_t,
+              std::enable_if_t<_utils::has_from_json_in_templ_spec<jsonization_t, string_t>::value, bool> = true>
+    explicit operator jsonization_t() const
+    {
+        jsonization_t dst {};
+        if (!ext::jsonization<jsonization_t>().from_json(*this, dst)) {
+            throw exception("Wrong JSON");
+        }
+        return dst;
+    }
+
+private:
+    friend class basic_array<string_t>;
+    friend class basic_object<string_t>;
+
+    string_t format(size_t indent, size_t indent_times) const;
+
+    static var_t deep_copy(const var_t& src);
+
+    template <typename... key_then_default_value_t, size_t... keys_indexes_t>
+    auto get(std::tuple<key_then_default_value_t...> keys_then_default_value,
+             std::index_sequence<keys_indexes_t...>) const;
+
+    template <typename value_t, typename first_key_t, typename... rest_keys_t>
+    auto get_helper(const value_t& default_value, first_key_t&& first, rest_keys_t&&... rest) const;
+    template <typename value_t, typename unique_key_t>
+    auto get_helper(const value_t& default_value, unique_key_t&& first) const;
+
+    const string_t& as_basic_type_str() const;
+    string_t& as_basic_type_str();
+
+    value_type _type = value_type::null;
+    var_t _raw_data;
+};
+
+template <typename string_t>
+inline basic_value<string_t>::basic_value() = default;
+
+template <typename string_t>
+inline basic_value<string_t>::basic_value(const basic_value<string_t>& rhs)
+    : _type(rhs._type), _raw_data(deep_copy(rhs._raw_data))
+{}
+
+template <typename string_t>
+inline basic_value<string_t>::basic_value(basic_value<string_t>&& rhs) noexcept = default;
+
+template <typename string_t>
+inline basic_value<string_t>::basic_value(bool b)
+    : _type(value_type::boolean),
+      _raw_data(string_t(b ? _utils::true_string<string_t>() : _utils::false_string<string_t>()))
+{}
+
+template <typename string_t>
+inline basic_value<string_t>::basic_value(int num)
+    : _type(value_type::number), _raw_data(_utils::to_basic_string<string_t>(num))
+{}
+
+template <typename string_t>
+inline basic_value<string_t>::basic_value(unsigned num)
+    : _type(value_type::number), _raw_data(_utils::to_basic_string<string_t>(num))
+{}
+
+template <typename string_t>
+inline basic_value<string_t>::basic_value(long num)
+    : _type(value_type::number), _raw_data(_utils::to_basic_string<string_t>(num))
+{}
+
+template <typename string_t>
+inline basic_value<string_t>::basic_value(unsigned long num)
+    : _type(value_type::number), _raw_data(_utils::to_basic_string<string_t>(num))
+{}
+
+template <typename string_t>
+inline basic_value<string_t>::basic_value(long long num)
+    : _type(value_type::number), _raw_data(_utils::to_basic_string<string_t>(num))
+{}
+
+template <typename string_t>
+inline basic_value<string_t>::basic_value(unsigned long long num)
+    : _type(value_type::number), _raw_data(_utils::to_basic_string<string_t>(num))
+{}
+
+template <typename string_t>
+inline basic_value<string_t>::basic_value(float num)
+    : _type(value_type::number), _raw_data(_utils::to_basic_string<string_t>(num))
+{}
+
+template <typename string_t>
+inline basic_value<string_t>::basic_value(double num)
+    : _type(value_type::number), _raw_data(_utils::to_basic_string<string_t>(num))
+{}
+
+template <typename string_t>
+inline basic_value<string_t>::basic_value(long double num)
+    : _type(value_type::number), _raw_data(_utils::to_basic_string<string_t>(num))
+{}
+
+template <typename string_t>
+inline basic_value<string_t>::basic_value(const char_t* str) : _type(value_type::string), _raw_data(string_t(str))
+{}
+
+template <typename string_t>
+inline basic_value<string_t>::basic_value(string_t str) : _type(value_type::string), _raw_data(std::move(str))
+{}
+
+template <typename string_t>
+inline basic_value<string_t>::basic_value(std::nullptr_t) : _type(value_type::null)
+{}
+
+template <typename string_t>
+inline basic_value<string_t>::basic_value(basic_array<string_t> arr)
+    : _type(value_type::array), _raw_data(std::make_unique<basic_array<string_t>>(std::move(arr)))
+{}
+
+template <typename string_t>
+inline basic_value<string_t>::basic_value(basic_object<string_t> obj)
+    : _type(value_type::object), _raw_data(std::make_unique<basic_object<string_t>>(std::move(obj)))
+{}
+
+template <typename string_t>
+inline basic_value<string_t>::basic_value(std::initializer_list<typename basic_object<string_t>::value_type> init_list)
+    : _type(value_type::object), _raw_data(std::make_unique<basic_object<string_t>>(init_list))
+{}
+
+// for Pimpl
+template <typename string_t>
+inline basic_value<string_t>::~basic_value() = default;
+
+template <typename string_t>
+template <typename value_t>
+inline bool basic_value<string_t>::is() const noexcept
+{
+    if constexpr (std::is_same_v<basic_value<string_t>, value_t>) {
+        return true;
+    }
+    else if constexpr (_utils::has_check_json_in_member<value_t, string_t>::value) {
+        return value_t().check_json(*this);
+    }
+    else if constexpr (_utils::has_check_json_in_templ_spec<value_t, string_t>::value) {
+        return ext::jsonization<value_t>().check_json(*this);
+    }
+    else if constexpr (std::is_same_v<bool, value_t>) {
+        return is_boolean();
+    }
+    else if constexpr (std::is_arithmetic_v<value_t>) {
+        return is_number();
+    }
+    else if constexpr (std::is_constructible_v<string_t, value_t>) {
+        return is_string();
+    }
+    else if constexpr (std::is_same_v<basic_array<string_t>, value_t>) {
+        return is_array();
+    }
+    else if constexpr (_utils::is_collection<value_t>) {
+        return is_array() && all<typename value_t::value_type>();
+    }
+    else if constexpr (std::is_same_v<basic_object<string_t>, value_t>) {
+        return is_object();
+    }
+    else if constexpr (_utils::is_map<value_t>) {
+        return is_object() && std::is_constructible_v<string_t, typename value_t::key_type> &&
+               all<typename value_t::mapped_type>();
+    }
+    else {
+        static_assert(!sizeof(value_t), "Unsupported type");
+    }
+}
+
+template <typename string_t>
+inline bool basic_value<string_t>::contains(const string_t& key) const
+{
+    return is_object() && as_object().contains(key);
+}
+
+template <typename string_t>
+inline bool basic_value<string_t>::contains(size_t pos) const
+{
+    return is_array() && as_array().contains(pos);
+}
+
+template <typename string_t>
+inline const basic_value<string_t>& basic_value<string_t>::at(size_t pos) const
+{
+    return as_array().at(pos);
+}
+
+template <typename string_t>
+inline const basic_value<string_t>& basic_value<string_t>::at(const string_t& key) const
+{
+    return as_object().at(key);
+}
+
+template <typename string_t>
+inline bool basic_value<string_t>::erase(size_t pos)
+{
+    return as_array().erase(pos);
+}
+
+template <typename string_t>
+inline bool basic_value<string_t>::erase(const string_t& key)
+{
+    return as_object().erase(key);
+}
+
+template <typename string_t>
+template <typename... key_then_default_value_t>
+inline auto basic_value<string_t>::get(key_then_default_value_t&&... keys_then_default_value) const
+{
+    return get(std::forward_as_tuple(keys_then_default_value...),
+               std::make_index_sequence<sizeof...(keys_then_default_value) - 1> {});
+}
+
+template <typename string_t>
+template <typename... key_then_default_value_t, size_t... keys_indexes_t>
+inline auto basic_value<string_t>::get(std::tuple<key_then_default_value_t...> keys_then_default_value,
+                                       std::index_sequence<keys_indexes_t...>) const
+{
+    constexpr unsigned long default_value_index = sizeof...(key_then_default_value_t) - 1;
+    return get_helper(std::get<default_value_index>(keys_then_default_value),
+                      std::get<keys_indexes_t>(keys_then_default_value)...);
+}
+
+template <typename string_t>
+template <typename value_t, typename first_key_t, typename... rest_keys_t>
+inline auto basic_value<string_t>::get_helper(const value_t& default_value, first_key_t&& first,
+                                              rest_keys_t&&... rest) const
+{
+    if constexpr (std::is_constructible_v<string_t, first_key_t>) {
+        return is_object() ? as_object().get_helper(default_value, std::forward<first_key_t>(first),
+                                                    std::forward<rest_keys_t>(rest)...)
+                           : default_value;
+    }
+    else if constexpr (std::is_integral_v<std::decay_t<first_key_t>>) {
+        return is_array() ? as_array().get_helper(default_value, std::forward<first_key_t>(first),
+                                                  std::forward<rest_keys_t>(rest)...)
+                          : default_value;
+    }
+    else {
+        static_assert(!sizeof(first_key_t), "Parameter must be integral or string_t constructible");
+    }
+}
+
+template <typename string_t>
+template <typename value_t, typename unique_key_t>
+inline auto basic_value<string_t>::get_helper(const value_t& default_value, unique_key_t&& first) const
+{
+    if constexpr (std::is_constructible_v<string_t, unique_key_t>) {
+        return is_object() ? as_object().get_helper(default_value, std::forward<unique_key_t>(first)) : default_value;
+    }
+    else if constexpr (std::is_integral_v<std::decay_t<unique_key_t>>) {
+        return is_array() ? as_array().get_helper(default_value, std::forward<unique_key_t>(first)) : default_value;
+    }
+    else {
+        static_assert(!sizeof(unique_key_t), "Parameter must be integral or string_t constructible");
+    }
+}
+
+template <typename string_t>
+template <typename value_t>
+inline std::optional<value_t> basic_value<string_t>::find(size_t pos) const
+{
+    return is_array() ? as_array().template find<value_t>(pos) : std::nullopt;
+}
+
+template <typename string_t>
+template <typename value_t>
+inline std::optional<value_t> basic_value<string_t>::find(const string_t& key) const
+{
+    return is_object() ? as_object().template find<value_t>(key) : std::nullopt;
+}
+
+template <typename string_t>
+inline bool basic_value<string_t>::as_boolean() const
+{
+    if (is_boolean()) {
+        if (const string_t& b_str = as_basic_type_str(); b_str == _utils::true_string<string_t>()) {
+            return true;
+        }
+        else if (b_str == _utils::false_string<string_t>()) {
+            return false;
+        }
+        else {
+            throw exception("Unknown Parse Error");
+        }
+    }
+    else {
+        throw exception("Wrong Type");
+    }
+}
+
+template <typename string_t>
+inline int basic_value<string_t>::as_integer() const
+{
+    if (is_number()) {
+        return std::stoi(as_basic_type_str());
+    }
+    else {
+        throw exception("Wrong Type");
+    }
+}
+
+template <typename string_t>
+inline unsigned basic_value<string_t>::as_unsigned() const
+{
+    // I don't know why there is no std::stou.
+    return static_cast<unsigned>(as_unsigned_long());
+}
+
+template <typename string_t>
+inline long basic_value<string_t>::as_long() const
+{
+    if (is_number()) {
+        return std::stol(as_basic_type_str());
+    }
+    else {
+        throw exception("Wrong Type");
+    }
+}
+
+template <typename string_t>
+inline unsigned long basic_value<string_t>::as_unsigned_long() const
+{
+    if (is_number()) {
+        return std::stoul(as_basic_type_str());
+    }
+    else {
+        throw exception("Wrong Type");
+    }
+}
+
+template <typename string_t>
+inline long long basic_value<string_t>::as_long_long() const
+{
+    if (is_number()) {
+        return std::stoll(as_basic_type_str());
+    }
+    else {
+        throw exception("Wrong Type");
+    }
+}
+
+template <typename string_t>
+inline unsigned long long basic_value<string_t>::as_unsigned_long_long() const
+{
+    if (is_number()) {
+        return std::stoull(as_basic_type_str());
+    }
+    else {
+        throw exception("Wrong Type");
+    }
+}
+
+template <typename string_t>
+inline float basic_value<string_t>::as_float() const
+{
+    if (is_number()) {
+        return std::stof(as_basic_type_str());
+    }
+    else {
+        throw exception("Wrong Type");
+    }
+}
+
+template <typename string_t>
+inline double basic_value<string_t>::as_double() const
+{
+    if (is_number()) {
+        return std::stod(as_basic_type_str());
+    }
+    else {
+        throw exception("Wrong Type");
+    }
+}
+
+template <typename string_t>
+inline long double basic_value<string_t>::as_long_double() const
+{
+    if (is_number()) {
+        return std::stold(as_basic_type_str());
+    }
+    else {
+        throw exception("Wrong Type");
+    }
+}
+
+template <typename string_t>
+inline string_t basic_value<string_t>::as_string() const
+{
+    if (is_string()) {
+        return as_basic_type_str();
+    }
+    else {
+        throw exception("Wrong Type");
+    }
+}
+
+template <typename string_t>
+inline const basic_array<string_t>& basic_value<string_t>::as_array() const
+{
+    if (is_array()) {
+        return *std::get<array_ptr>(_raw_data);
+    }
+
+    throw exception("Wrong Type");
+}
+
+template <typename string_t>
+inline const basic_object<string_t>& basic_value<string_t>::as_object() const
+{
+    if (is_object()) {
+        return *std::get<object_ptr>(_raw_data);
+    }
+
+    throw exception("Wrong Type or data empty");
+}
+
+template <typename string_t>
+inline basic_array<string_t>& basic_value<string_t>::as_array()
+{
+    if (empty()) {
+        *this = basic_array<string_t>();
+    }
+
+    if (is_array()) {
+        return *std::get<array_ptr>(_raw_data);
+    }
+
+    throw exception("Wrong Type");
+}
+
+template <typename string_t>
+inline basic_object<string_t>& basic_value<string_t>::as_object()
+{
+    if (empty()) {
+        *this = basic_object<string_t>();
+    }
+
+    if (is_object()) {
+        return *std::get<object_ptr>(_raw_data);
+    }
+
+    throw exception("Wrong Type or data empty");
+}
+
+template <typename string_t>
+template <typename value_t>
+inline value_t basic_value<string_t>::as() const
+{
+    if constexpr (std::is_same_v<basic_value<string_t>, value_t>) {
+        return *this;
+    }
+    else if constexpr (_utils::has_from_json_in_member<value_t, string_t>::value) {
+        value_t dst {};
+        if (!dst.from_json(*this)) {
+            throw exception("Wrong JSON");
+        }
+        return dst;
+    }
+    else if constexpr (_utils::has_from_json_in_templ_spec<value_t, string_t>::value) {
+        value_t dst {};
+        if (!ext::jsonization<value_t>().from_json(*this, dst)) {
+            throw exception("Wrong JSON");
+        }
+        return dst;
+    }
+    else {
+        return static_cast<value_t>(*this);
+    }
+}
+
+template <typename string_t>
+inline const string_t& basic_value<string_t>::as_basic_type_str() const
+{
+    return std::get<string_t>(_raw_data);
+}
+
+template <typename string_t>
+inline string_t& basic_value<string_t>::as_basic_type_str()
+{
+    return std::get<string_t>(_raw_data);
+}
+
+template <typename string_t>
+template <typename... args_t>
+inline decltype(auto) basic_value<string_t>::emplace(args_t&&... args)
+{
+    constexpr bool is_array_args = std::is_constructible_v<typename basic_array<string_t>::value_type, args_t...>;
+    constexpr bool is_object_args = std::is_constructible_v<typename basic_object<string_t>::value_type, args_t...>;
+
+    static_assert(is_array_args || is_object_args, "Args can not constructure a array or object value");
+
+    if constexpr (is_array_args) {
+        return as_array().emplace_back(std::forward<args_t>(args)...);
+    }
+    else if constexpr (is_object_args) {
+        return as_object().emplace(std::forward<args_t>(args)...);
+    }
+}
+
+template <typename string_t>
+inline void basic_value<string_t>::clear() noexcept
+{
+    *this = basic_value<string_t>();
+}
+
+template <typename string_t>
+inline string_t basic_value<string_t>::to_string() const
+{
+    switch (_type) {
+    case value_type::null:
+        return _utils::null_string<string_t>();
+    case value_type::boolean:
+    case value_type::number:
+        return as_basic_type_str();
+    case value_type::string:
+        return char_t('"') + _utils::unescape_string(as_basic_type_str()) + char_t('"');
+    case value_type::array:
+        return as_array().to_string();
+    case value_type::object:
+        return as_object().to_string();
+    default:
+        throw exception("Unknown basic_value Type");
+    }
+}
+
+template <typename string_t>
+inline string_t basic_value<string_t>::format(size_t indent, size_t indent_times) const
+{
+    switch (_type) {
+    case value_type::null:
+    case value_type::boolean:
+    case value_type::number:
+    case value_type::string:
+        return to_string();
+    case value_type::array:
+        return as_array().format(indent, indent_times);
+    case value_type::object:
+        return as_object().format(indent, indent_times);
+    default:
+        throw exception("Unknown basic_value Type");
+    }
+}
+
+template <typename string_t>
+template <typename value_t>
+inline bool basic_value<string_t>::all() const
+{
+    if (is_array()) {
+        return as_array().template all<value_t>();
+    }
+    else if (is_object()) {
+        return as_object().template all<value_t>();
+    }
+    else {
+        return false;
+    }
+}
+
+template <typename string_t>
+template <typename value_t, template <typename...> typename collection_t>
+inline collection_t<value_t> basic_value<string_t>::as_collection() const
+{
+    return as_array().template as_collection<value_t, collection_t>();
+}
+
+template <typename string_t>
+template <typename value_t, template <typename...> typename map_t>
+inline map_t<string_t, value_t> basic_value<string_t>::as_map() const
+{
+    return as_object().template as_map<value_t, map_t>();
+}
+
+template <typename string_t>
+inline basic_value<string_t>& basic_value<string_t>::operator=(const basic_value<string_t>& rhs)
+{
+    _type = rhs._type;
+    _raw_data = deep_copy(rhs._raw_data);
+
+    return *this;
+}
+
+template <typename string_t>
+inline basic_value<string_t>& basic_value<string_t>::operator=(basic_value<string_t>&& rhs) noexcept = default;
+
+template <typename string_t>
+inline bool basic_value<string_t>::operator==(const basic_value<string_t>& rhs) const
+{
+    if (_type != rhs._type) return false;
+
+    switch (_type) {
+    case value_type::null:
+        return rhs.is_null();
+    case value_type::boolean:
+    case value_type::number:
+    case value_type::string:
+        return _raw_data == rhs._raw_data;
+    case value_type::array:
+        return as_array() == rhs.as_array();
+    case value_type::object:
+        return as_object() == rhs.as_object();
+    default:
+        throw exception("Unknown basic_value Type");
+    }
+}
+
+template <typename string_t>
+inline const basic_value<string_t>& basic_value<string_t>::operator[](size_t pos) const
+{
+    // basic_array not support to create by operator[]
+
+    return as_array()[pos];
+}
+
+template <typename string_t>
+inline basic_value<string_t>& basic_value<string_t>::operator[](size_t pos)
+{
+    // basic_array not support to create by operator[]
+
+    return as_array()[pos];
+}
+
+template <typename string_t>
+inline basic_value<string_t>& basic_value<string_t>::operator[](const string_t& key)
+{
+    if (empty()) {
+        *this = basic_object<string_t>();
+    }
+
+    return as_object()[key];
+}
+
+template <typename string_t>
+inline basic_value<string_t>& basic_value<string_t>::operator[](string_t&& key)
+{
+    if (empty()) {
+        *this = basic_object<string_t>();
+    }
+
+    return as_object()[std::move(key)];
+}
+
+template <typename string_t>
+inline basic_value<string_t> basic_value<string_t>::operator|(const basic_object<string_t>& rhs) const&
+{
+    return as_object() | rhs;
+}
+
+template <typename string_t>
+inline basic_value<string_t> basic_value<string_t>::operator|(basic_object<string_t>&& rhs) const&
+{
+    return as_object() | std::move(rhs);
+}
+
+template <typename string_t>
+inline basic_value<string_t> basic_value<string_t>::operator|(const basic_object<string_t>& rhs) &&
+{
+    return std::move(as_object()) | rhs;
+}
+
+template <typename string_t>
+inline basic_value<string_t> basic_value<string_t>::operator|(basic_object<string_t>&& rhs) &&
+{
+    return std::move(as_object()) | std::move(rhs);
+}
+
+template <typename string_t>
+inline basic_value<string_t>& basic_value<string_t>::operator|=(const basic_object<string_t>& rhs)
+{
+    as_object() |= rhs;
+    return *this;
+}
+
+template <typename string_t>
+inline basic_value<string_t>& basic_value<string_t>::operator|=(basic_object<string_t>&& rhs)
+{
+    as_object() |= std::move(rhs);
+    return *this;
+}
+
+template <typename string_t>
+inline basic_value<string_t> basic_value<string_t>::operator+(const basic_array<string_t>& rhs) const&
+{
+    return as_array() + rhs;
+}
+
+template <typename string_t>
+inline basic_value<string_t> basic_value<string_t>::operator+(basic_array<string_t>&& rhs) const&
+{
+    return as_array() + std::move(rhs);
+}
+
+template <typename string_t>
+inline basic_value<string_t> basic_value<string_t>::operator+(const basic_array<string_t>& rhs) &&
+{
+    return std::move(as_array()) + rhs;
+}
+
+template <typename string_t>
+inline basic_value<string_t> basic_value<string_t>::operator+(basic_array<string_t>&& rhs) &&
+{
+    return std::move(as_array()) + std::move(rhs);
+}
+
+template <typename string_t>
+inline basic_value<string_t>& basic_value<string_t>::operator+=(const basic_array<string_t>& rhs)
+{
+    as_array() += rhs;
+    return *this;
+}
+
+template <typename string_t>
+inline basic_value<string_t>& basic_value<string_t>::operator+=(basic_array<string_t>&& rhs)
+{
+    as_array() += std::move(rhs);
+    return *this;
+}
+
+template <typename string_t>
+template <typename... args_t>
+inline basic_value<string_t>::basic_value(value_type type, args_t&&... args)
+    : _type(type), _raw_data(std::forward<args_t>(args)...)
+{
+    static_assert(std::is_constructible_v<var_t, args_t...>, "Parameter can't be used to construct a var_t");
+}
+
+template <typename string_t>
+inline typename basic_value<string_t>::var_t basic_value<string_t>::deep_copy(const var_t& src)
+{
+    var_t dst;
+    if (const auto string_ptr = std::get_if<string_t>(&src)) {
+        dst = *string_ptr;
+    }
+    else if (const auto arr_ptr = std::get_if<array_ptr>(&src)) {
+        dst = std::make_unique<basic_array<string_t>>(**arr_ptr);
+    }
+    else if (const auto obj_ptr = std::get_if<object_ptr>(&src)) {
+        dst = std::make_unique<basic_object<string_t>>(**obj_ptr);
+    }
+    else {
+        // maybe invalid_value
+    }
+
+    return dst;
+}
+
+template <typename ostream_t, typename string_t,
+          typename std_ostream_t =
+              std::basic_ostream<typename string_t::value_type, std::char_traits<typename string_t::value_type>>,
+          typename =
+              std::enable_if_t<std::is_same_v<std_ostream_t, ostream_t> || std::is_base_of_v<std_ostream_t, ostream_t>>>
+ostream_t& operator<<(ostream_t& out, const basic_value<string_t>& val)
+{
+    out << val.format();
+    return out;
+}
+} // namespace json

3rdparty/include/meojson/json5.hpp

@@ -0,0 +1,4 @@
+#pragma once
+
+#include "common/types.hpp"
+#include "parser5/parser5.hpp"

3rdparty/include/meojson/parser/bitops.hpp

@@ -0,0 +1,112 @@
+#pragma once
+
+#if __cplusplus >= 202002L || (defined(_MSVC_LANG) && _MSVC_LANG >= 202002L)
+#include <bit>
+namespace json::_bitops
+{
+using std::countl_one;
+using std::countl_zero;
+using std::countr_one;
+using std::countr_zero;
+inline constexpr bool is_little_endian()
+{
+    return std::endian::native == std::endian::little;
+}
+}
+#else
+#include <cstdint>
+namespace json::_bitops
+{
+#if defined(__GNUC__) || defined(__clang__)
+inline constexpr int countl_zero(uint32_t x)
+{
+    if constexpr (sizeof(uint32_t) == sizeof(unsigned int)) return x == 0 ? 32 : __builtin_clz(x);
+    if constexpr (sizeof(uint32_t) == sizeof(unsigned long)) return x == 0 ? 32 : __builtin_clzl(x);
+    return x == 0 ? 32 : __builtin_clzll(x);
+}
+inline constexpr int countr_zero(uint32_t x)
+{
+    if constexpr (sizeof(uint32_t) == sizeof(unsigned int)) return x == 0 ? 32 : __builtin_ctz(x);
+    if constexpr (sizeof(uint32_t) == sizeof(unsigned long)) return x == 0 ? 32 : __builtin_ctzl(x);
+    return x == 0 ? 32 : __builtin_ctzll(x);
+}
+inline constexpr int countl_zero(uint64_t x)
+{
+    return x == 0 ? 64 : __builtin_clzll(x);
+}
+inline constexpr int countr_zero(uint64_t x)
+{
+    return x == 0 ? 64 : __builtin_ctzll(x);
+}
+#elif defined(_MSC_VER)
+#ifdef __AVX2__
+// lzcnt intrinsics is not constexpr
+inline int countl_zero(uint32_t x)
+{
+    return __lzcnt(x);
+}
+inline int countr_zero(uint32_t x)
+{
+    return _tzcnt_u32(x);
+}
+inline int countl_zero(uint64_t x)
+{
+    return (int)__lzcnt64(x);
+}
+inline int countr_zero(uint64_t x)
+{
+    return (int)_tzcnt_u64(x);
+}
+#else
+inline constexpr int countl_zero(uint32_t x)
+{
+    unsigned long index = 0;
+    return _BitScanReverse(&index, x) ? 31 - index : 32;
+}
+inline constexpr int countr_zero(uint32_t x)
+{
+    unsigned long index = 0;
+    return _BitScanForward(&index, x) ? index : 32;
+}
+inline constexpr int countl_zero(uint64_t x)
+{
+    unsigned long index = 0;
+    return _BitScanReverse64(&index, x) ? 63 - index : 64;
+}
+inline constexpr int countr_zero(uint64_t x)
+{
+    unsigned long index = 0;
+    return _BitScanForward64(&index, x) ? index : 64;
+}
+#endif // __AVX2__
+#else  // compiler
+#error "bring your own bit counting implementation"
+#endif
+inline int countl_one(uint32_t x)
+{
+    return countl_zero(~x);
+}
+inline int countr_one(uint32_t x)
+{
+    return countr_zero(~x);
+}
+inline int countl_one(uint64_t x)
+{
+    return countl_zero(~x);
+}
+inline int countr_one(uint64_t x)
+{
+    return countr_zero(~x);
+}
+
+// no constexpr endian awareness before C++20
+inline bool is_little_endian()
+{
+    union {
+        uint32_t u32;
+        uint8_t u8;
+    } u = { 0x01020304 };
+    return u.u8 == 4;
+}
+} // namespace json::_bitops
+#endif // C++20

3rdparty/include/meojson/parser/packed_bytes.hpp

@@ -1,25 +1,32 @@
 #pragma once
+
 #include <cstdint>
 #include <cstring>
 #include <type_traits>
+
 #include "bitops.hpp"
 
 #if defined(__GNUC__) || defined(__clang__)
-#define __packed_bytes_strong_inline __attribute__((always_inline)) 
+#define __packed_bytes_strong_inline __attribute__((always_inline))
 #elif defined(_MSC_VER)
 #define __packed_bytes_strong_inline __forceinline
 #else
 #define __packed_bytes_strong_inline inline
 #endif
 
-struct packed_bytes_trait_none {
+namespace json::_packed_bytes
+{
+struct packed_bytes_trait_none
+{
     static constexpr bool available = false;
 };
 
 template <size_t N>
-struct packed_bytes {
+struct packed_bytes
+{
     using traits = packed_bytes_trait_none;
 };
+}
 
 #if defined(__SSE2__) || defined(_M_X64) || (defined(_M_IX86_FP) && _M_IX86_FP)
 #include "packed_bytes_x86.hpp"
@@ -27,100 +34,108 @@ struct packed_bytes {
 #include "packed_bytes_arm.hpp"
 #endif
 
-struct packed_bytes_trait_uint64 {
+namespace json::_packed_bytes
+{
+struct packed_bytes_trait_uint64
+{
     static constexpr bool available = sizeof(void*) >= 8;
     static constexpr auto step = 8;
-    using value_type = std::enable_if_t<sizeof(void*) >= 8, uint64_t>;
+    using value_type = uint64_t;
 
-    __packed_bytes_strong_inline static value_type load_unaligned(const void *ptr) {
+    __packed_bytes_strong_inline static value_type load_unaligned(const void* ptr)
+    {
         value_type result;
         memcpy((void*)&result, ptr, 8);
         return result;
     }
 
-    __packed_bytes_strong_inline static value_type less(value_type x, uint8_t n) {
-        return (((x) - UINT64_C(0x0101010101010101) * (n)) & ~(x) & UINT64_C(0x8080808080808080));
-    }
-
-    __packed_bytes_strong_inline static value_type is_zero_memberwise(value_type v) {
-        return (((v) - UINT64_C(0x0101010101010101)) & ~(v) & UINT64_C(0x8080808080808080));
-    }
-
-    __packed_bytes_strong_inline static bool is_all_zero(value_type v)
+    __packed_bytes_strong_inline static value_type less(value_type x, uint8_t n)
     {
-        return v == UINT64_C(0);
+        return (((x)-UINT64_C(0x0101010101010101) * (n)) & ~(x)&UINT64_C(0x8080808080808080));
     }
 
-    __packed_bytes_strong_inline static value_type equal(value_type x, uint8_t n) {
+    __packed_bytes_strong_inline static value_type is_zero_memberwise(value_type v)
+    {
+        return (((v)-UINT64_C(0x0101010101010101)) & ~(v)&UINT64_C(0x8080808080808080));
+    }
+
+    __packed_bytes_strong_inline static bool is_all_zero(value_type v) { return v == UINT64_C(0); }
+
+    __packed_bytes_strong_inline static value_type equal(value_type x, uint8_t n)
+    {
         return is_zero_memberwise((x) ^ (UINT64_C(0x0101010101010101) * (n)));
     }
 
-    __packed_bytes_strong_inline static value_type bitwise_or(value_type a, value_type b) {
-        return a | b;
-    }
+    __packed_bytes_strong_inline static value_type bitwise_or(value_type a, value_type b) { return a | b; }
 
-    __packed_bytes_strong_inline static size_t first_nonzero_byte(value_type x) {
-        if (json::__bitops::is_little_endian())
-            return json::__bitops::countr_zero(x) / 8;
+    __packed_bytes_strong_inline static size_t first_nonzero_byte(value_type x)
+    {
+        if (_bitops::is_little_endian())
+            return _bitops::countr_zero(x) / 8;
         else
-            return json::__bitops::countl_zero(x) / 8;
+            return _bitops::countl_zero(x) / 8;
     }
 };
 
-struct packed_bytes_trait_uint32 {
+struct packed_bytes_trait_uint32
+{
     static constexpr bool available = true;
     static constexpr auto step = 4;
     using value_type = uint32_t;
 
-    __packed_bytes_strong_inline static value_type load_unaligned(const void *ptr) {
+    __packed_bytes_strong_inline static value_type load_unaligned(const void* ptr)
+    {
         value_type result;
         memcpy((void*)&result, ptr, 4);
         return result;
     }
 
-    __packed_bytes_strong_inline static value_type less(value_type x, uint8_t n) {
+    __packed_bytes_strong_inline static value_type less(value_type x, uint8_t n)
+    {
         return (((x) - ~UINT32_C(0) / 255 * (n)) & ~(x) & ~UINT32_C(0) / 255 * 128);
     }
 
-    __packed_bytes_strong_inline static value_type is_zero_memberwise(value_type v) {
-        return (((v) - UINT32_C(0x01010101)) & ~(v) & UINT32_C(0x80808080));;
+    __packed_bytes_strong_inline static value_type is_zero_memberwise(value_type v)
+    {
+        return (((v)-UINT32_C(0x01010101)) & ~(v)&UINT32_C(0x80808080));
+        ;
     }
 
-    __packed_bytes_strong_inline static bool is_all_zero(value_type v) {
-        return v == UINT32_C(0);
-    }
+    __packed_bytes_strong_inline static bool is_all_zero(value_type v) { return v == UINT32_C(0); }
 
-    __packed_bytes_strong_inline static value_type equal(value_type x, uint8_t n) {
+    __packed_bytes_strong_inline static value_type equal(value_type x, uint8_t n)
+    {
         return is_zero_memberwise((x) ^ (~UINT32_C(0) / 255 * (n)));
     }
 
-    __packed_bytes_strong_inline static value_type bitwise_or(value_type a, value_type b) {
-        return a | b;
-    }
+    __packed_bytes_strong_inline static value_type bitwise_or(value_type a, value_type b) { return a | b; }
 
-    __packed_bytes_strong_inline static size_t first_nonzero_byte(value_type x) {
-        if (json::__bitops::is_little_endian())
-            return json::__bitops::countr_zero(x) / 8;
+    __packed_bytes_strong_inline static size_t first_nonzero_byte(value_type x)
+    {
+        if (_bitops::is_little_endian())
+            return _bitops::countr_zero(x) / 8;
         else
-            return json::__bitops::countl_zero(x) / 8;
+            return _bitops::countl_zero(x) / 8;
     }
 };
 template <>
-struct packed_bytes<8> {
-    using traits = std::enable_if_t<packed_bytes_trait_uint64::available, packed_bytes_trait_uint64>;
+struct packed_bytes<8>
+{
+    using traits = packed_bytes_trait_uint64;
 };
 
 template <>
-struct packed_bytes<4> {
+struct packed_bytes<4>
+{
     using traits = packed_bytes_trait_uint32;
 };
 
 template <size_t N>
 using packed_bytes_trait = typename packed_bytes<N>::traits;
 
-using packed_bytes_trait_max = std::conditional_t<packed_bytes_trait<32>::available, packed_bytes_trait<32>,
-  std::conditional_t<packed_bytes_trait<16>::available, packed_bytes_trait<16>,
-    std::conditional_t<packed_bytes_trait<8>::available, packed_bytes_trait<8>,
-      packed_bytes_trait<4>
-  >>>;
-
+using packed_bytes_trait_max =
+    std::conditional_t<packed_bytes_trait<32>::available, packed_bytes_trait<32>,
+                       std::conditional_t<packed_bytes_trait<16>::available, packed_bytes_trait<16>,
+                                          std::conditional_t<packed_bytes_trait<8>::available, packed_bytes_trait<8>,
+                                                             packed_bytes_trait<4>>>>;
+} // namespace json::_packed_bytes

3rdparty/include/meojson/parser/packed_bytes_arm.hpp

@@ -9,34 +9,31 @@
 #define __packed_bytes_trait_arm64
 #endif
 
-struct packed_bytes_trait_neon {
+namespace json::_packed_bytes
+{
+struct packed_bytes_trait_neon
+{
     static constexpr bool available = true;
     static constexpr auto step = 16;
     using value_type = uint8x16_t;
 
-    __packed_bytes_strong_inline static value_type load_unaligned(const void *ptr) {
-        return vld1q_u8((uint8_t*)ptr);
-    }
+    __packed_bytes_strong_inline static value_type load_unaligned(const void* ptr) { return vld1q_u8((uint8_t*)ptr); }
 
-    __packed_bytes_strong_inline static value_type less(value_type x, uint8_t n) {
+    __packed_bytes_strong_inline static value_type less(value_type x, uint8_t n)
+    {
         auto bcast = vdupq_n_u8(n);
         auto is_less = vcltq_u8(x, bcast);
         return is_less;
     }
 
-    __packed_bytes_strong_inline static value_type equal(value_type x, uint8_t n) {
-        return vceqq_u8(x, vdupq_n_u8(n));
-    }
+    __packed_bytes_strong_inline static value_type equal(value_type x, uint8_t n) { return vceqq_u8(x, vdupq_n_u8(n)); }
 
-    __packed_bytes_strong_inline static value_type equal(value_type x, value_type y) {
-        return vceqq_u8(x, y);
-    }
+    __packed_bytes_strong_inline static value_type equal(value_type x, value_type y) { return vceqq_u8(x, y); }
 
-    __packed_bytes_strong_inline static value_type bitwise_or(value_type a, value_type b) {
-        return vorrq_u8(a, b);
-    }
+    __packed_bytes_strong_inline static value_type bitwise_or(value_type a, value_type b) { return vorrq_u8(a, b); }
 
-    __packed_bytes_strong_inline static bool is_all_zero(value_type x) {
+    __packed_bytes_strong_inline static bool is_all_zero(value_type x)
+    {
 #ifdef __packed_bytes_trait_arm64
         return vmaxvq_u8(x) == 0;
 #else
@@ -46,18 +43,20 @@ struct packed_bytes_trait_neon {
 #endif
     }
 
-    __packed_bytes_strong_inline static size_t first_nonzero_byte(value_type x) {
+    __packed_bytes_strong_inline static size_t first_nonzero_byte(value_type x)
+    {
         // https://community.arm.com/arm-community-blogs/b/infrastructure-solutions-blog/posts/porting-x86-vector-bitmask-optimizations-to-arm-neon
         auto cmp = equal(x, 0);
         auto res = vshrn_n_u16(cmp, 4);
         auto mask64 = vget_lane_u64(vreinterpret_u64_u8(res), 0);
-        return json::__bitops::countr_one(mask64) >> 2;
+        return _bitops::countr_one(mask64) >> 2;
     }
 };
 
 template <>
-struct packed_bytes<16> {
+struct packed_bytes<16>
+{
     using traits = packed_bytes_trait_neon;
 };
-
+}
 #endif

3rdparty/include/meojson/parser/packed_bytes_x86.hpp

@@ -2,21 +2,26 @@
 #include "packed_bytes.hpp"
 
 #include <emmintrin.h>
-#if defined(__SSE4_1__) || defined(__AVX2__) || defined(_MSC_VER) 
+#if defined(__SSE4_1__) || defined(__AVX2__) || defined(_MSC_VER)
 // MSVC enables all SSE4.1 intrinsics by default
 #include <smmintrin.h>
 #endif
 
-struct packed_bytes_trait_sse {
+namespace json::_packed_bytes
+{
+struct packed_bytes_trait_sse
+{
     static constexpr bool available = true;
     static constexpr auto step = 16;
     using value_type = __m128i;
 
-    __packed_bytes_strong_inline static value_type load_unaligned(const void *ptr) {
+    __packed_bytes_strong_inline static value_type load_unaligned(const void* ptr)
+    {
         return _mm_loadu_si128(reinterpret_cast<const __m128i*>(ptr));
     }
 
-    __packed_bytes_strong_inline static value_type less(value_type x, uint8_t n) {
+    __packed_bytes_strong_inline static value_type less(value_type x, uint8_t n)
+    {
         auto bcast = _mm_set1_epi8(static_cast<char>(n));
         auto all1 = _mm_set1_epi8(-1);
         auto max_with_n = _mm_max_epu8(x, bcast);
@@ -25,19 +30,17 @@ struct packed_bytes_trait_sse {
         return is_less;
     }
 
-    __packed_bytes_strong_inline static value_type equal(value_type x, uint8_t n) {
+    __packed_bytes_strong_inline static value_type equal(value_type x, uint8_t n)
+    {
         return _mm_cmpeq_epi8(x, _mm_set1_epi8(static_cast<char>(n)));
     }
 
-    __packed_bytes_strong_inline static value_type equal(value_type x, value_type y) {
-        return _mm_cmpeq_epi8(x, y);
-    }
+    __packed_bytes_strong_inline static value_type equal(value_type x, value_type y) { return _mm_cmpeq_epi8(x, y); }
 
-    __packed_bytes_strong_inline static value_type bitwise_or(value_type a, value_type b) {
-        return _mm_or_si128(a, b);
-    }
+    __packed_bytes_strong_inline static value_type bitwise_or(value_type a, value_type b) { return _mm_or_si128(a, b); }
 
-    __packed_bytes_strong_inline static bool is_all_zero(value_type x) {
+    __packed_bytes_strong_inline static bool is_all_zero(value_type x)
+    {
 #if defined(__SSE4_1__) || defined(__AVX2__) || defined(_MSC_VER)
         // SSE4.1 path
         return !!_mm_testz_si128(x, x);
@@ -49,22 +52,25 @@ struct packed_bytes_trait_sse {
 #endif
     }
 
-    __packed_bytes_strong_inline static size_t first_nonzero_byte(value_type x) {
+    __packed_bytes_strong_inline static size_t first_nonzero_byte(value_type x)
+    {
         auto cmp = _mm_cmpeq_epi8(x, _mm_set1_epi8(0));
         auto mask = (uint16_t)_mm_movemask_epi8(cmp);
-        return json::__bitops::countr_one((uint32_t)mask);
+        return _bitops::countr_one((uint32_t)mask);
     }
 };
 
 template <>
-struct packed_bytes<16> {
+struct packed_bytes<16>
+{
     using traits = packed_bytes_trait_sse;
 };
-
-
+}
 #ifdef __AVX2__
 #include <immintrin.h>
 
+namespace json::_packed_bytes
+{
 struct packed_bytes_trait_avx2
 {
     static constexpr bool available = true;
@@ -91,33 +97,29 @@ struct packed_bytes_trait_avx2
         return _mm256_cmpeq_epi8(x, _mm256_set1_epi8(static_cast<char>(n)));
     }
 
-    __packed_bytes_strong_inline static value_type equal(value_type x, value_type y)
-    {
-        return _mm256_cmpeq_epi8(x, y);
-    }
+    __packed_bytes_strong_inline static value_type equal(value_type x, value_type y) { return _mm256_cmpeq_epi8(x, y); }
 
     __packed_bytes_strong_inline static value_type bitwise_or(value_type a, value_type b)
     {
         return _mm256_or_si256(a, b);
     }
 
-    __packed_bytes_strong_inline static bool is_all_zero(value_type x)
-    {
-        return (bool)_mm256_testz_si256(x, x);
-    }
+    __packed_bytes_strong_inline static bool is_all_zero(value_type x) { return (bool)_mm256_testz_si256(x, x); }
 
     __packed_bytes_strong_inline static size_t first_nonzero_byte(value_type x)
     {
         auto cmp = _mm256_cmpeq_epi8(x, _mm256_set1_epi8(0));
         auto mask = (uint32_t)_mm256_movemask_epi8(cmp);
         // AVX512 alternative: _mm_cmpeq_epi8_mask
-        return json::__bitops::countr_one(mask);
+        return _bitops::countr_one(mask);
     }
 };
 
 template <>
-struct packed_bytes<32> {
+struct packed_bytes<32>
+{
     using traits = packed_bytes_trait_avx2;
 };
+}
 
 #endif

3rdparty/include/meojson/parser/parser.hpp

@@ -0,0 +1,627 @@
+#pragma once
+
+#include <fstream>
+#include <optional>
+#include <ostream>
+#include <string>
+#include <tuple>
+
+#include "../common/types.hpp"
+#include "packed_bytes.hpp"
+
+namespace json
+{
+// ****************************
+// *      parser declare      *
+// ****************************
+
+template <typename string_t = default_string_t, typename parsing_t = void,
+          typename accel_traits = _packed_bytes::packed_bytes_trait_max>
+class parser
+{
+public:
+    using parsing_iter_t = typename parsing_t::const_iterator;
+
+public:
+    ~parser() noexcept = default;
+
+    static std::optional<basic_value<string_t>> parse(const parsing_t& content);
+
+private:
+    parser(parsing_iter_t cbegin, parsing_iter_t cend) noexcept : _cur(cbegin), _end(cend) { ; }
+
+    std::optional<basic_value<string_t>> parse();
+    basic_value<string_t> parse_value();
+
+    basic_value<string_t> parse_null();
+    basic_value<string_t> parse_boolean();
+    basic_value<string_t> parse_number();
+    // parse and return a basic_value<string_t> whose type is value_type::string
+    basic_value<string_t> parse_string();
+    basic_value<string_t> parse_array();
+    basic_value<string_t> parse_object();
+
+    // parse and return a string_t
+    std::optional<string_t> parse_stdstring();
+
+    bool skip_string_literal_with_accel();
+    bool skip_whitespace() noexcept;
+    bool skip_digit();
+
+private:
+    parsing_iter_t _cur;
+    parsing_iter_t _end;
+};
+
+// ***************************
+// *      utils declare      *
+// ***************************
+
+template <typename parsing_t>
+auto parse(const parsing_t& content);
+
+template <typename char_t>
+auto parse(char_t* content);
+
+template <typename istream_t,
+          typename = std::enable_if_t<std::is_base_of_v<std::basic_istream<typename istream_t::char_type>, istream_t>>>
+auto parse(istream_t& istream, bool check_bom);
+
+template <typename ifstream_t = std::ifstream, typename path_t = void>
+auto open(const path_t& path, bool check_bom = false);
+
+namespace literals
+{
+    value operator""_json(const char* str, size_t len);
+    wvalue operator""_json(const wchar_t* str, size_t len);
+
+    value operator""_jvalue(const char* str, size_t len);
+    wvalue operator""_jvalue(const wchar_t* str, size_t len);
+
+    array operator""_jarray(const char* str, size_t len);
+    warray operator""_jarray(const wchar_t* str, size_t len);
+
+    object operator""_jobject(const char* str, size_t len);
+    wobject operator""_jobject(const wchar_t* str, size_t len);
+}
+
+template <typename string_t = default_string_t>
+const basic_value<string_t> invalid_value();
+
+// *************************
+// *      parser impl      *
+// *************************
+
+template <typename string_t, typename parsing_t, typename accel_traits>
+inline std::optional<basic_value<string_t>> parser<string_t, parsing_t, accel_traits>::parse(const parsing_t& content)
+{
+    return parser<string_t, parsing_t, accel_traits>(content.cbegin(), content.cend()).parse();
+}
+
+template <typename string_t, typename parsing_t, typename accel_traits>
+inline std::optional<basic_value<string_t>> parser<string_t, parsing_t, accel_traits>::parse()
+{
+    if (!skip_whitespace()) {
+        return std::nullopt;
+    }
+
+    basic_value<string_t> result_value;
+    switch (*_cur) {
+    case '[':
+        result_value = parse_array();
+        break;
+    case '{':
+        result_value = parse_object();
+        break;
+    default: // A JSON payload should be an basic_object or basic_array
+        return std::nullopt;
+    }
+
+    if (!result_value.valid()) {
+        return std::nullopt;
+    }
+
+    // After the parsing is complete, there should be no more content other than
+    // spaces behind
+    if (skip_whitespace()) {
+        return std::nullopt;
+    }
+
+    return result_value;
+}
+
+template <typename string_t, typename parsing_t, typename accel_traits>
+inline basic_value<string_t> parser<string_t, parsing_t, accel_traits>::parse_value()
+{
+    switch (*_cur) {
+    case 'n':
+        return parse_null();
+    case 't':
+    case 'f':
+        return parse_boolean();
+    case '-':
+    case '0':
+    case '1':
+    case '2':
+    case '3':
+    case '4':
+    case '5':
+    case '6':
+    case '7':
+    case '8':
+    case '9':
+        return parse_number();
+    case '"':
+        return parse_string();
+    case '[':
+        return parse_array();
+    case '{':
+        return parse_object();
+    default:
+        return invalid_value<string_t>();
+    }
+}
+
+template <typename string_t, typename parsing_t, typename accel_traits>
+inline basic_value<string_t> parser<string_t, parsing_t, accel_traits>::parse_null()
+{
+    for (const auto& ch : _utils::null_string<string_t>()) {
+        if (_cur != _end && *_cur == ch) {
+            ++_cur;
+        }
+        else {
+            return invalid_value<string_t>();
+        }
+    }
+
+    return basic_value<string_t>();
+}
+
+template <typename string_t, typename parsing_t, typename accel_traits>
+inline basic_value<string_t> parser<string_t, parsing_t, accel_traits>::parse_boolean()
+{
+    switch (*_cur) {
+    case 't':
+        for (const auto& ch : _utils::true_string<string_t>()) {
+            if (_cur != _end && *_cur == ch) {
+                ++_cur;
+            }
+            else {
+                return invalid_value<string_t>();
+            }
+        }
+        return true;
+    case 'f':
+        for (const auto& ch : _utils::false_string<string_t>()) {
+            if (_cur != _end && *_cur == ch) {
+                ++_cur;
+            }
+            else {
+                return invalid_value<string_t>();
+            }
+        }
+        return false;
+    default:
+        return invalid_value<string_t>();
+    }
+}
+
+template <typename string_t, typename parsing_t, typename accel_traits>
+inline basic_value<string_t> parser<string_t, parsing_t, accel_traits>::parse_number()
+{
+    const auto first = _cur;
+    if (*_cur == '-') {
+        ++_cur;
+    }
+
+    // numbers cannot have leading zeroes
+    if (_cur != _end && *_cur == '0' && _cur + 1 != _end && std::isdigit(*(_cur + 1))) {
+        return invalid_value<string_t>();
+    }
+
+    if (!skip_digit()) {
+        return invalid_value<string_t>();
+    }
+
+    if (*_cur == '.') {
+        ++_cur;
+        if (!skip_digit()) {
+            return invalid_value<string_t>();
+        }
+    }
+
+    if (*_cur == 'e' || *_cur == 'E') {
+        if (++_cur == _end) {
+            return invalid_value<string_t>();
+        }
+        if (*_cur == '+' || *_cur == '-') {
+            ++_cur;
+        }
+        if (!skip_digit()) {
+            return invalid_value<string_t>();
+        }
+    }
+
+    return basic_value<string_t>(basic_value<string_t>::value_type::number, string_t(first, _cur));
+}
+
+template <typename string_t, typename parsing_t, typename accel_traits>
+inline basic_value<string_t> parser<string_t, parsing_t, accel_traits>::parse_string()
+{
+    auto string_opt = parse_stdstring();
+    if (!string_opt) {
+        return invalid_value<string_t>();
+    }
+    return basic_value<string_t>(basic_value<string_t>::value_type::string, std::move(string_opt).value());
+}
+
+template <typename string_t, typename parsing_t, typename accel_traits>
+inline basic_value<string_t> parser<string_t, parsing_t, accel_traits>::parse_array()
+{
+    if (*_cur == '[') {
+        ++_cur;
+    }
+    else {
+        return invalid_value<string_t>();
+    }
+
+    if (!skip_whitespace()) {
+        return invalid_value<string_t>();
+    }
+    else if (*_cur == ']') {
+        ++_cur;
+        // empty basic_array
+        return basic_array<string_t>();
+    }
+
+    typename basic_array<string_t>::raw_array result;
+    while (true) {
+        if (!skip_whitespace()) {
+            return invalid_value<string_t>();
+        }
+
+        basic_value<string_t> val = parse_value();
+
+        if (!val.valid() || !skip_whitespace()) {
+            return invalid_value<string_t>();
+        }
+
+        result.emplace_back(std::move(val));
+
+        if (*_cur == ',') {
+            ++_cur;
+        }
+        else {
+            break;
+        }
+    }
+
+    if (skip_whitespace() && *_cur == ']') {
+        ++_cur;
+    }
+    else {
+        return invalid_value<string_t>();
+    }
+
+    return basic_array<string_t>(std::move(result));
+}
+
+template <typename string_t, typename parsing_t, typename accel_traits>
+inline basic_value<string_t> parser<string_t, parsing_t, accel_traits>::parse_object()
+{
+    if (*_cur == '{') {
+        ++_cur;
+    }
+    else {
+        return invalid_value<string_t>();
+    }
+
+    if (!skip_whitespace()) {
+        return invalid_value<string_t>();
+    }
+    else if (*_cur == '}') {
+        ++_cur;
+        // empty basic_object
+        return basic_object<string_t>();
+    }
+
+    typename basic_object<string_t>::raw_object result;
+    while (true) {
+        if (!skip_whitespace()) {
+            return invalid_value<string_t>();
+        }
+
+        auto key_opt = parse_stdstring();
+
+        if (key_opt && skip_whitespace() && *_cur == ':') {
+            ++_cur;
+        }
+        else {
+            return invalid_value<string_t>();
+        }
+
+        if (!skip_whitespace()) {
+            return invalid_value<string_t>();
+        }
+
+        basic_value<string_t> val = parse_value();
+
+        if (!val.valid() || !skip_whitespace()) {
+            return invalid_value<string_t>();
+        }
+
+        result.emplace(std::move(*key_opt), std::move(val));
+
+        if (*_cur == ',') {
+            ++_cur;
+        }
+        else {
+            break;
+        }
+    }
+
+    if (skip_whitespace() && *_cur == '}') {
+        ++_cur;
+    }
+    else {
+        return invalid_value<string_t>();
+    }
+
+    return basic_object<string_t>(std::move(result));
+}
+
+template <typename string_t, typename parsing_t, typename accel_traits>
+inline std::optional<string_t> parser<string_t, parsing_t, accel_traits>::parse_stdstring()
+{
+    if (*_cur == '"') {
+        ++_cur;
+    }
+    else {
+        return std::nullopt;
+    }
+
+    string_t result;
+    auto no_escape_beg = _cur;
+
+    while (_cur != _end) {
+        if constexpr (sizeof(*_cur) == 1 && accel_traits::available) {
+            if (!skip_string_literal_with_accel()) {
+                return std::nullopt;
+            }
+        }
+        switch (*_cur) {
+        case '\t':
+        case '\r':
+        case '\n':
+            return std::nullopt;
+        case '\\': {
+            result += string_t(no_escape_beg, _cur++);
+            if (_cur == _end) {
+                return std::nullopt;
+            }
+            switch (*_cur) {
+            case '"':
+                result.push_back('"');
+                break;
+            case '\\':
+                result.push_back('\\');
+                break;
+            case '/':
+                result.push_back('/');
+                break;
+            case 'b':
+                result.push_back('\b');
+                break;
+            case 'f':
+                result.push_back('\f');
+                break;
+            case 'n':
+                result.push_back('\n');
+                break;
+            case 'r':
+                result.push_back('\r');
+                break;
+            case 't':
+                result.push_back('\t');
+                break;
+                // case 'u':
+                //     result.push_back('\u');
+                //     break;
+            default:
+                // Illegal backslash escape
+                return std::nullopt;
+            }
+            no_escape_beg = ++_cur;
+            break;
+        }
+        case '"': {
+            result += string_t(no_escape_beg, _cur++);
+            return result;
+        }
+        default:
+            ++_cur;
+            break;
+        }
+    }
+    return std::nullopt;
+}
+
+template <typename string_t, typename parsing_t, typename accel_traits>
+inline bool parser<string_t, parsing_t, accel_traits>::skip_string_literal_with_accel()
+{
+    if constexpr (sizeof(*_cur) != 1) {
+        return false;
+    }
+
+    while (_end - _cur >= accel_traits::step) {
+        auto pack = accel_traits::load_unaligned(&(*_cur));
+        auto result = accel_traits::less(pack, 32);
+        result = accel_traits::bitwise_or(result, accel_traits::equal(pack, static_cast<uint8_t>('"')));
+        result = accel_traits::bitwise_or(result, accel_traits::equal(pack, static_cast<uint8_t>('\\')));
+
+        if (accel_traits::is_all_zero(result)) {
+            _cur += accel_traits::step;
+        }
+        else {
+            auto index = accel_traits::first_nonzero_byte(result);
+            _cur += index;
+            break;
+        }
+    }
+
+    return _cur != _end;
+}
+
+template <typename string_t, typename parsing_t, typename accel_traits>
+inline bool parser<string_t, parsing_t, accel_traits>::skip_whitespace() noexcept
+{
+    while (_cur != _end) {
+        switch (*_cur) {
+        case ' ':
+        case '\t':
+        case '\r':
+        case '\n':
+            ++_cur;
+            break;
+        case '\0':
+            return false;
+        default:
+            return true;
+        }
+    }
+    return false;
+}
+
+template <typename string_t, typename parsing_t, typename accel_traits>
+inline bool parser<string_t, parsing_t, accel_traits>::skip_digit()
+{
+    // At least one digit
+    if (_cur != _end && std::isdigit(*_cur)) {
+        ++_cur;
+    }
+    else {
+        return false;
+    }
+
+    while (_cur != _end && std::isdigit(*_cur)) {
+        ++_cur;
+    }
+
+    if (_cur != _end) {
+        return true;
+    }
+    else {
+        return false;
+    }
+}
+
+// *************************
+// *      utils impl       *
+// *************************
+
+template <typename parsing_t>
+auto parse(const parsing_t& content)
+{
+    using string_t = std::basic_string<typename parsing_t::value_type>;
+    return parser<string_t, parsing_t>::parse(content);
+}
+
+template <typename char_t>
+auto parse(char_t* content)
+{
+    return parse(std::basic_string_view<std::decay_t<char_t>> { content });
+}
+
+template <typename istream_t, typename _>
+auto parse(istream_t& ifs, bool check_bom)
+{
+    using string_t = std::basic_string<typename istream_t::char_type>;
+
+    ifs.seekg(0, std::ios::end);
+    auto file_size = ifs.tellg();
+
+    ifs.seekg(0, std::ios::beg);
+    string_t str(file_size, '\0');
+
+    ifs.read(str.data(), file_size);
+
+    if (check_bom) {
+        using uchar = unsigned char;
+        static constexpr uchar Bom_0 = 0xEF;
+        static constexpr uchar Bom_1 = 0xBB;
+        static constexpr uchar Bom_2 = 0xBF;
+
+        if (str.size() >= 3 && static_cast<uchar>(str.at(0)) == Bom_0 && static_cast<uchar>(str.at(1)) == Bom_1 &&
+            static_cast<uchar>(str.at(2)) == Bom_2) {
+            str.assign(str.begin() + 3, str.end());
+        }
+    }
+    return parse(str);
+}
+
+template <typename ifstream_t, typename path_t>
+auto open(const path_t& filepath, bool check_bom)
+{
+    using char_t = typename ifstream_t::char_type;
+    using string_t = std::basic_string<char_t>;
+    using json_t = json::basic_value<string_t>;
+    using return_t = std::optional<json_t>;
+
+    ifstream_t ifs(filepath, std::ios::in);
+    if (!ifs.is_open()) {
+        return return_t(std::nullopt);
+    }
+    auto opt = parse(ifs, check_bom);
+    ifs.close();
+    return opt;
+}
+
+namespace literals
+{
+    inline value operator""_json(const char* str, size_t len)
+    {
+        return operator""_jvalue(str, len);
+    }
+    inline wvalue operator""_json(const wchar_t* str, size_t len)
+    {
+        return operator""_jvalue(str, len);
+    }
+
+    inline value operator""_jvalue(const char* str, size_t len)
+    {
+        return parse(std::string_view(str, len)).value_or(value());
+    }
+    inline wvalue operator""_jvalue(const wchar_t* str, size_t len)
+    {
+        return parse(std::wstring_view(str, len)).value_or(wvalue());
+    }
+
+    inline array operator""_jarray(const char* str, size_t len)
+    {
+        auto val = parse(std::string_view(str, len)).value_or(value());
+        return val.is_array() ? val.as_array() : array();
+    }
+    inline warray operator""_jarray(const wchar_t* str, size_t len)
+    {
+        auto val = parse(std::wstring_view(str, len)).value_or(wvalue());
+        return val.is_array() ? val.as_array() : warray();
+    }
+
+    inline object operator""_jobject(const char* str, size_t len)
+    {
+        auto val = parse(std::string_view(str, len)).value_or(value());
+        return val.is_object() ? val.as_object() : object();
+    }
+    inline wobject operator""_jobject(const wchar_t* str, size_t len)
+    {
+        auto val = parse(std::wstring_view(str, len)).value_or(wvalue());
+        return val.is_object() ? val.as_object() : wobject();
+    }
+} // namespace literals
+
+template <typename string_t>
+const basic_value<string_t> invalid_value()
+{
+    return basic_value<string_t>(basic_value<string_t>::value_type::invalid, typename basic_value<string_t>::var_t());
+}
+} // namespace json

3rdparty/include/meojson/reflection/jsonization.hpp

@@ -0,0 +1,241 @@
+#pragma once
+
+#include <string>
+#include <type_traits>
+
+#include "../common/types.hpp"
+
+namespace json::_jsonization_helper
+{
+struct next_is_optional_t
+{};
+struct va_arg_end
+{};
+
+struct dumper
+{
+    template <typename var_t, typename... rest_t>
+    json::value _to_json(const char* key, const var_t& var, rest_t&&... rest) const
+    {
+        json::value result = _to_json(std::forward<rest_t>(rest)...);
+        result.emplace(key, var);
+        return result;
+    }
+    template <typename... rest_t>
+    json::value _to_json(const char*, next_is_optional_t, rest_t&&... rest) const
+    {
+        return _to_json(std::forward<rest_t>(rest)...);
+    }
+    json::value _to_json(va_arg_end) const { return {}; }
+};
+
+struct checker
+{
+    template <typename var_t, typename... rest_t>
+    bool _check_json(const json::value& in, std::string& error_key, const char* key, const var_t&,
+                     rest_t&&... rest) const
+    {
+        auto opt = in.find(key);
+        if (!opt || !opt->is<var_t>()) {
+            error_key = key;
+            return false;
+        }
+        return _check_json(in, error_key, std::forward<rest_t>(rest)...);
+    }
+    template <typename var_t, typename... rest_t>
+    bool _check_json(const json::value& in, std::string& error_key, const char*, next_is_optional_t, const char* key,
+                     const var_t&, rest_t&&... rest) const
+    {
+        auto opt = in.find(key);
+        if (opt) {
+            if (!opt->is<var_t>()) {
+                error_key = key;
+                return false;
+            }
+        } // next_is_optional_t, ignore key not found
+
+        return _check_json(in, error_key, std::forward<rest_t>(rest)...);
+    }
+    bool _check_json(const json::value&, std::string&, va_arg_end) const { return true; }
+};
+
+struct loader
+{
+    template <typename var_t, typename... rest_t>
+    bool _from_json(const json::value& in, std::string& error_key, const char* key, var_t& var, rest_t&&... rest) const
+    {
+        auto opt = in.find(key);
+        if (!opt || !opt->is<var_t>()) {
+            error_key = key;
+            return false;
+        }
+        var = std::move(opt)->as<var_t>();
+
+        return _from_json(in, error_key, std::forward<rest_t>(rest)...);
+    }
+    template <typename var_t, typename... rest_t>
+    bool _from_json(const json::value& in, std::string& error_key, const char*, next_is_optional_t, const char* key,
+                    var_t& var, rest_t&&... rest) const
+    {
+        auto opt = in.find(key);
+        if (opt) {
+            if (!opt->is<var_t>()) {
+                error_key = key;
+                return false;
+            }
+            var = std::move(opt)->as<var_t>();
+        } // next_is_optional_t, ignore key not found
+
+        return _from_json(in, error_key, std::forward<rest_t>(rest)...);
+    }
+    bool _from_json(const json::value&, std::string&, va_arg_end) const { return true; }
+};
+} // namespace json::_jsonization_helper
+
+#if defined(__clang__)
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Wgnu-zero-variadic-macro-arguments"
+#endif
+
+namespace json::_private_macro
+{
+#define _MEOJSON_STRINGIZE(arg) _MEOJSON_STRINGIZE1(arg)
+#define _MEOJSON_STRINGIZE1(arg) _MEOJSON_STRINGIZE2(arg)
+#define _MEOJSON_STRINGIZE2(arg) #arg
+
+#define _MEOJSON_CONCATENATE(arg1, arg2) _MEOJSON_CONCATENATE1(arg1, arg2)
+#define _MEOJSON_CONCATENATE1(arg1, arg2) _MEOJSON_CONCATENATE2(arg1, arg2)
+#define _MEOJSON_CONCATENATE2(arg1, arg2) arg1##arg2
+
+#define _MEOJSON_EXPAND(x) x
+
+#define _MEOJSON_FOR_EACH_0(pred, ...)
+#define _MEOJSON_FOR_EACH_1(pred, x, ...) pred(x)
+#define _MEOJSON_FOR_EACH_2(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_1(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_3(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_2(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_4(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_3(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_5(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_4(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_6(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_5(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_7(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_6(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_8(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_7(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_9(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_8(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_10(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_9(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_11(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_10(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_12(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_11(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_13(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_12(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_14(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_13(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_15(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_14(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_16(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_15(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_17(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_16(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_18(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_17(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_19(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_18(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_20(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_19(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_21(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_20(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_22(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_21(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_23(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_22(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_24(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_23(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_25(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_24(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_26(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_25(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_27(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_26(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_28(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_27(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_29(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_28(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_30(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_29(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_31(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_30(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_32(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_31(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_33(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_32(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_34(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_33(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_35(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_34(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_36(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_35(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_37(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_36(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_38(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_37(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_39(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_38(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_40(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_39(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_41(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_40(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_42(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_41(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_43(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_42(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_44(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_43(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_45(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_44(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_46(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_45(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_47(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_46(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_48(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_47(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_49(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_48(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_50(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_49(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_51(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_50(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_52(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_51(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_53(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_52(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_54(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_53(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_55(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_54(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_56(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_55(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_57(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_56(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_58(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_57(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_59(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_58(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_60(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_59(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_61(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_60(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_62(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_61(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_63(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_62(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH_64(pred, x, ...) pred(x) _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_63(pred, __VA_ARGS__))
+
+#define _MEOJSON_ARG_COUNT(...)                                                                                       \
+    _MEOJSON_EXPAND(_MEOJSON_ARG_COUNT1(0, ##__VA_ARGS__, 64, 63, 62, 61, 60, 59, 58, 57, 56, 55, 54, 53, 52, 51, 50, \
+                                        49, 48, 47, 46, 45, 44, 43, 42, 41, 40, 39, 38, 37, 36, 35, 34, 33, 32, 31,   \
+                                        30, 29, 28, 27, 26, 25, 24, 23, 22, 21, 20, 19, 18, 17, 16, 15, 14, 13, 12,   \
+                                        11, 10, 9, 8, 7, 6, 5, 4, 3, 2, 1, 0))
+#define _MEOJSON_ARG_COUNT1(_0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12, _13, _14, _15, _16, _17, _18, _19, \
+                            _20, _21, _22, _23, _24, _25, _26, _27, _28, _29, _30, _31, _32, _33, _34, _35, _36, _37, \
+                            _38, _39, _40, _41, _42, _43, _44, _45, _46, _47, _48, _49, _50, _51, _52, _53, _54, _55, \
+                            _56, _57, _58, _59, _60, _61, _62, _63, _64, N, ...)                                      \
+    N
+
+#define _MEOJSON_FOR_EACH_(N, pred, ...) _MEOJSON_EXPAND(_MEOJSON_CONCATENATE(_MEOJSON_FOR_EACH_, N)(pred, __VA_ARGS__))
+#define _MEOJSON_FOR_EACH(pred, ...) \
+    _MEOJSON_EXPAND(_MEOJSON_FOR_EACH_(_MEOJSON_EXPAND(_MEOJSON_ARG_COUNT(__VA_ARGS__)), pred, __VA_ARGS__))
+
+#define _MEOJSON_VARNAME(x) _MEOJSON_CONCATENATE(_meojson_jsonization_, x)
+#define _MEOJSON_KEY_VALUE(x) _MEOJSON_STRINGIZE(x), x,
+} // namespace json::_private_macro
+
+#define MEO_TOJSON(...)                                                                                    \
+    json::value to_json() const                                                                            \
+    {                                                                                                      \
+        return json::_jsonization_helper::dumper()._to_json(_MEOJSON_EXPAND(                               \
+            _MEOJSON_FOR_EACH(_MEOJSON_KEY_VALUE, __VA_ARGS__)) json::_jsonization_helper::va_arg_end {}); \
+    }
+
+#define MEO_CHECKJSON(...)                                                                                   \
+    bool check_json(const json::value& _MEOJSON_VARNAME(in)) const                                           \
+    {                                                                                                        \
+        std::string _MEOJSON_VARNAME(error_key);                                                             \
+        return check_json(_MEOJSON_VARNAME(in), _MEOJSON_VARNAME(error_key));                                \
+    }                                                                                                        \
+    bool check_json(const json::value& _MEOJSON_VARNAME(in), std::string& _MEOJSON_VARNAME(error_key)) const \
+    {                                                                                                        \
+        return json::_jsonization_helper::checker()._check_json(                                             \
+            _MEOJSON_VARNAME(in), _MEOJSON_VARNAME(error_key),                                               \
+            _MEOJSON_EXPAND(_MEOJSON_FOR_EACH(_MEOJSON_KEY_VALUE, __VA_ARGS__))                              \
+                json::_jsonization_helper::va_arg_end {});                                                   \
+    }
+
+#define MEO_FROMJSON(...)                                                                             \
+    bool from_json(const json::value& _MEOJSON_VARNAME(in))                                           \
+    {                                                                                                 \
+        std::string _MEOJSON_VARNAME(error_key);                                                      \
+        return from_json(_MEOJSON_VARNAME(in), _MEOJSON_VARNAME(error_key));                          \
+    }                                                                                                 \
+    bool from_json(const json::value& _MEOJSON_VARNAME(in), std::string& _MEOJSON_VARNAME(error_key)) \
+    {                                                                                                 \
+        return json::_jsonization_helper::loader()._from_json(                                        \
+            _MEOJSON_VARNAME(in), _MEOJSON_VARNAME(error_key),                                        \
+            _MEOJSON_EXPAND(_MEOJSON_FOR_EACH(_MEOJSON_KEY_VALUE, __VA_ARGS__))                       \
+                json::_jsonization_helper::va_arg_end {});                                            \
+    }
+
+#define MEO_JSONIZATION(...)                    \
+    _MEOJSON_EXPAND(MEO_TOJSON(__VA_ARGS__))    \
+    _MEOJSON_EXPAND(MEO_CHECKJSON(__VA_ARGS__)) \
+    _MEOJSON_EXPAND(MEO_FROMJSON(__VA_ARGS__))
+
+#define MEO_OPT json::_jsonization_helper::next_is_optional_t {},
+
+#if defined(__clang__)
+#pragma clang diagnostic pop // -Wgnu-zero-variadic-macro-arguments
+#endif

CHANGELOG.md

@@ -1,92 +1,15 @@
-## v4.26.0-beta.1
+## v5.4.1
 
-### 新增
+### 文档 | Docs
 
-- 适配"迷城"界面主题 (#6847) @SherkeyXD
-- 新增 WpfGui选项-自动战斗-战斗列表-批量导入 (#6917) @status102
-- WpfGui 刷理智开始行动输出新增 每次开始行动时输出理智药和碎石次数（不记录临期药品使用次数） (#6857) @status102
-- 显示 ui 版本号 (#6944) @ABA2396
-- 肉鸽适配新干员默认技能 (#6948) @Lancarus
-- 支持13章关卡导航 @ABA2396
-- 远程控制更多功能 (#6896) @hsyhhssyy
-- 点击版本号后复制到剪贴板 @ABA2396
-- 自动战斗地图链接指向PRTS.Map对应的地图 @ABA2396
+* website docs (#9287) @ABA2396 @Rbqwow @Constrat @wangl-cc @HX3N @SherkeyXD
+* 修改win7相关问题描述&更新运行库 @Rbqwow
+* fix a bad link @Rbqwow
+* make i18n warnings show only once @Rbqwow
+* 修复字体和评论区分类 @Rbqwow
 
-### 改进
+### For Overseas
 
-- Only check version.json for Resource OTA (#6901) @MistEO @ABA2396
-- 肉鸽投资不进入第二层则不买东西 (#6946) @zzyyyl
-- 使用MdXaml来提升Markdown渲染表现 (#6828) @SherkeyXD
-- 修改刷理智每次开始战斗时输出：不再显示理智药、碎石的设定上限值，增加临期理智药使用次数 (#6962) @status102
-- 重构 changelog_generator.py 部分内容 (#6957) @quyansiyuanwang
-- 优化部分基建日志输出 @zzyyyl
-- 更新延迟延长到60分钟 @ABA2396
-- 优化资源更新相关代码 @ABA2396
-- 更新内置243一天四换极限效率 (#6883) @Black1312
-- 使用多模板重写 StartButton2；优化 PRTS#next @zzyyyl
-- 重写理智识别 (#6885) @zzyyyl
-- 优化 OperBox 相关代码 @zzyyyl
-- 优化 AllTasksCompleted 相关 WPF 代码 (#6845) @zzyyyl
+#### YostarEN
 
-### 修复
-
-- 修改日文 OCR 等价集 @zzyyyl
-- 修复待选干员在列表末尾时点击错位的问题 (#6960) @zzyyyl
-- 降低iOS平台中部分模板匹配的阈值 (#6963) @lanhao34
-- 修复干员头像保存错误 (#6967) @MistEO
-- 台服肉鸽模式无法招募某些好友干员 (#6965) @lirao
-- YostarEN Mizuki I.S. get recruit selection @Constrat
-- 修复自动战斗-保全ver在开始行动时第二次点击可能过早导致无法正常开始的bug (#6934) @status102
-- 修复账号切换时可能卡在选择账号之后的错误 (#6933) @status102
-- 日服水月Rogue选择难度功能 (#6950) @Manicsteiner
-- 修正日服“选择难度”按钮图片 @Manicsteiner
-- 修改错误的绑定逻辑 && 格式化代码 @ABA2396
-- 修复干员 Lancet-2 的识别问题 @zzyyyl
-- 修复手滑导致的日服资源加载失败的问题 @zzyyyl
-- 修复战斗中费用识别错误的问题 @zzyyyl
-- 修复日服肉鸽部分不期而遇的识别 @zzyyyl
-- 修复日服傀影肉鸽部分不期而遇的识别 @zzyyyl
-- 修复日服傀影肉鸽卡在不期而遇 「血には血を」（以血还血）的问题 @zzyyyl
-- 修复肉鸽卡在招募券界面的问题 @zzyyyl
-- 台服无法识别缄默德克萨斯 @ABA2396
-- 进一步优化资源更新逻辑，修复一些问题 @MistEO
-- 在CharsNameOcrReplace添加一条规则，将“^一”替换为空 (#6908) @lanhao34
-- 注释掉一行代码，消除一个Warning (#6904) @hsyhhssyy
-- 当minitouch断开时自动重连 @MistEO
-- 修复理智不足时反复点击开始行动而不吃药的问题 @zzyyyl
-- 修复WpfGui肉鸽 等待&停止 重复调用AsstStop的错误 (#6878) @status102
-- EN InfrastDormDoubleConfirmButton  not recognized [no ci] @Constrat
-- 修复因 ocr_replace 与 m_eq_classes 冲突导致的 ocr 识别失效的问题 (#6867) @zzyyyl
-- 修复部分模板图片名错误的问题；删除多余模板图 @zzyyyl
-- 修复台服获取信用及购物出错的问题 @zzyyyl
-- zh-tw 变量名错误 (#6882) @broken-paint
-- 修复傀影肉鸽卡在战斗失败界面的问题 @zzyyyl
-- 修复肉鸽烧到水不停的问题 @zzyyyl
-- Allow `BattleQuickFormation` to retry 3 times @zzyyyl
-- 定时执行强制启动无法切换基建计划 @ABA2396
-- changed EN OCR formation parameter [skip ci] @Constrat
-
-### 其他
-
-- 用于快速适配新页面主题的小工具 (#6846) @SherkeyXD
-- 删除无用的 Roguelike@Continue 相关任务 @zzyyyl
-- update meojson to v3.1.1 (#6956) @MistEO
-- ClangFormatter 的 ignore 参数也忽略所有子文件夹内容 @zzyyyl
-- use submodule for maa-cli and build it from source @wangl-cc
-- removed UnexpectedType error @Constrat
-- 删除多余检查 @ABA2396
-- 修复美服肉鸽卡在放弃行动弹窗界面的问题 @zzyyyl @MistEO @Rbqwow
-- 减少点rider的报错 @ABA2396
-- 延长 StartUp 失败判定时长 @zzyyyl
-- wpfGui: Taggify Version (#6894) @Cryolitia
-- Fix README.md (#6928) @martinwang2002
-- tools: overseas duplicates + new themes @Constrat
-- format @zzyyyl
-- 修改 Stop 返回值，增加文档注释 @ABA2396
-- 更正变量名 (#6880) @broken-paint
-- debug: save_img 默认使用缓存的图片 @zzyyyl
-- debug: 增加一些非法情况的截图 @zzyyyl
-
-### For develops
-
-- support GPU OCR (#6872) @MistEO
+* YoStarEN resolution warning on client switch (#9539) @Constrat @ABA2396

CITATION.cff

@@ -0,0 +1,17 @@
+# This CITATION.cff file was generated with cffinit.
+# Visit https://bit.ly/cffinit to generate yours today!
+
+cff-version: 1.2.0
+title: MaaAssistantArknights
+message: >-
+  If you use this software, please cite it using the
+  metadata from this file.
+type: software
+authors:
+  - name: Maa Team
+    website: 'https://maa.plus/'
+    date-start: '2021-07-10'
+repository-code: >-
+  https://github.com/MaaAssistantArknights/MaaAssistantArknights/
+url: 'https://maa.plus/'
+license: AGPL-3.0-only

CMakeLists.txt

@@ -13,9 +13,13 @@ option(BUILD_UNIVERSAL "build both arm64 and x86_64 on macOS" OFF)
 option(INSTALL_PYTHON "install python ffi" OFF)
 option(INSTALL_RESOURCE "install resource" OFF)
 option(INSTALL_DEVEL "install development files" OFF)
+option(INSTALL_FLATTEN "do not use bin lib include directory" ON)
 option(INSTALL_THIRD_LIBS "install third party libraries" ON)
 option(USE_MAADEPS "use third-party libraries built by MaaDeps" ON)
+option(USE_RANGE_V3 "use range-v3" OFF)
+option(WITH_EMULATOR_EXTRAS "build with emulator extras" ${WIN32})
 option(WITH_THRIFT "build with thrift" OFF)
+option(WITH_ASST_DEBUG "build with ASST_DEBUG defined" OFF)
 
 include(${PROJECT_SOURCE_DIR}/cmake/utils.cmake)
 include(${PROJECT_SOURCE_DIR}/cmake/thrift-gen.cmake)
@@ -24,29 +28,28 @@ if(USE_MAADEPS)
     include(${PROJECT_SOURCE_DIR}/MaaDeps/maadeps.cmake)
 endif()
 
-if (MSVC)
-    add_compile_options("/utf-8")
-    add_compile_options("/MP")
-    add_compile_options("/W4;/WX")
-    add_compile_options("/wd4127")  # conditional expression is constant
-    add_compile_options("/Wv:19.35.32217")  # disable warning introduced after this version
-
-    set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>DLL")
-else ()
-    add_compile_options("-Wall;-Werror;-Wextra;-Wpedantic;-Wno-missing-field-initializers")
-    if (CMAKE_CXX_COMPILER_ID MATCHES "GNU" AND CMAKE_CXX_COMPILER_VERSION VERSION_LESS 13)
-        add_compile_options("-Wno-restrict")
-    endif()
-endif ()
-
-
 add_library(header_only_libraries INTERFACE)
-target_include_directories(header_only_libraries INTERFACE 3rdparty/include)
+target_include_directories(header_only_libraries INTERFACE 3rdparty/include 3rdparty/EmulatorExtras)
 
 file(GLOB_RECURSE maa_src src/MaaCore/*.cpp)
 
 add_library(MaaCore SHARED ${maa_src})
 
+if (MSVC)
+    target_compile_options(MaaCore PRIVATE "/utf-8")
+    target_compile_options(MaaCore PRIVATE "/MP")
+    target_compile_options(MaaCore PRIVATE "/W4;/WX")
+    target_compile_options(MaaCore PRIVATE "/wd4127")  # conditional expression is constant
+    target_compile_options(MaaCore PRIVATE "/Wv:19.35.32217")  # disable warning introduced after this version
+
+    set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>DLL")
+else ()
+    target_compile_options(MaaCore PRIVATE "-Wall;-Werror;-Wextra;-Wpedantic;-Wno-missing-field-initializers")
+    if (CMAKE_CXX_COMPILER_ID MATCHES "GNU" AND CMAKE_CXX_COMPILER_VERSION VERSION_LESS 13)
+        target_compile_options(MaaCore PRIVATE "-Wno-restrict")
+    endif()
+endif ()
+
 if (WIN32)
     #注意：相比VS版本缺少了 -D_CONSOLE -D_WINDLL 两项
     target_compile_definitions(MaaCore PRIVATE ASST_DLL_EXPORTS _UNICODE UNICODE)
@@ -77,26 +80,61 @@ endif (BUILD_TEST)
 
 find_package(OpenCV REQUIRED COMPONENTS core imgproc imgcodecs videoio)
 find_package(ZLIB REQUIRED)
-find_package(MaaDerpLearning REQUIRED)
-find_package(asio REQUIRED)
-find_package(ONNXRuntime)
 find_package(cpr CONFIG REQUIRED)
+
+list(APPEND maa_libs ${OpenCV_LIBS} ZLIB::ZLIB cpr::cpr header_only_libraries)
+
+if(USE_MAADEPS)
+    find_package(asio REQUIRED)
+    list(APPEND maa_libs asio::asio)
+endif()
+
+find_package(onnxruntime CONFIG REQUIRED) # provided by onnxruntime>=1.16
+list(APPEND maa_libs onnxruntime::onnxruntime)
+if(DEFINED fastdeploy_SOURCE_DIR)
+    # TODO: FetchContent github.com/MaaAssistantArknights/FastDeploy
+    if(NOT DEFINED fastdeploy_BINARY_DIR)
+        set(fastdeploy_BINARY_DIR ${CMAKE_BINARY_DIR}/fastdeploy)
+    endif()
+    set(CMAKE_POSITION_INDEPENDENT_CODE ON)
+    add_subdirectory(${fastdeploy_SOURCE_DIR} ${fastdeploy_BINARY_DIR} EXCLUDE_FROM_ALL SYSTEM)
+    if(NOT DEFINED fastdeploy_INCLUDE_DIRS)
+        set(fastdeploy_INCLUDE_DIRS ${fastdeploy_SOURCE_DIR})
+    endif()
+    target_include_directories(MaaCore SYSTEM PRIVATE ${fastdeploy_INCLUDE_DIRS})
+    get_target_property(fastdeploy_type fastdeploy_ppocr TYPE)
+    if(fastdeploy_type STREQUAL "SHARED_LIBRARY")
+        install(TARGETS fastdeploy_ppocr)
+    endif()
+else()
+    find_package(fastdeploy_ppocr REQUIRED)
+endif()
+list(APPEND maa_libs fastdeploy_ppocr)
+
+target_link_libraries(MaaCore ${maa_libs})
+
+if(WITH_EMULATOR_EXTRAS AND NOT EXISTS ${PROJECT_SOURCE_DIR}/3rdparty/EmulatorExtras/Mumu)
+    message(WARNING "EmulatorExtras not found, please run `git submodule update --init 3rdparty/EmulatorExtras`")
+    set(WITH_EMULATOR_EXTRAS OFF)
+endif()
+target_compile_definitions(MaaCore PRIVATE ASST_WITH_EMULATOR_EXTRAS=$<BOOL:${WITH_EMULATOR_EXTRAS}>)
+
 if(WITH_THRIFT)
     find_package(Thrift CONFIG REQUIRED)
-endif(WITH_THRIFT)
-
-target_link_libraries(MaaCore ${OpenCV_LIBS} MaaDerpLearning asio::asio ZLIB::ZLIB ONNXRuntime::ONNXRuntime cpr::cpr header_only_libraries)
-
-if(WITH_THRIFT)
     add_subdirectory(src/MaaThriftController)
     target_link_libraries(MaaCore MaaThriftController)
 endif(WITH_THRIFT)
 
+if (WITH_ASST_DEBUG)
+    target_compile_definitions(MaaCore PRIVATE ASST_DEBUG)
+endif ()
+
 if(WIN32)
     target_link_libraries(MaaCore ws2_32)
 endif()
 
-if (CMAKE_CXX_COMPILER_ID MATCHES ".*Clang")
+if (USE_RANGE_V3)
+    target_compile_definitions(MaaCore PRIVATE ASST_USE_RANGES_RANGE_V3)
     find_package(range-v3 REQUIRED)
     target_link_libraries(MaaCore range-v3::range-v3)
 endif ()
@@ -105,12 +143,11 @@ if(INSTALL_DEVEL)
     set(MaaCore_install_extra_args PUBLIC_HEADER DESTINATION devel/include ARCHIVE DESTINATION devel/lib)
 endif()
 
-install(TARGETS MaaCore
-    RUNTIME DESTINATION .
-    LIBRARY DESTINATION .
-    PUBLIC_HEADER DESTINATION .
-    ${MaaCore_install_extra_args}
-)
+if(INSTALL_FLATTEN)
+    set(MaaCore_install_flatten_args RUNTIME DESTINATION . LIBRARY DESTINATION . PUBLIC_HEADER DESTINATION .)
+endif()
+
+install(TARGETS MaaCore ${MaaCore_install_flatten_args} ${MaaCore_install_extra_args})
 
 if(INSTALL_THIRD_LIBS AND USE_MAADEPS)
     maadeps_install()

LICENSE.spdx

@@ -0,0 +1,6 @@
+SPDXVersion: SPDX-2.3
+DataLicense: CC0-1.0
+PackageName: MaaAssistantArknights
+PackageOriginator: Maa Team and all contributors
+PackageHomePage: https://github.com/MaaAssistantArknights/MaaAssistantArknights
+PackageLicenseDeclared: AGPL-3.0-only

MAA.sln

@@ -10,6 +10,7 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "MaaWpfGui", "src\MaaWpfGui\
 	EndProjectSection
 EndProject
 Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "MaaCore", "src\MaaCore\MaaCore.vcxproj", "{362D1E30-F5AE-4279-9985-65C27B3BA300}"
+EndProject
 Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "MaaThriftController", "src\MaaThriftController\MaaThriftController.vcxproj", "{8238EDB1-19BF-4E3B-AF5B-016120D59D7B}"
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{11F02235-5785-408B-9651-8A4B41FF36F4}"

MAA.sln.DotSettings

@@ -40,6 +40,8 @@
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=autofill/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Bilibili/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Bluestacks/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=bsconsole/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=ctrler/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=desp/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=dnplayer/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Ehem/@EntryIndexedValue">True</s:Boolean>
@@ -48,20 +50,29 @@
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=findstr/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=FLASHW/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=FLASHWINFO/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=foldartal/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Foldartals/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=framerate/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=furni/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Gacha/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Gavial/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Grandet/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Hotkey/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=hwnd/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Infrast/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Inited/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=ldconsole/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Lolicon/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=lpwndpl/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=ls_005B_0022sub/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=luestacks/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=maatouch/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=memuc/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Minitouch/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Mizuki/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Mumu/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Nemu/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Netease/@EntryIndexedValue">True</s:Boolean>
 	
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=netstat/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Nonfriend/@EntryIndexedValue">True</s:Boolean>
@@ -80,7 +91,6 @@
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=ppidl/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Prts/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=pwfi/@EntryIndexedValue">True</s:Boolean>
-	<s:Boolean x:Key="/Default/UserDictionary/Words/=qodana/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=rcast/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=rdfend/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=rguard/@EntryIndexedValue">True</s:Boolean>
@@ -93,6 +103,7 @@
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=serilog/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Showminimized/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Shownormal/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=specialaccess/@EntryIndexedValue">True</s:Boolean>
     <s:Boolean x:Key="/Default/UserDictionary/Words/=SSS/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=STGM/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=strlen/@EntryIndexedValue">True</s:Boolean>

README.md

@@ -1,3 +1,5 @@
+<!-- markdownlint-disable -->
+
 <div align="center">
 
 <img alt="LOGO" src="https://cdn.jsdelivr.net/gh/MaaAssistantArknights/design@main/logo/maa-logo_512x512.png" width="256" height="256" />
@@ -6,7 +8,7 @@
 
 <br>
 <div>
-    <img alt="C++" src="https://img.shields.io/badge/c++-20-%2300599C?logo=cplusplus">
+    <img alt="C++" src="https://img.shields.io/badge/C++-20-%2300599C?logo=cplusplus">
 </div>
 <div>
     <img alt="platform" src="https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-blueviolet">
@@ -14,11 +16,16 @@
 <div>
     <img alt="license" src="https://img.shields.io/github/license/MaaAssistantArknights/MaaAssistantArknights">
     <img alt="commit" src="https://img.shields.io/github/commit-activity/m/MaaAssistantArknights/MaaAssistantArknights?color=%23ff69b4">
+</div>
+<div>
     <img alt="stars" src="https://img.shields.io/github/stars/MaaAssistantArknights/MaaAssistantArknights?style=social">
+    <img alt="GitHub all releases" src="https://img.shields.io/github/downloads/MaaAssistantArknights/MaaAssistantArknights/total?style=social">
 </div>
 <br>
 
-[简体中文](https://maa.plus/docs/) | [繁體中文](https://maa.plus/docs/zh-tw/) | [English](https://maa.plus/docs/en-us/) | [日本語](https://maa.plus/docs/ja-jp/) | [한국어](https://maa.plus/docs/ko-kr/)
+<!-- markdownlint-restore -->
+
+[简体中文](https://maa.plus/docs/zh-cn/) | [繁體中文](https://maa.plus/docs/zh-tw/) | [English](https://maa.plus/docs/en-us/) | [日本語](https://maa.plus/docs/ja-jp/) | [한국어](https://maa.plus/docs/ko-kr/)
 
 MAA 的意思是 MAA Assistant Arknights
 
@@ -26,33 +33,52 @@ MAA 的意思是 MAA Assistant Arknights
 
 基于图像识别技术，一键完成全部日常任务！
 
-绝赞更新中  ✿✿ヽ(°▽°)ノ✿<br>
+绝赞更新中  ✿✿ヽ(°▽°)ノ✿
 
 </div>
 
 ## 亮点功能
 
-- 刷理智，掉落识别及上传 [企鹅物流](https://penguin-stats.cn/)；
-- 智能基建换班，自动计算干员效率，单设施内最优解；同时也支持 [自定义排班](https://maa.plus/docs/3.6-基建排班协议.html)；
-- 自动公招，可选使用加急许可，一次全部刷完！公招数据上传 [企鹅物流](https://penguin-stats.cn/result/stage/recruit/recruit)，[一图流](https://yituliu.site/maarecruitdata)；
-- 支持手动识别公招界面，方便对高星公招做出选择； ~~（你的这个高姿回费出的是推王呢还是推王呢）~~
-- 支持识别干员列表，统计已有和未有干员（还能为手动识别公招界面提供已有潜能数据提示）；
-- 支持识别养成材料，并可导出至 [企鹅物流刷图规划](https://penguin-stats.cn/planner) 和 [明日方舟工具箱](https://arkn.lolicon.app/#/material) 计算缺少的养成材料；
-- 访问好友、收取信用及购物、领取日常奖励等，一键全日常自动长草；
-- 肉鸽全自动刷源石锭和蜡烛，自动识别干员及练度；
-- 选择作业 JSON 文件，自动抄作业， [视频演示](https://www.bilibili.com/video/BV1H841177Fk/)；
-- 仓库识别并支持导出至 [企鹅物流刷图规划器](https://penguin-stats.cn/planner), [明日方舟工具箱](https://arkn.lolicon.app/#/material), [ARK-NIGHTS 干员培养表](https://ark-nights.com/settings)；
+- 刷理智，掉落识别及上传 [企鹅物流](https://penguin-stats.cn/)，[一图流](https://ark.yituliu.cn/)
+- 智能基建换班，自动计算干员效率，单设施内最优解；同时也支持 [自定义排班](https://maa.plus/docs/zh-cn/protocol/base-scheduling-schema.html)
+- 自动公招，可选使用加急许可，一次全部刷完！公招数据自动上传 [企鹅物流](https://penguin-stats.cn/result/stage/recruit/recruit)，[一图流](https://ark.yituliu.cn/survey/maarecruitdata)
+- 支持手动识别公招界面，方便对高星公招做出选择 ~~（你的这个高姿回费出的是推王呢还是推王呢）~~
+- 支持识别干员列表，统计已有和未有干员及潜能，并在公招识别显示
+- 支持识别养成材料，并导出至 [企鹅物流刷图规划](https://penguin-stats.cn/planner)、[明日方舟工具箱](https://arkntools.app/#/material)、[ARK-NIGHTS 干员培养表](https://ark-nights.com/settings)
+- 访问好友、收取信用及购物、领取日常奖励等，一键全日常自动长草
+- 肉鸽全自动刷源石锭和等级，自动烧水和凹直升，智能识别干员及练度
+- 选择作业 JSON 文件，自动抄作业， [视频演示](https://www.bilibili.com/video/BV1H841177Fk/)
 - 支持 C, Python, Java, Rust, Golang, Java HTTP, Rust HTTP 等多种接口，方便集成调用，自定义你的 MAA！
 
-话不多说，看图！<br>
+<!-- markdownlint-disable -->
 
-![zh1](https://user-images.githubusercontent.com/9762652/259595058-1529207a-ef3d-4eca-a016-4759eb534c6e.png)
-![zh2](https://user-images.githubusercontent.com/9762652/259594965-882b61e6-bf31-40c1-8c03-3f51f82a0d42.png)
-![zh3](https://user-images.githubusercontent.com/9762652/259594874-07abdd9f-33f0-4446-8da3-799849bf7328.png)
-![zh4](https://user-images.githubusercontent.com/9762652/259594649-c08b6558-7d17-45a8-9ba0-3ebc9a6f5589.png)
+<details><summary>话不多说，看图！</summary>
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="./docs/.vuepress/public/image/zh-cn/readme/1-dark.png">
+  <img alt="zh1" src="./docs/.vuepress/public/image/zh-cn/readme/1-light.png">
+</picture>
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="./docs/.vuepress/public/image/zh-cn/readme/2-dark.png">
+  <img alt="zh2" src="./docs/.vuepress/public/image/zh-cn/readme/2-light.png">
+</picture>
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="./docs/.vuepress/public/image/zh-cn/readme/3-dark.png">
+  <img alt="zh3" src="./docs/.vuepress/public/image/zh-cn/readme/3-light.png">
+</picture>
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="./docs/.vuepress/public/image/zh-cn/readme/4-dark.png">
+  <img alt="zh4" src="./docs/.vuepress/public/image/zh-cn/readme/4-light.png">
+</picture>
+
+</details>
+
+<!-- markdownlint-restore -->
 
 ## 下载地址
 
+前往[官网](https://maa.plus)自动匹配镜像源并下载稳定版，或：
+
 - [稳定版/公测版](https://github.com/MaaAssistantArknights/MaaAssistantArknights/releases)
 - [内测版](https://github.com/MaaAssistantArknights/MaaRelease/releases)
 
@@ -60,33 +86,28 @@ MAA 的意思是 MAA Assistant Arknights
 
 ### 基本说明
 
-1. 请根据 [模拟器支持情况](https://maa.plus/docs/1.3-模拟器支持.html)，进行对应的操作；
-2. 修改模拟器分辨率为 `16:9` 比例，最低 `1280 * 720`，更高不限；<br>
-   对于国际服（美服）玩家，由于界面布局、字号等问题，我们则建议您将分辨率修改为 `1920 * 1080`；
-3. 开始使用吧！
-
-更多使用说明请参考 [详细介绍](https://maa.plus/docs/1.1-详细介绍.html)
+请参阅 [新手上路](https://maa.plus/docs/zh-cn/manual/newbie.html) 与 [功能介绍](https://maa.plus/docs/zh-cn/manual/introduction/)。
 
 ### 常见问题
 
 - 软件一打开就闪退；
-- 连接错误、不知道 adb 路径怎么填写；
+- 连接错误、不知道 ADB 路径怎么填写；
 - 连接成功了，但没反应；
 - 如何连接自定义端口；
 - 下载速度慢，且镜像站无法打开网页；
 - 下载到一半提示“登陆”/“鉴权”；
 - 连接正常，任务开始了，但是没反应。
 
-请参考 [常见问题](https://maa.plus/docs/1.2-常见问题.html)
+请参阅 [常见问题](https://maa.plus/docs/zh-cn/manual/faq.html)
 
 ### 外服支持
 
-目前国际服（美服）、日服、韩服、繁中服的绝大部分功能均已支持。但由于外服用户较少及项目人手不足，很多功能并没有进行全面的测试，所以请自行体验。<br>
-若您遇到了 Bug，或对某个功能有强需求，欢迎在 [Issues](https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues) 和 [讨论区](https://github.com/MaaAssistantArknights/MaaAssistantArknights/discussions) 催更；或加入我们一起建设 MAA！请参考 [外服适配教程](#外服适配)
+目前国际服（美服）、日服、韩服、繁中服的绝大部分功能均已支持。但由于外服用户较少及项目人手不足，很多功能并没有进行全面的测试，所以请自行体验。  
+若您遇到了 Bug，或对某个功能有强需求，欢迎在 [Issues](https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues) 和 [讨论区](https://github.com/MaaAssistantArknights/MaaAssistantArknights/discussions) 催更；或加入我们一起建设 MAA！请参阅 [外服适配教程](https://maa.plus/docs/zh-cn/develop/overseas-client-adaptation.html)
 
-### CLI支持
+### CLI 支持
 
-MAA 支持命令行界面（CLI）操作，支持 Linux 和 macOS，可用于自动化脚本或在无图形界面的服务器上使用。请参考 [CLI 使用指南](https://maa.plus/docs/1.6-CLI使用指南.html)
+MAA 支持命令行界面（CLI）操作，支持 Linux，macOS 和 Windows，可用于自动化脚本或在无图形界面的服务器上使用。请参阅 [CLI 使用指南](https://maa.plus/docs/zh-cn/manual/cli/intro.html)
 
 ## 加入我们
 
@@ -94,66 +115,58 @@ MAA 支持命令行界面（CLI）操作，支持 Linux 和 macOS，可用于自
 
 **目前项目组非常缺前端大佬，若您有相关经验，欢迎加入我们！**
 
-- 全新框架：[MaaFramework](https://github.com/MaaAssistantArknights/MaaFramework)
+- 全新框架：[MaaFramework](https://github.com/MaaXYZ/MaaFramework)
 - 全新 GUI：[MaaX](https://github.com/MaaAssistantArknights/MaaX)
 - [作业站](https://prts.plus) 前端：[maa-copilot-frontend](https://github.com/MaaAssistantArknights/maa-copilot-frontend)
 - [作业站](https://prts.plus) 后端：[MaaBackendCenter](https://github.com/MaaAssistantArknights/MaaBackendCenter)
 - [官网](https://maa.plus)：[前端](https://github.com/MaaAssistantArknights/maa-website)
 - 深度学习：[MaaAI](https://github.com/MaaAssistantArknights/MaaAI)
 
-
 ### 多语言 (i18n)
 
 MAA 支持多国语言，并使用 Weblate 进行本地化管理。如果您通晓多门语言，欢迎前往 [MAA Weblate](https://weblate.maa-org.net) 帮助我们进行翻译。
 
 MAA 以中文（简体）为第一语言，翻译词条均以中文（简体）为准。
 
-[![Weblate](https://weblate.maa-org.net/widgets/maa-assistant-arknights/zh_Hans/maa-wpf-gui/multi-auto.svg)](https://weblate.maa-org.net/engage/maa-assistant-arknights/zh_Hans/)
+[![Weblate](https://weblate.maa-org.net/widget/maa/wpf-gui/multi-auto.svg)](https://weblate.maa-org.net/engage/maa/)
 
-### Windows
+### 参与开发
 
-1. 下载预构建的第三方库
+#### Windows
 
-    ```cmd
-    python maadeps-download.py
-    ```
+请参阅 [开始开发](https://maa.plus/docs/zh-cn/develop/development.html)。
 
-2. 使用 Visual Studio 2022 打开 `MAA.sln`，右键 `MaaWpfGui`，设为启动项目
-3. VS 上方配置选择 `RelWithDebInfo` `x64` （如果编译 Release 包 或 ARM 平台，请忽略这步）
-4. 右键 `MaaWpfGui` - 属性 - 调试 - 启用本地调试（这样就能把断点挂到 C++ Core 那边了）
-5. （可选）若准备提交 PR，建议启用 [clang-format 支持](https://maa.plus/docs/2.2-开发相关.html#在-visual-studio-中启用-clang-format)
+#### Linux | macOS
 
-### Linux | macOS
+请参阅 [Linux 编译教程](https://maa.plus/docs/zh-cn/develop/linux-tutorial.html)。
 
-请参考 [Linux 编译教程](https://maa.plus/docs/2.1-Linux编译教程.html)
-
-### API
+#### API
 
 - [C 接口](include/AsstCaller.h)：[集成示例](src/Cpp/main.cpp)
 - [Python 接口](src/Python/asst/asst.py)：[集成示例](src/Python/sample.py)
-- [Golang 接口](src/Golang/)：[集成示例](src/Golang/maa/maa.go)
-- [Dart 接口](src/Dart/)
+- [Golang 接口](src/Golang)：[集成示例](src/Golang/maa/maa.go)
+- [Dart 接口](src/Dart)
 - [Java 接口](src/Java/src/main/java/com/iguigui/maaj/easySample/MaaCore.java)：[集成示例](src/Java/src/main/java/com/iguigui/maaj/easySample/MaaJavaSample.java)
 - [Java HTTP 接口](src/Java/Readme.md)
-- [Rust 接口](src/Rust/src/maa_sys/)：[HTTP 接口](src/Rust)
-- [TypeScript 接口](https://github.com/MaaAssistantArknights/MaaAsstElectronUI/tree/main/packages/main/coreLoader)
-- [Woolang 接口](src/Woolang/maa.wo)：[集成示例](src/Woolang/main.wo)
-- [集成文档](https://maa.plus/docs/3.1-集成文档.html)
-- [回调消息协议](https://maa.plus/docs/3.2-回调消息协议.html)
-- [任务流程协议](https://maa.plus/docs/3.4-任务流程协议.html)
-- [自动抄作业协议](https://maa.plus/docs/3.3-战斗流程协议.html)
+- [Rust 接口](src/Rust/src/maa_sys)：[HTTP 接口](src/Rust)
+- [TypeScript 接口](https://github.com/MaaAssistantArknights/MaaX/tree/main/packages/main/coreLoader)
+- [Woolang 接口](src/Woolang/maa.wo)：[集成示例](src/Woolang/demo.wo)
+- [集成文档](https://maa.plus/docs/zh-cn/protocol/integration.html)
+- [回调消息协议](https://maa.plus/docs/zh-cn/protocol/callback-schema.html)
+- [任务流程协议](https://maa.plus/docs/zh-cn/protocol/task-schema.html)
+- [自动抄作业协议](https://maa.plus/docs/zh-cn/protocol/copilot-schema.html)
 
-### 外服适配
+#### 外服适配
 
-请参考 [外服适配教程](https://maa.plus/docs/2.5-外服适配教程.html)，对于国服已支持的功能，绝大部分的外服适配工作仅需要截图 + 简单的 JSON 修改即可。
+请参阅 [外服适配教程](https://maa.plus/docs/zh-cn/develop/overseas-client-adaptation.html)，对于国服已支持的功能，绝大部分的外服适配工作仅需要截图 + 简单的 JSON 修改即可。
 
-### 想参与开发，但不太会用 GitHub?
+#### 想参与开发，但不太会用 GitHub?
 
-[GitHub Pull Request 流程简述](https://maa.plus/docs/2.2-开发相关.html#github-pull-request-流程简述)
+[GitHub Pull Request 流程简述](https://maa.plus/docs/zh-cn/develop/development.html#github-pull-request-流程简述)
 
-### Issue bot
+#### Issue bot
 
-请参考 [Issue bot 使用方法](https://maa.plus/docs/2.3-IssueBot使用方法.html)
+请参阅 [Issue Bot 使用方法](https://maa.plus/docs/zh-cn/develop/issue-bot-usage.html)
 
 ## 致谢
 
@@ -166,23 +179,23 @@ MAA 以中文（简体）为第一语言，翻译词条均以中文（简体）
 - 机器学习加速器：[onnxruntime](https://github.com/microsoft/onnxruntime)
 - ~~关卡掉落识别：[企鹅物流识别](https://github.com/penguin-statistics/recognizer)~~
 - 地图格子识别：[Arknights-Tile-Pos](https://github.com/yuanyan3060/Arknights-Tile-Pos)
-- C++ JSON库：[meojson](https://github.com/MistEO/meojson.git)
+- C++ JSON 库：[meojson](https://github.com/MistEO/meojson.git)
 - C++ 运算符解析器：[calculator](https://github.com/kimwalisch/calculator)
-- ~~C++ base64编解码：[cpp-base64](https://github.com/ReneNyffenegger/cpp-base64)~~
+- ~~C++ base64 编解码：[cpp-base64](https://github.com/ReneNyffenegger/cpp-base64)~~
 - C++ 解压压缩库：[zlib](https://github.com/madler/zlib)
-- C++ Gzip封装：[gzip-hpp](https://github.com/mapbox/gzip-hpp)
-- 安卓触控事件器：[minitouch](https://github.com/openstf/minitouch)
+- C++ Gzip 封装：[gzip-hpp](https://github.com/mapbox/gzip-hpp)
+- 安卓触控事件器：[Minitouch](https://github.com/DeviceFarmer/minitouch)
 - 安卓触控事件器：[MaaTouch](https://github.com/MaaAssistantArknights/MaaTouch)
-- WPF MVVM框架：[Stylet](https://github.com/canton7/Stylet)
-- WPF控件库：[HandyControl](https://github.com/HandyOrg/HandyControl) -> [HandyControls](https://github.com/ghost1372/HandyControls)
+- WPF MVVM 框架：[Stylet](https://github.com/canton7/Stylet)
+- WPF 控件库：[HandyControl](https://github.com/HandyOrg/HandyControl) -> [HandyControls](https://github.com/ghost1372/HandyControls)
 - C# 日志：[Serilog](https://github.com/serilog/serilog)
-- C# JSON库：[Newtonsoft.Json](https://github.com/JamesNK/Newtonsoft.Json) & [System.Text.Json](https://github.com/dotnet/runtime)
+- C# JSON 库：[Newtonsoft.Json](https://github.com/JamesNK/Newtonsoft.Json) & [System.Text.Json](https://github.com/dotnet/runtime)
 - ~~下载器：[aria2](https://github.com/aria2/aria2)~~
 
 ### 数据源
 
 - ~~公开招募数据：[明日方舟工具箱](https://www.bigfun.cn/tools/aktools/hr)~~
-- ~~干员及基建数据：[PRTS明日方舟中文WIKI](http://prts.wiki/)~~
+- ~~干员及基建数据：[PRTS Wiki](http://prts.wiki/)~~
 - 关卡数据：[企鹅物流数据统计](https://penguin-stats.cn/)
 - 游戏数据及资源：[明日方舟客户端素材](https://github.com/yuanyan3060/ArknightsGameResource)
 - ~~游戏数据：[《明日方舟》游戏数据](https://github.com/Kengxxiao/ArknightsGameData)~~
@@ -191,22 +204,22 @@ MAA 以中文（简体）为第一语言，翻译词条均以中文（简体）
 
 感谢所有参与到开发/测试中的朋友们，是大家的帮助让 MAA 越来越好！ (\*´▽｀)ノノ
 
-[![Contributors](https://contributors-img.web.app/image?repo=MaaAssistantArknights/MaaAssistantArknights)](https://github.com/MaaAssistantArknights/MaaAssistantArknights/graphs/contributors)
-
+[![Contributors](https://contributors-img.web.app/image?repo=MaaAssistantArknights/MaaAssistantArknights&max=114514&columns=15)](https://github.com/MaaAssistantArknights/MaaAssistantArknights/graphs/contributors)
 
 ## 声明
 
-- 本软件 logo 并非使用 AGPL 3.0 协议开源，[耗毛](https://weibo.com/u/3251357314)、vie 两位画师及软件全体开发者保留所有权利。不得以 AGPL 3.0 协议已授权为由在未经授权的情况下使用本软件 logo，不得在未经授权的情况下将本软件 logo 用于任何商业用途。
-- 本软件开源、免费，仅供学习交流使用。若您遇到商家使用本软件进行代练并收费，可能是设备与时间等费用，产生的问题及后果与本软件无关。
+- 本软件使用 [GNU Affero General Public License v3.0 only](https://spdx.org/licenses/AGPL-3.0-only.html) 开源。
+- 本软件 logo 并非使用 AGPL 3.0 协议开源，[耗毛](https://weibo.com/u/3251357314)、vie 两位画师及软件全体开发者保留所有权利。不得以 AGPL 3.0 协议已授权为由在未经授权的情况下使用本软件 logo，不得在未经授权的情况下将本软件 logo 用于任何用途。
+- 本软件开源、免费，仅供学习交流使用。若您遇到商家使用本软件进行代练并收费，可能由于设备或时间等原因，产生的任何问题及后果与本软件无关。
 
 ## 广告
 
-用户交流 QQ 群：[MAA 使用 & 粥游交流 QQ 群](https://ota.maa.plus/MaaAssistantArknights/api/qqgroup/index.html)<br>
-用户交流 TG 群：[Telegram 群](https://t.me/+Mgc2Zngr-hs3ZjU1)<br>
-自动战斗 JSON 作业分享：[prts.plus](https://prts.plus) 或 [抄作业.com](http://抄作业.com)<br>
-Bilibili 直播间：[直播间](https://live.bilibili.com/2808861) 每晚直播敲代码，近期很长一段时间应该都是在写本软件~<br>
+用户交流 QQ 群：[MAA 使用 & 粥游交流 QQ 群](https://ota.maa.plus/MaaAssistantArknights/api/qqgroup/index.html)  
+用户交流 TG 群：[Telegram 群](https://t.me/+Mgc2Zngr-hs3ZjU1)  
+自动战斗 JSON 作业分享：[prts.plus](https://prts.plus) 或 [抄作业.com](http://抄作业.com)  
+Bilibili 直播间：[直播间](https://live.bilibili.com/2808861) 每晚直播敲代码，近期很长一段时间应该都是在写本软件~  
 
-技术 & 吹水群（舟无关）：[内卷地狱！(QQ 群)](https://jq.qq.com/?_wv=1027&k=ypbzXcA2)<br>
-开发者群：[QQ 群](https://jq.qq.com/?_wv=1027&k=JM9oCk3C)<br>
+技术群（舟无关、禁水）：[内卷地狱！(QQ 群)](https://jq.qq.com/?_wv=1027&k=ypbzXcA2)  
+开发者群：[QQ 群](https://jq.qq.com/?_wv=1027&k=JM9oCk3C)  
 
 如果觉得软件对你有帮助，帮忙点个 Star 吧！~（网页最上方右上角的小星星），这就是对我们最大的支持了！

SECURITY.md

@@ -0,0 +1,21 @@
+# 安全策略 / Security Policy
+
+## 受支持的版本 / Supported Versions
+
+我们仅对 v4 和 v5 两个大版本的最新稳定版提供安全支持，如有安全问题，我们将会尽可能快地发布新的稳定版解决。
+
+内测版、公测版仅供测试，我们不会对其提供安全支持。
+
+We only provide security support for the latest Stable Release versions of v4 and v5. If there are security issues, we will release a new stable version as soon as possible to solve them.
+
+The Nightly Release version and the Beta Release version are for testing only, and we will not provide security support for them.
+
+## 如何报告漏洞 / Reporting a Vulnerability
+
+如果该漏洞可以公开发表，请通过 [issue](https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues/new?assignees=&labels=bug&projects=&template=cn-bug-report.yaml) 发布。
+
+如果该漏洞**不可以**公开发表（例如远程控制功能等可能被用于入侵用户的），请通过[秘密途径](https://github.com/MaaAssistantArknights/MaaAssistantArknights/security/advisories/new)报告。
+
+If the vulnerability can be published publicly, please [publish it through an issue](https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues/new?assignees=&labels=bug&projects=&template=cn-bug-report.yaml).
+
+If the vulnerability **cannot be published publicly** (for example, the vulnerability that can be used to invade the user's devices), please [report it privately](https://github.com/MaaAssistantArknights/MaaAssistantArknights/security/advisories/new).

cmake/FindFastDeploy.cmake

@@ -1,22 +0,0 @@
-# TODO: replace with cmake-generated interface file
-
-find_path(FastDeploy_INCLUDE_DIR NAMES fastdeploy/fastdeploy_model.h)
-
-find_library(FastDeploy_LIBRARY NAMES fastdeploy)
-
-include(FindPackageHandleStandardArgs)
-find_package_handle_standard_args(
-    FastDeploy
-    REQUIRED_VARS FastDeploy_LIBRARY FastDeploy_INCLUDE_DIR
-)
-
-if(FastDeploy_FOUND)
-    set(FastDeploy_INCLUDE_DIRS ${FastDeploy_INCLUDE_DIR})
-    if(NOT TARGET FastDeploy::FastDeploy)
-        add_library(FastDeploy::FastDeploy UNKNOWN IMPORTED)
-        set_target_properties(FastDeploy::FastDeploy PROPERTIES
-            IMPORTED_LOCATION "${FastDeploy_LIBRARY}"
-            INTERFACE_INCLUDE_DIRECTORIES "${FastDeploy_INCLUDE_DIR}"
-        )
-    endif()
-endif()

cmake/FindONNXRuntime.cmake

@@ -1,20 +0,0 @@
-find_path(ONNXRuntime_INCLUDE_DIR NAMES onnxruntime/core/session/onnxruntime_c_api.h)
-
-find_library(ONNXRuntime_LIBRARY NAMES onnxruntime)
-
-include(FindPackageHandleStandardArgs)
-find_package_handle_standard_args(
-    ONNXRuntime
-    REQUIRED_VARS ONNXRuntime_LIBRARY ONNXRuntime_INCLUDE_DIR
-)
-
-if(ONNXRuntime_FOUND)
-    set(ONNXRuntime_INCLUDE_DIRS ${ONNXRuntime_INCLUDE_DIR})
-    if(NOT TARGET ONNXRuntime::ONNXRuntime)
-        add_library(ONNXRuntime::ONNXRuntime UNKNOWN IMPORTED)
-        set_target_properties(ONNXRuntime::ONNXRuntime PROPERTIES
-            IMPORTED_LOCATION "${ONNXRuntime_LIBRARY}"
-            INTERFACE_INCLUDE_DIRECTORIES "${ONNXRuntime_INCLUDE_DIR}"
-        )
-    endif()
-endif()

cmake/fastdeploy.cmake

@@ -1,50 +0,0 @@
-
-
-set(FASTDEPLOY_URL_PREFIX "https://github.com/MaaAssistantArknights/build-fastdeploy/releases/download")
-
-set(FASTDEPLOY_TAG "gac255b8a")
-
-set(COMPRESSED_SUFFIX ".tar.gz")
-
-if(WIN32)
-    set(FASTDEPLOY_FILENAME "FastDeploy-Windows")
-    set(FASTDEPLOY_CHECKSUM "0a0700d4e8923bcd4c387a658e5e9a689ed9e0d114c260b11d082a2176c233d4")
-elseif(APPLE)
-    if (CURRENT_OSX_ARCH STREQUAL "arm64")
-        set(FASTDEPLOY_FILENAME "FastDeploy-macOS-arm64")
-        set(FASTDEPLOY_CHECKSUM "28a771814d197ba8056f1fcb7cc0671facec90a8733a0dac2cf0b68a8cc36d24")
-    else()
-        set(FASTDEPLOY_FILENAME "FastDeploy-macOS-x86_64")
-        set(FASTDEPLOY_CHECKSUM "76e97c7e944a18eb160646fa32ac0a7e24c87751b2b127dc33454f993f6d4b97")
-    endif()
-else()
-    set(FASTDEPLOY_FILENAME "FastDeploy-Linux")
-    set(FASTDEPLOY_CHECKSUM "4d106e5499e9b5b29426667617215ac7e4e70d2353af10caccdfdf6c1f1534a7")
-endif(WIN32)
-
-set(FASTDEPLOY_URL ${FASTDEPLOY_URL_PREFIX}/${FASTDEPLOY_TAG}/${FASTDEPLOY_FILENAME}${COMPRESSED_SUFFIX})
-
-if (FASTDEPLOY_DIRECTORY)
-    set(FastDeploy_DIR ${FASTDEPLOY_DIRECTORY})
-    find_package(FastDeploy REQUIRED PATHS ${FastDeploy_DIR})
-    include_directories(${FastDeploy_INCLUDE_DIRS})
-    list(APPEND DEPEND_LIBS ${FastDeploy_LIBS})
-else ()
-    download_and_decompress(${FASTDEPLOY_URL}
-                        ${CMAKE_CURRENT_BINARY_DIR}/${FASTDEPLOY_FILENAME}${COMPRESSED_SUFFIX}
-                        ${FASTDEPLOY_CHECKSUM}
-                        ${THIRD_PARTY_PATH}/install/)
-    set(FASTDEPLOY_FILENAME fastdeploy)
-    set(FastDeploy_DIR ${THIRD_PARTY_PATH}/install/${FASTDEPLOY_FILENAME})
-
-    find_package(FastDeploy REQUIRED PATHS ${FastDeploy_DIR} NO_DEFAULT_PATH)
-    include_directories(${FastDeploy_INCLUDE_DIRS})
-    list(APPEND DEPEND_LIBS ${FastDeploy_LIBS})
-endif (FASTDEPLOY_DIRECTORY)
-
-if (INSTALL_THIRD_LIBS)
-    install(DIRECTORY ${FastDeploy_DIR}/lib/ DESTINATION . USE_SOURCE_PERMISSIONS)
-    install(DIRECTORY ${ORT_LIB_PATH}/ DESTINATION . USE_SOURCE_PERMISSIONS)
-    install(DIRECTORY ${FastDeploy_DIR}/third_libs/install/paddle2onnx/lib/
-            DESTINATION . USE_SOURCE_PERMISSIONS)
-endif (INSTALL_THIRD_LIBS)

cmake/macos.cmake

@@ -15,13 +15,13 @@ if (BUILD_XCFRAMEWORK)
         COMMAND xcodebuild -create-xcframework -library "${PROJECT_SOURCE_DIR}/MaaDeps/runtime/${MAADEPS_TRIPLET}/libonnxruntime.1.14.1.dylib" -output ONNXRuntime.xcframework
     )
 
-    add_custom_command(OUTPUT MaaDerpLearning.xcframework
-        COMMAND rm -rf MaaDerpLearning.xcframework
-        COMMAND xcodebuild -create-xcframework -library "${PROJECT_SOURCE_DIR}/MaaDeps/runtime/${MAADEPS_TRIPLET}/libMaaDerpLearning.dylib" -output MaaDerpLearning.xcframework
+    add_custom_command(OUTPUT fastdeploy_ppocr.xcframework
+        COMMAND rm -rf fastdeploy_ppocr.xcframework
+        COMMAND xcodebuild -create-xcframework -library "${PROJECT_SOURCE_DIR}/MaaDeps/runtime/${MAADEPS_TRIPLET}/libfastdeploy_ppocr.dylib" -output fastdeploy_ppocr.xcframework
     )
 
     add_custom_target(MaaXCFramework ALL
-        DEPENDS MaaCore MaaCore.xcframework OpenCV.xcframework ONNXRuntime.xcframework MaaDerpLearning.xcframework
+        DEPENDS MaaCore MaaCore.xcframework OpenCV.xcframework ONNXRuntime.xcframework fastdeploy_ppocr.xcframework
     )
 endif (BUILD_XCFRAMEWORK)
 

docs/.vuepress/client.ts

@@ -0,0 +1,8 @@
+import { defineClientConfig } from "vuepress/client";
+import ImageGrid from "../components/ImageGrid.vue";
+
+export default defineClientConfig({
+  enhance: ({ app }) => {
+    app.component("ImageGrid", ImageGrid);
+  },
+});

docs/.vuepress/config.ts

@@ -1,35 +1,36 @@
-import { defineUserConfig } from 'vuepress';
-import Theme from './theme';
-import SearchPlugin from './plugins/search';
+import { defineUserConfig } from "vuepress";
+import { viteBundler } from "@vuepress/bundler-vite";
+import { googleAnalyticsPlugin } from "@vuepress/plugin-google-analytics";
+import Theme from "./theme";
 
 export default defineUserConfig({
-  base: '/docs/',
+  base: "/docs/",
   lang: "zh-CN",
   title: "MaaAssistantArknights",
   description: "MAA",
   port: 3001,
 
   locales: {
-    '/': {
-      lang: 'zh-CN',
-      description: '开发者文档',
+    "/zh-cn/": {
+      lang: "zh-CN",
+      description: "文档",
     },
-    '/zh-tw/': {
-      lang: 'zh-TW',
-      description: '開發者文件',
+    "/zh-tw/": {
+      lang: "zh-TW",
+      description: "文件",
     },
-    '/en-us/': {
-      lang: 'en-US',
-      title: 'Documents'
+    "/en-us/": {
+      lang: "en-US",
+      description: "Documentation",
     },
-    '/ja-jp/': {
-      lang: 'ja-JP',
-      description: 'ドキュメント'
+    "/ja-jp/": {
+      lang: "ja-JP",
+      description: "ドキュメンテーション",
+    },
+    "/ko-kr/": {
+      lang: "ko-KR",
+      description: "선적 서류 비치",
     },
-    '/ko-kr/': {
-      lang: 'ko-KR',
-      description: '문서'
-    }
   },
 
   markdown: {
@@ -41,6 +42,42 @@ export default defineUserConfig({
   theme: Theme,
 
   plugins: [
-    SearchPlugin(),
+    googleAnalyticsPlugin({
+      id: "G-FJQDKG394Z",
+    }),
   ],
+
+  head: [
+    ["link", { rel: "preconnect", href: "https://fonts.googleapis.com" }],
+    [
+      "link",
+      { rel: "preconnect", href: "https://fonts.gstatic.com", crossorigin: "" },
+    ],
+    [
+      "link",
+      {
+        href: "https://fonts.googleapis.com/css2?family=Noto+Sans+SC:wght@100..900&display=swap",
+        rel: "stylesheet",
+      },
+    ],
+    [
+      "link",
+      {
+        href: "https://fonts.googleapis.com/css2?family=Noto+Serif+SC:wght@200..900&display=swap",
+        rel: "stylesheet",
+      },
+    ],
+    [
+      "link",
+      {
+        href: "https://fonts.googleapis.com/css2?family=JetBrains+Mono:ital,wght@0,100..800;1,100..800&display=swap",
+        rel: "stylesheet",
+      },
+    ],
+  ],
+
+  bundler: viteBundler({
+    viteOptions: {},
+    vuePluginOptions: {},
+  }),
 });

docs/.vuepress/navbar/en-us.ts

@@ -9,17 +9,17 @@ export const enusNavbar = navbar([
   {
     text: "User Manual",
     icon: "mdi:user",
-    link: "/en-us/1.1-USER_MANUAL",
+    link: "/en-us/manual/",
   },
   {
     text: "Development Docs",
     icon: "ph:code-bold",
-    link: "/en-us/2.1-LINUX_TUTORIAL",
+    link: "/en-us/develop/",
   },
   {
     text: "Protocol Docs",
     icon: "basil:document-solid",
-    link: "/en-us/3.1-INTEGRATION",
+    link: "/en-us/protocol/",
   },
   {
     text: "MAA Website",

docs/.vuepress/navbar/ja-jp.ts

@@ -2,24 +2,24 @@ import { navbar } from "vuepress-theme-hope";
 
 export const jajpNavbar = navbar([
   {
-    text: "主页",
+    text: "ホームページ",
     icon: "ic:round-home",
     link: "/ja-jp/",
   },
   {
     text: "使用説明",
     icon: "mdi:user",
-    link: "/ja-jp/1.1-詳細説明",
+    link: "/ja-jp/manual/",
   },
   {
     text: "開発関連",
     icon: "ph:code-bold",
-    link: "/ja-jp/2.1-Linuxチュートリアル",
+    link: "/ja-jp/develop/",
   },
   {
     text: "プロトコルドキュメント",
     icon: "basil:document-solid",
-    link: "/ja-jp/3.1-統合ドキュメント",
+    link: "/ja-jp/protocol/",
   },
   {
     text: "MAA 公式サイト",

docs/.vuepress/navbar/ko-kr.ts

@@ -2,24 +2,24 @@ import { navbar } from "vuepress-theme-hope";
 
 export const kokrNavbar = navbar([
   {
-    text: "主页",
+    text: "홈페이지",
     icon: "ic:round-home",
     link: "/ko-kr/",
   },
   {
     text: "사용자 설명서",
     icon: "mdi:user",
-    link: "/ko-kr/1.1-사용자_설명서",
+    link: "/ko-kr/manual/",
   },
   {
-    text: "개발 관련",
+    text: "개발 문서",
     icon: "ph:code-bold",
-    link: "/ko-kr/2.1-LINUX_튜토리얼",
+    link: "/ko-kr/develop/",
   },
   {
     text: "프로토콜 문서",
     icon: "basil:document-solid",
-    link: "/ko-kr/3.1-연동",
+    link: "/ko-kr/protocol/",
   },
   {
     text: "MAA 공식 홈페이지",

docs/.vuepress/navbar/zh-cn.ts

@@ -4,22 +4,22 @@ export const zhcnNavbar = navbar([
   {
     text: "主页",
     icon: "ic:round-home",
-    link: "/",
+    link: "/zh-cn/",
   },
   {
     text: "用户手册",
     icon: "mdi:user",
-    link: "/1.1-详细介绍",
+    link: "/zh-cn/manual/",
   },
   {
     text: "开发文档",
     icon: "ph:code-bold",
-    link: "/2.1-Linux编译教程",
+    link: "/zh-cn/develop/",
   },
   {
     text: "协议文档",
     icon: "basil:document-solid",
-    link: "/3.1-集成文档",
+    link: "/zh-cn/protocol/",
   },
   {
     text: "MAA 官网",

docs/.vuepress/navbar/zh-tw.ts

@@ -9,17 +9,17 @@ export const zhtwNavbar = navbar([
   {
     text: "用戶說明書",
     icon: "mdi:user",
-    link: "/zh-tw/1.1-詳細介紹",
+    link: "/zh-tw/manual/",
   },
   {
     text: "開發文件",
     icon: "ph:code-bold",
-    link: "/zh-tw/2.1-Linux編譯教學",
+    link: "/zh-tw/develop/",
   },
   {
     text: "協議文件",
     icon: "basil:document-solid",
-    link: "/zh-tw/3.1-集成文件",
+    link: "/zh-tw/protocol/",
   },
   {
     text: "MAA 官網",

docs/.vuepress/plugins/search.ts

@@ -1,7 +1,4 @@
-import { docsearchPlugin } from "@vuepress/plugin-docsearch";
-
-export default function SearchPlugin() {
-  return docsearchPlugin({
+export default {
     appId: '99JM20SIFG',
     apiKey: '32ad931040facd36d2e99c3cb8e425e1',
     indexName: 'maa',
@@ -44,43 +41,6 @@ export default function SearchPlugin() {
           }
         }
       },
-      '/zh-tw/': {
-        placeholder: '搜尋',
-        translations: {
-          button: {
-            buttonText: '搜尋',
-          },
-          modal: {
-            searchBox: {
-              resetButtonTitle: '清除查詢條件',
-              cancelButtonText: '取消',
-            },
-            startScreen: {
-              recentSearchesTitle: '搜尋歷史',
-              noRecentSearchesText: '沒有搜尋歷史',
-              saveRecentSearchButtonTitle: '保存至搜尋歷史',
-              removeRecentSearchButtonTitle: '從搜尋歷史中移除',
-              favoriteSearchesTitle: '收藏',
-              removeFavoriteSearchButtonTitle: '從收藏中移除',
-            },
-            errorScreen: {
-              titleText: '無法獲取結果',
-              helpText: '你可能需要檢查你的網路連接',
-            },
-            footer: {
-              selectText: '選擇',
-              navigateText: '切換',
-              closeText: '關閉',
-              searchByText: '搜尋提供者',
-            },
-            noResultsScreen: {
-              noResultsText: '無法找到相關結果',
-              suggestedQueryText: '你可以嘗試查詢',
-              reportMissingResultsText: '你認為該查詢應該有結果？',
-              reportMissingResultsLinkText: '點擊反饋',
-            },
-          }
-        }
       },
       '/en-us/': {
         placeholder: 'Search',
@@ -120,9 +80,4 @@ export default function SearchPlugin() {
           }
         }
       },
-      '/ja-jp/': {
-        placeholder: '検索する',
-      }
-    }
-  })
 }

docs/.vuepress/sidebar/en-us.ts

@@ -10,115 +10,23 @@ export const enusSidebar = sidebar({
     {
       text: "User Manual",
       icon: "mdi:user",
+      prefix: "manual/",
       collapsible: true,
-      children: [
-        {
-          text: "Introduction",
-          icon: "mdi:information-outline",
-          link: "/en-us/1.1-USER_MANUAL",
-        },
-        {
-          text: "FAQs",
-          icon: "ph:question-fill",
-          link: "/en-us/1.2-FAQ",
-        },
-        {
-          text: "Emulator Supports",
-          icon: "mingcute:laptop-fill",
-          collapsible: true,
-          children: [
-            {
-              text: "Windows",
-              icon: "ri:windows-fill",
-              link: "/en-us/1.3-EMULATOR_SUPPORTS",
-            },
-            {
-              text: "Mac",
-              icon: "basil:apple-solid",
-              link: "/en-us/1.4-EMULATOR_SUPPORTS_FOR_MAC",
-            },
-            {
-              text: "Linux",
-              icon: "teenyicons:linux-alt-solid",
-              link: "/en-us/1.5-EMULATOR_SUPPORTS_FOR_LINUX",
-            },
-          ],
-        },
-      ],
+      children: "structure",
     },
     {
       text: "Development Docs",
       icon: "ph:code-bold",
+      prefix: "develop/",
       collapsible: true,
-      children: [
-        {
-          text: "Linux Compilation Tutorial",
-          icon: "teenyicons:linux-alt-solid",
-          link: "/en-us/2.1-LINUX_TUTORIAL",
-        },
-        {
-          text: "Development",
-          icon: "iconoir:developer",
-          link: "/en-us/2.2-DEVELOPMENT",
-        },
-        {
-          text: "IssueBot Usage",
-          icon: "bxs:bot",
-          link: "/en-us/2.3-ISSUE_BOT_USAGE",
-        },
-        {
-          text: "Web PR Tutorial",
-          icon: "mingcute:git-pull-request-fill",
-          link: "/en-us/2.4-PURE_WEB_PR_TUTORIAL",
-        },
-        {
-          text: "Overseas Clients Adaptation",
-          icon: "ri:earth-fill",
-          link: "/en-us/2.5-OVERSEAS_CLIENTS_ADAPTATION",
-        },
-      ],
+      children: "structure",
     },
     {
       text: "Protocol Docs",
       icon: "basil:document-solid",
+      prefix: "protocol/",
       collapsible: true,
-      children: [
-        {
-          text: "Integration",
-          icon: "bxs:book",
-          link: "/en-us/3.1-INTEGRATION",
-        },
-        {
-          text: "Callback Schema",
-          icon: "material-symbols:u-turn-left",
-          link: "/en-us/3.2-CALLBACK_SCHEMA",
-        },
-        {
-          text: "Copilot Schema",
-          icon: "ph:sword-bold",
-          link: "/en-us/3.3-COPILOT_SCHEMA",
-        },
-        {
-          text: "Task Schema",
-          icon: "material-symbols:task",
-          link: "/en-us/3.4-TASK_SCHEMA",
-        },
-        {
-          text: "Integrated Strategy Schema",
-          icon: "ri:game-fill",
-          link: "/en-us/3.5-INTEGRATED_STRATEGY_SCHEMA",
-        },
-        {
-          text: "Infrastructure Scheduling Schema",
-          icon: "material-symbols:view-quilt-rounded",
-          link: "/en-us/3.6-INFRASTRUCTURE_SCHEDULING_SCHEMA",
-        },
-        {
-          text: "Security Presence Schema",
-          icon: "game-icons:prisoner",
-          link: "/en-us/3.7-SECURITY_PRESENCE_SCHEMA",
-        },
-      ],
+      children: "structure",
     },
   ],
 });

docs/.vuepress/sidebar/ja-jp.ts

@@ -10,98 +10,23 @@ export const jajpSidebar = sidebar({
     {
       text: "使用説明",
       icon: "mdi:user",
+      prefix: "manual/",
       collapsible: true,
-      children: [
-        {
-          text: "詳細説明",
-          icon: "mdi:information-outline",
-          link: "/ja-jp/1.1-詳細説明",
-        },
-        {
-          text: "よくある質問",
-          icon: "ph:question-fill",
-          link: "/ja-jp/1.2-よくある質問",
-        },
-        {
-          text: "エミュレータのサポート",
-          icon: "mingcute:laptop-fill",
-          link: "/ja-jp/1.3-エミュレータのサポート",
-        },
-      ],
+      children: "structure",
     },
     {
       text: "開発関連",
       icon: "ph:code-bold",
+      prefix: "develop/",
       collapsible: true,
-      children: [
-        {
-          text: "Linuxコンパイルチュートリアル",
-          icon: "teenyicons:linux-alt-solid",
-          link: "/ja-jp/2.1-Linuxチュートリアル",
-        },
-        {
-          text: "開発関連",
-          icon: "iconoir:developer",
-          link: "/ja-jp/2.2-プルリクエスト",
-        },
-        {
-          text: "IssueBotの使用方法",
-          icon: "bxs:bot",
-          link: "/ja-jp/2.3-IssueBotの使用方法",
-        },
-        {
-          text: "純WebサイトのPRチュートリアル",
-          icon: "mingcute:git-pull-request-fill",
-          link: "/ja-jp/2.4-純WebサイトのPRチュートリアル",
-        },
-        {
-          text: "グローバル版を含む海外クライアントの対応について",
-          icon: "ri:earth-fill",
-          link: "/ja-jp/2.5-OVERSEAS_CLIENTS_ADAPTATION",
-        },
-      ],
+      children: "structure",
     },
     {
       text: "プロトコルドキュメント",
       icon: "basil:document-solid",
+      prefix: "protocol/",
       collapsible: true,
-      children: [
-        {
-          text: "インテグレーション",
-          icon: "bxs:book",
-          link: "/ja-jp/3.1-統合ドキュメント",
-        },
-        {
-          text: "コールバック図解",
-          icon: "material-symbols:u-turn-left",
-          link: "/ja-jp/3.2-コールバックAPI",
-        },
-        {
-          text: "自動作戦図解",
-          icon: "ph:sword-bold",
-          link: "/ja-jp/3.3-自動作戦API",
-        },
-        {
-          text: "タスク図解",
-          icon: "material-symbols:task",
-          link: "/ja-jp/3.4-タスクAPI",
-        },
-        {
-          text: "統合戦略図解",
-          icon: "ri:game-fill",
-          link: "/ja-jp/3.5-統合戦略API",
-        },
-        {
-          text: "インフラスケジュール図解",
-          icon: "material-symbols:view-quilt-rounded",
-          link: "/ja-jp/3.6-インフラスケジュール設定",
-        },
-        {
-          text: "セキュリティプレゼンス図解",
-          icon: "game-icons:prisoner",
-          link: "/ja-jp/3.7-SECURITY_PRESENCE_SCHEMA",
-        },
-      ],
+      children: "structure",
     },
   ],
 });

docs/.vuepress/sidebar/ko-kr.ts

@@ -10,115 +10,23 @@ export const kokrSidebar = sidebar({
     {
       text: "사용자 설명서",
       icon: "mdi:user",
+      prefix: "manual/",
       collapsible: true,
-      children: [
-        {
-          text: "기능",
-          icon: "mdi:information-outline",
-          link: "/ko-kr/1.1-사용자_설명서",
-        },
-        {
-          text: "자주 묻는 질문",
-          icon: "ph:question-fill",
-          link: "/ko-kr/1.2-FAQ",
-        },
-        {
-          text: "에뮬레이터 지원",
-          icon: "mingcute:laptop-fill",
-          collapsible: true,
-          children: [
-            {
-              text: "Windows",
-              icon: "ri:windows-fill",
-              link: "/ko-kr/1.3-에뮬레이터_지원",
-            },
-            {
-              text: "Mac",
-              icon: "basil:apple-solid",
-              link: "/ko-kr/1.4-Mac에뮬레이터_지원",
-            },
-            {
-              text: "Linux",
-              icon: "teenyicons:linux-alt-solid",
-              link: "/ko-kr/1.5-LINUX용_에뮬레이터 지원",
-            },
-          ],
-        },
-      ],
+      children: "structure",
     },
     {
       text: "개발 관련",
       icon: "ph:code-bold",
+      prefix: "develop/",
       collapsible: true,
-      children: [
-        {
-          text: "리눅스 컴파일 튜토리얼",
-          icon: "teenyicons:linux-alt-solid",
-          link: "/ko-kr/2.1-LINUX_튜토리얼",
-        },
-        {
-          text: "개발 환경 구축하기",
-          icon: "iconoir:developer",
-          link: "/ko-kr/2.2-개발_환경_구축하기",
-        },
-        {
-          text: "Issue Bot 사용 방법",
-          icon: "bxs:bot",
-          link: "/ko-kr/2.3-Issue_Bot_사용방법",
-        },
-        {
-          text: "GitHub Pull Request 사용 가이드",
-          icon: "mingcute:git-pull-request-fill",
-          link: "/ko-kr/2.4-웹을_통한_풀리퀘스트_튜토리얼",
-        },
-        {
-          text: "해외 클라이언트 현지화",
-          icon: "ri:earth-fill",
-          link: "/ko-kr/2.5-해외_클라이언트_현지화",
-        },
-      ],
+      children: "structure",
     },
     {
       text: "프로토콜 문서",
       icon: "basil:document-solid",
+      prefix: "protocol/",
       collapsible: true,
-      children: [
-        {
-          text: "연동",
-          icon: "bxs:book",
-          link: "/ko-kr/3.1-연동",
-        },
-        {
-          text: "콜백 스키마",
-          icon: "material-symbols:u-turn-left",
-          link: "/ko-kr/3.2-콜백_스키마",
-        },
-        {
-          text: "전투 스키마",
-          icon: "ph:sword-bold",
-          link: "/ko-kr/3.3-전투_스키마",
-        },
-        {
-          text: "작업 스키마",
-          icon: "material-symbols:task",
-          link: "/ko-kr/3.4-작업_스키마",
-        },
-        {
-          text: "통합전략 스키마",
-          icon: "ri:game-fill",
-          link: "/ko-kr/3.5-통합전략_스키마",
-        },
-        {
-          text: "기반시설 예약 스키마",
-          icon: "material-symbols:view-quilt-rounded",
-          link: "/ko-kr/3.6-기반시설_예약_스키마",
-        },
-        {
-          text: "보안파견 스키마",
-          icon: "game-icons:prisoner",
-          link: "/ko-kr/3.7-보안파견_스키마",
-        },
-      ],
+      children: "structure",
     },
   ],
 });

docs/.vuepress/sidebar/zh-cn.ts

@@ -1,139 +1,32 @@
 import { sidebar } from "vuepress-theme-hope";
 
 export const zhcnSidebar = sidebar({
-  "/": [
+  "/zh-cn/": [
     {
       text: "MAA",
       icon: "ic:round-home",
-      link: "/",
+      link: "/zh-cn/",
     },
     {
       text: "用户手册",
       icon: "mdi:user",
+      prefix: "manual/",
       collapsible: true,
-      children: [
-        {
-          text: "功能介绍",
-          icon: "mdi:information-outline",
-          link: "/1.1-详细介绍",
-        },
-        {
-          text: "常见问题",
-          icon: "ph:question-fill",
-          link: "/1.2-常见问题",
-        },
-        {
-          text: "模拟器支持",
-          icon: "mingcute:laptop-fill",
-          collapsible: true,
-          children: [
-            {
-              text: "Windows",
-              icon: "ri:windows-fill",
-              link: "/1.3-模拟器支持",
-            },
-            {
-              text: "Mac",
-              icon: "basil:apple-solid",
-              link: "/1.4-Mac模拟器支持",
-            },
-            {
-              text: "Linux",
-              icon: "teenyicons:linux-alt-solid",
-              link: "/1.5-Linux模拟器支持",
-            },
-          ],
-        },
-        {
-          text: "CLI使用指南",
-          icon: "material-symbols:terminal",
-          link: "/1.6-CLI使用指南",
-        },
-      ],
+      children: "structure",
     },
     {
       text: "开发文档",
       icon: "ph:code-bold",
+      prefix: "develop/",
       collapsible: true,
-      children: [
-        {
-          text: "Linux编译教程",
-          icon: "teenyicons:linux-alt-solid",
-          link: "/2.1-Linux编译教程",
-        },
-        {
-          text: "开发相关",
-          icon: "iconoir:developer",
-          link: "/2.2-开发相关",
-        },
-        {
-          text: "IssueBot使用方法",
-          icon: "bxs:bot",
-          link: "/2.3-IssueBot使用方法",
-        },
-        {
-          text: "纯网页端PR教程",
-          icon: "mingcute:git-pull-request-fill",
-          link: "/2.4-纯网页端PR教程",
-        },
-        {
-          text: "外服适配教程",
-          icon: "ri:earth-fill",
-          link: "/2.5-外服适配教程",
-        },
-        {
-          text: "文档编写指南",
-          icon: "jam:write-f",
-          link: "/2.6-文档编写指南",
-        }
-      ],
+      children: "structure",
     },
     {
       text: "协议文档",
       icon: "basil:document-solid",
+      prefix: "protocol/",
       collapsible: true,
-      children: [
-        {
-          text: "集成文档",
-          icon: "bxs:book",
-          link: "/3.1-集成文档",
-        },
-        {
-          text: "回调消息协议",
-          icon: "material-symbols:u-turn-left",
-          link: "/3.2-回调消息协议",
-        },
-        {
-          text: "战斗流程协议",
-          icon: "ph:sword-bold",
-          link: "/3.3-战斗流程协议",
-        },
-        {
-          text: "任务流程协议",
-          icon: "material-symbols:task",
-          link: "/3.4-任务流程协议",
-        },
-        {
-          text: "肉鸽辅助协议",
-          icon: "ri:game-fill",
-          link: "/3.5-肉鸽辅助协议",
-        },
-        {
-          text: "基建排班协议",
-          icon: "material-symbols:view-quilt-rounded",
-          link: "/3.6-基建排班协议",
-        },
-        {
-          text: "保全派驻协议",
-          icon: "game-icons:prisoner",
-          link: "/3.7-保全派驻协议",
-        },
-        {
-          text: "远程控制协议",
-          icon: "mdi:remote-desktop",
-          link: "/3.8-远程控制协议"
-        },
-      ],
+      children: "structure",
     },
   ],
 });

docs/.vuepress/sidebar/zh-tw.ts

@@ -10,120 +10,23 @@ export const zhtwSidebar = sidebar({
     {
       text: "用戶說明書",
       icon: "mdi:user",
+      prefix: "manual/",
       collapsible: true,
-      children: [
-        {
-          text: "功能介绍",
-          icon: "mdi:information-outline",
-          link: "/zh-tw/1.1-詳細介紹",
-        },
-        {
-          text: "常見問題",
-          icon: "ph:question-fill",
-          link: "/zh-tw/1.2-常見問題",
-        },
-        {
-          text: "模擬器支援",
-          icon: "mingcute:laptop-fill",
-          collapsible: true,
-          children: [
-            {
-              text: "Windows",
-              icon: "ri:windows-fill",
-              link: "/zh-tw/1.3-模擬器支援",
-            },
-            {
-              text: "Mac",
-              icon: "basil:apple-solid",
-              link: "/zh-tw/1.4-Mac模擬器支援",
-            },
-            {
-              text: "Linux",
-              icon: "teenyicons:linux-alt-solid",
-              link: "/zh-tw/1.5-Linux模擬器支援",
-            },
-          ],
-        },
-        {
-          text: "CLI使用說明",
-          icon: "material-symbols:terminal",
-          link: "/zh-tw/1.6-CLI使用說明",
-        },
-      ],
+      children: "structure",
     },
     {
       text: "開發文件",
       icon: "ph:code-bold",
+      prefix: "develop/",
       collapsible: true,
-      children: [
-        {
-          text: "Linux編譯教學",
-          icon: "teenyicons:linux-alt-solid",
-          link: "/zh-tw/2.1-Linux編譯教學",
-        },
-        {
-          text: "開發相關",
-          icon: "iconoir:developer",
-          link: "/zh-tw/2.2-開發相關",
-        },
-        {
-          text: "IssueBot使用方法",
-          icon: "bxs:bot",
-          link: "/zh-tw/2.3-IssueBot使用方法",
-        },
-        {
-          text: "純網頁端PR教學",
-          icon: "mingcute:git-pull-request-fill",
-          link: "/zh-tw/2.4-純網頁端PR教學",
-        },
-        {
-          text: "外服適配教學",
-          icon: "ri:earth-fill",
-          link: "/zh-tw/2.5-外服適配教學",
-        },
-      ],
+      children: "structure",
     },
     {
       text: "協議文件",
       icon: "basil:document-solid",
+      prefix: "protocol/",
       collapsible: true,
-      children: [
-        {
-          text: "集成文件",
-          icon: "bxs:book",
-          link: "/zh-tw/3.1-集成文件",
-        },
-        {
-          text: "回呼訊息協議",
-          icon: "material-symbols:u-turn-left",
-          link: "/zh-tw/3.2-回呼訊息協議",
-        },
-        {
-          text: "戰鬥流程協議",
-          icon: "ph:sword-bold",
-          link: "/zh-tw/3.3-戰鬥流程協議",
-        },
-        {
-          text: "任務流程協議",
-          icon: "material-symbols:task",
-          link: "/zh-tw/3.4-任務流程協議",
-        },
-        {
-          text: "肉鴿輔助協議",
-          icon: "ri:game-fill",
-          link: "/zh-tw/3.5-肉鴿輔助協議",
-        },
-        {
-          text: "基建排班協議",
-          icon: "material-symbols:view-quilt-rounded",
-          link: "/zh-tw/3.6-基建排班協議",
-        },
-        {
-          text: "保全派駐協議",
-          icon: "game-icons:prisoner",
-          link: "/zh-tw/3.7-保全派駐協議",
-        },
-      ],
+      children: "structure",
     },
   ],
 });

docs/.vuepress/styles/index.scss

@@ -1,16 +0,0 @@
-.home {
-  .vp-hero-info-wrapper {
-    min-height: 600px;
-  }
-}
-
-.catalog-display-container {
-  overflow-x: visible;
-  overflow-y: auto;
-
-  max-height: 75vh;
-  margin: 0.5rem;
-  border-radius: 0.5rem;
-
-  overflow-wrap: break-word;
-}

docs/.vuepress/styles/palette.scss

@@ -1,6 +1,10 @@
 $sidebar-width: 16rem;
 $content-width: 1000px;
 
+$font-family: '-apple-system, BlinkMacSystemFont, "Noto Sans SC", "Segoe UI", Roboto, Oxygen, Ubuntu, Cantarell, "Fira Sans", "Droid Sans", "Helvetica Neue", STHeiti, "Microsoft YaHei", sans-serif';
+$font-family-heading: 'Georgia, -apple-system, "Nimbus Roman No9 L", "PingFang SC", "Hiragino Sans GB", "Noto Serif SC", "Microsoft Yahei", "WenQuanYi Micro Hei", "ST Heiti", sans-serif';
+$font-family-mono: '"Sarasa Gothic", "Jetbrains mono", "Fira Code", "Noto Sans SC", Consolas, monospace, Menlo, "Courier New"';
+
 html[lang="ja-JP"] {
-  font-family: "Helvetica Neue, Arial, Hiragino Kaku Gothic ProN, Hiragino Sans, Meiryo, sans-serif";
+  $font-family: "Helvetica Neue, Arial, Hiragino Kaku Gothic ProN, Hiragino Sans, Meiryo, sans-serif";
 }

docs/.vuepress/theme.ts

@@ -1,4 +1,5 @@
 import { hopeTheme } from "vuepress-theme-hope";
+import DocSearchConfig from './plugins/search';
 import { zhcnNavbar, zhtwNavbar, enusNavbar, jajpNavbar, kokrNavbar } from "./navbar/index";
 import { zhcnSidebar, zhtwSidebar, enusSidebar, jajpSidebar, kokrSidebar } from "./sidebar/index";
 
@@ -10,12 +11,12 @@ export default hopeTheme({
   docsDir: "/docs",
 
   locales: {
-    "/": {
+    "/zh-cn/": {
       navbar: zhcnNavbar,
       sidebar: zhcnSidebar,
       displayFooter: false,
       metaLocales: {
-        editLink: "在Github上编辑此页面",
+        editLink: "在 Github 上编辑此页面",
       },
     },
     "/zh-tw/": {
@@ -23,7 +24,7 @@ export default hopeTheme({
       sidebar: zhtwSidebar,
       displayFooter: false,
       metaLocales: {
-        editLink: "在Github上編輯此頁面",
+        editLink: "在 Github 上編輯此頁面",
       },
     },
     "/en-us/": {
@@ -39,7 +40,7 @@ export default hopeTheme({
       sidebar: jajpSidebar,
       displayFooter: false,
       metaLocales: {
-        editLink: "このページをGithubで編集する",
+        editLink: "このページを Github で編集する",
       },
     },
     "/ko-kr/": {
@@ -47,13 +48,11 @@ export default hopeTheme({
       sidebar: kokrSidebar,
       displayFooter: false,
       metaLocales: {
-        editLink: "Github에서 이 페이지를 편집",
+        editLink: "Github 에서 이 페이지를 편집",
       },
     },
   },
 
-  sidebarIcon: true,
-
   plugins: {
     activeHeaderLinks: false,
 
@@ -61,43 +60,117 @@ export default hopeTheme({
       provider: "Giscus",
       repo: "MaaAssistantArknights/maa-website",
       repoId: "R_kgDOHY7Gyg",
-      category: "General",
-      categoryId: "DIC_kwDOHY7Gys4CYefe",
-      mapping: "title",
-      strict: false,
+      category: "Comments",
+      categoryId: "DIC_kwDOHY7Gys4CgoVH",
+      mapping: "pathname",
+      strict: true,
     },
 
     copyright: {
       license: "AGPL-3.0",
     },
 
+    docsearch: DocSearchConfig,
+
     mdEnhance: {
       align: true,
-      card: true,
-      chart: true,
       codetabs: true,
-      container: true,
-      echarts: true,
+      //echarts: true,
       footnote: true,
       gfm: true,
+      hint: true,
       imgLazyload: true,
       imgMark: true,
       imgSize: true,
-      mathjax: true,
+      //mathjax: true,
       mark: true,
-      mermaid: true,
+      //mermaid: true,
       tabs: true,
       tasklist: true,
       vPre: true,
+      component: true,
     },
 
-    prismjs: {
-      light: "one-dark",
-      dark: "nord",
+    shiki: {
+      themes: {
+        light: "light-plus",
+        dark: "nord",
+      }
     },
 
     sitemap: true,
 
+    notice: [
+      {
+        path: "/zh-tw/",
+        title: "翻译警告",
+        content: "MAA 的文檔以簡體中文為主，其他語言的文檔可能品質低或尚未翻譯，請諒解。",
+        fullscreen: true,
+        confirm: true,
+        showOnce: true,
+        actions: [
+          {
+            text: "我知道了",
+            type: "primary",
+          },
+          { text: "前往簡體中文",
+            link: "/zh-cn/",
+          },
+        ],
+      },
+      {
+        path: "/en-us/",
+        title: "Translation Warning",
+        content: "MAA's documents are mainly in Simplified Chinese. Documents in other languages may be of low quality or not yet translated. Please understand.",
+        fullscreen: true,
+        confirm: true,
+        showOnce: true,
+        actions: [
+          {
+            text: "Okay",
+            type: "primary",
+          },
+          { text: "Take me to zh-CN",
+            link: "/zh-cn/",
+          },
+        ],
+      },
+      {
+        path: "/ja-jp/",
+        title: "翻訳に関する警告",
+        content: "MAA のドキュメントは主に簡体字中国語で書かれており、他の言語のドキュメントは低品質であるか、翻訳されていない可能性がありますので、ご了承ください。",
+        fullscreen: true,
+        confirm: true,
+        showOnce: true,
+        actions: [
+          {
+            text: "OK",
+            type: "primary",
+          },
+          { text: "中国語サイトへ行く",
+            link: "/zh-cn/",
+          },
+        ],
+      },
+      {
+        path: "/ko-kr/",
+        title: "번역 경고",
+        content: "MAA의 문서는 주로 중국어 간체로 되어 있습니다. 다른 언어로 된 문서는 번역이 이상하거나, 번역이 되어있지 않을 수 있습니다.",
+        fullscreen: true,
+        confirm: true,
+        showOnce: true,
+        actions: [
+          {
+            text: "OK",
+            type: "primary",
+          },
+          { text: "중국어 간체로 이동",
+            link: "/zh-cn/",
+          },
+        ],
+      },
+    ],
+
   },
 
 });