unity-smart

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Unity Smart Skills

Unity智能技能

Guardrails

使用规范

Mode: Full-Auto required

DO NOT (common hallucinations):

```
smart_create
```
/
```
smart_build
```
do not exist → smart skills are query/layout tools, not creation tools
```
smart_search
```
does not exist → use
```
smart_query
```
for SQL-like scene queries

smart_move

does not exist → use

smart_snap_to_grid

smart_align_to_ground

Routing:

For creating objects → use
```
gameobject
```
module
For simple object search → use
```
gameobject_find
```
or
```
scene_find_objects
```
For complex scene queries (SQL-like) →
```
smart_query
```
(this module)

模式：需设置为全自动

禁止操作（常见错误）：

```
smart_create
```
/
```
smart_build
```
不存在 → 智能技能是查询/布局工具，而非创建工具
```
smart_search
```
不存在 → 请使用
```
smart_query
```
进行类SQL场景查询

smart_move

不存在 → 请使用

smart_snap_to_grid

或

smart_align_to_ground

路由指引：

创建对象 → 使用
```
gameobject
```
模块
简单对象搜索 → 使用
```
gameobject_find
```
或
```
scene_find_objects
```
复杂场景查询（类SQL） →
```
smart_query
```
（本模块）

Skills

技能列表

smart_scene_query

Find objects based on component property values (SQL-like).

Parameter	Type	Required	Default	Description
`componentName`	string	Yes	-	Component type (Light, Camera, MeshRenderer)
`propertyName`	string	Yes	-	Property to query (intensity, enabled, etc.)
`op`	string	No	"=="	==, !=, >, <, >=, <=, contains
`value`	string	No	null	Value to compare
`limit`	int	No	50	Max results
`query`	string	No	null	Unsupported shorthand; if provided alone returns a guidance error

Example:

python

undefined

根据组件属性值查找对象（类SQL）。

参数	类型	必填	默认值	描述
`componentName`	string	是	-	组件类型（Light、Camera、MeshRenderer）
`propertyName`	string	是	-	要查询的属性（intensity、enabled等）
`op`	string	否	"=="	==、!=、>、<、>=、<=、contains
`value`	string	否	null	要比较的值
`limit`	int	否	50	最大结果数
`query`	string	否	null	不支持的简写形式；若单独传入会返回指引错误

示例：

python

undefined

Find all lights with intensity > 2

查找所有强度大于2的灯光

call_skill("smart_scene_query", componentName="Light", propertyName="intensity", op=">", value="2")

---

call_skill("smart_scene_query", componentName="Light", propertyName="intensity", op=">", value="2")

---

smart_scene_layout

Organize selected objects into a layout.

Parameter	Type	Required	Default	Description
`layoutType`	string	No	"Linear"	Linear, Grid, Circle, Arc
`axis`	string	No	"X"	X, Y, Z, -X, -Y, -Z
`spacing`	float	No	2.0	Space between items (or radius)
`columns`	int	No	3	For Grid layout
`arcAngle`	float	No	180	For Arc layout (degrees)
`lookAtCenter`	bool	No	false	Rotate to face center

Example:

python

undefined

将选中的对象整理为指定布局。

参数	类型	必填	默认值	描述
`layoutType`	string	否	"Linear"	Linear（线性）、Grid（网格）、Circle（圆形）、Arc（弧形）
`axis`	string	否	"X"	X、Y、Z、-X、-Y、-Z
`spacing`	float	否	2.0	项目间距（或半径）
`columns`	int	否	3	适用于Grid布局
`arcAngle`	float	否	180	适用于Arc布局（度数）
`lookAtCenter`	bool	否	false	旋转至朝向中心

示例：

python

undefined

Arrange selected objects in a circle

将选中对象排列为圆形

call_skill("smart_scene_layout", layoutType="Circle", spacing=5)

---

call_skill("smart_scene_layout", layoutType="Circle", spacing=5)

---

smart_reference_bind

Auto-fill a List/Array field with matching objects.

Parameter	Type	Required	Default	Description
`targetName`	string	Yes	-	Target GameObject
`componentName`	string	Yes	-	Component on target
`fieldName`	string	Yes	-	Field to fill
`sourceTag`	string	No	null	Find by tag
`sourceName`	string	No	null	Find by name contains
`appendMode`	bool	No	false	Append instead of replace

Example:

python

undefined

自动用匹配对象填充List/Array字段。

参数	类型	必填	默认值	描述
`targetName`	string	是	-	目标GameObject
`componentName`	string	是	-	目标对象上的组件
`fieldName`	string	是	-	要填充的字段
`sourceTag`	string	否	null	按标签查找
`sourceName`	string	否	null	按名称包含查找
`appendMode`	bool	否	false	追加而非替换

示例：

python

undefined

Fill GameManager.spawns with all SpawnPoint tagged objects

将所有带有SpawnPoint标签的对象填充到GameManager的spawns字段中

call_skill("smart_reference_bind", targetName="GameManager", componentName="GameController", fieldName="spawns", sourceTag="SpawnPoint")

---

call_skill("smart_reference_bind", targetName="GameManager", componentName="GameController", fieldName="spawns", sourceTag="SpawnPoint")

---

smart_scene_query_spatial

smart_scene_query_spatial

Find objects within a sphere/box region, optionally filtered by component.

Parameter	Type	Required	Default	Description
`x`	float	Yes	-	Center X coordinate
`y`	float	Yes	-	Center Y coordinate
`z`	float	Yes	-	Center Z coordinate
`radius`	float	No	10	Search sphere radius
`componentFilter`	string	No	null	Only include objects with this component
`limit`	int	No	50	Max results

Returns:

{ success, count, center, radius, results }

查找球体/盒子区域内的对象，可按组件筛选。

参数	类型	必填	默认值	描述
`x`	float	是	-	中心X坐标
`y`	float	是	-	中心Y坐标
`z`	float	是	-	中心Z坐标
`radius`	float	否	10	搜索球体半径
`componentFilter`	string	否	null	仅包含带有该组件的对象
`limit`	int	否	50	最大结果数

返回值：

{ success, count, center, radius, results }

smart_align_to_ground

smart_align_to_ground

Raycast selected objects downward to align them to the ground. Requires objects selected in Hierarchy first.

Parameter	Type	Required	Default	Description
`maxDistance`	float	No	100	Maximum raycast distance
`alignRotation`	bool	No	false	Align rotation to surface normal

Returns:

{ success, aligned, total }

向下射线检测选中对象，使其对齐地面。需先在层级面板中选中对象。

参数	类型	必填	默认值	描述
`maxDistance`	float	否	100	最大射线检测距离
`alignRotation`	bool	否	false	对齐旋转至表面法线

返回值：

{ success, aligned, total }

smart_distribute

smart_distribute

Evenly distribute selected objects between first and last positions. Requires at least 3 objects selected in Hierarchy first.

Parameter	Type	Required	Default	Description
`axis`	string	No	"X"	X, Y, Z, -X, -Y, -Z

Returns:

{ success, distributed, axis }

在第一个和最后一个对象的位置之间均匀分布选中对象。需先在层级面板中选中至少3个对象。

参数	类型	必填	默认值	描述
`axis`	string	否	"X"	X、Y、Z、-X、-Y、-Z

返回值：

{ success, distributed, axis }

smart_snap_to_grid

smart_snap_to_grid

Snap selected objects to a grid.

Parameter	Type	Required	Default	Description
`gridSize`	float	No	1	Grid cell size

Returns:

{ success, snapped, gridSize }

将选中对象对齐到网格。

参数	类型	必填	默认值	描述
`gridSize`	float	否	1	网格单元格大小

返回值：

{ success, snapped, gridSize }

smart_randomize_transform

smart_randomize_transform

Randomize position/rotation/scale of selected objects within ranges.

Parameter	Type	Required	Default	Description
`posRange`	float	No	0	Position randomization range
`rotRange`	float	No	0	Rotation randomization range (degrees)
`scaleMin`	float	No	1	Minimum uniform scale
`scaleMax`	float	No	1	Maximum uniform scale

Returns:

{ success, randomized }

在指定范围内随机化选中对象的位置/旋转/缩放。

参数	类型	必填	默认值	描述
`posRange`	float	否	0	位置随机化范围
`rotRange`	float	否	0	旋转随机化范围（度数）
`scaleMin`	float	否	1	最小统一缩放比例
`scaleMax`	float	否	1	最大统一缩放比例

返回值：

{ success, randomized }

smart_replace_objects

smart_replace_objects

Replace selected objects with a prefab (preserving transforms). Requires objects selected in Hierarchy first.

Parameter	Type	Required	Default	Description
`prefabPath`	string	Yes	-	Asset path to the replacement prefab

Returns:

{ success, replaced, prefab }

用预制体替换选中对象（保留变换属性）。需先在层级面板中选中对象。

参数	类型	必填	默认值	描述
`prefabPath`	string	是	-	替换预制体的资源路径

返回值：

{ success, replaced, prefab }

smart_select_by_component

smart_select_by_component

Select all objects that have a specific component.

Parameter	Type	Required	Default	Description
`componentName`	string	Yes	-	Component type name to search for

Returns:

{ success, selected, component }

选中所有带有指定组件的对象。

参数	类型	必填	默认值	描述
`componentName`	string	是	-	要搜索的组件类型名称

返回值：

{ success, selected, component }

Exact Signatures

精确签名

Exact names, parameters, defaults, and returns are defined by

GET /skills/schema

unity_skills.get_skill_schema()

, not by this file.

精确的名称、参数、默认值和返回值由

GET /skills/schema

或

unity_skills.get_skill_schema()

定义，而非本文件。

unity-smart

Original

Translation

Unity Smart Skills

Unity智能技能

Guardrails

使用规范

Skills

技能列表

smart_scene_query

smart_scene_query

Find all lights with intensity > 2

查找所有强度大于2的灯光

smart_scene_layout

smart_scene_layout

Arrange selected objects in a circle

将选中对象排列为圆形

smart_reference_bind

smart_reference_bind

Fill GameManager.spawns with all SpawnPoint tagged objects

将所有带有SpawnPoint标签的对象填充到GameManager的spawns字段中

`smart_scene_query_spatial`

`smart_scene_query_spatial`

`smart_align_to_ground`

`smart_align_to_ground`

`smart_distribute`

`smart_distribute`

`smart_snap_to_grid`

`smart_snap_to_grid`

`smart_randomize_transform`

`smart_randomize_transform`

`smart_replace_objects`

`smart_replace_objects`

`smart_select_by_component`

`smart_select_by_component`

Exact Signatures

精确签名