Add build from config support (craft command)

docs/en/develop/craft-yml.md

@@ -0,0 +1,7 @@
+---
+aside: false
+---
+
+# craft.yml Configuration
+
+<!--@include: ../../deps-craft-yml.md-->

docs/en/guide/manual-build.md

@@ -1,3 +1,7 @@
+---
+outline: 'deep'
+---
+
 # Build (Linux, macOS, FreeBSD)
 
 This section covers the build process for Linux, macOS, and FreeBSD. If you want to build on Windows, 
@@ -133,7 +137,47 @@ and then install the latest version of PHP and tokenizer, XML, and phar extensio
 Older versions of Debian may have an older (<= 7.4) version of PHP installed by default, it is recommended to upgrade Debian first.
 :::
 
-## Command - download
+## Build with craft (recommended)
+
+Using `bin/spc craft`, you can use a configuration file and a command to automatically check the environment, download source code, build dependency libraries, build PHP and extensions, etc.
+
+You need to write a `craft.yml` file and save it in the current working directory. `craft.yml` can be generated by [command generator](./cli-generator) or written manually.
+
+For manual writing, please refer to the comments in [craft.yml configuration](../develop/craft-yml.md) to write it. 
+Let's assume that you compile an extension combination and choose PHP 8.4, outputting `cli` and `fpm`:
+
+```yaml
+# path/to/craft.yml
+php-version: 8.4
+extensions: bcmath,posix,phar,zlib,openssl,curl,fileinfo,tokenizer
+sapi:
+  - cli
+  - fpm
+```
+
+Then use the `bin/spc craft` command to compile:
+
+```bash
+bin/spc craft --debug
+```
+
+If the build is successful, you will see the `buildroot/bin` directory in the current directory, which contains the compiled PHP binary file, or the corresponding SAPI.
+
+- cli: The build result is `buildroot/bin/php.exe` on Windows and `buildroot/bin/php` on other platforms.
+- fpm: The build result is `buildroot/bin/php-fpm`.
+- micro: The build result is `buildroot/bin/micro.sfx`. If you need to further package it with PHP code, please refer to [Packaging micro binary](./manual-build#command-micro-combine).
+- embed: See [Using embed](./manual-build#embed-usage).
+
+If the build fails, you can use the `--debug` parameter to view detailed error information, 
+or use the `--with-clean` to clear the old compilation results and recompile.
+
+If the build still fails to use the above method, please submit an issue and attach your `craft.yml` and `craft.log`.
+
+## Step-by-step build command
+
+If you have customized requirements, or the need to download and compile PHP and dependent libraries separately, you can use the `bin/spc` command to execute step by step.
+
+### Command download - Download dependency packages
 
 Use the command `bin/spc download` to download the source code required for compilation, 
 including php-src and the source code of various dependent libraries.
@@ -217,7 +261,7 @@ bin/spc download --for-extensions=redis -G "php-src:master:https://github.com/ph
 bin/spc download --for-extensions=swoole -G "swoole:master:https://github.com/swoole/swoole-src.git"
 ```
 
-## Command - doctor
+### Command - doctor
 
 If you can run `bin/spc` normally but cannot compile static PHP or dependent libraries normally, 
 you can run `bin/spc doctor` first to check whether the system itself lacks dependencies.
@@ -230,13 +274,13 @@ bin/spc doctor
 bin/spc doctor --auto-fix
 ```
 
-## Command - build
+### Command - build
 
 Use the build command to start building the static php binary. 
 Before executing the `bin/spc build` command, be sure to use the `download` command to download sources. 
 It is recommended to use `doctor` to check the environment.
 
-### Basic build
+#### Basic build
 
 You need to go to [Extension List](./extensions) or [Command Generator](./cli-generator) to select the extension you want to add, 
 and then use the command `bin/spc build` to compile. 
@@ -283,16 +327,7 @@ bin/spc build bcmath,curl,openssl,ftp,posix,pcntl --build-cli
 ```
 :::
 
-### Debug
-
-If you encounter problems during the compilation process, or want to view each executing shell command, 
-you can use `--debug` to enable debug mode and view all terminal logs:
-
-```bash
-bin/spc build mysqlnd,pdo_mysql --build-all --debug
-```
-
-### Build Options
+#### Build Options
 
 During the compilation process, in some special cases, 
 the compiler and the content of the compilation directory need to be intervened. 
@@ -322,6 +357,15 @@ For hardcoding INI options, it works for cli, micro, embed sapi. Here is a simpl
 bin/spc build bcmath,pcntl,posix --build-all -I "memory_limit=4G" -I "disable_functions=system"
 ```
 
+## Debug
+
+If you encounter problems during the compilation process, or want to view each executing shell command,
+you can use `--debug` to enable debug mode and view all terminal logs:
+
+```bash
+bin/spc build mysqlnd,pdo_mysql --build-all --debug
+```
+
 ## Command - micro:combine
 
 Use the `micro:combine` command to build the compiled `micro.sfx` and your code (`.php` or `.phar` file) into an executable binary.