artdam-cli 0.2.0__tar.gz → 0.2.1__tar.gz

{artdam_cli-0.2.0 → artdam_cli-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: artdam-cli
-Version: 0.2.0
+Version: 0.2.1
 Summary: ArtDAM 数字资产管理平台命令行工具
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -28,8 +28,14 @@ pip install artdam-cli
 # 登录（首次使用，服务器地址已内置）
 artdam login --username <用户名> --password <密码>
 
+# 查看可访问的项目列表（获取项目 ID）
+artdam projects
+
+# 设置默认项目（之后无需每次输入 -p）
+artdam project use 1
+
 # 搜索资产
-artdam search "关键词" --project 1
+artdam search "关键词"
 
 # 查看资产详情
 artdam get 123
@@ -42,6 +48,24 @@ artdam download 123 --out ./downloads
 
 ### 查询命令（viewer 及以上）
 
+#### `artdam projects`
+
+列出当前用户可访问的所有项目（含 ID）。
+
+```bash
+artdam projects
+artdam projects --json   # 输出原始 JSON（AI Agent 用）
+```
+
+#### `artdam project use / show`
+
+设置或查看默认项目，设置后所有命令无需再传 `-p`。
+
+```bash
+artdam project use 1     # 设置默认项目 ID 为 1
+artdam project show      # 查看当前默认项目
+```
+
 #### `artdam login`
 
 登录 ArtDAM，保存 token 到本地 `~/.artdam/config.json`。
@@ -55,17 +79,18 @@ artdam login --username <用户名> --password <密码>
 搜索资产，返回匹配列表。
 
 ```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 用）
+artdam search "头盔"                        # 使用默认项目
+artdam search "头盔" --project 1            # 临时指定项目
+artdam search "头盔" --limit 50
+artdam search "头盔" --type image/png
+artdam search "头盔" --folder 10
+artdam search "头盔" --json                 # 输出原始 JSON（AI Agent 用）
 ```
 
 | 参数 | 说明 |
 |---|---|
 | `KEYWORD` | 搜索关键词 |
-| `-p, --project` | 项目 ID（必填） |
+| `-p, --project` | 项目 ID（省略则使用默认项目） |
 | `-n, --limit` | 返回数量上限（默认 20） |
 | `--type` | 文件类型，如 `image/png` |
 | `--folder` | 限定文件夹 ID |
@@ -94,9 +119,9 @@ artdam download 123 --out ./downloads
 列出项目标签。
 
 ```bash
-artdam tags --project 1
-artdam tags --project 1 --search "角色"
-artdam tags --project 1 --json
+artdam tags                        # 使用默认项目
+artdam tags --search "角色"
+artdam tags --json
 ```
 
 #### `artdam folders`
@@ -104,8 +129,8 @@ artdam tags --project 1 --json
 查看文件夹结构。
 
 ```bash
-artdam folders --project 1
-artdam folders --project 1 --json
+artdam folders                     # 使用默认项目
+artdam folders --json
 ```
 
 ### 资产管理（member 及以上）
@@ -115,8 +140,9 @@ artdam folders --project 1 --json
 上传文件到指定项目和文件夹。
 
 ```bash
-artdam upload ./image.jpg --project 1
-artdam upload ./image.jpg --project 1 --folder 10
+artdam upload ./image.jpg                  # 使用默认项目
+artdam upload ./image.jpg --folder 10
+artdam upload ./image.jpg --project 1      # 临时指定项目
 ```
 
 #### `artdam update`
@@ -154,16 +180,17 @@ artdam tag add 123 5
 # 从资产移除标签
 artdam tag remove 123 5
 
-# 创建新标签
+# 创建新标签（省略 -p 则使用默认项目）
+artdam tag create "标签名"
 artdam tag create "标签名" --project 1
 ```
 
 ### 文件夹管理（member 及以上）
 
 ```bash
-# 创建文件夹
-artdam folder create "文件夹名" --project 1
-artdam folder create "子文件夹" --project 1 --parent 10
+# 创建文件夹（省略 -p 则使用默认项目）
+artdam folder create "文件夹名"
+artdam folder create "子文件夹" --parent 10
 
 # 删除文件夹
 artdam folder delete 10
@@ -188,36 +215,43 @@ artdam favorite 123 --remove
 所有查询命令支持 `--json` 输出原始 JSON，适合 Agent 解析：
 
 ```bash
-artdam search "安妮" --project 1 --json
+artdam projects --json
+artdam search "安妮" --json
 artdam get 123 --json
-artdam tags --project 1 --json
-artdam folders --project 1 --json
+artdam tags --json
+artdam folders --json
 ```
 
 ### 典型 Agent 工作流
 
 ```bash
-# 1. 登录（向用户获取用户名密码后执行）
+# 1. 登录
 artdam login --username <用户名> --password <密码>
 
-# 2. 搜索 → 确认 → 下载
-artdam search "头盔" --project 1 --json
+# 2. 查询项目列表，选择目标项目并设为默认
+artdam projects --json
+artdam project use 1
+
+# 3. 搜索 → 确认 → 下载
+artdam search "头盔" --json
 artdam get 50707 --json
 artdam download 50707 --out ./assets
 
-# 3. 搜索 → 批量打标签
-artdam search "安妮" --project 1 --json
+# 4. 搜索 → 批量打标签
+artdam search "安妮" --json
 artdam tag add 50707 5
 artdam tag add 50708 5
 
-# 4. 上传并更新描述
-artdam upload ./new_asset.jpg --project 1 --folder 10
+# 5. 上传并更新描述
+artdam upload ./new_asset.jpg --folder 10
 artdam update <asset_id> --description "AI 生成的场景描述"
 ```
 
 ## 注意事项
 
-- `--project` 参数为**数字 ID**，不是项目名称
+- 首次使用先运行 `artdam projects` 获取项目 ID，再 `artdam project use <id>` 设置默认项目
+- 设置默认项目后，`search` / `tags` / `folders` / `upload` 等命令无需再传 `-p`
+- `-p` 仍可临时覆盖默认项目
 - `--json` 返回原始 JSON，适合程序解析
 - token 保存在 `~/.artdam/config.json`，登录一次长期有效
 - `artdam delete` 是软删除，可用 `artdam restore` 恢复
@@ -230,6 +264,7 @@ artdam update <asset_id> --description "AI 生成的场景描述"
 ```json
 {
   "base_url": "https://artdam.dsworks.cn",
-  "token": "eyJ..."
+  "token": "eyJ...",
+  "default_project": 1
 }
 ```

{artdam_cli-0.2.0 → artdam_cli-0.2.1}/README.md

@@ -18,8 +18,14 @@ pip install artdam-cli
 # 登录（首次使用，服务器地址已内置）
 artdam login --username <用户名> --password <密码>
 
+# 查看可访问的项目列表（获取项目 ID）
+artdam projects
+
+# 设置默认项目（之后无需每次输入 -p）
+artdam project use 1
+
 # 搜索资产
-artdam search "关键词" --project 1
+artdam search "关键词"
 
 # 查看资产详情
 artdam get 123
@@ -32,6 +38,24 @@ artdam download 123 --out ./downloads
 
 ### 查询命令（viewer 及以上）
 
+#### `artdam projects`
+
+列出当前用户可访问的所有项目（含 ID）。
+
+```bash
+artdam projects
+artdam projects --json   # 输出原始 JSON（AI Agent 用）
+```
+
+#### `artdam project use / show`
+
+设置或查看默认项目，设置后所有命令无需再传 `-p`。
+
+```bash
+artdam project use 1     # 设置默认项目 ID 为 1
+artdam project show      # 查看当前默认项目
+```
+
 #### `artdam login`
 
 登录 ArtDAM，保存 token 到本地 `~/.artdam/config.json`。
@@ -45,17 +69,18 @@ artdam login --username <用户名> --password <密码>
 搜索资产，返回匹配列表。
 
 ```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 用）
+artdam search "头盔"                        # 使用默认项目
+artdam search "头盔" --project 1            # 临时指定项目
+artdam search "头盔" --limit 50
+artdam search "头盔" --type image/png
+artdam search "头盔" --folder 10
+artdam search "头盔" --json                 # 输出原始 JSON（AI Agent 用）
 ```
 
 | 参数 | 说明 |
 |---|---|
 | `KEYWORD` | 搜索关键词 |
-| `-p, --project` | 项目 ID（必填） |
+| `-p, --project` | 项目 ID（省略则使用默认项目） |
 | `-n, --limit` | 返回数量上限（默认 20） |
 | `--type` | 文件类型，如 `image/png` |
 | `--folder` | 限定文件夹 ID |
@@ -84,9 +109,9 @@ artdam download 123 --out ./downloads
 列出项目标签。
 
 ```bash
-artdam tags --project 1
-artdam tags --project 1 --search "角色"
-artdam tags --project 1 --json
+artdam tags                        # 使用默认项目
+artdam tags --search "角色"
+artdam tags --json
 ```
 
 #### `artdam folders`
@@ -94,8 +119,8 @@ artdam tags --project 1 --json
 查看文件夹结构。
 
 ```bash
-artdam folders --project 1
-artdam folders --project 1 --json
+artdam folders                     # 使用默认项目
+artdam folders --json
 ```
 
 ### 资产管理（member 及以上）
@@ -105,8 +130,9 @@ artdam folders --project 1 --json
 上传文件到指定项目和文件夹。
 
 ```bash
-artdam upload ./image.jpg --project 1
-artdam upload ./image.jpg --project 1 --folder 10
+artdam upload ./image.jpg                  # 使用默认项目
+artdam upload ./image.jpg --folder 10
+artdam upload ./image.jpg --project 1      # 临时指定项目
 ```
 
 #### `artdam update`
@@ -144,16 +170,17 @@ artdam tag add 123 5
 # 从资产移除标签
 artdam tag remove 123 5
 
-# 创建新标签
+# 创建新标签（省略 -p 则使用默认项目）
+artdam tag create "标签名"
 artdam tag create "标签名" --project 1
 ```
 
 ### 文件夹管理（member 及以上）
 
 ```bash
-# 创建文件夹
-artdam folder create "文件夹名" --project 1
-artdam folder create "子文件夹" --project 1 --parent 10
+# 创建文件夹（省略 -p 则使用默认项目）
+artdam folder create "文件夹名"
+artdam folder create "子文件夹" --parent 10
 
 # 删除文件夹
 artdam folder delete 10
@@ -178,36 +205,43 @@ artdam favorite 123 --remove
 所有查询命令支持 `--json` 输出原始 JSON，适合 Agent 解析：
 
 ```bash
-artdam search "安妮" --project 1 --json
+artdam projects --json
+artdam search "安妮" --json
 artdam get 123 --json
-artdam tags --project 1 --json
-artdam folders --project 1 --json
+artdam tags --json
+artdam folders --json
 ```
 
 ### 典型 Agent 工作流
 
 ```bash
-# 1. 登录（向用户获取用户名密码后执行）
+# 1. 登录
 artdam login --username <用户名> --password <密码>
 
-# 2. 搜索 → 确认 → 下载
-artdam search "头盔" --project 1 --json
+# 2. 查询项目列表，选择目标项目并设为默认
+artdam projects --json
+artdam project use 1
+
+# 3. 搜索 → 确认 → 下载
+artdam search "头盔" --json
 artdam get 50707 --json
 artdam download 50707 --out ./assets
 
-# 3. 搜索 → 批量打标签
-artdam search "安妮" --project 1 --json
+# 4. 搜索 → 批量打标签
+artdam search "安妮" --json
 artdam tag add 50707 5
 artdam tag add 50708 5
 
-# 4. 上传并更新描述
-artdam upload ./new_asset.jpg --project 1 --folder 10
+# 5. 上传并更新描述
+artdam upload ./new_asset.jpg --folder 10
 artdam update <asset_id> --description "AI 生成的场景描述"
 ```
 
 ## 注意事项
 
-- `--project` 参数为**数字 ID**，不是项目名称
+- 首次使用先运行 `artdam projects` 获取项目 ID，再 `artdam project use <id>` 设置默认项目
+- 设置默认项目后，`search` / `tags` / `folders` / `upload` 等命令无需再传 `-p`
+- `-p` 仍可临时覆盖默认项目
 - `--json` 返回原始 JSON，适合程序解析
 - token 保存在 `~/.artdam/config.json`，登录一次长期有效
 - `artdam delete` 是软删除，可用 `artdam restore` 恢复
@@ -220,6 +254,7 @@ artdam update <asset_id> --description "AI 生成的场景描述"
 ```json
 {
   "base_url": "https://artdam.dsworks.cn",
-  "token": "eyJ..."
+  "token": "eyJ...",
+  "default_project": 1
 }
 ```

artdam_cli-0.2.1/artdam_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.2.1"

{artdam_cli-0.2.0 → artdam_cli-0.2.1}/artdam_cli/commands/project.py

@@ -1,28 +1,28 @@
-import click
-
-from artdam_cli import config
-
-
-@click.group(name="project")
-def project_group() -> None:
-    """管理默认项目（省去每次输入 -p）。"""
-
-
-@project_group.command(name="use")
-@click.argument("project_id", type=int)
-def project_use(project_id: int) -> None:
-    """设置默认项目 ID。"""
-    data = config.load()
-    data["default_project"] = project_id
-    config.save(data)
-    click.echo(f"✓ 默认项目已设置为 {project_id}")
-
-
-@project_group.command(name="show")
-def project_show() -> None:
-    """查看当前默认项目。"""
-    pid = config.get("default_project")
-    if pid is None:
-        click.echo("未设置默认项目，运行: artdam project use <id>")
-    else:
-        click.echo(f"默认项目: {pid}")
+import click
+
+from artdam_cli import config
+
+
+@click.group(name="project")
+def project_group() -> None:
+    """管理默认项目（省去每次输入 -p）。"""
+
+
+@project_group.command(name="use")
+@click.argument("project_id", type=int)
+def project_use(project_id: int) -> None:
+    """设置默认项目 ID。"""
+    data = config.load()
+    data["default_project"] = project_id
+    config.save(data)
+    click.echo(f"✓ 默认项目已设置为 {project_id}")
+
+
+@project_group.command(name="show")
+def project_show() -> None:
+    """查看当前默认项目。"""
+    pid = config.get("default_project")
+    if pid is None:
+        click.echo("未设置默认项目，运行: artdam project use <id>")
+    else:
+        click.echo(f"默认项目: {pid}")

artdam_cli-0.2.1/artdam_cli/commands/projects.py

@@ -0,0 +1,41 @@
+import json
+
+import click
+from rich.console import Console
+from rich.table import Table
+
+from artdam_cli import client
+
+console = Console()
+
+
+@click.command()
+@click.option("--json", "as_json", is_flag=True, help="输出原始 JSON（AI Agent 用）")
+def projects(as_json: bool) -> None:
+    """列出当前用户可访问的所有项目。"""
+    data = client.get("/api/projects/")
+    items = data if isinstance(data, list) else []
+
+    if as_json:
+        click.echo(json.dumps(items, ensure_ascii=False, indent=2))
+        return
+
+    if not items:
+        console.print("[yellow]暂无可访问的项目[/yellow]")
+        return
+
+    table = Table(title=f"项目列表（共 {len(items)} 个）")
+    table.add_column("ID", style="dim", width=6)
+    table.add_column("代码", width=10)
+    table.add_column("名称", min_width=16)
+    table.add_column("描述", min_width=20)
+
+    for item in items:
+        table.add_row(
+            str(item["id"]),
+            item.get("code", ""),
+            item.get("name", ""),
+            item.get("description") or "—",
+        )
+
+    console.print(table)

{artdam_cli-0.2.0 → artdam_cli-0.2.1}/artdam_cli/main.py

@@ -16,6 +16,7 @@ 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()
@@ -40,3 +41,4 @@ 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.0 → artdam_cli-0.2.1}/artdam_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: artdam-cli
-Version: 0.2.0
+Version: 0.2.1
 Summary: ArtDAM 数字资产管理平台命令行工具
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -28,8 +28,14 @@ pip install artdam-cli
 # 登录（首次使用，服务器地址已内置）
 artdam login --username <用户名> --password <密码>
 
+# 查看可访问的项目列表（获取项目 ID）
+artdam projects
+
+# 设置默认项目（之后无需每次输入 -p）
+artdam project use 1
+
 # 搜索资产
-artdam search "关键词" --project 1
+artdam search "关键词"
 
 # 查看资产详情
 artdam get 123
@@ -42,6 +48,24 @@ artdam download 123 --out ./downloads
 
 ### 查询命令（viewer 及以上）
 
+#### `artdam projects`
+
+列出当前用户可访问的所有项目（含 ID）。
+
+```bash
+artdam projects
+artdam projects --json   # 输出原始 JSON（AI Agent 用）
+```
+
+#### `artdam project use / show`
+
+设置或查看默认项目，设置后所有命令无需再传 `-p`。
+
+```bash
+artdam project use 1     # 设置默认项目 ID 为 1
+artdam project show      # 查看当前默认项目
+```
+
 #### `artdam login`
 
 登录 ArtDAM，保存 token 到本地 `~/.artdam/config.json`。
@@ -55,17 +79,18 @@ artdam login --username <用户名> --password <密码>
 搜索资产，返回匹配列表。
 
 ```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 用）
+artdam search "头盔"                        # 使用默认项目
+artdam search "头盔" --project 1            # 临时指定项目
+artdam search "头盔" --limit 50
+artdam search "头盔" --type image/png
+artdam search "头盔" --folder 10
+artdam search "头盔" --json                 # 输出原始 JSON（AI Agent 用）
 ```
 
 | 参数 | 说明 |
 |---|---|
 | `KEYWORD` | 搜索关键词 |
-| `-p, --project` | 项目 ID（必填） |
+| `-p, --project` | 项目 ID（省略则使用默认项目） |
 | `-n, --limit` | 返回数量上限（默认 20） |
 | `--type` | 文件类型，如 `image/png` |
 | `--folder` | 限定文件夹 ID |
@@ -94,9 +119,9 @@ artdam download 123 --out ./downloads
 列出项目标签。
 
 ```bash
-artdam tags --project 1
-artdam tags --project 1 --search "角色"
-artdam tags --project 1 --json
+artdam tags                        # 使用默认项目
+artdam tags --search "角色"
+artdam tags --json
 ```
 
 #### `artdam folders`
@@ -104,8 +129,8 @@ artdam tags --project 1 --json
 查看文件夹结构。
 
 ```bash
-artdam folders --project 1
-artdam folders --project 1 --json
+artdam folders                     # 使用默认项目
+artdam folders --json
 ```
 
 ### 资产管理（member 及以上）
@@ -115,8 +140,9 @@ artdam folders --project 1 --json
 上传文件到指定项目和文件夹。
 
 ```bash
-artdam upload ./image.jpg --project 1
-artdam upload ./image.jpg --project 1 --folder 10
+artdam upload ./image.jpg                  # 使用默认项目
+artdam upload ./image.jpg --folder 10
+artdam upload ./image.jpg --project 1      # 临时指定项目
 ```
 
 #### `artdam update`
@@ -154,16 +180,17 @@ artdam tag add 123 5
 # 从资产移除标签
 artdam tag remove 123 5
 
-# 创建新标签
+# 创建新标签（省略 -p 则使用默认项目）
+artdam tag create "标签名"
 artdam tag create "标签名" --project 1
 ```
 
 ### 文件夹管理（member 及以上）
 
 ```bash
-# 创建文件夹
-artdam folder create "文件夹名" --project 1
-artdam folder create "子文件夹" --project 1 --parent 10
+# 创建文件夹（省略 -p 则使用默认项目）
+artdam folder create "文件夹名"
+artdam folder create "子文件夹" --parent 10
 
 # 删除文件夹
 artdam folder delete 10
@@ -188,36 +215,43 @@ artdam favorite 123 --remove
 所有查询命令支持 `--json` 输出原始 JSON，适合 Agent 解析：
 
 ```bash
-artdam search "安妮" --project 1 --json
+artdam projects --json
+artdam search "安妮" --json
 artdam get 123 --json
-artdam tags --project 1 --json
-artdam folders --project 1 --json
+artdam tags --json
+artdam folders --json
 ```
 
 ### 典型 Agent 工作流
 
 ```bash
-# 1. 登录（向用户获取用户名密码后执行）
+# 1. 登录
 artdam login --username <用户名> --password <密码>
 
-# 2. 搜索 → 确认 → 下载
-artdam search "头盔" --project 1 --json
+# 2. 查询项目列表，选择目标项目并设为默认
+artdam projects --json
+artdam project use 1
+
+# 3. 搜索 → 确认 → 下载
+artdam search "头盔" --json
 artdam get 50707 --json
 artdam download 50707 --out ./assets
 
-# 3. 搜索 → 批量打标签
-artdam search "安妮" --project 1 --json
+# 4. 搜索 → 批量打标签
+artdam search "安妮" --json
 artdam tag add 50707 5
 artdam tag add 50708 5
 
-# 4. 上传并更新描述
-artdam upload ./new_asset.jpg --project 1 --folder 10
+# 5. 上传并更新描述
+artdam upload ./new_asset.jpg --folder 10
 artdam update <asset_id> --description "AI 生成的场景描述"
 ```
 
 ## 注意事项
 
-- `--project` 参数为**数字 ID**，不是项目名称
+- 首次使用先运行 `artdam projects` 获取项目 ID，再 `artdam project use <id>` 设置默认项目
+- 设置默认项目后，`search` / `tags` / `folders` / `upload` 等命令无需再传 `-p`
+- `-p` 仍可临时覆盖默认项目
 - `--json` 返回原始 JSON，适合程序解析
 - token 保存在 `~/.artdam/config.json`，登录一次长期有效
 - `artdam delete` 是软删除，可用 `artdam restore` 恢复
@@ -230,6 +264,7 @@ artdam update <asset_id> --description "AI 生成的场景描述"
 ```json
 {
   "base_url": "https://artdam.dsworks.cn",
-  "token": "eyJ..."
+  "token": "eyJ...",
+  "default_project": 1
 }
 ```

{artdam_cli-0.2.0 → artdam_cli-0.2.1}/artdam_cli.egg-info/SOURCES.txt

@@ -20,6 +20,7 @@ artdam_cli/commands/folders.py
 artdam_cli/commands/get.py
 artdam_cli/commands/login.py
 artdam_cli/commands/project.py
+artdam_cli/commands/projects.py
 artdam_cli/commands/rate.py
 artdam_cli/commands/restore.py
 artdam_cli/commands/search.py

{artdam_cli-0.2.0 → artdam_cli-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "artdam-cli"
-version = "0.2.0"
+version = "0.2.1"
 requires-python = ">=3.10"
 description = "ArtDAM 数字资产管理平台命令行工具"
 readme = "README.md"

artdam_cli-0.2.0/artdam_cli/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.2.0"