AgentKit Studio
参考

配置参考

四个配置文件的全部键:产品身份、插件清单、DSH 固定与模块补丁,含默认值与脱敏说明。

四个配置文件

Studio 的配置没有环境变量化的入口,全部落在这四个文件里;改配置等于改代码,走同一个 PR 评审。

文件作用schema
src/product.json产品身份、文案、桌面打包输入1
studio.plugin.json插件清单:版本、Host 要求、能力与贡献点—
dsh-pin.jsonDSH 基座固定:版本、提交、补丁目录1
cordis.patch.yml在官方 DSH 基座之上启用/禁用/插入模块—

src/product.json

产品身份与打包输入。copy 是唯一的可选段,按 namespace 与 locale 贡献词条。

键值说明
schemaVersion1产品配置 schema 版本
brand.nameAgentKit Studio插件展示名与桌面标题
brand.shortNameAgentKit窄空间简称
versionSources.pluginpackage.json#version插件版本唯一来源
versionSources.desktopexplicit-build-version-or-dsh-version桌面版本解析规则
copy.<namespace>.<locale>.<key>object可选产品文案,支持 {productName} 模板
desktop.appIdcom.kingsoftcloud.agentkit-studio桌面 App ID
desktop.pluginRoots@kingsoftcloud/agentkit-studio插件根包
desktop.defaultBundles@kingsoftcloud/agentkit-studio新 Profile 默认启用
desktop.updates.environmentproduction更新环境
desktop.updates.origin[release-origin]发行物 HTTPS 源(此处脱敏)
desktop.updates.channelnightly更新通道
desktop.platforms.<platform>.iconpath平台图标,相对 src/ 解析
desktop.platforms.<platform>.trayIconpath托盘图标

studio.plugin.json

键值说明
idagentkit-studio插件标识
version0.0.16跟随 package.json#version
requiredHostApidsh-native/0.2.2-rc.1所需 Host API 版本
requiredDsh0.2.2-rc.1所需 DSH 版本
requiredHostContract1Host 契约号
capabilitiesstudio.agent.catalog · studio.runtime.capabilities · studio.session.adapter · studio.workspace.dock声明的能力
contributesroute · resource · command贡献点类型

dsh-pin.json

DSH 基座固定。裸 commit SHA 与摘要值属于内部信息,本页统一替换为占位符,实际值以仓库文件为准。

键值说明
schemaVersion1pin 文件 schema
repository[dsh-repository]DSH 上游仓库(此处脱敏)
version0.2.2-rc.1固定的 DSH 版本
refdsh-v0.2.2-rc.1固定 tag
commit[commit-sha]固定提交,本页不展示裸 SHA
baseCommit[commit-sha]基线提交
patchedTree[commit-sha]打补丁后的树对象
hostContract1Host 契约号
nodeRange>=24.9.0Node 版本下界
patchDirectorypatches/dsh-v0.2.2-rc.1补丁目录
patchedSourceSha256[sha256]打补丁后源码摘要
maintenanceSourcepatches/dsh-v0.2.2-rc.1/source.json维护清单

cordis.patch.yml

共 10 个具名条目、2 个插入块。disabled: true 表示关掉官方模块,false 表示保留。

条目disabled包名config位置
ui-settings-accounttrue——cordis.patch.yml:2
ui-settings-modelstrue——cordis.patch.yml:7
ui-settings-general—@deepseek-ai/dsh-client-ui-settings-generalwelcomeNoticeVersion=2026-08-13.1cordis.patch.yml:12
ui-sidebar-browserfalse——cordis.patch.yml:19
ui-brand-officialtrue——cordis.patch.yml:24
time-contextfalse——cordis.patch.yml:27
schedulefalse——cordis.patch.yml:30
ui-schedulefalse——cordis.patch.yml:33
ui-agent-presetfalse——cordis.patch.yml:41
ui-model-selectionfalse——cordis.patch.yml:54

版本与兼容性

项值说明
产品 schema1新增必填键是破坏性变更
插件版本0.0.16与 package.json#version 一致
Host 契约1与 dsh-pin.json#hostContract 必须相同
DSH 版本0.2.2-rc.1固定,不跟随 npm 最新

开发者入口

内容源码位置
产品配置src/product.json
插件清单studio.plugin.json
DSH 固定dsh-pin.json
模块补丁cordis.patch.yml
产品配置解析scripts/product-config.mjs

相关测试:

测试文件位置
bundle-host.test.mjstests/bundle-host.test.mjs
managed-runtime-host.test.mjstests/managed-runtime-host.test.mjs
desktop-artifact-selection.test.mjstests/desktop-artifact-selection.test.mjs
desktop-isolation.test.mjstests/desktop-isolation.test.mjs

本页导航