介绍

@mshkq/cli 是 mshkq 社区系统的项目初始化工具以及构建集成工具。为用户集成了 Web 端构建（Next.js 16）以及小程序多端同构（Taro 4）的能力，并生成规范的模板，用于二次开发和深度开发使用。

CLI 采用现代化内嵌模式（原版架构形态，链内容升级为 Next 16 / Taro 4 兼容）：项目 next.config.js 写 require('@mshkq/cli/config/next') 开箱即用（支持回调扩展），CLI 内嵌 Next 16（webpack5 + SWC）默认构建链（路径别名 / dzq.config.yaml 注入 / CSS-SCSS 链 / splitChunks / Turbopack 相对别名），并转发 next build --webpack|--turbopack（Web）与 taro build --type weapp --compiler webpack5|vite（Mini）；同时负责环境注入、插件路由生成与错误码透传。

依赖

CLI 基于 Next.js 与 Taro 进行上层封装，一般情况无需关注底层工具细节，直接调用 dzq 命令即可。

| 依赖库 | 版本 | | --- | --- | | React | ^18.2.0 | | Next.js | ^16.2.12（webpack5 + SWC；--turbopack 可选）| | Taro | ^4.2.1（webpack5-runner）| | Node.js | ≥ 20.9（目标 22 LTS）|

安装

npm install @mshkq/cli -g

命令

# 初始化项目（web / mini）
dzq init <projectName> [-p web|mini]

# 本地开发
dzq dev                      # Web（转发 next dev）
dzq dev -p mini --type weapp # Mini（转发 taro build --watch）

# 构建
dzq build                    # Web（转发 next build --webpack）
dzq build --turbopack        # Web（Turbopack 实验模式）
dzq build -s                 # Web 静态化（output: 'export'）
dzq build -p mini --type weapp --compiler webpack5|vite

# SSR 服务
dzq start

# Serverless
dzq sls

模板

dzq init 内置两套模板（template/）：

• next-default：Next.js 16 + React 18 + MobX 6（mobx-react 9），next.config.js 使用 require('@mshkq/cli/config/next')（现代化内嵌链），SWC 装饰器由 jsconfig.json 启用；
• taro-default：Taro 4 + webpack5-runner + React 18 + MobX 6（mobx-react 9），config/index.js 显式声明 compiler.webpack5 与 prebundle。

模板依赖 @tarojs/plugin-platform-weapp、@tarojs/plugin-framework-react、[email protected]（精确）、@babel/preset-react；dzq.config.yaml 放置于项目父目录。

环境注入

CLI 在转发前注入 DISCUZ_ENV / DISCUZ_RUN / DISCUZ_CONFIG_* 等环境变量，与 dzq.config.yaml 构建期配置保持一致。