hainiubl-cloud-files 0.1.0 → 0.1.1

package/README.md

@@ -8,13 +8,13 @@ hainiubl 云端沙箱官方文件传输客户端。零第三方依赖，安装
 
 ```bash
 npm i -g hainiubl-cloud-files
-hainiubl-cloud-files --help
+hainiubl-cloud-files --version
 ```
 
 也可以不安装直接运行：
 
 ```bash
-npx -y hainiubl-cloud-files@0.1.0 --help
+npx -y hainiubl-cloud-files@0.1.1 --version
 ```
 
 ## 完整模式（人类用户）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hainiubl-cloud-files",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Official zero-dependency file transfer client for hainiubl cloud sandboxes",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { constants } from 'node:fs';
+import { constants, realpathSync } from 'node:fs';
 import { lstat, open } from 'node:fs/promises';
 import { resolve } from 'node:path';
-import { pathToFileURL } from 'node:url';
+import { fileURLToPath } from 'node:url';
 import { FileClient, hashFile, validateTicketDescriptor } from './client.js';
-import { loadFileClientConfig } from './config.js';
+import { loadFileClientConfig, PACKAGE_VERSION } from './config.js';
 import { exitCodeFor, fail, FileTransferError } from './errors.js';
 
 const MAX_TICKET_BYTES = 1024 * 1024;
@@ -21,6 +21,7 @@ const HELP = `用法：
   --overwrite          完整模式允许覆盖目标；票据下载允许覆盖已存在目标
   --transfer-id ID     完整模式显式续传，须使用相同文件及任务参数
   --ticket <文件|->    票据模式；使用 MCP prepare 返回的 JSON，- 表示从 stdin 读取
+  --version            显示版本
   --help               显示帮助
 
 认证：完整模式读取 HAINIUBL_API_KEY，未设置时读取 ~/.hainiubl-cloud-mcp/api-key；
@@ -42,6 +43,9 @@ export function parseArguments(argv) {
   if (argv.includes('--help') || argv.includes('-h')) {
     return { help: true };
   }
+  if (argv.includes('--version') || argv.includes('-v')) {
+    return { version: true };
+  }
   const [command, ...rest] = argv;
   if (!['upload', 'download', 'hash'].includes(command)) {
     fail('ARGUMENT', '请指定 upload、download 或 hash，使用 --help 查看用法');
@@ -211,6 +215,10 @@ export async function main(argv = process.argv.slice(2), {
     stdout.write(HELP);
     return;
   }
+  if (args.version) {
+    stdout.write(`${PACKAGE_VERSION}\n`);
+    return;
+  }
   if (args.command === 'hash') {
     const result = await hashFile(args.source);
     stdout.write(`${JSON.stringify(result)}\n`);
@@ -283,6 +291,18 @@ function runCli() {
   main().catch(error => reportError(error));
 }
 
-if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+// npm 安装后的 .bin 是符号链接；必须比较真实路径，否则 npx 调用会静默不执行 main。
+function isEntryPoint() {
+  if (!process.argv[1]) {
+    return false;
+  }
+  try {
+    return realpathSync(process.argv[1]) === realpathSync(fileURLToPath(import.meta.url));
+  } catch {
+    return false;
+  }
+}
+
+if (isEntryPoint()) {
   runCli();
 }