Merge pull request #61 from DogeLakeDev/cursor/bc-86b6eaa4-24c0-4632-87dd-c8ce6f7cabd9-ca9f

fix(pack-update): DRY/OCP/DIP 收敛 CF 源编排（审查 005fa99）

Author: Tanya7z

bds-tools/package.json

@@ -59,7 +59,6 @@
   },
   "dependencies": {
     "@sfmc-bds/sdk": "^0.1.0",
-    "cli-progress": "^3.12.0",
     "jszip": "^3.10.1",
     "node-html-parser": "^9.0.0"
   },

bds-tools/src/check-update.ts

@@ -14,6 +14,7 @@ import {
   createLogger,
   createStdoutSink,
   createTerminalProgress,
+  formatDownloadSpeed,
 } from "@sfmc-bds/sdk/logs";
 import fs from "node:fs";
 import os from "node:os";
@@ -317,12 +318,7 @@ export async function runUpdate(): Promise<number> {
             const timeDelta = (now - lastTime) / 1000; // 秒
             const bytesDelta = dl - lastLoaded;
             const speed = timeDelta > 0 ? bytesDelta / timeDelta : 0;
-            const speedStr =
-              speed > 1024 * 1024
-                ? `${(speed / 1024 / 1024).toFixed(1)} MB/s`
-                : speed > 1024
-                  ? `${(speed / 1024).toFixed(1)} KB/s`
-                  : `${speed.toFixed(0)} B/s`;
+            const speedStr = formatDownloadSpeed(speed);
             const totalMb = total > 0 ? total / (1024 * 1024) : 0;
             const dlMb = dl / (1024 * 1024);
             const pct = total > 0 ? (dl / total) * 100 : 0;

bds-tools/src/pack-manager.ts

@@ -12,7 +12,7 @@
  * 的一部分内嵌起来,而 SEA 是个单 exe (除 Node 内置 + bds-tools 已有依赖外)。
  *
  * 已有依赖 (bds-tools/package.json):
- *   - cli-progress: 进度条
+ *   - @sfmc-bds/sdk/logs createTerminalProgress: 进度条（BDS 更新等）
  *   - node-html-parser: changelog 抓取 (本文件用不到)
  *   - jszip: zip 解压(模块 zip / BDS server.zip),与 sfmc/wizard 共享同一个库
  *

configs-default/pack-update.json

@@ -16,8 +16,6 @@
       "pageSize": 10,
       "preferredReleaseTypes": ["release", "beta", "alpha"],
       "match": {
-        "byUuidInArchive": true,
-        "byName": true,
         "nameMinScore": 0.6,
         "stripFolderTags": true
       }

docs/guide/pack-update.md

@@ -99,8 +99,6 @@ flowchart TD
       "pageSize": 10,
       "preferredReleaseTypes": ["release", "beta", "alpha"],
       "match": {
-        "byUuidInArchive": true,
-        "byName": true,
         "nameMinScore": 0.6,
         "stripFolderTags": true
       }
@@ -129,6 +127,7 @@ flowchart TD
 | `baseUrl` | 官方 Core API：getMod / files / download-url。 |
 | `searchBaseUrl` | 搜索镜像；官方 search 403 时回退。 |
 | `nameMinScore` | 安装后自动绑定的最低相似度阈值。 |
+| `stripFolderTags` | 清洗时是否去掉方括号标签（如 `[BP]`/`[玩法]`）。 |
 
 ### 3.4 绑定文件示例
 

modules/sdk/@sfmc-sdk/src/logs/index.ts

@@ -51,6 +51,7 @@ export {
   resumeAllProgress,
   withProgressPaused,
   hasActiveProgress,
+  formatDownloadSpeed,
 } from "./terminal-progress.js";
 export type {
   TerminalProgressOptions,

modules/sdk/@sfmc-sdk/src/logs/terminal-progress.ts

@@ -92,6 +92,14 @@ function isWritableTty(stream: NodeJS.WritableStream): boolean {
   return !!(stream as WriteStream).isTTY;
 }
 
+/** 下载速度文案（BDS / CF 等共用，避免各处复制阈值分支） */
+export function formatDownloadSpeed(bytesPerSec: number): string {
+  const speed = Number.isFinite(bytesPerSec) ? Math.max(0, bytesPerSec) : 0;
+  if (speed > 1024 * 1024) return `${(speed / 1024 / 1024).toFixed(1)} MB/s`;
+  if (speed > 1024) return `${(speed / 1024).toFixed(1)} KB/s`;
+  return `${speed.toFixed(0)} B/s`;
+}
+
 function renderBarLine(
   value: number,
   total: number,