Chanjing Avatar

# 合规：根目录 合规规则.md §1–§2
name: chanjing-avatar
version: 0.1.0
vendor: chanjing
runtime:
  interpreter: python3
  dependencies: []
env:
  required: []
  optional:
    - CHANJING_OPENAPI_CREDENTIALS_DIR
    - CHANJING_OPENAPI_BASE_URL
permissions:
  network_mode: allowlist
  allowed_hosts:
    - open-api.chanjing.cc
    - www.chanjing.cc
  filesystem:
    read_roots:
      - "${WORKSPACE_ROOT}"
      - "${SKILL_DIR}"
      - "${CHANJING_OPENAPI_CREDENTIALS_DIR}"
    write_roots:
      - "${WORKSPACE_ROOT}"
      - "${CHANJING_OPENAPI_CREDENTIALS_DIR}"
  allowed_commands:
    - python3

schemaVersion: 1
skill:
  id: chanjing-avatar
  author: chan-skills
  category: 媒体处理
  tags:
    - Avatar
    - 对口型
    - 数字人
    - ChanjingAPI
    - 蝉镜
  summary: >-
    Chanjing Avatar API：上传音视频、创建对口型任务、轮询与获取结果。
  skillDoc: SKILL.md

environment:
  variables:
    - name: CHANJING_OPENAPI_CREDENTIALS_DIR
      required: false
      description: 存放 credentials.json 的目录（兼容 CHANJING_CONFIG_DIR），默认 ~/.chanjing
    - name: CHANJING_OPENAPI_BASE_URL
      required: false
      description: Open API 基址（兼容 CHANJING_API_BASE），默认 https://open-api.chanjing.cc

credentials:
  model: credentials_json
  defaultPath: "~/.chanjing/credentials.json"
  directoryEnv: CHANJING_OPENAPI_CREDENTIALS_DIR
  fileName: credentials.json
  sensitiveFields:
    - app_id
    - secret_key
    - access_token
    - expire_in
  persistAccessTokenOnDisk: true
  primaryEnvIntentionallyOmitted: true
  doNotCommitToVcs:
    - credentials.json

clientPermissions:
  network:
    httpsOutbound: true
    documentedHosts:
      - open-api.chanjing.cc
  filesystem:
    read:
      - "${CHANJING_OPENAPI_CREDENTIALS_DIR or CHANJING_CONFIG_DIR or ~/.chanjing}/credentials.json"
      - user_provided_media_paths
    write:
      - "${CHANJING_OPENAPI_CREDENTIALS_DIR or CHANJING_CONFIG_DIR or ~/.chanjing}/credentials.json"
  browser:
    mayOpenForAuth: true
    documentedHosts:
      - www.chanjing.cc
  subprocess:
    allowedPatterns:
      - python3
  userContent:
    mayDownloadFromApiResponseUrls: true

metadata:
  openclaw:
    homepage: https://doc.chanjing.cc

agentPolicy:
  alwaysSkill: false
  modifiesOtherSkillsOrGlobalAgent: false

# 鉴权：与 chanjing-credentials-guard 使用同一配置文件（CONFIG_DIR/credentials.json）
# 无 AK/SK 时执行 open_login_page.py 打开注册/登录页
import json
import os
import subprocess
import sys
import time
import urllib.request
from pathlib import Path

_DEFAULT_OPENAPI_BASE = "https://open-api.chanjing.cc"


def credentials_config_dir() -> Path:
    raw = os.environ.get("CHANJING_OPENAPI_CREDENTIALS_DIR") or os.environ.get("CHANJING_CONFIG_DIR")
    return Path(raw).expanduser() if raw else Path.home() / ".chanjing"


def openapi_base_url() -> str:
    return (
        os.environ.get("CHANJING_OPENAPI_BASE_URL")
        or os.environ.get("CHANJING_API_BASE")
        or _DEFAULT_OPENAPI_BASE
    ).rstrip("/")


CONFIG_DIR = credentials_config_dir()
CONFIG_FILE = CONFIG_DIR / "credentials.json"
API_BASE = openapi_base_url()
BUFFER_SECONDS = 300
LOGIN_URL = "https://www.chanjing.cc/openapi/login"

NO_CREDENTIALS_MSG = """已在浏览器打开蝉镜登录/注册页。
获取秘钥后请执行：
  python skills/chanjing-credentials-guard/scripts/chanjing_config.py --ak <你的app_id> --sk <你的secret_key>
设置完毕后请重新执行您之前的操作。"""


def _run_open_login_page():
    """执行 credentials-guard 的 open_login_page.py，在默认浏览器打开注册/登录页。"""
    try:
        skills_dir = Path(__file__).resolve().parent.parent.parent
        script = skills_dir / "chanjing-credentials-guard" / "scripts" / "open_login_page.py"
        if script.exists():
            subprocess.run([sys.executable, str(script)], check=False, timeout=5)
        else:
            import webbrowser
            webbrowser.open(LOGIN_URL)
    except Exception:
        try:
            import webbrowser
            webbrowser.open(LOGIN_URL)
        except Exception:
            pass


def read_config():
    if CONFIG_FILE.exists():
        with open(CONFIG_FILE, "r", encoding="utf-8") as f:
            return json.load(f)
    return {}


def write_config(data):
    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
    with open(CONFIG_FILE, "w", encoding="utf-8") as f:
        json.dump(data, f, indent=2, ensure_ascii=False)


def get_token():
    """返回 (token, None) 或 (None, error_msg)。"""
    data = read_config()
    app_id = (data.get("app_id") or "").strip()
    secret_key = (data.get("secret_key") or "").strip()
    if not app_id or not secret_key:
        _run_open_login_page()
        return None, NO_CREDENTIALS_MSG

    now = int(time.time())
    token = data.get("access_token")
    expire_in = data.get("expire_in")
    try:
        expire_in = int(expire_in) if expire_in is not None else 0
    except (ValueError, TypeError):
        expire_in = 0

    if token and expire_in > now + BUFFER_SECONDS:
        return token, None

    url = API_BASE + "/open/v1/access_token"
    req = urllib.request.Request(
        url,
        data=json.dumps({"app_id": app_id, "secret_key": secret_key}).encode("utf-8"),
        headers={"Content-Type": "application/json"},
        method="POST",
    )
    try:
        with urllib.request.urlopen(req, timeout=30) as resp:
            body = json.loads(resp.read().decode("utf-8"))
    except Exception as e:
        return None, str(e)

    if body.get("code") != 0:
        return None, body.get("msg", "获取 Token 失败")

    d = body.get("data", {})
    new_token = d.get("access_token")
    if not new_token:
        return None, "API 返回无 access_token"

    data["access_token"] = new_token
    data["expire_in"] = d.get("expire_in")
    write_config(data)
    return new_token, None

#!/usr/bin/env python3
"""
创建对口型视频任务。与 chanjing-credentials-guard 使用同一配置文件获取 Token。
用法:
  TTS 驱动: create_task --video-file-id <id> --text "台词" --audio-man-id <声音id> [--width 1080] [--height 1920]
  音频驱动: create_task --video-file-id <id> --audio-file-id <id> [--width 1080] [--height 1920]
输出: 视频任务 id（一行）或错误到 stderr
"""
import argparse
import json
import sys
import urllib.request
from pathlib import Path

sys.path.insert(0, str(Path(__file__).resolve().parent))
from _auth import get_token

API_BASE = (__import__("os").environ.get("CHANJING_OPENAPI_BASE_URL") or __import__("os").environ.get("CHANJING_API_BASE") or "https://open-api.chanjing.cc").rstrip("/")


def main():
    parser = argparse.ArgumentParser(description="创建对口型视频任务")
    parser.add_argument("--video-file-id", required=True, help="视频 file_id（来自 upload_file）")
    parser.add_argument("--text", help="TTS 文本（audio_type=tts 时必填）")
    parser.add_argument("--audio-man-id", help="声音 ID（TTS 时必填）")
    parser.add_argument("--audio-file-id", help="音频 file_id（audio_type=audio 时必填）")
    parser.add_argument("--width", type=int, default=1080, help="screen_width，默认 1080")
    parser.add_argument("--height", type=int, default=1920, help="screen_height，默认 1920")
    parser.add_argument("--callback", help="任务完成回调 URL")
    parser.add_argument("--model", type=int, default=0, help="0-基础 1-高清，默认 0")
    parser.add_argument("--speed", type=float, default=1, help="TTS 语速，默认 1")
    parser.add_argument("--pitch", type=float, default=1, help="TTS 语调，默认 1")
    args = parser.parse_args()

    if args.audio_file_id:
        body = {
            "video_file_id": args.video_file_id,
            "screen_width": args.width,
            "screen_height": args.height,
            "model": args.model,
            "audio_type": "audio",
            "audio_file_id": args.audio_file_id,
        }
    elif args.text and args.audio_man_id:
        body = {
            "video_file_id": args.video_file_id,
            "screen_width": args.width,
            "screen_height": args.height,
            "model": args.model,
            "audio_type": "tts",
            "tts_config": {
                "text": [args.text],
                "audio_man_id": args.audio_man_id,
                "speed": args.speed,
                "pitch": args.pitch,
            },
        }
    else:
        print("请指定 --text + --audio-man-id（TTS）或 --audio-file-id（音频驱动）", file=sys.stderr)
        sys.exit(1)

    if args.callback:
        body["callback"] = args.callback

    token, err = get_token()
    if err:
        print(err, file=sys.stderr)
        sys.exit(1)

    url = f"{API_BASE}/open/v1/video_lip_sync/create"
    req = urllib.request.Request(
        url,
        data=json.dumps(body).encode("utf-8"),
        headers={"access_token": token, "Content-Type": "application/json"},
        method="POST",
    )
    with urllib.request.urlopen(req, timeout=30) as resp:
        res = json.loads(resp.read().decode("utf-8"))

    if res.get("code") != 0:
        print(res.get("msg", res), file=sys.stderr)
        sys.exit(1)

    video_id = res.get("data")
    if not video_id:
        print("响应无 data", file=sys.stderr)
        sys.exit(1)
    print(video_id)


if __name__ == "__main__":
    main()

#!/usr/bin/env python3
"""
获取上传链接。与 chanjing-credentials-guard 使用同一配置文件获取 Token。
用法: get_upload_url.py --service lip_sync_video --name 1.mp4
输出: JSON { "sign_url", "mime_type", "file_id" } 或错误到 stderr
"""
import argparse
import json
import sys
import urllib.parse
import urllib.request
from pathlib import Path

# 同目录 _auth
sys.path.insert(0, str(Path(__file__).resolve().parent))
from _auth import get_token

API_BASE = (__import__("os").environ.get("CHANJING_OPENAPI_BASE_URL") or __import__("os").environ.get("CHANJING_API_BASE") or "https://open-api.chanjing.cc").rstrip("/")


def main():
    parser = argparse.ArgumentParser(description="获取蝉镜文件上传链接")
    parser.add_argument("--service", required=True, help="lip_sync_video 或 lip_sync_audio")
    parser.add_argument("--name", required=True, help="文件名，如 1.mp4")
    args = parser.parse_args()

    token, err = get_token()
    if err:
        print(err, file=sys.stderr)
        sys.exit(1)

    qs = urllib.parse.urlencode({"service": args.service, "name": args.name})
    url = f"{API_BASE}/open/v1/common/create_upload_url?{qs}"
    req = urllib.request.Request(url, headers={"access_token": token}, method="GET")
    with urllib.request.urlopen(req, timeout=30) as resp:
        body = json.loads(resp.read().decode("utf-8"))

    if body.get("code") != 0:
        print(body.get("msg", body), file=sys.stderr)
        sys.exit(1)

    data = body.get("data", {})
    print(json.dumps(data, ensure_ascii=False))


if __name__ == "__main__":
    main()

#!/usr/bin/env python3
"""
轮询对口型视频任务状态，直到完成或失败。与 chanjing-credentials-guard 使用同一配置文件获取 Token。
用法: poll_task.py --id <视频任务id> [--interval 10]
输出: 成功时打印 video_url（一行），失败时打印错误到 stderr 并 exit 1
状态: 0-待处理 10-生成中 20-成功 30-失败
"""
import argparse
import json
import sys
import time
import urllib.parse
import urllib.request
from pathlib import Path

sys.path.insert(0, str(Path(__file__).resolve().parent))
from _auth import get_token

API_BASE = (__import__("os").environ.get("CHANJING_OPENAPI_BASE_URL") or __import__("os").environ.get("CHANJING_API_BASE") or "https://open-api.chanjing.cc").rstrip("/")


def main():
    parser = argparse.ArgumentParser(description="轮询对口型视频任务直到完成")
    parser.add_argument("--id", required=True, help="视频任务 ID（来自 create_task）")
    parser.add_argument("--interval", type=int, default=10, help="轮询间隔秒数，默认 10")
    args = parser.parse_args()

    token, err = get_token()
    if err:
        print(err, file=sys.stderr)
        sys.exit(1)

    url = f"{API_BASE}/open/v1/video_lip_sync/detail?id={urllib.parse.quote(args.id)}"

    while True:
        req = urllib.request.Request(url, headers={"access_token": token}, method="GET")
        with urllib.request.urlopen(req, timeout=30) as resp:
            body = json.loads(resp.read().decode("utf-8"))

        if body.get("code") != 0:
            print(body.get("msg", body), file=sys.stderr)
            sys.exit(1)

        data = body.get("data", {})
        status = data.get("status")
        progress = data.get("progress", 0)

        if status == 20:
            video_url = data.get("video_url")
            if video_url:
                print(video_url)
                return 0
            print("任务成功但无 video_url", file=sys.stderr)
            sys.exit(1)

        if status == 30:
            print(f"任务失败: {data.get('msg', 'unknown')}", file=sys.stderr)
            sys.exit(1)

        # 0 或 10：继续轮询
        time.sleep(args.interval)


if __name__ == "__main__":
    main()

#!/usr/bin/env python3
"""
获取上传链接、PUT 本地文件，并轮询文件详情接口直到上传成功，最后输出 file_id。
与 chanjing-credentials-guard 使用同一配置文件获取 Token。
用法: upload_file.py --service lip_sync_video --file /path/to/video.mp4 [--poll-interval 5]
输出: file_id（一行）或错误到 stderr
"""
import argparse
import json
import sys
import time
import urllib.parse
import urllib.request
from pathlib import Path

sys.path.insert(0, str(Path(__file__).resolve().parent))
from _auth import get_token

API_BASE = (__import__("os").environ.get("CHANJING_OPENAPI_BASE_URL") or __import__("os").environ.get("CHANJING_API_BASE") or "https://open-api.chanjing.cc").rstrip("/")
# 官方文件管理文档里 1 表示文件可用；保留 2 以兼容历史状态定义。
FILE_READY_STATUSES = {1, 2}
POLL_INTERVAL_DEFAULT = 5
POLL_TIMEOUT_DEFAULT = 300


def get_file_detail(token, file_id):
    """GET /open/v1/common/file_detail?id=file_id, return (data_dict, None) or (None, error_msg)."""
    url = f"{API_BASE}/open/v1/common/file_detail?id={urllib.parse.quote(file_id)}"
    req = urllib.request.Request(url, headers={"access_token": token}, method="GET")
    with urllib.request.urlopen(req, timeout=30) as resp:
        body = json.loads(resp.read().decode("utf-8"))
    if body.get("code") != 0:
        return None, body.get("msg", "file_detail failed")
    return body.get("data"), None


def poll_file_ready(token, file_id, interval=5, timeout=300):
    """Poll file_detail until the uploaded file is ready to use."""
    deadline = time.monotonic() + timeout
    while time.monotonic() < deadline:
        data, err = get_file_detail(token, file_id)
        if err:
            return False, err
        if data is None:
            return False, "no data"
        status = data.get("status")
        if status in FILE_READY_STATUSES:
            return True, None
        if status not in (0, None):
            return False, data.get("msg") or f"file status={status}"
        time.sleep(interval)
    return False, "poll timeout"


def main():
    parser = argparse.ArgumentParser(description="上传文件并轮询直到就绪，返回 file_id")
    parser.add_argument("--service", required=True, help="lip_sync_video 或 lip_sync_audio")
    parser.add_argument("--file", required=True, help="本地文件路径")
    parser.add_argument("--poll-interval", type=int, default=POLL_INTERVAL_DEFAULT, help="轮询 file_detail 间隔秒数")
    parser.add_argument("--poll-timeout", type=int, default=POLL_TIMEOUT_DEFAULT, help="轮询超时秒数")
    args = parser.parse_args()

    path = Path(args.file)
    if not path.is_file():
        print(f"文件不存在: {path}", file=sys.stderr)
        sys.exit(1)

    token, err = get_token()
    if err:
        print(err, file=sys.stderr)
        sys.exit(1)

    qs = urllib.parse.urlencode({"service": args.service, "name": path.name})
    url = f"{API_BASE}/open/v1/common/create_upload_url?{qs}"
    req = urllib.request.Request(url, headers={"access_token": token}, method="GET")
    with urllib.request.urlopen(req, timeout=30) as resp:
        body = json.loads(resp.read().decode("utf-8"))

    if body.get("code") != 0:
        print(body.get("msg", body), file=sys.stderr)
        sys.exit(1)

    data = body.get("data", {})
    sign_url = data.get("sign_url")
    mime_type = data.get("mime_type", "application/octet-stream")
    file_id = data.get("file_id")

    if not sign_url or not file_id:
        print("响应缺少 sign_url 或 file_id", file=sys.stderr)
        sys.exit(1)

    # PUT 上传
    with open(path, "rb") as f:
        content = f.read()
    put_req = urllib.request.Request(
        sign_url,
        data=content,
        headers={"Content-Type": mime_type},
        method="PUT",
    )
    try:
        with urllib.request.urlopen(put_req, timeout=120) as put_resp:
            if put_resp.status not in (200, 204):
                print(f"上传返回状态: {put_resp.status}", file=sys.stderr)
                sys.exit(1)
    except Exception as e:
        print(f"上传失败: {e}", file=sys.stderr)
        sys.exit(1)

    # Poll file_detail until file is ready (status success)
    ready, err = poll_file_ready(token, file_id, interval=args.poll_interval, timeout=args.poll_timeout)
    if not ready:
        print(f"文件未就绪: {err}", file=sys.stderr)
        sys.exit(1)

    print(file_id)


if __name__ == "__main__":
    main()