tuya-platform-cli 0.1.0

package/src/lib/commands/sample-branch-edges.js

@@ -0,0 +1,391 @@
+import path from "node:path";
+import { ensureDir, writeJson, writeText } from "../util.js";
+import {
+  buildNetworkCapture,
+  createWorkflowViaPage,
+  getBrowserContext,
+  getWorkflowViaPage,
+  pageFetchJson,
+  readWorkflowSchema,
+  updateWorkflowViaPage,
+} from "./shared.js";
+
+function buildBranchWorkflowSchema({ region }) {
+  return {
+    editVersionNo: 1,
+    nodes: [
+      {
+        id: "100001",
+        type: "Start",
+        meta: { position: { x: 100, y: 320 } },
+        data: {
+          title: "Start",
+          nodeMeta: {
+            description: "支持中间过程的消息输出，支持流式和非流式两种方式",
+            title: "开始",
+          },
+          outputs: [
+            {
+              disableEdit: false,
+              id: "USER_TEXT",
+              name: "USER_TEXT",
+              required: true,
+              type: "string",
+            },
+            {
+              disableEdit: false,
+              id: "USER_IMAGE",
+              name: "USER_IMAGE",
+              required: false,
+              type: "image",
+            },
+          ],
+          version: 1,
+        },
+      },
+      {
+        id: "selectBranchAZ001",
+        type: "Select",
+        meta: { position: { x: 420, y: 320 } },
+        data: {
+          title: "选择器_双分支",
+          nodeMeta: {
+            title: "选择器",
+            description: "连接多个下游分支，若设定的条件成立则仅运行对应的分支，若均不成立则只运行“否则”分支",
+          },
+          exceptionSetting: {
+            timeout: 60,
+            retryTimes: 0,
+            strategy: 0,
+            portId: "",
+          },
+          inputs: [],
+          outputs: [],
+          nodeParam: {
+            selectConditions: {
+              0: {
+                portId: "condition_branch_a_port",
+                conditionList: [
+                  {
+                    conditionId: "condition_branch_a",
+                    prerequisites: {
+                      id: "pre_branch_a",
+                      name: "USER_TEXT",
+                      type: "string",
+                      isRef: 1,
+                      constantValue: "",
+                    },
+                    postcondition: {
+                      id: "post_branch_a",
+                      name: "",
+                      type: "string",
+                      isRef: 0,
+                      constantValue: "走A分支",
+                    },
+                    judge: "=",
+                  },
+                ],
+                conditionRelation: "&&",
+              },
+              "-1": {
+                portId: "condition_branch_else_port",
+              },
+            },
+          },
+        },
+      },
+      {
+        id: "llmBranchAAZ001",
+        type: "LLM",
+        meta: { position: { x: 780, y: 180 } },
+        data: {
+          title: "分支A回答",
+          nodeMeta: {
+            description: "调用大语言模型,使用变量和提示词生成回复",
+            title: "大模型",
+          },
+          exceptionSetting: {
+            timeout: 60,
+            retryTimes: 0,
+            strategy: 0,
+            portId: "",
+          },
+          inputs: [
+            {
+              constantValue: "",
+              disableEdit: false,
+              id: "inputBranchA",
+              isRef: 1,
+              name: "input",
+              refId: "USER_TEXT",
+              refName: "USER_TEXT",
+              refNode: "100001",
+              type: "string",
+            },
+          ],
+          nodeParam: {
+            model: "160",
+            outputType: 1,
+            skills: [],
+            systemPrompt: "你是分支A测试助手。",
+            useHistory: 0,
+            userPrompt: "如果用户输入命中A分支，请返回“A分支已执行”。否则也给出简短回答。",
+          },
+          outputs: [
+            {
+              disableEdit: false,
+              id: "outputBranchA",
+              name: "output",
+              type: "string",
+            },
+          ],
+          version: 1,
+          visionInputs: [],
+        },
+      },
+      {
+        id: "llmBranchBAZ001",
+        type: "LLM",
+        meta: { position: { x: 780, y: 460 } },
+        data: {
+          title: "分支B回答",
+          nodeMeta: {
+            description: "调用大语言模型,使用变量和提示词生成回复",
+            title: "大模型",
+          },
+          exceptionSetting: {
+            timeout: 60,
+            retryTimes: 0,
+            strategy: 0,
+            portId: "",
+          },
+          inputs: [
+            {
+              constantValue: "",
+              disableEdit: false,
+              id: "inputBranchB",
+              isRef: 1,
+              name: "input",
+              refId: "USER_TEXT",
+              refName: "USER_TEXT",
+              refNode: "100001",
+              type: "string",
+            },
+          ],
+          nodeParam: {
+            model: "160",
+            outputType: 1,
+            skills: [],
+            systemPrompt: "你是分支B测试助手。",
+            useHistory: 0,
+            userPrompt: "如果用户输入未命中A分支，请返回“B分支已执行”。否则也给出简短回答。",
+          },
+          outputs: [
+            {
+              disableEdit: false,
+              id: "outputBranchB",
+              name: "output",
+              type: "string",
+            },
+          ],
+          version: 1,
+          visionInputs: [],
+        },
+      },
+      {
+        id: "end_branch_a",
+        type: "End",
+        meta: { position: { x: 1140, y: 180 } },
+        data: {
+          title: "分支A结束",
+          nodeMeta: {
+            description: "支持中间过程的消息输出，支持流式和非流式两种方式",
+            title: "输出",
+          },
+          nodeParam: {
+            isStream: 0,
+            outputContent: "",
+            saveRecord: true,
+            tts: true,
+          },
+          inputs: [
+            {
+              constantValue: "",
+              disableEdit: false,
+              id: "inputEndA",
+              isRef: 1,
+              name: "output",
+              refId: "outputBranchA",
+              refName: "output",
+              refNode: "llmBranchAAZ001",
+              type: "string",
+            },
+          ],
+          visionInputs: [],
+          audioInputs: [],
+          outputs: [],
+          version: 1,
+        },
+      },
+      {
+        id: "end_branch_b",
+        type: "End",
+        meta: { position: { x: 1140, y: 460 } },
+        data: {
+          title: "分支B结束",
+          nodeMeta: {
+            description: "支持中间过程的消息输出，支持流式和非流式两种方式",
+            title: "输出",
+          },
+          nodeParam: {
+            isStream: 0,
+            outputContent: "",
+            saveRecord: true,
+            tts: true,
+          },
+          inputs: [
+            {
+              constantValue: "",
+              disableEdit: false,
+              id: "inputEndB",
+              isRef: 1,
+              name: "output",
+              refId: "outputBranchB",
+              refName: "output",
+              refNode: "llmBranchBAZ001",
+              type: "string",
+            },
+          ],
+          visionInputs: [],
+          audioInputs: [],
+          outputs: [],
+          version: 1,
+        },
+      },
+    ],
+    edges: [
+      { sourceNodeID: "100001", targetNodeID: "selectBranchAZ001" },
+      { sourceNodeID: "selectBranchAZ001", targetNodeID: "llmBranchAAZ001" },
+      { sourceNodeID: "selectBranchAZ001", targetNodeID: "llmBranchBAZ001" },
+      { sourceNodeID: "llmBranchAAZ001", targetNodeID: "end_branch_a" },
+      { sourceNodeID: "llmBranchBAZ001", targetNodeID: "end_branch_b" },
+    ],
+    workflow: {
+      region,
+    },
+  };
+}
+
+function buildSummaryMarkdown(artifact) {
+  return [
+    "# Branch Edges Sample",
+    "",
+    `- Workflow: \`${artifact.workflowName}\` (${artifact.workflowId})`,
+    `- Region: \`${artifact.region}\``,
+    `- Edge count: \`${artifact.savedSchema.edges.length}\``,
+    `- Node types: \`${artifact.savedSchema.nodes.map((item) => item.type).join(", ")}\``,
+    "",
+    "## Selector",
+    `- Type: \`${artifact.selectorNode.type}\``,
+    `- Branch keys: \`${Object.keys(
+      artifact.selectorNode.data?.nodeParam?.selectConditions ?? {},
+    ).join(", ")}\``,
+    "",
+  ].join("\n");
+}
+
+export async function runSampleBranchEdges(config) {
+  await ensureDir(config.outputDir);
+
+  const { browser, context, page } = await getBrowserContext(config.remoteDebuggingPort);
+  const capture = buildNetworkCapture(
+    context,
+    /workflow\/update|workflow\/get|workflow\/list|addBasic/i,
+  );
+  let createdWorkflowId = null;
+
+  try {
+    await page.bringToFront();
+    await page.goto(config.baseUrl, { waitUntil: "domcontentloaded" }).catch(() => {});
+    await page.waitForTimeout(4_000);
+
+    const workflowName = config.workflowName ?? `样本-多分支-${Date.now().toString().slice(-6)}`;
+    const created = await createWorkflowViaPage(page, {
+      workflowName,
+      workflowDesc: "CLI branch edges sample",
+      workflowRegion: config.region,
+      workflowType: 1,
+    });
+    createdWorkflowId = created.workflowId;
+
+    const detailBefore = await getWorkflowViaPage(page, created.workflowId);
+    const currentEditVersionNo = detailBefore.json?.result?.editVersionNo ?? 1;
+    const schemaJson = buildBranchWorkflowSchema({ region: config.region });
+
+    const updated = await updateWorkflowViaPage(page, {
+      workflowId: created.workflowId,
+      editVersionNo: currentEditVersionNo,
+      schemaJson,
+    });
+
+    const detailAfter = await getWorkflowViaPage(page, created.workflowId);
+    const savedSchema = readWorkflowSchema(detailAfter);
+    const selectorNode = savedSchema.nodes.find((item) => item.type === "Select") ?? null;
+
+    if (!selectorNode) {
+      throw new Error("Branch edges sample failed: selector node missing after workflow/get");
+    }
+
+    if ((savedSchema.edges ?? []).length < 5) {
+      throw new Error("Branch edges sample failed: expected at least 5 edges");
+    }
+
+    const artifact = {
+      generatedAt: new Date().toISOString(),
+      workflowId: created.workflowId,
+      workflowName,
+      region: config.region,
+      create: created,
+      getBefore: detailBefore,
+      update: updated,
+      getAfter: detailAfter,
+      savedSchema,
+      selectorNode,
+      events: capture.events,
+    };
+
+    await writeJson(
+      path.join(config.outputDir, `branch-edges-${created.workflowId}.json`),
+      artifact,
+    );
+    await writeText(
+      path.join(config.outputDir, "branch-edges.md"),
+      buildSummaryMarkdown(artifact),
+    );
+
+    console.log(
+      JSON.stringify(
+        {
+          outputDir: config.outputDir,
+          workflowId: created.workflowId,
+          workflowName,
+          edgeCount: savedSchema.edges.length,
+        },
+        null,
+        2,
+      ),
+    );
+  } finally {
+    if (createdWorkflowId) {
+      try {
+        await pageFetchJson(page, "/micro-app/exp/api/v2/aigc/workflow/delete", {
+          body: { params: { workflowId: createdWorkflowId } },
+        });
+      } catch {
+        console.error(`Warning: failed to clean up workflow ${createdWorkflowId}`);
+      }
+    }
+    capture.dispose();
+    await browser.close();
+  }
+}

package/src/lib/commands/sample-extra-nodes.js

@@ -0,0 +1,204 @@
+import path from "node:path";
+import { ensureDir, writeJson, writeText } from "../util.js";
+import {
+  assertNodePresent,
+  buildNetworkCapture,
+  createWorkflowViaPage,
+  extractSchemaNode,
+  getBrowserContext,
+  pageFetchJson,
+} from "./shared.js";
+
+async function openEditor(page, workflowId, baseUrl) {
+  await page.goto(`${baseUrl}/edit?workflowId=${workflowId}`, {
+    waitUntil: "domcontentloaded",
+  });
+  await page.waitForTimeout(7_000);
+}
+
+async function deleteWorkflowById(page, workflowId, { baseOrigin } = {}) {
+  try {
+    await pageFetchJson(page, "/micro-app/exp/api/v2/aigc/workflow/delete", {
+      body: { params: { workflowId } },
+      baseOrigin,
+    });
+  } catch {
+    console.error(`Warning: failed to clean up workflow ${workflowId}`);
+  }
+}
+
+async function addNodeFromPanel(page, nodeName) {
+  await page.getByRole("button", { name: "添加节点" }).click();
+  await page.waitForTimeout(1_000);
+  await page.getByText(nodeName, { exact: true }).last().click({ force: true });
+  await page.waitForTimeout(6_000);
+}
+
+async function captureLoopSample(page, context, outputDir, { namePrefix, region, baseUrl }) {
+  const workflowName = `${namePrefix}-循环`;
+  const capture = buildNetworkCapture(context);
+  let workflowId = null;
+
+  try {
+    const created = await createWorkflowViaPage(page, {
+      workflowName,
+      workflowDesc: "CLI Loop sample",
+      workflowRegion: region,
+      workflowType: 1,
+    });
+    workflowId = created.workflowId;
+
+    await openEditor(page, created.workflowId, baseUrl);
+    await addNodeFromPanel(page, "循环");
+
+    const snapshot = extractSchemaNode(capture.events, "Loop");
+    const loopNode = assertNodePresent(snapshot, "Loop");
+    const artifact = {
+      workflowName,
+      workflowId: created.workflowId,
+      createResponse: created.json,
+      bodyText: (await page.locator("body").innerText()).slice(0, 8_000),
+      events: capture.events,
+      loopNode,
+      schemaJson: snapshot.schemaJson,
+    };
+
+    await writeJson(
+      path.join(outputDir, `loop-node-sample-${created.workflowId}.json`),
+      artifact,
+    );
+
+    return artifact;
+  } finally {
+    capture.dispose();
+    if (workflowId) {
+      await deleteWorkflowById(page, workflowId);
+    }
+  }
+}
+
+async function captureMonitorSample(page, context, outputDir, { namePrefix, region, baseUrl }) {
+  const workflowName = `${namePrefix}-定时监听`;
+  const capture = buildNetworkCapture(context);
+  let workflowId = null;
+
+  try {
+    const created = await createWorkflowViaPage(page, {
+      workflowName,
+      workflowDesc: "CLI Monitor sample",
+      workflowRegion: region,
+      workflowType: 1,
+    });
+    workflowId = created.workflowId;
+
+    await openEditor(page, created.workflowId, baseUrl);
+    await addNodeFromPanel(page, "定时监听");
+
+    const snapshot = extractSchemaNode(capture.events, "Monitor");
+    const monitorNode = assertNodePresent(snapshot, "Monitor");
+    const artifact = {
+      workflowName,
+      workflowId: created.workflowId,
+      createResponse: created.json,
+      bodyText: (await page.locator("body").innerText()).slice(0, 8_000),
+      events: capture.events,
+      monitorNode,
+      schemaJson: snapshot.schemaJson,
+    };
+
+    await writeJson(
+      path.join(outputDir, `monitor-node-sample-${created.workflowId}.json`),
+      artifact,
+    );
+
+    return artifact;
+  } finally {
+    capture.dispose();
+    if (workflowId) {
+      await deleteWorkflowById(page, workflowId);
+    }
+  }
+}
+
+function buildSummaryMarkdown({ loopArtifact, monitorArtifact }) {
+  return [
+    "# Extra Node Samples",
+    "",
+    `- Loop workflow: \`${loopArtifact.workflowName}\` (${loopArtifact.workflowId})`,
+    `- Monitor workflow: \`${monitorArtifact.workflowName}\` (${monitorArtifact.workflowId})`,
+    "",
+    "## Loop",
+    `- Type: \`${loopArtifact.loopNode?.type ?? "unknown"}\``,
+    `- Blocks: \`${(loopArtifact.loopNode?.blocks ?? []).map((item) => item.type).join(", ")}\``,
+    `- loopType: \`${loopArtifact.loopNode?.data?.nodeParam?.loopType ?? ""}\``,
+    "",
+    "## Monitor",
+    `- Type: \`${monitorArtifact.monitorNode?.type ?? "unknown"}\``,
+    `- Blocks: \`${(monitorArtifact.monitorNode?.blocks ?? []).map((item) => item.type).join(", ")}\``,
+    `- time: \`${monitorArtifact.monitorNode?.data?.nodeParam?.time ?? ""}\``,
+    `- useOutput: \`${monitorArtifact.monitorNode?.data?.nodeParam?.useOutput ?? ""}\``,
+    "",
+  ].join("\n");
+}
+
+export async function runSampleExtraNodes(config) {
+  await ensureDir(config.outputDir);
+
+  const { browser, context, page } = await getBrowserContext(config.remoteDebuggingPort);
+
+  try {
+    await page.bringToFront();
+    await page.goto(config.baseUrl, { waitUntil: "domcontentloaded" }).catch(() => {});
+    await page.waitForTimeout(4_000);
+
+    const namePrefix = config.workflowName ?? `样本-${Date.now().toString().slice(-6)}`;
+    const loopArtifact = await captureLoopSample(page, context, config.outputDir, {
+      namePrefix,
+      region: config.region,
+      baseUrl: config.baseUrl,
+    });
+    const monitorArtifact = await captureMonitorSample(page, context, config.outputDir, {
+      namePrefix,
+      region: config.region,
+      baseUrl: config.baseUrl,
+    });
+
+    const summary = {
+      generatedAt: new Date().toISOString(),
+      command: "sample-extra-nodes",
+      region: config.region,
+      loop: {
+        workflowId: loopArtifact.workflowId,
+        workflowName: loopArtifact.workflowName,
+        nodeType: loopArtifact.loopNode?.type ?? null,
+      },
+      monitor: {
+        workflowId: monitorArtifact.workflowId,
+        workflowName: monitorArtifact.workflowName,
+        nodeType: monitorArtifact.monitorNode?.type ?? null,
+      },
+      files: {
+        loop: `loop-node-sample-${loopArtifact.workflowId}.json`,
+        monitor: `monitor-node-sample-${monitorArtifact.workflowId}.json`,
+      },
+    };
+
+    await writeJson(path.join(config.outputDir, "extra-node-samples-summary.json"), summary);
+    await writeJson(path.join(config.outputDir, "extra-node-samples-extended.json"), {
+      loopNode: loopArtifact.loopNode,
+      monitorNode: monitorArtifact.monitorNode,
+      workflowIds: {
+        loop: loopArtifact.workflowId,
+        monitor: monitorArtifact.workflowId,
+      },
+    });
+    await writeText(
+      path.join(config.outputDir, "extra-node-samples.md"),
+      buildSummaryMarkdown({ loopArtifact, monitorArtifact }),
+    );
+
+    console.log(JSON.stringify({ outputDir: config.outputDir, summary }, null, 2));
+  } finally {
+    await browser.close();
+  }
+}