Reference
Configuration
Every key in the four configuration files: product identity, plugin manifest, DSH pin and module patch, with defaults and redaction notes.
Studio has no environment-variable configuration surface; everything lives in these four files. Changing configuration is changing code and goes through the same review.
| File | Purpose | Schema |
|---|
src/product.json | Product identity, copy and desktop packaging input | 1 |
studio.plugin.json | Plugin manifest: version, Host requirements, capabilities, contributions | — |
dsh-pin.json | DSH base pin: version, commit, patch directory | 1 |
cordis.patch.yml | Enable, disable or insert modules on top of the official DSH base | — |
Product identity and packaging input. copy is the only optional section and contributes entries per namespace and locale.
| Key | Value | Notes |
|---|
schemaVersion | 1 | Product configuration schema version |
brand.name | AgentKit Studio | Plugin display name and desktop title |
brand.shortName | AgentKit | Short name for narrow spaces |
versionSources.plugin | package.json#version | Single source of the plugin version |
versionSources.desktop | explicit-build-version-or-dsh-version | Desktop version resolution rule |
copy.<namespace>.<locale>.<key> | object | Optional product copy, supports the {productName} template |
desktop.appId | com.kingsoftcloud.agentkit-studio | Desktop App ID |
desktop.pluginRoots | @kingsoftcloud/agentkit-studio | Plugin root packages |
desktop.defaultBundles | @kingsoftcloud/agentkit-studio | Enabled by default in a new profile |
desktop.updates.environment | production | Update environment |
desktop.updates.origin | [release-origin] | Release HTTPS origin (redacted here) |
desktop.updates.channel | nightly | Update channel |
desktop.platforms.<platform>.icon | path | Platform icon, resolved relative to src/ |
desktop.platforms.<platform>.trayIcon | path | Tray icon |
| Key | Value | Notes |
|---|
id | agentkit-studio | Plugin identifier |
version | 0.0.16 | Follows package.json#version |
requiredHostApi | dsh-native/0.2.2-rc.1 | Required Host API version |
requiredDsh | 0.2.2-rc.1 | Required DSH version |
requiredHostContract | 1 | Host contract number |
capabilities | studio.agent.catalog · studio.runtime.capabilities · studio.session.adapter · studio.workspace.dock | Declared capabilities |
contributes | route · resource · command | Contribution kinds |
The DSH base pin. Raw commit SHAs and digests are internal, so this page shows placeholders; the repository file is authoritative.
| Key | Value | Notes |
|---|
schemaVersion | 1 | Pin file schema |
repository | [dsh-repository] | DSH upstream repository (redacted here) |
version | 0.2.2-rc.1 | Pinned DSH version |
ref | dsh-v0.2.2-rc.1 | Pinned tag |
commit | [commit-sha] | Pinned commit; raw SHA is not shown here |
baseCommit | [commit-sha] | Base commit |
patchedTree | [commit-sha] | Tree object after patching |
hostContract | 1 | Host contract number |
nodeRange | >=24.9.0 | Minimum Node version |
patchDirectory | patches/dsh-v0.2.2-rc.1 | Patch directory |
patchedSourceSha256 | [sha256] | Digest of the patched source |
maintenanceSource | patches/dsh-v0.2.2-rc.1/source.json | Maintenance manifest |
10 named entries and 2 insert blocks. disabled: true turns an official module off; false keeps it.
| Entry | disabled | Package | config | Location |
|---|
ui-settings-account | true | — | — | cordis.patch.yml:2 |
ui-settings-models | true | — | — | cordis.patch.yml:7 |
ui-settings-general | — | @deepseek-ai/dsh-client-ui-settings-general | welcomeNoticeVersion=2026-08-13.1 | cordis.patch.yml:12 |
ui-sidebar-browser | false | — | — | cordis.patch.yml:19 |
ui-brand-official | true | — | — | cordis.patch.yml:24 |
time-context | false | — | — | cordis.patch.yml:27 |
schedule | false | — | — | cordis.patch.yml:30 |
ui-schedule | false | — | — | cordis.patch.yml:33 |
ui-agent-preset | false | — | — | cordis.patch.yml:41 |
ui-model-selection | false | — | — | cordis.patch.yml:54 |
| Item | Value | Notes |
|---|
| Product schema | 1 | A new required key is a breaking change |
| Plugin version | 0.0.16 | Matches package.json#version |
| Host contract | 1 | Must equal dsh-pin.json#hostContract |
| DSH version | 0.2.2-rc.1 | Pinned, does not follow npm latest |
| Item | Source |
|---|
| Product config | src/product.json |
| Plugin manifest | studio.plugin.json |
| DSH pin | dsh-pin.json |
| Module patch | cordis.patch.yml |
| Product config resolver | scripts/product-config.mjs |
Related tests:
| Test file | Location |
|---|
| bundle-host.test.mjs | tests/bundle-host.test.mjs |
| managed-runtime-host.test.mjs | tests/managed-runtime-host.test.mjs |
| desktop-artifact-selection.test.mjs | tests/desktop-artifact-selection.test.mjs |
| desktop-isolation.test.mjs | tests/desktop-isolation.test.mjs |