@ansstory/hias 1.0.4 → 1.0.6

package/lib/utils/tencent-translate.js

@@ -0,0 +1,187 @@
+// 腾讯翻译 API 封装 - 提供文本翻译能力
+
+const crypto = require('crypto')
+const axios = require('axios')
+const chalk = require('chalk')
+
+const SERVICE = 'tmt'
+const HOST = 'tmt.tencentcloudapi.com'
+const ENDPOINT = 'https://tmt.tencentcloudapi.com'
+const VERSION = '2018-03-21'
+const REGION = 'ap-guangzhou'
+const MAX_RETRIES = 3
+const RETRY_DELAY = 1000
+
+async function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms))
+}
+
+async function withRetry(fn, retries = MAX_RETRIES) {
+  for (let attempt = 0; attempt < retries; attempt++) {
+    try {
+      return await fn()
+    } catch (err) {
+      const isRetryable = err.message && (
+        err.message.includes('ResourceExhausted') ||
+        err.message.includes('LimitExceeded') ||
+        err.message.includes('InternalError') ||
+        err.message.includes('request failed: 5')
+      )
+      if (attempt < retries - 1 && isRetryable) {
+        const delay = RETRY_DELAY * Math.pow(2, attempt)
+        console.warn(chalk.yellow(`  ⚠ Tencent API attempt ${attempt + 1} failed, retrying in ${delay}ms...`))
+        await sleep(delay)
+        continue
+      }
+      throw err
+    }
+  }
+}
+
+function sha256Hex(message) {
+  return crypto.createHash('sha256').update(message, 'utf-8').digest('hex')
+}
+
+function hmacSha256(key, message) {
+  return crypto.createHmac('sha256', key).update(message, 'utf-8').digest()
+}
+
+/**
+ * 生成腾讯云 TC3-HMAC-SHA256 签名认证头
+ * 仅对 content-type 和 host 两个头签名（与官方 SDK 一致）
+ */
+function buildAuthorization(secretId, secretKey, timestamp, contentType, host, payload) {
+  const date = new Date(timestamp * 1000).toISOString().slice(0, 10)
+
+  const canonicalHeaders = `content-type:${contentType}\nhost:${host}\n`
+  const signedHeaders = 'content-type;host'
+  const hashedRequestPayload = sha256Hex(JSON.stringify(payload))
+
+  const canonicalRequest = [
+    'POST',
+    '/',
+    '',
+    canonicalHeaders,
+    signedHeaders,
+    hashedRequestPayload,
+  ].join('\n')
+
+  const algorithm = 'TC3-HMAC-SHA256'
+  const credentialScope = `${date}/${SERVICE}/tc3_request`
+  const hashedCanonicalRequest = sha256Hex(canonicalRequest)
+
+  const stringToSign = [
+    algorithm,
+    String(timestamp),
+    credentialScope,
+    hashedCanonicalRequest,
+  ].join('\n')
+
+  const kDate = hmacSha256(`TC3${secretKey}`, date)
+  const kService = hmacSha256(kDate, SERVICE)
+  const kSigning = hmacSha256(kService, 'tc3_request')
+  const signature = hmacSha256(kSigning, stringToSign).toString('hex')
+
+  return `${algorithm} Credential=${secretId}/${credentialScope}, SignedHeaders=${signedHeaders}, Signature=${signature}`
+}
+
+/**
+ * 调用腾讯云翻译 API 批量翻译中文文本为英文
+ * 使用 TextTranslateBatch 支持单次请求多个文本
+ * @param {string[]} texts - 待翻译文本数组
+ * @param {string} secretId - 腾讯云 SecretId
+ * @param {string} secretKey - 腾讯云 SecretKey
+ * @param {string} [from='zh'] - 源语言
+ * @param {string} [to='en'] - 目标语言
+ * @returns {Promise<string[]>} - 翻译结果数组
+ */
+async function tencentTranslate(texts, secretId, secretKey, from = 'zh', to = 'en') {
+  if (texts.length === 0) return []
+
+  // Tencent TMT 单条文本限制 2000 字节，超长时按句子边界截断并警告
+  const MAX_ITEM_BYTES = 2000
+  const truncated = []
+  for (let i = 0; i < texts.length; i++) {
+    const bytes = Buffer.byteLength(texts[i], 'utf-8')
+    if (bytes > MAX_ITEM_BYTES) {
+      console.warn(chalk.yellow(`  ⚠ Text #${i} exceeds ${MAX_ITEM_BYTES} bytes (${bytes}), truncating at sentence boundary`))
+      let buf = Buffer.from(texts[i], 'utf-8')
+      buf = buf.subarray(0, MAX_ITEM_BYTES)
+      let truncatedStr = buf.toString('utf-8').replace(/\uFFFD/g, '')
+      // 从末尾向前查找句子边界（句号、换行、感叹号、问号、分号）
+      const boundaryMatch = truncatedStr.match(/.*[。！？\n;；]/)
+      if (boundaryMatch) {
+        truncatedStr = boundaryMatch[0]
+      }
+      truncated.push(truncatedStr)
+    } else {
+      truncated.push(texts[i])
+    }
+  }
+
+  const BATCH_LIMIT = 200
+  const allResults = []
+
+  for (let i = 0; i < truncated.length; i += BATCH_LIMIT) {
+    const batch = truncated.slice(i, i + BATCH_LIMIT)
+
+    const timestamp = Math.floor(Date.now() / 1000)
+    const action = batch.length > 1 ? 'TextTranslateBatch' : 'TextTranslate'
+    const headers = {
+      'Content-Type': 'application/json',
+      Host: HOST,
+      'X-TC-Action': action,
+      'X-TC-Version': VERSION,
+      'X-TC-Region': REGION,
+      'X-TC-Timestamp': String(timestamp),
+    }
+
+    let payload
+    if (batch.length > 1) {
+      payload = {
+        SourceTextList: batch,
+        Source: from,
+        Target: to,
+        ProjectId: 0,
+      }
+    } else {
+      payload = {
+        SourceText: batch[0],
+        Source: from,
+        Target: to,
+        ProjectId: 0,
+      }
+    }
+
+    headers.Authorization = buildAuthorization(secretId, secretKey, timestamp, 'application/json', HOST, payload)
+
+    try {
+      const response = await withRetry(() => axios.post(ENDPOINT, payload, { headers }))
+      const d = response.data
+
+      if (d && d.Response) {
+        if (d.Response.TargetTextList) {
+          allResults.push(...d.Response.TargetTextList)
+          continue
+        }
+        if (d.Response.TargetText) {
+          allResults.push(d.Response.TargetText)
+          continue
+        }
+        if (d.Response.Error) {
+          throw new Error(`Tencent API error: ${d.Response.Error.Message} (Code: ${d.Response.Error.Code})`)
+        }
+      }
+      throw new Error('Translation failed: no result returned')
+    } catch (error) {
+      if (error.response) {
+        throw new Error(`Tencent API request failed: ${error.response.status} ${JSON.stringify(error.response.data)}`)
+      }
+      throw error
+    }
+  }
+
+  return allResults
+}
+
+module.exports = { tencentTranslate }

package/lib/utils/translation-cache.js

@@ -0,0 +1,73 @@
+const fs = require('fs')
+const path = require('path')
+
+const CACHE_FILE = '.hias/.translation-cache.json'
+
+let cache = null
+let cacheDirty = false
+
+function getCachePath(baseDir) {
+  return path.join(baseDir, CACHE_FILE)
+}
+
+function loadCache(baseDir) {
+  if (cache) return cache
+  const cp = getCachePath(baseDir)
+  try {
+    if (fs.existsSync(cp)) {
+      cache = JSON.parse(fs.readFileSync(cp, 'utf-8'))
+    }
+  } catch {
+    // ignore corrupt cache
+  }
+  if (!cache) cache = {}
+  cacheDirty = false
+  return cache
+}
+
+function saveCache(baseDir) {
+  if (!cacheDirty) return
+  const cp = getCachePath(baseDir)
+  try {
+    const dir = path.dirname(cp)
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true })
+    fs.writeFileSync(cp, JSON.stringify(cache, null, 2), 'utf-8')
+    cacheDirty = false
+  } catch {
+    // silent fail on cache write
+  }
+}
+
+function getCachedTranslation(text, fromLang, toLang, baseDir) {
+  const c = loadCache(baseDir)
+  const pair = `${fromLang}|${toLang}`
+  return c[pair] && c[pair][text] ? c[pair][text] : null
+}
+
+function setCachedTranslation(text, fromLang, toLang, translation, baseDir) {
+  const c = loadCache(baseDir)
+  const pair = `${fromLang}|${toLang}`
+  if (!c[pair]) c[pair] = {}
+  c[pair][text] = translation
+  cacheDirty = true
+  setImmediate(() => saveCache(baseDir))
+}
+
+function setBatchCache(results, texts, fromLang, toLang, baseDir) {
+  const c = loadCache(baseDir)
+  const pair = `${fromLang}|${toLang}`
+  if (!c[pair]) c[pair] = {}
+  for (let i = 0; i < texts.length; i++) {
+    c[pair][texts[i]] = results[i] || texts[i]
+  }
+  cacheDirty = true
+  setImmediate(() => saveCache(baseDir))
+}
+
+module.exports = {
+  getCachedTranslation,
+  setCachedTranslation,
+  setBatchCache,
+  saveCache,
+  loadCache,
+}

package/lib/utils/write-file.js

@@ -1,10 +1,16 @@
-const fs = require('fs')
-const path = require('path')
-
-async function writeFile(filePath, content) {
-  const dir = path.dirname(filePath)
-  await fs.promises.mkdir(dir, { recursive: true })
-  return fs.promises.writeFile(filePath, content)
-}
-
-module.exports = writeFile
+// 文件写入工具 - 处理文件和目录的创建及内容写入
+
+const fs = require('fs')
+const path = require('path')
+
+// 异步写入文件函数，自动创建必要的目录结构
+async function writeFile(filePath, content) {
+  // 获取文件所在的目录
+  const dir = path.dirname(filePath)
+  // 递归创建目录结构（如果目录不存在）
+  await fs.promises.mkdir(dir, { recursive: true })
+  // 将内容写入文件
+  return fs.promises.writeFile(filePath, content)
+}
+
+module.exports = writeFile

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@ansstory/hias",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "private": false,
-  "description": "创建项目模板",
+  "description": "个人自用脚手架内置个人常用功能",
   "author": "AnsStory story <story0809@163.com>",
   "main": "index.js",
   "bin": {
@@ -12,15 +12,23 @@
     "hias ansstory"
   ],
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "node --test",
+    "addv": "npm version patch",
+    "asp": "npm publish --access public",
+    "prepublish": "npm run addv && npm run asp"
   },
   "license": "MIT",
   "dependencies": {
+    "axios": "^1.17.0",
     "chalk": "^4.1.2",
     "commander": "^14.0.0",
     "download-git-repo": "^3.0.2",
     "ejs": "^3.1.10",
+    "i18next": "^26.3.0",
     "inquirer": "^8.2.6",
     "ora": "^5.4.1"
+  },
+  "devDependencies": {
+    "tencentcloud-sdk-nodejs-tmt": "^4.1.207"
   }
 }

package/test/close-port.test.js

@@ -0,0 +1,88 @@
+const test = require('node:test')
+const assert = require('node:assert/strict')
+
+const { closePort, closePorts, normalizePort, parsePortInputs, parsePidsFromWindowsNetstat } = require('../lib/core/close-port')
+
+test('normalizePort accepts valid numeric port strings', () => {
+  assert.equal(normalizePort('3000'), 3000)
+})
+
+test('normalizePort rejects invalid ports', () => {
+  assert.throws(() => normalizePort('abc'), /Invalid port/)
+  assert.throws(() => normalizePort('0'), /Invalid port/)
+  assert.throws(() => normalizePort('65536'), /Invalid port/)
+})
+
+test('parsePortInputs supports space-separated and comma-separated ports', () => {
+  assert.deepEqual(parsePortInputs(['8076', '8077,8078']), [8076, 8077, 8078])
+})
+
+test('parsePortInputs removes duplicate ports', () => {
+  assert.deepEqual(parsePortInputs(['8076,8077', '8076']), [8076, 8077])
+})
+
+test('parsePidsFromWindowsNetstat returns unique PIDs listening on the requested port', () => {
+  const output = [
+    '  TCP    0.0.0.0:3000           0.0.0.0:0              LISTENING       1234',
+    '  TCP    [::]:3000              [::]:0                 LISTENING       1234',
+    '  TCP    127.0.0.1:3001         0.0.0.0:0              LISTENING       7777',
+    '  TCP    127.0.0.1:3000         127.0.0.1:54511        ESTABLISHED     2222',
+    '  UDP    0.0.0.0:3000           *:*                                    5678',
+  ].join('\n')
+
+  assert.deepEqual(parsePidsFromWindowsNetstat(output, 3000), ['1234', '5678'])
+})
+
+test('closePort kills every process occupying the port', async () => {
+  const commands = []
+  const exec = async (command) => {
+    commands.push(command)
+    if (command.startsWith('netstat')) {
+      return {
+        stdout: [
+          '  TCP    0.0.0.0:5173           0.0.0.0:0              LISTENING       1001',
+          '  UDP    0.0.0.0:5173           *:*                                    1002',
+        ].join('\n'),
+      }
+    }
+    return { stdout: '' }
+  }
+
+  const result = await closePort('5173', { exec, platform: 'win32' })
+
+  assert.deepEqual(result, { port: 5173, pids: ['1001', '1002'], killed: ['1001', '1002'] })
+  assert.deepEqual(commands, ['netstat -ano', 'taskkill /F /PID 1001', 'taskkill /F /PID 1002'])
+})
+
+test('closePorts closes each requested port', async () => {
+  const commands = []
+  const exec = async (command) => {
+    commands.push(command)
+    if (command === 'netstat -ano') {
+      return {
+        stdout: [
+          '  TCP    0.0.0.0:8076           0.0.0.0:0              LISTENING       9001',
+          '  TCP    0.0.0.0:8077           0.0.0.0:0              LISTENING       9002',
+        ].join('\n'),
+      }
+    }
+    return { stdout: '' }
+  }
+
+  const results = await closePorts(['8076', '8077'], { exec, platform: 'win32' })
+
+  assert.deepEqual(results, [
+    { port: 8076, pids: ['9001'], killed: ['9001'] },
+    { port: 8077, pids: ['9002'], killed: ['9002'] },
+  ])
+  assert.deepEqual(commands, ['netstat -ano', 'taskkill /F /PID 9001', 'netstat -ano', 'taskkill /F /PID 9002'])
+})
+
+test('closePort returns an empty result when no process uses the port', async () => {
+  const result = await closePort('5173', {
+    exec: async () => ({ stdout: '' }),
+    platform: 'win32',
+  })
+
+  assert.deepEqual(result, { port: 5173, pids: [], killed: [] })
+})