# 工艺动作组

## 介绍

插件上的运行全部依靠 Action 来运作，所以你要学会使用这个插件，你就得理解  Action  的运行方式及逻辑，同时插件支持 Kether 语法触发，插件 Action 格式均为 **"craft:action \*params"** 不带 **craft:** 开头的视为 Kether 语法运行

## 基础格式

一个最基础的 Action 配置为以下格式，这个格式内 condition、meet、not-meet 都是可选的，你可以只设置 meet 那样子该 Action 配置就必定会触发 meet 所设内容

```yaml
- condition:
    #条件判断,这里的条件满足于不满足分别会执行 meet 或 not-meet 内所设 action 脚本
    #插件支持使用 Kether 的所有语法
    - "XXXX"
  #上方条件满足时触发
  meet:
    - "XXXX"
  #上方条件不满足时触发
  not-meet:
    - "XXXX"
```

## 进阶格式

以 **工艺图纸** 配置内的 start-actions 配置项为例，他会按步骤顺序依次往下执行，这个格式仅在 start-actions、extract-actions 配置项上使用，工艺图纸配置的 actions 项，请看下文 **高级进阶格式** 写法

```yaml
start-actions:
  #步骤1
  1:
    - condition:
      - "XXXX"
    meet:
      - "XXXX"
    not-meet:
      - "XXXX"
  #步骤2
  2:
    - condition:
      - "XXXX"
    meet:
      - "XXXX"
    not-meet:
      - "XXXX"
```

## 高级进阶格式

这个写法只在 工艺图纸 配置上的 actions 配置项使用，这个会把 Action 动作组分为 主、子 的步骤运行，一个主的 Action 动作组内可以包含多个子的 Action 动作组

```yaml
actions:
  #主步骤1
  1:
    #子步骤1
    1:
      - condition:
        - "XXXX"
      meet:
        - "XXXX"
      not-meet:
        - "XXXX"
    #子步骤2
    2:
      - condition:
        - "XXXX"
      meet:
        - "XXXX"
      not-meet:
        - "XXXX"
  #主步骤2
  2:
    #子步骤1
    1:
      - condition:
        - "XXXX"
      meet:
        - "XXXX"
      not-meet:
        - "XXXX"
    #子步骤2
    2:
      - condition:
        - "XXXX"
      meet:
        - "XXXX"
      not-meet:
        - "XXXX"
```

## 终止运行方式

在插件使用的过程中，如果需要做到概率判断不满足时中断 Action 动作组继续往下执行时可在 Action 动作组对应的配置位置中加上以下关键词做到终止

| 关键词         | 作用                     |
| ----------- | ---------------------- |
| cancel\_all | 终止接下来所有动作组的运行 (主、子都终止) |
| cancel\_sub | 终止子动作组内接下来的动作运行        |

**cancel\_sub** 在 **高级进阶格式** 上的用法比较特殊，如果是在动作组内使用该关键词，那么他会终止该主动作组内子动作组接下来步骤的运行，但不会运行到接下来运行到的主动作组，如果要终止接下来所有主动作组的运行，需要使用 **cancel\_all** 来终止

## 懂了吗？不懂接着往下看

看得出你是真的不懂，所以建议你看下插件提供的例子，上面都有用到上面说的内容，我还写了详细的注释


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ersha.gitbook.io/code-new/craftframe/craft-frame/gong-yi-dong-zuo-zu.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.