unity-importer（Unity importer 搜索）

Unity Importer Skills

Use this module to change import settings for textures, audio, and models that already exist in the project.

Batch-first: Prefer the batch setters when configuring 2+ assets of the same category.

Guardrails

Mode: Full-Auto required

DO NOT (common hallucinations):

• importer_import does not exist -> use asset_import in the asset module to bring files into the project
• importer_set_format does not exist -> use the specific texture/audio/model setters
• importer_get_settings does not exist -> use the category-specific getters
• Settings changes do not always apply instantly in memory. Reimport may still be required

Routing:

• File import or refresh -> asset
• Texture settings -> texture_*
• Audio settings -> audio_*
• Model settings -> model_*
• Alternative importer bridge skills -> texture_set_import_settings, audio_set_import_settings, model_set_import_settings
• Force importer refresh -> asset_reimport or asset_reimport_batch

Skills

Texture Route

Import settings:

Query and runtime info:

Typed / platform overrides:

Common texture decisions:

• UI sprites -> textureType="Sprite", usually mipmapEnabled=false
• Pixel art -> filterMode="Point"
• Runtime CPU reads -> readable=true only when necessary
• Platform-tuned builds -> prefer texture_set_platform_settings over global texture_set_settings

Audio Route

Import settings:

Clip query and info:

Scene runtime (AudioSource / AudioMixer):

Common audio decisions:

• Long BGM -> loadType="Streaming"
• Short SFX -> loadType="DecompressOnLoad"
• Memory-sensitive SFX libraries -> consider forceToMono=true
• Scene-side AudioSource tuning -> prefer audio_set_source_properties over manual component edits

Model Route

Import settings:

Query and info:

Animation and rig:

Common model decisions:

• Characters -> animationType="Humanoid" when retargeting is required
• Static props -> disable cameras/lights/animation imports when unused
• Baked-lighting meshes -> enable secondary UVs when appropriate
• After model_set_rig or model_set_animation_clips -> call asset_reimport to refresh clips and avatar

Reimport Rule

After importer changes, use reimport when you need Unity to fully refresh the asset:

Minimal Example

import unity_skills

unity_skills.call_skill("texture_set_settings_batch", items=[
    {"assetPath": "Assets/UI/icon_play.png", "textureType": "Sprite", "mipmapEnabled": False},
    {"assetPath": "Assets/UI/icon_pause.png", "textureType": "Sprite", "mipmapEnabled": False}
])

unity_skills.call_skill("audio_set_settings",
    assetPath="Assets/Audio/bgm.mp3",
    loadType="Streaming",
    compressionFormat="Vorbis",
    quality=0.7
)

unity_skills.call_skill("asset_reimport", assetPath="Assets/Audio/bgm.mp3")

Exact Signatures

Exact names, parameters, defaults, and returns are defined by GET /skills/schema or unity_skills.get_skill_schema(), not by this file. Load IMPORT_REFERENCE.md for extended asset search/query helpers, platform overrides, rig/animation details, and importer-side best practices.