drinkzen-admin-cli 0.3.0__tar.gz → 0.4.0__tar.gz

{drinkzen_admin_cli-0.3.0 → drinkzen_admin_cli-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: drinkzen-admin-cli
-Version: 0.3.0
+Version: 0.4.0
 Summary: Standalone CLI client for DrinkZen Admin operations
 Author: DrinkZen Team
 License: MIT
@@ -106,7 +106,18 @@ drinkzen-admin config set --set-url "https://api.drinkzen.cn" --set-token "your-
 drinkzen-admin config set --set-url "http://api.drinkzen.localhost:8000" --set-token "local-admin-token"
 ```
 
-配置文件将保存在 `~/.drinkzen/admin.json`，且在 Unix/macOS 系统上自动设置 **`chmod 600`** 权限（仅当前系统用户可读写）。
+用户全局配置保存在 `~/.config/drinkzen/admin.json`，且在 Unix/macOS 系统上自动设置 **`chmod 600`** 权限（仅当前系统用户可读写）。如果设置了 `XDG_CONFIG_HOME`，则使用 `$XDG_CONFIG_HOME/drinkzen/admin.json`。
+
+仓库可以保存一份仅对当前项目生效的覆盖配置：
+
+```bash
+cd /path/to/repository
+drinkzen-admin config set --scope project \
+  --set-url "http://api.drinkzen.localhost:8000" \
+  --set-token "local-admin-token"
+```
+
+仓库配置位于 `<repository>/.drinkzen/admin.json`。该目录已加入 DrinkZen 仓库的 `.gitignore`，不要提交包含管理员 Token 的配置文件。
 
 ### 2. 查看当前生效的配置与 Secret 脱敏展示
 
@@ -118,23 +129,35 @@ drinkzen-admin config show --json
 
 ```json
 {
-  "config_file": "/Users/admin/.drinkzen/admin.json",
+  "config_file": "/path/to/repository/.drinkzen/admin.json",
   "file_exists": true,
+  "global_config_file": "/Users/admin/.config/drinkzen/admin.json",
+  "project_config_file": "/path/to/repository/.drinkzen/admin.json",
   "active_url": "https://api.drinkzen.cn",
-  "url_source": "file",
+  "url_source": "project",
   "active_token": "secr****1234",
-  "token_source": "file"
+  "token_source": "global"
 }
 ```
 
+分别查看用户级和仓库级路径：
+
+```bash
+drinkzen-admin config path --scope global --json
+drinkzen-admin config path --scope project --json
+```
+
 ### 3. 配置加载优先级
 
 当执行命令时，配置按如下优先级依次生效：
 
 1. **显式命令行参数**：`--url "..."` / `--token "..."`
 2. **系统环境变量**：`DRINKZEN_API_BASE_URL` / `DRINKZEN_ADMIN_TOKEN`
-3. **用户配置文件**：`~/.drinkzen/admin.json`
-4. **内置默认值**：`http://localhost:8000` / `local-admin-token`
+3. **仓库覆盖配置**：`<repository>/.drinkzen/admin.json`
+4. **用户全局配置**：`~/.config/drinkzen/admin.json`
+5. **内置默认值**：`http://localhost:8000` / `local-admin-token`
+
+仓库配置按字段覆盖用户配置。例如仓库只配置 `url` 时，仍可继承用户全局配置中的 `token`。
 
 ---
 
@@ -156,6 +179,9 @@ drinkzen-admin brand update 霸王茶姬 --name "霸王茶姬 CHAGEE" --alias "C
 
 # 上传品牌 Logo 并标注数据置信度
 drinkzen-admin brand set-logo 霸王茶姬 ./logo.png --confidence verified --source-name "官方小程序"
+
+# 只读核对数据库 Logo 引用与 COS 文件，识别缺失引用与孤儿对象
+drinkzen-admin brand audit-logos --json
 ```
 
 ### 2. 菜单模板管理 (`menu-template`)

{drinkzen_admin_cli-0.3.0 → drinkzen_admin_cli-0.4.0}/README.md

@@ -84,7 +84,18 @@ drinkzen-admin config set --set-url "https://api.drinkzen.cn" --set-token "your-
 drinkzen-admin config set --set-url "http://api.drinkzen.localhost:8000" --set-token "local-admin-token"
 ```
 
-配置文件将保存在 `~/.drinkzen/admin.json`，且在 Unix/macOS 系统上自动设置 **`chmod 600`** 权限（仅当前系统用户可读写）。
+用户全局配置保存在 `~/.config/drinkzen/admin.json`，且在 Unix/macOS 系统上自动设置 **`chmod 600`** 权限（仅当前系统用户可读写）。如果设置了 `XDG_CONFIG_HOME`，则使用 `$XDG_CONFIG_HOME/drinkzen/admin.json`。
+
+仓库可以保存一份仅对当前项目生效的覆盖配置：
+
+```bash
+cd /path/to/repository
+drinkzen-admin config set --scope project \
+  --set-url "http://api.drinkzen.localhost:8000" \
+  --set-token "local-admin-token"
+```
+
+仓库配置位于 `<repository>/.drinkzen/admin.json`。该目录已加入 DrinkZen 仓库的 `.gitignore`，不要提交包含管理员 Token 的配置文件。
 
 ### 2. 查看当前生效的配置与 Secret 脱敏展示
 
@@ -96,23 +107,35 @@ drinkzen-admin config show --json
 
 ```json
 {
-  "config_file": "/Users/admin/.drinkzen/admin.json",
+  "config_file": "/path/to/repository/.drinkzen/admin.json",
   "file_exists": true,
+  "global_config_file": "/Users/admin/.config/drinkzen/admin.json",
+  "project_config_file": "/path/to/repository/.drinkzen/admin.json",
   "active_url": "https://api.drinkzen.cn",
-  "url_source": "file",
+  "url_source": "project",
   "active_token": "secr****1234",
-  "token_source": "file"
+  "token_source": "global"
 }
 ```
 
+分别查看用户级和仓库级路径：
+
+```bash
+drinkzen-admin config path --scope global --json
+drinkzen-admin config path --scope project --json
+```
+
 ### 3. 配置加载优先级
 
 当执行命令时，配置按如下优先级依次生效：
 
 1. **显式命令行参数**：`--url "..."` / `--token "..."`
 2. **系统环境变量**：`DRINKZEN_API_BASE_URL` / `DRINKZEN_ADMIN_TOKEN`
-3. **用户配置文件**：`~/.drinkzen/admin.json`
-4. **内置默认值**：`http://localhost:8000` / `local-admin-token`
+3. **仓库覆盖配置**：`<repository>/.drinkzen/admin.json`
+4. **用户全局配置**：`~/.config/drinkzen/admin.json`
+5. **内置默认值**：`http://localhost:8000` / `local-admin-token`
+
+仓库配置按字段覆盖用户配置。例如仓库只配置 `url` 时，仍可继承用户全局配置中的 `token`。
 
 ---
 
@@ -134,6 +157,9 @@ drinkzen-admin brand update 霸王茶姬 --name "霸王茶姬 CHAGEE" --alias "C
 
 # 上传品牌 Logo 并标注数据置信度
 drinkzen-admin brand set-logo 霸王茶姬 ./logo.png --confidence verified --source-name "官方小程序"
+
+# 只读核对数据库 Logo 引用与 COS 文件，识别缺失引用与孤儿对象
+drinkzen-admin brand audit-logos --json
 ```
 
 ### 2. 菜单模板管理 (`menu-template`)

{drinkzen_admin_cli-0.3.0 → drinkzen_admin_cli-0.4.0}/drinkzen_admin/__init__.py

@@ -1,3 +1,3 @@
 """DrinkZen Admin CLI package."""
 
-__version__ = "0.3.0"
+__version__ = "0.4.0"