Core Concepts

Extension Runtime

What Extension is, where it runs, and how to operate it

Extension Runtime

Extension is the runtime module type for optional feature plugins.

Typical built-in extension:

voice

What Extension is responsible for

Provide extension lifecycle and command forwarding via city extension ...
Expose HTTP control and command routes under /api/extensions/*
Keep extension-specific config in console-global ~/.ship/ship.db under extensions_config.*

Operational commands

city extension list
city extension status voice
city extension restart voice
city extension command voice status --payload '{}'

If you are operating speech models directly, use:

city voice models
city voice on SenseVoiceSmall

Service Runtime

What Service is, where it runs, and how to operate it

Runtime Relationship & Process

Collaboration model and process order across console, agent, service, and extension

Table of Contents

Extension Runtime What Extension is responsible for Operational commands Related docs