Trae脚本使用说明提示词怎么按平台改写
坦白说,跨平台适配这件事,看着门槛不高,但踩坑的人真不少。你写好了一套Trae脚本提示词,想在飞书、钉钉、企微或者Slack上用,结果呢?飞书按钮点不了,钉钉的换行乱成一锅粥,企微的@人功能干脆不触发,Slack那边富文本被截断一半——这几乎是每个深度用户都会遇到的“日常”。
问题就出在:不同平台对消息格式、交互组件、字符限制乃至链接渲染的规则,完全是“各说各话”。你以为复制粘贴就能搞定,但它根本就不是同一套语言。
所以,核心任务只有一个:
必须按平台规范改写。
actions字段、lark_md语法),钉钉认btns和select字段,而且标题里那个空格都省不得;企微这边,菜单指令要重新写,换行还得压缩。别偷懒,这些细节直接决定了你的提示词能不能正常“跑起来”。

先确认平台基础限制
别着急写代码,先做一件事:打开对应平台的最新开发者文档,搞清楚三项硬性约束。数字很实在——飞书消息体最长4000字符,钉钉放宽到6000,但企微只给了2000字符。问题是,这三种长度里,你习惯的写法完全不一样。
再一个,所有平台都不支持HTML标签。它们只认自己那套JSON Schema。也就是说,你写个,飞书不认,钉钉也不认。只有用它们指定的字段名才能渲染出按钮——飞书叫actions,钉钉叫btns,写反了,按钮就凭空消失了。这一步如果跳过,后续所有的调试都会变成无用功。
飞书版提示词改写要点
飞书的“消息卡片”结构是它的强项,但也是坑最多的地方。方法其实有两种。
方法一:用Card Schema重写。
{"tag": "button", "text": {"content": "提交工单", "tag": "plain_text"}, "value": {"action": "submit_ticket"}}。注意,飞书不识别Markdown,所有*加粗*或者>引用块,必须转成text.tag="lark_md"并用合法语法,否则整张卡片会被系统拒收,连个错误提示都不给。
方法二:保留部分提示语,嵌入快捷指令。
/trae-approve 查看待审批列表”,飞书会自动高亮它,用户点击就能直接触发机器人指令。这算是成本最低、效果最快的适配方式。
钉钉版提示词字段映射表
钉钉的字段映射,必须按步骤走,漏一步都不行。
第一步:把“请选择类型”这种自然语言替换成钉钉的select组件。写法是这样的:{"name": "type", "title": "请选择问题类型", "options": [{"label": "权限申请", "value": "perm"}, {"label": "系统报错", "value": "error"}]}。字段名不能写错,想改选项名称除非直接改代码。
第二步:所有超链接,不能再用文字这种写法。必须改成钉钉要求的hyperlink对象,并且附带scheme校验——只有https://开头的地址才能正常跳转,http://会被静默过滤掉,用户点过去就是白屏。
第三步:消息顶部必须带一个title字段,哪怕里面只写一个空格,卡片都无法正常展开。这个空格不能省略,也不能用 代替,否则钉钉会把卡片当作文本处理,所有交互组件全部失效。
企业微信版特殊处理
企业微信是最“硬核”的平台。它不支持动态按钮,所有交互必须靠“菜单栏”或“小程序跳转”来承载。如果你的提示词里有“点击确认执行”这种动作,就必须改成:“请在下方菜单栏选择【立即执行】→ 系统将自动调用Trae脚本”。看起来多了一步,但这是唯一的通路。
还有一个容易犯的低级错误:企微对换行极其敏感。两个
会被渲染成明显的空行,三个
就直接变成段间距过大,影响阅读体验。原始提示词里的段落空行,必须全部压缩成单个
,保持紧凑。
推荐的做法是: