rongshu/.agents/skills/lark-base/references/lark-base-form-questions-create.md

base +form-questions-create

前置条件： 先阅读 ../lark-shared/SKILL.md 了解认证、全局参数和安全规则。

向多维表格表单/问卷中批量添加问题。

命令

# 添加一个文本必填问题
lark-cli base +form-questions-create \
  --base-token <base_token> \
  --table-id <table_id> \
  --form-id <form_id> \
  --questions '[{"type":"text","title":"您的姓名是？","required":true}]'

# 添加多个问题（按顺序排列）
lark-cli base +form-questions-create \
  --base-token <base_token> \
  --table-id <table_id> \
  --form-id <form_id> \
  --questions '[
    {"type":"text","title":"您的姓名是？","required":true},
    {"type":"text","title":"您的联系方式是？","required":false}
  ]'

# 添加单选题（带选项）
lark-cli base +form-questions-create \
  --base-token <base_token> \
  --table-id <table_id> \
  --form-id <form_id> \
  --questions '[{"type":"select","title":"满意度评价","required":true,"multiple":false,"options":[{"name":"非常满意","hue":"Green"},{"name":"满意","hue":"Blue"},{"name":"一般","hue":"Yellow"}]}]'

# 添加评分题
lark-cli base +form-questions-create \
  --base-token <base_token> \
  --table-id <table_id> \
  --form-id <form_id> \
  --questions '[{"type":"number","title":"服务评分","style":{"type":"rating","icon":"star","min":1,"max":5}}]'
  
# 添加带描述的问题（纯文本）
lark-cli base +form-questions-create \
  --base-token <base_token> \
  --table-id <table_id> \
  --form-id <form_id> \
  --questions '[{"type":"text","title":"您的姓名","description":"请填写真实姓名"}]'
# 添加带描述的问题（含链接）
lark-cli base +form-questions-create \
  --base-token <base_token> \
  --table-id <table_id> \
  --form-id <form_id> \
  --questions '[{"type":"text","title":"反馈建议","description":"更多详情请查看[帮助文档](https://example.com/help)"}]'  

参数

参数	必填	说明
--base-token <token>	是	多维表格 App token（base_token）
--table-id <id>	是	数据表 ID
--form-id <id>	是	表单 ID
--questions <json>	是	问题 JSON 数组，最多 10 个（见下方格式）
--format	否	输出格式：json（默认）| pretty | table | ndjson | csv
--as	否	身份：user（默认）| bot
--dry-run	否	预览 API 调用，不执行

--questions 格式

每个问题对象支持以下字段：

字段	必填	说明
title	是	问题标题（字段名）
type	是	题目类型：text、number、select、datetime、user、attachment、location
description	否	问题描述（纯文本或 Markdown 链接，如 [文本](https://example.com)）
required	否	是否必填（true/false）
option_display_mode	否	选项展示方式（仅 select 有效）：0=下拉，1=纵向（默认），2=横向
multiple	否	是否多选（select/user 类型有效，bool）
options	否	选项列表（仅 select 有效）：[{"name":"选项1","hue":"Blue"}]，hue 可选：Red/Orange/Yellow/Green/Blue/Purple/Gray
style	否	字段样式配置（见下方说明）

style 字段说明

类型	style 结构	说明
text	{"type":"plain"}	type 可选：plain（纯文本）、phone（电话）、url（链接）、email（邮件）、barcode（扫码）
number	{"type":"plain","precision":2}	precision 为小数位数
number（评分）	{"type":"rating","icon":"star","min":1,"max":5}	icon 可选：star/heart/thumbsup/fire/smile/lightning/flower/number
datetime	{"type":"plain","format":"yyyy/MM/dd"}	format 可选：yyyy/MM/dd、yyyy/MM/dd HH:mm、MM-dd、MM/dd/yyyy、dd/MM/yyyy

输出格式

返回创建成功的问题列表：

{
  "ok": true,
  "data": {
    "items": [
      {"id": "q_001", "title": "您的姓名是？", "required": true}
    ]
  }
}

工作流

[!CAUTION] 这是写入操作 — 执行前必须向用户确认。

1. 先用 +form-questions-list 查看现有问题
2. 确认要添加的问题内容
3. 执行命令并报告新建的问题 ID

参考

• lark-base — 多维表格全部命令
• lark-shared — 认证和全局参数