For AI agents: the complete documentation index is available at https://scriptedalchemy.github.io/agent-bundle/zh/llms.txt, the full documentation bundle is available at https://scriptedalchemy.github.io/agent-bundle/zh/llms-full.txt, and this page is available as Markdown at https://scriptedalchemy.github.io/agent-bundle/zh/reference/hosts.md.
  • 简体中文
  • 宿主能力矩阵

    生成页面

    本页在文档构建时由固定版本的宿主能力表 claude-2.1.250.jsoncodex-0.147.0.jsoncursor-2026-08-28.jsonportable-1.0.0.json 渲染而成。这些 JSON 文件是每个目标适配器编译时依赖的唯一事实来源;请修改它们而不是本页。表格内容保留英文原文。

    每个目标适配器都会把归一化后的 bundle 投影到一份固定的能力表上:这份 JSON 文档记录了证据所对应的宿主版本、宿主读取的路径,以及每项能力是 supporteddegraded 还是 unavailable,并附带书面原因。没有任何推断:缺少证据的能力即为不可用,绝不会默默猜测。

    固定宿主

    宿主观测版本插件清单市场清单钩子文档
    claude2.1.250.claude-plugin/plugin.json.claude-plugin/marketplace.jsonhooks/hooks.json
    codex0.147.0.codex-plugin/plugin.json.agents/plugins/marketplace.jsonhooks/hooks.json
    cursor2026-08-28.cursor-plugin/plugin.json.cursor-plugin/marketplace.jsonhooks/hooks.json
    portable1.0.0plugin.json

    安装方式

    宿主状态方式 / 命令作用域来源
    claudesupportedmarketplaceAdd: claude plugin marketplace add ./
    pluginInstall: claude plugin install <plugin>@<marketplace> --scope <scope>
    user, project, localhttps://code.claude.com/docs/en/discover-plugins
    codexsupportedmarketplaceAdd: codex plugin marketplace add ./
    pluginInstall: codex plugin add <plugin>@<marketplace>
    userhttps://developers.openai.com/codex/cli/reference
    cursorsupportedmethod: copy
    localRoot: ~/.cursor/plugins/local/<name>
    userhttps://cursor.com/docs/plugins
    portableunavailablePortable is a distribution profile, not a host runtime with one universal plugin installation location.https://agent-plugins.org/

    路径令牌

    令牌claude 2.1.250codex 0.147.0cursor 2026-08-28portable 1.0.0
    pluginData${CLAUDE_PLUGIN_DATA}${PLUGIN_DATA}
    pluginRoot${CLAUDE_PLUGIN_ROOT}relative-with-plugin-root-cwd${CURSOR_PLUGIN_ROOT}${PLUGIN_ROOT}
    workspaceRoot${CLAUDE_PROJECT_DIR}${workspaceFolder}

    MCP 传输与令牌字段

    宿主stdioStreamable HTTP接受路径令牌的字段
    claudesupportedsupportedcommand: ${CLAUDE_PLUGIN_ROOT}, ${CLAUDE_PLUGIN_DATA}, ${CLAUDE_PROJECT_DIR}
    args: ${CLAUDE_PLUGIN_ROOT}, ${CLAUDE_PLUGIN_DATA}, ${CLAUDE_PROJECT_DIR}
    env: ${CLAUDE_PLUGIN_ROOT}, ${CLAUDE_PLUGIN_DATA}, ${CLAUDE_PROJECT_DIR}
    url: ${CLAUDE_PLUGIN_ROOT}, ${CLAUDE_PLUGIN_DATA}, ${CLAUDE_PROJECT_DIR}
    headers: ${CLAUDE_PLUGIN_ROOT}, ${CLAUDE_PLUGIN_DATA}, ${CLAUDE_PROJECT_DIR}
    headersHelper: ${CLAUDE_PLUGIN_ROOT}, ${CLAUDE_PLUGIN_DATA}, ${CLAUDE_PROJECT_DIR}
    codexsupportedsupportedNo host interpolation. command, args, env values, and cwd accept a leading ${PLUGIN_ROOT} only when cwd is the plugin root; the compiler rewrites it to a ./-relative path under cwd: "./". Embedded tokens, ${PLUGIN_DATA}, and workspace-root tokens are build errors.
    cursorsupportedsupportedargs: ${CURSOR_PLUGIN_ROOT}, ${workspaceFolder}
    env: ${CURSOR_PLUGIN_ROOT}, ${workspaceFolder}
    headers: ${CURSOR_PLUGIN_ROOT}, ${workspaceFolder}
    url: ${CURSOR_PLUGIN_ROOT}, ${workspaceFolder}
    portablesupportedsupportedargs: ${PLUGIN_DATA}, ${PLUGIN_ROOT}
    cwd: ${PLUGIN_DATA}, ${PLUGIN_ROOT}
    env: ${PLUGIN_DATA}, ${PLUGIN_ROOT}

    插件组件

    每张表的 plugin 部分,按点分能力路径展开。布尔行表示适配器会发出的组件;带状态的行记录宿主证据支持或保留该能力的原因。证据说明保留在 JSON 文件中。

    claude 2.1.250

    能力状态说明
    agents.componentunavailableThe #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately defers Agent Bundle's authored plugin agents/ component until a separate evidence-backed increment.
    2 条证据说明
    agents.nameunavailableThe #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately withholds an authored plugin-agent name field together with agents/ emission.
    2 条证据说明
    agents.descriptionunavailableThe #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately withholds an authored plugin-agent description field together with agents/ emission.
    2 条证据说明
    agents.modelunavailableThe #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately withholds an authored plugin-agent model field together with agents/ emission.
    2 条证据说明
    agents.effortunavailableThe #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately withholds an authored plugin-agent effort field together with agents/ emission.
    2 条证据说明
    agents.maxTurnsunavailableThe #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately withholds an authored plugin-agent maxTurns field together with agents/ emission.
    2 条证据说明
    agents.toolsunavailableThe #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately withholds an authored plugin-agent tools field together with agents/ emission.
    2 条证据说明
    agents.disallowedToolsunavailableThe #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately withholds an authored plugin-agent disallowedTools field together with agents/ emission.
    2 条证据说明
    agents.skillsunavailableThe #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately withholds an authored plugin-agent skills field together with agents/ emission.
    2 条证据说明
    agents.memoryunavailableThe #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately withholds an authored plugin-agent memory field together with agents/ emission.
    2 条证据说明
    agents.backgroundunavailableThe #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately withholds an authored plugin-agent background field together with agents/ emission.
    2 条证据说明
    agents.isolationWorktreeunavailableThe #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately withholds authored plugin-agent isolation: worktree together with agents/ emission.
    2 条证据说明
    agents.hooksunavailableThe #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately defers the plugin-agent surface on which Agent Bundle would omit hooks under the host security contract.
    3 条证据说明
    agents.mcpServersunavailableThe #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately defers the plugin-agent surface on which Agent Bundle would omit mcpServers under the host security contract.
    3 条证据说明
    agents.permissionModeunavailableThe #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately defers the plugin-agent surface on which Agent Bundle would omit permissionMode under the host security contract.
    3 条证据说明
    bin.bareCommandssupported
    bin.bashPathsupported
    bin.directorybin
    bin.enabledOnlysupported
    bin.organizationDistributionProhibitedsupported
    channels.bindsToPluginMcpServersupported
    channels.perChannelUserConfigsupported
    commandFrontmattersupportedfields: {"allowedTools":"allowed-tools","argumentHint":"argument-hint","description":"description","disableModelInvocation":"disable-model-invocation","model":"model"}
    2 条证据说明
    commandssupported
    dependencies.autoInstallsupported
    dependencies.autoInstallExceptionscommand-source, headersHelper
    dependencies.crossMarketplaceAllowlistallowCrossMarketplaceDependenciesOn
    dependencies.entryFormsname, object
    dependencies.errorCodesdependency-unsatisfied, range-conflict, dependency-version-unsatisfied, no-matching-tag
    dependencies.objectFieldsmarketplace, name, version
    dependencies.prereleaseOptInsupported
    dependencies.prunesupported
    dependencies.rangeIntersectionsupported
    dependencies.semverRangessupported
    dependencies.tagConvention{name}--v{version}
    distributionPolicy.skillsDirectoryPluginsunavailableAgent Bundle emits a plugin directory but does not place it in a Claude skills directory or register the host-owned @skills-dir identity.
    2 条证据说明
    distributionPolicy.skillsDirectoryProjectTrustunavailableAgent Bundle cannot grant or inspect the workspace trust required before Claude loads a project-scope @skills-dir plugin.
    1 条证据说明
    distributionPolicy.skillsDirectoryMcpApprovalunavailableAgent Bundle can emit plugin MCP configuration but cannot complete Claude's per-server approval for a project-scope @skills-dir plugin.
    1 条证据说明
    distributionPolicy.skillsDirectoryLspTrustunavailableAgent Bundle can emit plugin LSP configuration but cannot satisfy Claude's workspace-trust gate for a project-scope @skills-dir plugin.
    1 条证据说明
    distributionPolicy.skillsDirectoryMonitorsunavailableAgent Bundle cannot make Claude load background monitors from a project-scope @skills-dir plugin, which the host explicitly skips.
    1 条证据说明
    distributionPolicy.pluginInstallScopessupported3 条证据说明
    distributionPolicy.pluginReloadunavailableAgent Bundle cannot reload or restart a running Claude session after plugin files or installed versions change.
    3 条证据说明
    distributionPolicy.pluginTrustGatesunavailableAgent Bundle cannot accept Claude workspace-trust, server-managed-settings approval, or command-source confirmation prompts on a user's behalf.
    2 条证据说明
    distributionPolicy.syncedPluginsunavailableAgent Bundle cannot synchronize or administer the @synced plugins attached to a user's claude.ai account.
    2 条证据说明
    distributionPolicy.managedPluginScopeunavailableAgent Bundle cannot create, remove, enable, or disable managed-scope plugins; Claude exposes that host-owned scope as read-only and update-only.
    1 条证据说明
    distributionPolicy.managedStrictKnownMarketplacesunavailableAgent Bundle does not emit or override the organization-managed strictKnownMarketplaces allowlist.
    2 条证据说明
    distributionPolicy.managedBlockedMarketplacesunavailableAgent Bundle does not emit or override the organization-managed blockedMarketplaces denylist.
    2 条证据说明
    distributionPolicy.managedDisableSideloadFlagsunavailableAgent Bundle cannot configure or bypass disableSideloadFlags in Claude managed settings.
    1 条证据说明
    distributionPolicy.managedDisableCommandPluginSourcesunavailableAgent Bundle emits no managed setting that can permit, block, or exempt Claude command plugin sources.
    2 条证据说明
    distributionPolicy.managedAllowManagedHooksOnlyunavailableAgent Bundle cannot configure allowManagedHooksOnly or claim that emitted plugin commands are exempt from that managed policy.
    2 条证据说明
    distributionPolicy.managedPluginSuggestionsunavailableAgent Bundle does not emit the managed pluginSuggestionMarketplaces allowlist or marketplace relevance signals for contextual installation suggestions.
    2 条证据说明
    distributionPolicy.pluginCliLifecycleunavailableAgent Bundle emits Claude plugin artifacts but does not invoke Claude's plugin creation, installation, state, update, inspection, or release commands.
    commands: init, new, install, uninstall, prune, enable, disable, update, list, details, tag
    2 条证据说明
    distributionPolicy.marketplaceCliLifecycleunavailableAgent Bundle emits marketplace manifests but does not add, list, remove, or update marketplaces in a user's Claude configuration.
    commands: add, list, remove, update
    2 条证据说明
    packageLifecycle.nodeDependencyInstallunavailableAgent Bundle emits compile-time plugin artifacts but does not currently place package.json plus a supported lockfile at the plugin root or run Claude's host-owned dependency install in a copied cache entry.
    manifest: package.json
    commands: {"bun.lock":"bun install --frozen-lockfile --ignore-scripts","bun.lockb":"bun install --frozen-lockfile --ignore-scripts","npm-shrinkwrap.json":"npm ci --ignore-scripts","package-lock.json":"npm ci --ignore-scripts"}
    lockfilePrecedence: bun.lock, bun.lockb, npm-shrinkwrap.json, package-lock.json
    timeoutSeconds: 60
    5 条证据说明
    packageLifecycle.yarnPnpmInstallAlternativeunavailableAgent Bundle does not run automatic Yarn or pnpm installs; Claude skips those lockfiles at host install time, while authors must explicitly install such dependencies from a hook into persistent plugin data.
    skippedLockfiles: yarn.lock, pnpm-lock.yaml
    persistentDataToken: ${CLAUDE_PLUGIN_DATA}
    2 条证据说明
    packageLifecycle.pluginCacheLifecycleunavailableAgent Bundle emits compile-time artifacts; cache copying or linking, resolved-version directory naming, orphan marking and sweeping, symlink materialization, and host component path-escape rejection happen during Claude installation and runtime.
    cacheRoot: ~/.claude/plugins/cache
    orphanGraceDays: 14
    6 条证据说明
    packageLifecycle.pluginPathSubstitutiondegradedAgent Bundle lowers and validates its canonical path tokens in structured Claude MCP, LSP, settings, generated-hook, and monitor fields, but authored Skill content and target-native hook documents remain opaque compile-time payloads and actual placeholder substitution is owned by Claude at runtime.
    tokens: ${CLAUDE_PLUGIN_ROOT}, ${CLAUDE_PLUGIN_DATA}, ${CLAUDE_PROJECT_DIR}
    fields: {"skillAndAgentContent":["anywhere"],"hookCommands":["command","args"],"monitorCommands":["command"],"mcpStdio":["command","args","env"],"mcpRemote":["url","headers","headersHelper"],"lsp":["command","args","env","workspaceFolder"]}
    4 条证据说明
    packageLifecycle.pluginDataLifecycleunavailableAgent Bundle can emit ${CLAUDE_PLUGIN_DATA} references but cannot observe the last installed scope, prompt for deletion, delete persistent data, or apply Claude's --keep-data uninstall option.
    deleteOnLastScopeUninstall: true
    cliDeleteDefault: true
    keepDataFlag: --keep-data
    2 条证据说明
    experimentalThemes.defaultDirectorythemes
    experimentalThemes.experimentalsupported
    experimentalThemes.manifestFieldexperimental.themes
    experimentalThemes.readOnlysupported
    devtools.detailssupported
    devtools.listJsonsupported
    devtools.pluginDirsupported
    devtools.strictValidationsupported
    devtools.tagsupported
    devtools.validatesupported
    lsp.config.lsp.json
    lsp.manifestFieldlspServers
    lsp.manifestFieldTypesarray, object, string
    lsp.optionalFieldsargs, diagnostics, env, initializationOptions, maxRestarts, restartOnCrash, settings, shutdownTimeout, startupTimeout, transport, workspaceFolder
    lsp.pathTokenFieldsargs, command, env, workspaceFolder
    lsp.requiredFieldscommand, extensionToLanguage
    lsp.transportssocket, stdio
    lsp.vendorsServerBinaryunavailable
    nativeDiagnosticsunavailableThe pinned Claude plugin contract (2.1.250) documents no standalone diagnostics-provider component; diagnostics reach Claude Code only through the diagnostics option of an .lsp.json language server, which is the lsp kind.
    1 条证据说明
    nativeExtensionunavailableThe pinned Claude plugin contract (2.1.250) documents no editor or native extension component; Claude Code plugins are CLI-loaded component trees, and IDE integrations ship separately from the plugin manifest.
    1 条证据说明
    metadata.defaultEnabled.defaultsupported
    metadata.defaultEnabled.dependencyRequirementPrecedencesupported
    metadata.defaultEnabled.fieldsupported
    metadata.defaultEnabled.marketplaceEntryPrecedencesupported
    metadata.defaultEnabled.persistedEnabledPluginsPrecedencesupported
    metadata.displayName.fallbackname
    metadata.displayName.fieldsupported
    metadata.freeform.fieldsupported
    metadata.freeform.hostReadsValuesunavailable
    metadata.freeform.nonObjectHandlingwarning-and-ignore
    metadata.freeform.strictValidationfailure
    metadata.standardFields$schema, author, description, homepage, keywords, license, repository, version
    monitors.commandTokens${CLAUDE_PLUGIN_ROOT}, ${CLAUDE_PLUGIN_DATA}, ${CLAUDE_PROJECT_DIR}, ${ENV_VAR}
    monitors.configmonitors/monitors.json
    monitors.defaultWhenalways
    monitors.experimentalsupported
    monitors.interactiveCliOnlysupported
    monitors.manifestFieldexperimental.monitors
    monitors.monitorToolRequiredsupported
    monitors.projectScopeSkillsDirectoryPluginsunavailable
    monitors.userConfigSubstitutionunavailable
    monitors.unsandboxedsupported
    manifest.claude-plugin/plugin.json
    marketplace.claude-plugin/marketplace.json
    marketplaceManifest.allowCrossMarketplaceDependenciesOnsupported
    marketplaceManifest.entryAuthenticationFieldsheaders, headersHelper
    marketplaceManifest.entryMetadataFields$schema, author, category, defaultEnabled, description, displayName, homepage, keywords, license, metadata, repository, strict, tags, version
    marketplaceManifest.entryRelevanceSignalscli, cwd, filesRead, hosts, manifestDeps
    marketplaceManifest.generatedSourceFormsrelative
    marketplaceManifest.sourceMatrix.archiveIntegritysha256-64-hex
    marketplaceManifest.sourceMatrix.authoredFormsrelative, github, url, git-subdir, npm, archive, command
    marketplaceManifest.sourceMatrix.generatedDefaultrelative
    marketplaceManifest.sourceMatrix.gitPinFieldsref, sha
    marketplaceManifest.sourceMatrix.shaOverridesRefsupported
    marketplaceManifest.sourceMatrix.versionGates.archive2.1.224
    marketplaceManifest.sourceMatrix.versionGates.command2.1.229
    marketplaceManifest.sourceMatrix.versionGates.pluginRootBareName2.1.239
    marketplaceManifest.renamessupported
    marketplaceManifest.topLevelFields$schema, allowCrossMarketplaceDependenciesOn, description, metadata, name, owner, plugins, renames, version
    paths.addsToDefaultskills
    paths.fieldTypesarray, string
    paths.ignoredDefaultFolderWarningsupported
    paths.marketplaceRootSkillsSubdirectoriesReplaceDefaultsupported
    paths.relativePrefix./
    paths.replacesDefaultagents, commands, experimental.monitors, experimental.themes, outputStyles, workflows
    paths.skillsRootException.
    paths.skillsRootExceptionSince2.1.221
    outputStyles.allowedSuffixes.md
    outputStyles.directoryoutput-styles
    outputStyles.frontmatterFieldsdescription, force-for-plugin, keep-coding-instructions, name
    outputStyles.manifestFieldoutputStyles
    outputStyles.replacesDefaultsupported
    settings.configsettings.json
    settings.placeholderSubstitutionunavailable
    settings.precedesManifestSettingssupported
    settings.subagentStatusLineFieldscommand, type
    settings.supportedKeysagent, subagentStatusLine
    settings.unknownKeysIgnoredsupported
    skillFeatures.hostFrontmattersupported1 条证据说明
    skillFeatures.markdownTokenssupported1 条证据说明
    skillssupported
    userConfig.envVarPrefixCLAUDE_PLUGIN_OPTION_
    userConfig.installConfigFlagsupported
    userConfig.optionalFieldsdefault, max, min, multiple, required, sensitive
    userConfig.projectSettingsIgnoredsupported
    userConfig.requiredFieldstype, title, description
    userConfig.sensitiveStoragesupported
    userConfig.settingsSourcesmanaged, --settings, user
    userConfig.shellSubstitutionRejectedhookShellCommands, monitorCommands, mcpHeadersHelper
    userConfig.substitutionToken${user_config.KEY}
    userConfig.typesboolean, directory, file, number, string
    workflows.directoryworkflows
    workflows.fileContentsopaque
    workflows.manifestFieldworkflows
    workflows.replacesDefaultsupported

    codex 0.147.0

    能力状态说明
    apps.registeredMcpMappingssupported1 条证据说明
    components.lspunavailableThe pinned Codex plugin contract publishes no LSP server surface; language-server configuration reaches Claude Code only.
    1 条证据说明
    components.nativeDiagnosticsunavailableThe pinned Codex plugin contract publishes no diagnostics-provider component; plugin-shipped diagnostics have no schema-backed authoring field, so the compiler emits none.
    1 条证据说明
    components.nativeExtensionunavailableThe pinned Codex plugin contract publishes no plugin-shipped editor or native extension component; the host-managed browser-extension part has no authoring field, so the compiler emits none.
    1 条证据说明
    overviewSurfaces.mcpUidegradedAgent Bundle compiles MCP Apps as ui:// resources with _meta passthrough served by the compiled MCP server, which is the open MCP Apps contract that ChatGPT renders; Codex CLI 0.147.0 renders no components, so the emitted UI is inert there and every tool remains usable without it. Rendering is a ChatGPT host surface, not a Codex plugin artifact.
    3 条证据说明
    overviewSurfaces.browserExtensionsunavailableBrowser extensions are host-managed plugin parts with no schema-backed authoring field in the pinned .codex-plugin/plugin.json contract; the compiler infers nothing and the closed manifest schema rejects any authored field until a package contract publishes one.
    2 条证据说明
    overviewSurfaces.scheduledTaskTemplatesunavailableScheduled task templates are host-managed plugin parts with no schema-backed authoring field in the pinned .codex-plugin/plugin.json contract; the compiler infers nothing and the closed manifest schema rejects any authored field until a package contract publishes one.
    2 条证据说明
    hookEnvironment.claudePluginDatasupported1 条证据说明
    hookEnvironment.claudePluginRootsupported1 条证据说明
    hookEnvironment.pluginDatasupported1 条证据说明
    hookEnvironment.pluginRootsupported1 条证据说明
    interface.assetssupported1 条证据说明
    interface.brandColorsupported1 条证据说明
    interface.categoryCapabilitiessupported1 条证据说明
    interface.descriptionssupported1 条证据说明
    interface.identitysupported1 条证据说明
    interface.starterPromptssupported1 条证据说明
    interface.urlssupported1 条证据说明
    manifest.codex-plugin/plugin.json
    marketplace.agents/plugins/marketplace.json
    manifestPackage.manifestMetadatasupportedfields: author.name, author.email, author.url, homepage, repository, license, keywords
    2 条证据说明
    manifestPackage.manifestPathsdegradedThe adapter emits canonical component locations and validates all documented forms, but it has no authored config surface for selecting custom component paths or inline component objects.
    admitted: {"hooks":["path","path-array","inline-object","inline-object-array"],"mcpServers":["path","inline-object"],"skills":["path"]}
    emitted: {"hooks":"./hooks/hooks.json","mcpServers":"./.mcp.json","skills":"./skills/"}
    3 条证据说明
    manifestPackage.optionalAssetsunavailableThe Codex adapter copies selected assets but cannot author composerIcon, logo, logoDark, or screenshots references in the manifest.
    assets: interface.composerIcon, interface.logo, interface.logoDark, interface.screenshots
    2 条证据说明
    manifestPackage.submissionPolicyunavailablePublic submission requirements are portal-owned distribution policy with no compiler-authored or compiler-validation surface.
    constraints: Apps Management write access, verified developer or business identity, listing and policy URLs, production MCP review materials, five positive and three negative test cases, country or region availability, release notes and policy attestations
    3 条证据说明
    mcpServerPolicy.approvalModesunavailablePlugin MCP approval modes are host-owned user configuration under plugins.&lt;plugin&gt;.mcp_servers.&lt;server&gt;; the compiler emits plugin artifacts and does not write the user's config.toml.
    1 条证据说明
    mcpServerPolicy.enabledunavailablePlugin MCP enabled state is host-owned user configuration under plugins.&lt;plugin&gt;.mcp_servers.&lt;server&gt;; the compiler emits plugin artifacts and does not write the user's config.toml.
    1 条证据说明
    mcpServerPolicy.toolsunavailablePlugin MCP tool selection is host-owned user configuration under plugins.&lt;plugin&gt;.mcp_servers.&lt;server&gt;; the compiler emits plugin artifacts and does not write the user's config.toml.
    1 条证据说明
    skillFeatures.hostFrontmattersupported1 条证据说明
    skillFeatures.markdownTokensunavailableThe pinned Codex skills contract (0.147.0) documents no Skill Markdown interpolation placeholders; a skill body token has no Codex equivalent and fails closed (AB3008).
    1 条证据说明
    skillssupported

    cursor 2026-08-28

    能力状态说明
    agents.componentunavailableThe #100 stage-2 G5 gate, merged in PR #220 and preserved by #107 revision 3, deliberately defers Agent Bundle's authored plugin agents/ component; Cursor documents the component, but this compiler emits no agents/ directory or manifest agents pointer until a later stage admits it.
    2 条证据说明
    canvasesunavailableCursor advertises plugin canvases without publishing a schema-backed authoring contract; no canvas component is inferred from marketplace examples, so this compiler emits none.
    1 条证据说明
    commandFrontmatterunavailableThe pinned Cursor commands surface is frontmatter-free Markdown: the lowering emits the prompt body only, so authored command frontmatter fields do not reach Cursor.
    fields: allowedTools, argumentHint, description, disableModelInvocation, model
    2 条证据说明
    commandssupported
    componentDiscoverysupporteddefaults: {"agents":"agents/ (.md, .mdc, .markdown)","commands":"commands/ (.md, .mdc, .markdown, .txt)","hooks":"hooks/hooks.json","mcpServers":"mcp.json","rootSkill":"SKILL.md at the plugin root (only without skills/ and without a manifest skills field)","rules":"rules/ (.md, .mdc, .markdown)","skills":"skills/<name>/SKILL.md"}
    emitted: {"commands":"./commands/","hooks":"./hooks/hooks.json","mcpServers":"./mcp.json","rules":"./rules/","skills":"./skills/"}
    replacement: manifest-path-replaces-default-scan
    2 条证据说明
    contractcursor-plugin
    distributionPolicy.autoRefreshunavailableAgent Bundle emits marketplace documents but does not configure dashboard Auto Refresh, install the Cursor GitHub App, or trigger manual re-indexing.
    1 条证据说明
    distributionPolicy.installModesunavailableInstallation modes are set per plugin by team admins in Dashboard -> Plugins; no plugin manifest or marketplace field declares them, so this compiler emits nothing for them.
    modes: Default Off, Default On, Required
    1 条证据说明
    distributionPolicy.localPluginImportsunavailableAgent Bundle's installer copies into ~/.cursor/plugins/local but cannot grant the admin-controlled Allow Local Plugin Imports setting a Teams or Enterprise user needs before Cursor discovers the copy.
    1 条证据说明
    distributionPolicy.localSymlinkInstallunavailableThe generated installer and doctor guidance copy the built bundle instead of symlinking it: Cursor's docs now show a symlink, but the observed loader rejected symlinks resolving outside ~/.cursor/plugins/local, and a copy loads under both readings.
    3 条证据说明
    distributionPolicy.marketplaceAccessunavailableMarketplace scope and access are dashboard settings on the team's marketplace, not plugin-authored fields; this compiler emits nothing for them.
    1 条证据说明
    distributionPolicy.marketplaceReviewunavailableAgent Bundle emits a checklist-conformant artifact (manifest, relative pointers, declared variables, copied logo) but does not host it in a Git repository, submit it, or complete Cursor's manual review.
    1 条证据说明
    distributionPolicy.teamMarketplacesunavailableTeam marketplaces are created and populated in the Cursor dashboard from a Git repository; this compiler emits the repository-side .cursor-plugin/marketplace.json only.
    1 条证据说明
    formats.agentPluginunavailableThe cursor target emits the full Cursor Plugin format only; the portable Agent Plugin format is emitted by the portable target and is never mixed into this artifact.
    manifest: plugin.json
    2 条证据说明
    formats.cursorPluginsupportedmanifest: .cursor-plugin/plugin.json
    1 条证据说明
    lspunavailableThe pinned Cursor Plugin contract publishes no LSP server component; language intelligence is editor-owned and not a plugin component pointer, so language-server configuration reaches Claude Code only.
    1 条证据说明
    nativeDiagnosticsunavailableThe pinned Cursor Plugin contract publishes no diagnostics-provider component, so the compiler emits none.
    1 条证据说明
    nativeExtensionunavailableThe pinned Cursor Plugin contract publishes no plugin-shipped editor extension component; editor extensions are outside the plugin manifest at this pin, so a plugin cannot vendor or register one.
    1 条证据说明
    ruleFrontmattersupportedfields: alwaysApply, description, globs
    1 条证据说明
    skillFeatures.hostFrontmattersupported1 条证据说明
    skillFeatures.markdownTokensunavailableThe pinned Cursor skills contract (2026-08-28) documents no Skill Markdown interpolation placeholders; a skill body token has no Cursor equivalent and fails closed (AB3008).
    1 条证据说明
    localInstall.methodcopy
    localInstall.root~/.cursor/plugins/local/<name>
    manifest.cursor-plugin/plugin.json
    manifestMetadatasupportedauthoredFields: author.name, author.email, homepage, repository, license, keywords, publisher, category, tags, minClientVersions
    generatedFields: name, displayName, description, version, logo, commands, hooks, mcpServers, rules, skills, variables
    schemaOnlyFields: displayName, publisher, category, tags, minClientVersions
    3 条证据说明
    marketplace.cursor-plugin/marketplace.json
    marketplaceManifestsupportedentryFields: name, source, description, version, author, homepage, repository, license, keywords, logo, category, tags, skills, rules, agents, commands, hooks, mcpServers, variables
    generatedEntryFields: name, source, description
    maxEntries: 500
    mergePrecedence: plugin-manifest-over-marketplace-entry
    3 条证据说明
    rootSkillunavailableAgent Bundle always emits skills under skills/<name>/SKILL.md with an explicit manifest skills pointer, so the root SKILL.md single-skill fallback is never produced.
    1 条证据说明
    rulessupported
    schemacursor/plugins@070189284e702e8a4d2e3cc8913994b204c5337a:schemas/plugin.schema.json
    skillssupported
    variablessupportedacceptedKeywords: type, title, description, default, enum, const, properties, required, items, length and numeric constraints
    secretValuesEmitted: false
    2 条证据说明

    portable 1.0.0

    能力状态说明
    extensionDirectoriesunavailable2026-09-02: Agent Plugins 1.0.0 §8.2 reserves top-level reverse-domain directories for client-owned files; the compiler emits no client extension directory because no pinned client publishes a file-based namespace contract for this format (https://agent-plugins.org/specification).
    extensionssupportedconfigKey: portable.extensions
    1 条证据说明
    lspunavailableThe portable Agent Plugin contract (1.0.0) defines only skills and MCP components; it has no LSP server surface.
    1 条证据说明
    manifestplugin.json
    manifestMetadatasupportedconfigKey: portable
    fields: author, homepage, keywords, license, repository
    1 条证据说明
    nativeDiagnosticsunavailableThe portable Agent Plugin contract (1.0.0) defines only skills and MCP components; it has no native diagnostics surface.
    1 条证据说明
    nativeExtensionunavailableThe portable Agent Plugin contract (1.0.0) defines only skills and MCP components; it has no native extension surface, and its reverse-domain extensions metadata is not one.
    1 条证据说明
    skillFeatures.hostFrontmatterunavailableThe Agent Skills specification pinned for the portable target defines only the portable frontmatter fields; host-specific extensions are not emitted in the portable SKILL.md.
    1 条证据说明
    skillFeatures.markdownTokensunavailableThe Agent Skills specification pinned for the portable target documents no Skill Markdown interpolation placeholders; a skill body token has no portable equivalent and fails closed (AB3008).
    1 条证据说明
    skillssupported