@skopon-cool/form-sdk 0.5.0 → 0.5.2

package/dist/submit/intersectPayloadBlocksWithForm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intersectPayloadBlocksWithForm.d.ts","sourceRoot":"","sources":["../../src/submit/intersectPayloadBlocksWithForm.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAG3D,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,aAAa,GAAG,QAAQ,CAAC,GAAG;IAC3F;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,EAAE,CAAA;CACxB,CAAA;AAED,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,SAAS,EAAE,CAAA;IAC1B,WAAW,EAAE,SAAS,EAAE,CAAA;IACxB,gEAAgE;IAChE,YAAY,EAAE,SAAS,EAAE,CAAA;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;CACpB;AA+ED,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,uBAAuB,GAAG,IAAI,CAmBvF;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,uBAAuB,EACnC,cAAc,EAAE,UAAU,GAAG,SAAS,GACrC,yBAAyB,CA+B3B;AA+BD,2CAA2C;AAC3C,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzF;AAED,sDAAsD;AACtD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,uBAAuB,GAAG,OAAO,CAIlF;AAED,yEAAyE;AACzE,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,uBAAuB,GAAG,SAAS,EAAE,CAO3F;AAED,4DAA4D;AAC5D,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,uBAAuB,GAAG,MAAM,EAAE,CAIvF;AAED,6DAA6D;AAC7D,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,uBAAuB,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB"}
+{"version":3,"file":"intersectPayloadBlocksWithForm.d.ts","sourceRoot":"","sources":["../../src/submit/intersectPayloadBlocksWithForm.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAG3D,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,aAAa,GAAG,QAAQ,CAAC,GAAG;IAC3F;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,EAAE,CAAA;CACxB,CAAA;AAED,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,SAAS,EAAE,CAAA;IAC1B,WAAW,EAAE,SAAS,EAAE,CAAA;IACxB,gEAAgE;IAChE,YAAY,EAAE,SAAS,EAAE,CAAA;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;CACpB;AA+ED,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,uBAAuB,GAAG,IAAI,CAmBvF;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,uBAAuB,EACnC,cAAc,EAAE,UAAU,GAAG,SAAS,GACrC,yBAAyB,CA+B3B;AA+BD,2CAA2C;AAC3C,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzF;AAED,sDAAsD;AACtD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,uBAAuB,GAAG,OAAO,CAOlF;AAED,yEAAyE;AACzE,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,uBAAuB,GAAG,SAAS,EAAE,CAQ3F;AAED,4DAA4D;AAC5D,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,uBAAuB,GAAG,MAAM,EAAE,CASvF;AAED,6DAA6D;AAC7D,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,uBAAuB,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB"}

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Skopon form rendering SDK (A2UI + form_definition) with submit helpers",
   "type": "module",
   "sideEffects": [

package/src/adapter/a2uiAdapter.test.ts

@@ -80,6 +80,88 @@ describe('a2uiAdapter blocks <-> surface', () => {
     expect(img?.mediaSize).toBe('large')
   })
 
+  it('omits empty static option blocks from nodes and dataModel', () => {
+    const doc = blocksToA2ui(
+      {
+        title: '',
+        description: '',
+        blocks: [
+          { id: 'empty', type: 'select', name: 'empty_choice', label: '空问题', options: [] },
+          { id: 'title', type: 'text', name: 'title', label: '标题' },
+        ],
+      },
+      { includeHeader: false },
+    )
+
+    expect(doc.components.find((component) => component.id === 'empty')).toBeUndefined()
+    expect(doc.dataModel).not.toHaveProperty('empty_choice')
+    expect(doc.components.find((component) => component.id === 'title')).toBeDefined()
+  })
+
+  it('keeps dynamic option blocks when their initial options are empty', () => {
+    const doc = blocksToA2ui(
+      {
+        title: '',
+        description: '',
+        blocks: [
+          { id: 'resume', type: 'resume_multiselect', name: 'resumes', options: [] },
+          { id: 'case', type: 'case_multiselect', name: 'cases', options: [] },
+        ],
+      },
+      { includeHeader: false },
+    )
+
+    expect(doc.components.find((component) => component.id === 'resume')).toBeDefined()
+    expect(doc.components.find((component) => component.id === 'case')).toBeDefined()
+  })
+
+  it('sanitizes options while converting a direct A2UI document to blocks', () => {
+    const back = a2uiToBlocks({
+      root: 'root',
+      components: [
+        { id: 'root', component: 'Column', children: ['choice'] },
+        {
+          id: 'choice',
+          component: 'SkoponSelect',
+          label: '选择',
+          options: [
+            { value: 0, label: 123 },
+            { value: {}, label: '异常' },
+            { value: 'null', label: '异常' },
+          ],
+          value: { path: '/choice' },
+        },
+      ],
+    })
+
+    expect(back.blocks[0]?.options).toEqual([{ value: '0', label: '123' }])
+  })
+
+  it('sanitizes untrusted FormBlock options while building an A2UI document', () => {
+    const doc = blocksToA2ui(
+      {
+        title: '',
+        description: '',
+        blocks: [
+          {
+            id: 'choice',
+            type: 'select',
+            name: 'choice',
+            options: [
+              { value: 0, label: 123 },
+              { value: {}, label: '异常' },
+            ] as never,
+          },
+        ],
+      },
+      { includeHeader: false },
+    )
+
+    expect(doc.components.find((component) => component.id === 'choice')?.options).toEqual([
+      { value: '0', label: '123' },
+    ])
+  })
+
   it('blocksToA2ui emits SkoponMedia for image blocks', () => {
     const doc = blocksToA2ui(makeDefinition(), { includeHeader: false })
     const imgNode = doc.components.find((c) => c.id === 'b-img')

package/src/adapter/a2uiAdapter.ts

@@ -10,6 +10,7 @@ import type {
 import { generateId } from './id'
 import { coerceToggleValue, syncFormDefinition } from './formSchema'
 import { getMediaUrls, normalizeMediaSize } from './formMedia'
+import { hasRenderableFormOptions, normalizeFormOptions } from './formOptions'
 import { getBlockTypeAdapter, getComponentAdapter } from '../blocks/registry'
 
 /**
@@ -126,7 +127,7 @@ function blockToComponent(block: FormBlock): {
   const label = block.label ?? ''
   const name = block.name?.trim() || ''
   const path = name ? pathFor(name) : undefined
-  const options = (block.options ?? []).map((o) => ({ label: o.label, value: o.value }))
+  const options = normalizeFormOptions(block.options)
 
   const withData = (node: A2uiComponentNode): {
     node: A2uiComponentNode
@@ -325,6 +326,7 @@ export function blocksToA2ui(
   }
 
   for (const block of definition.blocks ?? []) {
+    if (!hasRenderableFormOptions(block)) continue
     const { node, dataKey, dataValue } = blockToComponent(block)
     // hidden 等无节点块仍可写入 dataModel，保证「不展示仍提交」
     if (dataKey) dataModel[dataKey] = dataValue
@@ -352,18 +354,7 @@ function indexComponents(doc: A2uiSurfaceDoc): Map<string, A2uiComponentNode> {
 }
 
 function readOptions(node: A2uiComponentNode): FormBlockOption[] {
-  const raw = node.options
-  if (!Array.isArray(raw)) return []
-  return raw
-    .map((o) => {
-      if (!o || typeof o !== 'object') return null
-      const rec = o as Record<string, unknown>
-      return {
-        value: String(rec.value ?? rec.label ?? ''),
-        label: String(rec.label ?? rec.value ?? ''),
-      } as FormBlockOption
-    })
-    .filter((o): o is FormBlockOption => !!o)
+  return normalizeFormOptions(node.options)
 }
 
 /** 单个 A2UI 组件节点 -> FormBlock（无法识别返回 null） */

package/src/adapter/formOptions.test.ts

@@ -0,0 +1,60 @@
+/**
+ * @vitest-environment node
+ */
+import { describe, expect, it } from 'vitest'
+import { hasRenderableFormOptions, normalizeFormOptions } from './formOptions'
+
+describe('normalizeFormOptions', () => {
+  it('keeps trimmed strings and finite numbers in source order', () => {
+    const options = normalizeFormOptions([
+      { value: ' first ', label: ' 第一项 ' },
+      { value: 0, label: 123 },
+      { value: -1.5, label: '负数' },
+      { value: 'undefined', label: '普通文本' },
+      { value: 'first', label: '重复值仍保留' },
+    ])
+
+    expect(options).toEqual([
+      { value: 'first', label: '第一项' },
+      { value: '0', label: '123' },
+      { value: '-1.5', label: '负数' },
+      { value: 'undefined', label: '普通文本' },
+      { value: 'first', label: '重复值仍保留' },
+    ])
+  })
+
+  it('drops malformed options and unsupported value or label types without throwing', () => {
+    const malformed = [
+      null,
+      [],
+      'not-an-option',
+      { value: '', label: '空值' },
+      { value: '   ', label: '空白值' },
+      { value: 'null', label: 'null 文本' },
+      { value: ' NULL ', label: '大小写 null 文本' },
+      { value: null, label: '真正 null' },
+      { value: 'ok', label: null },
+      { value: true, label: '布尔值' },
+      { value: 'ok', label: false },
+      { value: {}, label: '对象' },
+      { value: 'ok', label: [] },
+      { value: Number.NaN, label: 'NaN' },
+      { value: Number.POSITIVE_INFINITY, label: 'Infinity' },
+      { label: '缺少 value' },
+      { value: '缺少 label' },
+    ]
+
+    expect(() => normalizeFormOptions(malformed)).not.toThrow()
+    expect(normalizeFormOptions(malformed)).toEqual([])
+  })
+})
+
+describe('hasRenderableFormOptions', () => {
+  it('hides empty static option blocks but keeps dynamic option blocks', () => {
+    expect(hasRenderableFormOptions({ type: 'select', options: [] })).toBe(false)
+    expect(hasRenderableFormOptions({ type: 'radio', options: undefined })).toBe(false)
+    expect(hasRenderableFormOptions({ type: 'resume_multiselect', options: [] })).toBe(true)
+    expect(hasRenderableFormOptions({ type: 'case_multiselect', options: [] })).toBe(true)
+    expect(hasRenderableFormOptions({ type: 'text', options: undefined })).toBe(true)
+  })
+})

package/src/adapter/formOptions.ts

@@ -0,0 +1,36 @@
+import type { FormBlock, FormBlockOption } from '../types/index'
+import { isOptionsBlockType } from '../types/index'
+
+function normalizeOptionText(raw: unknown): string | undefined {
+  if (typeof raw === 'number') {
+    return Number.isFinite(raw) ? String(raw) : undefined
+  }
+  if (typeof raw !== 'string') return undefined
+
+  const trimmed = raw.trim()
+  if (!trimmed || trimmed.toLowerCase() === 'null') return undefined
+  return trimmed
+}
+
+/** 将不可信 JSON 中的静态选项收敛为 SDK 的字符串选项契约。 */
+export function normalizeFormOptions(raw: unknown): FormBlockOption[] {
+  if (!Array.isArray(raw)) return []
+
+  const options: FormBlockOption[] = []
+  for (const item of raw) {
+    if (!item || typeof item !== 'object' || Array.isArray(item)) continue
+    const option = item as Record<string, unknown>
+    const value = normalizeOptionText(option.value)
+    const label = normalizeOptionText(option.label)
+    if (value === undefined || label === undefined) continue
+    options.push({ value, label })
+  }
+  return options
+}
+
+/** 动态简历/案例选择不属于静态 options 块，允许初始选项为空。 */
+export function hasRenderableFormOptions(
+  block: Pick<FormBlock, 'type' | 'options'>,
+): boolean {
+  return !isOptionsBlockType(block.type) || normalizeFormOptions(block.options).length > 0
+}

package/src/adapter/formSchema.test.ts

@@ -2,6 +2,7 @@
  * @vitest-environment node
  */
 import { describe, it, expect } from 'vitest'
+import type { FormBlock } from '../types/index'
 import {
   coerceToggleValue,
   createEmptyBlock,
@@ -75,6 +76,35 @@ describe('normalizeFormDefinition toggle default', () => {
   })
 })
 
+describe('normalizeFormDefinition static options', () => {
+  it('keeps an empty static question for editing but omits it from jsonSchema', () => {
+    const def = normalizeFormDefinition({
+      title: '',
+      description: '',
+      blocks: [
+        {
+          id: 'empty-choice',
+          type: 'select',
+          name: 'empty_choice',
+          label: '无有效选项',
+          required: true,
+          options: [
+            { value: null, label: '空' },
+            { value: 'null', label: 'null' },
+          ] as unknown as FormBlock['options'],
+        },
+        { id: 'title', type: 'text', name: 'title', label: '标题', required: true },
+      ],
+      jsonSchema: {},
+    })
+
+    expect(def.blocks).toHaveLength(2)
+    expect(def.blocks[0]?.options).toEqual([])
+    expect(def.jsonSchema.properties).not.toHaveProperty('empty_choice')
+    expect(def.jsonSchema.required).toEqual(['title'])
+  })
+})
+
 describe('normalizeFormDefinition preserves needLLM and editor fields', () => {
   it('keeps needLLM, hidden, condition, jsonSchemaDescription after normalize', () => {
     const def = normalizeFormDefinition({

package/src/adapter/formSchema.ts

@@ -23,6 +23,7 @@ import {
   normalizeMediaUrls,
 } from './formMedia'
 import { FORM_WEB_DEFAULT_HEIGHT, normalizeWebHeight } from './formWeb'
+import { hasRenderableFormOptions, normalizeFormOptions } from './formOptions'
 
 const DEFAULT_MEDIA_URL_MAX = 10
 
@@ -183,10 +184,7 @@ function normalizeBlock(raw: FormBlock): FormBlock {
     hidden: type === 'text' ? migrated.hidden === true : undefined,
     needLLM: migrated.needLLM === true ? true : undefined,
     options: Array.isArray(migrated.options)
-      ? migrated.options.map((opt, index) => ({
-          value: opt.value?.trim() || `option_${index + 1}`,
-          label: opt.label?.trim() || `选项 ${index + 1}`,
-        }))
+      ? normalizeFormOptions(migrated.options)
       : undefined,
     condition: migrated.condition?.fieldName
       ? {
@@ -223,7 +221,7 @@ function normalizeBlock(raw: FormBlock): FormBlock {
 }
 
 function getOptionValueSet(block: FormBlock): Set<string> {
-  return new Set((block.options ?? []).map((opt) => opt.value))
+  return new Set(normalizeFormOptions(block.options).map((opt) => opt.value))
 }
 
 function buildMultiselectCountJsonSchema(
@@ -294,13 +292,13 @@ function blockToJsonSchemaProperty(block: FormBlock): Record<string, unknown> |
     case 'select':
     case 'radio': {
       property = { type: 'string' }
-      const enumValues = (block.options ?? []).map((opt) => opt.value).filter(Boolean)
+      const enumValues = normalizeFormOptions(block.options).map((opt) => opt.value)
       if (enumValues.length > 0) property.enum = enumValues
       break
     }
     case 'multiselect':
     case 'checkbox': {
-      const enumValues = (block.options ?? []).map((opt) => opt.value).filter(Boolean)
+      const enumValues = normalizeFormOptions(block.options).map((opt) => opt.value)
       property = {
         type: 'array',
         items:
@@ -359,7 +357,7 @@ export function blocksToJsonSchema(
 
   for (const block of blocks) {
     const name = block.name?.trim()
-    if (!name || !isInputBlockType(block.type)) continue
+    if (!name || !isInputBlockType(block.type) || !hasRenderableFormOptions(block)) continue
 
     const property = blockToJsonSchemaProperty(block)
     if (!property) continue

package/src/catalog/a2uiCustomCatalog.tsx

@@ -27,6 +27,7 @@ import {
   formatFileAcceptSummary,
 } from '../adapter/formFileAccept'
 import { buildMediaListClassName, normalizeMediaSize } from '../adapter/formMedia'
+import { normalizeFormOptions } from '../adapter/formOptions'
 import {
   getRegisteredCatalogComponentNames,
   getRegisteredCatalogComponents,
@@ -77,16 +78,7 @@ function readString(value: unknown): string {
 function readOptions(
   raw: unknown,
 ): { label: string; value: string }[] {
-  if (!Array.isArray(raw)) return []
-  return raw
-    .map((item) => {
-      if (!item || typeof item !== 'object') return null
-      const rec = item as Record<string, unknown>
-      const value = String(rec.value ?? rec.label ?? '')
-      const label = String(rec.label ?? rec.value ?? '')
-      return { value, label }
-    })
-    .filter((item): item is { label: string; value: string } => !!item)
+  return normalizeFormOptions(raw)
 }
 
 interface SkoponMediaPreviewProps {
@@ -257,6 +249,8 @@ function SkoponSelectPreview({ context }: { context: ComponentContext }) {
     if (normalized !== null) setValueSilent(normalized)
   }, [isMultiple, value, setValueSilent])
 
+  if (options.length === 0) return null
+
   return (
     <div className="form-block-preview" data-skopon-field={fieldName || undefined}>
       {label ? <div className="form-block-preview-label">{label}</div> : null}
@@ -310,6 +304,8 @@ function ChoicePickerPreview({ context }: { context: ComponentContext }) {
     if (normalized !== null) setValueSilent(normalized)
   }, [isMultiplePicker, value, setValueSilent])
 
+  if (options.length === 0) return null
+
   return (
     <div className="form-block-preview" data-skopon-field={fieldName || undefined}>
       {label ? <div className="form-block-preview-label">{label}</div> : null}

package/src/catalog/invalidStaticOptions.test.tsx

@@ -0,0 +1,62 @@
+// @vitest-environment happy-dom
+import { afterEach, beforeAll, describe, expect, it, vi } from 'vitest'
+
+vi.mock('@a2ui/web_core/v0_9/basic_catalog', async (importOriginal) => {
+  const actual = await importOriginal<typeof import('@a2ui/web_core/v0_9/basic_catalog')>()
+  return { ...actual, injectBasicCatalogStyles: vi.fn() }
+})
+
+vi.mock('@a2ui/react/styles', () => ({
+  injectStyles: vi.fn(),
+  removeStyles: vi.fn(),
+}))
+
+import { createElement } from 'react'
+import { cleanup, render } from '@testing-library/react'
+import SkoponFormRenderer from '../components/SkoponFormRenderer'
+
+beforeAll(() => {
+  class ResizeObserverMock {
+    observe() {}
+    unobserve() {}
+    disconnect() {}
+  }
+  vi.stubGlobal('ResizeObserver', ResizeObserverMock)
+})
+
+afterEach(() => cleanup())
+
+describe('direct A2UI static options', () => {
+  it('does not render an invalid empty question and keeps a numeric option question', () => {
+    const doc = {
+      root: 'root',
+      components: [
+        { id: 'root', component: 'Column', children: ['invalid', 'valid'] },
+        {
+          id: 'invalid',
+          component: 'SkoponSelect',
+          label: '不应显示的问题',
+          options: [{ value: null, label: '空' }, { value: {}, label: '对象' }],
+          value: { path: '/invalid' },
+        },
+        {
+          id: 'valid',
+          component: 'ChoicePicker',
+          label: '应显示的问题',
+          options: [{ value: 0, label: 123 }],
+          value: { path: '/valid' },
+        },
+      ],
+    }
+
+    const view = render(
+      createElement(SkoponFormRenderer, {
+        doc,
+        surfaceId: 'invalid-options-test',
+      }),
+    )
+
+    expect(view.queryByText('不应显示的问题')).toBeNull()
+    expect(view.queryByText('应显示的问题')).toBeTruthy()
+  })
+})

package/src/submit/intersectPayloadBlocksWithForm.ts

@@ -1,4 +1,5 @@
 import { normalizeFormDefinition } from '../adapter/formSchema'
+import { hasRenderableFormOptions } from '../adapter/formOptions'
 import type { FormBlock, FormSchema } from '../types/index'
 import { isDisplayBlockType, isInputBlockType } from '../types/index'
 
@@ -58,7 +59,7 @@ function buildRenderBlocks(
     if (!matched) continue
     // hidden text 不上屏；提交值由 AskUser 从 matchedBlocks 提取
     if (isHiddenTextBlock(matched)) continue
-    renderBlocks.push(matched)
+    if (hasRenderableFormOptions(matched)) renderBlocks.push(matched)
   }
   return renderBlocks
 }
@@ -191,7 +192,7 @@ function blockValueFromDefault(block: FormBlock): unknown {
 export function extractExtraBlockValues(extraBlocks: FormBlock[]): Record<string, unknown> {
   const values: Record<string, unknown> = {}
   for (const block of extraBlocks) {
-    if (!isInputBlockType(block.type)) continue
+    if (!isInputBlockType(block.type) || !hasRenderableFormOptions(block)) continue
     const name = block.name?.trim()
     if (!name) continue
     values[name] = blockValueFromDefault(block)
@@ -202,7 +203,10 @@ export function extractExtraBlockValues(extraBlocks: FormBlock[]): Record<string
 /** payload 是否含至少一个具 name 的 input 块（可用于卡片 fallback） */
 export function payloadHasInputBlocks(payloadDef: PayloadBlocksDefinition): boolean {
   return payloadDef.blocks.some(
-    (block) => isInputBlockType(block.type) && Boolean(block.name?.trim()),
+    (block) =>
+      isInputBlockType(block.type) &&
+      Boolean(block.name?.trim()) &&
+      hasRenderableFormOptions(block),
   )
 }
 
@@ -211,6 +215,7 @@ export function getPayloadRenderableBlocks(payloadDef: PayloadBlocksDefinition):
   return payloadDef.blocks.filter((block) => {
     if (isDisplayBlockType(block.type)) return true
     if (!isInputBlockType(block.type) || !block.name?.trim()) return false
+    if (!hasRenderableFormOptions(block)) return false
     // hidden text 不上屏；提交值由 getPayloadHiddenBlockValues / dataModel 补齐
     return !isHiddenTextBlock(block)
   })
@@ -219,7 +224,12 @@ export function getPayloadRenderableBlocks(payloadDef: PayloadBlocksDefinition):
 /** payload 中所有 input 块 field name（fallback 提交用，含 hidden） */
 export function getPayloadInputFieldNames(payloadDef: PayloadBlocksDefinition): string[] {
   return payloadDef.blocks
-    .filter((block) => isInputBlockType(block.type) && block.name?.trim())
+    .filter(
+      (block) =>
+        isInputBlockType(block.type) &&
+        block.name?.trim() &&
+        hasRenderableFormOptions(block),
+    )
     .map((block) => block.name!.trim())
 }
 

package/src/submit/submit.test.ts

@@ -165,6 +165,32 @@ describe('intersectPayloadBlocksWithForm', () => {
     expect(extractExtraBlockValues(result.extraBlocks)).toEqual({ agent_hint: 'hint' })
   })
 
+  it('excludes empty static questions from rendering, field names, and extra values', () => {
+    const invalidOptions = [
+      { value: null, label: '空' },
+      { value: {}, label: '对象' },
+    ]
+    const payload = parsePayloadBlocksJson({
+      title: 'Ask',
+      blocks: [
+        {
+          id: 'invalid',
+          type: 'select',
+          name: 'invalid_choice',
+          label: '无效选择',
+          options: invalidOptions,
+        },
+        { id: 'valid', type: 'text', name: 'title', label: '标题' },
+      ],
+    })!
+
+    expect(payload.blocks[0]?.options).toEqual([])
+    expect(payloadHasInputBlocks(payload)).toBe(true)
+    expect(getPayloadRenderableBlocks(payload).map((block) => block.name)).toEqual(['title'])
+    expect(getPayloadInputFieldNames(payload)).toEqual(['title'])
+    expect(extractExtraBlockValues(payload.blocks)).toEqual({ title: '' })
+  })
+
   it('defaults resume_multiselect extra blocks to empty array', () => {
     const extraBlocks = [
       {
@@ -415,7 +441,13 @@ describe('payload fallback helpers', () => {
     title: '',
     blocks: [
       { id: 'title', type: 'heading', label: '问卷调查' },
-      { id: 'q1', type: 'radio', name: 'occupation', label: '职业', options: [] },
+      {
+        id: 'q1',
+        type: 'radio',
+        name: 'occupation',
+        label: '职业',
+        options: [{ value: 'operations', label: '运营' }],
+      },
     ],
   })!
 
@@ -433,7 +465,13 @@ describe('payload fallback helpers', () => {
       title: '',
       blocks: [
         { id: 'title', type: 'heading', label: '问卷调查' },
-        { id: 'q1', type: 'radio', name: 'occupation', label: '职业', options: [] },
+        {
+          id: 'q1',
+          type: 'radio',
+          name: 'occupation',
+          label: '职业',
+          options: [{ value: 'operations', label: '运营' }],
+        },
         {
           id: 'hint',
           type: 'text',