@deepstorm/cli 0.8.0 → 0.9.0

package/dist/skills/reef-scope/SKILL.md

@@ -71,13 +71,17 @@ bash packages/reef/hooks/reef-scope-split.sh
 
 ## 配置文件
 
-安装后生成 `.deepstorm/scope-config.json`：
+安装后配置写入 `.deepstorm/settings.json` 的 `reef.scope` 字段：
 
 ```json
 {
-  "enabled": true,
-  "ciEnabled": true,
-  "domains": []
+  "reef": {
+    "scope": {
+      "enabled": true,
+      "ciEnabled": true,
+      "domains": []
+    }
+  }
 }
 ```
 
@@ -85,6 +89,8 @@ bash packages/reef/hooks/reef-scope-split.sh
 - `ciEnabled`: CI 门禁开关（独立控制）
 - `domains`: 项目业务领域列表（空 = AI 自由分类，非空 = AI 对齐到这些领域）
 
+> **注意：** 旧版 `.deepstorm/scope-config.json` 已不再使用。如果存在该文件，运行 `deepstorm scope setup` 会自动迁移到 `settings.json`。
+
 ## 使用流程
 
 1. **安装**: 运行一次 `reef-scope-setup.sh install`

package/dist/skills/sweep-init/SKILL.md

@@ -8,7 +8,7 @@ deepstorm:
 
 # Sweep Setup — E2E 测试项目初始化
 
-初始化当前目录为 Sweep E2E 测试项目。根据 DeepStorm setup 阶段选择的 E2E 框架（如 Playwright），创建对应的项目骨架。
+初始化当前目录（或指定子目录）为 Sweep E2E 测试项目。根据 DeepStorm setup 阶段选择的 E2E 框架（如 Playwright），创建对应的项目骨架。
 
 > **注意：** setup 是 flow-create 和 flow-run 的硬性前置条件。如果当前目录未初始化，其他 skill 会报错引导执行 `/sweep-init`。
 
@@ -41,27 +41,79 @@ cat .deepstorm/settings.json 2>/dev/null | grep -o '"e2eFramework"[^,]*' | head
 
 ---
 
+### 步骤 0A：选择生成位置
+
+在执行初始化前，先询问用户的 E2E 测试项目类型，确定文件生成的目标目录。
+
+> **注意：** TARGET_DIR 是后续所有文件操作的前缀，在整个初始化流程中使用。
+
+#### 0A.1 询问项目类型
+
+```
+📂 请问你的 E2E 测试是哪种类型？
+
+  a) 独立项目 → 生成在当前目录
+  b) 与其他项目混放 → 生成到子目录
+```
+
+**如果选择 a（独立项目）：**
+- 设置 TARGET_DIR 为当前目录（`.`）
+- 继续到步骤 1
+
+**如果选择 b（混放项目）：**
+- 进一步询问子目录选择：
+
+```
+  请选择目标子目录：
+  1) e2e/           👈 推荐
+  2) tests/e2e/
+  3) 自定义路径
+```
+
+- 如果选择 3（自定义），AI 询问用户输入路径
+- 验证用户输入的路径：不能为空、不能是绝对路径、不能包含 `..`
+- 设置 TARGET_DIR 为所选路径（如 `"e2e"`、`"tests/e2e"` 等）
+- 如果子目录已存在且非空，输出警告并询问用户是否确认继续
+
+#### 0A.2 记录 TARGET_DIR
+
+`TARGET_DIR` 变量在后续所有步骤中使用。写入 `.deepstorm/settings.json` 中的 `sweep.e2eProjectPath` 字段将在步骤 8 中完成。
+
+---
+
 ### 步骤 1：检查初始化状态
 
-检查当前目录是否存在 `.sweep-init` 标记文件。
+检查当前项目是否已初始化为 E2E 测试项目。从 `.deepstorm/settings.json` 读取 `sweep.e2eProjectPath` 判断。
+
+#### 1.1 检查 settings.json
+
+```bash
+E2E_PATH=$(cat .deepstorm/settings.json 2>/dev/null | grep -o '"e2eProjectPath"[^,]*' | head -1 | cut -d'"' -f4)
+```
 
-#### 1.1 已初始化 → 退出
+#### 1.2 已初始化 → 退出
 
-- **WHEN** `.sweep-init` 文件已存在
-- **THEN** 提示"当前目录已初始化为 Sweep 测试项目。如需重新初始化，请删除 .sweep-init 文件后重试。"并退出
+- **WHEN** `sweep.e2eProjectPath` 已设置（或旧 `.sweep-init` 文件存在）
+- **THEN** 提示"当前项目已初始化为 Sweep 测试项目。如需重新初始化，请删除 `sweep.e2eProjectPath` 配置或 `.sweep-init` 文件后重试。"并退出
 
-#### 1.2 未初始化 → 继续
+#### 1.3 向后兼容：旧 .sweep-init 文件检测
 
-- **WHEN** `.sweep-init` 文件不存在
+- **WHEN** `settings.json` 中 `sweep.e2eProjectPath` 未设置，但 `.sweep-init` 文件存在
+- **THEN** 提示"ℹ️ 检测到旧版 .sweep-init 标记。建议删除该文件后重新运行 /sweep-init 以使用新版配置。"
+- **THEN** 提示已初始化，退出
+
+#### 1.4 未初始化 → 继续
+
+- **WHEN** 以上均不满足
 - **THEN** 继续执行初始化流程
 
 ---
 
 ### 步骤 2：创建项目目录结构
 
-创建 E2E 测试项目的目录骨架。
+在 `{TARGET_DIR}` 下创建 E2E 测试项目的目录骨架。
 
-#### 目录结构
+#### 目录结构（当 TARGET_DIR 为 `"."` 时）
 
 ```
 .
@@ -75,19 +127,27 @@ cat .deepstorm/settings.json 2>/dev/null | grep -o '"e2eFramework"[^,]*' | head
 └── tsconfig.json                # TypeScript 配置
 ```
 
-> 如果框架为 `playwright`，还会额外生成 `playwright.config.ts`。
+> 如果 TARGET_DIR 为 `"e2e"`，以上所有文件在 `e2e/` 下生成。如果框架为 `playwright`，还会额外生成 `playwright.config.ts`。
 
 #### 执行
 
 ```bash
-mkdir -p flows flows/reports scripts
+# 计算目标目录：TARGET_DIR 为 "." 时用当前目录，否则用 TARGET_DIR
+if [ "$TARGET_DIR" != "." ]; then
+  mkdir -p "$TARGET_DIR"/flows "$TARGET_DIR"/flows/reports "$TARGET_DIR"/scripts
+  echo "📂 将在 $TARGET_DIR/ 目录下生成 E2E 测试项目"
+else
+  mkdir -p flows flows/reports scripts
+fi
 ```
 
 ---
 
 ### 步骤 3：生成项目配置文件（框架感知）
 
-根据步骤 0 读取的框架配置，生成对应的配置文件。
+根据步骤 0 读取的框架配置，在 `{TARGET_DIR}` 下生成对应的配置文件。
+
+> 所有文件写入路径以 `{TARGET_DIR}` 为前缀。当 `TARGET_DIR` 为 `"."` 时，路径不变。
 
 #### 3.1 package.json
 
@@ -115,7 +175,7 @@ mkdir -p flows flows/reports scripts
 
 #### 3.2 框架配置文件
 
-**当框架为 `playwright` 时**，写入 `playwright.config.ts`，包含多环境 baseURL 设置：
+**当框架为 `playwright` 时**，写入 `{TARGET_DIR}/playwright.config.ts`，包含多环境 baseURL 设置：
 
 ```ts
 import { defineConfig } from '@playwright/test';
@@ -164,23 +224,43 @@ export default defineConfig({
 3. 生产环境（prod）baseURL
 4. 默认目标环境（test / staging / prod）
 
-#### 4.2 写入 .env
+#### 4.2 写入 settings.json
 
-只写入环境地址配置，不包含 MCP 连接说明（MCP 配置在 `.mcp.json` 中统一管理）：
+将多环境配置写入 `.deepstorm/settings.json` 的 `sweep.environments` 字段。**不再生成 `.env` 文件。**
+
+使用 Bash 和 `jq` 合并写入（或 AI 读取-修改-写回）：
 
 ```bash
-# .env（gitignored，不提交）
-BASE_URL_TEST=http://localhost:3000
-BASE_URL_STAGING=https://staging.example.com
-BASE_URL_PROD=https://prod.example.com
-DEFAULT_ENV=test
+# 先读取现有 settings.json
+SETTINGS=$(cat .deepstorm/settings.json 2>/dev/null || echo "{}")
+
+# 构造 environments 配置并写入
+# （使用 jq 或 AI 逐字段修改）
 ```
 
+写入后的 settings.json 结构示例：
+
+```json
+{
+  "sweep": {
+    "e2eFramework": "playwright",
+    "environments": {
+      "test": { "baseUrl": "http://localhost:3000" },
+      "staging": { "baseUrl": "https://staging.example.com" },
+      "prod": { "baseUrl": "https://prod.example.com" },
+      "default": "test"
+    }
+  }
+}
+```
+
+> **注意：** API Key 等敏感信息仍然放在 `.env` 文件（gitignored）中。此处仅迁移多环境 baseURL 配置。
+
 ---
 
 ### 步骤 5：创建 topology.yaml 初始模板
 
-写入功能模块拓扑文件基础结构：
+写入功能模块拓扑文件基础结构到 `{TARGET_DIR}/flows/topology.yaml`：
 
 ```yaml
 # flows/topology.yaml
@@ -202,7 +282,7 @@ modules:
 
 ### 步骤 6：创建 flow-selector.mjs
 
-使用 Read 读取本 skill 目录下的 `scripts/flow-selector.mjs` 文件，用 Write 写入目标项目的 `scripts/flow-selector.mjs`。
+使用 Read 读取本 skill 目录下的 `scripts/flow-selector.mjs` 文件，用 Write 写入目标项目的 `{TARGET_DIR}/scripts/flow-selector.mjs`。
 
 > **说明：** `flow-selector.mjs` 是基于 `@inquirer/checkbox` 的层级选择工具脚本（供 flow-run skill 调用）。
 > 它与本 SKILL.md 同属一个 skill，作为 skill 的子文件分开维护，避免内联代码块导致的重复。
@@ -236,16 +316,37 @@ cat .mcp.json 2>/dev/null | grep -c "deepstorm-playwright"
 
 ### 步骤 8：完成初始化
 
-#### 8.1 创建初始化标记
+#### 8.1 写入 e2eProjectPath 到 settings.json
+
+将 `sweep.e2eProjectPath` 写入 `.deepstorm/settings.json`。**不再创建 `.sweep-init` 标记文件。**
 
 ```bash
-echo "sweep-e2e-project" > .sweep-init
+# 值由步骤 0A 确定：
+#   独立项目 → "."
+#   混放项目 → 用户选择的路径（如 "e2e"）
+```
+
+写入后的 settings.json 结构示例：
+
+```json
+{
+  "sweep": {
+    "e2eFramework": "playwright",
+    "e2eProjectPath": "e2e",
+    "environments": { ... }
+  }
+}
 ```
 
 #### 8.2 安装依赖
 
 ```bash
-npm install
+# 在目标目录中执行 npm install
+if [ "$TARGET_DIR" != "." ]; then
+  cd "$TARGET_DIR" && npm install
+else
+  npm install
+fi
 ```
 
 #### 8.3 输出完成信息
@@ -254,15 +355,16 @@ npm install
 ✅ Sweep E2E 测试项目初始化完成！
 
 框架：{所选框架}
+位置：{TARGET_DIR}
 
 项目结构：
-  flows/          — 测试意图文档目录
-  flows/reports/  — 执行报告目录
-  scripts/        — 辅助脚本
-  (框架配置文件)  — {框架名} 配置文件
+  {TARGET_DIR}/flows/          — 测试意图文档目录
+  {TARGET_DIR}/flows/reports/  — 执行报告目录
+  {TARGET_DIR}/scripts/        — 辅助脚本
+  (框架配置文件)              — {框架名} 配置文件
 
 下一步：
-  1. 编辑 flows/topology.yaml 添加你的功能模块
+  1. 编辑 {TARGET_DIR}/flows/topology.yaml 添加你的功能模块
   2. 运行 /sweep-plan 创建测试意图文档
   3. 运行 /sweep-run 执行测试流程
 ```
@@ -272,15 +374,16 @@ npm install
 ## 检查清单
 
 - [ ] 已读取框架配置（`deepstorm.sweep.e2eFramework`）
-- [ ] `.sweep-init` 不存在 → 继续
-- [ ] 项目目录结构已创建（flows/、flows/reports/、scripts/）
+- [ ] 步骤 0A：已选择目标目录（`TARGET_DIR` 已确定）
+- [ ] 步骤 1：检查通过（`e2eProjectPath` 未设置，且 `.sweep-init` 不存在）
+- [ ] 项目目录结构已创建（`{TARGET_DIR}/flows/`、`{TARGET_DIR}/flows/reports/`、`{TARGET_DIR}/scripts/`）
 - [ ] package.json 已写入（含对应框架的依赖）
 - [ ] 框架配置文件已生成（如 playwright.config.ts）
 - [ ] tsconfig.json 已写入
 - [ ] 用户已输入三个环境的 baseURL
-- [ ] .env 已写入（gitignored）
+- [ ] environments 已写入 `.deepstorm/settings.json` 的 `sweep.environments`
 - [ ] topology.yaml 初始模板已创建
 - [ ] flow-selector.mjs 已写入
 - [ ] 已确认 MCP 配置状态（从 `.mcp.json` 读取）
-- [ ] .sweep-init 标记文件已创建
-- [ ] npm install 已执行
+- [ ] `sweep.e2eProjectPath` 已写入 `.deepstorm/settings.json`
+- [ ] npm install 已在目标目录执行

package/dist/skills/sweep-plan/SKILL.md.tmpl

@@ -17,7 +17,7 @@ mcpCapabilities:
 
 ## 前置条件
 
-运行 `/sweep-plan` 前，请确保当前目录已通过 `/sweep-init` 初始化（存在 `.sweep-init` 标记文件和 `flows/` 目录）。
+运行 `/sweep-plan` 前，请确保项目已通过 `/sweep-init` 初始化（`.deepstorm/settings.json` 中存在 `sweep.e2eProjectPath` 配置）。
 
 ---
 
@@ -44,10 +44,67 @@ mcpCapabilities:
 
 ## 工作流
 
-### 步骤 1：检查初始化状态
+### 步骤 1：检查初始化状态与路径导航
 
-- **WHEN** `.sweep-init` 不存在
-- **THEN** 提示"当前目录尚未初始化为 Sweep 测试项目。请先运行 /sweep-init 初始化。"并退出
+从 `.deepstorm/settings.json` 读取 `sweep.e2eProjectPath`，确定 E2E 测试项目的位置，如非根目录则自动切换。支持从子目录向上查找以兼容用户在 E2E 项目子目录中执行的情况。
+
+#### 1.1 读取配置（支持向上查找）
+
+```bash
+# 向上查找 .deepstorm/settings.json
+DEEPSTORM_DIR=""
+CUR="$PWD"
+while [ "$CUR" != "/" ]; do
+  if [ -f "$CUR/.deepstorm/settings.json" ]; then
+    DEEPSTORM_DIR="$CUR"
+    break
+  fi
+  CUR=$(dirname "$CUR")
+done
+
+if [ -n "$DEEPSTORM_DIR" ]; then
+  E2E_PATH=$(grep -o '"e2eProjectPath"[^,]*' "$DEEPSTORM_DIR/.deepstorm/settings.json" | head -1 | cut -d'"' -f4)
+else
+  E2E_PATH=""
+fi
+```
+
+#### 1.2 配置存在 → 路径导航
+
+- **WHEN** `E2E_PATH` 不为空
+- **THEN** 判断路径值。注意 `E2E_PATH` 是基于 `DEEPSTORM_DIR`（settings.json 所在目录）的相对路径，若当前在子目录则需拼接：
+  ```bash
+  if [ "$E2E_PATH" != "." ]; then
+    # 若从子目录找到的 settings.json，E2E_PATH 相对于 DEEPSTORM_DIR
+    TARGET_DIR="$E2E_PATH"
+    if [ -n "$DEEPSTORM_DIR" ] && [ "$DEEPSTORM_DIR" != "$PWD" ]; then
+      TARGET_DIR="$DEEPSTORM_DIR/$E2E_PATH"
+    fi
+    if [ -d "$TARGET_DIR" ]; then
+      echo "📂 切换到 E2E 项目目录: $E2E_PATH"
+      cd "$TARGET_DIR"
+    else
+      echo "❌ E2E 项目目录不存在: $E2E_PATH，请重新运行 /sweep-init"
+      exit 1
+    fi
+  fi
+  ```
+
+#### 1.3 配置不存在 → 向后兼容检查
+
+- **WHEN** `E2E_PATH` 为空
+- **THEN** 检查旧 `.sweep-init` 文件是否存在（从当前目录和 DEEPSTORM_DIR 向上查找）：
+  ```bash
+  if [ -f ".sweep-init" ]; then
+    echo "ℹ️ 检测到旧版 .sweep-init 标记。建议运行 /sweep-init 刷新配置。"
+    # 继续执行（兼容旧项目）
+  elif [ -n "$DEEPSTORM_DIR" ] && [ -f "$DEEPSTORM_DIR/.sweep-init" ]; then
+    echo "ℹ️ 检测到旧版 .sweep-init 标记（项目根: $DEEPSTORM_DIR）。建议运行 /sweep-init 刷新配置。"
+  else
+    echo "❌ 未检测到 E2E 项目。请先运行 /sweep-init 初始化。"
+    exit 1
+  fi
+  ```
 
 ### 步骤 2：获取测试需求上下文（MCP 动态适配）
 
@@ -303,7 +360,7 @@ node scripts/spec-compiler.mjs flows/user-system/login/login.flow.md
 
 ## 检查清单
 
-- [ ] 项目已初始化（检查 .sweep-init）
+- [ ] 项目已初始化（读取 settings.json → sweep.e2eProjectPath）
 - [ ] 获取到测试需求上下文（Issue / PRD / 描述）
 - [ ] 确定放置模块位置（topology.yaml）
 - [ ] 确定文件名

package/dist/skills/sweep-run/SKILL.md

@@ -58,10 +58,65 @@ node scripts/env-manager.mjs --framework
 
 ---
 
-### 步骤 1：检查初始化状态
+### 步骤 1：检查初始化状态与路径导航
 
-- **WHEN** `.sweep-init` 不存在
-- **THEN** 提示"当前目录尚未初始化为 Sweep 测试项目。请先运行 /sweep-init 初始化。"并退出
+从 `.deepstorm/settings.json` 读取 `sweep.e2eProjectPath`，确定 E2E 测试项目的位置，如非根目录则自动切换。支持从子目录向上查找以兼容用户在 E2E 项目子目录中执行的情况。
+
+```bash
+# 向上查找 .deepstorm/settings.json
+DEEPSTORM_DIR=""
+CUR="$PWD"
+while [ "$CUR" != "/" ]; do
+  if [ -f "$CUR/.deepstorm/settings.json" ]; then
+    DEEPSTORM_DIR="$CUR"
+    break
+  fi
+  CUR=$(dirname "$CUR")
+done
+
+if [ -n "$DEEPSTORM_DIR" ]; then
+  E2E_PATH=$(grep -o '"e2eProjectPath"[^,]*' "$DEEPSTORM_DIR/.deepstorm/settings.json" | head -1 | cut -d'"' -f4)
+else
+  E2E_PATH=""
+fi
+```
+
+#### 1.1 配置存在 → 路径导航
+
+- **WHEN** `E2E_PATH` 不为空
+- **THEN** 判断路径值。注意 `E2E_PATH` 是基于 `DEEPSTORM_DIR`（settings.json 所在目录）的相对路径，若当前在子目录则需拼接：
+  ```bash
+  if [ "$E2E_PATH" != "." ]; then
+    # 若从子目录找到的 settings.json，E2E_PATH 相对于 DEEPSTORM_DIR
+    TARGET_DIR="$E2E_PATH"
+    if [ -n "$DEEPSTORM_DIR" ] && [ "$DEEPSTORM_DIR" != "$PWD" ]; then
+      TARGET_DIR="$DEEPSTORM_DIR/$E2E_PATH"
+    fi
+    if [ -d "$TARGET_DIR" ]; then
+      echo "📂 切换到 E2E 项目目录: $E2E_PATH"
+      cd "$TARGET_DIR"
+    else
+      echo "❌ E2E 项目目录不存在: $E2E_PATH，请重新运行 /sweep-init"
+      exit 1
+    fi
+  fi
+  ```
+
+#### 1.2 配置不存在 → 向后兼容检查
+
+- **WHEN** `E2E_PATH` 为空
+- **THEN** 检查旧 `.sweep-init` 文件是否存在（从当前目录和 DEEPSTORM_DIR 向上查找）：
+  ```bash
+  if [ -f ".sweep-init" ]; then
+    echo "ℹ️ 检测到旧版 .sweep-init 标记。建议运行 /sweep-init 刷新配置。"
+    # 继续执行（兼容旧项目）
+  elif [ -n "$DEEPSTORM_DIR" ] && [ -f "$DEEPSTORM_DIR/.sweep-init" ]; then
+    echo "ℹ️ 检测到旧版 .sweep-init 标记（项目根: $DEEPSTORM_DIR）。建议运行 /sweep-init 刷新配置。"
+  else
+    echo "❌ 未检测到 E2E 项目。请先运行 /sweep-init 初始化。"
+    exit 1
+  fi
+  ```
 
 ---
 
@@ -162,9 +217,9 @@ node scripts/env-manager.mjs --env staging
 ]}
 ```
 
-- `--env staging` → 从 `.env` 读 `BASE_URL_STAGING`
-- `--env test` → 从 `.env` 读 `BASE_URL_TEST`
-- 不传参 → 使用 `.env` 中的 `DEFAULT_ENV`，未设置则默认 `test`
+- `--env staging` → 从 `settings.json` 的 `sweep.environments.staging` 读取（回退到 `.env`）
+- `--env test` → 从 `settings.json` 的 `sweep.environments.test` 读取（回退到 `.env`）
+- 不传参 → 使用 `settings.json` 的 `sweep.environments.default`（回退到 `.env` 的 `DEFAULT_ENV`），未设置则默认 `test`
 
 #### 4.2 设置环境变量
 
@@ -426,7 +481,7 @@ Flow: L01 - 正常登录成功
 ## 检查清单
 
 - [ ] 前置检查：框架配置已读取（`.deepstorm/settings.json` → `sweep.e2eFramework`）
-- [ ] 项目已初始化（`.sweep-init` 存在）
+- [ ] 项目已初始化（读取 settings.json → sweep.e2eProjectPath）
 - [ ] 执行范围已确定（--all / --path / 交互选择）
 - [ ] 执行模式已选择（hybrid / native / no-parallel / browser）
 - [ ] MCP 服务按模式正确启动（available → headless / headed / 不启动）

package/dist/skills/sweep-run/scripts/env-manager.mjs

@@ -27,6 +27,65 @@ function getEnvPath() {
 function getMcpPath() {
   return resolve(process.cwd(), '.mcp.json');
 }
+function getDeepstormSettingsPath() {
+  return resolve(process.cwd(), '.deepstorm', 'settings.json');
+}
+
+// ── settings.json reading ─────────────────────────────────────────
+
+/**
+ * Read .deepstorm/settings.json and extract environments config.
+ * Returns the sweep.environments object or null if not configured.
+ */
+export function readDeepstormEnvironments() {
+  const settingsPath = getDeepstormSettingsPath();
+  if (!existsSync(settingsPath)) return null;
+  try {
+    const content = readFileSync(settingsPath, 'utf-8');
+    const config = JSON.parse(content);
+    return config.sweep?.environments || null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Read .deepstorm/settings.json and extract e2eProjectPath.
+ * Returns the project path string or null if not configured.
+ */
+export function readE2eProjectPath() {
+  const settingsPath = getDeepstormSettingsPath();
+  if (!existsSync(settingsPath)) return null;
+  try {
+    const content = readFileSync(settingsPath, 'utf-8');
+    const config = JSON.parse(content);
+    return config.sweep?.e2eProjectPath || null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Convert settings.json environments format to the same structure
+ * that listEnvs() returns from .env, for a unified return format.
+ *
+ * Input:  { test: { baseUrl: "..." }, staging: { baseUrl: "..." }, default: "test" }
+ * Output: { envMap: { BASE_URL_TEST: "...", BASE_URL_STAGING: "...", DEFAULT_ENV: "test" },
+ *           defaultEnv: "test" }
+ */
+function deepstormEnvsToEnvMap(envs) {
+  if (!envs) return { envMap: {}, defaultEnv: 'test' };
+  const envMap = {};
+  const defaultEnv = envs.default || 'test';
+  for (const [name, config] of Object.entries(envs)) {
+    if (name === 'default') continue;
+    if (config && config.baseUrl) {
+      envMap[`BASE_URL_${name.toUpperCase()}`] = config.baseUrl;
+    }
+  }
+  envMap.DEFAULT_ENV = defaultEnv;
+  return { envMap, defaultEnv };
+}
 
 // ── .env parsing ──────────────────────────────────────────────────
 
@@ -68,17 +127,40 @@ export function readDotEnv() {
 
 /**
  * Get the default environment name.
+ * Priority: settings.json > .env
  * Falls back to 'test' if not configured.
  */
 export function getDefaultEnv(envMap) {
+  const dsEnvs = readDeepstormEnvironments();
+  if (dsEnvs && dsEnvs.default) {
+    return dsEnvs.default;
+  }
   return envMap.DEFAULT_ENV || 'test';
 }
 
 /**
- * List all available environments from .env.
+ * List all available environments.
+ * Priority: settings.json > .env
  * Detects BASE_URL_{ENV} patterns and returns their names.
  */
 export function listEnvs(envMap) {
+  const dsEnvs = readDeepstormEnvironments();
+  if (dsEnvs) {
+    const envs = [];
+    for (const [name, config] of Object.entries(dsEnvs)) {
+      if (name === 'default') continue;
+      if (config && config.baseUrl) {
+        envs.push({
+          name: name.toLowerCase(),
+          key: `BASE_URL_${name.toUpperCase()}`,
+          url: config.baseUrl,
+        });
+      }
+    }
+    return envs;
+  }
+
+  // Fallback to .env-based envMap
   const envs = [];
   for (const key of Object.keys(envMap)) {
     const match = key.match(/^BASE_URL_(.+)$/);
@@ -96,13 +178,27 @@ export function listEnvs(envMap) {
 /**
  * Resolve target environment config.
  *
+ * Priority: settings.json > .env
+ *
  * @param {string} [envName] - Target environment name (e.g. 'staging', 'test')
  * @returns {{ env: string, baseUrl: string|null, availableEnvs: Array<{name:string,url:string}> }}
  *
- * If envName is omitted, uses DEFAULT_ENV from .env (or 'test').
+ * If envName is omitted, uses DEFAULT_ENV (or 'test').
  * If the environment is not found, baseUrl is null and availableEnvs lists alternatives.
  */
 export function resolveEnv(envName) {
+  // Try settings.json first
+  const dsEnvs = readDeepstormEnvironments();
+  if (dsEnvs) {
+    const { envMap, defaultEnv } = deepstormEnvsToEnvMap(dsEnvs);
+    const name = envName || defaultEnv;
+    const availableEnvs = listEnvs(envMap);
+    const baseUrlKey = `BASE_URL_${name.toUpperCase()}`;
+    const baseUrl = envMap[baseUrlKey] || null;
+    return { env: name, baseUrl, availableEnvs };
+  }
+
+  // Fallback to .env
   const envMap = readDotEnv();
   const name = envName || getDefaultEnv(envMap);
   const availableEnvs = listEnvs(envMap);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepstorm/cli",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "DeepStorm CLI — 一键配置项目开发环境",
   "license": "MIT",
   "author": "billkang",
@@ -16,7 +16,7 @@
     "dotenv": "^17.4.2",
     "handlebars": "^4.7.8",
     "js-yaml": "^4.1.0",
-    "@deepstorm/pilot": "^0.8.0"
+    "@deepstorm/pilot": "^0.9.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",