@struggler/cli 1.0.11 → 1.0.13

package/Makefile

@@ -55,9 +55,14 @@ link:
 		$(PNPM) setup; \
 	fi
 	@$(PNPM) link --global
+	@hash -r
+	@which struggler-cli || true
+	@struggler-cli -v || true
 
 unlink:
-	@$(PNPM) unlink --global @struggler/cli
+	@$(PNPM) unlink --global @struggler/cli || true
+	@npm uninstall -g @struggler/cli || true
+	@hash -r
 
 init:
 	$(NODE) $(CLI_ENTRY) --config $(CONFIG) --dir $(DIR) $(DRY_RUN) $(JSON) init

package/README.md

@@ -1,6 +1,8 @@
 # struggler-cli
 
-`struggler-cli` is a small deployment CLI for front-end build assets on Qiniu Cloud. It can generate versioned paths, upload build output, refresh CDN URLs, and now supports `dry-run`, concurrent uploads, ignore rules, manifest export, JSON output, and a one-shot `deploy` command.
+`struggler-cli` is a small deployment CLI for front-end build assets on Qiniu Cloud. It supports versioned paths, upload, CDN refresh, upload cache, profiles for multiple Qiniu accounts, `dry-run`, concurrency, ignore rules, manifest export, JSON output, and a one-shot `deploy` command.
+
+Works on **macOS, Linux, and Windows** (Node.js `path` / `fs` APIs are cross-platform).
 
 ## Install
 
@@ -14,105 +16,182 @@ For local command usage:
 pnpm link --global
 ```
 
-## Config Files
+## First-time setup (recommended: profiles)
+
+Use **profiles** to store Qiniu credentials under your user home: `~/.struggler-cli/` (Windows: `%USERPROFILE%\\.struggler-cli\\`). This folder is created automatically; it is **not** shipped with the npm package.
 
-The CLI expects two files in the same directory:
+```text
+~/.struggler-cli/          # created on first profile add/import (Windows/macOS/Linux)
+  profiles/
+    prod.json              # Qiniu credentials for production
+    staging.json
+  current                  # one line: active profile name, e.g. prod
 
-- `qiniu.json`: Qiniu credentials and bucket metadata
-- `config.json`: generated deploy prefix metadata used by upload/refresh
+your-project/
+  command/
+    config.json            # deploy prefix (publicPath / base), from init
+    upload-cache.json      # upload cache (optional)
+  dist/                    # build output to upload (-d)
+```
 
-Example `qiniu.json`:
+### Step 1 — Create a profile
 
-```json
-{
-  "path": "your-project",
-  "accessKey": "",
-  "secretKey": "",
-  "Bucket": "",
-  "zone": "Zone_z1",
-  "domain": "https://cdn.example.com/"
-}
+From your project root:
+
+```bash
+struggler-cli profile add prod
 ```
 
-Optional ignore file:
+This creates `~/.struggler-cli/profiles/prod.json` from the built-in template. Open it and fill in:
 
-```text
-.strugglerignore
+| Field | Description |
+|-------|-------------|
+| `path` | CDN path prefix segment for this app |
+| `accessKey` | Qiniu access key |
+| `secretKey` | Qiniu secret key |
+| `Bucket` | Bucket name |
+| `zone` | e.g. `Zone_z0`, `Zone_z1`, `Zone_z2` |
+| `domain` | CDN domain, e.g. `https://cdn.example.com/` |
+
+### Step 2 — Activate the profile
+
+```bash
+struggler-cli profile use prod
 ```
 
-Example:
+Or pass the profile name per command: `-c prod`.
 
-```text
-.DS_Store
-*.map
-legacy/**
+### Step 3 — Generate deploy metadata
+
+```bash
+struggler-cli init -d ./dist
 ```
 
-## Commands
+Writes `command/config.json` with a timestamped `publicPath` and `base` URL (always under `./command/`, same as older versions).
 
-Initialize versioned config:
+### Step 4 — Upload
 
 ```bash
-node ./index.js --config ./command/qiniu.json --dir ./dist init
+struggler-cli upload -d ./dist
 ```
 
-Preview upload work without changing files or calling Qiniu:
+### More environments
 
 ```bash
-node ./index.js --config ./command/qiniu.json --dir ./dist --dry-run upload
+struggler-cli profile add staging
+# edit ~/.struggler-cli/profiles/staging.json
+
+struggler-cli profile import dev ./path/to/existing-qiniu.json
+
+struggler-cli profile list
+struggler-cli profile current
+struggler-cli profile use staging
+struggler-cli init
+struggler-cli upload -d ./dist
 ```
 
-Upload with concurrency:
+Because profiles are user-level, they are outside your project repo by default.
+
+## Legacy setup (single `command/qiniu.json`)
+
+Still supported for existing projects:
+
+```text
+command/
+  qiniu.json
+  config.json
+```
 
 ```bash
-node ./index.js --config ./command/qiniu.json --dir ./dist --concurrency 8 upload
+struggler-cli init -c ./command/qiniu.json -d ./dist
+struggler-cli upload -c ./command/qiniu.json -d ./dist
 ```
 
-Upload with ignore patterns and a manifest:
+If no profile is active and you omit `-c`, the CLI defaults to `./command/qiniu.json`.
+
+## How `-c` resolves config
+
+| You pass | Resolved to |
+|----------|-------------|
+| *(omit)* | Active profile in `~/.struggler-cli/current`, else `./command/qiniu.json` |
+| `-c prod` | `~/.struggler-cli/profiles/prod.json` |
+| `-c ./command/qiniu.json` | That file path (legacy) |
+
+`config.json` and upload cache stay in `./command/` unless you pass `--config-dir`.
+
+## Profile commands
 
 ```bash
-node ./index.js --config ./command/qiniu.json --dir ./dist --exclude ".DS_Store,*.map" --manifest ./artifacts/upload-manifest.json upload
+struggler-cli profile list
+struggler-cli profile use <name>
+struggler-cli profile current
+struggler-cli profile add <name>
+struggler-cli profile import <name> <file>
+```
+
+## Other config files
+
+Optional ignore file:
+
+```text
+.strugglerignore
+```
+
+Example:
+
+```text
+.DS_Store
+*.map
+legacy/**
 ```
 
-Refresh CDN for generated URLs:
+## Commands
+
+Initialize versioned config:
 
 ```bash
-node ./index.js --config ./command/qiniu.json --dir ./dist refresh
+struggler-cli init -d ./dist
 ```
 
-Run the full flow:
+Preview upload:
 
 ```bash
-node ./index.js --config ./command/qiniu.json --dir ./dist --concurrency 8 deploy
+struggler-cli --dry-run upload -d ./dist
 ```
 
-Skip parts of deploy:
+Upload with concurrency:
 
 ```bash
-node ./index.js --config ./command/qiniu.json --dir ./dist --skip-refresh deploy
+struggler-cli upload -d ./dist --concurrency 8
 ```
 
-Machine-readable output:
+Full deploy:
 
 ```bash
-node ./index.js --config ./command/qiniu.json --dir ./dist --json --dry-run deploy
+struggler-cli deploy -d ./dist --concurrency 8
 ```
 
-Version bump script:
+Machine-readable output:
 
 ```bash
-pnpm add-version
+struggler-cli deploy -d ./dist --json --dry-run
 ```
 
-## Makefile Shortcuts
+## Windows notes
+
+- The folder name `.struggler-cli` is valid on Windows; Node resolves paths with `\` automatically.
+- User-level profile root on Windows is `%USERPROFILE%\\.struggler-cli\\`.
+- In **Cmd** or **PowerShell**, run the same commands as on Unix.
+- Avoid spaces in profile names; use `prod`, `staging`, `dev`.
+- When scripting, quote paths: `--config-dir "./command"`.
+
+## Makefile shortcuts
 
 ```bash
 make init
 make upload
 make refresh
 make deploy
-make upload DIR=./test/dist3 CONFIG=./test/command/qiniu.json DRY_RUN=--dry-run
-make deploy MANIFEST=./artifacts/deploy.json JSON=--json SKIP_REFRESH=--skip-refresh
 ```
 
 ## Test
@@ -121,4 +200,4 @@ make deploy MANIFEST=./artifacts/deploy.json JSON=--json SKIP_REFRESH=--skip-ref
 pnpm test
 ```
 
-The automated tests cover config path resolution, init dry-run behavior, upload ignore handling, manifest generation, and deploy JSON summaries.
+Tests cover profile resolution, config paths, init, upload, and deploy.

package/command/index.js

@@ -2,8 +2,10 @@ var init = require('./init');
 var upload = require('./upload');
 var refresh = require('./refresh');
 var deploy = require('./deploy');
+var profile = require('./profile');
 
 exports.init = init;
 exports.upload = upload;
 exports.refresh = refresh;
 exports.deploy = deploy;
+exports.profile = profile;

package/command/profile.js

@@ -0,0 +1,84 @@
+const path = require('path');
+const chalk = require('chalk');
+const {
+    listProfiles,
+    readCurrentProfile,
+    writeCurrentProfile,
+    importProfile,
+    addProfile,
+    getProfilePath,
+    getProfilesDir,
+} = require('../lib/profile');
+const { printMessage } = require('../lib/output');
+const { getLocale } = require('../lib/i18n');
+
+const TEMPLATE_PATH = path.resolve(__dirname, '../def/qiniu.json');
+
+function listAction(options) {
+    const { messages } = getLocale(options.lang);
+    const profiles = listProfiles();
+    const current = readCurrentProfile();
+
+    if (profiles.length === 0) {
+        printMessage(options, chalk.yellow(`  ${messages.profileListEmpty}`));
+        printMessage(options, chalk.dim(`     ${getProfilesDir()}`));
+        return { profiles: [], current: null };
+    }
+
+    printMessage(options, messages.profileListTitle);
+    profiles.forEach((name) => {
+        const marker = name === current ? chalk.green(' *') : '  ';
+        const file = getProfilePath(name);
+        printMessage(options, `${marker} ${name}${chalk.dim(`  →  ${file}`)}`);
+    });
+    if (current) {
+        printMessage(options, chalk.dim(messages.profileListCurrentHint));
+    }
+    return { profiles, current };
+}
+
+function useAction(name, options) {
+    const { messages } = getLocale(options.lang);
+    const profilePath = writeCurrentProfile(name);
+    printMessage(options, chalk.green(`  ✓  ${messages.profileUseDone(name)}`));
+    printMessage(options, chalk.dim(`     ${profilePath}`));
+    return { name, path: profilePath };
+}
+
+function currentAction(options) {
+    const { messages } = getLocale(options.lang);
+    const current = readCurrentProfile();
+    if (!current) {
+        printMessage(options, chalk.yellow(`  ${messages.profileNoCurrent}`));
+        return { current: null };
+    }
+    const profilePath = getProfilePath(current);
+    printMessage(options, `${messages.profileCurrentLabel} ${chalk.cyan(current)}`);
+    printMessage(options, chalk.dim(`     ${profilePath}`));
+    return { current, path: profilePath };
+}
+
+function addAction(name, options) {
+    const { messages } = getLocale(options.lang);
+    const profilePath = addProfile(name, TEMPLATE_PATH);
+    printMessage(options, chalk.green(`  ✓  ${messages.profileAddDone(name)}`));
+    printMessage(options, chalk.dim(`     ${profilePath}`));
+    printMessage(options, chalk.dim(messages.profileEditHint));
+    return { name, path: profilePath };
+}
+
+function importAction(name, fromPath, options) {
+    const { messages } = getLocale(options.lang);
+    const profilePath = importProfile(name, fromPath);
+    printMessage(options, chalk.green(`  ✓  ${messages.profileImportDone(name)}`));
+    printMessage(options, chalk.dim(`     ${profilePath}`));
+    return { name, path: profilePath, from: path.resolve(fromPath) };
+}
+
+module.exports = {
+    list: listAction,
+    use: useAction,
+    current: currentAction,
+    add: addAction,
+    import: importAction,
+};

package/index.js

@@ -58,7 +58,7 @@ program.configureHelp({
 	},
 })
 
-program.name("struggler-cli").description(locale.appDescription).version(packageJson.version, "-v, --version", locale.options.version).helpOption("-h, --help", locale.options.help).option("-c, --config <path>", locale.options.config, "./command/qiniu.json").option("--config-dir <path>", locale.options.configDir).option("-d, --dir <path>", locale.options.dir, "./dist").option("--dry-run", locale.options.dryRun).option("--concurrency <number>", locale.options.concurrency, "5").option("--exclude <pattern>", locale.options.exclude).option("--ignore-file <path>", locale.options.ignoreFile, ".strugglerignore").option("--manifest <path>", locale.options.manifest).option("--json", locale.options.json).option("--skip-init", locale.options.skipInit).option("--skip-refresh", locale.options.skipRefresh).option("--no-cache", locale.options.noCache).option("--lang <lang>", locale.options.lang, lang)
+program.name("struggler-cli").description(locale.appDescription).version(packageJson.version, "-v, --version", locale.options.version).helpOption("-h, --help", locale.options.help).option("-c, --config <path>", locale.options.config).option("--config-dir [path]", locale.options.configDir).option("-d, --dir <path>", locale.options.dir, "./dist").option("--dry-run", locale.options.dryRun).option("--concurrency <number>", locale.options.concurrency, "5").option("--exclude <pattern>", locale.options.exclude).option("--ignore-file <path>", locale.options.ignoreFile, ".strugglerignore").option("--manifest <path>", locale.options.manifest).option("--json", locale.options.json).option("--skip-init", locale.options.skipInit).option("--skip-refresh", locale.options.skipRefresh).option("--no-cache", locale.options.noCache).option("--lang <lang>", locale.options.lang, lang)
 
 program
 	.command("init")
@@ -88,6 +88,43 @@ program
 		await command.deploy(program.opts())
 	})
 
+const profileCmd = program.command("profile").description(locale.commands.profile)
+
+profileCmd
+	.command("list")
+	.description(locale.commands.profileList)
+	.action(() => {
+		command.profile.list(program.opts())
+	})
+
+profileCmd
+	.command("use <name>")
+	.description(locale.commands.profileUse)
+	.action((name) => {
+		command.profile.use(name, program.opts())
+	})
+
+profileCmd
+	.command("current")
+	.description(locale.commands.profileCurrent)
+	.action(() => {
+		command.profile.current(program.opts())
+	})
+
+profileCmd
+	.command("add <name>")
+	.description(locale.commands.profileAdd)
+	.action((name) => {
+		command.profile.add(name, program.opts())
+	})
+
+profileCmd
+	.command("import <name> <file>")
+	.description(locale.commands.profileImport)
+	.action((name, file) => {
+		command.profile.import(name, file, program.opts())
+	})
+
 program.addHelpCommand(true, locale.help.helpCommandDescription)
 
 program.parseAsync().catch(error => {

package/lib/config.js

@@ -1,5 +1,6 @@
 let path = require('path')
 const { getJsonData } = require('./files');
+const { resolveProfileConfigPath } = require('./profile');
 
 const DEFAULT_QINIU_CONFIG = './command/qiniu.json';
 const DEFAULT_META_DIR = './command';
@@ -11,26 +12,37 @@ function resolveFromCwd(targetPath) {
 }
 
 function getQiniuConfigPath(options = {}) {
+    const profilePath = resolveProfileConfigPath(options);
+    if (profilePath) {
+        return profilePath;
+    }
     return resolveFromCwd(options.config || DEFAULT_QINIU_CONFIG);
 }
 
-/** config.json / upload-cache.json 所在目录；优先级：CLI --config-dir > qiniu.json configDir > 与 qiniu 同目录 > ./command */
+function resolveConfigDirOption(options = {}) {
+    const value = options.configDir;
+    if (value === true || value === '') {
+        return DEFAULT_META_DIR;
+    }
+    if (typeof value === 'string') {
+        return value;
+    }
+    return null;
+}
+
+/** config.json / upload-cache.json 所在目录；优先级：CLI --config-dir > qiniu.json configDir > 默认 ./command（与旧版一致，不随 -c 目录变化） */
 function getMetaDir(options = {}) {
-    if (options.configDir) {
-        return resolveFromCwd(options.configDir);
+    const cliConfigDir = resolveConfigDirOption(options);
+    if (cliConfigDir) {
+        return resolveFromCwd(cliConfigDir);
     }
 
-    const qiniuConfigPath = getQiniuConfigPath(options);
-    const qiniuConfig = getJsonData(qiniuConfigPath);
+    const qiniuConfig = getJsonData(getQiniuConfigPath(options));
     if (qiniuConfig.configDir) {
         return resolveFromCwd(qiniuConfig.configDir);
     }
 
-    if (!options.config) {
-        return resolveFromCwd(DEFAULT_META_DIR);
-    }
-
-    return path.dirname(qiniuConfigPath);
+    return resolveFromCwd(DEFAULT_META_DIR);
 }
 
 function getConfigPath(options = {}) {

package/lib/i18n.js

@@ -30,15 +30,24 @@ const LANGUAGES = {
             deployUnit: '个',
             errorTitle: '出错了',
             errorMissingConfig: '配置不完整，以下字段缺失或为空：',
-            errorMissingConfigHint: '请检查 command/qiniu.json 和 command/config.json，或运行 struggler-cli init 初始化配置。',
+            errorMissingConfigHint: '请检查七牛配置（~/.struggler-cli/profiles，Windows 为 %USERPROFILE%\\.struggler-cli\\profiles）或 command/qiniu.json，以及 command/config.json；也可先运行 struggler-cli init。',
+            profileListEmpty: '尚无 profile，请先执行：struggler-cli profile add <name>',
+            profileListTitle: '可用 profile：',
+            profileListCurrentHint: '（* 为当前激活）',
+            profileUseDone: (name) => `已切换 profile：${name}`,
+            profileNoCurrent: '未设置当前 profile。可执行：struggler-cli profile use <name>',
+            profileCurrentLabel: '当前 profile：',
+            profileAddDone: (name) => `已创建 profile：${name}`,
+            profileImportDone: (name) => `已导入 profile：${name}`,
+            profileEditHint: '请编辑该文件，填写 accessKey、secretKey、Bucket、zone、domain 等字段。',
             dryRunLabel: '预览',
             dryRunPlan: (action, n) => `[预览] ${action} 计划 (${n} 个文件)`,
             manifestWritten: '清单已写入：',
         },
         options: {
             version: '显示版本号。',
-            config: '指定上传配置文件路径。',
-            configDir: '指定 config.json、upload-cache.json 所在目录（默认与 -c 同目录，未传 -c 时为 ./command）。',
+            config: '七牛配置：profile 名（如 prod）、文件路径（如 ./command/qiniu.json）；不传则优先用 ~/.struggler-cli/current（Windows 为 %USERPROFILE%\\.struggler-cli\\current），否则回退 ./command/qiniu.json。',
+            configDir: '指定 config.json、upload-cache.json 所在目录；不传时固定为 ./command（与旧版一致）；可写 --config-dir ./command。',
             dir: '指定要上传的目录。',
             dryRun: '仅预览执行计划，不写文件也不调用七牛接口。',
             concurrency: '设置上传并发数。',
@@ -57,6 +66,12 @@ const LANGUAGES = {
             upload: '将指定目录下文件上传到七牛云。',
             refresh: '刷新七牛云 CDN 文件。',
             deploy: '一次执行 init、upload 和 refresh。',
+            profile: '管理多套七牛配置（profile）。',
+            profileList: '列出所有 profile',
+            profileUse: '切换当前 profile',
+            profileCurrent: '显示当前 profile',
+            profileAdd: '从模版新建 profile',
+            profileImport: '从已有文件导入 profile',
         },
         help: {
             helpCommandDescription: '显示指定命令的帮助信息',
@@ -104,15 +119,24 @@ const LANGUAGES = {
             deployUnit: '',
             errorTitle: 'Error',
             errorMissingConfig: 'Incomplete config, the following fields are missing or empty:',
-            errorMissingConfigHint: 'Check command/qiniu.json and command/config.json, or run struggler-cli init.',
+            errorMissingConfigHint: 'Check Qiniu config (~/.struggler-cli/profiles, Windows: %USERPROFILE%\\.struggler-cli\\profiles) or command/qiniu.json, plus command/config.json; you can also run struggler-cli init first.',
+            profileListEmpty: 'No profiles yet. Run: struggler-cli profile add <name>',
+            profileListTitle: 'Profiles:',
+            profileListCurrentHint: '(* = active)',
+            profileUseDone: (name) => `Active profile: ${name}`,
+            profileNoCurrent: 'No active profile. Run: struggler-cli profile use <name>',
+            profileCurrentLabel: 'Active profile:',
+            profileAddDone: (name) => `Created profile: ${name}`,
+            profileImportDone: (name) => `Imported profile: ${name}`,
+            profileEditHint: 'Edit the file and fill accessKey, secretKey, Bucket, zone, domain.',
             dryRunLabel: 'dry-run',
             dryRunPlan: (action, n) => `[dry-run] ${action} plan (${n} files)`,
             manifestWritten: 'Manifest written:',
         },
         options: {
             version: 'Display the version number.',
-            config: 'Specify the path to the upload configuration file.',
-            configDir: 'Directory for config.json and upload-cache.json (default: same dir as -c, or ./command).',
+            config: 'Qiniu config: profile name (e.g. prod) or file path (e.g. ./command/qiniu.json); when omitted, use ~/.struggler-cli/current first (Windows: %USERPROFILE%\\.struggler-cli\\current), then fallback to ./command/qiniu.json.',
+            configDir: 'Directory for config.json and upload-cache.json; defaults to ./command when omitted (legacy behavior).',
             dir: 'Specify the directory to upload.',
             dryRun: 'Preview actions without writing files or calling Qiniu APIs.',
             concurrency: 'Set upload concurrency.',
@@ -131,6 +155,12 @@ const LANGUAGES = {
             upload: 'Upload files under the specified directory to Qiniu Cloud.',
             refresh: 'Refresh Qiniu Cloud CDN files.',
             deploy: 'Run init, upload, and refresh in one command.',
+            profile: 'Manage multiple Qiniu configs (profiles).',
+            profileList: 'List profiles',
+            profileUse: 'Set active profile',
+            profileCurrent: 'Show active profile',
+            profileAdd: 'Create profile from template',
+            profileImport: 'Import profile from file',
         },
         help: {
             helpCommandDescription: 'display help for command',

package/lib/profile.js

@@ -0,0 +1,148 @@
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { setSyncJsonData, getJsonData } = require('./files');
+
+const PROFILE_DIR_NAME = '.struggler-cli';
+const PROFILES_SUBDIR = 'profiles';
+const CURRENT_FILE = 'current';
+const PROFILE_NAME_RE = /^[a-zA-Z][a-zA-Z0-9_-]*$/;
+
+function getStoreRoot() {
+    const customHome = process.env.STRUGGLER_CLI_HOME;
+    if (customHome && customHome.trim()) {
+        return path.join(path.resolve(customHome), PROFILE_DIR_NAME);
+    }
+    return path.join(os.homedir(), PROFILE_DIR_NAME);
+}
+
+function getProfilesDir() {
+    return path.join(getStoreRoot(), PROFILES_SUBDIR);
+}
+
+function getCurrentFile() {
+    return path.join(getStoreRoot(), CURRENT_FILE);
+}
+
+function assertProfileName(name) {
+    if (!PROFILE_NAME_RE.test(name)) {
+        throw new Error(
+            `Invalid profile name "${name}". Use letters, numbers, _ or -, and start with a letter.`
+        );
+    }
+}
+
+function getProfilePath(name) {
+    assertProfileName(name);
+    return path.join(getProfilesDir(), `${name}.json`);
+}
+
+function ensureProfilesDir() {
+    fs.mkdirSync(getProfilesDir(), { recursive: true });
+}
+
+function readCurrentProfile() {
+    const currentFile = getCurrentFile();
+    if (!fs.existsSync(currentFile)) {
+        return null;
+    }
+    const name = fs.readFileSync(currentFile, 'utf8').trim();
+    return name || null;
+}
+
+function writeCurrentProfile(name) {
+    assertProfileName(name);
+    const profilePath = getProfilePath(name);
+    if (!fs.existsSync(profilePath)) {
+        throw new Error(`Profile "${name}" does not exist. Run: struggler-cli profile list`);
+    }
+    fs.mkdirSync(getStoreRoot(), { recursive: true });
+    fs.writeFileSync(getCurrentFile(), `${name}\n`, 'utf8');
+    return profilePath;
+}
+
+function listProfiles() {
+    const dir = getProfilesDir();
+    if (!fs.existsSync(dir)) {
+        return [];
+    }
+    return fs.readdirSync(dir)
+        .filter((file) => file.endsWith('.json'))
+        .map((file) => path.basename(file, '.json'))
+        .sort();
+}
+
+function isFileConfigPath(configValue, cwd = process.cwd()) {
+    if (!configValue) {
+        return false;
+    }
+    if (configValue.includes('/') || configValue.includes('\\')) {
+        return true;
+    }
+    const resolved = path.resolve(cwd, configValue);
+    return fs.existsSync(resolved) && fs.statSync(resolved).isFile();
+}
+
+function resolveProfileConfigPath(options = {}, cwd = process.cwd()) {
+    const configValue = options.config;
+
+    if (!configValue) {
+        const current = readCurrentProfile();
+        if (current) {
+            return getProfilePath(current);
+        }
+        return null;
+    }
+
+    if (isFileConfigPath(configValue, cwd)) {
+        return path.resolve(cwd, configValue);
+    }
+
+    assertProfileName(configValue);
+    const profilePath = getProfilePath(configValue);
+    if (!fs.existsSync(profilePath)) {
+        throw new Error(
+            `Profile "${configValue}" not found at ${profilePath}. Run: struggler-cli profile list`
+        );
+    }
+    return profilePath;
+}
+
+function importProfile(name, fromPath, cwd = process.cwd()) {
+    assertProfileName(name);
+    const source = path.resolve(cwd, fromPath);
+    if (!fs.existsSync(source)) {
+        throw new Error(`Config file not found: ${source}`);
+    }
+    ensureProfilesDir();
+    const target = getProfilePath(name);
+    fs.copyFileSync(source, target);
+    return target;
+}
+
+function addProfile(name, templatePath) {
+    assertProfileName(name);
+    ensureProfilesDir();
+    const target = getProfilePath(name);
+    if (fs.existsSync(target)) {
+        throw new Error(`Profile "${name}" already exists.`);
+    }
+    setSyncJsonData(target, getJsonData(templatePath));
+    return target;
+}
+
+module.exports = {
+    PROFILE_DIR_NAME,
+    getStoreRoot,
+    getProfilesDir,
+    getProfilePath,
+    getCurrentFile,
+    assertProfileName,
+    readCurrentProfile,
+    writeCurrentProfile,
+    listProfiles,
+    isFileConfigPath,
+    resolveProfileConfigPath,
+    importProfile,
+    addProfile,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@struggler/cli",
-	"version": "1.0.11",
+	"version": "1.0.13",
 	"description": "CLI to Upload vite packaged files to Qiniu Cloud OSS.",
 	"main": "index.js",
 	"scripts": {

package/test/config.test.js

@@ -16,7 +16,7 @@ test('config helpers resolve qiniu and derived config paths together', () => {
     );
     assert.equal(
         getConfig(options),
-        `${process.cwd()}/test/command/config.json`
+        `${process.cwd()}/command/config.json`
     );
     assert.equal(
         getDir(options),
@@ -36,6 +36,29 @@ test('config-dir overrides default meta directory', () => {
     );
 });
 
+test('config-dir flag without path defaults to ./command', () => {
+    const options = {
+        config: './test/command/qiniu.json',
+        configDir: true,
+    };
+
+    assert.equal(
+        getConfig(options),
+        `${process.cwd()}/command/config.json`
+    );
+});
+
+test('custom -c without config-dir keeps meta files in ./command', () => {
+    const options = {
+        config: './def/qiniu.json',
+    };
+
+    assert.equal(
+        getConfig(options),
+        `${process.cwd()}/command/config.json`
+    );
+});
+
 test('deploy helpers normalize concurrency and build remote keys', () => {
     assert.equal(normalizeConcurrency('0'), 5);
     assert.equal(normalizeConcurrency('3'), 3);

package/test/profile.test.js

@@ -0,0 +1,129 @@
+const test = require('node:test');
+const assert = require('node:assert/strict');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const {
+    addProfile,
+    importProfile,
+    writeCurrentProfile,
+    readCurrentProfile,
+    listProfiles,
+    resolveProfileConfigPath,
+    isFileConfigPath,
+} = require('../lib/profile');
+const { getQiniuConfig } = require('../lib/config');
+
+function makeWorkspace() {
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'struggler-cli-profile-'));
+    return fs.realpathSync(dir);
+}
+
+function withTempProfileHome(workspace, run) {
+    const prevHome = process.env.STRUGGLER_CLI_HOME;
+    process.env.STRUGGLER_CLI_HOME = path.join(workspace, '.home');
+    try {
+        return run();
+    } finally {
+        if (prevHome === undefined) {
+            delete process.env.STRUGGLER_CLI_HOME;
+        } else {
+            process.env.STRUGGLER_CLI_HOME = prevHome;
+        }
+    }
+}
+
+function samePath(a, b) {
+    const norm = (p) => {
+        try {
+            return fs.realpathSync(p);
+        } catch {
+            const dir = path.dirname(p);
+            const base = path.basename(p);
+            try {
+                return path.join(fs.realpathSync(dir), base);
+            } catch {
+                return path.resolve(p);
+            }
+        }
+    };
+    return norm(a) === norm(b);
+}
+
+test('profile paths work on any platform', () => {
+    const workspace = makeWorkspace();
+    const prev = process.cwd();
+    process.chdir(workspace);
+    try {
+        withTempProfileHome(workspace, () => {
+            addProfile('prod', path.resolve(__dirname, '../def/qiniu.json'));
+            const profileFile = path.join(workspace, '.home', '.struggler-cli', 'profiles', 'prod.json');
+            assert.equal(fs.existsSync(profileFile), true);
+            assert.match(profileFile, /profiles[\\/]prod\.json$/);
+        });
+    } finally {
+        process.chdir(prev);
+    }
+});
+
+test('resolve current profile when -c is omitted', () => {
+    const workspace = makeWorkspace();
+    const prev = process.cwd();
+    process.chdir(workspace);
+    try {
+        withTempProfileHome(workspace, () => {
+            addProfile('staging', path.resolve(__dirname, '../def/qiniu.json'));
+            writeCurrentProfile('staging');
+            const resolved = resolveProfileConfigPath({});
+            const expected = path.join(workspace, '.home', '.struggler-cli', 'profiles', 'staging.json');
+            assert.equal(samePath(resolved, expected), true);
+        });
+    } finally {
+        process.chdir(prev);
+    }
+});
+
+test('-c prod resolves profile name; -c with path resolves file', () => {
+    const workspace = makeWorkspace();
+    const prev = process.cwd();
+    process.chdir(workspace);
+    try {
+        withTempProfileHome(workspace, () => {
+            importProfile('prod', path.resolve(__dirname, '../def/qiniu.json'));
+            const byName = resolveProfileConfigPath({ config: 'prod' });
+            assert.equal(
+                samePath(byName, path.join(workspace, '.home', '.struggler-cli', 'profiles', 'prod.json')),
+                true
+            );
+
+            const legacy = path.join(workspace, 'command', 'qiniu.json');
+            fs.mkdirSync(path.dirname(legacy), { recursive: true });
+            fs.copyFileSync(path.resolve(__dirname, '../def/qiniu.json'), legacy);
+            assert.equal(isFileConfigPath('./command/qiniu.json'), true);
+            assert.equal(
+                samePath(resolveProfileConfigPath({ config: './command/qiniu.json' }), legacy),
+                true
+            );
+        });
+    } finally {
+        process.chdir(prev);
+    }
+});
+
+test('getQiniuConfig falls back to command/qiniu.json without profile', () => {
+    const workspace = makeWorkspace();
+    const prev = process.cwd();
+    process.chdir(workspace);
+    try {
+        withTempProfileHome(workspace, () => {
+            assert.equal(listProfiles().length, 0);
+            assert.equal(readCurrentProfile(), null);
+            assert.equal(
+                samePath(getQiniuConfig({}), path.join(workspace, 'command', 'qiniu.json')),
+                true
+            );
+        });
+    } finally {
+        process.chdir(prev);
+    }
+});