接入页先解决“怎么开始”

import { ZiinClient } from "@ziin/sdk-js";

const client = new ZiinClient({
  baseUrl: "https://ziin.shenliu.cc",
  token: "editor|softwareId:erp-suite|tenantId:tenant-east-cn|userId:u-1001",
});

const result = await client.query({
  question: "怎么做入库单？",
  mode: "api-engine",
  module: "inventory",
  context: {
    route: "/inventory/inbound/create",
    platform: "web",
  },
});

console.log(result.answer);

const response = await fetch("https://ziin.shenliu.cc/api/ziin/query", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer editor|softwareId:erp-suite|tenantId:tenant-east-cn|userId:u-1001",
  },
  body: JSON.stringify({
    question: "这个模块是干嘛的？",
    mode: "ui-assistant",
    module: "inventory",
    context: {
      route: "/inventory/inbound/create",
      pageTitle: "入库管理",
      selectedMenu: "仓储中心 / 入库管理",
      platform: "web",
    },
  }),
});

const result = await response.json();
assistantPanel.render({
  answer: result.answer,
  intent: result.intent,
  routingVerdict: result.routingVerdict,
  taskState: result.taskState,
  nextAction: result.nextAction,
  followups: result.followups,
  cards: result.cards,
});

import {
  createHostRuntimeAdapter,
  createActionPlanExecutor,
  createZiinWidget,
} from "https://ziin.shenliu.cc/sdk/js/index.js";

const runtimeAdapter = createHostRuntimeAdapter({
  adapterConfig: {
    clientConfig: {
      baseUrl: "https://ziin.shenliu.cc",
      token: "editor|softwareId:erp-suite|tenantId:tenant-east-cn|userId:u-1001",
    },
    defaults: {
      mode: "ui-assistant",
      module: "inventory",
      softwareId: "erp-suite",
      tenantId: "tenant-east-cn",
      userId: "u-1001",
    },
  },
  getContext: () => ({
    route: window.location.pathname,
    pageTitle: document.title,
    selectedMenu: readSelectedMenuFromHost(),
    platform: "web",
    pageId: readStablePageId(),
    availableActions: ["navigate", "focus_field", "scroll_to", "open_dialog"],
  }),
});

createZiinWidget({
  runtimeAdapter,
  actionExecutor: createActionPlanExecutor({
    allowActions: ["navigate", "focus_field", "scroll_to", "open_dialog"],
    handlers: {
      navigate: (plan) => router.push(plan.route || "/"),
      focusField: (plan) => focusHostField(plan.target || ""),
      scrollTo: (plan) => document.querySelector(plan.target || "")?.scrollIntoView({ behavior: "smooth", block: "center" }),
      openDialog: (plan) => openDialog(plan.target),
    },
  }),
  defaultOpen: true,
  title: "智引操作内核",
  subtitle: "权限感知式操作指引",
  buttonLabel: "打开使用助手",
  contextLabel: "当前页面",
  theme: {
    accentColor: "#c55b2d",
    panelWidth: 420,
    borderRadius: 26,
  },
  events: {
    onQuerySuccess: ({ response }) => console.log("ziin.trace", response.traceId),
    onActionExecuted: ({ plan }) => console.log("ziin.action", plan.id),
  },
});

await widget.refreshContext();

wx.request({
  url: "https://ziin.shenliu.cc/api/ziin/query",
  method: "POST",
  header: {
    "Content-Type": "application/json",
    Authorization: "Bearer editor|softwareId:erp-suite|tenantId:tenant-east-cn|userId:u-1001",
  },
  data: {
    question: "报错是什么意思？",
    mode: "mini-program",
    module: "inventory",
    context: {
      route: "/pages/inventory/inbound/create",
      pageTitle: "入库管理",
      selectedMenu: "仓储中心 / 入库管理",
      platform: "mini-program",
    },
  },
});

curl -X POST https://ziin.shenliu.cc/api/ziin/sync \
  -H 'Content-Type: application/json' \
  -d '{
    "softwareId": "erp-suite",
    "tenant": {
      "id": "tenant-east-cn",
      "softwareId": "erp-suite",
      "name": "华东制造集团"
    },
    "menuNodes": [
      {
        "id": "mn-sync-001",
        "module": "inventory",
        "name": "入库管理",
        "route": "/inventory/inbound/create",
        "permissionKey": "inventory.write"
      }
    ],
    "permissionPoints": [
      {
        "roleCode": "warehouse_clerk",
        "permissionKey": "inventory.write"
      }
    ]
  }'

adapter:
  softwareId: erp-demo
  tenantMode: single
  defaultPlatform: web

mapping:
  roles:
    "采购员": purchaser
    "仓库管理员": warehouse_admin

  permissions:
    "inventory:inbound:create": "inventory.inbound.create"
    "inventory:inbound:read": "inventory.inbound.read"

import { ZiinClient } from "@ziin/sdk-js";

const client = new ZiinClient({
  baseUrl: "https://ziin.shenliu.cc",
});

const created = await client.uploadAndCreateAsrTask({
  tenantId: "tenant-east-cn",
  userId: "u-1001",
  source: "app",
  scene: "voice-ticket",
  language: "zh",
  file: {
    fileName: file.name,
    mimeType: file.type,
    bytes: file,
  },
});

const detail = await client.waitForTask(created.task.taskId, {
  intervalMs: 2000,
  maxAttempts: 45,
});

if (detail.status !== "success") {
  console.error(detail.error);
}

console.log(detail.result);

[
  { "type": "text", "content": "为什么提交失败？" },
  { "type": "error-dialog", "content": "提交失败：无权限提交入库单" },
  { "type": "ocr-text", "content": "OCR 结果：单据状态不允许过账" },
  { "type": "image", "content": "https://cdn.example.com/error.png", "mimeType": "image/png" },
  { "type": "document", "content": "https://cdn.example.com/manual.pdf", "mimeType": "application/pdf" }
]

type MultimodalEntryPayload = {
  scene: "assistant" | "order_create" | "order_detail" | string
  intent?: "lookup" | "shipping_consult" | "exception_judge" | string
  mode: "voice" | "text" | "image" | "file" | "mixed"
  text?: string
  audio?: { fileId?: string; durationMs?: number; transcript?: string }
  images?: Array<{ fileId?: string; name?: string }>
  files?: Array<{ fileId?: string; name?: string; mimeType?: string }>
  businessContext?: {
    route?: string
    pageTitle?: string
    selectedMenu?: string
    platform?: string
  }
  createdAt: string
}

curl -X POST https://omnimodal.shenliu.cc/api/v1/realtime/sessions \
  -H 'Content-Type: application/json' \
  -H 'x-omnimodal-api-key: YOUR_OMNIMODAL_KEY' \
  -d '{
    "tenantId": "YOUR_TENANT_ID",
    "scene": "ziin-public-site-voice",
    "mode": "voice",
    "audioConfig": {
      "codec": "pcm16",
      "sampleRate": 16000,
      "channelCount": 1
    },
    "businessContext": {
      "sourceSystem": "ziin",
      "channel": "floating-assistant"
    }
  }'