用途:Velt Arrows 的方向箭头标注让用户把箭头钉在 DOM 元素或其局部区域上,用于视觉反馈、设计评审和协同指向。本技能提供该功能的实现指南,适用于在 React、Next.js 或 HTML 应用中搭建 Velt Arrows 时参考。
主要能力与规则分类:按优先级分为三组。API 与设置(api-,HIGH):放置根组件 VeltArrows(或 velt-arrows)与触发组件 VeltArrowTool(或 velt-arrow-tool),调用 client.getArrowElement() 获取 ArrowElement 句柄,使用自定义按钮的子插槽模式。配置(config-,HIGH):通过 allowedElementIds 属性或 arrowElement.allowedElementIds() 方法限制可绘制箭头的元素,启用 darkMode,并用 CSS ::part(container | button-container | button-icon) 钩子定制箭头工具样式。类型(types-,MEDIUM):ArrowAnnotation(含 annotationId、from、color、targetElement、position、locationId、location、props、annotationIndex、pageInfo)与 AnnotationProperty(视口尺寸、arrowLength、arrowAngle)。
使用方式:阅读各规则文件(rules/shared/api/api-setup.md、rules/shared/config/config-customize.md、rules/shared/types/types-arrow-annotation.md),每条规则包含原因说明、React/Next.js 与其他框架示例、常见陷阱、验证清单与官方文档指向。可从 AGENTS.md 压缩索引开始,或查看 AGENTS.full.md 完整指南。SDK 基础设置(VeltProvider、认证、文档标识)请参考 velt-setup-best-practices,与其他 Velt 功能重叠的 UI 定制概念请参考 velt-comments-best-practices。
限制:已知限制是箭头暂不提供 velt-...-wireframe 注册,因此 Comments、Activity、Notifications wireframe 上可用的 velt-data / velt-if / velt-class 模板变量系统目前不支持 Arrows;在 wireframe 标签注册发布前,只能通过 CSS parts 和自定义按钮插槽进行定制。资料未提供安装命令与具体代码示例全文。