docs: fix the skill draft-hash order and stop weaviate gracefully before backup

en/cli/reference/results-errors-and-exit-codes.mdx

@@ -132,7 +132,7 @@ Each sign-in gets 60 requests a minute. On a self-hosted server, set [`OPENAPI_R
 | `skill_version_not_found: …` | `server_error` | Check the version ID with `get skill version`. |
 | `skill_name_conflict: …` on `import skill` | `server_error` | Another skill already has this name.<br/><br/>If that's the skill you meant to update, pass its ID from `get skill` with `--skill-id`. Otherwise, rename yours in its `SKILL.md`. |
 | `skill_name_mismatch: …` on `import skill` | `server_error` | The `name` in your `SKILL.md` doesn't match the name of the skill you passed with `--skill-id`.<br/><br/>Change it back, or leave out `--skill-id` to import the folder as a new skill. |
-| `draft_changed: …` on `import skill` | `server_error` | The skill changed after you read its `draft_hash`, such as an edit to its draft, a publish, or a rename.<br/><br/>Export the current draft and merge its changes into your folder, then import again with the new hash from `describe skill`. Importing your folder as it is would wipe those changes. |
+| `draft_changed: …` on `import skill` | `server_error` | The skill changed after you read its `draft_hash`, such as an edit to its draft, a publish, or a rename.<br/><br/>Run `describe skill` and save the new hash, then export the current draft and merge its changes into your folder. Import with the saved hash. Importing your folder as it is would wipe those changes. |
 | `skill_package_invalid: …` on `import skill` | `server_error` | The folder isn't a valid skill package. For the format, see [Agent Skills](https://agentskills.io/home). |
 | `skill_package_invalid: …` on `publish skill` or `export skill` | `server_error` | The draft's `SKILL.md` frontmatter is invalid. In Dify, fix the field or line the error names. |
 | `request_entity_too_large: …` on `import skill` | `server_error` | The folder has too many files or is too large for your server's [skill package limits](/en/self-host/deploy/configuration/environments#upload_skill_file_size_limit).<br/><br/>Remove files the skill doesn't need, or have your server admin raise the limit the message names. |

en/self-host/deploy/quick-start/docker-compose.mdx

@@ -166,9 +166,11 @@ Run every Compose command below with the deployment's existing project name and
     1. From `dify/docker`, stop the deployment so the databases aren't writing while you copy their files:
 
         ```bash
-        docker compose stop
+        docker compose stop -t -1
         ```
 
+        This can take a while: `-t -1` waits for each service to stop on its own, so Weaviate doesn't lose data.
+
         If you can't stop it, back up the databases with their own dump tools instead.
 
     2. Back up `docker/.env`, your local service `.env` files, any custom Compose files, and persistent data, including `docker/volumes/` and any external databases and storage.

ja/cli/reference/results-errors-and-exit-codes.mdx

@@ -134,7 +134,7 @@ description: difyctl コマンドの出力を読み、実行がどう終わっ
 | `skill_version_not_found: …` | `server_error` | `get skill version` でバージョン ID を確認する。 |
 | `import skill` で `skill_name_conflict: …` が返される | `server_error` | 同じ名前のスキルがすでにある。<br/><br/>そのスキルを更新するつもりだった場合は、`get skill` でそのスキルの ID を確認し、`--skill-id` に指定する。そうでない場合は、自分のスキルの `SKILL.md` で名前を変更する。 |
 | `import skill` で `skill_name_mismatch: …` が返される | `server_error` | `SKILL.md` の `name` が、`--skill-id` で指定したスキルの名前と一致しない。<br/><br/>名前を元に戻すか、`--skill-id` を外してフォルダを新しいスキルとしてインポートする。 |
-| `import skill` で `draft_changed: …` が返される | `server_error` | `draft_hash` を読み取った後に、ドラフトの編集、公開、名前の変更などでスキルが変更された。<br/><br/>現在のドラフトをエクスポートし、その変更をフォルダにマージしてから、`describe skill` で確認した新しいハッシュで再度インポートする。フォルダをそのままインポートすると、それらの変更が失われる。 |
+| `import skill` で `draft_changed: …` が返される | `server_error` | `draft_hash` を読み取った後に、ドラフトの編集、公開、名前の変更などでスキルが変更された。<br/><br/>先に `describe skill` で新しいハッシュを控え、現在のドラフトをエクスポートしてその変更をフォルダにマージする。その後、控えたハッシュで再度インポートする。フォルダをそのままインポートすると、それらの変更が失われる。 |
 | `import skill` で `skill_package_invalid: …` が返される | `server_error` | フォルダが有効なスキルパッケージの形式になっていない。形式は [Agent Skills](https://agentskills.io/home) を参照する。 |
 | `publish skill` または `export skill` で `skill_package_invalid: …` が返される | `server_error` | ドラフトの `SKILL.md` の frontmatter が無効。Dify で、エラーに示されたフィールドまたは行を修正する。 |
 | `import skill` で `request_entity_too_large: …` が返される | `server_error` | フォルダのファイル数またはサイズが、サーバーの [スキルパッケージの上限](/ja/self-host/deploy/configuration/environments#upload_skill_file_size_limit) を超えている。<br/><br/>スキルに不要なファイルを削除するか、メッセージに示された上限を引き上げるようサーバー管理者に依頼する。 |

ja/self-host/deploy/quick-start/docker-compose.mdx

@@ -168,9 +168,11 @@ Dify がすでに稼働している場合は、`docker compose up -d` で新し
     1. ファイルのコピー中にデータベースへの書き込みが発生しないよう、`dify/docker` でデプロイを停止します：
 
         ```bash
-        docker compose stop
+        docker compose stop -t -1
         ```
 
+        停止には時間がかかることがあります。`-t -1` を付けると各サービスが自ら停止するまで待つため、Weaviate のデータが失われません。
+
         停止できない場合は、代わりに各データベース専用のダンプツールでバックアップしてください。
 
     2. `docker/.env`、ローカルのサービス用 `.env` ファイル、カスタム Compose ファイル、永続データをバックアップします。永続データには `docker/volumes/` のほか、外部のデータベースやストレージも含みます。

zh/cli/reference/results-errors-and-exit-codes.mdx

@@ -134,7 +134,7 @@ description: 看懂 difyctl 命令输出的内容，判断一次运行是怎样
 | `skill_version_not_found: …` | `server_error` | 用 `get skill version` 核对版本 ID。 |
 | `import skill` 返回 `skill_name_conflict: …` | `server_error` | 已有其他 Skill 使用这个名称。<br/><br/>如果你要更新的正是那个 Skill，用 `get skill` 查到它的 ID，通过 `--skill-id` 传入。否则，在 `SKILL.md` 中给你的 Skill 改名。 |
 | `import skill` 返回 `skill_name_mismatch: …` | `server_error` | `SKILL.md` 中的 `name` 与 `--skill-id` 所指 Skill 的名称不一致。<br/><br/>把名称改回去，或者去掉 `--skill-id`，将文件夹作为新 Skill 导入。 |
-| `import skill` 返回 `draft_changed: …` | `server_error` | 你读取 `draft_hash` 之后，Skill 又有了改动，例如草稿经过编辑、Skill 已发布或已改名。<br/><br/>先导出当前草稿，把其中的改动合并到你的文件夹，再用 `describe skill` 返回的新哈希值重新导入。如果直接导入现在的文件夹，这些改动会丢失。 |
+| `import skill` 返回 `draft_changed: …` | `server_error` | 你读取 `draft_hash` 之后，Skill 又有了改动，例如草稿经过编辑、Skill 已发布或已改名。<br/><br/>先运行 `describe skill` 记下新的哈希值，再导出当前草稿，把其中的改动合并到你的文件夹，然后用记下的哈希值重新导入。如果直接导入现在的文件夹，这些改动会丢失。 |
 | `import skill` 返回 `skill_package_invalid: …` | `server_error` | 该文件夹不是有效的 Skill 包。格式要求详见 [Agent Skills](https://agentskills.io/home)。 |
 | `publish skill` 或 `export skill` 返回 `skill_package_invalid: …` | `server_error` | 草稿中 `SKILL.md` 的 frontmatter 无效。在 Dify 中修正错误信息指出的字段或行。 |
 | `import skill` 返回 `request_entity_too_large: …` | `server_error` | 文件夹的文件数或体积超出了服务器的 [Skill 包限制](/zh/self-host/deploy/configuration/environments#upload_skill_file_size_limit)。<br/><br/>删除 Skill 用不到的文件，或请服务器管理员调高错误信息中提到的那项限制。 |

zh/self-host/deploy/quick-start/docker-compose.mdx

@@ -168,9 +168,11 @@ docker compose version
     1. 在 `dify/docker` 中停止部署，避免复制数据库文件时数据库仍在写入：
 
         ```bash
-        docker compose stop
+        docker compose stop -t -1
         ```
 
+        这一步可能需要一些时间：`-t -1` 会等待每个服务自行停止，避免 Weaviate 丢失数据。
+
         如果无法停止部署，改用数据库自带的转储工具备份。
 
     2. 备份 `docker/.env`、本地服务 `.env` 文件、自定义 Compose 文件和持久化数据。持久化数据包括 `docker/volumes/`，以及所用的外部数据库和存储。