trailsnap-cli 0.1.0__tar.gz

trailsnap_cli-0.1.0/PKG-INFO

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: trailsnap-cli
+Version: 0.1.0
+Summary: TrailSnap Command Line Interface
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# TrailSnap CLI
+
+Command Line Interface for TrailSnap.
+
+## Installation
+
+### Via pip
+
+```bash
+pip install trailsnap-cli
+```
+
+### Via npm
+
+```bash
+npm install -g trailsnap-cli
+```
+
+## Local Development / Testing
+
+If you want to test or develop the CLI locally before publishing:
+
+### 1. Test via Python (Recommended for Development)
+
+Use pip's editable mode to install the package so your code changes take effect immediately without reinstalling:
+
+```bash
+cd package/trailsnap-cli
+pip install -e .
+
+# Test if the command works
+trailsnap --help
+```
+
+### 2. Test via npm (Testing the Node.js Wrapper)
+
+Since the npm package relies on downloading pre-built binaries from GitHub Releases (which don't exist locally), you must build the binary manually and skip the download script.
+
+```bash
+cd package/trailsnap-cli
+
+# Install pyinstaller
+pip install pyinstaller
+
+# Build the standalone executable
+pyinstaller --onefile --name trailsnap --paths trailsnap trailsnap/cli.py
+
+# Create bin directory and move the executable (Windows example)
+mkdir bin
+cp dist/trailsnap.exe bin/
+# For Mac/Linux: cp dist/trailsnap bin/
+
+# Install globally via npm, skipping the postinstall download script
+npm install -g . --ignore-scripts
+
+# Test if the wrapper works
+trailsnap --help
+```
+
+To uninstall local versions:
+- `pip uninstall trailsnap-cli`
+- `npm uninstall -g trailsnap-cli`
+
+## Usage
+
+```bash
+trailsnap --help
+```
+
+获取TrailSnap的API URL和Token
+
+```bash
+trailsnap config set --url <url> --token <token>
+```

trailsnap_cli-0.1.0/README.md

@@ -0,0 +1,74 @@
+# TrailSnap CLI
+
+Command Line Interface for TrailSnap.
+
+## Installation
+
+### Via pip
+
+```bash
+pip install trailsnap-cli
+```
+
+### Via npm
+
+```bash
+npm install -g trailsnap-cli
+```
+
+## Local Development / Testing
+
+If you want to test or develop the CLI locally before publishing:
+
+### 1. Test via Python (Recommended for Development)
+
+Use pip's editable mode to install the package so your code changes take effect immediately without reinstalling:
+
+```bash
+cd package/trailsnap-cli
+pip install -e .
+
+# Test if the command works
+trailsnap --help
+```
+
+### 2. Test via npm (Testing the Node.js Wrapper)
+
+Since the npm package relies on downloading pre-built binaries from GitHub Releases (which don't exist locally), you must build the binary manually and skip the download script.
+
+```bash
+cd package/trailsnap-cli
+
+# Install pyinstaller
+pip install pyinstaller
+
+# Build the standalone executable
+pyinstaller --onefile --name trailsnap --paths trailsnap trailsnap/cli.py
+
+# Create bin directory and move the executable (Windows example)
+mkdir bin
+cp dist/trailsnap.exe bin/
+# For Mac/Linux: cp dist/trailsnap bin/
+
+# Install globally via npm, skipping the postinstall download script
+npm install -g . --ignore-scripts
+
+# Test if the wrapper works
+trailsnap --help
+```
+
+To uninstall local versions:
+- `pip uninstall trailsnap-cli`
+- `npm uninstall -g trailsnap-cli`
+
+## Usage
+
+```bash
+trailsnap --help
+```
+
+获取TrailSnap的API URL和Token
+
+```bash
+trailsnap config set --url <url> --token <token>
+```

trailsnap_cli-0.1.0/pyproject.toml

@@ -0,0 +1,17 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "trailsnap-cli"
+version = "0.1.0"
+description = "TrailSnap Command Line Interface"
+readme = "README.md"
+requires-python = ">=3.9"
+dependencies = []
+
+[project.scripts]
+trailsnap = "trailsnap.cli:main"
+
+[tool.setuptools]
+packages = ["trailsnap", "trailsnap.commands"]

trailsnap_cli-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

trailsnap_cli-0.1.0/trailsnap/cli.py

@@ -0,0 +1,43 @@
+#!/usr/bin/env python3
+import argparse
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).parent))
+
+from commands import config, photos, tags, albums, locations, people, folders, medias
+
+VERSION = "0.1.0"
+
+def main():
+    if hasattr(sys.stdout, "reconfigure"):
+        sys.stdout.reconfigure(errors="replace")
+    if hasattr(sys.stderr, "reconfigure"):
+        sys.stderr.reconfigure(errors="replace")
+    sys.stdout.reconfigure(encoding='utf-8')
+    parser = argparse.ArgumentParser(description="TrailSnap CLI 命令行工具")
+    subparsers = parser.add_subparsers(dest="command", help="可用命令")
+    subparsers.required = True
+
+    parser.add_argument("-v", "--version", action="version", version=VERSION)
+
+    # 注册各个子命令
+    config.setup_parser(subparsers)
+    photos.setup_parser(subparsers)
+    tags.setup_parser(subparsers)
+    albums.setup_parser(subparsers)
+    locations.setup_parser(subparsers)
+    people.setup_parser(subparsers)
+    folders.setup_parser(subparsers)
+    medias.setup_parser(subparsers)
+
+    args = parser.parse_args()
+
+    # 执行对应的命令处理函数
+    if hasattr(args, "func"):
+        args.func(args)
+    else:
+        parser.print_help()
+
+if __name__ == "__main__":
+    main()

trailsnap_cli-0.1.0/trailsnap/commands/__init__.py

@@ -0,0 +1,12 @@
+from . import config, photos, tags, albums, locations, people, folders, medias
+
+__all__ = [
+    "config",
+    "photos",
+    "tags",
+    "albums",
+    "locations",
+    "people",
+    "folders",
+    "medias"
+]

trailsnap_cli-0.1.0/trailsnap/commands/albums.py

@@ -0,0 +1,27 @@
+import json
+from utils import make_request
+
+def setup_parser(subparsers):
+    parser = subparsers.add_parser("albums", help="管理和查询相册")
+    sub_subparsers = parser.add_subparsers(dest="subcommand", help="可用操作")
+    sub_subparsers.required = True
+
+    list_parser = sub_subparsers.add_parser("list", help="查询相册列表")
+    list_parser.add_argument("--skip", type=int, default=0, help="跳过 N 张相册")
+    list_parser.add_argument("--limit", type=int, default=100, help="限制返回 N 张相册")
+    list_parser.set_defaults(func=execute_list)
+
+def execute_list(args):
+    data = make_request("/albums", {"skip": args.skip, "limit": args.limit})
+    if data:
+        albums = [{
+            "id": album["id"],
+            "name": album["name"],
+            "count": album["num_photos"],
+            "description": album["description"],
+            "condition": album["condition"],
+            "type": album["type"]
+        } for album in data]
+        print(json.dumps(albums, indent=2, ensure_ascii=False))
+    else:
+        print("未查询到相册记录")

trailsnap_cli-0.1.0/trailsnap/commands/config.py

@@ -0,0 +1,14 @@
+from utils import save_env
+
+def setup_parser(subparsers):
+    parser = subparsers.add_parser("config", help="配置 CLI")
+    sub_subparsers = parser.add_subparsers(dest="subcommand", help="可用操作")
+    sub_subparsers.required = True
+
+    set_parser = sub_subparsers.add_parser("set", help="配置 API URL 和 Token")
+    set_parser.add_argument("--url", help="API 基础地址 (例如: http://localhost:8000)", required=True)
+    set_parser.add_argument("--token", help="API Token (Bearer 凭证)", required=True)
+    set_parser.set_defaults(func=execute_set)
+
+def execute_set(args):
+    save_env(args.url, args.token)

trailsnap_cli-0.1.0/trailsnap/commands/folders.py

@@ -0,0 +1,17 @@
+import json
+from utils import make_request
+
+def setup_parser(subparsers):
+    parser = subparsers.add_parser("folders", help="管理和查询挂载的存储目录")
+    sub_subparsers = parser.add_subparsers(dest="subcommand", help="可用操作")
+    sub_subparsers.required = True
+
+    list_parser = sub_subparsers.add_parser("list", help="查询挂载的存储目录")
+    list_parser.set_defaults(func=execute_list)
+
+def execute_list(args):
+    data = make_request("/settings/directories")
+    if data is not None:
+        print(json.dumps(data, indent=2, ensure_ascii=False))
+    else:
+        print("未查询到存储目录信息")

trailsnap_cli-0.1.0/trailsnap/commands/locations.py

@@ -0,0 +1,50 @@
+import json
+from utils import make_request
+
+def setup_parser(subparsers):
+    parser = subparsers.add_parser("locations", help="管理和查询位置")
+    sub_subparsers = parser.add_subparsers(dest="subcommand", help="可用操作")
+    sub_subparsers.required = True
+
+    list_parser = sub_subparsers.add_parser("list", help="查询位置分布，不含时间信息（地点名，照片数量）")
+    list_parser.add_argument("--level", choices=["city", "province", "district", "scene"], default="city", help="分组级别，默认 city, 可选值：city,province,district,scene（5A景区） 中的一个")
+    list_parser.add_argument("--skip", type=int, default=0, help="跳过 N 个位置")
+    list_parser.add_argument("--limit", type=int, default=100, help="限制返回 N 个位置")
+    # start_date, end_date 过滤时间范围
+    list_parser.add_argument("--start-date", help="可选，开始日期，格式 YYYY-MM-DD")
+    list_parser.add_argument("--end-date", help="可选，结束日期，格式 YYYY-MM-DD")
+    list_parser.set_defaults(func=execute_list)
+
+    timeline_parser = sub_subparsers.add_parser("timeline", help="查询足迹时间轴列表，按时间和地点分组（开始日期，结束日期，地点名，照片数量）")
+    timeline_parser.add_argument("--level", choices=["city", "province", "district", "scene"], default="city", help="分组级别，默认 city, 可选值：city,province,district,scene（5A景区） 中的一个")
+    timeline_parser.add_argument("--skip", type=int, default=0, help="跳过 N 个位置")
+    timeline_parser.add_argument("--limit", type=int, default=100, help="限制返回 N 个位置")
+    # start_date, end_date 过滤时间范围
+    timeline_parser.add_argument("--start-date", help="可选，开始日期，格式 YYYY-MM-DD")
+    timeline_parser.add_argument("--end-date", help="可选，结束日期，格式 YYYY-MM-DD")
+    timeline_parser.set_defaults(func=execute_timeline)
+
+def execute_timeline(args):
+    data = make_request("/locations/timeline", {"start_date": args.start_date, "end_date": args.end_date, "skip": args.skip, "limit": args.limit, "level": args.level})
+    if data:
+        timelines = [{
+            "startDate": timeline["startDate"],
+            "endDate": timeline["endDate"],
+            "locationName": timeline["locationName"],
+            "count": timeline["photoCount"]
+        } for timeline in data["nodes"]]
+        print(json.dumps(timelines, indent=2, ensure_ascii=False))
+    else:
+        print("未查询到位置足迹时间轴数据")
+
+def execute_list(args):
+    data = make_request("/locations", {"level": args.level, "skip": args.skip, "limit": args.limit, "start_date": args.start_date, "end_date": args.end_date})
+    if data:
+        # 映射字段并添加 count 字段
+        locations = [{
+            "name": location["name"],
+            "count": location["count"]
+        } for location in data]
+        print(json.dumps(locations, indent=2, ensure_ascii=False))
+    else:
+        print("未查询到位置记录")

trailsnap_cli-0.1.0/trailsnap/commands/medias.py

@@ -0,0 +1,50 @@
+import json
+import os
+from utils import make_request,load_env
+
+def setup_parser(subparsers):
+    parser = subparsers.add_parser("medias", help="获取和管理媒体文件")
+    sub_subparsers = parser.add_subparsers(dest="subcommand", help="可用操作")
+    sub_subparsers.required = True
+
+    get_parser = sub_subparsers.add_parser("get", help="获取媒体文件")
+    get_parser.add_argument("--photo-id", type=str, default=100, help="照片ID")
+    get_parser.add_argument("--size", type=str, default="medium", help="照片质量，默认 medium，可选值：small,medium,large")
+    # 输出格式，默认 URL
+    get_parser.add_argument("--format", type=str, default="url", help="输出格式，默认 URL，可选值：url,base64,file")
+    # 输出文件路径，默认不保存
+    get_parser.add_argument("--output", type=str, default=None, help="输出文件路径，默认不保存，仅当format为file时有效")
+    get_parser.set_defaults(func=execute_get)
+
+def execute_get(args):
+    env = load_env()
+    photo_id = args.photo_id
+    size = args.size
+    if size not in ["small", "medium", "large"]:
+        print("错误：size参数值必须为 small,medium,large 中的一个")
+        return
+    format = args.format
+    if format not in ["url", "base64", "file"]:
+        print("错误：format参数值必须为 url,base64,file 中的一个")
+        return
+    output = args.output
+    if format == "url":
+        base_url = env.get("TRAILSNAP_API_URL", "")
+        if not base_url:
+            print("错误：TRAILSNAP_API_URL环境变量未设置")
+            return
+        if size == 'large':
+            print(base_url + f"/medias/{photo_id}/file")
+        else:
+            print(base_url + f"/medias/{photo_id}/thumbnail?size={size}")
+    elif format == "base64":
+        data = make_request(f"/medias/{photo_id}/thumbnail?size={size}&format=base64")
+        print(data["base64"])
+    elif format == "file":
+        if not output:
+            print("错误：output参数值不能为空")
+            return
+        data = make_request(f"/medias/{photo_id}/file", method="GET", response_type="bytes")
+        with open(output, "wb") as f:
+            f.write(data)
+        print(f"将文件保存到 {output}")

trailsnap_cli-0.1.0/trailsnap/commands/people.py

@@ -0,0 +1,35 @@
+import json
+from utils import make_request
+
+def setup_parser(subparsers):
+    parser = subparsers.add_parser("people", help="管理和查询人物（面部识别）")
+    sub_subparsers = parser.add_subparsers(dest="subcommand", help="可用操作")
+    sub_subparsers.required = True
+
+    list_parser = sub_subparsers.add_parser("list", help="查询人物列表")
+    list_parser.add_argument("--limit", type=int, default=100, help="返回的记录数，默认 100")
+    # types: named,unnamed,hidden（允许多个值）
+    list_parser.add_argument("--types", type=str, default="named", help="查询类型，默认 named, 可选值：named,unnamed,hidden 中的一个或多个,逗号分隔")
+    list_parser.set_defaults(func=execute_list)
+
+def execute_list(args):
+    # 验证types参数值是否有效
+    valid_types = {"named", "unnamed", "hidden"}
+    if not set(args.types.split(",")) <= valid_types:
+        print("错误：types参数值必须为 named,unnamed,hidden 中的一个或多个")
+        return
+
+    # 转换types参数值为列表
+    args.types = args.types.split(",")
+    data = make_request("/faces/identities", {"page": 1, "limit": args.limit, "types": args.types})
+    if data:
+        identities = [{
+            "id": identity["id"],
+            "name": identity["identity_name"],
+            "tags": identity["tags"],
+            "description": identity["description"],
+            "face_count": identity["face_count"]
+        } for identity in data]
+        print(json.dumps(identities, indent=2, ensure_ascii=False))
+    else:
+        print("未查询到人物记录")

trailsnap_cli-0.1.0/trailsnap/commands/photos.py

@@ -0,0 +1,111 @@
+import json
+from utils import make_request,load_env
+
+def setup_parser(subparsers):
+    parser = subparsers.add_parser("photos", help="管理和查询照片")
+    sub_subparsers = parser.add_subparsers(dest="subcommand", help="可用操作")
+    sub_subparsers.required = True
+
+    # list subcommand
+    list_parser = sub_subparsers.add_parser("list", help="查询照片列表")
+    list_parser.add_argument("--skip", type=int, default=0, help="跳过 N 张照片")
+    list_parser.add_argument("--limit", type=int, default=10, help="限制返回 N 张照片")
+    list_parser.add_argument("--order_by", type=str, default="memory_score", help="排序字段，默认按值得回忆评分排序，可选值：quality_score,memory_score,photo_time")
+    list_parser.add_argument("--image-type", help="按图片类型过滤照片，多个类型用逗号分隔，可选值：Camera,Screenshot,Other")
+    # start_time 过滤照片
+    list_parser.add_argument("--start-time", help="按开始时间过滤照片，格式为 YYYY-MM-DD HH:MM:SS")
+    # end_time 过滤照片
+    list_parser.add_argument("--end-time", help="按结束时间过滤照片，格式为 YYYY-MM-DD HH:MM:SS")
+    list_parser.add_argument("--album-id", help="按相册 ID 过滤，多个 ID 用逗号分隔")
+    list_parser.add_argument("--people-id", help="按人物 ID 过滤，多个 ID 用逗号分隔")
+    list_parser.add_argument("--tag-id", help="按标签 ID 过滤，多个 ID 用逗号分隔")
+    list_parser.add_argument("--city", help="按城市过滤，多个城市用逗号分隔")
+    list_parser.add_argument("--province", help="按省份过滤，多个省份用逗号分隔")
+    list_parser.add_argument("--scene", help="按景区过滤，多个景区用逗号分隔")
+    list_parser.add_argument("--make", help="按相机品牌过滤，多个品牌用逗号分隔")
+    list_parser.add_argument("--model", help="按相机型号过滤，多个型号用逗号分隔")
+    list_parser.set_defaults(func=execute_list)
+
+    # info subcommand
+    info_parser = sub_subparsers.add_parser("info", help="获取单张照片信息")
+    info_parser.add_argument("--photo-id", required=True, help="照片ID")
+    info_parser.set_defaults(func=execute_info)
+
+    # delete subcommand
+    delete_parser = sub_subparsers.add_parser("delete", help="删除照片")
+    delete_parser.add_argument("--photo-id", required=True, help="照片ID")
+    delete_parser.set_defaults(func=execute_delete)
+
+def execute_list(args):
+    params = {
+        "skip": args.skip,
+        "limit": args.limit,
+        "start_time": args.start_time,
+        "end_time": args.end_time,
+        "image_types": args.image_type.split(",") if args.image_type else [],
+        "scenes": args.scene.split(",") if args.scene else [],
+        "album_ids": args.album_id.split(",") if args.album_id else [],
+        "cities": args.city.split(",") if args.city else [],
+        "provinces": args.province.split(",") if args.province else [],
+        "makes": args.make.split(",") if args.make else [],
+        "models": args.model.split(",") if args.model else [],
+        "face_ids": args.people_id.split(",") if args.people_id else [],
+        "tag_ids": args.tag_id.split(",") if args.tag_id else [],
+        "order_by": args.order_by
+    }
+    data = make_request("/photos/detail", params)
+    env = load_env()
+    base_url = env.get("TRAILSNAP_API_URL", "")
+
+    if data:
+        photos = []
+        for photo in data:
+            metadata = photo.get("metadata_info", {})
+            if not metadata:
+                metadata = {}
+            image_description = photo.get("image_description", {})
+            if not image_description:
+                image_description = {}
+            photos.append({
+                "id": photo["id"],
+                "url": f"{base_url}/medias/{photo['id']}/file",
+                "filename": photo["filename"],
+                "file_type": photo["file_type"],
+                "photo_time": photo["photo_time"],
+                "address": metadata.get("address", ""),
+                "description": {
+                    "description": image_description.get("description", ""),
+                    "tags": image_description.get("tags", []),
+                    "memory_score": image_description.get("memory_score", 0),
+                    "quality_score": image_description.get("quality_score", 0),
+                    "narrative": image_description.get("narrative", "")
+                }
+            })
+        print(json.dumps(photos, indent=2, ensure_ascii=False))
+    else:
+        print("没有查询到照片列表")
+
+def execute_info(args):
+    data = make_request(f"/photos/{args.photo_id}/metadata")
+    description_data = make_request(f"/photos/{args.photo_id}/description")
+    if not description_data:
+        description_data = {}
+    if data:
+        info = {
+            # "file_path": data["file_path"],
+            "address": data["address"],
+            "albums": data["albums"],
+            "tags": data["tags"],
+            "faces_identities": data["faces_identities"],
+            "description": description_data
+        }
+        print(json.dumps(info, indent=2, ensure_ascii=False))
+    else:
+        print("未查询到照片信息")
+
+def execute_delete(args):
+    data = make_request(f"/photos/{args.photo_id}", method="DELETE")
+    if data:
+        print(f"照片 {args.photo_id} 删除成功")
+    else:
+        print("照片删除失败或不存在")

trailsnap_cli-0.1.0/trailsnap/commands/tags.py

@@ -0,0 +1,24 @@
+import json
+from utils import make_request
+
+def setup_parser(subparsers):
+    parser = subparsers.add_parser("tags", help="管理和查询分类标签")
+    sub_subparsers = parser.add_subparsers(dest="subcommand", help="可用操作")
+    sub_subparsers.required = True
+
+    list_parser = sub_subparsers.add_parser("list", help="查询分类标签")
+    list_parser.add_argument("--skip", type=int, default=0, help="跳过 N 个记录")
+    list_parser.add_argument("--limit", type=int, default=100, help="限制返回 N 个记录")
+    list_parser.set_defaults(func=execute_list)
+
+def execute_list(args):
+    data = make_request("/tags", {"skip": args.skip, "limit": args.limit})
+    if data:
+        tags = [{
+            "id": tag["id"],
+            "name": tag["tag_name"],
+            "count": tag["count"]
+        } for tag in data]
+        print(json.dumps(tags, indent=2, ensure_ascii=False))
+    else:
+        print("未查询到分类标签记录")

trailsnap_cli-0.1.0/trailsnap/utils.py

@@ -0,0 +1,86 @@
+import json
+import urllib.request
+from urllib.error import URLError, HTTPError
+import sys
+from pathlib import Path
+from urllib.parse import urlencode
+
+import os
+
+# 获取用户目录（永久目录，不会消失）
+if os.name == "nt":  # Windows
+    CONFIG_DIR = Path(os.getenv("APPDATA")) / "trailsnap"
+else:  # Mac/Linux
+    CONFIG_DIR = Path.home() / ".config" / "trailsnap"
+
+# 确保目录存在
+CONFIG_DIR.mkdir(exist_ok=True)
+
+# .env 配置文件 永久保存在这里
+ENV_FILE = CONFIG_DIR / ".env"
+
+def load_env():
+    if not ENV_FILE.exists():
+        return {}
+    env = {}
+    with open(ENV_FILE, "r", encoding="utf-8") as f:
+        for line in f:
+            line = line.strip()
+            if line and not line.startswith("#") and "=" in line:
+                key, val = line.split("=", 1)
+                env[key.strip()] = val.strip()
+    return env
+
+def save_env(url, token):
+    with open(ENV_FILE, "w", encoding="utf-8") as f:
+        f.write(f"TRAILSNAP_API_URL={url}\n")
+        f.write(f"TRAILSNAP_API_TOKEN={token}\n")
+    print(f"配置已保存到 {ENV_FILE}")
+
+def make_request(endpoint, params=None, method="GET", response_type="json"):
+    env = load_env()
+    base_url = env.get("TRAILSNAP_API_URL")
+    token = env.get("TRAILSNAP_API_TOKEN")
+    
+    if not base_url or not token:
+        print("错误: API URL 和 Token 未配置，请先运行 'config' 命令。")
+        sys.exit(1)
+        
+    url = f"{base_url.rstrip('/')}{endpoint}"
+    if params:
+        # 过滤掉 None 值
+        params = {k: v for k, v in params.items() if v is not None}
+        if params:
+            query_string = urlencode(params, doseq=True)
+            url = f"{url}?{query_string}"
+            
+    headers = {
+        "Authorization": f"Bearer {token}",
+        "Content-Type": "application/json"
+    }
+    
+    req = urllib.request.Request(url, headers=headers)
+    
+    try:
+        with urllib.request.urlopen(req) as response:
+            if response_type == "json":
+                return json.loads(response.read().decode("utf-8"))
+            elif response_type == "text":
+                return response.read().decode("utf-8")
+            if response_type == "bytes":
+                return response.read()
+            else:
+                print(f"未知的响应类型: {response_type}")
+                sys.exit(1)
+                return response.read().decode("utf-8")
+    except HTTPError as e:
+        print(f"HTTP 错误: {e.code} - {e.read().decode('utf-8')}")
+        sys.exit(1)
+    except URLError as e:
+        print(f"URL 错误: {e.reason}")
+        sys.exit(1)
+    except Exception as e:
+        print(f"错误: {str(e)}")
+        sys.exit(1)
+
+load_env()

trailsnap_cli-0.1.0/trailsnap_cli.egg-info/PKG-INFO

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: trailsnap-cli
+Version: 0.1.0
+Summary: TrailSnap Command Line Interface
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# TrailSnap CLI
+
+Command Line Interface for TrailSnap.
+
+## Installation
+
+### Via pip
+
+```bash
+pip install trailsnap-cli
+```
+
+### Via npm
+
+```bash
+npm install -g trailsnap-cli
+```
+
+## Local Development / Testing
+
+If you want to test or develop the CLI locally before publishing:
+
+### 1. Test via Python (Recommended for Development)
+
+Use pip's editable mode to install the package so your code changes take effect immediately without reinstalling:
+
+```bash
+cd package/trailsnap-cli
+pip install -e .
+
+# Test if the command works
+trailsnap --help
+```
+
+### 2. Test via npm (Testing the Node.js Wrapper)
+
+Since the npm package relies on downloading pre-built binaries from GitHub Releases (which don't exist locally), you must build the binary manually and skip the download script.
+
+```bash
+cd package/trailsnap-cli
+
+# Install pyinstaller
+pip install pyinstaller
+
+# Build the standalone executable
+pyinstaller --onefile --name trailsnap --paths trailsnap trailsnap/cli.py
+
+# Create bin directory and move the executable (Windows example)
+mkdir bin
+cp dist/trailsnap.exe bin/
+# For Mac/Linux: cp dist/trailsnap bin/
+
+# Install globally via npm, skipping the postinstall download script
+npm install -g . --ignore-scripts
+
+# Test if the wrapper works
+trailsnap --help
+```
+
+To uninstall local versions:
+- `pip uninstall trailsnap-cli`
+- `npm uninstall -g trailsnap-cli`
+
+## Usage
+
+```bash
+trailsnap --help
+```
+
+获取TrailSnap的API URL和Token
+
+```bash
+trailsnap config set --url <url> --token <token>
+```

trailsnap_cli-0.1.0/trailsnap_cli.egg-info/SOURCES.txt

@@ -0,0 +1,18 @@
+README.md
+pyproject.toml
+trailsnap/cli.py
+trailsnap/utils.py
+trailsnap/commands/__init__.py
+trailsnap/commands/albums.py
+trailsnap/commands/config.py
+trailsnap/commands/folders.py
+trailsnap/commands/locations.py
+trailsnap/commands/medias.py
+trailsnap/commands/people.py
+trailsnap/commands/photos.py
+trailsnap/commands/tags.py
+trailsnap_cli.egg-info/PKG-INFO
+trailsnap_cli.egg-info/SOURCES.txt
+trailsnap_cli.egg-info/dependency_links.txt
+trailsnap_cli.egg-info/entry_points.txt
+trailsnap_cli.egg-info/top_level.txt

trailsnap_cli-0.1.0/trailsnap_cli.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

trailsnap_cli-0.1.0/trailsnap_cli.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+trailsnap = trailsnap.cli:main

trailsnap_cli-0.1.0/trailsnap_cli.egg-info/top_level.txt

@@ -0,0 +1 @@
+trailsnap