tuya-platform-cli 0.1.0

package/src/lib/report.js

@@ -0,0 +1,309 @@
+import path from "node:path";
+import { summarizeWorkflowSchema, buildStaticAnalysis } from "./analyze.js";
+import { safeJsonParse, writeText } from "./util.js";
+
+const STEP_PRIMARY_PATTERNS = {
+  "step-01-list-load": ["/micro-app/exp/api/aigc/workflow/list"],
+  "step-02-create-workflow": ["/micro-app/exp/api/v2/aigc/workflow/addBasic"],
+  "step-03-detail-load": ["/micro-app/ai/api/v2/aigc/workflow/get"],
+  "step-04-add-intent-node": ["/micro-app/ai/api/aigc/workflow/update"],
+  "step-05-add-llm-node": ["/micro-app/ai/api/aigc/workflow/update"],
+  "step-06-save-workflow": ["/micro-app/ai/api/aigc/workflow/update"],
+  "step-07-trial-run": [
+    "/micro-app/ai/api/v2/aigc/workflow/test/execute",
+    "/micro-app/ai/api/aigc/workflow/test/config/save",
+    "/micro-app/ai/api/aigc/workflow/test/config",
+    "/micro-app/ai/api/aigc/workflow/test/progress",
+  ],
+  "step-08-delete-workflow": ["/micro-app/exp/api/aigc/workflow/delete"],
+};
+
+const STEP_FALLBACK_SOURCES = {
+  "step-06-save-workflow": ["step-05-add-llm-node", "step-04-add-intent-node"],
+};
+
+function isNoiseRequest(request) {
+  const url = String(request?.url ?? "");
+
+  return (
+    request?.method === "OPTIONS" ||
+    url.startsWith("chrome-extension://") ||
+    url.includes("tpm.tuyacn.com/tpm.gif") ||
+    url.includes("sentry.tuyacn.com/") ||
+    url.includes("static1.tuyacn.com/") ||
+    url.includes("feedback.tuya-inc.top") ||
+    url.includes("/_channel")
+  );
+}
+
+function scoreRequest(stepId, request) {
+  if (!request || isNoiseRequest(request)) {
+    return Number.NEGATIVE_INFINITY;
+  }
+
+  const url = String(request.url ?? "");
+  const patterns = STEP_PRIMARY_PATTERNS[stepId] ?? [];
+  let score = 0;
+
+  if (url.includes("platform.tuya.com")) {
+    score += 5;
+  }
+  if (url.includes("/micro-app/")) {
+    score += 20;
+  }
+  if (request.method === "POST") {
+    score += 8;
+  }
+  if (String(request.responseHeaders?.["content-type"] ?? "").includes("json")) {
+    score += 4;
+  }
+  if (safeJsonParse(request.requestBody) || safeJsonParse(request.responseBody)) {
+    score += 4;
+  }
+
+  const schema = url.includes("workflow/update") ? summarizeWorkflowSchema(request) : null;
+  if (stepId === "step-06-save-workflow" && schema?.edgeCount > 0) {
+    score += 40;
+  }
+  if (stepId === "step-06-save-workflow" && schema?.nodeCount > 0) {
+    score += 8;
+  }
+
+  const matchedPattern = patterns
+    .filter((pattern) => url.includes(pattern))
+    .sort((left, right) => right.length - left.length)[0];
+
+  if (matchedPattern) {
+    score += 100;
+  }
+
+  if (url.includes("workflow/update")) {
+    score += 15;
+  }
+  if (url.includes("workflow/test/execute")) {
+    score += 25;
+  }
+  if (url.includes("workflow/test/progress")) {
+    score += 20;
+  }
+  if (url.includes("workflow/test/config/save")) {
+    score += 18;
+  }
+  if (url.includes("workflow/test/")) {
+    score += 15;
+  }
+  if (url.includes("workflow/get") || url.includes("workflow/list") || url.includes("workflow/delete")) {
+    score += 12;
+  }
+
+  return score;
+}
+
+function expandSchemaJson(value) {
+  if (Array.isArray(value)) {
+    return value.map(expandSchemaJson);
+  }
+
+  if (!value || typeof value !== "object") {
+    return value;
+  }
+
+  const output = {};
+  for (const [key, current] of Object.entries(value)) {
+    if (key === "schemaJson" && typeof current === "string") {
+      output[key] = safeJsonParse(current) ?? current;
+      continue;
+    }
+
+    output[key] = expandSchemaJson(current);
+  }
+
+  return output;
+}
+
+function normalizeBody(body) {
+  const parsed = safeJsonParse(body);
+  return parsed ? expandSchemaJson(parsed) : body ?? null;
+}
+
+function extractWorkflowId(request) {
+  const sources = [
+    request?.url,
+    request?.requestBody,
+    request?.responseBody,
+  ]
+    .filter(Boolean)
+    .map(String);
+
+  for (const source of sources) {
+    const match = source.match(/[?&]id=([^&]+)/) ?? source.match(/workflowId["':= ]+([a-zA-Z0-9_-]+)/);
+    if (match) {
+      return match[1];
+    }
+  }
+
+  return null;
+}
+
+function detectEvidenceLevel(request) {
+  return request ? "实测抓包" : "静态推断";
+}
+
+function extractRelevantHeaders(request) {
+  if (!request) {
+    return {};
+  }
+
+  const headers = request.requestHeaders ?? {};
+  const relevantKeys = [
+    "authorization",
+    "cookie",
+    "csrf-token",
+    "x-csrf-token",
+    "x-requested-with",
+  ];
+
+  return Object.fromEntries(
+    Object.entries(headers).filter(([key]) => relevantKeys.includes(key.toLowerCase())),
+  );
+}
+
+function findBestRequest(stepId, stepNetworks) {
+  const current = stepNetworks.find((entry) => entry.step.id === stepId);
+  const candidates = current?.network ?? [];
+  const sorted = [...candidates].sort((left, right) => scoreRequest(stepId, right) - scoreRequest(stepId, left));
+
+  if (sorted[0] && scoreRequest(stepId, sorted[0]) > 0) {
+    return { request: sorted[0], sourceStepId: stepId };
+  }
+
+  for (const fallbackStepId of STEP_FALLBACK_SOURCES[stepId] ?? []) {
+    const fallback = stepNetworks.find((entry) => entry.step.id === fallbackStepId);
+    const fallbackSorted = [...(fallback?.network ?? [])].sort(
+      (left, right) => scoreRequest(stepId, right) - scoreRequest(stepId, left),
+    );
+    if (fallbackSorted[0] && scoreRequest(stepId, fallbackSorted[0]) > 0) {
+      return { request: fallbackSorted[0], sourceStepId: fallbackStepId };
+    }
+  }
+
+  return { request: candidates[0] ?? null, sourceStepId: stepId };
+}
+
+function buildNotes(step, primaryRequest, sourceStepId, network) {
+  const notes = [];
+
+  notes.push(`证据等级：${detectEvidenceLevel(primaryRequest)}`);
+
+  if (!primaryRequest) {
+    notes.push("该步骤未识别出主请求，请结合 raw network.json 和 static-analysis.md 复核。");
+    return notes.join("；");
+  }
+
+  const workflowId = extractWorkflowId(primaryRequest);
+  if (workflowId) {
+    notes.push(`workflowId 线索：${workflowId}`);
+    if (/^\d+$/.test(workflowId)) {
+      notes.push("workflowId 格式：十进制数字，表现为后端创建后返回");
+    }
+  }
+
+  if (sourceStepId && sourceStepId !== step.id) {
+    notes.push(`主证据来自 ${sourceStepId}`);
+  }
+
+  const streamType =
+    primaryRequest.method === "WEBSOCKET"
+      ? "WebSocket"
+      : String(primaryRequest.responseHeaders?.["content-type"] ?? "")
+          .includes("text/event-stream")
+        ? "SSE"
+        : primaryRequest.responseBody?.includes("\n\n")
+          ? "可能为分块流式响应"
+          : "非流式或未识别";
+
+  if (step.id === "step-07-trial-run") {
+    notes.push(`试运行流式格式：${streamType}`);
+    notes.push("前端实现：先调用 /workflow/test/execute，再轮询 /workflow/test/progress；未发现 SSE");
+
+    const executeBody = normalizeBody(primaryRequest?.responseBody);
+    if (typeof executeBody?.result === "string") {
+      notes.push(`executeId：${executeBody.result}`);
+    }
+
+    const progressRequest = (network ?? []).find((request) =>
+      String(request.url ?? "").includes("/workflow/test/progress"),
+    );
+    const progressBody = normalizeBody(progressRequest?.responseBody);
+    const progressResult = progressBody?.result;
+    if (progressResult) {
+      notes.push(
+        `progress 完成态：executeStatus=${progressResult.executeStatus}，nodeResults=${progressResult.nodeResults?.length ?? 0}，outputCards=${progressResult.outputCards?.length ?? 0}`,
+      );
+    }
+  }
+
+  if (step.id === "step-06-save-workflow") {
+    const schema = summarizeWorkflowSchema(primaryRequest);
+    if (schema) {
+      notes.push(
+        `保存 schema 摘要：nodes=${schema.nodeCount}，edges=${schema.edgeCount}，nodeTypes=${schema.nodeTypes.join(", ") || "unknown"}`,
+      );
+      if (schema.nodes.length > 0) {
+        notes.push(
+          `节点字段：id(${schema.nodes[0].id}) / type(${schema.nodes[0].type}) / meta.position(${schema.nodes[0].position}) / data(${schema.nodes[0].data})`,
+        );
+      }
+      if (schema.edgeCount === 0) {
+        notes.push("edges 结构：当前保存样本为空数组 []");
+      } else if (schema.edges.length > 0) {
+        const edgeFields = Object.entries(schema.edges[0])
+          .map(([key, value]) => `${key}(${value})`)
+          .join(" / ");
+        notes.push(
+          `edges 字段：${edgeFields}`,
+        );
+        if (schema.edgeSample) {
+          notes.push(`edges 样例：${JSON.stringify(schema.edgeSample)}`);
+        }
+      }
+    }
+  }
+
+  return notes.join("；");
+}
+
+export async function writeReport(outputDir, stepNetworks) {
+  const lines = ["# Tuya Workflow API Reverse Report", ""];
+
+  for (const { step, network } of stepNetworks) {
+    const { request: primary, sourceStepId } = findBestRequest(step.id, stepNetworks);
+
+    lines.push(`### ${step.title}`);
+    lines.push(`- 方法：${primary?.method ?? "未识别"}`);
+    lines.push(`- URL：${primary?.url ?? "未识别"}`);
+    lines.push(
+      `- 请求头（认证相关）：${JSON.stringify(extractRelevantHeaders(primary), null, 2)}`,
+    );
+    lines.push(
+      `- 请求 Body / Query 参数（完整 JSON）：${JSON.stringify(normalizeBody(primary?.requestBody), null, 2)}`,
+    );
+    lines.push(
+      `- 响应 Body（完整 JSON，至少记录关键字段）：${JSON.stringify(normalizeBody(primary?.responseBody), null, 2)}`,
+    );
+    lines.push(`- 备注：${buildNotes(step, primary, sourceStepId, network)}`);
+    lines.push("");
+  }
+
+  const hits = buildStaticAnalysis(stepNetworks);
+  lines.push("## Static Hints");
+  if (hits.length === 0) {
+    lines.push("- 无额外静态关键词命中。");
+  } else {
+    for (const hit of hits.slice(0, 20)) {
+      lines.push(`- ${hit.stepTitle}: ${hit.method} ${hit.url} [${hit.matches.join(", ")}]`);
+    }
+  }
+
+  await writeText(path.join(outputDir, "report.md"), `${lines.join("\n")}\n`);
+}