AgentKit Studio
参考

命令参考

56 个 make 目标与 100 个校验脚本的完整清单,含依赖关系、平台支持与源码位置。

命令入口

仓库有两个执行面:Makefile 的 56 个目标(默认目标 check),以及 scripts/ 下的 100 个校验脚本。

入口条数什么时候用
make <target>56日常开发、打包、门禁;目标带依赖与平台检查
node scripts/verify-*.mjs100单点校验;门禁目标内部也是调它们
node scripts/*.mjs204构建、发布、代码生成等非校验脚本

先看依赖

make 目标大多有前置依赖(例如 web-dev 依赖 profile-install)。直接跑依赖链比手动按顺序敲命令安全。

平台支持

桌面端只发布 macOS arm64 与 Windows x64 构建。仓库里另有 2 个面向 Intel Mac 的遗留目标,不属于受支持路径,因此不在下面的清单里。

平台架构状态
macOSarm64受支持,发布 .dmg
Windowsx64受支持,发布 NSIS .exe
macOSIntel不受支持,文档与发布物里都不出现

make 目标

全部 56 个受支持目标,按定义顺序。空依赖显示为 —。

目标依赖说明位置
make setup—初始化开发环境:装依赖、打补丁、构建 Host、安装插件Makefile:43
make dev—启动本地开发服务器Makefile:53
make doctor—检查工具链、Host 修订、构建产物与已装插件Makefile:56
make cloud-identity—验证云端身份配置Makefile:62
make check—默认门禁:lint、类型与单元测试Makefile:72
make dsh-pin-check—校验 dsh-pin.json 与宿主一致Makefile:75
make client-module-gate—客户端模块边界门禁Makefile:80
make client-build—构建客户端产物Makefile:84
make test—运行单元测试Makefile:87
make public-surface-audit—审计公开边界与敏感信息Makefile:90
make secret-scan—扫描凭证泄漏Makefile:95
make public-gate—公开边界总门禁Makefile:100
make ref-parity—校验两条分支的引用一致性Makefile:113
make pack—打出插件 tarballMakefile:118
make release-checkpublic-gate发布前总检查Makefile:122
make runtime-source-stage—暂存运行时源码Makefile:127
make patch-format-check—校验补丁格式Makefile:131
make patch-manifest-check—校验补丁清单Makefile:135
make patch-source-check—校验补丁源码Makefile:141
make patch-source-verify—校验补丁源码摘要Makefile:144
make patch-source-import—导入补丁源码Makefile:147
make patch-source-export—导出补丁源码Makefile:151
make verify-patched-host—验证打补丁后的 HostMakefile:155
make dsh-bootstrap—拉取并构建 DSH 基座Makefile:162
make profile-installpack把插件装进目标 ProfileMakefile:176
make profile-check—检查 Profile 状态Makefile:196
make patch-check—校验补丁能否应用Makefile:203
make patch-applypatch-check应用补丁Makefile:210
make verify-dsh—验证 DSH 基座Makefile:213
make verify-dsh-lifecycle—验证 DSH 生命周期Makefile:218
make verify-dsh-live-runtime—用真实运行时验证 DSHMakefile:222
make verify-studio-plugin-lifecycle—验证插件生命周期Makefile:227
make verify-studio-desktop-dev—验证桌面开发运行时Makefile:231
make verify-desktop-update—验证桌面更新Makefile:235
make verify-desktop-differential—差分验证桌面产物Makefile:240
make verify-desktop-artifact—验证桌面安装包Makefile:244
make verify-dsh-sdk—验证 DSH SDK 契约Makefile:248
make web-buildclient-build构建 Web 客户端Makefile:254
make web-devprofile-install构建并启动 Web 开发环境Makefile:260
make web-startweb-dev启动已构建的 Web 客户端Makefile:265
make desktop-buildclient-build构建桌面产物Makefile:269
make desktop-dev—构建并启动桌面开发运行时Makefile:275
make desktop-startclient-build启动已构建的桌面运行时Makefile:279
make desktop-package-preflightpack桌面打包预检Makefile:284
make desktop-package-mac-arm64desktop-package-preflight打 macOS arm64 签名安装包Makefile:291
make desktop-package-mac-arm64-unsigneddesktop-package-preflight打 macOS arm64 未签名包Makefile:296
make desktop-package-mac-arm64-dirdesktop-package-preflight打 macOS arm64 目录形态(不装包)Makefile:300
make desktop-package-win-x64desktop-package-preflight打 Windows x64 安装包Makefile:313
make desktop-package-win-x64-unsigneddesktop-package-preflight打 Windows x64 未签名包Makefile:316
make desktop-check-package—检查桌面安装包Makefile:319
make docs-site-build—静态导出文档站Makefile:326
make docs-site-dev—本地起文档站开发服务器Makefile:330
make docs-site-check—文档站门禁:双语、链接与生成器Makefile:333
make docs-site-previewdocs-site-build预览已导出的文档站Makefile:336
make cipublic-gateCI 总入口Makefile:341
make clean—清理构建产物与临时目录Makefile:343

校验脚本

scripts/verify-*.mjs 共 100 个(顶层 99 个,另有 1 个在子目录),按文件名第二段分成 23 个家族。每个脚本的具体用途写在文件头注释里。

家族条数脚本验收什么
studio39verify-studio-catalog-ui.mjs verify-studio-client-pages-ui.mjs verify-studio-client-state-ui.mjs verify-studio-desktop-dev.mjs verify-studio-dsh-a2a-controls.mjs verify-studio-frozen-host.mjs verify-studio-host-startup.mjs verify-studio-http-scope.mjs verify-studio-native-a2a-busy-cancel.mjs verify-studio-native-a2a-inbound.mjs verify-studio-native-a2a-recovery.mjs verify-studio-native-a2a.mjs verify-studio-native-background.mjs verify-studio-native-child-a2a-recovery.mjs verify-studio-native-child-write-recovery.mjs verify-studio-native-children-web.mjs verify-studio-native-children.mjs verify-studio-native-e2b.mjs verify-studio-native-harness.mjs verify-studio-native-managed-a2a.mjs verify-studio-native-managed-children.mjs verify-studio-native-managed-crash.mjs verify-studio-native-management-web.mjs verify-studio-native-memory-web.mjs verify-studio-native-portable-runtime.mjs verify-studio-native-portable.mjs verify-studio-native-response-crash.mjs verify-studio-native-sidebar-ui.mjs verify-studio-native-sidebar-web.mjs verify-studio-native-skill-workflow.mjs verify-studio-native-vision.mjs verify-studio-node-builtins.mjs verify-studio-onboarding-ui.mjs verify-studio-persistence.mjs verify-studio-plugin-lifecycle.mjs verify-studio-product-profiles.mjs verify-studio-route-failures-ui.mjs verify-studio-startup-states.mjs verify-studio-team-host.mjsStudio 插件与桌面产品的端到端验收
native17verify-native-codex-cli.mjs verify-native-dependencies.mjs verify-native-dsh-browser.mjs verify-native-dsh-numeric.mjs verify-native-dsh-output.mjs verify-native-dsh-turn.mjs verify-native-durable-approval.mjs verify-native-full-page.mjs verify-native-mcp-package.mjs verify-native-memory-browser.mjs verify-native-model-surface.mjs verify-native-owned-recovery.mjs verify-native-python-syntax-package.mjs verify-native-real-model.mjs verify-native-studio-install.mjs verify-native-thinking-browser.mjs verify-native-thinking-view.mjs原生引擎、原生工具与原生会话
dsh9verify-dsh-codex-tool-cards.mjs verify-dsh-lifecycle.mjs verify-dsh-live-runtime.mjs verify-dsh-node-store.mjs verify-dsh-plugin-market.mjs verify-dsh-product-presentation.mjs verify-dsh-runtime-adapter.mjs verify-dsh-runtime-retry.mjs verify-dsh-sdk-node-store.mjsDSH 基座、补丁与生命周期
desktop6verify-desktop-artifact.mjs verify-desktop-client-source.mjs verify-desktop-differential.mjs verify-desktop-installed-update.mjs verify-desktop-module-graph.mjs verify-desktop-update-inputs.mjs桌面运行时与安装包
codex5verify-codex-command-events.mjs verify-codex-configured-model.mjs verify-codex-long-task.mjs verify-codex-plugins.mjs verify-codex-signing.mjsCodex App Server 与插件
a2a4verify-a2a-host-decisions.mjs verify-a2a-observation-view.mjs verify-a2a-question-wait.mjs verify-a2a-session-events.mjsAgent-to-Agent 控制面
windows4verify-windows-app-ui.mjs verify-windows-coexistence.mjs verify-windows-official-dsh.mjs verify-windows-online-update.mjsWindows 发布与更新
agent1verify-agent-manifest.mjsAgent 目录
agentengine1verify-agentengine-responses.mjsAgentEngine 控制面对接
bundle1verify-bundle-host.mjs可移植运行包
client1verify-client-modules.mjs客户端构建与模块图
container1verify-container-bundle.mjs容器部署环境
deployed1verify-deployed-bundle.mjs已部署运行时
host1verify-host-dependency-lifecycle.mjsHost 路由与分发
independent1verify-independent-workspace-host.mjs原生引擎独立性
ks31verify-ks3-multipart.mjsKS3 存储
macos1verify-macos-onboarding.mjsmacOS 发布
managed1verify-managed-mcp-identity.mjs—
packaged1verify-packaged-drag-region.mjs打包产物
patched1verify-patched-dsh-host.mjs打补丁后的 Host
portable1verify-portable-codex.mjs可移植资源与凭证
team1verify-team-template-catalog.mjs专家团运行时
verification/verify1verification/verify-assistant-deliverable-boundary.mjs—

版本与兼容性

项值说明
make 目标56新增即更新本页,否则 --check 失败
默认目标checkmake 不带参数时执行
校验脚本100门禁目标复用它们
排除目标2面向 Intel Mac 的遗留目标,不对外发布

开发者入口

内容源码位置
目标定义Makefile
校验脚本scripts/
开发者体验scripts/development-doctor.mjs
文档站构建docs-site/scripts/build-static.mjs

相关测试:

测试文件位置

本页导航