hw-cloudrobo-core 0.2.0__tar.gz

hw_cloudrobo_core-0.2.0/PKG-INFO

@@ -0,0 +1,28 @@
+Metadata-Version: 2.4
+Name: hw-cloudrobo-core
+Version: 0.2.0
+Summary: CloudRobo Core SDK and CLI Framework
+Author-email: Huawei Cloud CloudRobo Team <hwcloudrobo@huawei.com>
+License: Apache-2.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Requires-Dist: click>=8.0
+Requires-Dist: pyyaml>=5.0
+Requires-Dist: requests>=2.25
+Requires-Dist: rich>=10.0
+Requires-Dist: cryptography>=41.0.0
+Requires-Dist: esdk-obs-python
+Requires-Dist: hw-cloudrobo-workspace>=0.1.0
+Requires-Dist: hw-cloudrobo-resource>=0.1.0
+Provides-Extra: obs
+Requires-Dist: pycryptodome==3.10.1; extra == "obs"

hw_cloudrobo_core-0.2.0/README.md

@@ -0,0 +1,18 @@
+# cloudrobo-core
+
+核心 SDK 与 CLI 框架，提供 Config、HttpClient、BaseClient 和 CLI 插件加载机制。
+
+## 安装
+
+```bash
+pip install -e packages/cloudrobo-core
+```
+
+## 文档
+
+- [模块概览](docs/index.md)
+- [CLI 命令](docs/commands.md)
+- [使用示例](docs/examples.md)
+- [开发指南](docs/development.md)
+- [安装指南](../../docs/installation.md)
+- [架构文档](../../docs/architecture.md)

hw_cloudrobo_core-0.2.0/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["setuptools==83.0.0", "packaging==26.2", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "hw-cloudrobo-core"
+version = "0.2.0"
+description = "CloudRobo Core SDK and CLI Framework"
+requires-python = ">=3.8"
+authors = [{name = "Huawei Cloud CloudRobo Team", email = "hwcloudrobo@huawei.com"}]
+license = {text = "Apache-2.0"}
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "click>=8.0",
+    "pyyaml>=5.0",
+    "requests>=2.25",
+    "rich>=10.0",
+    "cryptography>=41.0.0",
+    "esdk-obs-python",
+    "hw-cloudrobo-workspace>=0.1.0",
+    "hw-cloudrobo-resource>=0.1.0",
+]
+
+[project.optional-dependencies]
+obs = [
+    "pycryptodome==3.10.1",
+]
+
+[project.scripts]
+cloudrobo = "cloudrobo_core.cli_main:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+cloudrobo_core = ["config.yaml"]

hw_cloudrobo_core-0.2.0/setup.cfg

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

hw_cloudrobo_core-0.2.0/src/cloudrobo_core/cli/cli_utils.py

@@ -0,0 +1,15 @@
+import json
+import os
+import click
+from cloudrobo_core.sdk import Config, HttpClient
+
+
+def get_client(ctx, client_class):
+    config_path = os.environ.get("CLOUDROBO_SERVICE_CONFIG")
+    config = Config(config_path or None)
+    http = HttpClient(config)
+    return client_class(http)
+
+
+def out(result):
+    click.echo(json.dumps(result, ensure_ascii=False, indent=2))

hw_cloudrobo_core-0.2.0/src/cloudrobo_core/cli/config_cmd.py

@@ -0,0 +1,173 @@
+#!/usr/bin/env python
+import os
+
+import click
+import yaml
+
+from cloudrobo_core.cli.config_utils import USER_CONFIG_PATH
+
+_SENSITIVE_KEYS = {"ak", "sk"}
+
+
+def _mask(value: str) -> str:
+    if len(value) > 8:
+        return value[:4] + "****" + value[-4:]
+    return "****"
+
+
+@click.group()
+def config():
+    """配置管理命令"""
+    pass
+
+
+@config.command("set")
+@click.argument("pairs", nargs=-1, required=True)
+def set_config(pairs):
+    """设置配置项（支持一次设置多个）
+
+    用法:
+      cloudrobo config set ak xxx sk yyy
+      cloudrobo config set ak xxx sk yyy region cn-southwest-2
+
+    支持的 key:
+      ak, sk, region
+
+    ak/sk 会自动加密存储（机器绑定），region 明文存储。
+    """
+    if len(pairs) % 2 != 0:
+        click.echo("参数必须是 key-value 对，例如: config set ak xxx sk yyy", err=True)
+        return
+
+    config_path = USER_CONFIG_PATH
+
+    data = {}
+    if config_path.exists():
+        with open(config_path, "r", encoding="utf-8") as f:
+            data = yaml.safe_load(f) or {}
+
+    if "cloudrobo" not in data:
+        data["cloudrobo"] = {}
+    if "auth" not in data["cloudrobo"]:
+        data["cloudrobo"]["auth"] = {}
+
+    key_map = {
+        "ak": ("cloudrobo", "auth", "ak"),
+        "sk": ("cloudrobo", "auth", "sk"),
+        "region": ("cloudrobo", "region"),
+    }
+
+    for i in range(0, len(pairs), 2):
+        key, value = pairs[i], pairs[i + 1]
+
+        if key not in key_map:
+            click.echo(f"不支持的配置项: {key}", err=True)
+            click.echo(f"支持的配置项: {', '.join(key_map.keys())}", err=True)
+            return
+
+        if key in _SENSITIVE_KEYS:
+            from cloudrobo_core.sdk.crypto import encrypt
+            enc_value = encrypt(value)
+            data["cloudrobo"]["auth"][f"{key}_enc"] = enc_value
+            data["cloudrobo"]["auth"].pop(key, None)
+            click.echo(f"已设置 {key} (加密存储)")
+        else:
+            path = key_map[key]
+            obj = data
+            for p in path[:-1]:
+                if p not in obj:
+                    obj[p] = {}
+                obj = obj[p]
+            obj[path[-1]] = value
+            click.echo(f"已设置 {key} = {value}")
+
+    config_path.parent.mkdir(parents=True, exist_ok=True)
+    with open(config_path, "w", encoding="utf-8") as f:
+        yaml.dump(data, f, allow_unicode=True, default_flow_style=False)
+    try:
+        os.chmod(config_path, 0o600)
+    except OSError:
+        pass
+
+
+@config.command("get")
+@click.argument("key")
+def get_config(key):
+    """获取配置项
+
+    支持的 key:
+      ak, sk, region
+
+    ak/sk 解密后脱敏显示（仅显示前4后4位）。
+    """
+    config_path = USER_CONFIG_PATH
+
+    if not config_path.exists():
+        click.echo(f"配置文件不存在: {config_path}", err=True)
+        return
+
+    with open(config_path, "r", encoding="utf-8") as f:
+        data = yaml.safe_load(f) or {}
+
+    cloudrobo = data.get("cloudrobo", {})
+    auth = cloudrobo.get("auth", {})
+
+    if key in _SENSITIVE_KEYS:
+        enc_field = f"{key}_enc"
+        enc_value = auth.get(enc_field)
+        if enc_value:
+            from cloudrobo_core.sdk.crypto import decrypt
+            try:
+                value = decrypt(enc_value)
+                click.echo(_mask(value))
+            except Exception:
+                click.echo("(解密失败)", err=True)
+        else:
+            plain = auth.get(key, "")
+            if plain:
+                click.echo(f"{_mask(plain)} (明文存储)")
+            else:
+                click.echo(f"{key} 未设置")
+        return
+
+    if key == "region":
+        value = cloudrobo.get("region", "")
+        click.echo(value if value else f"{key} 未设置")
+        return
+
+    click.echo(f"不支持的配置项: {key}", err=True)
+    click.echo(f"支持的配置项: ak, sk, region", err=True)
+
+
+@config.command("list")
+def list_config():
+    """列出所有配置"""
+    config_path = USER_CONFIG_PATH
+
+    if not config_path.exists():
+        click.echo(f"配置文件不存在: {config_path}", err=True)
+        return
+
+    with open(config_path, "r", encoding="utf-8") as f:
+        data = yaml.safe_load(f) or {}
+
+    cloudrobo = data.get("cloudrobo", {})
+    auth = cloudrobo.get("auth", {})
+
+    click.echo(f"配置文件: {config_path}")
+    click.echo()
+    click.echo("认证配置:")
+
+    for key in ("ak", "sk"):
+        enc_field = f"{key}_enc"
+        if auth.get(enc_field):
+            click.echo(f"  {key}: 已加密存储 ✓")
+        elif auth.get(key):
+            click.echo(f"  {key}: 明文存储 ⚠ (建议重新配置以启用加密存储)")
+        else:
+            click.echo(f"  {key}: (未设置)")
+
+    click.echo()
+    click.echo("其他配置:")
+    region = cloudrobo.get("region", "")
+    click.echo(f"  region: {region if region else '(未设置)'}")

hw_cloudrobo_core-0.2.0/src/cloudrobo_core/cli/config_utils.py

@@ -0,0 +1,81 @@
+import logging
+import os
+from importlib.resources import files
+from pathlib import Path
+from typing import Any, Dict
+
+import yaml
+
+logger = logging.getLogger(__name__)
+
+USER_CONFIG_DIR = Path.home() / ".cloudrobo"
+USER_CONFIG_PATH = USER_CONFIG_DIR / "config.yaml"
+
+_FIELDS_TO_CLEAR = [
+    ("cloudrobo", "auth", "ak"),
+    ("cloudrobo", "auth", "sk"),
+    ("cloudrobo", "proxy", "http"),
+    ("cloudrobo", "proxy", "https"),
+    ("cloudrobo", "proxy", "no_proxy"),
+    ("debug", "ca_bundle"),
+]
+
+
+def _load_project_config() -> Dict[str, Any]:
+    try:
+        config_file = files("cloudrobo_core").joinpath("config.yaml")
+        with open(str(config_file), "r", encoding="utf-8") as f:
+            return yaml.safe_load(f) or {}
+    except (FileNotFoundError, yaml.YAMLError) as e:
+        logger.debug("Failed to load project config via importlib: %s", e)
+    fallback = Path(__file__).resolve()
+    for _ in range(6):
+        fallback = fallback.parent
+        candidate = fallback / "config.yaml"
+        if candidate.exists():
+            try:
+                with open(candidate, "r", encoding="utf-8") as f:
+                    return yaml.safe_load(f) or {}
+            except (FileNotFoundError, yaml.YAMLError) as e:
+                logger.debug("Failed to load fallback config %s: %s", candidate, e)
+            continue
+    return {}
+
+
+def _generate_user_template() -> str:
+    data = _load_project_config()
+    for path in _FIELDS_TO_CLEAR:
+        node = data
+        for key in path[:-1]:
+            if isinstance(node, dict) and key in node:
+                node = node[key]
+            else:
+                node = None
+                break
+        if node is not None and isinstance(node, dict):
+            node[path[-1]] = ""
+    header = "# CloudRobo 用户配置（优先级高于工程目录 config/config.yaml）\n"
+    header += "# 在此填入你的 AK/SK，无需修改工程目录下的配置\n\n"
+    return header + yaml.dump(data, allow_unicode=True, default_flow_style=False)
+
+
+def ensure_user_config() -> Path:
+    if not USER_CONFIG_PATH.exists():
+        USER_CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+        USER_CONFIG_PATH.write_text(_generate_user_template(), encoding="utf-8")
+        try:
+            os.chmod(USER_CONFIG_PATH, 0o600)
+        except OSError:
+            pass
+        logger.info("Created user config template: %s", USER_CONFIG_PATH)
+    return USER_CONFIG_PATH
+
+
+def deep_merge(base: Dict[str, Any], override: Dict[str, Any]) -> Dict[str, Any]:
+    result = dict(base)
+    for k, v in override.items():
+        if k in result and isinstance(result[k], dict) and isinstance(v, dict):
+            result[k] = deep_merge(result[k], v)
+        else:
+            result[k] = v
+    return result

hw_cloudrobo_core-0.2.0/src/cloudrobo_core/cli/self_cmd.py

@@ -0,0 +1,113 @@
+import os
+import subprocess
+import sys
+import tempfile
+
+import click
+
+
+@click.group()
+def self():
+    """CloudRobo 自身管理命令组"""
+    pass
+
+
+@self.command("uninstall")
+@click.argument("packages", nargs=-1, required=False)
+@click.option("--yes", "-y", is_flag=True, help="跳过确认提示")
+@click.option("--all", "uninstall_all", is_flag=True, help="卸载所有 CloudRobo 包")
+def uninstall(packages, yes, uninstall_all):
+    """卸载 CloudRobo Client 安装包
+
+    不指定包名时卸载所有包。支持子包简写（如 asset, dataset）或完整包名。
+
+    示例:
+
+      cloudrobo self uninstall                   # 卸载所有包
+
+      cloudrobo self uninstall asset             # 卸载 asset 子包
+
+      cloudrobo self uninstall hw-cloudrobo-asset  # 卸载 asset 子包（完整名）
+
+      cloudrobo self uninstall asset dataset     # 卸载多个子包
+    """
+    # 获取已安装的包列表
+    result = subprocess.run(
+        [sys.executable, "-m", "pip", "list", "--format=columns"],
+        capture_output=True,
+        text=True,
+    )
+    if result.returncode != 0:
+        click.echo(f"获取安装包列表失败: {result.stderr.strip()}", err=True)
+        sys.exit(1)
+
+    # 扫描所有 cloudrobo 相关包（支持开发模式和发布模式）
+    installed_packages = []
+    for line in result.stdout.splitlines():
+        parts = line.split()
+        if parts and (
+            parts[0].startswith("cloudrobo-")
+            or parts[0].startswith("hw-cloudrobo-")
+        ):
+            installed_packages.append(parts[0])
+
+    if not installed_packages:
+        click.echo("未找到任何 CloudRobo 安装包。")
+        return
+
+    # 确定要卸载的包
+    if uninstall_all or not packages:
+        # 卸载所有包
+        to_uninstall = installed_packages
+    else:
+        # 卸载指定包（支持简写和完整名）
+        to_uninstall = []
+        for pkg in packages:
+            # 如果已经是完整包名且已安装
+            if pkg in installed_packages:
+                to_uninstall.append(pkg)
+            else:
+                # 尝试匹配简写（asset → hw-cloudrobo-asset 或 cloudrobo-asset）
+                matched = [
+                    p for p in installed_packages
+                    if p.endswith(f"-{pkg}") or p == f"hw-cloudrobo-{pkg}" or p == f"cloudrobo-{pkg}"
+                ]
+                if matched:
+                    to_uninstall.extend(matched)
+                else:
+                    click.echo(f"警告: 未找到包 '{pkg}'，跳过。")
+
+    if not to_uninstall:
+        click.echo("没有需要卸载的包。")
+        return
+
+    click.echo("即将卸载以下安装包：")
+    for pkg in to_uninstall:
+        click.echo(f"  - {pkg}")
+
+    if not yes:
+        if not click.confirm("确认卸载？"):
+            click.echo("已取消。")
+            return
+
+    # 生成卸载脚本（避免自杀问题）
+    script = "import subprocess, sys\n"
+    script += f"pkgs = {to_uninstall!r}\n"
+    script += "cmd = [sys.executable, '-m', 'pip', 'uninstall', '-y'] + pkgs\n"
+    script += "r = subprocess.run(cmd)\n"
+    script += "sys.exit(r.returncode)\n"
+
+    script_path = os.path.join(tempfile.gettempdir(), "cloudrobo_uninstall.py")
+    with open(script_path, "w", encoding="utf-8") as f:
+        f.write(script)
+
+    click.echo("卸载脚本已生成，即将退出当前进程并执行卸载...")
+    popen_kwargs = {}
+    if sys.platform == "win32":
+        popen_kwargs["creationflags"] = (
+            subprocess.DETACHED_PROCESS | subprocess.CREATE_NO_WINDOW
+        )
+    else:
+        popen_kwargs["start_new_session"] = True
+    subprocess.Popen([sys.executable, script_path], **popen_kwargs)
+    sys.exit(0)

hw_cloudrobo_core-0.2.0/src/cloudrobo_core/cli/setup_user_config.py

@@ -0,0 +1,36 @@
+import logging
+import os
+from pathlib import Path
+
+logger = logging.getLogger(__name__)
+
+USER_CLOUDROBO_DIR = Path.home() / ".cloudrobo"
+USER_CONFIG_PATH = USER_CLOUDROBO_DIR / "config.yaml"
+
+_DEFAULT_USER_CONFIG = """\
+# CloudRobo 用户配置（优先级高于工程目录 config/config.yaml）
+# 在此填入你的 AK/SK，无需修改工程目录下的配置
+
+cloudrobo:
+  auth:
+    ak: ""
+    sk: ""
+"""
+
+
+def ensure_user_config() -> Path:
+    USER_CLOUDROBO_DIR.mkdir(parents=True, exist_ok=True)
+    if not USER_CONFIG_PATH.exists():
+        USER_CONFIG_PATH.write_text(_DEFAULT_USER_CONFIG, encoding="utf-8")
+        logger.info("Created user config: %s", USER_CONFIG_PATH)
+    return USER_CONFIG_PATH
+
+
+def _post_install():
+    ensure_user_config()
+    secrets_dir = USER_CLOUDROBO_DIR / "conversations"
+    secrets_dir.mkdir(parents=True, exist_ok=True)
+
+
+if __name__ == "__main__":
+    _post_install()

hw_cloudrobo_core-0.2.0/src/cloudrobo_core/cli/skill_cmd.py

@@ -0,0 +1,137 @@
+import os
+import shutil
+from pathlib import Path
+
+import click
+
+from .skill_loader import _parse_frontmatter
+
+
+TARGET_MAP = {
+    "claude-code": "~/.claude/skills",
+    "claude-code-project": ".claude/skills",
+    "jiuwenswarm": "~/.jiuwenswarm/agent/workspace/skills",
+}
+
+
+def _resolve_target(target: str) -> Path:
+    if target.startswith("path:"):
+        return Path(target[5:]).expanduser().resolve()
+
+    if target not in TARGET_MAP:
+        click.echo(f"Unknown target: {target}", err=True)
+        click.echo(f"Supported targets: {', '.join(TARGET_MAP.keys())}, path:/custom/dir", err=True)
+        return None
+
+    if target == "jiuwenswarm":
+        data_dir = os.environ.get("JIUWENSWARM_DATA_DIR")
+        if data_dir:
+            return Path(data_dir) / "agent" / "workspace" / "skills"
+
+    return Path(TARGET_MAP[target]).expanduser().resolve()
+
+
+def _list_skills_from(skills_root: Path) -> list:
+    skills = []
+    for skill_dir in sorted(skills_root.iterdir()):
+        if not skill_dir.is_dir():
+            continue
+        skill_md = skill_dir / "SKILL.md"
+        if not skill_md.exists():
+            continue
+        meta = _parse_frontmatter(skill_md)
+        skills.append({
+            "name": meta.get("name", skill_dir.name),
+            "description": meta.get("description", ""),
+            "dir": str(skill_dir),
+        })
+    return skills
+
+
+@click.group(name="skill")
+def skill():
+    """Skill management commands"""
+    pass
+
+
+@skill.command("install")
+@click.option("--target", required=True,
+              help="Target platform (claude-code, claude-code-project, jiuwenswarm) or custom path (path:/dir)")
+@click.option("--source", required=True,
+              help="Skill source directory")
+@click.option("--skill-name", default=None,
+              help="Specific skills to install (comma-separated). Default: all skills")
+def install(target, source, skill_name):
+    """Install skills to agent platform directories"""
+    target_dir = _resolve_target(target)
+    if target_dir is None:
+        return
+
+    target_dir = Path(target_dir).expanduser().resolve()
+    target_dir.mkdir(parents=True, exist_ok=True)
+
+    skills_root = Path(source).expanduser().resolve()
+    if not skills_root.exists():
+        click.echo(f"Source directory not found: {skills_root}", err=True)
+        return
+    skills = _list_skills_from(skills_root)
+
+    if skill_name:
+        skill_names = [n.strip() for n in skill_name.split(",") if n.strip()]
+        skills = [s for s in skills if s["name"] in skill_names]
+        missing = set(skill_names) - {s["name"] for s in skills}
+        if missing:
+            click.echo(f"Skills not found: {', '.join(missing)}", err=True)
+
+    if not skills:
+        click.echo("No matching skills to install.")
+        return
+
+    installed = []
+    for s in skills:
+        src = Path(s["dir"])
+        dst = target_dir / src.name
+        if dst.exists():
+            shutil.rmtree(dst)
+        shutil.copytree(src, dst)
+        installed.append(s["name"])
+
+    click.echo(f"Installed {len(installed)} skill(s) to {target_dir}:")
+    for name in installed:
+        click.echo(f"  {name}")
+
+
+@skill.command("uninstall")
+@click.option("--target", required=True,
+              help="Target platform (claude-code, claude-code-project, jiuwenswarm) or custom path (path:/dir)")
+@click.option("--skill-name", default=None,
+              help="Specific skills to uninstall (comma-separated). Default: all skills")
+def uninstall(target, skill_name):
+    """Uninstall skills from agent platform directories"""
+    target_dir = _resolve_target(target)
+    if target_dir is None:
+        return
+
+    target_dir = Path(target_dir).expanduser().resolve()
+    if not target_dir.exists():
+        click.echo(f"Target directory does not exist: {target_dir}")
+        return
+
+    if skill_name:
+        skills_to_remove = [n.strip() for n in skill_name.split(",") if n.strip()]
+    else:
+        skills_to_remove = [d.name for d in target_dir.iterdir() if d.is_dir()]
+
+    removed = []
+    for name in skills_to_remove:
+        skill_path = target_dir / name
+        if skill_path.exists():
+            shutil.rmtree(skill_path)
+            removed.append(name)
+
+    if removed:
+        click.echo(f"Uninstalled {len(removed)} skill(s) from {target_dir}:")
+        for name in removed:
+            click.echo(f"  {name}")
+    else:
+        click.echo("No skills to uninstall.")

hw_cloudrobo_core-0.2.0/src/cloudrobo_core/cli/skill_loader.py

@@ -0,0 +1,17 @@
+"""Skill loader: SKILL.md frontmatter parsing."""
+import re
+from pathlib import Path
+from typing import Dict
+
+import yaml
+
+
+def _parse_frontmatter(path: Path) -> Dict:
+    text = path.read_text(encoding="utf-8")
+    m = re.match(r"^---[ \t]*\r?\n(.*?)\r?\n---", text, re.DOTALL)
+    if not m:
+        return {}
+    try:
+        return yaml.safe_load(m.group(1)) or {}
+    except yaml.YAMLError:
+        return {}