refactor(scripts): 使用npm包中的内容哈希替代本地版本文件比较

- 修改diff-hash脚本，改为与最新发布的npm包内容哈希比较
- 移除对本地usb.ids.version.json文件的依赖，避免循环依赖问题
- 新增check-version-update.ts脚本，专门用于GitHub Actions中版本更新检测
- 从unpkg CDN获取npm包版本信息，简化获取流程
- 保留错误处理和详细日志输出，确保流程透明且稳定
- 保持更新逻辑以内容哈希为准，提升变更检测准确性

Author: Drswith

scripts/README.md

@@ -6,10 +6,10 @@ This directory contains utility scripts for the USB.IDS project. Each script ser
 
 ### `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.
+Compares content hashes between remote USB.IDS data and the published npm package 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.
+Determines whether the automated update workflow should proceed by comparing the content hash of remote USB.IDS data with the hash from the latest published npm package.
 
 #### Usage
 
@@ -23,33 +23,24 @@ 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
+1. Downloads remote USB.IDS data from official sources using `downloadFromUrls()` from `src/fetcher.ts`
+2. Calculates content hash using `generateContentHash()` from `src/parser.ts`
+3. Fetches version information from the latest npm package
+4. Compares the 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)
+- **1**: Update needed (content hashes differ 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
+- **Code Reuse**: Leverages existing functions from `src/fetcher.ts`, `src/parser.ts`, and `src/utils.ts`
 - **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
 

scripts/check-version-update.ts

@@ -0,0 +1,113 @@
+#!/usr/bin/env tsx
+
+/**
+ * 版本更新检查脚本
+ * 该脚本用于GitHub Actions工作流中，检查远程USB.IDS数据是否需要更新
+ * 通过比较远程数据的contentHash与npm包中的contentHash来判断
+ */
+
+import { USB_IDS_SOURCE } from '../src/config'
+import { downloadFromUrls } from '../src/fetcher'
+import { generateContentHash } from '../src/parser'
+import { logger } from '../src/utils'
+
+interface NpmVersionInfo {
+  contentHash: string
+  version: string
+  fetchTime: number
+}
+
+/**
+ * 获取npm包中的版本信息
+ */
+async function getNpmVersionInfo(): Promise<NpmVersionInfo | null> {
+  try {
+    // 尝试直接从unpkg CDN获取版本信息文件
+    const versionUrl = 'https://unpkg.com/usb.ids@latest/usb.ids.version.json'
+    const response = await fetch(versionUrl)
+
+    if (!response.ok) {
+      logger.warn(`Failed to fetch version info from unpkg: ${response.status}`)
+      return null
+    }
+
+    const versionInfo = await response.json() as NpmVersionInfo
+    logger.info(`NPM package version: ${versionInfo.version}`)
+    return versionInfo
+  }
+  catch (error) {
+    logger.warn(`Error fetching npm version info: ${(error as Error).message}`)
+    return null
+  }
+}
+
+/**
+ * 获取远程数据的contentHash
+ */
+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 checkVersionUpdate(): Promise<void> {
+  try {
+    logger.start('Checking if version update is needed...')
+
+    // 获取npm包版本信息
+    const npmInfo = await getNpmVersionInfo()
+    if (!npmInfo) {
+      logger.info('No npm version info available, forcing update')
+      process.exit(1) // 退出码1表示需要更新
+    }
+
+    logger.info(`NPM package hash: ${npmInfo.contentHash}`)
+
+    // 获取远程数据hash
+    const remoteHash = await getRemoteContentHash()
+    if (!remoteHash) {
+      logger.info('Failed to get remote hash, forcing update')
+      process.exit(1) // 退出码1表示需要更新
+    }
+
+    // 比较hash值
+    if (remoteHash === npmInfo.contentHash) {
+      logger.success('No update needed, content hash is the same')
+      process.exit(0) // 退出码0表示不需要更新
+    }
+    else {
+      logger.info('Update needed, content hash is different')
+      logger.info(`Remote: ${remoteHash}`)
+      logger.info(`NPM:    ${npmInfo.contentHash}`)
+      process.exit(1) // 退出码1表示需要更新
+    }
+  }
+  catch (error) {
+    logger.error(`Version check failed: ${(error as Error).message}`)
+    process.exit(1) // 出错时也强制更新
+  }
+}
+
+// 当直接运行此脚本时执行检查
+if (import.meta.url === `file://${process.argv[1]}`) {
+  checkVersionUpdate()
+}
+
+export { checkVersionUpdate }

scripts/diff-hash.ts

@@ -2,47 +2,46 @@
 
 /**
  * USB.IDS数据哈希差异检查脚本
- * 该脚本比较远程数据与本地已处理数据的contentHash来判断是否需要更新
- * 避免了使用npm包作为基准的循环逻辑问题
- * 复用core.ts中的现有函数以保持代码一致性
+ * 该脚本用于GitHub Actions工作流中，通过比较远程数据与npm包中的contentHash来判断是否需要更新
  */
 
-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 { USB_IDS_SOURCE } from '../src/config'
 import { downloadFromUrls } from '../src/fetcher'
 import { generateContentHash } from '../src/parser'
 import { logger } from '../src/utils'
 
+interface NpmVersionInfo {
+  contentHash: string
+  version: string
+  fetchTime: number
+}
+
 /**
- * 获取本地版本信息
- * 复用core.ts中的loadVersionInfo函数
+ * 获取npm包中的版本信息
  */
-function getLocalVersionInfo(): VersionInfo | null {
+async function getNpmVersionInfo(): Promise<NpmVersionInfo | null> {
   try {
-    const versionFilePath = path.resolve(process.cwd(), USB_IDS_VERSION_JSON_FILE)
-    const versionInfo = loadVersionInfo(versionFilePath)
+    // 尝试直接从unpkg CDN获取版本信息文件
+    const versionUrl = 'https://unpkg.com/usb.ids@latest/usb.ids.version.json'
+    const response = await fetch(versionUrl)
 
-    if (!versionInfo) {
-      logger.warn('Local version file does not exist')
+    if (!response.ok) {
+      logger.warn(`Failed to fetch version info from unpkg: ${response.status}`)
       return null
     }
 
-    logger.info(`Local version: ${versionInfo.version}`)
-    logger.info(`Local hash: ${versionInfo.contentHash}`)
-
+    const versionInfo = await response.json() as NpmVersionInfo
+    logger.info(`NPM package version: ${versionInfo.version}`)
     return versionInfo
   }
   catch (error) {
-    logger.warn(`Error reading local version info: ${(error as Error).message}`)
+    logger.warn(`Error fetching npm version info: ${(error as Error).message}`)
     return null
   }
 }
 
 /**
  * 获取远程数据的contentHash
- * 复用fetcher.ts中的downloadFromUrls和parser.ts中的generateContentHash
  */
 async function getRemoteContentHash(): Promise<string | null> {
   try {
@@ -65,38 +64,37 @@ async function getRemoteContentHash(): Promise<string | null> {
 }
 
 /**
- * 主函数：比较本地与远程数据的哈希差异
- * 使用函数式编程风格，保持逻辑清晰简洁
+ * 主函数：比较哈希差异
  */
 async function diffHash(): Promise<void> {
   try {
-    logger.start('Comparing local and remote content hashes...')
+    logger.start('Comparing content hashes...')
 
-    // 获取本地版本信息（复用core.ts逻辑）
-    const localInfo = getLocalVersionInfo()
+    // 获取npm包版本信息
+    const npmInfo = await getNpmVersionInfo()
+    if (!npmInfo) {
+      logger.info('No npm version info available, forcing update')
+      process.exit(1) // 退出码1表示需要更新
+    }
 
-    // 获取远程数据hash（复用fetcher和parser逻辑）
+    logger.info(`NPM package hash: ${npmInfo.contentHash}`)
+
+    // 获取远程数据hash
     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) {
+    if (remoteHash === npmInfo.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}`)
+      logger.info(`NPM:    ${npmInfo.contentHash}`)
       process.exit(1) // 退出码1表示需要更新
     }
   }