@ansstory/hias 1.0.4 → 1.0.5

package/.gitattributes

@@ -1 +1 @@
-* text=auto eol=lf
+* text=auto eol=lf

package/.vscode/settings.json

@@ -0,0 +1,8 @@
+{
+  "i18n-ally.localesPaths": [
+    "lib/i18n/**/*",
+  ],
+  "i18n-ally.keystyle": "nested",
+  "i18n-ally.sourceLanguage": "zh-CN",
+  "i18n-ally.displayLanguage": "zh-CN",
+}

package/I18N.md

@@ -0,0 +1,178 @@
+# 国际化功能文档
+
+## 概述
+
+hias-cli 现在支持国际化（i18n），用户可以通过命令切换 CLI 工具的显示语言。
+
+## 支持的语言
+
+- **英文** (en) - 默认语言
+- **简体中文** (zh-CN)
+
+## 使用方法
+
+### 1. 查看当前语言
+
+```bash
+hias lang -l
+# 或
+hias lang --list
+```
+
+### 2. 切换语言
+
+**切换到中文：**
+
+```bash
+hias lang zh-CN
+```
+
+**切换到英文：**
+
+```bash
+hias lang en
+```
+
+### 3. 语言设置的持久化
+
+用户选择的语言会被保存到 `~/.hias-cli/config.json`，下次使用 CLI 工具时会自动使用保存的语言设置。
+
+```json
+{
+  "language": "zh-CN"
+}
+```
+
+## 技术实现
+
+### 依赖库
+
+- **i18next** - 专业的国际化库，用于管理多语言翻译
+
+### 项目结构
+
+```
+lib/
+├── i18n/
+│   ├── index.js              # i18n 初始化模块
+│   ├── store.js              # 语言配置存储和管理
+│   └── resources/
+│       ├── en.json           # 英文翻译资源
+│       └── zh-CN.json        # 中文翻译资源
+├── core/
+│   ├── lang.js               # 语言切换命令处理
+│   ├── commander.js          # 命令定义（已集成 i18n）
+│   ├── action.js             # 命令处理（已集成 i18n）
+│   ├── download.js           # 下载处理（已集成 i18n）
+│   └── help.js               # 帮助信息（已集成 i18n）
+└── index.js                  # 入口文件（初始化 i18n）
+```
+
+### 配置文件位置
+
+`~/.hias-cli/config.json` - 存储用户的语言偏好
+
+## 示例
+
+### 场景 1：首次使用
+
+用户首次运行 CLI 工具，默认显示英文：
+
+```bash
+$ hias -h
+Commands:
+  create|crt <project> [other...]   create project. For example: hias create airbnb
+  adv <vuecpnname> [...others]      add vue component into a folder...
+  ...
+  lang [options] [language]         set CLI language. For example: hias lang zh-CN or hias lang en
+```
+
+### 场景 2：切换到中文
+
+```bash
+$ hias lang zh-CN
+语言已设置为: 简体中文
+
+$ hias -h
+Commands:
+  create|crt <project> [other...]   创建项目。示例: hias create airbnb
+  adv <vuecpnname> [...others]      将 Vue 组件添加到文件夹，示例...
+  ...
+  lang [options] [language]         设置 CLI 语言。示例: hias lang zh-CN 或 hias lang en
+```
+
+### 场景 3：查看当前语言
+
+```bash
+$ hias lang -l
+当前语言: 简体中文
+```
+
+### 场景 4：切换回英文
+
+```bash
+$ hias lang en
+Language has been set to: English
+
+$ hias lang -l
+Current language: English
+```
+
+## 扩展国际化
+
+要添加新的语言支持，只需：
+
+1. 在 `lib/i18n/resources/` 目录中创建新的翻译文件（如 `es.json`）
+2. 在 `lib/i18n/store.js` 中更新 `SUPPORTED_LANGUAGES` 数组
+3. 在新的翻译文件中翻译所有的消息键
+
+### 翻译文件结构
+
+参考 `lib/i18n/resources/en.json` 或 `zh-CN.json`：
+
+```json
+{
+  "commands": {
+    "create": "...",
+    "adv": "...",
+    "lang": "..."
+  },
+  "options": {
+    "dest": "..."
+  },
+  "prompts": {
+    "selectTemplate": "..."
+  },
+  "messages": {
+    "downloading": "...",
+    "langSet": "...",
+    "langCurrent": "..."
+  },
+  "languages": {
+    "en": "English",
+    "zh-CN": "简体中文"
+  }
+}
+```
+
+## 注意事项
+
+- 语言设置是全局的，会影响所有 CLI 命令的输出
+- 配置文件会在用户的主目录下创建 `.hias-cli` 目录
+- 如果配置文件损坏，CLI 会自动使用默认语言（英文）
+- 当前支持的语言代码符合 BCP 47 标准
+
+## 故障排除
+
+### 问题：语言没有切换
+
+- **解决方案**：检查 `~/.hias-cli/config.json` 是否存在且有写入权限
+- 尝试手动删除配置文件，让 CLI 重新创建
+
+### 问题：出现乱码
+
+- **解决方案**：确保你的终端支持 UTF-8 编码
+
+### 问题：某些消息仍然是英文
+
+- **解决方案**：这可能是第三方库输出的信息，这些信息不受 i18n 控制

package/LICENSE

@@ -1,22 +1,22 @@
-The MIT License (MIT)
-
-Copyright © 2025
-
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the “Software”), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
+The MIT License (MIT)
+
+Copyright © 2025
+
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the “Software”), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -1,11 +1,13 @@
-# hias-cli
-```sh
-npm i hias -g
-hias -h
-hias create xxx
-hias adv Demo -d src/components
-hias adr Demo -d src/components
-hias adrt Demo -d src/components
-hias adrd useDemoStore -d src/store/modules
-hias adrdt useDemoStore -d src/store/modules
-```
+# hias-cli
+```sh
+npm i hias -g
+hias -h
+hias create xxx
+hias adv Demo -d src/components
+hias adr Demo -d src/components
+hias adrt Demo -d src/components
+hias adrd useDemoStore -d src/store/modules
+hias adrdt useDemoStore -d src/store/modules
+hias close-port 8076 8077
+hias close-port 8076,8077
+```

package/lib/config.js

@@ -1,18 +1,22 @@
-const foramworkUrl = {
-  'vue2': 'https://gitee.com/AnsStory/hias-vue2-template.git',
-  'vue3': 'https://gitee.com/AnsStory/hias-vue3-template.git',
-  'vue-ts': 'https://gitee.com/AnsStory/hias-vue-ts-template.git',
-  'uni-vite': 'https://gitee.com/AnsStory/hias-uni-vite.git',
-  'nuxt-web': 'https://gitee.com/AnsStory/hias-nuxt-web-tmp.git',
-  'vue-screen': 'https://gitee.com/AnsStory/hias-vite-screen.git',
-  'react': 'https://gitee.com/AnsStory/hias-react-template.git',
-  'react-ts': 'https://gitee.com/AnsStory/hias-react-ts-template.git',
-}
-const framwork = Object.keys(foramworkUrl)
-
-module.exports = {
-  // 可选择的框架
-  framwork,
-  // 框架对应的下载地址
-  foramworkUrl,
-}
+// 项目配置文件 - 定义支持的框架模板和对应的下载地址
+// 各框架模板的 Gitee 仓库地址映射表
+const foramworkUrl = {
+  vue2: 'https://gitee.com/AnsStory/hias-vue2-template.git',
+  vue3: 'https://gitee.com/AnsStory/hias-vue3-template.git',
+  'vue-ts': 'https://gitee.com/AnsStory/hias-vue-ts-template.git',
+  'uni-vite': 'https://gitee.com/AnsStory/hias-uni-vite.git',
+  'nuxt-web': 'https://gitee.com/AnsStory/hias-nuxt-web-tmp.git',
+  'vue-screen': 'https://gitee.com/AnsStory/hias-vite-screen.git',
+  react: 'https://gitee.com/AnsStory/hias-react-template.git',
+  'react-ts': 'https://gitee.com/AnsStory/hias-react-ts-template.git',
+}
+
+// 从 foramworkUrl 对象提取所有支持的框架名称
+const framwork = Object.keys(foramworkUrl)
+
+module.exports = {
+  // 可选择的框架列表
+  framwork,
+  // 框架对应的下载地址映射表
+  foramworkUrl,
+}

package/lib/core/action.js

@@ -1,68 +1,95 @@
-const inquirer = require('inquirer')
-const chalk = require('chalk')
-const { program } = require('commander')
-var config = require('../config')
-var downloadFun = require('./download')
-const compileEjs = require('../utils/compile-ejs')
-const writeFile = require('../utils/write-file')
-const beginAction = async (project, args) => {
-  // 命令行的执行逻辑代码
-  // console.log(project);
-  // console.log(args);
-  const answer = await inquirer.prompt([
-    {
-      type: 'list',
-      name: 'framwork',
-      choices: config.framwork,
-      message: 'Please select the template.',
-    },
-  ])
-  // console.log(answer);
-  // 下载代码模板
-  downloadFun(config.foramworkUrl[answer.framwork], project)
-}
-
-async function addComponentAction(cpnName, temPath, fileType) {
-  // 边界处理: 若为 .\xx\xx\ 则转换为 ./xx/xx/
-  const dest = program.opts().dest.replace(/\\/g, '/') || 'src/components'
-  // 边界处理: 若为 ./xx/xx 则转换为 ./xx/xx/
-  const path = /[\\/]/.test(dest.at(-1)) ? dest : `${dest}/`
-
-  const [folderName = 'index'] = dest.match(/[^\\/]+(?=\/?$)/)
-  const name = cpnName === 'index' ? folderName : cpnName
-
-  const result = await compileEjs(temPath, {
-    name: name,
-    lowername: name.toLowerCase(),
-  })
-
-  const filePath = `${path}${cpnName}.${fileType}`
-
-  await writeFile(filePath, result)
-  console.log(chalk.green.bold('Component creation was successful:'), chalk.blue.bold(`${cpnName}.${fileType}`), chalk.underline(filePath))
-}
-
-async function addVueComponentAction(cpnName) {
-  await addComponentAction(cpnName, 'component.vue.ejs', 'vue')
-}
-async function addReactComponentAction(cpnName) {
-  await addComponentAction(cpnName, 'component.jsx.ejs', 'jsx')
-}
-async function addReactTsComponentAction(cpnName) {
-  await addComponentAction(cpnName, 'component.tsx.ejs', 'tsx')
-}
-async function addReduxStoreAction(cpnName) {
-  await addComponentAction(cpnName, 'reduxStore.jsx.ejs', 'jsx')
-}
-async function addReduxTsStoreAction(cpnName) {
-  await addComponentAction(cpnName, 'reduxTsStore.tsx.ejs', 'tsx')
-}
-
-module.exports = {
-  beginAction,
-  addVueComponentAction,
-  addReactComponentAction,
-  addReactTsComponentAction,
-  addReduxStoreAction,
-  addReduxTsStoreAction,
-}
+// 命令行操作处理文件 - 处理各种命令的具体执行逻辑
+
+const inquirer = require('inquirer')
+const chalk = require('chalk')
+const { program } = require('commander')
+var config = require('../config')
+var downloadFun = require('./download')
+const compileEjs = require('../utils/compile-ejs')
+const writeFile = require('../utils/write-file')
+const i18n = require('../i18n')
+
+// 创建项目的主处理函数
+const beginAction = async (project, args) => {
+  // 获取翻译函数
+  const t = i18n.getT()
+
+  // 使用 inquirer 交互式命令行提示用户选择框架
+  const answer = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'framwork',
+      choices: config.framwork,
+      message: t('prompts.selectTemplate'),
+    },
+  ])
+
+  // 调用下载函数获取对应框架的模板
+  downloadFun(config.foramworkUrl[answer.framwork], project)
+}
+
+// 通用的组件/Store 添加处理函数
+async function addComponentAction(cpnName, temPath, fileType) {
+  // 获取翻译函数
+  const t = i18n.getT()
+
+  // 边界处理：将反斜杠转换为正斜杠（处理 Windows 路径格式）
+  const dest = program.opts().dest.replace(/\\/g, '/') || 'src/components'
+
+  // 边界处理：确保路径末尾带有斜杠
+  const path = /[\\/]/.test(dest.at(-1)) ? dest : `${dest}/`
+
+  // 从目标路径中提取文件夹名称（用作默认组件名）
+  const [folderName = 'index'] = dest.match(/[^\\/]+(?=\/?$)/)
+  // 如果组件名为 'index'，使用文件夹名作为实际组件名
+  const name = cpnName === 'index' ? folderName : cpnName
+
+  // 使用 EJS 模板引擎编译模板文件
+  const result = await compileEjs(temPath, {
+    name: name,
+    lowername: name.toLowerCase(),
+  })
+
+  // 拼接完整的文件路径
+  const filePath = `${path}${cpnName}.${fileType}`
+
+  // 将编译后的内容写入文件
+  await writeFile(filePath, result)
+
+  // 输出成功提示信息
+  console.log(chalk.green.bold(t('messages.componentCreated')), chalk.blue.bold(`${cpnName}.${fileType}`), chalk.underline(filePath))
+}
+
+// 添加 Vue 组件
+async function addVueComponentAction(cpnName) {
+  await addComponentAction(cpnName, 'component.vue.ejs', 'vue')
+}
+
+// 添加 React JSX 组件
+async function addReactComponentAction(cpnName) {
+  await addComponentAction(cpnName, 'component.jsx.ejs', 'jsx')
+}
+
+// 添加 React TSX 组件
+async function addReactTsComponentAction(cpnName) {
+  await addComponentAction(cpnName, 'component.tsx.ejs', 'tsx')
+}
+
+// 添加 Redux JSX Store
+async function addReduxStoreAction(cpnName) {
+  await addComponentAction(cpnName, 'reduxStore.jsx.ejs', 'jsx')
+}
+
+// 添加 Redux TSX Store
+async function addReduxTsStoreAction(cpnName) {
+  await addComponentAction(cpnName, 'reduxTsStore.tsx.ejs', 'tsx')
+}
+
+module.exports = {
+  beginAction,
+  addVueComponentAction,
+  addReactComponentAction,
+  addReactTsComponentAction,
+  addReduxStoreAction,
+  addReduxTsStoreAction,
+}

package/lib/core/close-port.js

@@ -0,0 +1,173 @@
+// 关闭端口命令处理文件 - 查找并结束占用指定端口的进程
+
+const { exec: execWithCallback } = require('child_process')
+const { promisify } = require('util')
+
+// 将 Node 回调风格的 exec 转换为 Promise，方便 async/await 调用
+const defaultExec = promisify(execWithCallback)
+
+// 端口参数标准化：校验端口必须是 1-65535 之间的数字
+function normalizePort(port) {
+  const value = String(port || '').trim()
+
+  if (!/^\d+$/.test(value)) {
+    throw new Error('Invalid port. Port must be a number between 1 and 65535.')
+  }
+
+  const number = Number(value)
+  if (number < 1 || number > 65535) {
+    throw new Error('Invalid port. Port must be a number between 1 and 65535.')
+  }
+
+  return number
+}
+
+// 解析命令行端口输入，支持空格分隔和逗号分隔两种方式
+function parsePortInputs(inputs) {
+  return unique(
+    inputs
+      .flatMap((input) => String(input).split(','))
+      .map((port) => port.trim())
+      .filter(Boolean)
+      .map(normalizePort),
+  )
+}
+
+// 从 netstat 的本地地址字段中提取端口号
+function getLocalPort(localAddress) {
+  const match = String(localAddress).match(/:(\d+)$/)
+  return match ? Number(match[1]) : null
+}
+
+// 数组去重，保持原有顺序
+function unique(values) {
+  return Array.from(new Set(values))
+}
+
+// 解析 Windows netstat 输出，提取占用目标端口的进程 PID
+function parsePidsFromWindowsNetstat(output, port) {
+  return unique(
+    String(output)
+      .split(/\r?\n/)
+      .map((line) => line.trim())
+      .filter(Boolean)
+      .map((line) => line.split(/\s+/))
+      .filter((parts) => {
+        const protocol = parts[0]
+        const localAddress = parts[1]
+        const state = parts[parts.length - 2]
+
+        // 只处理本地端口匹配的连接
+        if (getLocalPort(localAddress) !== port) {
+          return false
+        }
+
+        // TCP 只结束监听进程，UDP 没有 LISTENING 状态，直接按端口匹配
+        return protocol === 'UDP' || (protocol === 'TCP' && state === 'LISTENING')
+      })
+      .map((parts) => parts[parts.length - 1])
+      .filter((pid) => /^\d+$/.test(pid)),
+  )
+}
+
+// 解析类 Unix 系统 lsof 输出，提取进程 PID
+function parsePidsFromPosixLsof(output) {
+  return unique(
+    String(output)
+      .split(/\r?\n/)
+      .map((line) => line.trim())
+      .filter((line) => /^\d+$/.test(line)),
+  )
+}
+
+// 根据当前系统查找占用端口的进程 PID
+async function findPortPids(port, options) {
+  const exec = options.exec || defaultExec
+  const platform = options.platform || process.platform
+
+  // Windows 使用 netstat 查询所有端口，再在 Node 内部解析过滤
+  if (platform === 'win32') {
+    const { stdout } = await exec('netstat -ano')
+    return parsePidsFromWindowsNetstat(stdout, port)
+  }
+
+  // macOS/Linux 使用 lsof 查询端口；如果系统未安装 lsof 或无占用，则视为无进程
+  try {
+    const { stdout } = await exec(`lsof -ti :${port}`)
+    return parsePidsFromPosixLsof(stdout)
+  } catch (err) {
+    return []
+  }
+}
+
+// 根据平台结束指定 PID
+async function killPid(pid, options) {
+  const exec = options.exec || defaultExec
+  const platform = options.platform || process.platform
+  const command = platform === 'win32' ? `taskkill /F /PID ${pid}` : `kill -9 ${pid}`
+
+  await exec(command)
+  return pid
+}
+
+// 关闭单个端口：查找占用进程并逐个结束
+async function closePort(port, options = {}) {
+  const normalizedPort = normalizePort(port)
+  const pids = await findPortPids(normalizedPort, options)
+  const killed = []
+
+  for (const pid of pids) {
+    killed.push(await killPid(pid, options))
+  }
+
+  return {
+    port: normalizedPort,
+    pids,
+    killed,
+  }
+}
+
+// 关闭多个端口：先解析输入，再按端口顺序逐个处理
+async function closePorts(portInputs, options = {}) {
+  const ports = parsePortInputs(portInputs)
+  const results = []
+
+  for (const port of ports) {
+    results.push(await closePort(port, options))
+  }
+
+  return results
+}
+
+// CLI action：执行关闭端口命令并输出结果
+async function handleClosePortAction(ports) {
+  const chalk = require('chalk')
+  const i18n = require('../i18n')
+  const t = i18n.getT()
+
+  try {
+    const results = await closePorts(ports)
+
+    // 每个端口单独输出处理结果，方便用户定位具体端口状态
+    for (const result of results) {
+      if (result.killed.length === 0) {
+        console.log(chalk.yellow.bold(t('messages.closePortNoProcess', { port: result.port })))
+        continue
+      }
+
+      console.log(chalk.green.bold(t('messages.closePortSuccess', { port: result.port, pids: result.killed.join(', ') })))
+    }
+  } catch (err) {
+    console.log(chalk.red.bold(err.message))
+  }
+}
+
+module.exports = {
+  closePort,
+  closePorts,
+  handleClosePortAction,
+  normalizePort,
+  parsePortInputs,
+  parsePidsFromPosixLsof,
+  parsePidsFromWindowsNetstat,
+}