lcap-frontend-library 0.0.1

package/packages/lcap-frontend-library/references/nasl-logic-authoring/SKILL.md

@@ -0,0 +1,201 @@
+---
+name: nasl-logic-authoring
+description: >-
+  Authors dependency-library logic for LCAP/NASL using @nasl/types, JSDoc
+  @NaslLogic metadata, generics, rest parameters, and higher-order function
+  signatures; entry at logics/index.ts. Use when writing or refactoring
+  NaslLogic, logics/index.ts, nasl.collection types, dependency library TS, or
+  platform-exposed functions.
+---
+
+# NASL 依赖库逻辑编写规范
+
+## When to apply
+
+编写或改造 **依赖库逻辑**、需接入平台的 **`@NaslLogic`** 函数、使用 **`nasl.*` 类型**、**可变参数 / 泛型 / 函数类型入参** 时遵循本文。
+
+## 代码位置
+
+- **逻辑目录入口**：`logics/index.ts`（在此集中导出需接入平台的逻辑，或 `export * from './xxx'` 聚合子模块）。
+- 具体实现可拆到 `logics/` 下其他文件，但**对外暴露给平台的导出**应与 `logics/index.ts` 的约定一致（以项目规范为准）。
+
+## 环境要求（可变参数、泛型、高阶函数相关能力）
+
+- IDE **≥ 3.8**
+- Node **≥ 18**
+- lcap **> 0.4.x**
+
+## Instructions（Agent 必须遵守）
+
+1. **路径**：新增或调整对外逻辑时，以 **`logics/index.ts`** 为入口，与仓库既有 `logics/` 结构保持一致。
+2. 文件顶部 **`import '@nasl/types';`**，参数与返回值用 **`nasl` 命名空间类型** 声明，勿随意用原生 `any` 替代平台语义类型。
+3. 每个需接入平台的导出函数使用 **`/** @NaslLogic ... */`** JSDoc；其余注解用于 IDE/文档展示，与平台绑定一致。
+4. **可变参数**：仅允许**一个** rest，且**必须在参数列表最后**；语义上对应列表，类型多用 `nasl.collection.List<...>`。
+5. **泛型**：`@typeParam` 与 TS 泛型一致；可与可变参数、函数类型参数组合。
+6. **高阶函数**：回调/映射函数类型写在参数或返回值上，并在 `@param` / `@returns` 中说明含义。
+
+---
+
+## JSDoc：`@NaslLogic` 与常用标签
+
+| 标签 | 作用 |
+|------|------|
+| `@NaslLogic` | 声明该函数需接入平台（必填） |
+| `@type` | 绑定端，如 `pc` / `h5` / `both` |
+| `@title` | 逻辑标题（展示用） |
+| `@description` / `@desc` | 逻辑描述；**优先使用 `@description`**，与历史文档 `@desc` 等价时统一一种即可 |
+| `@typeParam` | 泛型形参说明 |
+| `@param` | 参数说明；**写了参数名则按名称与形参匹配**，否则按**参数顺序（index）**匹配 |
+| `@returns` | 返回值说明 |
+
+---
+
+## 基础示例
+
+### 泛型：过滤列表中的空值
+
+```typescript
+import '@nasl/types';
+
+/**
+ * @NaslLogic
+ * @title 过滤列表
+ * @description 过滤列表中的 null / 假值
+ * @typeParam T 元素类型
+ * @param list 列表
+ * @returns 过滤后的列表
+ */
+export function filterNull<T>(list: nasl.collection.List<T>): nasl.collection.List<T> {
+  return list.filter((n) => !!n);
+}
+```
+
+### 异步：并发执行若干任务
+
+```typescript
+import '@nasl/types';
+
+/**
+ * @NaslLogic
+ * @title 并发执行异步任务
+ * @description 按并发上限分批执行无参任务函数，收集结果
+ * @param count 最大并发数
+ * @param taskList 任务函数列表
+ * @returns 各任务返回值按完成批次展开后的列表
+ */
+export async function asyncExecuteTask(
+  count: nasl.core.Integer,
+  taskList: nasl.collection.List<() => nasl.core.Any>
+): Promise<nasl.collection.List<nasl.core.Any>> {
+  const asyncTaskCount = count || 5;
+  let waitExecuteTasks = [...taskList];
+  const results: nasl.collection.List<nasl.core.Any> = [];
+
+  while (waitExecuteTasks.length > 0) {
+    const executeTasks =
+      waitExecuteTasks.length > asyncTaskCount
+        ? waitExecuteTasks.slice(0, asyncTaskCount)
+        : waitExecuteTasks;
+
+    const batch = await Promise.all(executeTasks.map((fn) => Promise.resolve(fn())));
+    results.push(...batch);
+    waitExecuteTasks = waitExecuteTasks.slice(executeTasks.length);
+  }
+
+  return results;
+}
+```
+
+> 若平台侧需「可变参数」形式传入多个任务函数，可将 `taskList` 改为 rest（见下节），并与 IDE 的「添加可变参数」配合使用。
+
+---
+
+## 可变参数（rest）
+
+- **本质**：在 NASL/TS 侧按**列表**处理；IDE 中可通过 **「添加可变参数」** 逐个追加实参。
+- **规则**：
+  - 可变参数**只能出现一次**；
+  - 必须位于**最后一个**形参；
+  - 可与泛型、高阶函数类型组合。
+
+**示例：字符串拼接**
+
+```typescript
+import '@nasl/types';
+
+/**
+ * @NaslLogic
+ * @title 字符串拼接
+ * @description 可变参数示例：拼接多个字符串
+ * @param str 参与拼接的字符串（可变）
+ * @returns 拼接结果
+ */
+export function concatenateStrings(
+  ...args: nasl.collection.List<nasl.core.String>
+): nasl.core.String {
+  return args.join('');
+}
+```
+
+**反例（不合法）**：两个 rest 或 rest 不在最后。
+
+```typescript
+// 不合法：两个可变参数
+export function bad(
+  ...a: nasl.collection.List<nasl.core.String>,
+  ...b: nasl.collection.List<nasl.core.Integer>
+): nasl.core.String {
+  return '';
+}
+```
+
+---
+
+## 泛型
+
+- 入参、返回值可使用同一泛型形参，便于在 IDE 中选择具体数据结构（如 `List` 元素类型）。
+- 与 **可变参数**、**函数类型** 可组合使用；为每个泛型写清 `@typeParam`。
+
+（示例见上文 `filterNull<T>`。）
+
+---
+
+## 高阶函数（函数类型入参 / 返回值）
+
+- 将 **回调、映射、谓词** 等声明为函数类型参数（或返回函数），与普通 `@param` 一样写说明，便于平台生成连线与文档。
+- 可与泛型、可变参数组合；注意 rest 仍须在最后。
+
+**示例：列表映射**
+
+```typescript
+import '@nasl/types';
+
+/**
+ * @NaslLogic
+ * @title 列表映射
+ * @description 对列表中每个元素应用映射函数
+ * @typeParam T 源元素类型
+ * @typeParam U 目标元素类型
+ * @param list 源列表
+ * @param mapper 将 T 转为 U 的函数
+ * @returns 新列表
+ */
+export function mapList<T, U>(
+  list: nasl.collection.List<T>,
+  mapper: (item: T) => U
+): nasl.collection.List<U> {
+  return list.map(mapper);
+}
+```
+
+---
+
+## 自检清单
+
+- [ ] 对外逻辑已从 **`logics/index.ts`**（或经其 re-export）暴露
+- [ ] 已 `import '@nasl/types'`
+- [ ] 公开给平台的函数带 `@NaslLogic` 及 `@title`、参数/返回值说明
+- [ ] 类型以 `nasl.*` 为主，与平台数据结构一致
+- [ ] 使用可变参数时：仅一处 rest，且在最后
+- [ ] 泛型已用 `@typeParam` 说明
+- [ ] 函数类型参数在 `@param` 中描述清用途

package/packages/lcap-frontend-library/scripts/bash/create-component-files.sh

@@ -0,0 +1,95 @@
+#!/usr/bin/env bash
+# 创建组件文件
+# 用法: create-component-files.sh --library-dir <库根> --name <组件名> --title <中文名> [--type pc|h5|both]
+
+set -e
+
+LIBRARY_DIR=""
+NAME=""
+TITLE=""
+TYPE="pc"
+
+usage() {
+  echo "用法: $0 --library-dir <库根绝对路径> --name <组件名> --title <中文名> [--type pc|h5|both]" >&2
+  echo "组件名仅允许小写字母与下划线" >&2
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --library-dir)
+      LIBRARY_DIR="$2"
+      shift 2
+      ;;
+    --name)
+      NAME="$2"
+      shift 2
+      ;;
+    --title)
+      TITLE="$2"
+      shift 2
+      ;;
+    --type)
+      TYPE="$2"
+      shift 2
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "错误：未知参数 $1" >&2
+      usage
+      exit 1
+      ;;
+  esac
+done
+
+if [ -z "$LIBRARY_DIR" ] || [ -z "$NAME" ] || [ -z "$TITLE" ]; then
+  echo "错误：缺少 --library-dir、--name 或 --title" >&2
+  usage
+  exit 1
+fi
+
+if ! [[ "$NAME" =~ ^[a-z_]+$ ]]; then
+  echo "错误：组件名仅允许小写字母与下划线，当前值: $NAME" >&2
+  exit 1
+fi
+
+case "$TYPE" in
+  pc|h5|both) ;;
+  *)
+    echo "错误：--type 必须为 pc、h5 或 both，当前值: $TYPE" >&2
+    exit 1
+    ;;
+esac
+
+if [ ! -d "$LIBRARY_DIR" ]; then
+  echo "错误：库目录不存在: $LIBRARY_DIR" >&2
+  exit 1
+fi
+
+LIBRARY_DIR="$(cd "$LIBRARY_DIR" && pwd)"
+
+if [ ! -f "$LIBRARY_DIR/package.json" ]; then
+  echo "错误：未找到 package.json: $LIBRARY_DIR/package.json" >&2
+  exit 1
+fi
+
+if ! (cd "$LIBRARY_DIR" && node -e "
+  const fs = require('fs');
+  const p = JSON.parse(fs.readFileSync('package.json', 'utf8'));
+  const deps = { ...p.dependencies, ...p.devDependencies };
+  process.exit(deps['@lcap/builder'] ? 0 : 1);
+"); then
+  echo "错误：package.json 中未找到 @lcap/builder" >&2
+  exit 1
+fi
+
+if [ ! -d "$LIBRARY_DIR/node_modules/@lcap/builder" ]; then
+  echo "错误：未安装依赖，请执行: npm install --prefix \"$LIBRARY_DIR\"" >&2
+  exit 1
+fi
+
+prompt_json="$(node -e "console.log(JSON.stringify({ name: process.argv[1], title: process.argv[2], type: process.argv[3] }))" "$NAME" "$TITLE" "$TYPE")"
+
+(cd "$LIBRARY_DIR" && npx lcap-scripts create --component --prompt "$prompt_json")

package/packages/lcap-frontend-library/scripts/bash/create-extension-project.sh

@@ -0,0 +1,109 @@
+#!/usr/bin/env bash
+# 创建扩展依赖库工程
+# 用法: create-extension-project.sh --name <库名> --title <中文标题> --target-dir <放置目录> [--template vue3|vue2]
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+NAME=""
+TITLE=""
+TARGET_DIR=""
+TEMPLATE="vue3"
+
+usage() {
+  echo "用法: $0 --name <库名> --title <中文标题> --target-dir <放置目录> [--template vue3|vue2]" >&2
+  echo "库名仅允许小写字母与下划线" >&2
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --name)
+      NAME="$2"
+      shift 2
+      ;;
+    --title)
+      TITLE="$2"
+      shift 2
+      ;;
+    --target-dir)
+      TARGET_DIR="$2"
+      shift 2
+      ;;
+    --template)
+      TEMPLATE="$2"
+      shift 2
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "错误：未知参数 $1" >&2
+      usage
+      exit 1
+      ;;
+  esac
+done
+
+if [ -z "$NAME" ] || [ -z "$TITLE" ]; then
+  echo "错误：缺少 --name 或 --title" >&2
+  usage
+  exit 1
+fi
+
+if [ -z "$TARGET_DIR" ]; then
+  echo "错误：缺少 --target-dir 参数" >&2
+  usage
+  exit 1
+fi
+
+if ! [[ "$NAME" =~ ^[a-z_]+$ ]]; then
+  echo "错误：库名仅允许小写字母与下划线，当前值: $NAME" >&2
+  exit 1
+fi
+
+case "$TEMPLATE" in
+  vue2|vue3) ;;
+  react)
+    echo "错误：暂不支持 react 建库，请使用 --template vue2 或 vue3" >&2
+    exit 1
+    ;;
+  *)
+    echo "错误：--template 必须为 vue2 或 vue3，当前值: $TEMPLATE" >&2
+    exit 1
+    ;;
+esac
+
+mkdir -p "$TARGET_DIR"
+TARGET_DIR_ABS="$(cd "$TARGET_DIR" && pwd)"
+
+prompt_json="$(node -e "
+  console.log(JSON.stringify({
+    packageName: process.argv[1],
+    title: process.argv[2],
+    template: process.argv[3],
+  }));
+" "$NAME" "$TITLE" "$TEMPLATE")"
+
+(
+  cd "$TARGET_DIR_ABS"
+  npm create lcap-extension@latest -- --name "$NAME" --prompt "$prompt_json"
+)
+
+LIBRARY_DIR="$TARGET_DIR_ABS/$NAME"
+if [ ! -f "$LIBRARY_DIR/package.json" ]; then
+  echo "错误：未找到新建工程：$LIBRARY_DIR/package.json" >&2
+  exit 1
+fi
+
+SETUP_JS="${SCRIPT_DIR}/../node/setup-extension-project.mjs"
+if [ ! -f "$SETUP_JS" ]; then
+  echo "错误：未找到 setup-extension-project.mjs：$SETUP_JS" >&2
+  exit 1
+fi
+
+node "$SETUP_JS" "$LIBRARY_DIR"
+
+echo "libraryDir=$LIBRARY_DIR"
+echo "template=$TEMPLATE"

package/packages/lcap-frontend-library/scripts/bash/create-logic-files.sh

@@ -0,0 +1,149 @@
+#!/usr/bin/env bash
+# 创建逻辑函数文件
+# 用法: create-logic-files.sh --library-dir <库根> --name <函数名 snake_case> --title <逻辑中文标题> [--type pc|h5|both]
+
+set -e
+
+LIBRARY_DIR=""
+NAME=""
+TITLE=""
+TYPE="pc"
+
+usage() {
+  echo "用法: $0 --library-dir <库根> --name <函数名 snake_case> --title <逻辑中文标题> [--type pc|h5|both]" >&2
+  echo "函数名仅允许小写字母与下划线" >&2
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --library-dir)
+      LIBRARY_DIR="$2"
+      shift 2
+      ;;
+    --name)
+      NAME="$2"
+      shift 2
+      ;;
+    --title)
+      TITLE="$2"
+      shift 2
+      ;;
+    --type)
+      TYPE="$2"
+      shift 2
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "错误：未知参数 $1" >&2
+      usage
+      exit 1
+      ;;
+  esac
+done
+
+if [ -z "$LIBRARY_DIR" ] || [ -z "$NAME" ] || [ -z "$TITLE" ]; then
+  echo "错误：缺少 --library-dir、--name 或 --title" >&2
+  usage
+  exit 1
+fi
+
+if ! [[ "$NAME" =~ ^[a-z_]+$ ]]; then
+  echo "错误：函数名仅允许小写字母与下划线，当前值: $NAME" >&2
+  exit 1
+fi
+
+case "$TYPE" in
+  pc|h5|both) ;;
+  *)
+    echo "错误：--type 必须为 pc、h5 或 both，当前值: $TYPE" >&2
+    exit 1
+    ;;
+esac
+
+if [ ! -d "$LIBRARY_DIR" ]; then
+  echo "错误：库目录不存在: $LIBRARY_DIR" >&2
+  exit 1
+fi
+
+LIBRARY_DIR="$(cd "$LIBRARY_DIR" && pwd)"
+
+if [ ! -f "$LIBRARY_DIR/package.json" ]; then
+  echo "错误：未找到 package.json: $LIBRARY_DIR/package.json" >&2
+  exit 1
+fi
+
+if ! (cd "$LIBRARY_DIR" && node -e "
+  const fs = require('fs');
+  const p = JSON.parse(fs.readFileSync('package.json', 'utf8'));
+  const deps = { ...p.dependencies, ...p.devDependencies };
+  process.exit(deps['@lcap/builder'] ? 0 : 1);
+"); then
+  echo "错误：package.json 中未找到 @lcap/builder" >&2
+  exit 1
+fi
+
+if [ ! -d "$LIBRARY_DIR/node_modules/@lcap/builder" ]; then
+  echo "错误：未安装依赖，请执行: npm install --prefix \"$LIBRARY_DIR\"" >&2
+  exit 1
+fi
+
+CAMEL_NAME=$(node -e "
+  const name = process.argv[1];
+  const camel = name.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+  console.log(camel);
+" "$NAME")
+
+LOGIC_DIR="$LIBRARY_DIR/src/logics"
+LOGIC_FILE="$LOGIC_DIR/$NAME.ts"
+INDEX_FILE="$LOGIC_DIR/index.ts"
+TEST_FILE="$LOGIC_DIR/__tests__/$NAME.spec.ts"
+
+if [ -f "$LOGIC_FILE" ]; then
+  echo "错误：逻辑文件已存在: $LOGIC_FILE" >&2
+  exit 1
+fi
+
+mkdir -p "$LOGIC_DIR"
+mkdir -p "$LOGIC_DIR/__tests__"
+
+cat > "$LOGIC_FILE" <<EOF
+import '@nasl/types';
+
+/**
+ * @NaslLogic
+ * @title $TITLE
+ * @description TODO
+ * @type $TYPE
+ */
+export function $CAMEL_NAME() {
+  // TODO
+}
+EOF
+
+if [ ! -f "$INDEX_FILE" ]; then
+  touch "$INDEX_FILE"
+fi
+
+EXPORT_LINE="export { $CAMEL_NAME } from './$NAME';"
+if ! grep -qF "$EXPORT_LINE" "$INDEX_FILE" 2>/dev/null; then
+  echo "$EXPORT_LINE" >> "$INDEX_FILE"
+fi
+
+cat > "$TEST_FILE" <<EOF
+import { describe, it } from 'vitest';
+import { $CAMEL_NAME } from '../$NAME';
+
+describe('$CAMEL_NAME', () => {
+  it('TODO', () => {
+    // TODO
+  });
+});
+EOF
+
+echo "已创建逻辑文件:"
+echo "  $LOGIC_FILE"
+echo "  $INDEX_FILE (已追加导出)"
+echo "  $TEST_FILE"

package/packages/lcap-frontend-library/scripts/bash/create-spec.sh

@@ -0,0 +1,109 @@
+#!/usr/bin/env bash
+# 创建规范需求目录（Spec Driven Development）
+# 用法:
+#   普通: bash create-spec.sh --short-name "name"
+#   供 speckit.specify 调用: bash create-spec.sh --json --short-name "name"
+# 注意：必须在 LCAP 扩展工程目录内执行（即 cwd 为工程根目录），specs 将创建在 cwd/specs/ 下
+# 目录名称: kebab-case，2-4 个英文词，例如 my-feature、user-auth-api
+
+set -e
+
+# 解析参数
+JSON_MODE=false
+SHORT_NAME=""
+SPECS_DIR_ARG=""
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --json)
+      JSON_MODE=true
+      shift
+      ;;
+    --short-name)
+      SHORT_NAME="$2"
+      shift 2
+      ;;
+    --specs-dir)
+      SPECS_DIR_ARG="$2"
+      shift 2
+      ;;
+    -ShortName)
+      # PowerShell 风格
+      SHORT_NAME="$2"
+      shift 2
+      ;;
+    *)
+      if [ "$JSON_MODE" = false ] && [ -z "$SHORT_NAME" ] && [[ "$1" != --* ]]; then
+        SHORT_NAME="$1"
+      fi
+      shift
+      ;;
+  esac
+done
+
+current_dir=$(pwd)
+
+# 确认当前工作目录为 LCAP 扩展工程（与 create-component-files.sh 一致）
+if [ ! -f package.json ]; then
+  echo "错误：当前目录下没有 package.json，请先 cd 到 LCAP 扩展工程目录再执行本脚本。" >&2
+  echo "当前目录: $current_dir" >&2
+  exit 1
+fi
+
+if ! node -e "
+  const fs = require('fs');
+  const p = JSON.parse(fs.readFileSync('package.json', 'utf8'));
+  const deps = { ...p.dependencies, ...p.devDependencies };
+  process.exit(deps['@lcap/builder'] ? 0 : 1);
+" 2>/dev/null; then
+  echo "错误：package.json 中未找到 @lcap/builder 依赖，请确认当前目录为 LCAP 扩展组件工程。" >&2
+  echo "当前目录: $current_dir" >&2
+  exit 1
+fi
+
+# specs 目录优先级：--specs-dir 参数 > SPECS_DIR 环境变量 > cwd/specs
+specs_dir="${SPECS_DIR_ARG:-${SPECS_DIR:-$current_dir/specs}}"
+
+if [ -z "$SHORT_NAME" ]; then
+  if [ "$JSON_MODE" = true ]; then
+    echo '{"error":"缺少 --short-name 参数"}' >&2
+    exit 1
+  fi
+  echo "错误：请输入规范需求目录名称（kebab-case，2-4 个英文词）"
+  echo "用法: $0 [--json] --short-name \"名称\""
+  echo "注意：必须在 LCAP 扩展工程目录内执行"
+  exit 1
+fi
+
+name="$SHORT_NAME"
+
+# 计算下一个序号
+highest=0
+if [ -d "$specs_dir" ]; then
+  for dir in "$specs_dir"/*; do
+    [ -d "$dir" ] || continue
+    dirname=$(basename "$dir")
+    number=$(echo "$dirname" | grep -o '^[0-9]\+' || echo "0")
+    number=$((10#$number))
+    if [ "$number" -gt "$highest" ]; then highest=$number; fi
+  done
+fi
+
+next=$((highest + 1))
+feature_number=$(printf "%02d" "$next")
+current_spec_dir="$specs_dir/$feature_number-$name"
+
+# 创建目录与空 spec.md
+mkdir -p "$current_spec_dir"
+touch "$current_spec_dir/spec.md"
+
+# 转为绝对路径
+current_spec_dir_abs=$(cd "$current_spec_dir" && pwd)
+spec_file_abs="$current_spec_dir_abs/spec.md"
+feature_dir_abs="$current_spec_dir_abs"
+
+if [ "$JSON_MODE" = true ]; then
+  echo "{\"SPEC_FILE\":\"$spec_file_abs\",\"FEATURE_DIR\":\"$feature_dir_abs\"}"
+else
+  echo "规范需求目录已创建：$current_spec_dir_abs"
+  echo "  - spec.md"
+fi

package/packages/lcap-frontend-library/scripts/bash/get-available-port.sh

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+# 获取可用端口号（49152-65535 动态端口范围）
+# 用法: .specify/scripts/bash/get-available-port.sh
+
+set -e
+
+MIN_PORT=49152
+MAX_PORT=65535
+RANGE=$((MAX_PORT - MIN_PORT + 1))
+
+# 尝试最多 100 次找到可用端口
+for _ in $(seq 1 100); do
+  # 生成随机端口
+  port=$((MIN_PORT + RANDOM % RANGE))
+
+  # 检查端口是否可用（nc -z 连接成功返回 0，即端口被占用）
+  if command -v nc &>/dev/null; then
+    if ! nc -z 127.0.0.1 "$port" 2>/dev/null; then
+      echo "$port"
+      exit 0
+    fi
+  elif command -v lsof &>/dev/null; then
+    if ! lsof -i ":$port" &>/dev/null; then
+      echo "$port"
+      exit 0
+    fi
+  else
+    # 无 nc/lsof 时直接返回随机端口（可能被占用，调用方需自行处理）
+    echo "$port"
+    exit 0
+  fi
+done
+
+echo "错误：无法在 $MIN_PORT-$MAX_PORT 范围内找到可用端口" >&2
+exit 1