@modern-js/main-doc 0.0.0-next-1685988387703 → 0.0.0-next-1686037191101

package/docs/en/guides/topic-detail/changesets/release.mdx

@@ -0,0 +1,229 @@
+---
+sidebar_position: 3
+---
+
+# Publishing version
+
+When releasing a version, we need to upgrade the version numbers of the corresponding packages based on the changeset generated during development, and execute the publish command to publish them to NPM.
+
+## Steps
+
+:::info
+The following example commands are all using pnpm as the package management tool. If you need to use other package management tools, please replace them as needed.
+
+:::
+
+### Npm Module
+
+#### Run the following command in the root directory:
+
+```bash
+pnpm run bump
+```
+
+![](https://lf3-static.bytednsdoc.com/obj/eden-cn/zq-uylkvT/ljhwZthlaukjlkulzlp/changeset-module-bump.png)
+
+When running this command, changesets will automatically perform the following operations:
+
+- Delete all changeset files under the `.changesets` directory.
+
+- Upgrade the package version number based on the changeset information.
+
+- Write Changelog information to the `CHANGELOG.md` file in the root directory. The file will be automatically created if it does not exist.
+
+#### Confirm and submit the current changes:
+
+```bash
+git add .
+git commit -m "release: bump package"
+```
+
+#### Run the following command in the root directory to publish the package to NPM:
+
+```bash
+pnpm run release
+```
+
+![](https://lf3-static.bytednsdoc.com/obj/eden-cn/zq-uylkvT/ljhwZthlaukjlkulzlp/changeset-module-release.png)
+
+#### Push the corresponding tag information to the remote repository:
+
+```bash
+git push --follow-tags
+```
+
+### Monorepo
+
+#### Run the following command in the root directory:
+
+```bash
+pnpm run bump
+```
+
+![](https://lf3-static.bytednsdoc.com/obj/eden-cn/zq-uylkvT/ljhwZthlaukjlkulzlp/changeset-monorepo-bump.png)
+
+When running this command, changesets will automatically perform the following operations:
+
+- Delete all changeset files under the `.changesets` directory.
+
+- Upgrade the version numbers of the relevant packages based on the changeset information. In addition to the packages written in the changeset, changesets will also analyze the dependency relationships of all packages in the Monorepo during execution. If an upgrade is required, the version number will be automatically upgraded accordingly.
+
+- Write Changelog information to the `CHANGELOG.md` file in the directory of the package that needs to be upgraded. The file will be automatically created if it does not exist.
+
+#### Confirm and submit the current changes:
+
+:::info
+Make sure that the automatically upgraded version numbers meet the expected requirements. If you need to understand the version upgrade strategy, please refer to [Version Upgrade Strategy](/guides/topic-detail/changesets/release#version-upgrade-strategy).
+:::
+
+```bash
+git add .
+git commit -m "release: bump package"
+```
+
+#### Run the following command in the root directory to publish the package to NPM:
+
+```bash
+pnpm run release
+```
+
+When running this command, it will sequentially determine whether the versions of all packages in the Monorepo exist on NPM. If they do not exist, the `publish` command will be executed to publish them.
+
+:::warning
+When the dependencies between packages in the Monorepo are declared using workspace, do not directly execute `npm publish` to publish the package in the corresponding subdirectory of the package. Use the `release` command instead. When publishing, the workspace declaration will be automatically removed to ensure that the NPM package is available after publishing.
+:::
+
+#### Push the corresponding tag information to the remote repository:
+
+```bash
+git push --follow-tags
+```
+
+## Parameters
+
+### Parameters for the `bump` command
+
+- `--snapshot` Generates a timestamp-based version number.
+
+```bash
+pnpm run bump --snapshot canary
+```
+
+After running, the corresponding upgraded version number will become `0.0.0-canary-20220622092823`, and `canary` is the tag configured for snapshot. If not configured, it will directly generate the form of `0.0.0-20220622092823`.
+
+This parameter is mainly used to publish temporary test versions for testing and does not require code submission.
+
+- `--ignore` Manually ignore some packages during publishing.
+
+For example, if you need to ignore the `module-2` package for this release:
+
+```bash
+pnpm run bump --ignore module-2
+```
+
+After executing the command, the update of the `module-2` package will be ignored. Note that if there are packages that depend on `module-2`, the corresponding packages also need to be added to the `ignore` parameter, otherwise the `bump` command will fail.
+
+The usage for adding multiple packages is as follows:
+
+```bash
+pnpm run bump --ignore module-2 --ignore module-3
+```
+
+### Parameters for the `release` command
+
+- `--otp` Uses `npm token` to execute the release command to publish the corresponding package.
+
+```bash
+pnpm run relese --otp <token>
+```
+
+- `--tag` Uses a specific tag for local publishing, and `latest` is used by default.
+
+```bash
+pnpm run release --tag <tag>
+```
+
+- `--ignore-scripts` Ignores npm scripts during publishing.
+
+When executing the `publish` command, npm will automatically trigger many commands, such as `prepare` and `prepublish`. Using this parameter can ignore the execution of these commands. This parameter is only supported in Monorepo using pnpm.
+
+```bash
+pnpm run release --ignore-scripts
+```
+
+- `--no-git-checks` Ignores checking the current branch during publishing.
+
+By default, when executing the publish command, it will automatically check whether the current branch is a release branch, whether there are uncommitted changes, etc. Using this parameter can ignore git-related checks.
+
+```bash
+pnpm run release --no-git-checks
+```
+
+## Version Upgrade Strategy
+
+### dependencies or devDependencies dependencies
+
+#### Only upgrade the patch version of the package itself for patch version dependencies
+
+For example, the following scenario exists:
+
+There are two packages in Monorepo, `module-1` and `module-2`, and `module-1` exists in the `dependencies` of `module-2`.
+
+The current changeset is the patch version upgrade of `module-1`.
+
+After executing the bump command, only the patch version number of `module-1` will be upgraded.
+
+#### Upgrade the major or minor version number of the package itself for major/minor version upgrades, and upgrade the patch version number of the dependent packages
+
+For example, the following scenario exists:
+
+There are two packages in Monorepo, `module-1` and `module-2`, and `module-1` exists in the `dependencies` of `module-2`.
+
+The current changeset is the minor version upgrade of `module-1`.
+
+After executing the bump command, `module-1` will upgrade the `minor` version number, and `module-2` will upgrade the `patch` version number.
+
+### peerDependencies dependencies
+
+#### Upgrade the patch version number of the package itself and the dependent package for patch version dependencies
+
+For example, the following scenario exists:
+
+There are two packages in Monorepo, `module-1` and `module-2`, and `module-1` exists in the `peerDependencies` of `module-2`.
+
+The current changeset is the patch version upgrade of `module-1`.
+
+After executing the bump command, both `module-1` and `module-2` will upgrade the patch version number.
+
+#### Upgrade the major version number of the dependent package for major/minor version upgrades of the package itself
+
+For example, the following scenario exists:
+
+There are two packages in Monorepo, `module-1` and `module-2`, and `module-1` exists in the `peerDependencies` of `module-2`.
+
+The current changeset is the minor version upgrade of `module-1`.
+
+After executing the bump command, `module-1` will upgrade the `minor` version number, and `module-2` will upgrade the `major` version number.
+
+#### Modify the upgrade strategy for peerDependencies
+
+The upgrade strategy of `peerDependencies` can be modified by configuring `onlyUpdatePeerDependentsWhenOutOfRange`. When only the declared version type range is exceeded, the corresponding `peerDependencies` will be upgraded.
+
+```json
+{
+  "___experimentalUnsafeOptions_WILL_CHANGE_IN_PATCH": {
+    "onlyUpdatePeerDependentsWhenOutOfRange": true
+  },
+  ...
+}
+```
+
+For example, the following scenario exists:
+
+There are two packages in Monorepo, `module-1` and `module-2`, and `module-1` exists in the `peerDependencies` of `module-2`, and the version number of `module-1` is declared using `^`.
+
+The current changeset is the patch or minor version upgrade of `module-1`.
+
+After executing the `bump` command, only the version number of `module-1` will be upgraded.
+
+Note that if the package version number is in the `0.x.x` range, upgrading the `minor` version number is also beyond the declared version type range.

package/docs/zh/configure/app/tools/swc.mdx

@@ -19,23 +19,9 @@ import SWC from '@modern-js/builder-doc/docs/zh/shared/swc.md';
 
 ## 安装
 
-首先，你需要执行 `pnpm run new` 启用 SWC 编译：
+import EnableSWC from '@modern-js/builder-doc/docs/zh/shared/enable-swc.md';
 
-```bash
-? 请选择你想要的操作 启用可选功能
-? 请选择功能名称 启用「SWC 编译」
-```
-
-执行完成后，你只需在 `modern.config.ts` 文件中注册 SWC 插件，即可启用 SWC 编译和压缩能力。
-
-```ts title="modern.config.ts"
-import appTools, { defineConfig } from '@modern-js/app-tools';
-import swcPlugin from '@modern-js/plugin-swc';
-
-export default defineConfig({
-  plugins: [appTools(), swcPlugin()],
-});
-```
+<EnableSWC />
 
 ## 配置项
 

package/docs/zh/guides/topic-detail/changesets/add.mdx

@@ -2,9 +2,9 @@
 sidebar_position: 2
 ---
 
-# 添加一个 changeset
+# 添加 Changesets
 
-当我们开发完成一个功能时，需要添加一个 changeset 用于声明当前功能，用于后续版本发布。
+当我们开发完成时，需要添加一个 changeset 声明当前变更，用于后续版本发布。
 
 ## 信息
 
@@ -14,7 +14,7 @@ sidebar_position: 2
 
 - 本次变更需要升级的版本号类型，类型符合 [semver](https://semver.org/) 规范。
 
-- 本次变更的 Changelog 信息。
+- 本次变更的 changelog 信息。
 
 ## 步骤
 
@@ -35,7 +35,7 @@ pnpm run change
 
 ![选择版本类型](https://lf3-static.bytednsdoc.com/obj/eden-cn/zq-uylkvT/ljhwZthlaukjlkulzlp/changeset-select-version.png)
 
-#### 填入 Changelog 信息，并点击两次回车：
+#### 填入 changelog 信息，并点击两次回车：
 
 ![写入变更信息](https://lf3-static.bytednsdoc.com/obj/eden-cn/zq-uylkvT/ljhwZthlaukjlkulzlp/changeset-input-changelog.png)
 
@@ -73,7 +73,7 @@ Changesets 会根据当前代码变更(`git diff Head...baseBranch`)，将 Monor
 
 ![选择升级包版本类型](https://lf3-static.bytednsdoc.com/obj/eden-cn/zq-uylkvT/ljhwZthlaukjlkulzlp/changeset-auto-select-patch.png)
 
-#### 填入 Changelog 信息，并点击两次回车：
+#### 填入 changelog 信息，并点击两次回车：
 
 ![写入变更信息](https://lf3-static.bytednsdoc.com/obj/eden-cn/zq-uylkvT/ljhwZthlaukjlkulzlp/changeset-input-changelog-monorepo.png)
 
@@ -97,7 +97,7 @@ change 命令支持以下参数：
 - `--empty` 添加一个空的 changeset。
 
 ```bash
-pnpm run change -- --empty
+pnpm run change --empty
 ```
 
 执行完成后，将在项目的 `.changeset` 目录创建空的 changeset 文件，文件内容如下：
@@ -107,7 +107,7 @@ pnpm run change -- --empty
 ---
 ```
 
-- `--open` 使用该参数时，在填写 Changelog 步骤会打开系统默认编辑器进行填写。
+- `--open` 使用该参数时，在填写 changelog 步骤会打开系统默认编辑器进行填写。
 
 ## 注意事项
 

package/docs/zh/guides/topic-detail/changesets/changelog.mdx

@@ -2,15 +2,15 @@
 sidebar_position: 6
 ---
 
-# 自定义 Changelog 生成
+# 自定义 changelog 生成
 
-Changesets 默认会使用 `@changesets/cli/changelog` 生成 Changelog 信息，如果默认的 Changelog 信息不能满足需求，可以自定义 Changelog 的生成。
+Changesets 默认会使用 `@changesets/cli/changelog` 生成 Changelog 信息，如果默认的 changelog 信息不能满足需求，可以自定义 changelog 的生成。
 
-## 自定义 Changlog 内容
+## 自定义 changelog 内容
 
-Changelog 信息主要包含以下两种信息：
+changelog 信息主要包含以下两种信息：
 
-- changeset 中写入的 Changelog 信息。
+- changeset 中写入的 changelog 信息。
 
 - 本次版本升级关联包的版本变更信息。
 
@@ -41,7 +41,7 @@ export type Changeset = {
 
 #### 返回值
 
-Changelog 内容。
+changelog 内容。
 
 #### 默认实现
 
@@ -91,7 +91,7 @@ type DependenciesUpdated = ModCompWithPackage[];
 
 #### 返回值
 
-Changelog 内容。
+changelog 内容。
 
 #### 默认实现
 
@@ -128,11 +128,11 @@ async function getDependencyReleaseLine(changesets, dependenciesUpdated) {
 
 ## 配置
 
-Changesets 配置文件中 `changelog` 字段，该字段用于标记 Changelog 信息的获取途径。
+Changesets 配置文件中 `changelog` 字段用于标记 changelog 信息的获取途径。
 
-该配置可以为字符串，直接声明获取 Changelog 信息模块的模块名称或者路径。
+该配置可以为字符串，直接声明获取 changelog 信息模块的模块名称或者路径。
 
-该配置还支持配置数组，数组中第一个元素为获取 Changelog 信息模块的模块名称或者路径，第二个元素为传入对应函数的参数值，会作为 `getReleaseLine` 和 `getDependencyReleaseLine` 函数的第三个参数传入。
+该配置还支持配置数组，数组中第一个元素为获取 changelog 信息模块的模块名称或者路径，第二个元素为传入对应函数的参数值，会作为 `getReleaseLine` 和 `getDependencyReleaseLine` 函数的第三个参数传入。
 
 ### 配置相对路径
 
@@ -162,7 +162,7 @@ module.exports = {
 
 ### 使用模块工程方案
 
-自定义 Changelog 还可以使用模块工程方案进行管理，提供通用方案。
+自定义 changelog 还可以使用模块工程方案进行管理，提供通用方案。
 
 #### 使用 `npx @modern-js/create@latest` 创建模块工程方案。
 

package/docs/zh/guides/topic-detail/changesets/commit.mdx

@@ -169,7 +169,7 @@ Changesets 配置文件中 `commit` 字段，该字段用于标记是否需要
 
 commit 配置如果为相对路径为 `.changesets` 目录下的相对路径。
 
-例如创建 .changeset/my-commit-config.js 文件，定义如下内容：
+例如创建 `.changeset/my-commit-config.js` 文件，定义如下内容：
 
 ```js title=".changeset/my-commit-config.js"
 async function getAddMessage(changeset, options) {}
@@ -195,8 +195,6 @@ commit 配置为 ./my-commit-config.js 即可:
 
 自定义 commit 还可以使用模块工程方案进行管理，提供通用方案。
 
-自定义 Changelog 还可以使用模块工程方案进行管理，提供通用方案。
-
 #### 使用 `npx @modern-js/create@latest` 创建模块工程方案。
 
 ```md
@@ -222,7 +220,7 @@ export async function getVersionMessage() {}
 
 ```json title="package.json"
 {
-  "changelog": "custom-commit",
+  "commit": "custom-commit",
    ...
 }
 ```

package/docs/zh/guides/topic-detail/changesets/config.mdx

@@ -4,7 +4,7 @@ sidebar_position: 5
 
 # Changesets 配置文件
 
-我们前面了解到，初始化 Modern.js 仓库时，会默认初始化 Changesets 的配置文件，即 `.changeset/config.json` 文件，下面我们将详细了解一下该文件中支持哪些配置。
+我们前面了解到，初始化 Modern.js 仓库时，会默认初始化 changesets 的配置文件，即 `.changeset/config.json` 文件，下面我们将详细了解一下该文件中支持哪些配置。
 
 ## 配置介绍
 
@@ -106,15 +106,15 @@ pkg-b @ version 1.0.0
 
 默认值：`@changesets/cli/changelog`
 
-生成 Changelog 规则。
+生成 changelog 规则。
 
-配置为 `false` 时，执行 bump 命令时，在 `CHANGELOG.md` 文件中只声明版本号，不声明其他 Changelog 信息。
+配置为 `false` 时，执行 bump 命令时，在 `CHANGELOG.md` 文件中只声明版本号，不声明其他 changelog 信息。
 
 ![关闭 changelog 配置](https://lf3-static.bytednsdoc.com/obj/eden-cn/zq-uylkvT/ljhwZthlaukjlkulzlp/changeset-empty-changelog.png)
 
-配置为 `@changesets/cli/changelog` 将使用官方提供的 Changlog 生成规则，将 changeset 信息转换为 Changlog 内容。
+配置为 `@changesets/cli/changelog` 将使用官方提供的 Changlog 生成规则，将 changeset 信息转换为 changlog 内容。
 
-配置为数组时，第一个参数为自定义 NPM 包或者路径，第二个参数为需要传入的默认参数配置，自定义格式我们将在后续[自定义 Changelog](/guides/topic-detail/changesets/changelog) 章节讲解。
+配置为数组时，第一个参数为自定义 NPM 包或者路径，第二个参数为需要传入的默认参数配置，自定义格式我们将在后续[自定义 changelog](/guides/topic-detail/changesets/changelog) 章节讲解。
 
 ### \_\_\_experimentalUnsafeOptions_WILL_CHANGE_IN_PATCH
 

package/docs/zh/guides/topic-detail/changesets/github.mdx

@@ -6,7 +6,7 @@ sidebar_position: 9
 
 ## BOT
 
-在 Github 上，Changesets 提供了机器人用于检测当前 Pull Request 是否存在 changeset，并提供了 UI 界面添加和修改 changeset。
+在 Github 上，changesets 提供了机器人用于检测当前 Pull Request 是否存在 changeset，并提供了 UI 界面添加和修改 changeset。
 
 ### 安装
 
@@ -46,7 +46,7 @@ sidebar_position: 9
 
 Modern.js 提供了自动创建发版 Pull Request 的 Github Action，提供基于选择的分支自动执行 bump 操作，更新 lock 文件及创建 Pull Request 操作。
 
-### 使用
+#### 使用
 
 在仓库中创建 `.github/workflows/release-pull-request.yml` 文件，填入以下内容：
 
@@ -57,8 +57,15 @@ on:
   workflow_dispatch:
     inputs:
       version:
-        description: 'Release Version(v1.0.0)'
+        type: choice
+        description: 'Release Type(canary, beta, alpha, latest)'
         required: true
+        default: 'latest'
+        options:
+        - canary
+        - beta
+        - alpha
+        - latest
 
 jobs:
   release:
@@ -71,14 +78,17 @@ jobs:
           # This makes Actions fetch only one branch to release
           fetch-depth: 100
 
+      - ... # install dependencies and build repo package
       - name: Create Release Pull Request
-        uses: web-infra-dev/actions@main
+        uses: web-infra-dev/actions@v2
         with:
-          # this expects you to have a script called release which does a build for your packages and calls changeset publish
-          versionNumber: ${{ github.event.inputs.version }}
+          version: ${{ github.event.inputs.version }}
+          versionNumber: 'auto'
           type: 'pull request'
+          tools: 'modern'
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.REPO_SCOPED_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
           REPOSITORY: ${{ github.repository }}
           REF: ${{ github.ref }}
 ```
@@ -87,17 +97,17 @@ jobs:
 
 ![Release Pull Request Action](https://lf3-static.bytednsdoc.com/obj/eden-cn/zq-uylkvT/ljhwZthlaukjlkulzlp/action-pull-request.png)
 
-选择本次发布的分支并填入版本号，版本号格式推荐 v1.0.0，点击 Run workflow 按钮：
+选择本次发布类型，点击 Run workflow 按钮：
 
-![Run Release Pull Request](https://lf3-static.bytednsdoc.com/obj/eden-cn/zq-uylkvT/ljhwZthlaukjlkulzlp/run-pull-request-action.png)
+![Run Release Pull Request](https://lf3-static.bytednsdoc.com/obj/eden-cn/zq-uylkvT/ljhwZthlaukjlkulzlp/action-pull-request.jpeg)
 
 workflow 运行完成后将自动创建 `Release-${version}` 的 Pull Request，自动完成 `bump` changeset 相关版本号并更新 lock 文件，Pull Request 的内容为执行 `gen-release-note` 命令自动生成的 Release Note。
 
-![Release Pull Request](https://lf3-static.bytednsdoc.com/obj/eden-cn/zq-uylkvT/ljhwZthlaukjlkulzlp/release-pull-request.png)
+![Release Pull Request](https://lf3-static.bytednsdoc.com/obj/eden-cn/zq-uylkvT/ljhwZthlaukjlkulzlp/release-pull-request.jpeg)
 
 ### 自动 Release
 
-Modern.js 提供了自动创建发版 Pull Request 的 Github Action，提供基于选择的分支自动执行 release 操作，将包发布到 NPM 上。
+Modern.js 提供了自动发布版本 的 Github Action，提供基于选择的分支自动执行 release 操作，将包发布到 NPM 上。
 
 #### 使用
 
@@ -111,14 +121,14 @@ on:
     inputs:
       version:
         type: choice
-        description: 'Release Version(canary, alpha, pre, latest)'
+        description: 'Release Version(canary, beta, alpha, latest)'
         required: true
-        default: 'canary'
+        default: 'next'
         options:
-          - canary
-          - alpha
-          - pre
-          - latest
+        - canary
+        - beta
+        - alpha
+        - latest
       branch:
         description: 'Release Branch(confirm release branch)'
         required: true
@@ -135,13 +145,14 @@ jobs:
           # This makes Actions fetch only one branch to release
           fetch-depth: 1
 
+      - ... # install dependencies and build repo package
       - name: Release
-        uses: web-infra-dev/actions@main
+        uses: web-infra-dev/actions@v2
         with:
-          # this expects you to have a script called release which does a build for your packages and calls changeset publish
           version: ${{ github.event.inputs.version }}
           branch: ${{ github.event.inputs.branch }}
           type: 'release'
+          tools: 'modern'
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

package/docs/zh/guides/topic-detail/changesets/introduce.mdx

@@ -4,7 +4,7 @@ sidebar_position: 1
 
 # 认识 Changesets
 
-Modern.js 默认集成了 [Changesets](https://github.com/changesets/changesets) 用于模块和 Monorepo 工程方案项目中的包版本管理。
+Modern.js 默认集成了 [changesets](https://github.com/changesets/changesets) 用于模块和 Monorepo 工程方案项目中的包版本管理。
 
 ## 特点
 
@@ -12,15 +12,15 @@ Changesets 具有以下几个特点：
 
 - 在开发时，需要开发者提供本次变更涉及的包名称、升级版本类型(`pathch`、`minor`、`major`)及变更信息，即 changeset。
 
-- 在发布版本时，会根据 changeset 自动升级对应包的版本号，并在对应的包中生成 Changelog 信息。
+- 在发布版本时，会根据 changeset 内容自动升级对应包的版本号，并在对应的包中生成 changelog 信息。
 
 - 在 Monorepo 场景中，changeset 会自动生成仓库依赖图，升级时只会升级变更包及相关依赖包的版本号。
 
 ## 初始化
 
-Modern.js 默认创建的模块和 Monorepo 工程方案项目已经初始化完成 Changesets，在项目根目录会自动创建 `.changeset` 目录，及 `.changeset/config.json` 的配置文件。
+Modern.js 默认创建的模块和 Monorepo 工程方案项目已经初始化完成 changesets，在项目根目录会自动创建 `.changeset` 目录，及 `.changeset/config.json` 的配置文件。
 
-并且，Modern.js 在其对应的工程方案工具 `@modern-js/module-tools` 和 `@modern-js/monorepo-tools` 提供了 Changesets 相应的命令，无需再手动安装 Changesets 相关依赖。
+并且，Modern.js 在其对应的工程方案工具 `@modern-js/module-tools` 和 `@modern-js/monorepo-tools` 提供了 changesets 相应的命令，无需再手动安装 changesets 相关依赖。
 
 Changesets 默认配置如下：
 
@@ -37,7 +37,7 @@ Changesets 默认配置如下：
 }
 ```
 
-配置文件提供了生成 Changesets 的一些基本配置，字段详细介绍请参考后续章节： [Changesets 配置文件](/guides/topic-detail/changesets/config)。
+配置文件提供了生成 changesets 的一些基本配置，字段详细介绍请参考后续章节： [changesets 配置文件](/guides/topic-detail/changesets/config)。
 
 ## 命令