地址:https://github.com/VaJoy/cocos-virtual-list (支持的话欢迎点 star
)
SKILL 使用方式
将 ./skills 文件夹放到你的项目根目录下,然后直接向 Agent 提出疑问或需求:
- “基于 cocos-virtual-list,总结下实现一个高性能虚拟列表需要留意哪些点?”
- “基于 cocos-virtual-list,修改 assets/virtual-list(替换为你的虚拟列表文件夹路径)的虚拟列表,让它支持不等高 item 的模式。”
- “修改 assets/virtual-list(替换为你的虚拟列表文件夹路径)的虚拟列表,让它支持分层渲染。”
保守起见,建议以「基于 cocos-virtual-list」开头,确保 agent 命中该 SKILL。
演示工程(基于 3.8.6)
./skills/examples/cocos-3.8.6-project-demo 是基于此 SKILL 创建的虚拟列表工程,运行时会生成 10 万条数据,但能确保在虚拟列表中顺畅滚动展示。
在「打开摄像头都会卡 10 秒」的低端红米手机上的演示:
性能/交互保障:
- 支持垂直和水平滚动模式(可根据
vertical参数修改模式)。 - 像素对齐 —— 定位走
Math.round,规避子像素采样导致 item 纹理发虚/闪烁的问题(可通过pixelAlign参数关闭此功能)。 - 只生成容器视口可见的 item + 前后缓冲的 item(默认单侧缓存 2 个,可通过
buffer参数修改)。 - item 走对象池复用。
- 高速滚动降低刷新率——飞速≈20fps、快速≈30fps、慢速≈60fps(可通过
throttle参数关闭此功能)。 - 自动统计最近几帧的耗时,识别为低性能时自动降级刷新率到 30fps(可通过
autoDowngrade参数关闭此功能)。 - 支持内置 item 点击事件。
如果有功能扩展需要,可以基于此 SKILL 对其进行二次改造。
想尝试 Agent 的可以来 workbuddy 薅羊毛, 新用户送 2600 积分,每天签到又送 100 积分,搭配 ds v4 flash 可以用很久。

如果有功能扩展需要,可以基于此 SKILL 对其进行二次改造。
