@mongoui/skills 0.1.7 → 0.1.9

package/skills/glink-hotel-api/scripts/glink_signed_request.py

@@ -1,188 +1,199 @@
-#!/usr/bin/env python3
-"""Generate or send signed requests for the Glink open-platform gateway.
-
-Examples:
-  python scripts/glink_signed_request.py ^
-    --method POST ^
-    --path /openapi/v1/glink/queryBusinessList ^
-    --body-json "{\"language\":\"zh-CN\",\"cityCode\":\"1\"}" ^
-    --app-key open_app_xxx ^
-    --app-secret sk_xxx
-
-  python scripts/glink_signed_request.py ^
-    --method POST ^
-    --path /openapi/v1/glink/queryCreditBalance ^
-    --body-json "{}" ^
-    --app-key open_app_xxx ^
-    --app-secret sk_xxx ^
-    --send
-"""
-
-from __future__ import annotations
-
-import argparse
-import hashlib
-import hmac
-import json
-import os
-import sys
-import time
-import urllib.parse
-import urllib.request
-import uuid
-from pathlib import Path
-
-
-def sha256_hex(data: bytes) -> str:
-    return hashlib.sha256(data).hexdigest()
-
-
-def parse_query_items(items: list[str]) -> list[tuple[str, str]]:
-    pairs: list[tuple[str, str]] = []
-    for item in items:
-        if "=" not in item:
-            raise ValueError(f"invalid query item: {item!r}; expected key=value")
-        key, value = item.split("=", 1)
-        pairs.append((key, value))
-    return pairs
-
-
-def canonical_query(pairs: list[tuple[str, str]]) -> str:
-    ordered = sorted(pairs, key=lambda item: (item[0], item[1]))
-    return "&".join(
-        f"{urllib.parse.quote(key, safe='~-._')}={urllib.parse.quote(value, safe='~-._')}"
-        for key, value in ordered
-    )
-
-
-def build_sign_payload(
-    method: str,
-    path: str,
-    query_string: str,
-    body_bytes: bytes,
-    timestamp: str,
-    nonce: str,
-    app_key: str,
-) -> str:
-    return "\n".join(
-        [
-            method.upper(),
-            path,
-            query_string,
-            sha256_hex(body_bytes),
-            timestamp,
-            nonce,
-            app_key,
-        ]
-    )
-
-
-def sign(secret: str, payload: str) -> str:
-    return hmac.new(secret.encode("utf-8"), payload.encode("utf-8"), hashlib.sha256).hexdigest()
-
-
-def load_body(args: argparse.Namespace) -> bytes:
-    if args.body_file:
-        return Path(args.body_file).read_bytes()
-    if args.body_json is None:
-        return b""
-    parsed = json.loads(args.body_json)
-    return json.dumps(parsed, ensure_ascii=False, separators=(",", ":")).encode("utf-8")
-
-
-def build_url(base_url: str, path: str, query_string: str) -> str:
-    base = base_url.rstrip("/")
-    url = f"{base}{path}"
-    if query_string:
-        url = f"{url}?{query_string}"
-    return url
-
-
-def build_headers(app_key: str, timestamp: str, nonce: str, signature: str, has_body: bool) -> dict[str, str]:
-    headers = {
-        "Accept": "application/json",
-        "X-OP-App-Key": app_key,
-        "X-OP-Timestamp": timestamp,
-        "X-OP-Nonce": nonce,
-        "X-OP-Sign": signature,
-    }
-    if has_body:
-        headers["Content-Type"] = "application/json"
-    return headers
-
-
-def send_request(method: str, url: str, headers: dict[str, str], body_bytes: bytes, timeout: float) -> tuple[int, str]:
-    request = urllib.request.Request(url=url, data=body_bytes or None, headers=headers, method=method.upper())
-    try:
-        with urllib.request.urlopen(request, timeout=timeout) as response:
-            return response.status, response.read().decode("utf-8", errors="replace")
-    except urllib.error.HTTPError as exc:
-        return exc.code, exc.read().decode("utf-8", errors="replace")
-
-
-def main() -> int:
-    parser = argparse.ArgumentParser(description="Generate or send a signed Glink open-platform request.")
-    parser.add_argument("--base-url", default=os.getenv("OPEN_PLATFORM_BASE_URL", "http://127.0.0.1:8671"))
-    parser.add_argument("--method", required=True)
-    parser.add_argument("--path", required=True)
-    parser.add_argument("--query", action="append", default=[], help="Repeatable key=value query parameter")
-    parser.add_argument("--body-json", help="JSON string request body")
-    parser.add_argument("--body-file", help="Path to a raw request body file")
-    parser.add_argument("--app-key", default=os.getenv("OPEN_PLATFORM_APP_KEY") or os.getenv("OPEN_PLATFORM_OPEN_APP_ID"))
-    parser.add_argument("--app-secret", default=os.getenv("OPEN_PLATFORM_APP_SECRET") or os.getenv("OPEN_PLATFORM_OPEN_SECRET"))
-    parser.add_argument("--timestamp", default=str(int(time.time())))
-    parser.add_argument("--nonce", default=uuid.uuid4().hex)
-    parser.add_argument("--send", action="store_true")
-    parser.add_argument("--timeout", type=float, default=15.0)
-    args = parser.parse_args()
-
-    if not args.app_key or not args.app_secret:
-        print("app key and app secret are required", file=sys.stderr)
-        return 2
-
-    try:
-        query_pairs = parse_query_items(args.query)
-        body_bytes = load_body(args)
-    except Exception as exc:
-        print(str(exc), file=sys.stderr)
-        return 2
-
-    query_string = canonical_query(query_pairs)
-    payload = build_sign_payload(
-        method=args.method,
-        path=args.path,
-        query_string=query_string,
-        body_bytes=body_bytes,
-        timestamp=args.timestamp,
-        nonce=args.nonce,
-        app_key=args.app_key,
-    )
-    signature = sign(args.app_secret, payload)
-    headers = build_headers(args.app_key, args.timestamp, args.nonce, signature, bool(body_bytes))
-    url = build_url(args.base_url, args.path, query_string)
-
-    print("URL:")
-    print(url)
-    print()
-    print("Canonical String:")
-    print(payload)
-    print()
-    print("Headers:")
-    print(json.dumps(headers, ensure_ascii=False, indent=2))
-    if body_bytes:
-        print()
-        print("Body:")
-        print(body_bytes.decode("utf-8", errors="replace"))
-
-    if not args.send:
-        return 0
-
-    status, response_text = send_request(args.method, url, headers, body_bytes, args.timeout)
-    print()
-    print(f"HTTP {status}")
-    print(response_text)
-    return 0
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())
+#!/usr/bin/env python3
+"""Generate or send signed requests for the Glink open-platform gateway.
+
+Examples:
+  python scripts/glink_signed_request.py ^
+    --method POST ^
+    --path /region/businesses ^
+    --body-json "{\"language\":\"zh-CN\",\"cityCode\":\"1\"}" ^
+    --app-key open_app_xxx ^
+    --app-secret sk_xxx
+
+  python scripts/glink_signed_request.py ^
+    --method POST ^
+    --path /search/creditBalance ^
+    --body-json "{}" ^
+    --app-key open_app_xxx ^
+    --app-secret sk_xxx ^
+    --send
+"""
+
+from __future__ import annotations
+
+import argparse
+import hashlib
+import hmac
+import json
+import os
+import sys
+import time
+import urllib.parse
+import urllib.request
+import uuid
+from pathlib import Path
+
+GATEWAY_PREFIX = "/openapi/v1/glink"
+
+
+def sha256_hex(data: bytes) -> str:
+    return hashlib.sha256(data).hexdigest()
+
+
+def normalize_path(path: str) -> str:
+    if not path.startswith("/"):
+        path = f"/{path}"
+    if path == GATEWAY_PREFIX or path.startswith(f"{GATEWAY_PREFIX}/"):
+        return path
+    return f"{GATEWAY_PREFIX}{path}"
+
+
+def parse_query_items(items: list[str]) -> list[tuple[str, str]]:
+    pairs: list[tuple[str, str]] = []
+    for item in items:
+        if "=" not in item:
+            raise ValueError(f"invalid query item: {item!r}; expected key=value")
+        key, value = item.split("=", 1)
+        pairs.append((key, value))
+    return pairs
+
+
+def canonical_query(pairs: list[tuple[str, str]]) -> str:
+    ordered = sorted(pairs, key=lambda item: (item[0], item[1]))
+    return "&".join(
+        f"{urllib.parse.quote(key, safe='~-._')}={urllib.parse.quote(value, safe='~-._')}"
+        for key, value in ordered
+    )
+
+
+def build_sign_payload(
+    method: str,
+    path: str,
+    query_string: str,
+    body_bytes: bytes,
+    timestamp: str,
+    nonce: str,
+    app_key: str,
+) -> str:
+    return "\n".join(
+        [
+            method.upper(),
+            path,
+            query_string,
+            sha256_hex(body_bytes),
+            timestamp,
+            nonce,
+            app_key,
+        ]
+    )
+
+
+def sign(secret: str, payload: str) -> str:
+    return hmac.new(secret.encode("utf-8"), payload.encode("utf-8"), hashlib.sha256).hexdigest()
+
+
+def load_body(args: argparse.Namespace) -> bytes:
+    if args.body_file:
+        return Path(args.body_file).read_bytes()
+    if args.body_json is None:
+        return b""
+    parsed = json.loads(args.body_json)
+    return json.dumps(parsed, ensure_ascii=False, separators=(",", ":")).encode("utf-8")
+
+
+def build_url(base_url: str, path: str, query_string: str) -> str:
+    base = base_url.rstrip("/")
+    url = f"{base}{path}"
+    if query_string:
+        url = f"{url}?{query_string}"
+    return url
+
+
+def build_headers(app_key: str, timestamp: str, nonce: str, signature: str, has_body: bool) -> dict[str, str]:
+    headers = {
+        "Accept": "application/json",
+        "X-OP-App-Key": app_key,
+        "X-OP-Timestamp": timestamp,
+        "X-OP-Nonce": nonce,
+        "X-OP-Sign": signature,
+    }
+    if has_body:
+        headers["Content-Type"] = "application/json"
+    return headers
+
+
+def send_request(method: str, url: str, headers: dict[str, str], body_bytes: bytes, timeout: float) -> tuple[int, str]:
+    request = urllib.request.Request(url=url, data=body_bytes or None, headers=headers, method=method.upper())
+    try:
+        with urllib.request.urlopen(request, timeout=timeout) as response:
+            return response.status, response.read().decode("utf-8", errors="replace")
+    except urllib.error.HTTPError as exc:
+        return exc.code, exc.read().decode("utf-8", errors="replace")
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="Generate or send a signed Glink open-platform request.")
+    parser.add_argument("--base-url", default=os.getenv("OPEN_PLATFORM_BASE_URL", "http://127.0.0.1:8671"))
+    parser.add_argument("--method", required=True)
+    parser.add_argument("--path", required=True, help="Short interface path, such as /search/destination; full gateway paths are also accepted")
+    parser.add_argument("--query", action="append", default=[], help="Repeatable key=value query parameter")
+    parser.add_argument("--body-json", help="JSON string request body")
+    parser.add_argument("--body-file", help="Path to a raw request body file")
+    parser.add_argument("--app-key", default=os.getenv("OPEN_PLATFORM_APP_KEY") or os.getenv("OPEN_PLATFORM_OPEN_APP_ID"))
+    parser.add_argument("--app-secret", default=os.getenv("OPEN_PLATFORM_APP_SECRET") or os.getenv("OPEN_PLATFORM_OPEN_SECRET"))
+    parser.add_argument("--timestamp", default=str(int(time.time())))
+    parser.add_argument("--nonce", default=uuid.uuid4().hex)
+    parser.add_argument("--send", action="store_true")
+    parser.add_argument("--timeout", type=float, default=15.0)
+    args = parser.parse_args()
+
+    if not args.app_key or not args.app_secret:
+        print("app key and app secret are required", file=sys.stderr)
+        return 2
+
+    try:
+        query_pairs = parse_query_items(args.query)
+        body_bytes = load_body(args)
+        runtime_path = normalize_path(args.path)
+    except Exception as exc:
+        print(str(exc), file=sys.stderr)
+        return 2
+
+    query_string = canonical_query(query_pairs)
+    payload = build_sign_payload(
+        method=args.method,
+        path=runtime_path,
+        query_string=query_string,
+        body_bytes=body_bytes,
+        timestamp=args.timestamp,
+        nonce=args.nonce,
+        app_key=args.app_key,
+    )
+    signature = sign(args.app_secret, payload)
+    headers = build_headers(args.app_key, args.timestamp, args.nonce, signature, bool(body_bytes))
+    url = build_url(args.base_url, runtime_path, query_string)
+
+    print("URL:")
+    print(url)
+    print()
+    print("Canonical String:")
+    print(payload)
+    print()
+    print("Headers:")
+    print(json.dumps(headers, ensure_ascii=False, indent=2))
+    if body_bytes:
+        print()
+        print("Body:")
+        print(body_bytes.decode("utf-8", errors="replace"))
+
+    if not args.send:
+        return 0
+
+    status, response_text = send_request(args.method, url, headers, body_bytes, args.timeout)
+    print()
+    print(f"HTTP {status}")
+    print(response_text)
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/skills/tmc-whitelabel/SKILL.md

@@ -1,8 +1,8 @@
----
-name: tmc-whitelabel
-description: Placeholder skill for TMC Whitelabel.
----
-
-# TMC Whitelabel
-
-内容待补充。
+---
+name: tmc-whitelabel
+description: Placeholder skill for TMC Whitelabel.
+---
+
+# TMC Whitelabel
+
+内容待补充。