fix version 1

README.md

@@ -35,6 +35,16 @@ Linux/macOS：
 
 `pkgs/ecmall` 使用相同的取值规则读取 `pkgs/ecmall/etc/default_<runtime>.yaml`，监听 gRPC `12300` / HTTP `12301`，因此两个聚合入口可以同时启动。
 
+## 本地开发前提
+
+共享能力依赖 `git.apinb.com/bsm-sdk/core`。当前 `go.work` 把它替换为仓库外的相对路径 `../../bsm-sdk/core`（`module/` 下各模块的 `go.mod` 指向同一位置），因此**本地开发必须先将 SDK 检出到固定位置**，两个仓库以固定名字并列：
+
+    <父目录>/
+    ├── bsm-infra/full      # 本仓库，代码根目录
+    └── bsm-sdk/core        # 共享 SDK，必须存在
+
+即 `bsm-sdk/core` 需要在与 `bsm-infra` 同级的位置，解析后对应 `<父目录>/bsm-sdk/core`（相对于本仓库根目录是上一级的同级路径）。缺少该目录时整个工作区都无法解析，单独克隆本仓库也无法构建。`scripts/verify-workspace.sh` 与 `scripts/verify-workspace.ps1` 会在开始校验前检查该目录，缺失时打印中文提示并以非 0 退出。
+
 ## 服务域与模块总览
 
 | 服务域 | 目录 | 服务模块 | 主要职责 | 接入聚合入口 |