SuperAPI AI 工具集

dingtalk-aicard

设计与创作

查看项目

更新于 10-15 21:10

技能介绍

用途:离线创建、编辑和校验钉钉 AI 卡片(A2UI)JSON 文件,适用于按需求或图片构建卡片、排查结构协议错误、查询命名契约,以及发送、预览或更新卡片。基于钉钉 V0.8 包(A2UI 1.0),消息版本为 v1.0,发送 API 的 protocolVersion 为 1.0。

主要能力:按意图路由,只读取相关参考,不预加载完整协议。支持从内容或图片创建/重设计卡片、查询已知或未知的组件/函数/Token 名称、构建与修复卡片、发送预览更新。组合模式涵盖通知提醒、对象事实与决策、图文内容与附件、指标报告、可编辑输入与提交、生成与执行进度。

使用方式:本版使用原生 DWS 命令而非 Python,需确认 dws aicard --help 暴露 explain、lint、preview;复制技能不会安装命令。查询与 lint 离线进行,无需 Profile。示例:dws aicard explain Tabs --format json;dws aicard lint --file card.a2ui.json --format json。完整新卡片需 Surface 创建、根数据初始化(静态内容也需 {})和 id 为 root 的组件,同一卡片保持相同 surfaceId。发送仅在要求时进行,需在发送 Profile 下解析唯一目标(--conversation-id 或 --open-dingtalk-id),将消息字符串数组 JSON 编码为单个 --content 参数,调用 dws chat message send-a2ui-card。更新用 dws chat message update-a2ui-card --biz-id <bizId> --content <message-strings> --flow-status <state>。预览用 dws aicard preview --file card.a2ui.json,--dry-run 不发送。

限制:lint 检查语法与 Schema 字段;new-card preflight 额外检查初始化、root、消息内重复 ID、最终组件快照的静态引用与循环,不检查每个中间流式帧;resource preflight 检查内联编码;两者都不评估绑定或证明图片加载。本地校验与请求受理不能证明客户端渲染,需在同 Profile 与目标下回读确认,否则标记为未验证。不确定结果须先检查再重试,不得自动重发。不要静默改写用户数据、删除请求组件或降级交互以通过检查。发送前替换 REPLACE_* 占位符,演示数据需标注。