@xtalpi/agentic-lab-skills 0.0.1

package/skills/lab-orbit-component-builder/examples/xnb-component-template/src/utils/openerTicketIds.ts

@@ -0,0 +1,32 @@
+/**
+ * 从 opener 回包 `payload` 中解析 `ticket_ids`，供 `GET /api/ticket/list` 的 `ticket_id__in` 使用。
+ * 支持：`string[]`、`string`（逗号/分号/空白分隔）。
+ */
+export function extractTicketIdsFromPayload (payload: unknown): string[] {
+  if (payload == null || typeof payload !== 'object') return []
+  const raw = (payload as Record<string, unknown>).ticket_ids
+  if (Array.isArray(raw)) {
+    return raw.map((x: unknown) => String(x).trim()).filter((s: string) => s.length > 0)
+  }
+  if (typeof raw === 'string') {
+    return raw
+      .split(/[,;\s]+/)
+      .map((s: string) => s.trim())
+      .filter((s: string) => s.length > 0)
+  }
+  return []
+}
+
+/**
+ * 从 opener `payload` 解析 **`valve_id`**，供 `POST /api/execution/complete` 请求体使用。
+ */
+export function extractValveIdFromPayload (payload: unknown): number | null {
+  if (payload == null || typeof payload !== 'object') return null
+  const raw = (payload as Record<string, unknown>).valve_id
+  if (typeof raw === 'number' && Number.isFinite(raw)) return raw
+  if (typeof raw === 'string' && raw.trim() !== '') {
+    const n = Number(raw)
+    if (Number.isFinite(n)) return n
+  }
+  return null
+}

package/skills/lab-orbit-component-builder/examples/xnb-component-template/src/utils/orbitHttpClient.ts

@@ -0,0 +1,110 @@
+/**
+ * Orbit 运行时 HTTP：优先 `window.xnb.http.client.request`（与 Book 代理、鉴权一致），
+ * 无注入时回退 `fetch`。约定见仓库根目录 `OrbitAPI.md` §6.3。
+ *
+ * 请求体形状与 **`dev/src/global.d.ts`** 中 `XnbHttpClient.request` 对齐，避免与宿主注入类型冲突。
+ */
+
+export type OrbitHttpMethod = 'get' | 'post' | 'put' | 'delete' | 'patch'
+
+export interface OrbitRequestJsonInput {
+  method: OrbitHttpMethod
+  /** 完整 URL（已含 origin），如 `https://host/api/ticket/list` */
+  url: string
+  headers?: Record<string, string>
+  /** GET 时作为 query；值会转成 string */
+  query?: Record<string, string | number | boolean | undefined | null>
+  /** POST/PUT/PATCH 时作为 JSON 体（仅在使用 Orbit `Body.json` 时） */
+  jsonBody?: Record<string, unknown>
+}
+
+/** 与 `dev/src/global.d.ts` → `XnbHttpClient.request` 的 `options` 一致 */
+export interface XnbHttpClientRequestOptions {
+  method: string
+  url: string
+  headers?: Record<string, string>
+  responseType?: number
+  query?: Record<string, string>
+  body?: { type: string; data: unknown }
+}
+
+function getXnbHttp (): Window['xnb']['http'] | undefined {
+  return window.xnb?.http
+}
+
+/**
+ * 将 `client.request` 返回值规范为「业务 JSON 根对象」。
+ * 兼容 `res` 或 `res.data` 为 `{ code, data, msg }` 的形态。
+ */
+export function unwrapOrbitClientData (res: unknown): unknown {
+  if (res == null) return res
+  if (typeof res !== 'object') return res
+  const r = res as Record<string, unknown>
+  if ('code' in r && ('data' in r || 'msg' in r)) return res
+  if ('data' in r) {
+    const inner = r.data
+    if (inner != null && typeof inner === 'object' && 'code' in (inner as Record<string, unknown>)) {
+      return inner
+    }
+    return inner
+  }
+  return res
+}
+
+/**
+ * 使用 Orbit `http.client.request`（若存在）或回退 `fetch` 发 JSON 请求。
+ */
+export async function orbitRequestJson (input: OrbitRequestJsonInput): Promise<unknown> {
+  const http = getXnbHttp()
+  const client = http?.client
+  const RT = http?.ResponseType
+  const Body = http?.Body
+
+  if (client?.request != null && RT?.JSON != null) {
+    const headers: Record<string, string> = {
+      'Content-Type': 'application/json; charset=utf-8',
+      ...(input.headers ?? {})
+    }
+    const req: XnbHttpClientRequestOptions = {
+      method: input.method,
+      url: input.url,
+      headers,
+      responseType: RT.JSON
+    }
+    if (input.query != null) {
+      const q: Record<string, string> = {}
+      for (const [k, v] of Object.entries(input.query)) {
+        if (v !== undefined && v !== null) {
+          q[k] = String(v)
+        }
+      }
+      if (Object.keys(q).length > 0) req.query = q
+    }
+    if (input.jsonBody != null && Body?.json != null) {
+      req.body = Body.json(input.jsonBody) as { type: string; data: unknown }
+    }
+    const raw = await client.request(req)
+    return unwrapOrbitClientData(raw.data ?? raw)
+  }
+
+  if (input.method !== 'get') {
+    throw new Error('orbitRequestJson: 非 GET 且无 window.xnb.http.client 时无法回退 fetch')
+  }
+
+  const u = new URL(input.url)
+  if (input.query != null) {
+    for (const [k, v] of Object.entries(input.query)) {
+      if (v !== undefined && v !== null) {
+        u.searchParams.set(k, String(v))
+      }
+    }
+  }
+  const res = await fetch(u.toString(), {
+    method: 'GET',
+    headers: input.headers ?? { Accept: 'application/json' }
+  })
+  if (!res.ok) {
+    throw new Error(`HTTP ${String(res.status)}`)
+  }
+  return await res.json() as unknown
+}

package/skills/lab-orbit-component-builder/examples/xnb-component-template/src/utils/request.ts

@@ -0,0 +1,92 @@
+interface RequestOptions {
+  method: string
+  url: string
+  headers?: Record<string, string>
+  query?: Record<string, string | number | boolean | string[] | null | undefined>
+  body?: any
+}
+
+interface RequestResponse<T = any> {
+  data: T
+  headers: Record<string, string>
+}
+
+async function getToken (): Promise<string> {
+  try {
+    return await window.xnb.choreo.getUserToken()
+  } catch {
+    return ''
+  }
+}
+
+async function request<T = any> (options: RequestOptions): Promise<T> {
+  const token = await getToken()
+
+  const headers: Record<string, string> = {
+    'Content-Type': 'application/json',
+    ...options.headers
+  }
+  if (token) {
+    headers.Authorization = `Bearer ${token}`
+  }
+
+  const httpOptions: any = {
+    method: options.method.toUpperCase(),
+    url: options.url,
+    headers,
+    responseType: window.xnb.http.ResponseType.JSON
+  }
+
+  if (options.query) {
+    httpOptions.query = options.query
+  }
+
+  if (options.body !== undefined) {
+    httpOptions.body = window.xnb.http.Body.json(options.body)
+  }
+
+  const res: RequestResponse<T> = await window.xnb.http.client.request(httpOptions)
+  return res.data
+}
+
+export async function get<T = any> (
+  url: string,
+  query?: Record<string, string | number | boolean | string[] | null | undefined>,
+  headers?: Record<string, string>
+): Promise<T> {
+  return request<T>({ method: 'GET', url, query, headers })
+}
+
+export async function post<T = any> (
+  url: string,
+  body?: any,
+  headers?: Record<string, string>
+): Promise<T> {
+  return request<T>({ method: 'POST', url, body, headers })
+}
+
+export async function put<T = any> (
+  url: string,
+  body?: any,
+  headers?: Record<string, string>
+): Promise<T> {
+  return request<T>({ method: 'PUT', url, body, headers })
+}
+
+export async function del<T = any> (
+  url: string,
+  query?: Record<string, string | number | boolean | string[] | null | undefined>,
+  headers?: Record<string, string>
+): Promise<T> {
+  return request<T>({ method: 'DELETE', url, query, headers })
+}
+
+export async function patch<T = any> (
+  url: string,
+  body?: any,
+  headers?: Record<string, string>
+): Promise<T> {
+  return request<T>({ method: 'PATCH', url, body, headers })
+}
+
+export default request

package/skills/lab-orbit-component-builder/examples/xnb-component-template/src/views/bitable.vue

@@ -0,0 +1,65 @@
+<template>
+  <div class="orbit-quasar-host q-pa-md">
+    <q-banner v-if="openerInitError" rounded dense class="error-banner q-mb-sm">
+      {{ openerErrorText }}
+    </q-banner>
+
+    <div v-if="openerInitReady && props.xnbContext.XNBBitable" class="row items-center q-gutter-xs q-mb-sm flex-wrap">
+      <span class="text-subtitle2 q-mr-sm">超级表格</span>
+      <q-btn dense outline label="刷新" :loading="busyRefresh" :disable="!!openerInitError" @click="onRefresh" />
+      <q-btn dense outline label="检查" :loading="busyCheck" :disable="!!openerInitError" @click="onCheck" />
+      <q-btn color="primary" dense unelevated label="提交" :loading="busySubmit" :disable="!!openerInitError" @click="onSubmit" />
+      <span v-if="lastRowCount > 0" class="row-count">{{ lastRowCount }} 条</span>
+    </div>
+
+    <q-banner v-else-if="openerInitReady && !props.xnbContext.XNBBitable" rounded dense class="info-banner">
+      未注入 XNBBitable
+    </q-banner>
+  </div>
+</template>
+
+<script lang="ts" setup>
+/**
+ * 模板内演示用超级表格工具栏示例（非业务交付物）。
+ * studio-orbit-vue-component 技能：向用户目标目录产出时勿原样复制本文件；请按流程文档新建具语义的 `src/views/<业务>.vue` 并参考此处写法。
+ *
+ * 刷新 / 提交：在 `useBitablePage` 内经 Quasar 对话框确认后再执行。
+ */
+import { useBitablePage } from '@/use/useBitablePage'
+import type { XnbSuperCellContext } from '@/types/xnb-context'
+
+const props = defineProps<{
+  xnbContext: XnbSuperCellContext
+}>()
+
+const {
+  openerInitReady,
+  openerInitError,
+  openerErrorText,
+  busyRefresh,
+  busyCheck,
+  busySubmit,
+  lastRowCount,
+  onRefresh,
+  onCheck,
+  onSubmit
+} = useBitablePage(() => props.xnbContext)
+</script>
+
+<style scoped lang="scss">
+@import '@/styles/orbit-quasar-host.scss';
+
+.error-banner {
+  background: #FEF2F2;
+  border-left: 3px solid #ffbe7d;
+}
+.info-banner {
+  background: #FFFFFF;
+  border: 1px solid #E5E5E3;
+  color: #6B6B6B;
+}
+.row-count {
+  font-size: 0.75rem;
+  color: #6B6B6B;
+}
+</style>

package/skills/lab-orbit-component-builder/examples/xnb-component-template/src/views/custom-page.vue

@@ -0,0 +1,140 @@
+<!--
+  模板内演示用多区页面示例（非业务交付物）。
+  studio-orbit-vue-component 技能：向用户目标目录产出时勿原样复制本文件；请按流程文档新建具语义的 views 与 entries。
+
+  场景：复杂多组件页面（不使用超级表格 / XNBBitable）
+  入口文件名：custom-page.vue（与 xnb-components 中 id 一致）
+
+  仅占位布局：顶栏 + 侧栏 + 多卡片主区；与 bitable（超级表格 Cell）分离，后续可单独扩展。
+-->
+<template>
+  <div class="orbit-quasar-host multi-page-demo">
+    <header class="demo-header row items-center q-px-md">
+      <div class="text-weight-medium">自定义多区页面（custom-page）</div>
+      <q-space />
+      <q-chip dense outline color="grey-8">无 XNBBitable / 子 Cell</q-chip>
+    </header>
+
+    <div class="demo-body row no-wrap">
+      <aside class="demo-aside q-pa-sm">
+        <div class="text-caption text-grey-7 q-mb-sm">侧栏占位</div>
+        <q-list bordered separator dense class="rounded-borders bg-white">
+          <q-item clickable v-ripple v-for="nav in navItems" :key="nav.id">
+            <q-item-section>{{ nav.label }}</q-item-section>
+          </q-item>
+        </q-list>
+      </aside>
+
+      <main class="demo-main col q-pa-md">
+        <p class="hint q-mb-md">
+          入口文件 <code>src/views/custom-page.vue</code>。用于「多区域、多卡片、无超级表格」类页面；
+          <code>xnbContext</code> 仍可从宿主注入（见下方节选）。可与
+          <code>bitable</code> 场景独立演进。
+        </p>
+        <div class="row q-col-gutter-md">
+          <div class="col-12 col-md-4" v-for="card in cards" :key="card.id">
+            <q-card flat bordered class="full-height">
+              <q-card-section class="text-subtitle2">{{ card.title }}</q-card-section>
+              <q-card-section class="text-caption text-grey-7">{{ card.desc }}</q-card-section>
+            </q-card>
+          </div>
+        </div>
+        <q-expansion-item
+          class="q-mt-md rounded-borders bordered bg-white"
+          label="当前 xnbContext（节选）"
+          header-class="text-body2"
+          dense
+        >
+          <q-card flat>
+            <q-card-section>
+              <pre class="ctx-pre">{{ summary }}</pre>
+            </q-card-section>
+          </q-card>
+        </q-expansion-item>
+      </main>
+    </div>
+  </div>
+</template>
+
+<script lang="ts" setup>
+import { computed, withDefaults } from 'vue'
+
+export type XnbContextPageLike = {
+  bookPath?: string
+  cellUid?: string
+  [key: string]: unknown
+}
+
+const props = withDefaults(
+  defineProps<{
+    xnbContext?: XnbContextPageLike
+  }>(),
+  {
+    xnbContext: () => ({})
+  }
+)
+
+const navItems = [
+  { id: 'a', label: '模块占位 A' },
+  { id: 'b', label: '模块占位 B' },
+  { id: 'c', label: '模块占位 C' }
+]
+
+const cards = [
+  { id: '1', title: '区域 1', desc: '实际功能组件、表格或图表等可放此处。' },
+  { id: '2', title: '区域 2', desc: '与区域 1 并列，演示多列布局。' },
+  { id: '3', title: '区域 3', desc: '后续可替换为真实功能模块。' }
+]
+
+const summary = computed(() => {
+  const c = props.xnbContext || {}
+  return JSON.stringify(
+    { bookPath: c.bookPath, cellUid: c.cellUid },
+    null,
+    2
+  )
+})
+</script>
+
+<style scoped lang="scss">
+@import '@/styles/orbit-quasar-host.scss';
+
+.multi-page-demo {
+  box-sizing: border-box;
+  height: 100%;
+  display: flex;
+  flex-direction: column;
+  font-family: system-ui, -apple-system, sans-serif;
+  color: #1a1a1a;
+}
+.demo-header {
+  min-height: 48px;
+  border-bottom: 1px solid #e0e0e0;
+  background: #fafafa;
+}
+.demo-body {
+  flex: 1;
+  min-height: 0;
+  overflow: auto;
+}
+.demo-aside {
+  width: 200px;
+  flex-shrink: 0;
+  border-right: 1px solid #e0e0e0;
+  background: #fcfcfc;
+}
+.demo-main {
+  min-width: 0;
+}
+.hint {
+  margin: 0;
+  color: #555;
+  font-size: 0.9rem;
+  line-height: 1.5;
+}
+.ctx-pre {
+  margin: 0;
+  font-size: 12px;
+  overflow: auto;
+}
+</style>

package/skills/lab-orbit-component-builder/examples/xnb-component-template/tsconfig.json

@@ -0,0 +1,48 @@
+{
+  "compilerOptions": {
+    "target": "esnext",
+    "module": "esnext",
+    "strict": true,
+    "jsx": "preserve",
+    "importHelpers": true,
+    "moduleResolution": "bundler",
+    "experimentalDecorators": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "allowSyntheticDefaultImports": true,
+    "sourceMap": true,
+    "baseUrl": ".",
+    "types": ["vite/client"],
+    "paths": {
+      "@/*": ["src/*"],
+      "Views/*": ["src/views/*"],
+      "Libs/*": ["src/libs/*"],
+      "Components/*": ["src/components/*"],
+      "Api/*": ["src/api/*"],
+      "Utils/*": ["src/utils/*"],
+      "Assets/*": ["src/assets/*"],
+      "Types/*": ["src/types/*"],
+      "Plugins/*": ["src/plugins/*"]
+    },
+    "lib": [
+      "esnext",
+      "dom",
+      "dom.iterable",
+      "scripthost"
+    ]
+  },
+  "include": [
+    "src/**/*.ts",
+    "src/**/*.tsx",
+    "src/**/*.vue",
+    "dev/src/**/*.ts",
+    "dev/src/**/*.tsx",
+    "dev/src/**/*.vue",
+    "vite.config.ts",
+    "vite.dev.config.ts"
+  ],
+  "exclude": [
+    "node_modules"
+  ]
+}

package/skills/lab-orbit-component-builder/examples/xnb-component-template/vite.config.ts

@@ -0,0 +1,165 @@
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import externalGlobals from 'rollup-plugin-external-globals'
+import viteCompression from 'vite-plugin-compression'
+import cssInjectedByJsPlugin from 'vite-plugin-css-injected-by-js'
+import { resolve } from 'path'
+import { readFileSync } from 'fs'
+import type { Plugin } from 'vite'
+
+const pkg = JSON.parse(readFileSync(resolve(__dirname, 'package.json'), 'utf-8'))
+
+// ==================== 多入口组件清单 ====================
+
+interface ComponentSpec {
+  distBaseName: string
+  registrarName: string
+  label?: string
+}
+
+const COMPONENT_MAP: Record<string, ComponentSpec> = {
+  bitable: {
+    label: '超级表格 Cell（bitable）',
+    distBaseName: 'DemoOrbitBitable',
+    registrarName: 'DemoOrbitBitable'
+  },
+  'custom-page': {
+    label: '自定义多区页面（custom-page）',
+    distBaseName: 'DemoOrbitCustomPage',
+    registrarName: 'DemoOrbitCustomPage'
+  }
+}
+
+const DEFAULT_COMPONENT_ID = 'bitable'
+
+// ==================== Webb 组件包装插件 ====================
+
+function wrapComponentPlugin (funcMode: boolean): Plugin {
+  return {
+    name: 'wrap-component',
+    enforce: 'post',
+    generateBundle (_options, bundle) {
+      for (const [fileName, chunk] of Object.entries(bundle)) {
+        if (chunk.type !== 'chunk' || !fileName.endsWith('.js')) continue
+
+        const exportRegex = /export\s*\{([^}]+)\}\s*;?/
+        const match = chunk.code.match(exportRegex)
+        if (!match) continue
+
+        const mappings: Record<string, string> = {}
+        match[1].split(',').forEach((part: string) => {
+          const tokens = part.trim().split(/\s+/)
+          if (tokens.length >= 3 && tokens[1] === 'as') {
+            mappings[tokens[2]] = tokens[0]
+          } else {
+            mappings[tokens[0]] = tokens[0]
+          }
+        })
+
+        const viewVar = mappings['View'] || 'View'
+        const pkgDataVar = mappings['packageData'] || 'packageData'
+
+        if (!funcMode) continue
+
+        const componentId = process.env.VITE_COMPONENT_ID || DEFAULT_COMPONENT_ID
+        const spec = COMPONENT_MAP[componentId]
+        const compName = spec ? spec.registrarName : pkg.name
+
+        const wrapCode = [
+          'return {',
+          '  component: {',
+          `    packageData: ${pkgDataVar},`,
+          `    name: '${compName}',`,
+          `    "${spec ? spec.distBaseName : pkg.name}": ${viewVar}`,
+          '  }',
+          '}'
+        ].join('\n')
+        chunk.code = chunk.code.replace(exportRegex, wrapCode)
+      }
+    }
+  }
+}
+
+// ==================== Vite 配置 ====================
+
+export default defineConfig(({ mode }) => {
+  const funcMode = mode === 'func'
+  const componentId = process.env.VITE_COMPONENT_ID || DEFAULT_COMPONENT_ID
+  const spec = COMPONENT_MAP[componentId]
+
+  if (componentId !== DEFAULT_COMPONENT_ID && !spec) {
+    const keys = Object.keys(COMPONENT_MAP).join(', ')
+    throw new Error(`[vite.config] 未知组件 id "${componentId}"，应为: ${keys}`)
+  }
+
+  const entryFile = spec
+    ? resolve(__dirname, `src/entries/${componentId}.ts`)
+    : resolve(__dirname, 'src/index.ts')
+  const outputName = spec ? spec.distBaseName : pkg.name
+
+  return {
+    plugins: [
+      vue(),
+      cssInjectedByJsPlugin(),
+      wrapComponentPlugin(funcMode),
+      viteCompression({
+        algorithm: 'gzip',
+        ext: '.gz',
+        threshold: 30240,
+        deleteOriginFile: false
+      })
+    ],
+    resolve: {
+      alias: {
+        '@': resolve(__dirname, 'src'),
+        'Views': resolve(__dirname, 'src/views'),
+        'Libs': resolve(__dirname, 'src/libs'),
+        'Components': resolve(__dirname, 'src/components'),
+        'Api': resolve(__dirname, 'src/api'),
+        'Utils': resolve(__dirname, 'src/utils'),
+        'Assets': resolve(__dirname, 'src/assets'),
+        'Types': resolve(__dirname, 'src/types'),
+        'Plugins': resolve(__dirname, 'src/plugins')
+      }
+    },
+    css: {
+      preprocessorOptions: {
+        sass: {
+          additionalData: '@import "quasar/src/css/variables.sass"\n',
+          silenceDeprecations: ['legacy-js-api', 'import', 'global-builtin', 'slash-div']
+        },
+        scss: {
+          additionalData: '@import "quasar/src/css/variables.sass";',
+          silenceDeprecations: ['legacy-js-api', 'import', 'global-builtin', 'slash-div']
+        }
+      }
+    },
+    build: {
+      outDir: resolve(__dirname, 'dist'),
+      sourcemap: true,
+      cssCodeSplit: false,
+      minify: false,
+      lib: {
+        entry: entryFile,
+        formats: ['es'],
+        fileName: () => `${outputName}.umd.js`
+      },
+      rollupOptions: {
+        external: ['vue', 'quasar'],
+        plugins: [
+          externalGlobals({
+            vue: 'window.Vue',
+            quasar: 'window.webb.utils.quasar'
+          })
+        ],
+        onwarn (warning, warn) {
+          if (warning.code === 'UNUSED_EXTERNAL_IMPORT') return
+          warn(warning)
+        },
+        output: {
+          inlineDynamicImports: true
+        }
+      }
+    }
+  }
+})