mock-service-cli 4.7.0 → 4.9.0

package/README.md

@@ -1,7 +1,7 @@
 [![release status](https://github.com/chandq/mock-service-cli/actions/workflows/release.yml/badge.svg)](https://github.com/chandq/mock-service-cli/actions/workflows/release.yml)
 [![Coverage Status](https://coveralls.io/repos/github/chandq/mock-service-cli/badge.svg?branch=master)](https://coveralls.io/github/chandq/mock-service-cli?branch=master)
 [![mock-service-cli](https://img.shields.io/github/package-json/v/chandq/mock-service-cli?style=flat-square)](https://www.npmjs.com/package/mock-service-cli)
-[![license:MIT](https://img.shields.io/npm/l/vue.svg?sanitize=true)](https://github.com/chandq/mock-service-cli/blob/master/LICENSE.md)
+[![license:MIT](https://img.shields.io/npm/l/vue.svg?sanitize=true)](https://github.com/chandq/mock-service-cli/blob/master/LICENSE)
 
 # 🦅 mock-service-cli
 
@@ -32,15 +32,29 @@
 ### 全局安装
 
 ```bash
+# npm
 npm install --global mock-service-cli
-# 或
+
+# Homebrew (macOS / Linux)
+brew tap chandq/tap
 brew install mock-service-cli
+
+# Scoop (Windows)
+scoop bucket add chandq https://github.com/chandq/scoop-bucket
+scoop install mock-service-cli
+
+# Nix (Linux / macOS)
+nix run github:chandq/mock-service-cli -- --help     # 临时运行
+nix profile install github:chandq/mock-service-cli     # 安装到 profile
 ```
 
 需要 RAR、7z、bzip2、xz 等高级归档格式时，安装 Ultra 版。它与轻量版使用相同的命令，不能同时全局安装：
 
 ```bash
 npm install --global mock-service-cli-ultra
+# Homebrew / Scoop 对应 Ultra 包名：mock-service-cli-ultra
+brew tap chandq/tap && brew install mock-service-cli-ultra
+scoop bucket add chandq https://github.com/chandq/scoop-bucket && scoop install mock-service-cli-ultra
 ```
 
 ### 局部安装
@@ -79,7 +93,8 @@ npx mock-service-cli [options] [path]
 | `-R` 或 `--static-server`  | 启用单目录静态服务器，指定静态资源目录                            | -      |
 | `--spa-fallback <path>`    | 单目录模式显式启用 SPA 回退                                       | -      |
 | `--static-config <file>`   | 使用自包含 JSON 配置启动静态服务器                                | -      |
-| `-w` 或 `--open`           | 自动打开 API 概览页、文件浏览器页                                 | false  |
+| `-w` 或 `--open`           | 自动打开可用的 Web 页面或 API 概览页                               | false  |
+| `--watch-depth <n>`        | 限制静态服务器文件监听递归深度（非负整数）                         | 无限   |
 | `-e` 或 `--explorer`       | 启用文件浏览器服务器，指定要浏览的目录                            | ./     |
 | `--edit`                   | 启用文件浏览器的新建、重命名、删除和上传操作                      | false  |
 | `--auth <password>`        | 为文件浏览器启用密码认证（仅可搭配 `--explorer`）                 | -      |
@@ -118,8 +133,9 @@ mock-service-cli --static-config ./static-server.json
 ```
 
 静态服务器会监听资源变化并向 HTML 页面注入热更新客户端：CSS 文件更新时替换样式表，其余变更刷新页面。
-默认不打开浏览器；在配置中设置 `"open": true` 或提供页面路径即可打开。完整配置字段和示例见
+默认不打开浏览器；使用 `-w/--open` 可自动打开静态服务器页面。也可在配置中设置 `"open": true` 或提供页面路径。完整配置字段和示例见
 [`docs/static-server.config.example.json`](./docs/static-server.config.example.json)：支持忽略规则、SPA 回退、挂载目录、代理、HTTPS、CORS、响应头和自定义浏览器命令。
+`watch.depth` 可限制 chokidar 递归监听层数；未设置时为无限深度，大目录建议显式设置有限值。命令行 `--watch-depth <n>` 优先于配置文件。
 配置文件只在顶层保留服务器级字段。所有应用都放在 `mounts` 中，并可独立设置 `directory`、`spaFallback`、`proxy`、`cors`、`headers`、`requestHeaders` 和 `secure`。mount 未设置 `path` 时默认挂载到 `/`；`directory` 可省略，但该应用必须配置至少一条代理。代理键使用完整公开路径，例如 `/api/app`。
 `headers` 是发送给客户端的响应头。`requestHeaders` 是发送给该应用全部代理上游的请求头；也可放在单个 `proxy` 规则中，覆盖或追加 mount 级请求头。代理规则使用 `{ "target": "http://...", "rewrite": true }`；`rewrite` 为 true 时只移除匹配的完整代理前缀并保留剩余路径和 query string。应用级 `secure` 控制其代理 HTTPS 目标的证书校验，默认 `false`。配置模式不接受 `--proxy-options`、`--rewrite` 或 `--spa-fallback`。
 未设置 `spaFallback` 时，应用目录会显示可点击的目录索引；可直接访问其中的 HTML 文件。mount 未命中的路由不会继续进入其他应用的 SPA fallback。
@@ -133,6 +149,9 @@ mock-service-cli -D ./dist
 
 # 指定公共路径和端口
 mock-service-cli -D ./dist -b /app -P 9090
+
+# 自动打开 Web 页面
+mock-service-cli -D ./dist --open
 ```
 
 ### HTTP 代理
@@ -308,6 +327,12 @@ socket.on('mock-dir-stat', data => {
 
 欢迎提交 Issue 和 Pull Request！
 
+- **[CONTRIBUTING.md](CONTRIBUTING.md)** - 开发指南、代码规范、提交规范
+- **[CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)** - 社区行为准则
+- **[SECURITY.md](SECURITY.md)** - 安全漏洞报告方式（请勿公开提交安全问题）
+- **Issue 模板** - Bug 反馈 / 功能建议（新建 Issue 时自动弹出）
+- **PR 模板** - 提交 Pull Request 时自动填充
+
 ## 📄 许可证
 
-MIT License - 详见 [LICENSE.md](LICENSE.md)
+MIT License - 详见 [LICENSE](LICENSE)

package/bin/mock-service-cli.cmd

@@ -0,0 +1,2 @@
+@echo off
+node "%~dp0mock-service-cli" %*

package/dist/meta.json

@@ -1041,7 +1041,7 @@
       "format": "cjs"
     },
     "src/lib/utils.js": {
-      "bytes": 12567,
+      "bytes": 15764,
       "imports": [
         {
           "path": "fs",
@@ -1067,12 +1067,17 @@
           "path": "net",
           "kind": "require-call",
           "external": true
+        },
+        {
+          "path": "child_process",
+          "kind": "require-call",
+          "external": true
         }
       ],
       "format": "cjs"
     },
     "src/lib/packageInfo.js": {
-      "bytes": 541,
+      "bytes": 529,
       "imports": [
         {
           "path": "fs",
@@ -1088,7 +1093,7 @@
       "format": "cjs"
     },
     "src/bin/mock-service-cli": {
-      "bytes": 13903,
+      "bytes": 14310,
       "imports": [
         {
           "path": "node_modules/colors/safe.js",
@@ -7344,7 +7349,7 @@
       "format": "cjs"
     },
     "src/lib/mockServer.js": {
-      "bytes": 17620,
+      "bytes": 18262,
       "imports": [
         {
           "path": "node_modules/express/index.js",
@@ -7420,7 +7425,7 @@
       "format": "cjs"
     },
     "src/lib/staticServer.js": {
-      "bytes": 34916,
+      "bytes": 35926,
       "imports": [
         {
           "path": "node_modules/express/index.js",
@@ -8417,7 +8422,7 @@
       "format": "cjs"
     },
     "src/lib/archiveProviders/light.js": {
-      "bytes": 8792,
+      "bytes": 8830,
       "imports": [
         {
           "path": "fs",
@@ -8458,7 +8463,7 @@
       "format": "cjs"
     },
     "src/lib/archiveService.js": {
-      "bytes": 9667,
+      "bytes": 9713,
       "imports": [
         {
           "path": "fs",
@@ -8494,7 +8499,7 @@
       "format": "cjs"
     },
     "src/lib/fileExplorerServer.js": {
-      "bytes": 26109,
+      "bytes": 25942,
       "imports": [
         {
           "path": "node_modules/express/index.js",
@@ -8783,6 +8788,11 @@
           "kind": "require-call",
           "external": true
         },
+        {
+          "path": "child_process",
+          "kind": "require-call",
+          "external": true
+        },
         {
           "path": "fs",
           "kind": "require-call",
@@ -10066,13 +10076,13 @@
           "bytesInOutput": 4540
         },
         "src/lib/utils.js": {
-          "bytesInOutput": 7057
+          "bytesInOutput": 8483
         },
         "src/lib/packageInfo.js": {
           "bytesInOutput": 429
         },
         "src/bin/mock-service-cli": {
-          "bytesInOutput": 10724
+          "bytesInOutput": 11080
         },
         "node_modules/depd/index.js": {
           "bytesInOutput": 6779
@@ -11185,10 +11195,10 @@
           "bytesInOutput": 721
         },
         "src/lib/mockServer.js": {
-          "bytesInOutput": 11363
+          "bytesInOutput": 11845
         },
         "src/lib/staticServer.js": {
-          "bytesInOutput": 27469
+          "bytesInOutput": 28120
         },
         "node_modules/busboy/lib/utils.js": {
           "bytesInOutput": 8707
@@ -11365,13 +11375,13 @@
           "bytesInOutput": 7774
         },
         "src/lib/fileExplorerServer.js": {
-          "bytesInOutput": 19335
+          "bytesInOutput": 19196
         },
         "src/runtime.js": {
           "bytesInOutput": 507
         }
       },
-      "bytes": 1825712
+      "bytes": 1828488
     }
   }
 }