chore(workflow): 优化更新检查逻辑，使用TypeScript脚本对比内容哈希

- 用diff-hash.ts脚本替代复杂的shell命令，避免参数过长问题
- 脚本复用了现有代码库中的版本信息读取和内容哈希计算方法
- 实现了远程与本地USB.IDS数据哈希的比较，提升更新检测准确性
- 修改GitHub Actions自动更新流程，集成diff-hash脚本判断是否跳过更新
- 新增diff-hash命令至package.json脚本列表，方便调用与管理
- 补充脚本使用说明至scripts目录README，详细介绍用法和机制

Author: Drswith

.github/workflows/auto-update.yml

@@ -45,43 +45,12 @@ jobs:
       - name: Check if update is needed
         id: check-update
         run: |
-          # 获取npm最新版本的contentHash作为基准
-          mkdir -p /tmp/npm-check
-          cd /tmp/npm-check
-          npm install usb.ids --silent 2>/dev/null || true
-
-          # 获取 npm 最新版本的 contentHash
-          if [ -f "node_modules/usb.ids/usb.ids.version.json" ]; then
-            NPM_HASH=$(node -p "require('./node_modules/usb.ids/usb.ids.version.json').contentHash" 2>/dev/null || echo "")
+          # 使用TypeScript脚本进行哈希差异检查，避免shell参数过长问题
+          if pnpm run diff-hash; then
+            echo "No update needed, content hash is the same"
+            echo "skip=true" >> $GITHUB_OUTPUT
           else
-            NPM_HASH=""
-          fi
-          echo "NPM hash: $NPM_HASH"
-
-          # 清理临时目录
-          cd /
-          rm -rf /tmp/npm-check
-
-          # 回到工作目录，获取远程数据但不保存，只计算hash
-          cd $GITHUB_WORKSPACE
-
-          # 下载远程数据并计算contentHash（不保存文件）
-          REMOTE_CONTENT=$(curl -s "http://www.linux-usb.org/usb.ids" || curl -s "https://raw.githubusercontent.com/systemd/systemd/main/hwdb.d/usb.ids" || echo "")
-
-          if [ -n "$REMOTE_CONTENT" ]; then
-            # 使用Node.js计算SHA256 hash
-            REMOTE_HASH=$(node -e "const crypto = require('crypto'); console.log(crypto.createHash('sha256').update(process.argv[1]).digest('hex'));" "$REMOTE_CONTENT")
-            echo "Remote hash: $REMOTE_HASH"
-
-            if [ "$REMOTE_HASH" = "$NPM_HASH" ] && [ -n "$NPM_HASH" ]; then
-              echo "No update needed, contentHash is the same"
-              echo "skip=true" >> $GITHUB_OUTPUT
-            else
-              echo "Update needed, contentHash is different or no previous version"
-              echo "skip=false" >> $GITHUB_OUTPUT
-            fi
-          else
-            echo "Failed to fetch remote data, forcing update"
+            echo "Update needed, content hash is different or error occurred"
             echo "skip=false" >> $GITHUB_OUTPUT
           fi
 

package.json

@@ -58,7 +58,8 @@
     "prepare": "simple-git-hooks",
     "bumpp": "bumpp",
     "lint-staged": "lint-staged",
-    "update-readme-version": "tsx scripts/update-readme-version.ts"
+    "update-readme-version": "tsx scripts/update-readme-version.ts",
+    "diff-hash": "tsx scripts/diff-hash.ts"
   },
   "devDependencies": {
     "@antfu/eslint-config": "^4.2.1",

scripts/README.md

@@ -4,6 +4,66 @@ This directory contains utility scripts for the USB.IDS project. Each script ser
 
 ## Available Scripts
 
+### `diff-hash.ts`
+
+Compares content hashes between remote USB.IDS data and local processed data to determine if an update is needed. Designed for use in GitHub Actions workflow.
+
+#### Purpose
+Determines whether the automated update workflow should proceed by comparing the content hash of remote USB.IDS data with the hash from the local version file. This approach avoids circular dependency logic and provides more reliable change detection.
+
+#### Usage
+
+```bash
+# Run using npm script (recommended)
+pnpm run diff-hash
+
+# Or run directly with tsx
+tsx scripts/diff-hash.ts
+```
+
+#### What it does
+
+1. Reads local version information from `usb.ids.version.json` file
+2. Downloads remote USB.IDS data from official sources using `downloadFromUrls()` from `src/fetcher.ts`
+3. Calculates content hash using `generateContentHash()` from `src/parser.ts`
+4. Compares the local and remote content hashes
+5. Exits with appropriate exit codes for shell script integration
+
+#### Comparison Strategy
+
+- **Local baseline**: Uses the local `usb.ids.version.json` file as the comparison baseline
+- **Avoids circular logic**: No longer depends on npm package for version comparison
+- **First-run handling**: Automatically triggers update if no local version file exists
+- **Content-driven**: Only content changes trigger updates, not timestamps
+
+#### Exit Codes
+
+- **0**: No update needed (content hashes match)
+- **1**: Update needed (content hashes differ, no local version, or error occurred)
+
+#### Key Features
+
+- **Shell Integration**: Designed for use in GitHub Actions workflows
+- **Error Handling**: Gracefully handles network errors and missing data
+- **Code Reuse**: Leverages existing functions from `src/core.ts`, `src/fetcher.ts`, `src/parser.ts`, and `src/utils.ts`
+- **Functional Programming**: Uses pure functions and functional programming style
+- **Detailed Logging**: Provides clear status messages for debugging
+- **Content-based Detection**: Uses SHA256 hash comparison for accurate change detection
+- **Consistent Logic**: Reuses `loadVersionInfo()` from core.ts for file operations
+
+#### GitHub Actions Integration
+
+```yaml
+- name: Check if update is needed
+  id: check-update
+  run: |
+    if pnpm run diff-hash; then
+      echo "skip=true" >> $GITHUB_OUTPUT
+    else
+      echo "skip=false" >> $GITHUB_OUTPUT
+    fi
+```
+
 ### `update-readme-version.ts`
 
 Updates the version information in the project's README.md file based on data from `usb.ids.version.json`.

scripts/diff-hash.ts

@@ -0,0 +1,114 @@
+#!/usr/bin/env tsx
+
+/**
+ * USB.IDS数据哈希差异检查脚本
+ * 该脚本比较远程数据与本地已处理数据的contentHash来判断是否需要更新
+ * 避免了使用npm包作为基准的循环逻辑问题
+ * 复用core.ts中的现有函数以保持代码一致性
+ */
+
+import type { VersionInfo } from '../src/types'
+import * as path from 'node:path'
+import { USB_IDS_SOURCE, USB_IDS_VERSION_JSON_FILE } from '../src/config'
+import { loadVersionInfo } from '../src/core'
+import { downloadFromUrls } from '../src/fetcher'
+import { generateContentHash } from '../src/parser'
+import { logger } from '../src/utils'
+
+/**
+ * 获取本地版本信息
+ * 复用core.ts中的loadVersionInfo函数
+ */
+function getLocalVersionInfo(): VersionInfo | null {
+  try {
+    const versionFilePath = path.resolve(process.cwd(), USB_IDS_VERSION_JSON_FILE)
+    const versionInfo = loadVersionInfo(versionFilePath)
+
+    if (!versionInfo) {
+      logger.warn('Local version file does not exist')
+      return null
+    }
+
+    logger.info(`Local version: ${versionInfo.version}`)
+    logger.info(`Local hash: ${versionInfo.contentHash}`)
+
+    return versionInfo
+  }
+  catch (error) {
+    logger.warn(`Error reading local version info: ${(error as Error).message}`)
+    return null
+  }
+}
+
+/**
+ * 获取远程数据的contentHash
+ * 复用fetcher.ts中的downloadFromUrls和parser.ts中的generateContentHash
+ */
+async function getRemoteContentHash(): Promise<string | null> {
+  try {
+    logger.info('Downloading remote USB.IDS data...')
+    const content = await downloadFromUrls(USB_IDS_SOURCE)
+
+    if (!content) {
+      logger.warn('Failed to download remote USB.IDS data')
+      return null
+    }
+
+    const hash = generateContentHash(content)
+    logger.info(`Remote content hash: ${hash}`)
+    return hash
+  }
+  catch (error) {
+    logger.warn(`Error downloading remote data: ${(error as Error).message}`)
+    return null
+  }
+}
+
+/**
+ * 主函数：比较本地与远程数据的哈希差异
+ * 使用函数式编程风格，保持逻辑清晰简洁
+ */
+async function diffHash(): Promise<void> {
+  try {
+    logger.start('Comparing local and remote content hashes...')
+
+    // 获取本地版本信息（复用core.ts逻辑）
+    const localInfo = getLocalVersionInfo()
+
+    // 获取远程数据hash（复用fetcher和parser逻辑）
+    const remoteHash = await getRemoteContentHash()
+    if (!remoteHash) {
+      logger.info('Failed to get remote hash, forcing update')
+      process.exit(1) // 退出码1表示需要更新
+    }
+
+    // 如果没有本地版本信息，说明是首次运行，需要更新
+    if (!localInfo) {
+      logger.info('No local version info found, update needed for initial setup')
+      process.exit(1) // 退出码1表示需要更新
+    }
+
+    // 比较hash值
+    if (remoteHash === localInfo.contentHash) {
+      logger.success('No difference found, content hash is the same')
+      process.exit(0) // 退出码0表示不需要更新
+    }
+    else {
+      logger.info('Hash difference detected')
+      logger.info(`Remote: ${remoteHash}`)
+      logger.info(`Local:  ${localInfo.contentHash}`)
+      process.exit(1) // 退出码1表示需要更新
+    }
+  }
+  catch (error) {
+    logger.error(`Hash comparison failed: ${(error as Error).message}`)
+    process.exit(1) // 出错时也强制更新
+  }
+}
+
+// 当直接运行此脚本时执行检查
+if (import.meta.url === `file://${process.argv[1]}`) {
+  diffHash()
+}
+
+export { diffHash }