1仕組みと動作原理

全機能が単一の Python CLI で実装されています。argparse で list/create/clone/check/manage_memory などのサブコマンドを定義し、main() が対応する関数にディスパッチします。

skills/flyworks-avatar-video-1.0.0/scripts/hifly_client.py

parser = argparse.ArgumentParser(description="HiFly Agent Skill Client")

ここでの処理内容：「デジタルヒューマン動画の生成」に関する全操作を、エージェントが直接呼び出し可能な単一のコマンドラインエントリに集約しています。

認証情報は環境変数 HIFLY_API_TOKEN から読み取られます。設定されていない場合は、ソースコード内にハードコードされた無料試用トークンにフォールバックし、30秒制限・透かし付きで動作します。

skills/flyworks-avatar-video-1.0.0/scripts/hifly_client.py

token = os.environ.get("HIFLY_API_TOKEN")

ここでの処理内容：デモトークンにより設定不要で試走可能にしつつ、ユーザー自身がトークンを用意することで制限を解除できるようにしています。

すべてのリクエストは固定のバックエンド BASE_URL に送信され、Bearer ヘッダーでトークンを渡します。

skills/flyworks-avatar-video-1.0.0/scripts/hifly_client.py

BASE_URL = "https://hfw-api.hifly.cc/api/v2/hifly"

ここでの処理内容：リモート生成サービスのアドレスを定数としてハードコードし、HiFly/Flyworks デジタルヒューマン API エンドポイントを指定しています。

動画、音声、アバターはすべて非同期タスクです。送信して task_id を取得後、check_task_status/poll_avatar_task を使用してステータスコード（1: 待機 / 2: 処理中 / 3: 成功 / 4: 失敗）を2秒ごとにポーリングします。

skills/flyworks-avatar-video-1.0.0/scripts/hifly_client.py

url = f"{BASE_URL}/{task_type}/task"

ここでの処理内容：リモートの非同期キューを同期的な待機にラッピングし、エージェント側からは「リクエストを送信して結果を待つだけ」の呼び出しにしています。

ローカル素材（画像/音声）は2ステップでアップロードされます。まず /tool/create_upload_url にアップロード用 URL と file_id を要求し、次に PUT メソッドでファイル内容を送信、その file_id を指定して生成をリクエストします。

skills/flyworks-avatar-video-1.0.0/scripts/hifly_client.py

url = f"{BASE_URL}/tool/create_upload_url"

ここでの処理内容：「ローカルファイル」をリモートで利用可能な参照形式へ変換し、トーキングフォトや音声クローンの前提条件を満たします。

トーキングフォト（talking photo）は2段階パイプラインです。まず /avatar/create_by_image でカスタムアバターを作成してポーリングで avatar_id を取得し、次にそのアバターを用いて TTS を実行し動画を生成します。

skills/flyworks-avatar-video-1.0.0/scripts/hifly_client.py

url = f"{BASE_URL}/avatar/create_by_image"

ここでの処理内容：「1枚の写真 + 原稿 + 声色」をアバター作成と動画生成の2ステップに分割し、それぞれ個別に再試行できるようにしています。

音声クローンは voice_type=8 で /voice/create に送信され、タスク完了後に再利用可能な Voice ID が返されます。

skills/flyworks-avatar-video-1.0.0/scripts/hifly_client.py

"voice_type": 8

ここでの処理内容：標準の TTS 声色（1）とクローン声色（8）を区別し、クローン結果を以降の TTS 動画から参照可能にしています。

ローカルエイリアス記憶：アバターや音声のエイリアスマッピングをスクリプトと同じディレクトリの memory.json に永続化し、セッションを跨いだ再利用を容易にします。

skills/flyworks-avatar-video-1.0.0/scripts/hifly_client.py

MEMORY_FILE = Path(__file__).parent / "memory.json"

ここでの処理内容：小さな JSON ファイルを「保存済みのアバター/声色」の管理台帳として使用し、manage_memory から追加・一覧表示できるようにしています。

2コア機能

01公開アバターのテキストtoビデオ（TTS：テキスト + アバター + 音声）

02トーキングフォト：単一画像からの発話動画生成

03音声クローン：音声サンプルからの声色クローニング

04音声駆動ビデオ（音声アップロード → 生成）

05タスクステータスの問い合わせとポーリング

06ローカルエイリアス記憶管理（add/list）

07公開アバターおよび公開音声の一覧表示

3外部依存関係

Kind	Dependency / Endpoint
api	HiFly/Flyworks 数字人 API
network	视频产物 CDN
package	requests（HTTP 客户端，requirements.txt）
cli	python3（运行 hifly_client.py）

4推奨統制措置と判定根拠

安全運用のための推奨統制措置

Agent 向け

段階的・都度認可、サンドボックス推奨

管理者向け

承認フロー、ロールバック可能、全履歴監査

判定根拠（ファイルパスと抜粋）

scripts/: ローカルスクリプトまたはコマンドの実行: python scripts/hifly_client.py <list_public_avatars|list_public_voices|crea
网络端点: 外部ネットワークアクセスの宣言: https://hfw-api.hifly.cc/api/v2/hifly (avatar/list, voice/list, video/create_b
本地工作目录: ファイルの読み書きと成果物の出力: load_memory/save_memory がスクリプト同階層の memory.json にエイリアスを書き込み。

監査ノート： オレンジ（評価後に使用）：実行可能スクリプトを含む実サービス向けクライアントです。宣言された用途に従い環境変数 HIFLY_API_TOKEN（認証情報）を読み取り、ユーザー素材（画像/音声/テキスト）を外部バックエンド hfw-api.hifly.cc に送信して生成を行います。これは「自己の用途のために認証情報/envを読み取る」「ユーザー素材を外部生成/サービスバックエンドに送信する」というオレンジの基準に該当します。リバースエンジニアリング、偽装、保護の回避などは含まれないためレッドには該当せず、純粋なローカル処理でもないためブルーより上位となります。

5二重目の独立検証

[ok] 网络端点全部指向 hfw-api.hifly.cc — requests.get/post/put 的 url 均由 BASE_URL 或上传返回的 upload_url 构造，扫到 11 处请求调用，无额外域名。
[ok] 凭证读取点 — 仅 get_token() 读 HIFLY_API_TOKEN，源码第 15 行；默认 token 第 11 行硬编码。
[ok] 写盘面 — 仅 save_memory 写 memory.json（第 34 行）；未见其它文件写入。
[ok] 是否有隐藏/混淆脚本 — 目录清单仅 9 个文本文件，无二进制/混淆体；扫描沙箱与危险旗标 0 命中。
[ok] 能力声明与代码相符 — SKILL/README 声称的公共头像、说话照片、声音克隆在脚本中均有对应函数与端点。
[ok] 默认 token 有效性声明 — 源码与 references/authentication.md 一致：demo token 自动启用，30s 上限且带水印。
[ok] 安装方式 — README 的 `npx skills add Flyworks-AI/skills` 属宿主安装行为，非本目录执行，故不计入档位。