@struggler/cli 1.0.12 → 1.0.14

package/Makefile

@@ -13,7 +13,7 @@ JSON ?=
 SKIP_INIT ?=
 SKIP_REFRESH ?=
 
-.PHONY: help install reinstall link unlink init upload refresh deploy add-version example-upload test
+.PHONY: help install reinstall link unlink init upload refresh deploy add-version example-upload test completion-install
 
 help:
 	@echo "Available targets:"
@@ -28,6 +28,7 @@ help:
 	@echo "  make add-version                Run the package version bump script"
 	@echo "  make example-upload             Upload the sample test/dist3 directory"
 	@echo "  make test                       Run the automated test suite"
+	@echo "  make completion-install         Install zsh completion (adds to ~/.zshrc)"
 	@echo ""
 	@echo "Variables:"
 	@echo "  CONFIG=$(CONFIG)"
@@ -55,9 +56,16 @@ link:
 		$(PNPM) setup; \
 	fi
 	@$(PNPM) link --global
+	@hash -r
+	@which struggler-cli || true
+	@struggler-cli -v || true
+	@echo ""
+	@$(NODE) $(CLI_ENTRY) completion install || 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
@@ -79,3 +87,19 @@ example-upload:
 
 test:
 	$(PNPM) test
+
+completion-install:
+	@FPATH_DIR="$${HOME}/.zsh/completions"; \
+	mkdir -p "$$FPATH_DIR"; \
+	$(NODE) $(CLI_ENTRY) completion zsh > "$$FPATH_DIR/_struggler-cli"; \
+	echo "  ✓  zsh completion installed: $$FPATH_DIR/_struggler-cli"; \
+	if ! grep -q "$$FPATH_DIR" "$${HOME}/.zshrc" 2>/dev/null; then \
+		echo "" >> "$${HOME}/.zshrc"; \
+		echo "# struggler-cli zsh completion" >> "$${HOME}/.zshrc"; \
+		echo "fpath=($$FPATH_DIR \$$fpath)" >> "$${HOME}/.zshrc"; \
+		echo "autoload -Uz compinit && compinit" >> "$${HOME}/.zshrc"; \
+		echo "  ✓  added fpath to ~/.zshrc"; \
+	else \
+		echo "  ·  fpath already in ~/.zshrc, skipped"; \
+	fi; \
+	echo "  →  run: source ~/.zshrc"

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,26 +16,121 @@ 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.
+
+```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
+
+your-project/
+  command/
+    config.json            # deploy prefix (publicPath / base), from init
+    upload-cache.json      # upload cache (optional)
+  dist/                    # build output to upload (-d)
+```
+
+### Step 1 — Create a profile
+
+From your project root:
+
+```bash
+struggler-cli profile add prod
+```
+
+This creates `~/.struggler-cli/profiles/prod.json` from the built-in template. Open it and fill in:
+
+| 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
+```
+
+Or pass the profile name per command: `-c prod`.
+
+### Step 3 — Generate deploy metadata
+
+```bash
+struggler-cli init -d ./dist
+```
+
+Writes `command/config.json` with a timestamped `publicPath` and `base` URL (always under `./command/`, same as older versions).
+
+### Step 4 — Upload
+
+```bash
+struggler-cli upload -d ./dist
+```
+
+### More environments
+
+```bash
+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
+```
+
+Because profiles are user-level, they are outside your project repo by default.
 
-The CLI expects two files in the same directory:
+## Legacy setup (single `command/qiniu.json`)
 
-- `qiniu.json`: Qiniu credentials and bucket metadata
-- `config.json`: generated deploy prefix metadata used by upload/refresh
+Still supported for existing projects:
 
-Example `qiniu.json`:
+```text
+command/
+  qiniu.json
+  config.json
+```
 
-```json
-{
-  "path": "your-project",
-  "accessKey": "",
-  "secretKey": "",
-  "Bucket": "",
-  "zone": "Zone_z1",
-  "domain": "https://cdn.example.com/"
-}
+```bash
+struggler-cli init -c ./command/qiniu.json -d ./dist
+struggler-cli upload -c ./command/qiniu.json -d ./dist
 ```
 
+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
+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
@@ -53,66 +150,81 @@ legacy/**
 Initialize versioned config:
 
 ```bash
-node ./index.js --config ./command/qiniu.json --dir ./dist init
+struggler-cli init -d ./dist
 ```
 
-Preview upload work without changing files or calling Qiniu:
+Preview upload:
 
 ```bash
-node ./index.js --config ./command/qiniu.json --dir ./dist --dry-run upload
+struggler-cli --dry-run upload -d ./dist
 ```
 
 Upload with concurrency:
 
 ```bash
-node ./index.js --config ./command/qiniu.json --dir ./dist --concurrency 8 upload
+struggler-cli upload -d ./dist --concurrency 8
 ```
 
-Upload with ignore patterns and a manifest:
+Full deploy:
 
 ```bash
-node ./index.js --config ./command/qiniu.json --dir ./dist --exclude ".DS_Store,*.map" --manifest ./artifacts/upload-manifest.json upload
+struggler-cli deploy -d ./dist --concurrency 8
 ```
 
-Refresh CDN for generated URLs:
+Machine-readable output:
 
 ```bash
-node ./index.js --config ./command/qiniu.json --dir ./dist refresh
+struggler-cli deploy -d ./dist --json --dry-run
 ```
 
-Run the full flow:
+## Windows notes
 
-```bash
-node ./index.js --config ./command/qiniu.json --dir ./dist --concurrency 8 deploy
-```
+- 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"`.
+
+## Shell completion
+
+Enable tab completion for subcommands, flags, and profile names.
 
-Skip parts of deploy:
+### zsh (recommended)
+
+One-liner install:
 
 ```bash
-node ./index.js --config ./command/qiniu.json --dir ./dist --skip-refresh deploy
+make completion-install
+source ~/.zshrc
 ```
 
-Machine-readable output:
+Or manually:
 
 ```bash
-node ./index.js --config ./command/qiniu.json --dir ./dist --json --dry-run deploy
+mkdir -p ~/.zsh/completions
+struggler-cli completion zsh > ~/.zsh/completions/_struggler-cli
+# add to ~/.zshrc if not already present:
+echo 'fpath=(~/.zsh/completions $fpath)' >> ~/.zshrc
+echo 'autoload -Uz compinit && compinit' >> ~/.zshrc
+source ~/.zshrc
 ```
 
-Version bump script:
+### bash
 
 ```bash
-pnpm add-version
+struggler-cli completion bash >> ~/.bash_profile
+source ~/.bash_profile
 ```
 
-## Makefile Shortcuts
+After installation, `struggler-cli <TAB>` completes subcommands, flags, and `profile use <TAB>` completes your profile names.
+
+## 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 +233,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/completion.js

@@ -0,0 +1,260 @@
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { listProfiles } = require('../lib/profile');
+
+// Completion scripts are built from string arrays to avoid
+// conflicts between JS template literals and shell variable syntax like ${(f)...}.
+
+function zshScript() {
+    const lines = [
+        '#compdef struggler-cli',
+        '',
+        '_struggler_cli() {',
+        '  local context state line',
+        '  typeset -A opt_args',
+        '',
+        '  _arguments -C \\',
+        "    '(-v --version)'{-v,--version}'[show version]' \\",
+        "    '(-h --help)'{-h,--help}'[show help]' \\",
+        "    '(-c --config)'{-c,--config}'[qiniu config: profile name or file path]:config:' \\",
+        "    '--config-dir[meta config directory]:dir:_files -/' \\",
+        "    '(-d --dir)'{-d,--dir}'[upload source directory]:dir:_files -/' \\",
+        "    '--dry-run[preview without writing or calling qiniu]' \\",
+        "    '--concurrency[upload concurrency]:number:(1 2 3 4 5 8 10)' \\",
+        "    '--exclude[exclude glob pattern]:pattern:' \\",
+        "    '--ignore-file[custom ignore file]:file:_files' \\",
+        "    '--manifest[write result to manifest json]:file:_files' \\",
+        "    '--json[machine-readable json output]' \\",
+        "    '--skip-init[skip init step in deploy]' \\",
+        "    '--skip-refresh[skip refresh step in deploy]' \\",
+        "    '--no-cache[force re-upload all files]' \\",
+        "    '--lang[ui language]:lang:(zh en)' \\",
+        "    '1: :_struggler_cli_cmds' \\",
+        "    '*::arg:->args'",
+        '',
+        '  case $state in',
+        '    args)',
+        '      case $line[1] in',
+        '        profile)',
+        '          _struggler_cli_profile',
+        '          ;;',
+        '        completion)',
+        "          _arguments '1:shell:(zsh bash)'",
+        '          ;;',
+        '        init|upload|refresh|deploy)',
+        "          _message 'no more subcommands'",
+        '          ;;',
+        '      esac',
+        '      ;;',
+        '  esac',
+        '}',
+        '',
+        '_struggler_cli_cmds() {',
+        '  local cmds',
+        '  cmds=(',
+        "    'init:generate versioned upload config'",
+        "    'upload:upload build files to qiniu'",
+        "    'refresh:refresh qiniu cdn urls'",
+        "    'deploy:run init + upload + refresh'",
+        "    'profile:manage qiniu credential profiles'",
+        "    'completion:output shell completion script'",
+        '  )',
+        "  _describe 'command' cmds",
+        '}',
+        '',
+        '_struggler_cli_profile() {',
+        '  local subcmds',
+        '  subcmds=(',
+        "    'list:list all profiles'",
+        "    'use:set active profile'",
+        "    'current:show active profile'",
+        "    'add:create profile from template'",
+        "    'import:import profile from file'",
+        '  )',
+        '',
+        '  if (( CURRENT == 2 )); then',
+        "    _describe 'profile subcommand' subcmds",
+        '    return',
+        '  fi',
+        '',
+        '  case $words[2] in',
+        '    use)',
+        // Use a dedicated CLI helper to list profiles, avoiding nested quote hell
+        '      local profiles',
+        '      profiles=($(struggler-cli completion --list-profiles 2>/dev/null))',
+        '      if [[ ${#profiles[@]} -gt 0 ]]; then',
+        "        _describe 'profile' profiles",
+        '      else',
+        "        _message 'profile name'",
+        '      fi',
+        '      ;;',
+        '    import)',
+        "      (( CURRENT == 3 )) && _message 'profile name'",
+        '      (( CURRENT == 4 )) && _files',
+        '      ;;',
+        '  esac',
+        '}',
+        '',
+        '_struggler_cli',
+        '',
+    ];
+    return lines.join('\n');
+}
+
+function bashScript() {
+    const lines = [
+        '# bash completion for struggler-cli',
+        '# source this file or put in ~/.bash_completion.d/struggler-cli',
+        '',
+        '_struggler_cli_completion() {',
+        '  local cur prev words cword',
+        '  _init_completion 2>/dev/null || {',
+        '    COMPREPLY=()',
+        '    cur="${COMP_WORDS[COMP_CWORD]}"',
+        '    prev="${COMP_WORDS[COMP_CWORD-1]}"',
+        '  }',
+        '',
+        '  local cmds="init upload refresh deploy profile completion"',
+        '  local profile_cmds="list use current add import"',
+        '  local global_opts="-v --version -h --help -c --config --config-dir -d --dir --dry-run --concurrency --exclude --ignore-file --manifest --json --skip-init --skip-refresh --no-cache --lang"',
+        '',
+        '  if [[ ${COMP_CWORD} -eq 1 ]]; then',
+        '    COMPREPLY=($(compgen -W "${cmds}" -- "${cur}"))',
+        '    return',
+        '  fi',
+        '',
+        '  case "${COMP_WORDS[1]}" in',
+        '    profile)',
+        '      if [[ ${COMP_CWORD} -eq 2 ]]; then',
+        '        COMPREPLY=($(compgen -W "${profile_cmds}" -- "${cur}"))',
+        '        return',
+        '      fi',
+        '      if [[ "${COMP_WORDS[2]}" == "use" && ${COMP_CWORD} -eq 3 ]]; then',
+        '        local profiles',
+        '        profiles=$(struggler-cli completion --list-profiles 2>/dev/null)',
+        '        COMPREPLY=($(compgen -W "${profiles}" -- "${cur}"))',
+        '        return',
+        '      fi',
+        '      ;;',
+        '    completion)',
+        '      if [[ ${COMP_CWORD} -eq 2 ]]; then',
+        '        COMPREPLY=($(compgen -W "zsh bash" -- "${cur}"))',
+        '        return',
+        '      fi',
+        '      ;;',
+        '    init|upload|refresh|deploy)',
+        '      COMPREPLY=($(compgen -W "${global_opts}" -- "${cur}"))',
+        '      return',
+        '      ;;',
+        '  esac',
+        '}',
+        '',
+        'complete -F _struggler_cli_completion struggler-cli',
+        '',
+    ];
+    return lines.join('\n');
+}
+
+function detectShell() {
+    const shellBin = process.env.SHELL || '';
+    if (shellBin.endsWith('zsh')) return 'zsh';
+    if (shellBin.endsWith('bash')) return 'bash';
+    return null;
+}
+
+function installZsh(script) {
+    const dir = path.join(os.homedir(), '.zsh', 'completions');
+    const file = path.join(dir, '_struggler-cli');
+    const rcFile = path.join(os.homedir(), '.zshrc');
+
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(file, script, 'utf8');
+    console.log('  \u2713  zsh completion installed: ' + file);
+
+    let rc = '';
+    try { rc = fs.readFileSync(rcFile, 'utf8'); } catch { /* new file */ }
+
+    const fpathLine = 'fpath=(' + dir + ' $fpath)';
+    const compLine = 'autoload -Uz compinit && compinit';
+    const marker = '# struggler-cli completion';
+
+    if (!rc.includes(marker)) {
+        const addition = '\n' + marker + '\n' + fpathLine + '\n' + compLine + '\n';
+        fs.appendFileSync(rcFile, addition, 'utf8');
+        console.log('  \u2713  added fpath + compinit to ~/.zshrc');
+    } else {
+        console.log('  \u00b7  ~/.zshrc already configured, skipped');
+    }
+    console.log('  \u2192  run: source ~/.zshrc');
+}
+
+function installBash(script) {
+    const dir = path.join(os.homedir(), '.bash_completion.d');
+    const file = path.join(dir, 'struggler-cli');
+    const rcFile = path.join(os.homedir(), '.bash_profile');
+
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(file, script, 'utf8');
+    console.log('  \u2713  bash completion installed: ' + file);
+
+    let rc = '';
+    try { rc = fs.readFileSync(rcFile, 'utf8'); } catch { /* new file */ }
+
+    const marker = '# struggler-cli completion';
+    if (!rc.includes(marker)) {
+        const addition = '\n' + marker + '\n[ -f ' + file + ' ] && source ' + file + '\n';
+        fs.appendFileSync(rcFile, addition, 'utf8');
+        console.log('  \u2713  added source line to ~/.bash_profile');
+    } else {
+        console.log('  \u00b7  ~/.bash_profile already configured, skipped');
+    }
+    console.log('  \u2192  run: source ~/.bash_profile');
+}
+
+function installAction(_options) {
+    const shell = detectShell();
+    if (!shell) {
+        process.stderr.write('Cannot detect shell from $SHELL. Run manually:\n');
+        process.stderr.write('  struggler-cli completion zsh  > ~/.zsh/completions/_struggler-cli\n');
+        process.stderr.write('  struggler-cli completion bash > ~/.bash_completion.d/struggler-cli\n');
+        process.exitCode = 1;
+        return;
+    }
+    console.log('  detected shell: ' + shell);
+    if (shell === 'zsh') {
+        installZsh(zshScript());
+    } else {
+        installBash(bashScript());
+    }
+}
+
+function completionAction(shell, options) {
+    // Internal helper: list profile names for shell completion scripts
+    if (options && options.listProfiles) {
+        try {
+            listProfiles().forEach((name) => process.stdout.write(name + '\n'));
+        } catch {
+            // silently fail; completion scripts handle empty output
+        }
+        return;
+    }
+
+    // Auto-install to current shell
+    if (shell === 'install' || (options && options.install)) {
+        installAction(options);
+        return;
+    }
+
+    const s = (shell || '').toLowerCase();
+    if (s === 'zsh') {
+        process.stdout.write(zshScript());
+    } else if (s === 'bash') {
+        process.stdout.write(bashScript());
+    } else {
+        process.stderr.write('Usage: struggler-cli completion <zsh|bash|install>\n');
+        process.exitCode = 1;
+    }
+}
+
+module.exports = completionAction;

package/command/index.js

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

package/command/profile.js

@@ -0,0 +1,88 @@
+const path = require('path');
+const chalk = require('chalk');
+const {
+    listProfiles,
+    readCurrentProfile,
+    writeCurrentProfile,
+    importProfile,
+    addProfile,
+    getProfilePath,
+    getProfilesDir,
+} = require('../lib/profile');
+const { printMessage, printJson, shouldUseJson } = 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));
+    }
+    const result = { profiles, current };
+    if (shouldUseJson(options)) {
+        printJson(result);
+    }
+    return result;
+}
+
+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

@@ -9,14 +9,15 @@ const { resolveLang, getLocale } = require("./lib/i18n")
 const lang = resolveLang(process.argv)
 const locale = getLocale(lang)
 const isJsonMode = process.argv.includes("--json")
+const isVersionMode = process.argv.includes("-v") || process.argv.includes("--version")
 
-// 清除命令行
-if (!shouldUseJson({ json: isJsonMode })) {
-	clear()
-}
+// 只有在没有执行具体子命令时（即展示根 help）才显示 logo
+const KNOWN_CMDS = new Set(['init', 'upload', 'refresh', 'deploy', 'profile', 'completion'])
+const hasSubCmd = process.argv.slice(2).some((a) => KNOWN_CMDS.has(a))
+const showLogo = !isJsonMode && !hasSubCmd && !isVersionMode
 
-// 输出Logo
-if (!isJsonMode) {
+if (showLogo) {
+	clear()
 	console.log(require('./lib/logo') + '\n')
 }
 
@@ -58,7 +59,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,7 +89,53 @@ program
 		await command.deploy(program.opts())
 	})
 
-program.addHelpCommand(true, locale.help.helpCommandDescription)
+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
+	.command("completion [shell]")
+	.description(locale.commands.completion)
+	.option("--list-profiles", "list profile names (used by shell completion)")
+	.addHelpText('after', '\nshell: zsh | bash | install (auto-detect and install)')
+	.action((shell, cmdOpts) => {
+		command.completion(shell, { ...program.opts(), ...cmdOpts })
+	})
+
+program.addHelpCommand(false)
 
 program.parseAsync().catch(error => {
 	if (isJsonMode) {

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,6 +12,10 @@ function resolveFromCwd(targetPath) {
 }
 
 function getQiniuConfigPath(options = {}) {
+    const profilePath = resolveProfileConfigPath(options);
+    if (profilePath) {
+        return profilePath;
+    }
     return resolveFromCwd(options.config || DEFAULT_QINIU_CONFIG);
 }
 
@@ -25,24 +30,19 @@ function resolveConfigDirOption(options = {}) {
     return null;
 }
 
-/** config.json / upload-cache.json 所在目录；优先级：CLI --config-dir > qiniu.json configDir > 与 qiniu 同目录 > ./command */
+/** config.json / upload-cache.json 所在目录；优先级：CLI --config-dir > qiniu.json configDir > 默认 ./command（与旧版一致，不随 -c 目录变化） */
 function getMetaDir(options = {}) {
     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 所在目录；可写 --config-dir ./command，单独写 --config-dir 时默认为 ./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,13 @@ const LANGUAGES = {
             upload: '将指定目录下文件上传到七牛云。',
             refresh: '刷新七牛云 CDN 文件。',
             deploy: '一次执行 init、upload 和 refresh。',
+            profile: '管理多套七牛配置（profile）。',
+            profileList: '列出所有 profile',
+            profileUse: '切换当前 profile',
+            profileCurrent: '显示当前 profile',
+            profileAdd: '从模版新建 profile',
+            profileImport: '从已有文件导入 profile',
+            completion: '输出 shell 补全脚本（zsh / bash），或 install 自动安装到当前 shell',
         },
         help: {
             helpCommandDescription: '显示指定命令的帮助信息',
@@ -104,15 +120,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; use --config-dir ./command, or --config-dir alone for ./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 +156,13 @@ 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',
+            completion: 'Output shell completion script (zsh / bash), or "install" to auto-install for current shell',
         },
         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.12",
+	"version": "1.0.14",
 	"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),
@@ -48,6 +48,17 @@ test('config-dir flag without path defaults to ./command', () => {
     );
 });
 
+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);
+    }
+});