Agent Skills
返回列表
💻

Godot 富文本与 BBCode

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/thedivergentai-gd-agentic-skills-godot-ui-rich-text。

技能介绍

问题从哪来

Godot 里大量文案落在 RichTextLabel 上:任务说明、日志、可点击的 [url]、玩家聊天。难点往往在解析与性能(每帧重拼 BBCode)、逐字演出(暂停、变速标签)、以及不可信输入把 [img]、[color=transparent] 打进界面。官方文档能查 API,但很少把「该用 visible_ratio 还是 visible_characters」「meta_clicked 里能做什么」收成可执行的约束。

技能在帮你做什么

本技能把 BBCode、meta_clicked 前缀分发和 RichTextEffect 绑成一套格式化文本系统,并附带一组可直接对照的 GDScript 参考实现:

  • 演出与控制:rich_text_typewriter_controller.gd 用 visible_characters 解析 [pause]、[speed] 等事件标签,避免用 visible_ratio 做逐字逻辑。
  • 交互与反馈:rich_text_meta_dispatch.gd 处理多前缀 URL;rich_text_hover_reactive.gd 让可点击片段有悬停与光标反馈。
  • 视觉扩展:彩虹/故障等自定义 RichTextEffect(需注册到 custom_effects / install_effect());rich_text_image_scaler.gd 让 [img] 跟行高对齐,而不是写死像素宽。
  • 安全与展示:rich_text_bbcode_sanitizer.gd 在用户生成字符串进 Label 前必须过一遍;另有自动滚动、语法高亮、渐变生成等辅助脚本。

文档里的 NEVER Do 相当于审稿清单:大循环里别反复解析超长 BBCode;打字机动画别逐帧改字符串;meta_clicked 里别塞重逻辑。

边界与习惯

内置标签如 [b]、[color] 以官方文档为准,技能侧重非显而易见的用法与决策表(例如简单整行淡入用 visible_ratio,带标签的打字机强制走 typewriter controller)。布局和表格应靠 BBCode 对齐/表格标签,不要把布局硬编码进字符串。标题级大字优先考虑 MSDF 字体,避免位图字体放大发糊。

使用场景

  • 视觉小说台词框要做逐字显示,并在句中插入 `[pause]`、`[speed]` 控制节奏
  • 大厅聊天把玩家输入显示在 `RichTextLabel` 前,需要拦截恶意 BBCode 破坏布局
  • 任务日志里物品、NPC 链接共用 `[url=payload]`,点击时要按前缀分发到不同系统
  • 成就界面或新闻条需要长文平滑纵向自动滚动,且内嵌自定义彩虹/故障文字效果

适合人员

  • 独立开发者正在用 Godot 4 做带可点击选项的对话 UI,需要分清 meta 与打字机 API
  • 负责 Godot 网游或联机大厅 UI 的程序员,要为用户输入加 BBCode 白名单净化
  • 做教育/工具类 Godot 应用的前端向 GDScript 作者,要在说明面板里嵌代码高亮与渐变标题
  • 从位图字体迁到高分辨率 UI 的技术美术,想按技能规则启用 MSDF 并统一 `[img]` 缩放