المهارات react-flow-node-ts
📦

react-flow-node-ts

آمن

使用 TypeScript 构建 React Flow 节点组件

创建可视化工作流编辑器需要一致的节点组件模式。此技能提供具有正确类型定义、句柄和 Zustand 状态集成的 TypeScript 模板。

يدعم: Claude Codex Code(CC)
🥉 74 برونزي
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "react-flow-node-ts". 创建一个带有播放控制功能的 VideoNode 组件

النتيجة المتوقعة:

  • TypeScript 接口:VideoNodeData,带有 videoUrl、thumbnail 和 duration 字段
  • React 组件:VideoNode,带有 memo、句柄和视频播放器 UI
  • 集成清单:在 React Flow 画布中注册节点的 6 个步骤

استخدام "react-flow-node-ts". 生成一个 FormNode 用于在工作流中收集用户输入

النتيجة المتوقعة:

  • 类型定义:FormNodeData,带有 formFields 数组和 submitAction
  • 组件:FormNode,基于 canvasMode 的条件编辑/查看模式
  • 状态集成:用于字段值更改的 updateNode 调用

التدقيق الأمني

آمن
v1 • 2/24/2026

Static analyzer flagged 20 patterns as potential security issues, but all are false positives. The 'external_commands' detections (14) are Markdown code block backticks used for documentation formatting, not shell execution. The 'weak cryptographic algorithm' findings (6) are misidentified text patterns with no actual cryptographic code present. This skill is a documentation template for creating React Flow node components and poses no security risk.

1
الملفات التي تم فحصها
72
الأسطر التي تم تحليلها
0
النتائج
1
إجمالي عمليات التدقيق
لا توجد مشكلات أمنية
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
50
المجتمع
100
الأمان
91
الامتثال للمواصفات

ماذا يمكنك بناءه

可视化工作流构建器

为拖放式工作流编辑器创建自定义节点,用户可以连接块来定义自动化序列。

图表和流程图编辑器

构建具有自定义节点类型的交互式图表工具,用于技术文档或流程映射应用程序。

数据管道可视化器

为数据处理管道设计可视化界面,其中每个节点代表转换或数据源。

جرّب هذه الموجهات

基础节点组件
创建一个名为 'ProcessNode' 的 React Flow 节点组件,带有标题和状态指示器。包���用于连接的目标和源句柄。
数据��动节点
生成一个 'DataNode' 组件,显示来自节点 data 属性的动态数据。包括带有可选字段的数据结构的 TypeScript 接口。
带有状态管理的交互式节点
创建一个 'ConfigNode' 组件,使用 useAppStore 读取 canvasMode 并更新节点属性。包括仅在编辑模式下可见的调整大小句柄。
完整节点集成
生成 'DecisionNode' 所需的所有文件,包括:类型定义、带有条件渲染的组件、状态默认值和菜单注册步骤。

أفضل الممارسات

  • 始终使用 memo 包装节点组件,以防止在画布交互期间不必要的重新渲染
  • 为 Node 类型使用 TypeScript 泛型,以确保整个应用程序中的类型安全数据访问
  • 在显示交互元素之前检查 canvasMode,以防止在画布平移期间发生冲突

تجنب

  • 避免在节点组件中直接操作 DOM - 改用 React 状态和属性
  • 不要跳过 TypeScript 类型定义 - 它们对于捕获数据结构错误至关重要
  • 永远不要直接修改节点数据 - 始终��用 updateNode 等状态操作来进行状态更改

الأسئلة المتكررة

什么是 React Flow,何时应该使用此技能?
React Flow 是一个用于构建基于节点的交互式编辑器的 React 库。当您需要超出默认矩形节点的自定义节点类型时,请使用此技能。
我需要安装额外的依赖项吗?
是的,您需要 reactflow (或 @xyflow/react) 用于核心组件,以及 Zustand 用于状态管理。该技能假定这些已经设置。
我可以自定义生成节点的视觉外观吗?
是的,模板提供了结构模式。您可以自定义内部 div 内容、CSS 类和样式以匹配您的设计系统。
多个句柄如何用于复杂连接?
添加多个具有唯一 id 属性的 Handle 组件。将它们定位在 Top、Bottom、Left 或 Right。使用 id 来识别哪个句柄触发了连接。
NodeResizer 的目的是什么?
NodeResizer 在可见时在您的节点周围提供调整大小句柄。它通常仅在选中节点且画布处于编辑模式时显示。
如何处理节点交互,如点击或编辑?
向节点内的元素添加 onClick 处理程序。使用状态的 updateNode 操作来持久化更改。从节点属性访问 selected 状态以进行条件样式设置。

تفاصيل المطور

المؤلف

sickn33

الترخيص

MIT

مرجع

main

بنية الملفات

📄 SKILL.md