drinkzen-admin-cli 0.2.4__tar.gz → 0.3.3__tar.gz

{drinkzen_admin_cli-0.2.4 → drinkzen_admin_cli-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: drinkzen-admin-cli
-Version: 0.2.4
+Version: 0.3.3
 Summary: Standalone CLI client for DrinkZen Admin operations
 Author: DrinkZen Team
 License: MIT
@@ -64,6 +64,34 @@ PYTHONPATH=packages/admin-cli python3 -m drinkzen_admin.cli config show
 
 ---
 
+## Agent Skill 安装
+
+`drinkzen-admin` 提供与具体 AI 工具无关的运营使用手册。默认安装到当前项目的 `.agents/skills`：
+
+```bash
+drinkzen-admin skill install
+```
+
+如需安装到当前用户的全局 Agent Skill 目录：
+
+```bash
+drinkzen-admin skill install --scope global
+```
+
+查询目标路径或更新已有 Skill：
+
+```bash
+drinkzen-admin skill path --scope project --json
+drinkzen-admin skill path --scope global --json
+drinkzen-admin skill install --force
+```
+
+项目级安装默认使用当前目录，也可以指定项目目录：
+
+```bash
+drinkzen-admin skill install --scope project --project-dir /path/to/project
+```
+
 ## 密钥与持久化配置管理 (`config`)
 
 `drinkzen-admin` 提供了内置的密钥持久化管理，避免每次在终端手动输入敏感 Token 或将其留在 Bash 历史记录中。
@@ -128,6 +156,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.2.4 → drinkzen_admin_cli-0.3.3}/README.md

@@ -42,6 +42,34 @@ PYTHONPATH=packages/admin-cli python3 -m drinkzen_admin.cli config show
 
 ---
 
+## Agent Skill 安装
+
+`drinkzen-admin` 提供与具体 AI 工具无关的运营使用手册。默认安装到当前项目的 `.agents/skills`：
+
+```bash
+drinkzen-admin skill install
+```
+
+如需安装到当前用户的全局 Agent Skill 目录：
+
+```bash
+drinkzen-admin skill install --scope global
+```
+
+查询目标路径或更新已有 Skill：
+
+```bash
+drinkzen-admin skill path --scope project --json
+drinkzen-admin skill path --scope global --json
+drinkzen-admin skill install --force
+```
+
+项目级安装默认使用当前目录，也可以指定项目目录：
+
+```bash
+drinkzen-admin skill install --scope project --project-dir /path/to/project
+```
+
 ## 密钥与持久化配置管理 (`config`)
 
 `drinkzen-admin` 提供了内置的密钥持久化管理，避免每次在终端手动输入敏感 Token 或将其留在 Bash 历史记录中。
@@ -106,6 +134,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.2.4 → drinkzen_admin_cli-0.3.3}/drinkzen_admin/__init__.py

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

{drinkzen_admin_cli-0.2.4 → drinkzen_admin_cli-0.3.3}/drinkzen_admin/cli.py

@@ -12,6 +12,7 @@ from .client import AdminCLIClient
 from .config import cmd_config_path, cmd_config_set, cmd_config_show
 from .formatting import format_cli_output
 from .menu_options import normalize_menu_option_config
+from .skill import install_skill, skill_path
 
 
 # ----------------------------------------------------------------------
@@ -62,6 +63,16 @@ def cmd_brand_show(
     return 0
 
 
+def cmd_brand_audit_logos(client: AdminCLIClient, is_json: bool = False) -> int:
+    """Print the API's read-only COS/database logo consistency audit."""
+    status, data = client.request("GET", "/api/admin/brands/logo-audit")
+    if status != 200:
+        print(format_cli_output({"error": data}, is_json))
+        return 1
+    print(format_cli_output(data, is_json))
+    return 0
+
+
 def cmd_brand_update(
     client: AdminCLIClient,
     brand_id_or_name: str,
@@ -404,6 +415,19 @@ def build_parser() -> argparse.ArgumentParser:
     c_show = config_sub.add_parser("show", help="Show active configuration with masked secrets", parents=[common_parser])
     c_path = config_sub.add_parser("path", help="Print configuration file path", parents=[common_parser])
 
+    # skill
+    skill_parser = subparsers.add_parser("skill", help="Install the agent-neutral DrinkZen Admin Skill")
+    skill_sub = skill_parser.add_subparsers(dest="skill_action", required=True)
+    s_install = skill_sub.add_parser("install", help="Download the Skill into .agents/skills")
+    s_install.add_argument("--scope", choices=["project", "global"], default="project")
+    s_install.add_argument("--project-dir", default=None, help="Project directory for project scope (default: current directory)")
+    s_install.add_argument("--force", action="store_true", help="Replace an existing Skill")
+    s_install.add_argument("--json", action="store_true", help="Output JSON format")
+    s_path = skill_sub.add_parser("path", help="Show the target Skill path")
+    s_path.add_argument("--scope", choices=["project", "global"], default="project")
+    s_path.add_argument("--project-dir", default=None)
+    s_path.add_argument("--json", action="store_true", help="Output JSON format")
+
     # brand
     brand_parser = subparsers.add_parser("brand", help="Brand operations", parents=[common_parser])
     brand_sub = brand_parser.add_subparsers(dest="brand_action", required=True)
@@ -415,6 +439,12 @@ def build_parser() -> argparse.ArgumentParser:
     b_show = brand_sub.add_parser("show", help="Show brand details", parents=[common_parser])
     b_show.add_argument("brand", help="Brand ID or name")
 
+    brand_sub.add_parser(
+        "audit-logos",
+        help="Read-only audit of brand Logo references against object storage",
+        parents=[common_parser],
+    )
+
     b_update = brand_sub.add_parser("update", help="Update brand information", parents=[common_parser])
     b_update.add_argument("brand", help="Brand ID or name")
     b_update.add_argument("--name", default=None, help="New brand name")
@@ -470,6 +500,19 @@ def main(args: list[str] | None = None) -> int:
     is_json = getattr(parsed, "json", False)
     dry_run = getattr(parsed, "dry_run", False)
 
+    if parsed.subcommand == "skill":
+        target = skill_path(parsed.scope, parsed.project_dir)
+        if parsed.skill_action == "path":
+            print(format_cli_output({"path": str(target), "scope": parsed.scope}, parsed.json))
+            return 0
+        try:
+            installed = install_skill(parsed.scope, parsed.project_dir, parsed.force)
+            print(format_cli_output({"installed": True, "path": str(installed), "scope": parsed.scope}, parsed.json))
+            return 0
+        except Exception as exc:
+            print(format_cli_output({"installed": False, "error": str(exc), "path": str(target)}, parsed.json))
+            return 1
+
     # Config commands
     if parsed.subcommand == "config":
         if parsed.config_action == "set":
@@ -488,6 +531,8 @@ def main(args: list[str] | None = None) -> int:
             return cmd_brand_list(client, search=parsed.search, active_only=parsed.active_only, is_json=is_json)
         if parsed.brand_action == "show":
             return cmd_brand_show(client, brand_id_or_name=parsed.brand, is_json=is_json)
+        if parsed.brand_action == "audit-logos":
+            return cmd_brand_audit_logos(client, is_json=is_json)
         if parsed.brand_action == "update":
             return cmd_brand_update(
                 client,

drinkzen_admin_cli-0.3.3/drinkzen_admin/skill.py

@@ -0,0 +1,37 @@
+"""Install the DrinkZen Admin Agent Skill without binding to a specific agent."""
+
+from __future__ import annotations
+
+import urllib.request
+from pathlib import Path
+
+SKILL_NAME = "drinkzen-admin"
+SKILL_URL = "https://drinkzen.cn/skills/drinkzen-admin/SKILL.md"
+SKILL_USER_AGENT = "DrinkZenAdminCLI/1.0 (+https://drinkzen.cn)"
+
+
+def skill_path(scope: str = "project", project_dir: str | None = None) -> Path:
+    if scope == "global":
+        root = Path.home() / ".agents" / "skills"
+    else:
+        root = Path(project_dir or ".").expanduser().resolve() / ".agents" / "skills"
+    return root / SKILL_NAME / "SKILL.md"
+
+
+def install_skill(
+    scope: str = "project",
+    project_dir: str | None = None,
+    force: bool = False,
+    url: str = SKILL_URL,
+) -> Path:
+    destination = skill_path(scope, project_dir)
+    if destination.exists() and not force:
+        raise FileExistsError(f"Skill already exists: {destination}. Use --force to replace it.")
+    destination.parent.mkdir(parents=True, exist_ok=True)
+    request = urllib.request.Request(url, headers={"User-Agent": SKILL_USER_AGENT})
+    with urllib.request.urlopen(request, timeout=20) as response:
+        content = response.read()
+    if not content:
+        raise RuntimeError("Downloaded Skill is empty")
+    destination.write_bytes(content)
+    return destination

{drinkzen_admin_cli-0.2.4 → drinkzen_admin_cli-0.3.3}/drinkzen_admin_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: drinkzen-admin-cli
-Version: 0.2.4
+Version: 0.3.3
 Summary: Standalone CLI client for DrinkZen Admin operations
 Author: DrinkZen Team
 License: MIT
@@ -64,6 +64,34 @@ PYTHONPATH=packages/admin-cli python3 -m drinkzen_admin.cli config show
 
 ---
 
+## Agent Skill 安装
+
+`drinkzen-admin` 提供与具体 AI 工具无关的运营使用手册。默认安装到当前项目的 `.agents/skills`：
+
+```bash
+drinkzen-admin skill install
+```
+
+如需安装到当前用户的全局 Agent Skill 目录：
+
+```bash
+drinkzen-admin skill install --scope global
+```
+
+查询目标路径或更新已有 Skill：
+
+```bash
+drinkzen-admin skill path --scope project --json
+drinkzen-admin skill path --scope global --json
+drinkzen-admin skill install --force
+```
+
+项目级安装默认使用当前目录，也可以指定项目目录：
+
+```bash
+drinkzen-admin skill install --scope project --project-dir /path/to/project
+```
+
 ## 密钥与持久化配置管理 (`config`)
 
 `drinkzen-admin` 提供了内置的密钥持久化管理，避免每次在终端手动输入敏感 Token 或将其留在 Bash 历史记录中。
@@ -128,6 +156,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.2.4 → drinkzen_admin_cli-0.3.3}/drinkzen_admin_cli.egg-info/SOURCES.txt

@@ -6,10 +6,12 @@ drinkzen_admin/client.py
 drinkzen_admin/config.py
 drinkzen_admin/formatting.py
 drinkzen_admin/menu_options.py
+drinkzen_admin/skill.py
 drinkzen_admin_cli.egg-info/PKG-INFO
 drinkzen_admin_cli.egg-info/SOURCES.txt
 drinkzen_admin_cli.egg-info/dependency_links.txt
 drinkzen_admin_cli.egg-info/entry_points.txt
 drinkzen_admin_cli.egg-info/top_level.txt
 tests/test_config.py
+tests/test_skill.py
 tests/test_standalone_cli.py

{drinkzen_admin_cli-0.2.4 → drinkzen_admin_cli-0.3.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "drinkzen-admin-cli"
-version = "0.2.4"
+version = "0.3.3"
 description = "Standalone CLI client for DrinkZen Admin operations"
 readme = "README.md"
 requires-python = ">=3.9"

drinkzen_admin_cli-0.3.3/tests/test_skill.py

@@ -0,0 +1,26 @@
+from pathlib import Path
+from tempfile import TemporaryDirectory
+from unittest.mock import patch
+
+from drinkzen_admin.skill import SKILL_USER_AGENT, install_skill
+
+
+class SkillResponse:
+    def __enter__(self) -> "SkillResponse":
+        return self
+
+    def __exit__(self, exc_type: object, exc_value: object, traceback: object) -> None:
+        return None
+
+    def read(self) -> bytes:
+        return b"---\nname: drinkzen-admin\n---\n"
+
+
+def test_install_skill_identifies_the_cli_request() -> None:
+    with TemporaryDirectory() as temp_dir:
+        with patch("urllib.request.urlopen", return_value=SkillResponse()) as urlopen:
+            destination = install_skill(project_dir=temp_dir)
+
+        request = urlopen.call_args.args[0]
+        assert request.get_header("User-agent") == SKILL_USER_AGENT
+        assert Path(destination).read_text(encoding="utf-8").startswith("---")

{drinkzen_admin_cli-0.2.4 → drinkzen_admin_cli-0.3.3}/tests/test_standalone_cli.py

@@ -71,6 +71,34 @@ class TestStandaloneCLI(unittest.TestCase):
         self.assertTrue(output.get("dry_run"))
         self.assertEqual(output["proposed"]["name"], "新名称")
 
+    @patch("drinkzen_admin.cli.AdminCLIClient")
+    def test_brand_audit_logos_command(self, mock_client_cls):
+        mock_client = MagicMock()
+        mock_client.request.return_value = (
+            200,
+            {
+                "backend": "CosObjectStorage",
+                "total_brands": 14,
+                "referenced_logo_count": 9,
+                "missing_referenced_objects": [],
+                "recoverable_unlinked_objects": [],
+                "orphan_object_keys": ["brands/old/logo.png"],
+            },
+        )
+        mock_client_cls.return_value = mock_client
+
+        buf = io.StringIO()
+        with patch("sys.argv", ["drinkzen-admin", "brand", "audit-logos", "--json"]):
+            with redirect_stdout(buf):
+                exit_code = main()
+
+        self.assertEqual(exit_code, 0)
+        output = json.loads(buf.getvalue())
+        self.assertEqual(output["referenced_logo_count"], 9)
+        mock_client.request.assert_called_once_with(
+            "GET", "/api/admin/brands/logo-audit"
+        )
+
     def test_menu_template_validate_command(self):
         valid_template = json.dumps({
             "optionGroups": [