公鸡 AI电池使用教程
简介
公鸡 AI电池是一款基于人工智能的 Grasshopper 插件，通过自然语言指令自动生成 Python 脚本电池。只需输入中文描述，即可快速创建各种几何体、执行计算、烘焙对象等操作。
安装与登录
1. 下载与安装
在公鸡官网(www.softcn.store)下载公鸡插件并安装，重启 Rhino 即可在Grasshopper工具栏中找到"公鸡"标签页。
2. 登录
首次使用需要登录账号：
- 拖出 AI 电池，点击电池右上角的菜单按钮
- 选择登录，输入账号密码, 常用机器可记住密码
- 登录成功后即可正常使用
💡 如无账号，请前往官网 www.softcn.store 注册(新用户送30个银币, 可体验40次左右),体验完可充值金币
电池端口说明
输入端口
| 端口 | 类型 | 说明 |
|---|---|---|
| 指令 (P) | String | 自然语言指令，以"生成"开头 |
| 文件 (F) | FilePath | 可选，上传本地文件供 AI 分析 |
| 执行 (E) | Boolean | 设为 True 开始执行 |
输出端口
| 端口 | 类型 | 说明 |
|---|---|---|
| 电池 (C) | String | 创建的新组件名称 |
| 回答 (A) | String | AI 生成的 Python 代码 |
| 摘要 (S) | String | AI 返回的摘要信息 |
| 用量 (T) | Integer | 消耗的 Token 数量 |
| 费用 (C) | Number | 消耗的铜币数量 |
| 信息 (I) | String | 执行结果消息 |
基础用法
生成几何体
示例 1：生成圆
指令：生成半径默认1200的圆
执行：True
点击执行后，画布上会自动创建一个新的 Python 电池，输出一个半径为 1200mm 的圆。
示例 2：生成圆环体
指令：生成主半径1000次半径300的圆环体
执行：True
示例 3：批量生成
指令：批量生成10个半径不同的球体，从100到1000均匀分布
执行：True
几何计算
示例 4：求面积
指令：计算输入曲线的长度和包围盒面积
执行：True
示例 5：求交点
指令：计算两条曲线的交点
执行：True
生成多个独立电池
当指令中指定了数量，AI 会一次性生成多个独立的电池，放置在主电池下方。
示例 1：生成两个圆
指令：生成互相垂直的两个圆环，主半径1000次半径300
执行：True
画布上会出现两个独立的新电池，分别为 XY 平面和 YZ 平面的圆环体。
示例 2：批量生成不同几何体
指令：生成一个圆、一个方体、一个球体，半径都是500
执行：True
画布上会出现三个独立电池，分别生成圆、方体和球体。
示例 3：生成多个计算组件
指令：生成两个电池，一个计算圆的面积，一个计算周长
执行：True
| 关键词 | 效果 |
|---|---|
| 两个/三个/多个/批量 | 生成指定数量的独立电池 |
| 互相垂直/分别/各自 | 每个电池参数独立 |
> 💡 生成的多个电池之间相互独立，需要手动连线使用。
高级功能
烘焙到 Rhino
当指令中包含"烘焙"或"bake"关键词时，生成的代码会自动包含文档切换逻辑，将几何体直接烘焙到 Rhino 空间。
指令：把选中的曲线烘焙到Rhino文档
执行：True
SDK 模式 / 类封装
当指令中包含"SDK模式"、"编译模式"、"封装"、"类模式"等关键词时，生成的代码会使用面向对象的类封装方式。
指令：用SDK模式生成一个可以根据半径计算面积的圆组件
执行：True
生成的代码结构：
class MyComponent(component):
def calculate_area(self, Radius):
"""计算圆面积
Radius: 圆的半径(float)
return: 面积(float)"""
if Radius is None: Radius = 1200.0
return math.pi * Radius ** 2
def RunScript(self, Radius):
"""主入口"""
Area = self.calculate_area(Radius)
return Area
文件分析
支持上传多种文件格式供 AI 分析：
| 文件类型 | 支持格式 |
|---|---|
| 文本 | .txt, .csv, .json, .xml, .md 等 |
| 代码 | .py, .cs, .js, .html 等 |
| 图片 | .png, .jpg, .bmp, .gif 等 |
| 3D模型 | .3dm, .obj, .stl, .fbx 等 |
| CAD | .dwg, .dxf, .3ds 等 |
| 办公 | .doc, .xlsx, .pdf 等 |
指令：分析上传的CSV文件并生成对应的点云
文件：选择 data.csv
执行：True
端口类型关键词
在指令中使用以下关键词可控制输入端口的类型：
| 关键词 | 端口类型 | 示例 |
|---|---|---|
| 多个/列表/批量/一组 | list | "批量生成圆" |
| 树形/分组/多层 | tree | "分组处理树形数据" |
几何类型关键词
| 类型 | 关键词 |
|---|---|
| 点 | 点/Point3d |
| 线 | 线/直线/Line |
| 圆 | 圆/Circle |
| 曲线 | 曲线/Curve |
| 曲面 | 曲面/Surface |
| 网格 | 网格/Mesh |
| 实体 | Brep/实体/方体/球体/圆环/圆柱/圆锥 |
注意事项
⚠️ 指令格式
- 指令必须以生成关键词开头（生成/创建/制作/画/做等）
- 问问题的形式（"怎么画圆？"）会返回文字说明而非代码
⚠️ 费用说明
- 每次生成消耗铜币，根据 Token 数量计算
- 余额不足时请前往官网充值
⚠️ 执行限制
- 相同指令+相同文件会使用缓存，不重复扣费
- 异步生成时请稍候，超时时间约 30 次轮询
⚠️ 版本兼容
- 支持 Rhino 7 和 Rhino 8 及 Rhino 9
- 自动适配不同版本的 Python 组件
常见问题
Q: 生成的电池没有代码？
A: 检查网络连接和登录状态，确认余额充足后重试。
Q: 如何查看消耗明细？
A: 查看输出端口"用量"和"费用"获取本次调用的 Token 消耗和铜币费用。
Q: 可以同时生成多个电池吗？
A: 可以，指令中说明数量即可，如"生成互相垂直的两个圆环"。
联系与支持
- 官网：www.softcn.store
- 邮箱：241525449@qq.com
- 版本：2026.06.08.01