Skip to content

对interfaceV2, "option"-"type"增加"show"字段 #1221

@Quartewe

Description

@Quartewe

功能描述 / Feature Description

  • shows object[]
    仅在 type"show" 时使用。用于按顺序定义要展示的数据节点列表。

    每个节点对象支持以下字段(可按需填写):

    • name string
      节点唯一名称或标识。
    • label string
      节点显示名称。支持国际化(以$开头)。未设置时可回退显示 name
    • description string
      节点描述信息。支持文件路径、URL或直接文本,内容支持 Markdown。
    • path string
      节点内容来源。可填写相对路径(相对于 interface.json 所在目录)或直接文本。
    • mode "auto" | "md" | "json"
      展示模式,默认 "auto"
    • shows object[]
      子节点列表,支持递归嵌套。
    • cases object[]
      兼容 select/switch/checkbox 的基础结构,可作为子节点并入展示序列。
    • inputs object[]
      兼容 input 的基础结构,可作为子节点并入展示序列。

    行为约定:

    • shows 中定义顺序展示节点内容。
    • 每个节点提供展开/收起交互。
    • mode=auto 且来源为文件时:.md 按 Markdown 渲染,.json/.jsonc 以只读 JSON 卡片展示。
    • shows 仅用于前端展示,不参与 pipeline_override 合并。

sample:

        "show_progress":{
            "type": "show",
            "label": "$current_progress"
            "description": "$current_progress_description",
            "shows":[
                {
                    "name": "当前进度",
                    "label": "$current_progress_show", 
                    "description": "$current_progress_show_description", // 支持国际化
                    "path": "$current_progress_show_path", // 应支持 markdown,json等本地文件相对地址, 支持国际化
                    "mode": "auto"
                },
                { ... }
            ]
        },

MaaFramework 版本 / Version

No response

其他信息 / Additional Information

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions