hand-line-draw

用途：对预设的 SVG 路径执行手绘线条的描边生长动画，常见于运动轨迹、箭头标注和方向性下划线。它与 squiggle-draw-on 的区别在于：后者现场生成带抖动的自由波浪路径，而 hand-line-draw 跟随预先计算好的路径（通常由移动元素留下的轨迹）。主要能力：可设置 SVG 路径 d 属性、描边颜色、线宽、线端与连接样式、绘制时长（帧）、缓动曲线、起始帧，以及是否在路径末端渲染箭头及箭头尺寸；可选 follows_element 字段让路径跟踪某元素的关键帧位置，用于元素交接轨迹。使用方式：通过参数对象传入 path_d、stroke_color、stroke_width_px、stroke_linecap、stroke_linejoin、draw_duration_frames、draw_easing、draw_start_frame、arrow_tip、arrow_tip_size_px、follows_element。行为上先按 stroke-dasharray 等于路径长度、stroke-dashoffset 按进度偏移来渲染，再在指定帧数内将进度从 0 动画到 1；若开启箭头，则依据路径末端切线方向绘制箭头。风格包覆盖：SP-G（riso-illustration）用作移动对象身后的运动线，SP-B、SP-E 用作方向性箭头标注。质量检查：路径需落在画布边界内；描边动画应在 draw_start_frame 加 draw_duration_frames 之前完成；箭头端点须与路径切线对齐。限制与故障模式：线条未生长通常是 stroke-dasharray 设置不当，应使用 getTotalLength() 测量；箭头偏离路径多因硬编码角度，应在实际路径末端坐标计算切线。具体平台与性能等资料暂未提供。