@zyun_skill/skills-runtime 1.0.0

package/README.md

@@ -0,0 +1,9 @@
+# @zyun_skill/skills-runtime
+
+Zhiyun Skills Runtime
+
+## Example
+
+```bash
+npx @zyun_skill/skills-runtime@latest serve douyin
+```

package/bin/zhiyun-skills-runtime.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import { argv } from "node:process";
+import { createApiClient } from "../src/client.js";
+import { getApiKey } from "../src/env.js";
+import { executeDouyinAction } from "../src/skills/douyin.js";
+
+const args = argv.slice(2);
+const command = args[0];
+const skillName = args[1];
+const action = args[2];
+
+function parsePayload(cliArgs) {
+  const payloadFileIndex = cliArgs.indexOf("--payload-file");
+  if (payloadFileIndex !== -1) {
+    const payloadFile = cliArgs[payloadFileIndex + 1];
+    if (!payloadFile) {
+      throw new Error("缺少 --payload-file 对应的文件路径");
+    }
+
+    try {
+      return JSON.parse(fs.readFileSync(payloadFile, "utf-8"));
+    } catch (error) {
+      throw new Error("无法解析 --payload-file 中的 JSON");
+    }
+  }
+
+  const payloadIndex = cliArgs.indexOf("--payload");
+  if (payloadIndex === -1) {
+    return {};
+  }
+
+  const payloadRaw = cliArgs[payloadIndex + 1];
+  if (!payloadRaw) {
+    throw new Error("缺少 --payload 对应的 JSON 内容");
+  }
+
+  try {
+    return JSON.parse(payloadRaw);
+  } catch (error) {
+    throw new Error("无法解析 --payload JSON");
+  }
+}
+
+if (command === "serve") {
+  try {
+    const apiKey = getApiKey();
+    createApiClient();
+
+    if (skillName !== "douyin") {
+      throw new Error(`暂不支持的 Skill: ${skillName}`);
+    }
+
+    if (!action) {
+      console.log(`启动 Runtime: ${skillName}`);
+      console.log(`读取到 API_KEY，长度: ${apiKey.length}`);
+      process.exit(0);
+    }
+
+    const payload = parsePayload(args);
+    const result = await executeDouyinAction(action, payload);
+    console.log(JSON.stringify(result, null, 2));
+    process.exit(0);
+  } catch (error) {
+    console.error(error.message);
+    process.exit(1);
+  }
+}
+
+console.log("用法: npx @zyun_skill/skills-runtime@latest serve douyin");
+console.log("示例: npx @zyun_skill/skills-runtime@latest serve douyin fetch_video_search_v2 --payload '{\"keyword\":\"HappyHorse\"}'");
+console.log("示例: npx @zyun_skill/skills-runtime@latest serve douyin fetch_video_search_v2 --payload-file .\\payloads\\search.json");
+process.exit(1);

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@zyun_skill/skills-runtime",
+  "version": "1.0.0",
+  "description": "Zhiyun skills runtime",
+  "type": "module",
+  "bin": {
+    "zhiyun-skills-runtime": "./bin/zhiyun-skills-runtime.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "README.md"
+  ],
+  "dependencies": {
+    "axios": "^1.9.0",
+    "dotenv": "^16.5.0"
+  },
+  "license": "MIT"
+}

package/src/client.js

@@ -0,0 +1,31 @@
+import axios from "axios";
+import { getApiKey, getBaseUrl } from "./env.js";
+
+export function createApiClient() {
+  const apiKey = getApiKey();
+
+  return axios.create({
+    baseURL: getBaseUrl(),
+    timeout: 60000,
+    headers: {
+      Authorization: `Bearer ${apiKey}`
+    }
+  });
+}
+
+export async function requestApi({ method, path, payloadMode = "query", payload = {} }) {
+  const client = createApiClient();
+  const requestConfig = {
+    method,
+    url: path
+  };
+
+  if (payloadMode === "body") {
+    requestConfig.data = payload;
+  } else {
+    requestConfig.params = payload;
+  }
+
+  const response = await client.request(requestConfig);
+  return response.data;
+}

package/src/env.js

@@ -0,0 +1,18 @@
+import dotenv from "dotenv";
+
+dotenv.config();
+
+export function getApiKey() {
+  const apiKey = process.env.API_KEY || process.env.ZYUN_API_KEY || "";
+
+  if (!apiKey) {
+    throw new Error("未找到 API_KEY，请在 .env 中配置");
+  }
+
+  return apiKey;
+}
+
+export function getBaseUrl() {
+  const baseUrl = process.env.ZYUN_BASE_URL || "https://www.zyunaigc.com";
+  return baseUrl.replace(/\/+$/, "");
+}

package/src/skills/douyin.js

@@ -0,0 +1,90 @@
+import { requestApi } from "../client.js";
+
+export const douyinSkill = {
+  slug: "douyin",
+  name: "抖音工具箱"
+};
+
+export const douyinEndpoints = {
+  fetch_one_video: {
+    method: "GET",
+    path: "/api/v1/douyin/web/fetch_one_video",
+    payloadMode: "query",
+    params: ["aweme_id", "video_url"]
+  },
+  fetch_video_search_v2: {
+    method: "POST",
+    path: "/api/v1/douyin/search/fetch_video_search_v2",
+    payloadMode: "body",
+    params: [
+      "keyword",
+      "cursor",
+      "offset",
+      "sort_type",
+      "publish_time",
+      "filter_duration",
+      "content_type",
+      "search_id"
+    ]
+  },
+  handler_user_profile: {
+    method: "GET",
+    path: "/api/v1/douyin/web/handler_user_profile",
+    payloadMode: "query",
+    params: ["sec_user_id", "user_url"]
+  }
+};
+
+function pickAllowedParams(payload, allowedParams) {
+  const result = {};
+
+  for (const key of allowedParams) {
+    if (payload[key] !== undefined) {
+      result[key] = payload[key];
+    }
+  }
+
+  return result;
+}
+
+function normalizePayload(action, payload = {}) {
+  if (action === "fetch_video_search_v2") {
+    return {
+      keyword: payload.keyword ?? "",
+      cursor: payload.cursor ?? 0,
+      offset: payload.offset ?? 0,
+      sort_type: payload.sort_type ?? "0",
+      publish_time: payload.publish_time ?? "0",
+      filter_duration: payload.filter_duration ?? "0",
+      content_type: payload.content_type ?? "0",
+      search_id: payload.search_id ?? ""
+    };
+  }
+
+  const endpoint = douyinEndpoints[action];
+  return pickAllowedParams(payload, endpoint.params);
+}
+
+export async function executeDouyinAction(action, payload = {}) {
+  const endpoint = douyinEndpoints[action];
+
+  if (!endpoint) {
+    throw new Error(`未定义的抖音 Skill 动作: ${action}`);
+  }
+
+  const normalizedPayload = normalizePayload(action, payload);
+  const result = await requestApi({
+    method: endpoint.method,
+    path: endpoint.path,
+    payloadMode: endpoint.payloadMode,
+    payload: normalizedPayload
+  });
+
+  return {
+    action,
+    method: endpoint.method,
+    path: endpoint.path,
+    payload: normalizedPayload,
+    result
+  };
+}