From c982753eb8d9e938269bf4fccde68700e10c23ef Mon Sep 17 00:00:00 2001
From: Maofeng <hornjs@qq.com>
Date: Wed, 29 Jul 2026 20:26:57 +0800
Subject: [PATCH] docs: clarify live WIT dependency updates

Recommend unlocked development mode when editing local WIT replacements, while retaining --locked for source-only work that must preserve the existing contract graph.
---
 README.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 61ee4d1..75597e2 100644
--- a/README.md
+++ b/README.md
@@ -62,7 +62,7 @@ Console 启动后，使用开发模式监听组件源码和本地 WIT `replace`
 
 ```bash
 cargo run -p wasmeld-package --bin wasmeld -- \
-  dev components/echo/Cargo.toml --locked
+  dev components/echo/Cargo.toml
 ```
 
 首次构建和每次源码变化都会自动完成 WIT 同步、Debug 编译、打包、注册和 Deployment
@@ -72,7 +72,8 @@ cargo run -p wasmeld-package --bin wasmeld -- \
 
 管理面每 5 秒刷新一次，可以直接在调用面板预览新版本。只构建并部署一次可使用
 `--once`；其它选项包括 `--id`、`--console`、`--release` 和 `--poll-ms`。管理 API
-地址也可通过 `WASMELD_CONSOLE` 设置。
+地址也可通过 `WASMELD_CONSOLE` 设置。默认允许本地 `replace` 更新 `wit.lock`；若开发
+期间不允许 WIT 契约发生变化，再添加 `--locked`。
 
 构建组件：