artdam-cli 0.2.5__tar.gz → 0.2.7__tar.gz

artdam_cli-0.2.7/PKG-INFO

@@ -0,0 +1,235 @@
+Metadata-Version: 2.4
+Name: artdam-cli
+Version: 0.2.7
+Summary: ArtDAM 数字资产管理平台命令行工具
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.1
+Requires-Dist: httpx>=0.27
+Requires-Dist: rich>=13.0
+
+# artdam-cli
+
+ArtDAM 数字资产管理平台命令行工具，支持所有主流 AI Agent工具接入
+
+## 安装
+
+```bash
+# 推荐（无需 Python 环境）
+uv tool install artdam-cli
+
+# 或使用 pip
+pip install artdam-cli
+```
+
+## 快速开始
+
+```bash
+# 登录（首次使用，服务器地址已内置）
+artdam login --username <用户名> --password <密码>
+
+# 搜索资产
+artdam search "关键词" --project 1
+
+# 查看资产详情
+artdam get 123
+
+# 下载资产
+artdam download 123 --out ./downloads
+```
+
+## 命令说明
+
+### 查询命令（viewer 及以上）
+
+#### `artdam login`
+
+登录 ArtDAM，保存 token 到本地 `~/.artdam/config.json`。
+
+```bash
+artdam login --username <用户名> --password <密码>
+```
+
+#### `artdam search`
+
+搜索资产，返回匹配列表。
+
+```bash
+artdam search "头盔" --project 1
+artdam search "头盔" --project 1 --limit 50
+artdam search "头盔" --project 1 --type image/png
+artdam search "头盔" --project 1 --folder 10
+artdam search "头盔" --project 1 --json   # 输出原始 JSON（AI Agent 用）
+```
+
+| 参数 | 说明 |
+|---|---|
+| `KEYWORD` | 搜索关键词 |
+| `-p, --project` | 项目 ID（必填） |
+| `-n, --limit` | 返回数量上限（默认 20） |
+| `--type` | 文件类型，如 `image/png` |
+| `--folder` | 限定文件夹 ID |
+| `--json` | 输出原始 JSON |
+
+#### `artdam get`
+
+查看单个资产详情（含预览链接）。
+
+```bash
+artdam get 123
+artdam get 123 --json   # 输出原始 JSON（AI Agent 用）
+```
+
+#### `artdam download`
+
+下载资产文件到本地。
+
+```bash
+artdam download 123
+artdam download 123 --out ./downloads
+```
+
+#### `artdam tags`
+
+列出项目标签。
+
+```bash
+artdam tags --project 1
+artdam tags --project 1 --search "角色"
+artdam tags --project 1 --json
+```
+
+#### `artdam folders`
+
+查看文件夹结构。
+
+```bash
+artdam folders --project 1
+artdam folders --project 1 --json
+```
+
+### 资产管理（member 及以上）
+
+#### `artdam upload`
+
+上传文件到指定项目和文件夹。
+
+```bash
+artdam upload ./image.jpg --project 1
+artdam upload ./image.jpg --project 1 --folder 10
+```
+
+#### `artdam update`
+
+更新资产信息（可同时传多个选项）。
+
+```bash
+artdam update 123 --name "新文件名"
+artdam update 123 --description "新描述"
+artdam update 123 --folder 10
+```
+
+#### `artdam delete`
+
+软删除资产（可通过 `restore` 恢复）。
+
+```bash
+artdam delete 123
+```
+
+#### `artdam restore`
+
+恢复已删除的资产。
+
+```bash
+artdam restore 123
+```
+
+### 标签管理（member 及以上）
+
+```bash
+# 给资产添加标签
+artdam tag add 123 5
+
+# 从资产移除标签
+artdam tag remove 123 5
+
+# 创建新标签
+artdam tag create "标签名" --project 1
+```
+
+### 文件夹管理（member 及以上）
+
+```bash
+# 创建文件夹
+artdam folder create "文件夹名" --project 1
+artdam folder create "子文件夹" --project 1 --parent 10
+
+# 删除文件夹
+artdam folder delete 10
+```
+
+### 互动操作（member 及以上）
+
+```bash
+# 评论
+artdam comment 123 "评论内容"
+
+# 评分（1-5 星）
+artdam rate 123 4
+
+# 收藏 / 取消收藏
+artdam favorite 123
+artdam favorite 123 --remove
+```
+
+## AI Agent 使用指南
+
+所有查询命令支持 `--json` 输出原始 JSON，适合 Agent 解析：
+
+```bash
+artdam search "安妮" --project 1 --json
+artdam get 123 --json
+artdam tags --project 1 --json
+artdam folders --project 1 --json
+```
+
+### 典型 Agent 工作流
+
+```bash
+# 1. 登录（向用户获取用户名密码后执行）
+artdam login --username <用户名> --password <密码>
+
+# 2. 搜索 → 确认 → 下载
+artdam search "头盔" --project 1 --json
+artdam get 50707 --json
+artdam download 50707 --out ./assets
+
+# 3. 搜索 → 批量打标签
+artdam search "安妮" --project 1 --json
+artdam tag add 50707 5
+artdam tag add 50708 5
+
+# 4. 上传并更新描述
+artdam upload ./new_asset.jpg --project 1 --folder 10
+artdam update <asset_id> --description "AI 生成的场景描述"
+```
+
+## 注意事项
+
+- `--project` 参数为**数字 ID**，不是项目名称
+- `--json` 返回原始 JSON，适合程序解析
+- token 保存在 `~/.artdam/config.json`，登录一次长期有效
+- `artdam delete` 是软删除，可用 `artdam restore` 恢复
+- Windows CMD 下中文乱码时，在命令前加 `PYTHONUTF8=1`
+
+## 配置文件
+
+登录信息保存在 `~/.artdam/config.json`：
+
+```json
+{
+  "base_url": "https://artdam.xindong.com",
+  "token": "eyJ..."
+}
+```

artdam_cli-0.2.7/README.md

@@ -0,0 +1,225 @@
+# artdam-cli
+
+ArtDAM 数字资产管理平台命令行工具，支持所有主流 AI Agent工具接入
+
+## 安装
+
+```bash
+# 推荐（无需 Python 环境）
+uv tool install artdam-cli
+
+# 或使用 pip
+pip install artdam-cli
+```
+
+## 快速开始
+
+```bash
+# 登录（首次使用，服务器地址已内置）
+artdam login --username <用户名> --password <密码>
+
+# 搜索资产
+artdam search "关键词" --project 1
+
+# 查看资产详情
+artdam get 123
+
+# 下载资产
+artdam download 123 --out ./downloads
+```
+
+## 命令说明
+
+### 查询命令（viewer 及以上）
+
+#### `artdam login`
+
+登录 ArtDAM，保存 token 到本地 `~/.artdam/config.json`。
+
+```bash
+artdam login --username <用户名> --password <密码>
+```
+
+#### `artdam search`
+
+搜索资产，返回匹配列表。
+
+```bash
+artdam search "头盔" --project 1
+artdam search "头盔" --project 1 --limit 50
+artdam search "头盔" --project 1 --type image/png
+artdam search "头盔" --project 1 --folder 10
+artdam search "头盔" --project 1 --json   # 输出原始 JSON（AI Agent 用）
+```
+
+| 参数 | 说明 |
+|---|---|
+| `KEYWORD` | 搜索关键词 |
+| `-p, --project` | 项目 ID（必填） |
+| `-n, --limit` | 返回数量上限（默认 20） |
+| `--type` | 文件类型，如 `image/png` |
+| `--folder` | 限定文件夹 ID |
+| `--json` | 输出原始 JSON |
+
+#### `artdam get`
+
+查看单个资产详情（含预览链接）。
+
+```bash
+artdam get 123
+artdam get 123 --json   # 输出原始 JSON（AI Agent 用）
+```
+
+#### `artdam download`
+
+下载资产文件到本地。
+
+```bash
+artdam download 123
+artdam download 123 --out ./downloads
+```
+
+#### `artdam tags`
+
+列出项目标签。
+
+```bash
+artdam tags --project 1
+artdam tags --project 1 --search "角色"
+artdam tags --project 1 --json
+```
+
+#### `artdam folders`
+
+查看文件夹结构。
+
+```bash
+artdam folders --project 1
+artdam folders --project 1 --json
+```
+
+### 资产管理（member 及以上）
+
+#### `artdam upload`
+
+上传文件到指定项目和文件夹。
+
+```bash
+artdam upload ./image.jpg --project 1
+artdam upload ./image.jpg --project 1 --folder 10
+```
+
+#### `artdam update`
+
+更新资产信息（可同时传多个选项）。
+
+```bash
+artdam update 123 --name "新文件名"
+artdam update 123 --description "新描述"
+artdam update 123 --folder 10
+```
+
+#### `artdam delete`
+
+软删除资产（可通过 `restore` 恢复）。
+
+```bash
+artdam delete 123
+```
+
+#### `artdam restore`
+
+恢复已删除的资产。
+
+```bash
+artdam restore 123
+```
+
+### 标签管理（member 及以上）
+
+```bash
+# 给资产添加标签
+artdam tag add 123 5
+
+# 从资产移除标签
+artdam tag remove 123 5
+
+# 创建新标签
+artdam tag create "标签名" --project 1
+```
+
+### 文件夹管理（member 及以上）
+
+```bash
+# 创建文件夹
+artdam folder create "文件夹名" --project 1
+artdam folder create "子文件夹" --project 1 --parent 10
+
+# 删除文件夹
+artdam folder delete 10
+```
+
+### 互动操作（member 及以上）
+
+```bash
+# 评论
+artdam comment 123 "评论内容"
+
+# 评分（1-5 星）
+artdam rate 123 4
+
+# 收藏 / 取消收藏
+artdam favorite 123
+artdam favorite 123 --remove
+```
+
+## AI Agent 使用指南
+
+所有查询命令支持 `--json` 输出原始 JSON，适合 Agent 解析：
+
+```bash
+artdam search "安妮" --project 1 --json
+artdam get 123 --json
+artdam tags --project 1 --json
+artdam folders --project 1 --json
+```
+
+### 典型 Agent 工作流
+
+```bash
+# 1. 登录（向用户获取用户名密码后执行）
+artdam login --username <用户名> --password <密码>
+
+# 2. 搜索 → 确认 → 下载
+artdam search "头盔" --project 1 --json
+artdam get 50707 --json
+artdam download 50707 --out ./assets
+
+# 3. 搜索 → 批量打标签
+artdam search "安妮" --project 1 --json
+artdam tag add 50707 5
+artdam tag add 50708 5
+
+# 4. 上传并更新描述
+artdam upload ./new_asset.jpg --project 1 --folder 10
+artdam update <asset_id> --description "AI 生成的场景描述"
+```
+
+## 注意事项
+
+- `--project` 参数为**数字 ID**，不是项目名称
+- `--json` 返回原始 JSON，适合程序解析
+- token 保存在 `~/.artdam/config.json`，登录一次长期有效
+- `artdam delete` 是软删除，可用 `artdam restore` 恢复
+- Windows CMD 下中文乱码时，在命令前加 `PYTHONUTF8=1`
+
+## 配置文件
+
+登录信息保存在 `~/.artdam/config.json`：
+
+```json
+{
+  "base_url": "https://artdam.xindong.com",
+  "token": "eyJ..."
+}
+```

artdam_cli-0.2.7/artdam_cli/__init__.py

@@ -0,0 +1,6 @@
+from importlib.metadata import version, PackageNotFoundError
+
+try:
+    __version__ = version("artdam-cli")
+except PackageNotFoundError:
+    __version__ = "0.0.0"

{artdam_cli-0.2.5 → artdam_cli-0.2.7}/artdam_cli/main.py

@@ -1,52 +1,69 @@
-import io
-import sys
-
-import click
-
-# Windows 终端默认 GBK，强制 UTF-8 避免中文乱码
-if hasattr(sys.stdout, "buffer") and sys.stdout.encoding.lower() not in ("utf-8", "utf-8-sig"):
-    sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding="utf-8", errors="replace")
-    sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding="utf-8", errors="replace")
-
-from artdam_cli.commands.login import login
-from artdam_cli.commands.search import search
-from artdam_cli.commands.get import get
-from artdam_cli.commands.tags import tags
-from artdam_cli.commands.folders import folders
-from artdam_cli.commands.download import download
-from artdam_cli.commands.update import update
-from artdam_cli.commands.delete_cmd import delete_cmd
-from artdam_cli.commands.restore import restore
-from artdam_cli.commands.upload import upload
-from artdam_cli.commands.tag_cmd import tag_group
-from artdam_cli.commands.folder_cmd import folder_group
-from artdam_cli.commands.comment import comment
-from artdam_cli.commands.rate import rate
-from artdam_cli.commands.favorite import favorite
-from artdam_cli.commands.project import project_group
-from artdam_cli.commands.projects import projects
-
-
-@click.group()
-@click.version_option(package_name="artdam-cli")
-def cli() -> None:
-    """ArtDAM 命令行工具 — 搜索、查看、下载、管理数字资产。"""
-
-
-cli.add_command(login)
-cli.add_command(search)
-cli.add_command(get)
-cli.add_command(tags)
-cli.add_command(folders)
-cli.add_command(download)
-cli.add_command(update)
-cli.add_command(delete_cmd)
-cli.add_command(restore)
-cli.add_command(upload)
-cli.add_command(tag_group)
-cli.add_command(folder_group)
-cli.add_command(comment)
-cli.add_command(rate)
-cli.add_command(favorite)
-cli.add_command(project_group)
-cli.add_command(projects)
+import io
+import sys
+
+import click
+
+# Windows 终端默认 GBK，强制 UTF-8 避免中文乱码
+if hasattr(sys.stdout, "buffer") and sys.stdout.encoding.lower() not in ("utf-8", "utf-8-sig"):
+    sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding="utf-8", errors="replace")
+    sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding="utf-8", errors="replace")
+
+from artdam_cli.update_check import check_update
+from artdam_cli.commands.login import login
+from artdam_cli.commands.search import search
+from artdam_cli.commands.get import get
+from artdam_cli.commands.tags import tags
+from artdam_cli.commands.folders import folders
+from artdam_cli.commands.download import download
+from artdam_cli.commands.update import update
+from artdam_cli.commands.delete_cmd import delete_cmd
+from artdam_cli.commands.restore import restore
+from artdam_cli.commands.upload import upload
+from artdam_cli.commands.tag_cmd import tag_group
+from artdam_cli.commands.folder_cmd import folder_group
+from artdam_cli.commands.comment import comment
+from artdam_cli.commands.rate import rate
+from artdam_cli.commands.favorite import favorite
+from artdam_cli.commands.project import project_group
+from artdam_cli.commands.projects import projects
+
+
+@click.group()
+@click.version_option(package_name="artdam-cli")
+def cli() -> None:
+    """ArtDAM 命令行工具 — 搜索、查看、下载、管理数字资产。"""
+
+
+@cli.result_callback()
+def _after_command(*args: object, **kwargs: object) -> None:
+    result = check_update()
+    if result:
+        current, latest = result
+        click.echo(
+            f"\n[notice] A new release of artdam-cli is available: "
+            f"{click.style(current, fg='yellow')} -> {click.style(latest, fg='green')}",
+            err=True,
+        )
+        click.echo(
+            f"[notice] To update, run: {click.style('uv tool upgrade artdam-cli', fg='cyan')}",
+            err=True,
+        )
+
+
+cli.add_command(login)
+cli.add_command(search)
+cli.add_command(get)
+cli.add_command(tags)
+cli.add_command(folders)
+cli.add_command(download)
+cli.add_command(update)
+cli.add_command(delete_cmd)
+cli.add_command(restore)
+cli.add_command(upload)
+cli.add_command(tag_group)
+cli.add_command(folder_group)
+cli.add_command(comment)
+cli.add_command(rate)
+cli.add_command(favorite)
+cli.add_command(project_group)
+cli.add_command(projects)

artdam_cli-0.2.7/artdam_cli/update_check.py

@@ -0,0 +1,71 @@
+from __future__ import annotations
+
+import json
+import time
+from importlib.metadata import PackageNotFoundError, version
+from pathlib import Path
+
+import httpx
+
+_CACHE_PATH = Path.home() / ".artdam" / "version_check.json"
+_CACHE_TTL = 86400  # 24 hours
+_PYPI_URL = "https://pypi.org/pypi/artdam-cli/json"
+_PACKAGE_NAME = "artdam-cli"
+
+
+def get_current_version() -> str:
+    try:
+        return version(_PACKAGE_NAME)
+    except PackageNotFoundError:
+        return "0.0.0"
+
+
+def _load_cache() -> dict:
+    try:
+        if _CACHE_PATH.exists():
+            return json.loads(_CACHE_PATH.read_text(encoding="utf-8"))
+    except Exception:
+        pass
+    return {}
+
+
+def _save_cache(latest: str) -> None:
+    try:
+        _CACHE_PATH.parent.mkdir(parents=True, exist_ok=True)
+        _CACHE_PATH.write_text(
+            json.dumps({"latest": latest, "checked_at": time.time()}),
+            encoding="utf-8",
+        )
+    except Exception:
+        pass
+
+
+def check_update() -> tuple[str, str] | None:
+    """Return (current, latest) if a newer version is available, else None.
+
+    Never raises — network/parse errors are silently swallowed.
+    """
+    current = get_current_version()
+
+    cache = _load_cache()
+    if time.time() - cache.get("checked_at", 0) < _CACHE_TTL:
+        latest = cache.get("latest", current)
+    else:
+        try:
+            resp = httpx.get(_PYPI_URL, timeout=3)
+            resp.raise_for_status()
+            latest = resp.json()["info"]["version"]
+            _save_cache(latest)
+        except Exception:
+            return None
+
+    try:
+        if _parse_version(latest) > _parse_version(current):
+            return current, latest
+    except Exception:
+        pass
+    return None
+
+
+def _parse_version(v: str) -> tuple[int, ...]:
+    return tuple(int(x) for x in v.split(".") if x.isdigit())