SZHN CLI — 前端项目脚手架 ​

szhn-cli 是数字海南前端项目脚手架工具，支持通过命令行或可视化 UI 快速创建标准化前端工程。

执行步骤 ​

步骤 1：检查并安装 CLI ​

检查是否已安装：

szhn-cli --version

若未安装，先配置私有源后安装：

npm config set registry https://npmmirror.digitalhainan.com.cn/
npm install -g @szhn/szhn-cli

若已安装，建议更新到最新版：

npm update -g @szhn/szhn-cli

步骤 2：创建项目 ​

方式一：命令行模式（推荐） ​

szhn-cli init <项目名称>

若不带项目名，CLI 会询问是否在当前目录初始化：

szhn-cli init

方式二：可视化 UI 模式 ​

szhn-cli ui

启动本地 Web 界面，功能与命令行一致，体验更直观。

步骤 3：回答交互问题 ​

执行 init 后，CLI 会依次询问以下信息：

部分问题仅在所选模板支持对应属性时才会显示。

支持的项目模板 ​

实际模板列表由远程配置动态下发，可能随版本更新增减。

项目初始化完成后的操作 ​

CLI 完成模板克隆后，会自动：

1. 将项目信息写入 package.json（name、description、version、author）
2. 写入 baseApi 配置（接口请求基础路径）
3. 写入本地开发代理配置（vue.config.js / vite.config.js）
4. 对 element / PC 模板写入平台名称（页面标题）
5. 若选择开启埋点，注入埋点插件

随后询问是否全局安装 @szhn/ai-cli（AI 辅助开发工具），建议安装。

进入项目目录后正常启动：

cd <项目名称>
pnpm install
npm run dev

若未安装 pnpm，可使用 npm install 替代。

常见问题 ​

常见问题 ​

Vite 代理配置指南 ​

创建项目后，需要修改 vite.config.mts 中的代理配置以指向本地后端服务：

默认配置（指向远程环境） ​

server: {
  host: true,
  port: 5555,
  proxy: {
    '/admin-web/api': {
      changeOrigin: true,
      rewrite: (path: string) => path.replace(/^\/admin-web\/api/, ''),
      target: 'https://system-manage-dev.digitalhainan.com.cn/system-manage/api',
      ws: true,
    },
  },
},

本地开发配置（指向本地后端） ​

修改 target 为本地后端地址：

server: {
  host: true,
  port: 5555,
  proxy: {
    '/admin-web/api': {
      changeOrigin: true,
      rewrite: (path: string) => path.replace(/^\/admin-web\/api/, ''),
      target: 'http://localhost:8081/<context-path>/api',  // 修改为本地后端地址
      ws: true,
    },
  },
},

配置说明 ​

示例 ​

如果后端配置为：

• 端口：8081
• context-path：/<context-path>

则 Vite 代理配置应为：

target: 'http://localhost:8081/<context-path>'