CLI 参考

comp-hub CLI 提供了一套命令行工具，帮助您管理本地开发服务。支持多项目同时运行，每个项目独立端口互不干扰。

命令概览

命令	说明
comphub	启动当前项目的开发服务
comphub status	查看所有运行中的项目
comphub stop <hash>	停止指定项目
comphub stop --all	停止所有项目
comphub kill	关闭全部服务

---

comphub — 启动服务

在项目目录下执行，启动后即可在浏览器中预览和下载组件。

comphub

可选参数：

参数	简写	类型	默认值	说明
--port	-p	number	5478	启动端口
--dir	-d	path	"./"	资源目录相对路径

| --version | -v | - | - | 显示版本号 | | --help | -h | - | - | 显示帮助 |

示例：

# 默认端口启动
comphub

# 指定端口
comphub -p 8080

# 指定目录
comphub -d ./src

启动成功后会显示项目信息和访问地址：

✅ comp-hub v0.27.20
📦 项目已注册 (hash: 94525912)

  版本     0.27.20
  项目     D:\project\housing\vue2
  Hash    94525912
  端口     5002

  访问地址 http://localhost:5002/94525912/main/

用浏览器打开访问地址即可进入平台。

---

comphub status — 查看状态

查看当前有哪些项目正在运行。

comphub status

输出示例：

🔍 查询 master 状态...

  Master 状态: ok
  版本: 0.27.20
  运行时间: 120s
  项目数: 2

  已注册项目:
  ----------------------------------------------------------
    hash:    94525912
    cwd:     D:\project\housing\vue2
    port:    5003
    url:     http://localhost:5002/94525912/main/
  ----------------------------------------------------------
    hash:    a3f82109
    cwd:     D:\project\housing\vue3
    port:    5005
    url:     http://localhost:5002/a3f82109/main/
  ----------------------------------------------------------

如果没有服务在运行：

❌ master 服务未运行

---

comphub stop — 停止项目

停止一个或全部正在运行的项目，不影响其他项目。

# 停止指定项目（hash 可通过 status 命令查看）
comphub stop <hash>

# 停止所有项目
comphub stop --all

示例：

# 停止 hash 为 94525912 的项目
comphub stop 94525912

# 一次性停止所有项目
comphub stop --all

---

comphub kill — 关闭全部服务

关闭所有项目和服务。

comphub kill

执行后所有项目和服务都会被终止。如需重新启动，再次执行 comphub 即可。

---

多项目同时运行

不同的项目可以同时启动，互不影响：

# 终端 1：启动项目 A
cd /path/to/project-a
comphub

# 终端 2：启动项目 B
cd /path/to/project-b
comphub

# 查看所有项目
comphub status

每个项目会分配到独立的端口，通过不同的 URL 访问。