From b74f002e5039b44348c5b4748ca76b538a59e989 Mon Sep 17 00:00:00 2001
From: Tivonsico <173276029+Tivonsico@users.noreply.github.com>
Date: Sun, 11 Oct 2026 00:29:38 +0800
Subject: [PATCH] docs(deploy): preserve runtime configuration on retries

---
 README.md    | 11 +++++++++--
 README_zh.md |  9 +++++++--
 2 files changed, 16 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 373ff112..73811e0e 100644
--- a/README.md
+++ b/README.md
@@ -114,7 +114,6 @@ with the Skill's source and the problem it solves, or submit a PR by following t
 Start the full local stack with:
 
 ```bash
-rm -rf /tmp/skillhub-runtime
 curl -fsSL https://imageless.oss-cn-beijing.aliyuncs.com/runtime.sh | sh -s -- up
 ```
 
@@ -137,7 +136,15 @@ The `--public-url` parameter sets the public access URL for your SkillHub instan
 curl -fsSL https://imageless.oss-cn-beijing.aliyuncs.com/runtime.sh | sh -s -- up --aliyun --public-url https://skillhub.your-company.com --version latest
 ```
 
-If deployment runs into problems, clear the existing runtime home and retry.
+Keep the existing runtime home when rerunning or updating the deployment. The
+runtime script reuses its `.env.release` file; deleting the directory discards
+your custom configuration, including the public URL and generated anonymous
+download cookie secret.
+
+If deployment runs into problems, inspect the `ps` and `logs` lifecycle commands
+printed by the runtime script, then retry `up` with the same runtime home. If you
+intentionally want a fresh configuration, back up `.env.release` before clearing
+the runtime home.
 
 ## SkillHub CLI
 
diff --git a/README_zh.md b/README_zh.md
index 7ba0d3b7..f84bb300 100644
--- a/README_zh.md
+++ b/README_zh.md
@@ -71,7 +71,6 @@ Skill，欢迎分享给 SkillHub 社区，与大家一起丰富开放、实用
 使用以下命令启动完整的本地环境：
 
 ```bash
-rm -rf /tmp/skillhub-runtime
 curl -fsSL https://imageless.oss-cn-beijing.aliyuncs.com/runtime.sh | sh -s -- up
 ```
 
@@ -94,7 +93,13 @@ curl -fsSL https://imageless.oss-cn-beijing.aliyuncs.com/runtime.sh | sh -s -- u
 curl -fsSL https://imageless.oss-cn-beijing.aliyuncs.com/runtime.sh | sh -s -- up --aliyun --public-url https://skillhub.your-company.com --version latest
 ```
 
-如果部署遇到问题，请清除现有的运行时目录并重试。
+重新运行或更新部署时，请保留现有的运行时目录。运行时脚本会复用其中的
+`.env.release` 文件；删除该目录会丢失自定义配置，包括公网访问地址和自动生成的匿名下载
+Cookie 密钥。
+
+如果部署遇到问题，请先使用运行时脚本输出的 `ps` 和 `logs` 生命周期命令检查状态与日志，
+再使用相同的运行时目录重试 `up`。如果确实需要重新生成配置，请在清除运行时目录之前备份
+`.env.release`。
 
 ### 前置要求