gogeo-client-agentos 0.2.2__tar.gz

gogeo_client_agentos-0.2.2/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: gogeo-client-agentos
+Version: 0.2.2
+Summary: AgentOS CLI tool for managing the AgentOS Client Docker container
+Author-email: agentos-team <agentos@example.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/agentos/client
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# AgentOS Client
+
+AgentOS Client Docker 容器管理 CLI 工具。
+
+## 安装
+
+```bash
+pip install agentos
+```
+
+## 使用
+
+### 首次安装/设置
+
+```bash
+# 方式一：直接设置（从环境变量或交互式输入读取 key）
+agentos setup
+
+# 方式二：命令行指定 key
+agentos setup --key "your-nuwax-saved-key"
+
+# 方式三：先设置环境变量
+export NUWAX_SAVED_KEY="your-key"
+agentos setup
+```
+
+setup 流程：
+1. 检查 Docker 是否安装，未安装则自动安装（仅 Linux）
+2. 拉取 agentos-client 镜像
+3. 生成 docker-compose.yml 到 `~/.agentos/`
+4. 保存 key 到 `~/.agentos/.env`
+
+### 日常管理
+
+```bash
+agentos start      # 启动容器
+agentos stop       # 停止容器
+agentos restart    # 重启容器
+agentos status     # 查看容器状态
+agentos logs       # 查看最近 50 行日志
+```
+
+### 更新 key
+
+```bash
+agentos update-key "new-key-here"
+agentos restart    # 重启生效
+```
+
+### 重新部署
+
+```bash
+agentos redeploy   # 删除旧配置，重新生成并重启
+```
+
+## 发布到 PyPI
+
+```bash
+# 安装构建工具
+pip install build twine
+
+# 构建
+cd gogeo-client
+python -m build
+
+# 发布到 TestPyPI（测试）
+python -m twine upload --repository testpypi dist/*
+
+# 发布到 PyPI（正式）
+python -m twine upload dist/*
+```
+
+## 目录结构
+
+```
+gogeo-client/
+├── pyproject.toml          # Python 包配置
+├── agentos/
+│   ├── __init__.py
+│   └── cli.py              # CLI 入口
+├── app/                    # 应用覆盖文件
+├── desktop/                # 桌面快捷方式
+├── icons/                  # 桌面图标
+├── wallpaper/              # 桌面壁纸
+└── docker-compose.yml      # 本地开发用 compose
+```

gogeo_client_agentos-0.2.2/README.md

@@ -0,0 +1,86 @@
+# AgentOS Client
+
+AgentOS Client Docker 容器管理 CLI 工具。
+
+## 安装
+
+```bash
+pip install agentos
+```
+
+## 使用
+
+### 首次安装/设置
+
+```bash
+# 方式一：直接设置（从环境变量或交互式输入读取 key）
+agentos setup
+
+# 方式二：命令行指定 key
+agentos setup --key "your-nuwax-saved-key"
+
+# 方式三：先设置环境变量
+export NUWAX_SAVED_KEY="your-key"
+agentos setup
+```
+
+setup 流程：
+1. 检查 Docker 是否安装，未安装则自动安装（仅 Linux）
+2. 拉取 agentos-client 镜像
+3. 生成 docker-compose.yml 到 `~/.agentos/`
+4. 保存 key 到 `~/.agentos/.env`
+
+### 日常管理
+
+```bash
+agentos start      # 启动容器
+agentos stop       # 停止容器
+agentos restart    # 重启容器
+agentos status     # 查看容器状态
+agentos logs       # 查看最近 50 行日志
+```
+
+### 更新 key
+
+```bash
+agentos update-key "new-key-here"
+agentos restart    # 重启生效
+```
+
+### 重新部署
+
+```bash
+agentos redeploy   # 删除旧配置，重新生成并重启
+```
+
+## 发布到 PyPI
+
+```bash
+# 安装构建工具
+pip install build twine
+
+# 构建
+cd gogeo-client
+python -m build
+
+# 发布到 TestPyPI（测试）
+python -m twine upload --repository testpypi dist/*
+
+# 发布到 PyPI（正式）
+python -m twine upload dist/*
+```
+
+## 目录结构
+
+```
+gogeo-client/
+├── pyproject.toml          # Python 包配置
+├── agentos/
+│   ├── __init__.py
+│   └── cli.py              # CLI 入口
+├── app/                    # 应用覆盖文件
+├── desktop/                # 桌面快捷方式
+├── icons/                  # 桌面图标
+├── wallpaper/              # 桌面壁纸
+└── docker-compose.yml      # 本地开发用 compose
+```

gogeo_client_agentos-0.2.2/agentos/cli.py

@@ -0,0 +1,928 @@
+#!/usr/bin/env python3
+"""
+AgentOS CLI tool
+"""
+
+import argparse
+import os
+import platform
+import subprocess
+import sys
+import time
+from pathlib import Path
+
+VERSION = "0.2.0"
+IMAGE_NAME = "nuwax-docker-images-registry.cn-hangzhou.cr.aliyuncs.com/nuwax/nuwax-agent-client:latest"
+CONTAINER_NAME = "agentos-client"
+
+COLORS = {
+    "green": "\033[0;32m",
+    "yellow": "\033[1;33m",
+    "red": "\033[0;31m",
+    "cyan": "\033[0;36m",
+    "reset": "\033[0m",
+}
+
+
+def color(name, text):
+    return f"{COLORS.get(name, '')}{text}{COLORS['reset']}"
+
+
+def info(text):
+    print(color("green", f"[INFO]  {text}"))
+
+
+def warn(text):
+    print(color("yellow", f"[WARN]  {text}"))
+
+
+def error(text):
+    print(color("red", f"[ERROR] {text}"))
+
+
+# ============================================================
+# Docker mirrors (acceleration)
+# ============================================================
+
+DOCKER_MIRRORS = [
+    "https://docker.1ms.run",
+    "https://hub-mirror.c.163.com",
+    "https://docker.m.daocloud.io",
+]
+
+
+def configure_docker_mirrors():
+    """配置 Docker 镜像加速器"""
+    system = platform.system()
+    info("正在检查 Docker 镜像加速配置...")
+
+    if system == "Linux":
+        _configure_linux_mirrors()
+    elif system == "Darwin":
+        _configure_darwin_mirrors()
+    elif system == "Windows":
+        _configure_windows_mirrors()
+
+
+def _configure_linux_mirrors():
+    daemon_json = Path("/etc/docker/daemon.json")
+    if daemon_json.exists():
+        import json
+        try:
+            existing = json.loads(daemon_json.read_text())
+            if "registry-mirrors" in existing:
+                info("Docker 镜像加速已配置")
+                return
+        except (json.JSONDecodeError, IOError):
+            pass
+
+    import json
+    config = {"registry-mirrors": DOCKER_MIRRORS}
+    if daemon_json.exists():
+        try:
+            existing = json.loads(daemon_json.read_text())
+            existing.update(config)
+            config = existing
+        except (json.JSONDecodeError, IOError):
+            pass
+
+    try:
+        daemon_json.write_text(json.dumps(config, indent=2))
+        info("已写入 Docker 镜像加速配置")
+        subprocess.run(["sudo", "systemctl", "reload", "docker"], capture_output=True, text=True)
+        result = subprocess.run(["docker", "info"], capture_output=True, text=True, timeout=5)
+        if result.returncode != 0:
+            subprocess.run(["sudo", "systemctl", "restart", "docker"])
+    except PermissionError:
+        warn("无权限写入 /etc/docker/daemon.json，跳过镜像加速配置")
+
+
+def _configure_darwin_mirrors():
+    daemon_json = Path.home() / ".docker" / "daemon.json"
+    daemon_json.parent.mkdir(parents=True, exist_ok=True)
+    import json
+    if daemon_json.exists():
+        try:
+            existing = json.loads(daemon_json.read_text())
+            if "registry-mirrors" in existing:
+                info("Docker 镜像加速已配置")
+                return
+            existing.update({"registry-mirrors": DOCKER_MIRRORS})
+            config = existing
+        except (json.JSONDecodeError, IOError):
+            config = {"registry-mirrors": DOCKER_MIRRORS}
+    else:
+        config = {"registry-mirrors": DOCKER_MIRRORS}
+
+    daemon_json.write_text(json.dumps(config, indent=2))
+    info("已写入 Docker 镜像加速配置，请重启 Docker Desktop")
+
+
+def _configure_windows_mirrors():
+    import json
+    docker_config_dir = Path(os.environ.get("PROGRAMDATA", "")) / "Docker" / "config"
+    daemon_json = docker_config_dir / "daemon.json"
+    daemon_json_alt = docker_config_dir / "daemon" / "daemon.json"
+
+    for config_path in [daemon_json, daemon_json_alt]:
+        if config_path.exists():
+            try:
+                existing = json.loads(config_path.read_text())
+                if "registry-mirrors" in existing:
+                    info("Docker 镜像加速已配置")
+                    return
+                existing.update({"registry-mirrors": DOCKER_MIRRORS})
+                config = existing
+            except (json.JSONDecodeError, IOError):
+                config = {"registry-mirrors": DOCKER_MIRRORS}
+            config_path.write_text(json.dumps(config, indent=2))
+            info("已写入 Docker 镜像加速配置")
+            return
+
+    docker_config_dir.mkdir(parents=True, exist_ok=True)
+    daemon_json.write_text(json.dumps({"registry-mirrors": DOCKER_MIRRORS}, indent=2))
+    info("已写入 Docker 镜像加速配置")
+
+
+# ============================================================
+# Docker check / install
+# ============================================================
+
+def docker_installed():
+    """检查 Docker 是否已安装并运行"""
+    try:
+        result = subprocess.run(
+            ["docker", "--version"], capture_output=True, text=True, timeout=5
+        )
+        if result.returncode != 0:
+            return False
+    except (subprocess.SubprocessError, FileNotFoundError):
+        return False
+
+    try:
+        result = subprocess.run(
+            ["docker", "info"], capture_output=True, text=True, timeout=10
+        )
+        return result.returncode == 0
+    except (subprocess.SubprocessError, FileNotFoundError):
+        return False
+
+
+def check_docker():
+    """检查 Docker，未安装则自动安装"""
+    try:
+        result = subprocess.run(
+            ["docker", "--version"], capture_output=True, text=True, timeout=5
+        )
+        docker_binary_exists = result.returncode == 0
+    except (subprocess.SubprocessError, FileNotFoundError):
+        docker_binary_exists = False
+
+    if docker_installed():
+        return
+
+    if docker_binary_exists:
+        warn("Docker 已安装但服务未启动，正在尝试启动...")
+        _start_docker()
+        if docker_installed():
+            info(f"Docker 已启动: {subprocess.run(['docker', '--version'], capture_output=True, text=True).stdout.strip()}")
+            return
+        warn("Docker 服务启动失败，请手动检查")
+        sys.exit(1)
+
+    # Windows 特殊处理：检查 Docker Desktop 是否已安装（即使 docker 不在 PATH 中）
+    if platform.system() == "Windows":
+        if _check_docker_desktop_installed_windows():
+            warn("Docker Desktop 已安装但 docker 命令不可用，正在启动...")
+            _start_docker()
+            if docker_installed():
+                info(f"Docker 已启动: {subprocess.run(['docker', '--version'], capture_output=True, text=True).stdout.strip()}")
+                return
+            warn("Docker 服务启动失败，请手动检查")
+            sys.exit(1)
+
+    warn("未检测到 Docker，开始自动安装...")
+    install_docker()
+
+    if not docker_installed():
+        error("Docker 安装完成但服务未启动，请手动检查")
+        sys.exit(1)
+
+    info(f"Docker 已安装: {subprocess.run(['docker', '--version'], capture_output=True, text=True).stdout.strip()}")
+
+
+def _check_docker_desktop_installed_windows():
+    """Windows 上检查 Docker Desktop 是否已安装"""
+    try:
+        result = subprocess.run(
+            ["winget", "list", "--id", "Docker.DockerDesktop",
+             "--accept-source-agreements"],
+            capture_output=True, text=True
+        )
+        return "Docker.DockerDesktop" in result.stdout or "Docker Desktop" in result.stdout
+    except (subprocess.SubprocessError, FileNotFoundError):
+        return False
+
+
+def _start_docker():
+    """尝试启动 Docker 服务"""
+    system = platform.system()
+    if system == "Windows":
+        try:
+            subprocess.Popen(
+                ["C:\\Program Files\\Docker\\Docker\\Docker Desktop.exe"],
+                creationflags=subprocess.CREATE_NO_WINDOW
+            )
+        except FileNotFoundError:
+            pass
+        _wait_for_docker_ready()
+    elif system == "Darwin":
+        subprocess.Popen(["open", "/Applications/Docker.app"])
+        _wait_for_docker_ready()
+    elif system == "Linux":
+        subprocess.run(["sudo", "systemctl", "start", "docker"])
+
+
+def _wait_for_docker_ready(timeout=300):
+    """轮询等待 Docker 就绪"""
+    start = time.time()
+    dots = 0
+    while time.time() - start < timeout:
+        try:
+            result = subprocess.run(
+                ["docker", "info"],
+                capture_output=True, text=True, timeout=5
+            )
+            if result.returncode == 0:
+                print()
+                info("Docker 已就绪")
+                return
+        except (subprocess.SubprocessError, FileNotFoundError):
+            pass
+
+        dots += 1
+        if dots % 5 == 0:
+            elapsed = int(time.time() - start)
+            print(f"\r  等待中... ({elapsed}s)", end="", flush=True)
+
+        time.sleep(3)
+
+    print()
+    error(f"Docker 在 {timeout}s 内未就绪，请稍后重试")
+    sys.exit(1)
+
+
+def install_docker():
+    """自动安装 Docker"""
+    system = platform.system()
+
+    if system == "Windows":
+        _install_docker_windows()
+    elif system == "Darwin":
+        _install_docker_mac()
+    else:
+        _install_docker_linux()
+
+    # 启动服务（非 Windows）
+    if system != "Windows":
+        info("正在启动 Docker 服务...")
+        subprocess.run(["sudo", "systemctl", "start", "docker"])
+        subprocess.run(["sudo", "systemctl", "enable", "docker"])
+        _wait_for_docker_ready()
+        return
+
+    info("Docker 安装完成，等待服务就绪...")
+    _wait_for_docker_ready()
+
+
+def _install_docker_windows():
+    # 先检查 winget 是否显示已安装（避免重复下载安装）
+    try:
+        result = subprocess.run(
+            ["winget", "list", "--id", "Docker.DockerDesktop",
+             "--accept-source-agreements"],
+            capture_output=True, text=True
+        )
+        if "Docker.DockerDesktop" in result.stdout or "Docker Desktop" in result.stdout:
+            info("Docker Desktop 已安装，正在启动...")
+            _start_docker()
+            return
+    except FileNotFoundError:
+        pass
+
+    info("正在安装 Docker Desktop (Windows)...")
+
+    # 优先使用 winget
+    try:
+        result = subprocess.run(
+            ["winget", "--version"], capture_output=True, text=True
+        )
+        if result.returncode == 0:
+            info("使用 winget 安装...")
+            rc = subprocess.run([
+                "winget", "install", "-e", "--id", "Docker.DockerDesktop",
+                "--accept-package-agreements", "--accept-source-agreements"
+            ])
+            if rc.returncode == 0:
+                _start_docker()
+                return
+            warn("winget 安装失败，尝试直接下载...")
+    except FileNotFoundError:
+        pass
+
+    # 备选：PowerShell 直接下载安装
+    info("使用 PowerShell 下载安装...")
+    docker_installer_url = (
+        "https://desktop.docker.com/win/main/amd64/225177/Docker%20Desktop%20Installer.exe"
+    )
+    installer_path = os.path.join(
+        os.environ.get("TEMP", "."), "DockerDesktopInstaller.exe"
+    )
+
+    info(f"正在下载: {docker_installer_url}")
+    rc = subprocess.run([
+        "powershell", "-Command",
+        f"[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; "
+        f"Invoke-WebRequest -Uri '{docker_installer_url}' -OutFile '{installer_path}'"
+    ])
+    if rc.returncode != 0:
+        warn("下载失败，请手动安装 Docker Desktop：")
+        warn("https://www.docker.com/products/docker-desktop/")
+        sys.exit(1)
+
+    info("正在安装 Docker Desktop...")
+    subprocess.run([installer_path, "install", "--quiet", "--accept-license"])
+    _start_docker()
+
+
+def _install_docker_mac():
+    info("正在安装 Docker Desktop (macOS)...")
+
+    try:
+        result = subprocess.run(
+            ["brew", "--version"], capture_output=True, text=True
+        )
+        if result.returncode == 0:
+            info("使用 Homebrew 安装...")
+            subprocess.run(["brew", "install", "--cask", "docker"])
+            _start_docker()
+            return
+    except FileNotFoundError:
+        pass
+
+    info("Homebrew 不可用，直接下载 Docker Desktop...")
+    docker_dmg_url = "https://desktop.docker.com/mac/main/arm64/Docker.dmg"
+    dmg_path = "/tmp/Docker.dmg"
+
+    info(f"正在下载: {docker_dmg_url}")
+    subprocess.run(["curl", "-fsSL", docker_dmg_url, "-o", dmg_path])
+
+    info("正在挂载并安装...")
+    result = subprocess.run(
+        ["hdiutil", "attach", dmg_path],
+        capture_output=True, text=True
+    )
+    mount_point = None
+    for line in result.stdout.splitlines():
+        if "Docker" in line and "/Volumes/" in line:
+            mount_point = line.split("/Volumes/")[-1].strip()
+            break
+
+    if mount_point:
+        subprocess.run(["cp", "-R", f"/Volumes/{mount_point}/Docker.app", "/Applications/"])
+        subprocess.run(["hdiutil", "detach", f"/Volumes/{mount_point}"])
+
+    os.remove(dmg_path)
+    _start_docker()
+
+
+def _install_docker_linux():
+    try:
+        with open("/etc/os-release") as f:
+            os_release = f.read()
+    except FileNotFoundError:
+        os_release = ""
+
+    if "ubuntu" in os_release or "debian" in os_release:
+        _install_docker_debian()
+    elif "centos" in os_release or "rhel" in os_release or "rocky" in os_release or "almalinux" in os_release:
+        _install_docker_centos()
+    else:
+        _install_docker_generic()
+
+
+def _install_docker_debian():
+    info("正在安装 Docker (Debian/Ubuntu)...")
+    _run_shell(["sudo", "apt-get", "update"])
+    _run_shell([
+        "sudo", "apt-get", "install", "-y",
+        "ca-certificates", "curl", "gnupg", "lsb-release",
+    ])
+    _run_shell(["sudo", "install", "-m", "0755", "-d", "/etc/apt/keyrings"])
+    try:
+        _run_shell([
+            "sudo", "bash", "-c",
+            "curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg "
+            "| gpg --dearmor -o /etc/apt/keyrings/docker.gpg"
+        ])
+    except RuntimeError:
+        _run_shell([
+            "sudo", "bash", "-c",
+            "curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/debian/gpg "
+            "| gpg --dearmor -o /etc/apt/keyrings/docker.gpg"
+        ])
+    _run_shell(["sudo", "chmod", "a+r", "/etc/apt/keyrings/docker.gpg"])
+    _run_shell([
+        "sudo", "bash", "-c",
+        "echo 'deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] "
+        "https://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable' "
+        "> /etc/apt/sources.list.d/docker.list"
+    ])
+    _run_shell(["sudo", "apt-get", "update"])
+    _run_shell([
+        "sudo", "apt-get", "install", "-y",
+        "docker-ce", "docker-ce-cli", "containerd.io", "docker-compose-plugin",
+    ])
+
+
+def _install_docker_centos():
+    info("正在安装 Docker (CentOS/RHEL)...")
+    _run_shell(["sudo", "yum", "install", "-y", "yum-utils"])
+    try:
+        _run_shell([
+            "sudo", "yum-config-manager", "--add-repo",
+            "https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo"
+        ])
+    except RuntimeError:
+        _run_shell([
+            "sudo", "yum-config-manager", "--add-repo",
+            "https://download.docker.com/linux/centos/docker-ce.repo"
+        ])
+    _run_shell([
+        "sudo", "yum", "install", "-y",
+        "docker-ce", "docker-ce-cli", "containerd.io", "docker-compose-plugin",
+    ])
+
+
+def _install_docker_generic():
+    info("正在安装 Docker (通用脚本)...")
+    _run_shell(["sudo", "bash", "-c", "curl -fsSL https://get.docker.com | sh -s -- --mirror Aliyun"])
+
+
+def _run_shell(cmd, check=True):
+    """执行 shell 命令（静默）"""
+    result = subprocess.run(cmd, capture_output=True, text=True)
+    if check and result.returncode != 0:
+        raise RuntimeError(f"命令执行失败: {' '.join(cmd)}\n{result.stderr}")
+    return result
+
+
+# ============================================================
+# Docker compose
+# ============================================================
+
+def compose_command():
+    """返回可用的 docker compose 命令"""
+    for cmd in [["docker", "compose"], ["docker-compose"]]:
+        try:
+            result = subprocess.run(
+                cmd + ["version"], capture_output=True, text=True, timeout=5
+            )
+            if result.returncode == 0:
+                return cmd
+        except (subprocess.SubprocessError, FileNotFoundError):
+            continue
+    return None
+
+
+def run_cmd(cmd, check=True):
+    """执行 shell 命令（可见输出）"""
+    print(color("cyan", f"$ {' '.join(cmd)}"))
+    result = subprocess.run(cmd)
+    if check and result.returncode != 0:
+        raise RuntimeError(f"命令执行失败: {' '.join(cmd)}")
+    return result
+
+
+# ============================================================
+# Pull image with progress
+# ============================================================
+
+def pull_image():
+    """拉取镜像（带进度显示）"""
+    DISPLAY_NAME = "gogeo-agentos:latest"
+    info(f"正在拉取镜像: {DISPLAY_NAME}")
+    print()
+
+    process = subprocess.Popen(
+        ["docker", "pull", IMAGE_NAME],
+        stdout=subprocess.PIPE, stderr=subprocess.STDOUT,
+        text=True, bufsize=1
+    )
+
+    layers = {}
+    dots = 0
+
+    for line in process.stdout:
+        line = line.strip()
+        if not line:
+            continue
+
+        if ":" in line and any(kw in line for kw in [
+            "Downloading", "Extracting", "Pulling fs layer", "Waiting",
+            "Verifying Checksum", "Download complete", "Pull complete", "Already exists"
+        ]):
+            parts = line.split(":", 1)
+            layer_id = parts[0].strip()
+            layers[layer_id] = parts[1].strip() if len(parts) > 1 else ""
+        elif line and not line.startswith("{"):
+            print(f"  {line}")
+
+        dots += 1
+        if dots % 20 == 0:
+            _print_pull_progress(layers)
+
+    process.wait()
+    print()
+    _print_pull_progress(layers, final=True)
+
+    if process.returncode != 0:
+        error("镜像拉取失败")
+        sys.exit(1)
+
+    info("镜像拉取完成")
+    print()
+
+
+def _print_pull_progress(layers, final=False):
+    """打印拉取进度"""
+    total = len(layers)
+    if total == 0:
+        return
+
+    completed = 0
+    for layer_id, status in layers.items():
+        if any(kw in status for kw in ["Pull complete", "Download complete", "Already exists"]):
+            completed += 1
+
+    bar_len = 30
+    filled = int(bar_len * completed / total)
+    bar = "█" * filled + "░" * (bar_len - filled)
+    sys.stdout.write(f"\r  [{bar}] {completed}/{total} 层   ")
+    if final:
+        sys.stdout.write("\n")
+    sys.stdout.flush()
+
+
+def ensure_image():
+    """确保镜像存在"""
+    result = subprocess.run(
+        ["docker", "image", "inspect", IMAGE_NAME],
+        capture_output=True, text=True
+    )
+    if result.returncode != 0:
+        pull_image()
+    else:
+        info("镜像已存在，跳过拉取")
+
+
+# ============================================================
+# Config
+# ============================================================
+
+def get_config_dir():
+    """获取配置目录"""
+    return Path.home() / ".agentos"
+
+
+def get_compose_file():
+    return get_config_dir() / "docker-compose.yml"
+
+
+def get_env_file():
+    return get_config_dir() / ".env"
+
+
+def get_saved_key():
+    """获取 NUWAX_SAVED_KEY"""
+    key = os.environ.get("NUWAX_SAVED_KEY")
+    if key:
+        return key
+
+    env_file = get_env_file()
+    if env_file.exists():
+        for line in env_file.read_text().splitlines():
+            if line.startswith("NUWAX_SAVED_KEY="):
+                return line.split("=", 1)[1].strip()
+
+    return None
+
+
+def save_saved_key(key):
+    """保存 key 到 .env"""
+    config_dir = get_config_dir()
+    config_dir.mkdir(parents=True, exist_ok=True)
+
+    env_file = get_env_file()
+    env_file.write_text(f"# AgentOS 配置\nNUWAX_SAVED_KEY={key}\n")
+    info(f"已保存 key 到 {env_file}")
+
+
+# ============================================================
+# Setup
+# ============================================================
+
+def setup(key=None, force=False):
+    """首次安装/设置"""
+    print()
+    print("=" * 50)
+    print("  AgentOS 安装")
+    print("=" * 50)
+    print()
+
+    check_docker()
+    configure_docker_mirrors()
+
+    compose = compose_command()
+    if not compose:
+        error("未找到 docker compose 或 docker-compose 命令")
+        sys.exit(1)
+
+    info(f"使用 compose 命令: {' '.join(compose)}")
+
+    ensure_image()
+
+    if key:
+        saved_key = key
+    else:
+        saved_key = get_saved_key()
+
+    if not saved_key:
+        saved_key = input(color("yellow", "[输入] 请输入 NUWAX_SAVED_KEY: ")).strip()
+        if not saved_key:
+            error("key 不能为空")
+            sys.exit(1)
+
+    save_saved_key(saved_key)
+
+    deploy_compose(saved_key, force)
+    copy_resources(force)
+
+    print()
+    info("安装完成！")
+    info(f"配置文件: {get_config_dir()}")
+    print()
+    print("  后续使用命令:")
+    print("    agentos start    启动容器")
+    print("    agentos stop     停止容器")
+    print("    agentos restart  重启容器")
+    print("    agentos status   查看状态")
+    print()
+
+
+def copy_resources(force=False):
+    """从包内复制资源文件到配置目录"""
+    config_dir = get_config_dir()
+
+    import gzip
+    import importlib.resources as pkg_resources
+
+    resource_files = [
+        ("app/app.asar", True),  # True = gzip 压缩
+        ("desktop/gogeoclaw.desktop", False),
+        ("desktop/terminal.desktop", False),
+        ("desktop/vscode.desktop", False),
+        ("desktop/chromium.desktop", False),
+        ("icons/@nuwax-ainuwaclaw.png", False),
+        ("wallpaper/gogeoDesk.jpg", False),
+    ]
+
+    copied = 0
+    replaced = 0
+    for rel_path, is_gzipped in resource_files:
+        dest = config_dir / rel_path
+
+        try:
+            res = pkg_resources.files("agentos.resources") / rel_path
+            data = res.read_bytes()
+            if is_gzipped:
+                data = gzip.decompress(data)
+        except (FileNotFoundError, TypeError):
+            data = b""
+
+        if dest.exists() and not dest.is_dir():
+            if not force and dest.stat().st_size == len(data):
+                continue
+            if dest.stat().st_size < len(data):
+                replaced += 1
+
+        dest.parent.mkdir(parents=True, exist_ok=True)
+        dest.write_bytes(data)
+        copied += 1
+
+    if replaced > 0:
+        info(f"已更新 {replaced} 个过时的资源文件")
+    if copied > 0 and replaced == 0:
+        info(f"已复制 {copied} 个资源文件到配置目录")
+    elif copied == 0:
+        info("资源文件已是最新版本")
+
+
+def deploy_compose(key, force=False):
+    """部署 docker-compose.yml"""
+    config_dir = get_config_dir()
+    config_dir.mkdir(parents=True, exist_ok=True)
+
+    compose_file = get_compose_file()
+
+    if compose_file.exists() and not force:
+        info(f"docker-compose.yml 已存在: {compose_file}")
+        return
+
+    content = f"""services:
+  agentos-client:
+    image: {IMAGE_NAME}
+    container_name: {CONTAINER_NAME}
+    restart: always
+    ports:
+      - "6080:6080"
+    volumes:
+      - agentos_home:/home/user
+      - ./desktop/gogeoclaw.desktop:/usr/share/applications/@nuwax-ainuwaclaw.desktop
+      - ./desktop/terminal.desktop:/usr/share/applications/user-terminal.desktop
+      - ./desktop/vscode.desktop:/usr/share/applications/user-vscode.desktop
+      - ./desktop/chromium.desktop:/usr/share/applications/chromium-browser.desktop
+      - ./icons/@nuwax-ainuwaclaw.png:/usr/share/icons/hicolor/512x512/apps/@nuwax-ainuwaclaw.png
+      - ./wallpaper/gogeoDesk.jpg:/usr/share/backgrounds/xfce/wallpaper.jpeg
+
+    environment:
+      - TZ=Asia/Shanghai
+      - NUWAX_SERVER_HOST=https://agentos.topprismdata.com/claw-api
+      - NUWAX_AGENT_PORT=60006
+      - NUWAX_FILE_SERVER_PORT=60005
+      - NUWAX_WORKSPACE_DIR=/home/user/nuwaxbot/workspace
+      - NUWAX_SAVED_KEY={key}
+
+volumes:
+  agentos_home:
+"""
+
+    compose_file.write_text(content)
+    info(f"已生成 docker-compose.yml: {compose_file}")
+
+
+# ============================================================
+# Commands
+# ============================================================
+
+def cmd_start():
+    compose = compose_command()
+    if not compose:
+        error("未找到 docker compose")
+        sys.exit(1)
+
+    compose_file = get_compose_file()
+    if not compose_file.exists():
+        warn("未找到配置，请先运行: agentos setup")
+        sys.exit(1)
+
+    info("启动 AgentOS Client...")
+    run_cmd(compose + ["-f", str(compose_file), "up", "-d"])
+
+    print()
+    info("容器已启动")
+    print()
+    print("  访问地址: http://localhost:6080")
+    print()
+
+
+def cmd_stop():
+    compose = compose_command()
+    if not compose:
+        error("未找到 docker compose")
+        sys.exit(1)
+
+    compose_file = get_compose_file()
+    if not compose_file.exists():
+        warn("未找到配置")
+        sys.exit(1)
+
+    info("停止 AgentOS Client...")
+    run_cmd(compose + ["-f", str(compose_file), "down"])
+    info("容器已停止")
+
+
+def cmd_restart():
+    cmd_stop()
+    print()
+    cmd_start()
+
+
+def cmd_status():
+    result = subprocess.run(
+        ["docker", "ps", "-a", "--filter", f"name={CONTAINER_NAME}",
+         "--format", "table {{.Names}}\t{{.Status}}\t{{.Ports}}"],
+        capture_output=True, text=True
+    )
+    print(result.stdout)
+
+    if CONTAINER_NAME not in result.stdout:
+        warn("容器不存在，请先运行: agentos setup")
+
+
+def cmd_logs():
+    result = subprocess.run(
+        ["docker", "logs", "--tail", "50", CONTAINER_NAME],
+        capture_output=True, text=True
+    )
+    print(result.stdout)
+    print(result.stderr)
+
+
+def cmd_update_key(new_key):
+    """更新 key"""
+    save_saved_key(new_key)
+
+    compose_file = get_compose_file()
+    if compose_file.exists():
+        content = compose_file.read_text()
+        content = content.replace(
+            "NUWAX_SAVED_KEY=",
+            f"NUWAX_SAVED_KEY={new_key}"
+        )
+        compose_file.write_text(content)
+        info("已更新 docker-compose.yml 中的 key")
+
+    info("如需生效，请运行: agentos restart")
+
+
+def cmd_redeploy():
+    """重新部署（删除旧配置重新生成）"""
+    compose_file = get_compose_file()
+    if compose_file.exists():
+        compose_file.unlink()
+        info("已删除旧配置")
+
+    key = get_saved_key()
+    if key:
+        setup(key=key, force=True)
+    else:
+        warn("未找到已保存的 key，请先运行: agentos setup")
+        sys.exit(1)
+
+
+# ============================================================
+# CLI
+# ============================================================
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="agentos",
+        description="AgentOS Client Docker 容器管理工具",
+    )
+    parser.add_argument(
+        "--version", action="version", version=f"agentos {VERSION}"
+    )
+
+    subparsers = parser.add_subparsers(dest="command", help="命令")
+
+    p_setup = subparsers.add_parser("setup", help="首次安装/设置")
+    p_setup.add_argument("--key", help="NUWAX_SAVED_KEY")
+    p_setup.add_argument("--force", action="store_true", help="强制重新生成配置")
+
+    subparsers.add_parser("start", help="启动容器")
+    subparsers.add_parser("stop", help="停止容器")
+    subparsers.add_parser("restart", help="重启容器")
+    subparsers.add_parser("status", help="查看容器状态")
+    subparsers.add_parser("logs", help="查看容器日志")
+
+    p_key = subparsers.add_parser("update-key", help="更新 NUWAX_SAVED_KEY")
+    p_key.add_argument("key", help="新的 key")
+
+    subparsers.add_parser("redeploy", help="重新部署（重新生成配置并重启）")
+
+    args = parser.parse_args()
+
+    if args.command == "setup":
+        setup(key=args.key, force=args.force)
+    elif args.command == "start":
+        cmd_start()
+    elif args.command == "stop":
+        cmd_stop()
+    elif args.command == "restart":
+        cmd_restart()
+    elif args.command == "status":
+        cmd_status()
+    elif args.command == "logs":
+        cmd_logs()
+    elif args.command == "update-key":
+        cmd_update_key(args.key)
+    elif args.command == "redeploy":
+        cmd_redeploy()
+    else:
+        parser.print_help()
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

gogeo_client_agentos-0.2.2/agentos/resources/desktop/chromium.desktop

@@ -0,0 +1,9 @@
+[Desktop Entry]
+Version=1.0
+Type=Application
+Name=Chromium
+Comment=Web Browser
+Exec=/usr/bin/chromium-browser-launcher
+Icon=chromium
+Terminal=false
+Categories=Network;WebBrowser;

gogeo_client_agentos-0.2.2/agentos/resources/desktop/gogeoclaw.desktop

@@ -0,0 +1,10 @@
+[Desktop Entry]
+Version=1.0
+Type=Application
+Name=AgentOs
+Comment=AgentOs Desktop Client (Electron)
+Exec=/usr/local/bin/nuwax-agent %U
+Icon=@nuwax-ainuwaclaw
+Terminal=false
+Categories=Productivity;
+StartupWMClass=nuwaclaw

gogeo_client_agentos-0.2.2/agentos/resources/desktop/terminal.desktop

@@ -0,0 +1,9 @@
+[Desktop Entry]
+Version=1.0
+Type=Application
+Name=Terminal
+Comment=Terminal Emulator
+Exec=xfce4-terminal
+Icon=utilities-terminal
+Terminal=false
+Categories=System;TerminalEmulator;

gogeo_client_agentos-0.2.2/agentos/resources/desktop/vscode.desktop

@@ -0,0 +1,9 @@
+[Desktop Entry]
+Version=1.0
+Type=Application
+Name=Visual Studio Code
+Comment=Code Editor
+Exec=/usr/bin/code --no-sandbox --user-data-dir=/home/user/.config/Code
+Icon=vscode
+Terminal=false
+Categories=Development;IDE;

gogeo_client_agentos-0.2.2/gogeo_client_agentos.egg-info/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: gogeo-client-agentos
+Version: 0.2.2
+Summary: AgentOS CLI tool for managing the AgentOS Client Docker container
+Author-email: agentos-team <agentos@example.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/agentos/client
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# AgentOS Client
+
+AgentOS Client Docker 容器管理 CLI 工具。
+
+## 安装
+
+```bash
+pip install agentos
+```
+
+## 使用
+
+### 首次安装/设置
+
+```bash
+# 方式一：直接设置（从环境变量或交互式输入读取 key）
+agentos setup
+
+# 方式二：命令行指定 key
+agentos setup --key "your-nuwax-saved-key"
+
+# 方式三：先设置环境变量
+export NUWAX_SAVED_KEY="your-key"
+agentos setup
+```
+
+setup 流程：
+1. 检查 Docker 是否安装，未安装则自动安装（仅 Linux）
+2. 拉取 agentos-client 镜像
+3. 生成 docker-compose.yml 到 `~/.agentos/`
+4. 保存 key 到 `~/.agentos/.env`
+
+### 日常管理
+
+```bash
+agentos start      # 启动容器
+agentos stop       # 停止容器
+agentos restart    # 重启容器
+agentos status     # 查看容器状态
+agentos logs       # 查看最近 50 行日志
+```
+
+### 更新 key
+
+```bash
+agentos update-key "new-key-here"
+agentos restart    # 重启生效
+```
+
+### 重新部署
+
+```bash
+agentos redeploy   # 删除旧配置，重新生成并重启
+```
+
+## 发布到 PyPI
+
+```bash
+# 安装构建工具
+pip install build twine
+
+# 构建
+cd gogeo-client
+python -m build
+
+# 发布到 TestPyPI（测试）
+python -m twine upload --repository testpypi dist/*
+
+# 发布到 PyPI（正式）
+python -m twine upload dist/*
+```
+
+## 目录结构
+
+```
+gogeo-client/
+├── pyproject.toml          # Python 包配置
+├── agentos/
+│   ├── __init__.py
+│   └── cli.py              # CLI 入口
+├── app/                    # 应用覆盖文件
+├── desktop/                # 桌面快捷方式
+├── icons/                  # 桌面图标
+├── wallpaper/              # 桌面壁纸
+└── docker-compose.yml      # 本地开发用 compose
+```

gogeo_client_agentos-0.2.2/gogeo_client_agentos.egg-info/SOURCES.txt

@@ -0,0 +1,21 @@
+README.md
+pyproject.toml
+agentos/__init__.py
+agentos/cli.py
+agentos/resources/__init__.py
+agentos/resources/app/__init__.py
+agentos/resources/app/app.asar
+agentos/resources/desktop/__init__.py
+agentos/resources/desktop/chromium.desktop
+agentos/resources/desktop/gogeoclaw.desktop
+agentos/resources/desktop/terminal.desktop
+agentos/resources/desktop/vscode.desktop
+agentos/resources/icons/@nuwax-ainuwaclaw.png
+agentos/resources/icons/__init__.py
+agentos/resources/wallpaper/__init__.py
+agentos/resources/wallpaper/gogeoDesk.jpg
+gogeo_client_agentos.egg-info/PKG-INFO
+gogeo_client_agentos.egg-info/SOURCES.txt
+gogeo_client_agentos.egg-info/dependency_links.txt
+gogeo_client_agentos.egg-info/entry_points.txt
+gogeo_client_agentos.egg-info/top_level.txt

gogeo_client_agentos-0.2.2/gogeo_client_agentos.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

gogeo_client_agentos-0.2.2/gogeo_client_agentos.egg-info/entry_points.txt

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

gogeo_client_agentos-0.2.2/gogeo_client_agentos.egg-info/top_level.txt

@@ -0,0 +1 @@
+agentos

gogeo_client_agentos-0.2.2/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "gogeo-client-agentos"
+version = "0.2.2"
+description = "AgentOS CLI tool for managing the AgentOS Client Docker container"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+authors = [
+    {name = "agentos-team", email = "agentos@example.com"},
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+
+[project.scripts]
+agentos = "agentos.cli:main"
+
+[project.urls]
+"Homepage" = "https://github.com/agentos/client"
+
+[tool.setuptools.packages.find]
+include = ["agentos*"]
+
+[tool.setuptools.package-data]
+agentos = ["resources/**/*"]

gogeo_client_agentos-0.2.2/setup.cfg

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