bdpan-cli 0.1.0__tar.gz → 0.2.0__tar.gz

{bdpan_cli-0.1.0 → bdpan_cli-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: bdpan-cli
-Version: 0.1.0
+Version: 0.2.0
 Summary: 百度网盘工程化 CLI 管理工具
 Keywords: baidu-pan,netdisk,cli,scraper,backup,cloud-storage
 Author: CodingRookie98
@@ -57,11 +57,23 @@ pip install bdpan-cli
 
 ### 方式 4：跨平台单文件二进制（免 Python 运行时）
 前往 [GitHub Releases](https://github.com/CodingRookie98/bdpan-cli/releases) 直接下载对应平台单文件二进制可执行包，加入 `PATH` 即可运行：
-- `bdpan-linux-amd64`
-- `bdpan-linux-arm64`
-- `bdpan-macos-arm64` (Apple Silicon)
-- `bdpan-macos-x86_64` (Intel)
-- `bdpan-windows-amd64.exe`
+- `bdpan-linux-amd64` (Linux x86_64)
+- `bdpan-macos-arm64` (macOS Apple Silicon)
+- `bdpan-windows-amd64.exe` (Windows x86_64)
+
+### 快速开始 (Quickstart)
+
+```bash
+# 1. 配置百度开放平台凭证（仅需一次，保存在 ~/.config/bdpan/.env）
+bdpan auth config --app-key <YOUR_APP_KEY> --secret-key <YOUR_SECRET_KEY>
+
+# 2. 授权登录网盘账号（自动唤起默认浏览器打开授权页）
+bdpan auth login
+
+# 3. 立即使用
+bdpan whoami
+bdpan ls /
+```
 
 ---
 
@@ -96,11 +108,14 @@ bdpan ops list [--limit 20]               # 查看关键变更操作流水审计
 bdpan ops show <op_id>                    # 查看某次操作的明细与映射清单
 bdpan undo <op_id> [--dry-run] [-y]       # 逆向撤销回滚指定批次操作（支持预演）
 
-# 多账号认证与隔离 (Multi-Account Auth)
-bdpan auth list                           # 查看本地保存的网盘账号及凭证有效性
-bdpan auth switch <alias>                 # 切换当前默认活跃账号
-bdpan auth login [--account <alias>]      # 登录/重新授权指定账号别名
-bdpan --account <alias> <subcommand>      # 临时以指定账号执行单次命令（多租户并发隔离）
+# 认证配置与多账号管理 (Auth & Multi-Account)
+bdpan auth config --app-key <key> --secret-key <secret> # 快速写入全局开发者凭据 (~/.config/bdpan/.env)
+bdpan auth config --show                      # 查看当前凭据来源与脱敏信息
+bdpan auth config --path                      # 打印全局配置文件物理路径
+bdpan auth login [--account <alias>]          # 启动设备码授权（自动唤起默认浏览器并高亮授权码）
+bdpan auth list                               # 查看本地保存的网盘账号及凭证有效性
+bdpan auth switch <alias>                     # 切换当前默认活跃账号
+bdpan --account <alias> <subcommand>          # 临时以指定账号执行单次命令（多租户并发隔离）
 
 # 媒体可观测性与全局选项 (Media Insights & Global Options)
 bdpan info /影视/电影/Inception.mkv        # 探测视频精准分辨率(4K/1080P)、时长、HEVC编码与音轨

{bdpan_cli-0.1.0 → bdpan_cli-0.2.0}/README.md

@@ -29,11 +29,23 @@ pip install bdpan-cli
 
 ### 方式 4：跨平台单文件二进制（免 Python 运行时）
 前往 [GitHub Releases](https://github.com/CodingRookie98/bdpan-cli/releases) 直接下载对应平台单文件二进制可执行包，加入 `PATH` 即可运行：
-- `bdpan-linux-amd64`
-- `bdpan-linux-arm64`
-- `bdpan-macos-arm64` (Apple Silicon)
-- `bdpan-macos-x86_64` (Intel)
-- `bdpan-windows-amd64.exe`
+- `bdpan-linux-amd64` (Linux x86_64)
+- `bdpan-macos-arm64` (macOS Apple Silicon)
+- `bdpan-windows-amd64.exe` (Windows x86_64)
+
+### 快速开始 (Quickstart)
+
+```bash
+# 1. 配置百度开放平台凭证（仅需一次，保存在 ~/.config/bdpan/.env）
+bdpan auth config --app-key <YOUR_APP_KEY> --secret-key <YOUR_SECRET_KEY>
+
+# 2. 授权登录网盘账号（自动唤起默认浏览器打开授权页）
+bdpan auth login
+
+# 3. 立即使用
+bdpan whoami
+bdpan ls /
+```
 
 ---
 
@@ -68,11 +80,14 @@ bdpan ops list [--limit 20]               # 查看关键变更操作流水审计
 bdpan ops show <op_id>                    # 查看某次操作的明细与映射清单
 bdpan undo <op_id> [--dry-run] [-y]       # 逆向撤销回滚指定批次操作（支持预演）
 
-# 多账号认证与隔离 (Multi-Account Auth)
-bdpan auth list                           # 查看本地保存的网盘账号及凭证有效性
-bdpan auth switch <alias>                 # 切换当前默认活跃账号
-bdpan auth login [--account <alias>]      # 登录/重新授权指定账号别名
-bdpan --account <alias> <subcommand>      # 临时以指定账号执行单次命令（多租户并发隔离）
+# 认证配置与多账号管理 (Auth & Multi-Account)
+bdpan auth config --app-key <key> --secret-key <secret> # 快速写入全局开发者凭据 (~/.config/bdpan/.env)
+bdpan auth config --show                      # 查看当前凭据来源与脱敏信息
+bdpan auth config --path                      # 打印全局配置文件物理路径
+bdpan auth login [--account <alias>]          # 启动设备码授权（自动唤起默认浏览器并高亮授权码）
+bdpan auth list                               # 查看本地保存的网盘账号及凭证有效性
+bdpan auth switch <alias>                     # 切换当前默认活跃账号
+bdpan --account <alias> <subcommand>          # 临时以指定账号执行单次命令（多租户并发隔离）
 
 # 媒体可观测性与全局选项 (Media Insights & Global Options)
 bdpan info /影视/电影/Inception.mkv        # 探测视频精准分辨率(4K/1080P)、时长、HEVC编码与音轨

{bdpan_cli-0.1.0 → bdpan_cli-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "bdpan-cli"
-version = "0.1.0"
+version = "0.2.0"
 description = "百度网盘工程化 CLI 管理工具"
 readme = "README.md"
 requires-python = ">=3.12"

{bdpan_cli-0.1.0 → bdpan_cli-0.2.0}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "bdpan-cli"
-version = "0.1.0"
+version = "0.2.0"
 description = "百度网盘工程化 CLI 管理工具"
 readme = "README.md"
 license = { text = "MIT" }

{bdpan_cli-0.1.0 → bdpan_cli-0.2.0}/src/bdpan_cli/__init__.py

@@ -7,9 +7,23 @@ from bdpan_cli._vendor.openapi_client.api.fileinfo_api import FileinfoApi
 from bdpan_cli._vendor.openapi_client.rest import ApiException
 
 from bdpan_cli.auth import TokenManager
-from bdpan_cli.config import load_config
+from bdpan_cli.config import (
+    AppConfig,
+    ConfigError,
+    get_global_config_path,
+    load_config,
+    save_global_config,
+)
 from bdpan_cli._version import __version__
 
 from bdpan_cli.cli import main
 
-__all__ = ["main", "__version__"]
+__all__ = [
+    "main",
+    "__version__",
+    "AppConfig",
+    "ConfigError",
+    "load_config",
+    "get_global_config_path",
+    "save_global_config",
+]

{bdpan_cli-0.1.0 → bdpan_cli-0.2.0}/src/bdpan_cli/_version.py

@@ -1,3 +1,3 @@
 """Version definition for bdpan-cli."""
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"

{bdpan_cli-0.1.0 → bdpan_cli-0.2.0}/src/bdpan_cli/auth.py

@@ -16,7 +16,7 @@ from bdpan_cli._vendor.openapi_client.rest import ApiException
 from bdpan_cli.config import AppConfig
 
 # 默认用户端 Token 凭据路径遵循 XDG 规范 (~/.config/bdpan/tokens.json)
-DEFAULT_CONFIG_DIR = Path.home() / ".config" / "bdpan"
+DEFAULT_CONFIG_DIR = Path(os.environ.get("XDG_CONFIG_HOME", Path.home() / ".config")) / "bdpan"
 DEFAULT_TOKEN_FILE = DEFAULT_CONFIG_DIR / "tokens.json"
 LEGACY_TOKEN_CACHE = Path(__file__).resolve().parents[2] / ".baidupan_tokens.json"
 
@@ -193,10 +193,22 @@ class TokenManager:
             device = auth.oauth_token_device_code(self._config.app_key, SCOPE)
             interval = max(int(device.interval or 5), 3)
             deadline = time.time() + int(device.expires_in or 300)
-            print(
-                f"请打开 {device.verification_url} ，输入用户码 {device.user_code} 并确认授权",
-                flush=True,
-            )
+
+            # 尝试自动在默认浏览器中打开授权页面
+            try:
+                import webbrowser
+                webbrowser.open(device.verification_url)
+            except Exception:
+                pass
+
+            print("\n" + "=" * 66, flush=True)
+            print("🔗 请在浏览器中打开授权页面完成登录：", flush=True)
+            print(f"   {device.verification_url}", flush=True)
+            print("\n🔑 您的设备授权码 (User Code)：", flush=True)
+            print(f"   👉  {device.user_code}  👈", flush=True)
+            print("\n（系统已尝试唤起默认浏览器；如未弹出，请手动复制上述链接访问并输入授权码）", flush=True)
+            print("=" * 66 + "\n", flush=True)
+            print("⏳ 正在等待网页端授权确认...", flush=True)
             while time.time() < deadline:
                 time.sleep(interval)
                 try:
@@ -213,6 +225,6 @@ class TokenManager:
                         interval += 5
                         continue
                     raise RuntimeError(f"设备码授权失败：{body}") from e
-                print("授权成功", flush=True)
+                print("🎉 授权成功！", flush=True)
                 return self._save_cache(self._to_cache(response))
         raise AuthorizationNeeded("设备码已过期，请重新运行")

{bdpan_cli-0.1.0 → bdpan_cli-0.2.0}/src/bdpan_cli/cli.py

@@ -8,11 +8,17 @@ import logging
 import os
 import sys
 from datetime import datetime
+from pathlib import Path
 from typing import Any
 
 from bdpan_cli.account import AccountClient, AccountError
 from bdpan_cli.auth import TOKEN_CACHE, TokenManager
-from bdpan_cli.config import load_config
+from bdpan_cli.config import (
+    ConfigError,
+    get_global_config_path,
+    load_config,
+    save_global_config,
+)
 from bdpan_cli.dedup import execute_dedup, plan_dedup
 from bdpan_cli.downloader import DownloadError, Downloader
 from bdpan_cli.file_manager import FileManager, FileManagerError
@@ -761,6 +767,85 @@ def cmd_undo(args: argparse.Namespace) -> int:
 def cmd_auth(args: argparse.Namespace) -> int:
     """网盘账号认证与多租户管理。"""
     subcmd = getattr(args, "auth_subcmd", None)
+
+    if subcmd == "config":
+        # 1. 打印全局配置文件路径
+        if getattr(args, "path", False):
+            print(str(get_global_config_path()))
+            return 0
+
+        # 2. 显示当前配置状态（脱敏）
+        if getattr(args, "show", False):
+            global_path = get_global_config_path()
+            local_path = Path.cwd() / ".env"
+            has_env = bool(os.getenv("BAIDU_APP_KEY") and os.getenv("BAIDU_SECRET_KEY"))
+
+            try:
+                cfg = load_config()
+                app_key = cfg.app_key
+                secret_key = cfg.secret_key
+                masked_app = app_key[:3] + "..." + app_key[-3:] if len(app_key) > 6 else "***"
+                masked_secret = secret_key[:3] + "..." + secret_key[-3:] if len(secret_key) > 6 else "***"
+
+                source = "环境变量" if has_env else ("当前目录 .env" if local_path.exists() else f"全局配置 ({global_path})")
+                if getattr(args, "json", False):
+                    return _output_envelope({
+                        "source": source,
+                        "global_path": str(global_path),
+                        "app_key": masked_app,
+                        "secret_key": masked_secret,
+                    })
+                print("\n📋 百度网盘开放平台开发者凭证配置状态:")
+                print(f"  • 配置来源: {source}")
+                print(f"  • BAIDU_APP_KEY:    {masked_app}")
+                print(f"  • BAIDU_SECRET_KEY: {masked_secret}")
+                print(f"  • 全局配置文件位置: {global_path}\n")
+                return 0
+            except ConfigError as e:
+                if getattr(args, "json", False):
+                    return _output_envelope(None, success=False, code=1, error=str(e))
+                print("\n⚠️ 尚未检测到有效开发者凭证配置。", file=sys.stderr)
+                print(f"  全局配置文件位置: {global_path}", file=sys.stderr)
+                print("  提示：请运行 'bdpan auth config --app-key <KEY> --secret-key <SECRET>' 写入全局配置。\n", file=sys.stderr)
+                return 1
+
+        # 3. 写入配置
+        app_key = getattr(args, "app_key", None)
+        secret_key = getattr(args, "secret_key", None)
+
+        if not app_key or not secret_key:
+            if sys.stdin.isatty() and not getattr(args, "json", False):
+                print("请输入百度网盘开放平台的开发者凭证（可从 https://pan.baidu.com/union 获取）：")
+                if not app_key:
+                    try:
+                        app_key = input("  BAIDU_APP_KEY: ").strip()
+                    except (EOFError, KeyboardInterrupt):
+                        print("\n操作已取消。")
+                        return 1
+                if not secret_key:
+                    try:
+                        secret_key = input("  BAIDU_SECRET_KEY: ").strip()
+                    except (EOFError, KeyboardInterrupt):
+                        print("\n操作已取消。")
+                        return 1
+
+        if not app_key or not secret_key:
+            msg = (
+                "缺少凭据参数。请提供 --app-key 与 --secret-key，例如：\n"
+                "  bdpan auth config --app-key YOUR_APP_KEY --secret-key YOUR_SECRET_KEY"
+            )
+            if getattr(args, "json", False):
+                return _output_envelope(None, success=False, code=1, error=msg)
+            print(f"❌ {msg}", file=sys.stderr)
+            return 1
+
+        saved_path = save_global_config(app_key, secret_key)
+        if getattr(args, "json", False):
+            return _output_envelope({"saved_path": str(saved_path)})
+        print(f"✅ 开发者凭证已成功保存至全局配置: {saved_path}")
+        print("💡 您现在可以在任意目录直接运行 'bdpan auth login' 或其他 bdpan 命令。")
+        return 0
+
     tm = _get_token_manager(args)
 
     if subcmd == "switch":
@@ -1320,14 +1405,32 @@ def build_parser() -> argparse.ArgumentParser:
     p_auth = subparsers.add_parser(
         "auth",
         help="网盘账号认证与多账号管理",
-        description="百度网盘多账号认证管理系统，支持多租户凭证隔离存储、活跃账号切换与单独授权。",
+        description="百度网盘多账号认证管理系统，支持多租户凭证隔离存储、活跃账号切换、快速配置与单独授权。",
         epilog="""示例:
+  bdpan auth config --app-key YOUR_KEY --secret-key YOUR_SECRET
+  bdpan auth config --show
+  bdpan auth login
   bdpan auth list
-  bdpan auth switch work_pan
-  bdpan auth login --account personal_pan""",
+  bdpan auth switch work_pan""",
         formatter_class=argparse.RawDescriptionHelpFormatter,
     )
     auth_sub = p_auth.add_subparsers(dest="auth_subcmd", help="认证子命令")
+    p_auth_config = auth_sub.add_parser(
+        "config",
+        help="配置或查看百度网盘开发者凭据 (AppKey / SecretKey)",
+        description="配置或查看百度网盘开放平台开发者凭据。凭据将安全保存在用户全局配置目录中 (~/.config/bdpan/.env)。",
+        epilog="""示例:
+  bdpan auth config --app-key YOUR_KEY --secret-key YOUR_SECRET
+  bdpan auth config --show
+  bdpan auth config --path""",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    p_auth_config.add_argument("--app-key", help="百度开放平台 App Key (Client ID)")
+    p_auth_config.add_argument("--secret-key", help="百度开放平台 Secret Key (Client Secret)")
+    p_auth_config.add_argument("--show", action="store_true", help="显示当前配置来源与脱敏凭证")
+    p_auth_config.add_argument("--path", action="store_true", help="输出全局配置文件存储路径")
+    p_auth_config.set_defaults(func=cmd_auth)
+
     p_auth_list = auth_sub.add_parser(
         "list",
         help="列出本地所有网盘账号与到期状态",
@@ -1421,7 +1524,13 @@ def main(argv: list[str] | None = None) -> int:
         parser.print_help()
         return 0
 
-    return args.func(args)
+    try:
+        return args.func(args)
+    except ConfigError as e:
+        if getattr(args, "json", False):
+            return _output_envelope(None, success=False, code=1, error=str(e))
+        print(f"\n❌ 配置缺失: {e}\n", file=sys.stderr)
+        return 1
 
 
 if __name__ == "__main__":

bdpan_cli-0.2.0/src/bdpan_cli/config.py

@@ -0,0 +1,81 @@
+"""应用配置：从环境变量、本地 .env 或 XDG 全局配置读取百度网盘开放平台凭证。"""
+
+import os
+from dataclasses import dataclass
+from pathlib import Path
+
+from dotenv import load_dotenv
+
+# XDG 全局配置目录与文件 (~/.config/bdpan/.env)
+DEFAULT_CONFIG_DIR = Path(os.environ.get("XDG_CONFIG_HOME", Path.home() / ".config")) / "bdpan"
+DEFAULT_CONFIG_FILE = DEFAULT_CONFIG_DIR / ".env"
+
+
+class ConfigError(RuntimeError):
+    """应用配置缺失或无效异常。"""
+
+
+@dataclass(frozen=True)
+class AppConfig:
+    app_key: str
+    secret_key: str
+
+
+def get_global_config_path() -> Path:
+    """获取全局 .env 配置文件的实际路径。"""
+    custom = os.environ.get("BDPAN_CONFIG_PATH")
+    if custom:
+        return Path(custom)
+    return DEFAULT_CONFIG_FILE
+
+
+def load_config() -> AppConfig:
+    """按优先级检索并加载百度开放平台凭证：
+    1. 进程内既有环境变量 (os.environ)
+    2. 当前工作目录下的 .env 文件
+    3. 全局 XDG 配置文件 (~/.config/bdpan/.env)
+
+    若全部未配置，抛出友好的 ConfigError。
+    """
+    # 1. 尝试从当前目录加载 .env (override=False 保护已存在的环境变量)
+    local_env = Path.cwd() / ".env"
+    if local_env.is_file():
+        load_dotenv(dotenv_path=local_env, override=False)
+
+    # 2. 尝试从全局 XDG 配置加载 .env (override=False 保护优先由本地 .env 或环境变量指定的值)
+    global_env = get_global_config_path()
+    if global_env.is_file():
+        load_dotenv(dotenv_path=global_env, override=False)
+
+    values = {
+        "BAIDU_APP_KEY": os.getenv("BAIDU_APP_KEY", "").strip(),
+        "BAIDU_SECRET_KEY": os.getenv("BAIDU_SECRET_KEY", "").strip(),
+    }
+    missing = [name for name, value in values.items() if not value]
+    if missing:
+        raise ConfigError(
+            f"缺少必要配置项：{'、'.join(missing)}。\n"
+            "请通过以下任一方式配置：\n"
+            "  1. 快速配置（推荐）：bdpan auth config --app-key <KEY> --secret-key <SECRET>\n"
+            f"  2. 全局配置文件：在 {global_env} 中填写\n"
+            "  3. 当前目录：在当前工作目录下 .env 中填写\n"
+            "  4. 环境变量：export BAIDU_APP_KEY=... BAIDU_SECRET_KEY=..."
+        )
+    return AppConfig(values["BAIDU_APP_KEY"], values["BAIDU_SECRET_KEY"])
+
+
+def save_global_config(app_key: str, secret_key: str, path: Path | None = None) -> Path:
+    """将 AppKey 和 SecretKey 保存至全局 .env 配置文件（强制权限 0o600）。"""
+    target_path = path or get_global_config_path()
+    target_path.parent.mkdir(parents=True, exist_ok=True)
+    content = (
+        f"# 百度网盘开放平台开发者凭证 (XDG 全局配置)\n"
+        f"BAIDU_APP_KEY={app_key.strip()}\n"
+        f"BAIDU_SECRET_KEY={secret_key.strip()}\n"
+    )
+    target_path.write_text(content, encoding="utf-8")
+    try:
+        target_path.chmod(0o600)
+    except OSError:
+        pass
+    return target_path

{bdpan_cli-0.1.0 → bdpan_cli-0.2.0}/src/bdpan_cli/mcp_server.py

@@ -12,6 +12,7 @@ import os
 import sys
 from typing import Any, Callable
 
+from bdpan_cli._version import __version__
 from bdpan_cli.account import AccountClient
 from bdpan_cli.file_manager import FileManager, FileManagerError
 from bdpan_cli.media_info import MediaInfoClient, MediaInfoError
@@ -39,7 +40,7 @@ class BdpanMcpServer:
         self.protocol_version = "2024-11-05"
         self.server_info = {
             "name": "bdpan-mcp",
-            "version": "0.1.0",
+            "version": __version__,
         }
 
     def _get_file_manager(self) -> FileManager:

bdpan_cli-0.1.0/src/bdpan_cli/config.py

@@ -1,26 +0,0 @@
-"""应用配置：从 .env 读取百度网盘开放平台凭证。"""
-
-import os
-from dataclasses import dataclass
-
-from dotenv import load_dotenv
-
-
-@dataclass(frozen=True)
-class AppConfig:
-    app_key: str
-    secret_key: str
-
-
-def load_config() -> AppConfig:
-    load_dotenv()
-    values = {
-        "BAIDU_APP_KEY": os.getenv("BAIDU_APP_KEY", "").strip(),
-        "BAIDU_SECRET_KEY": os.getenv("BAIDU_SECRET_KEY", "").strip(),
-    }
-    missing = [name for name, value in values.items() if not value]
-    if missing:
-        raise RuntimeError(
-            f"缺少配置项：{'、'.join(missing)}，请在 .env 中填写（参考 .env.example）"
-        )
-    return AppConfig(values["BAIDU_APP_KEY"], values["BAIDU_SECRET_KEY"])