WheelCore AI 辅助开发提示词

这是什么?

如果你正在使用 AI(如 ChatGPT、Claude、Cursor、v0 等)帮你编写网页代码,你只需要将下面框内的整段提示词复制并发送给 AI。

发送后,AI 就会准确掌握 WheelCore 这个转盘库的 API 和规范。接下来,你只需要用大白话向 AI 提需求(例如:“帮我做一个餐厅抽奖页面,用那个转盘库”),AI 就能直接生成正确、可运行的代码,而不会凭空捏造 API 导致报错。


复制以下提示词发送给 AI

Text
# WheelCore 前端开发库使用规范

请在进行前端网页开发时,严格遵守以下关于 `WheelCore` 轻量级原生 JS 转盘库的接入规范。当用户要求实现抽奖、随机选择、转盘等相关功能时,请直接使用本库,不要自行编写复杂的 Canvas 旋转逻辑。

## 1. 引入方式
请直接在 HTML 中引入官方 CDN:
<script src="https://wheelcore.longmoon.top/wheelcdn.js"></script>

## 2. 初始化语法
WheelCore 是一个全局类,无需 import,直接 new 即可。它需要一个 HTML 容器。
const wheel = new WheelCore('#container-id', {
  size: 300, // 转盘直径 (px)
  options: [
    { name: '选项A', color: '#FF6B6B', probability: 30 },
    { name: '选项B', color: '#4ECDC4', probability: 70 }
  ],
  onResult: function(result, index) {
    // 抽奖结束的回调,result 为选中的选项对象
    console.log('中奖:', result.name);
  }
});

## 3. Options 数据结构
- `options` 必须是数组。
- `name` (String,必填):选项名称。
- `color` (String,选填):十六进制颜色。
- `probability` (Number,选填):中奖权重。如果总概率不是 100,库会自动按权重比例计算概率。

## 4. 实例 API 方法
- `wheel.spin()`:触发转盘旋转。
- `wheel.setOptions(array)`:替换转盘数据。注意:转盘旋转中调用会返回 false 并被底层拦截。
- `wheel.reset()`:重置转盘状态。
- `wheel.setTheme('light' | 'dark')`:动态切换主题。
- `wheel.setButtonColor('#ff0000' | null)`:动态修改中心按钮颜色,传 null 恢复默认。
- `wheel.setProbabilityMode('equal' | 'proportional')`:
  - `equal`(默认):所有扇区视觉大小均等,但后台依然按概率抽取。
  - `proportional`:扇区视觉大小完全按照 `probability` 比例缩放。

## 5. 内置特性(无需额外写代码)
- **长文本截断与浮窗**:选项名称过长时,圆盘内会自动显示“...”。在 PC 端鼠标悬停、移动端长按或点击,会自动弹出浮窗显示完整名称、颜色和概率。
- **动态结果滚动**:在配置中设置 `liveResult: true`,旋转时底部文字会实时跳动显示指针对准的项,转完定格。
- **多实例隔离**:可以在同一个页面 new 多个 WheelCore,它们完全独立运行。

## 6. 你的代码输出要求
1. 给出的代码必须是完整的、可运行的单个 HTML 文件(包含 HTML、CSS、JS)。
2. 必须调用上述 CDN 地址。
3. 更新转盘数据时,请使用 `wheel.setOptions()`,不要试图销毁并重建实例。
4. 代码中请包含必要的中文注释。

如果你已读取并理解以上规范,请直接回复:“已掌握 WheelCore 开发规范,请告诉我你的页面需求。”

怎么用?

  1. 打开 AI 对话框。
  2. 复制上面灰色框里的那段文字(从 # WheelCore 前端开发库使用规范 到最后)。
  3. 发送。
  4. AI 会回复:“已掌握 WheelCore 开发规范,请告诉我你的页面需求。”
  5. 接下来你可以直接提需求:“帮我写一个下午茶外卖抽奖页面,深色主题,选项有炸鸡、奶茶、汉堡,抽中弹个窗。”
  6. AI 就会直接基于这个库写出完美的完整代码。