@helixlife-ai/xiantao 0.1.18 → 0.1.19

package/dist/commands/history/download.js

@@ -20,6 +20,12 @@ export default class HistoryDownload extends XtzCommand {
         device: Flags.string({
             description: 'Preferred device/format, e.g. pdf, xlsx, zip',
         }),
+        item: Flags.integer({
+            description: 'Select a download item by its 1-based index from the listed results',
+        }),
+        label: Flags.string({
+            description: 'Select a download item by its label',
+        }),
         output: Flags.string({
             char: 'o',
             description: 'Destination path; defaults to ~/Downloads/<file name>',
@@ -33,13 +39,21 @@ export default class HistoryDownload extends XtzCommand {
         const agent = await this.getProfile(flags.profile);
         const auth = await getAuthContext(agent, flags.token);
         const record = await findXiantaoHistoryRecordByFuid(auth, args.fuid);
+        if (flags.item !== undefined && flags.label) {
+            throw new XtzError('`--item` 与 `--label` 不能同时使用。');
+        }
         if (!record?.module_id?.trim()) {
             throw new XtzError(`未找到 fuid 为 ${args.fuid} 的历史记录。`);
         }
         const result = await fetchXiantaoHistoryDownloadButtons(auth, { fuid: args.fuid });
-        const item = this.pickDownloadItem(result.downloads, flags.device, flags.output);
+        const item = this.pickDownloadItem(result.downloads, {
+            device: flags.device,
+            item: flags.item,
+            label: flags.label,
+            outputPath: flags.output,
+        });
         if (!item) {
-            throw new XtzError('当前历史记录返回多个可下载结果，请传入 `--device`，或将 `--output` 改为带目标扩展名的文件名。');
+            throw new XtzError(this.buildMultipleDownloadsMessage(result.downloads));
         }
         const resolved = await resolveXiantaoDownload(auth, {
             item,
@@ -62,8 +76,14 @@ export default class HistoryDownload extends XtzCommand {
             profile: agent,
         });
     }
-    pickDownloadItem(downloads, expectedDevice, outputPath) {
-        const normalizedExpectedDevice = this.normalizeDevice(expectedDevice ?? this.inferDeviceFromOutputPath(outputPath));
+    pickDownloadItem(downloads, input) {
+        if (input.item !== undefined) {
+            return this.pickDownloadItemByIndex(downloads, input.item);
+        }
+        if (input.label) {
+            return this.pickDownloadItemByLabel(downloads, input.label);
+        }
+        const normalizedExpectedDevice = this.normalizeDevice(input.device ?? this.inferDeviceFromOutputPath(input.outputPath));
         if (normalizedExpectedDevice) {
             const matched = downloads.filter((item) => this.normalizeDevice(item.device) === normalizedExpectedDevice);
             if (matched.length === 1) {
@@ -79,6 +99,26 @@ export default class HistoryDownload extends XtzCommand {
         }
         return undefined;
     }
+    pickDownloadItemByIndex(downloads, itemIndex) {
+        if (!Number.isInteger(itemIndex) || itemIndex < 1 || itemIndex > downloads.length) {
+            throw new XtzError(`下载项序号 ${itemIndex} 无效，可选范围为 1-${downloads.length}。\n${this.buildMultipleDownloadsMessage(downloads)}`);
+        }
+        return downloads[itemIndex - 1];
+    }
+    pickDownloadItemByLabel(downloads, expectedLabel) {
+        const normalizedExpectedLabel = expectedLabel.trim().toLowerCase();
+        if (!normalizedExpectedLabel) {
+            return undefined;
+        }
+        const matched = downloads.filter((item) => item.label.trim().toLowerCase() === normalizedExpectedLabel);
+        if (matched.length === 1) {
+            return matched[0];
+        }
+        if (matched.length > 1) {
+            throw new XtzError(`下载项名称 ${expectedLabel} 匹配到多个结果，请改用 \`--item\` 精确选择。\n${this.buildMultipleDownloadsMessage(downloads)}`);
+        }
+        return undefined;
+    }
     inferDeviceFromOutputPath(outputPath) {
         const extension = outputPath?.trim().split('.').pop()?.toLowerCase();
         return extension ? this.normalizeDevice(extension) : undefined;
@@ -96,4 +136,14 @@ export default class HistoryDownload extends XtzCommand {
         }
         return normalized;
     }
+    buildMultipleDownloadsMessage(downloads) {
+        const lines = [
+            '当前历史记录返回多个可下载结果，请传入 `--item`、`--label`、`--device`，或将 `--output` 改为带目标扩展名的文件名。',
+            '可选下载项：',
+        ];
+        downloads.forEach((item, index) => {
+            lines.push(`${index + 1}. ${item.label} (device=${item.device}, endpoint=${item.endpoint})`);
+        });
+        return lines.join('\n');
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helixlife-ai/xiantao",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "description": "CLI for Xiantao bioinformatics tools",
   "type": "module",
   "main": "dist/index.js",