AIDAWORK / LIFECYCLE

Plugin Bundle 发布生命周期

独立图页 ↗
机制说明(SoT)图是辅读 · 结论以说明与证据为准

作者输入经过构建形成不可变输出;contractDigest 表示合同身份,不等同整个包的字节哈希。理解发布阶段时,要区分包是否构建成功、是否可分发,以及客户端是否已经同步。

本页可直接往下读完整机制说明,不需要「演示 / 播放故事」。术语不熟先看 术语表。

先读机制说明,结论以说明与证据为准 · 基于固定代码版本核验 · 部署状态另行确认

机制说明(全文)

Plugin Bundle 发布生命周期

构建身份与分发可见性

作者输入经过构建形成不可变输出;contractDigest 表示合同身份,不等同整个包的字节哈希。理解发布阶段时,要区分包是否构建成功、是否可分发,以及客户端是否已经同步。

当前官方目录是相同的 official 货架,企业包不进入这份目录。撤销需要客户端同步后才可获知;本地验签只验证本地包,不证明生产发布已经完成或离线客户端已经看见撤销。

证据与范围

  • aida-plugins · docs/plugin-v2-contract.md L1–44 · a33ce3733365
  • aida-desktop · apps/desktop/electron/plugin-host/plugin-host.ts L1–59 · 4346d79eb364
  • aida-agent · packages/agent/src/distribution/desktop-release-service.ts L152–182 · isOfficialDesktopRelease · e2adc9a3c325
  • aida-desktop · apps/desktop/electron/plugin-host/plugin-host.ts L169–186 · 4346d79eb364

结论来自固定版本的静态源码与合同阅读;实现存在、默认开关和生产启用分别判断。本站代码证据面板列出声明状态与具体限制。

publish:all → OSS 与内部预览免私钥发布(钉点 d220086aa495)

  • package.json script publish:all → scripts/publish-plugins.mjs:发现插件、按 scope 编排、状态迁移写入 OSS(可复用 Desktop 发布桶环境变量)。
  • 内部预览免发布私钥(unsignedPreview):packages/cli/src/platform-release.mjs(PREVIEW_OFFICIAL_RELEASE_PREFIX / loadPreviewReleasePublisher)与 Desktop official-release-store.ts / package-verifier.ts 支持内部预览通道免发布私钥发布,首推时从已验签的正式目录导入历史版本并保留包完整性(SHA-256 / contractDigest)与数据 schema 迁移链覆盖校验(assertMigrationChainCovers)。
  • aida-cli dry-run 续发预览路径锚定与断点相对化修复。不改变 Plugin V2 运行时协议。

机制说明

Plugin Bundle 发布生命周期

构建身份与分发可见性

作者输入经过构建形成不可变输出;contractDigest 表示合同身份,不等同整个包的字节哈希。理解发布阶段时,要区分包是否构建成功、是否可分发,以及客户端是否已经同步。

当前官方目录是相同的 official 货架,企业包不进入这份目录。撤销需要客户端同步后才可获知;本地验签只验证本地包,不证明生产发布已经完成或离线客户端已经看见撤销。

证据与范围

  • aida-plugins · docs/plugin-v2-contract.md L1–44 · a33ce3733365
  • aida-desktop · apps/desktop/electron/plugin-host/plugin-host.ts L1–59 · 4346d79eb364
  • aida-agent · packages/agent/src/distribution/desktop-release-service.ts L152–182 · isOfficialDesktopRelease · e2adc9a3c325
  • aida-desktop · apps/desktop/electron/plugin-host/plugin-host.ts L169–186 · 4346d79eb364

结论来自固定版本的静态源码与合同阅读;实现存在、默认开关和生产启用分别判断。本站代码证据面板列出声明状态与具体限制。

publish:all → OSS 与内部预览免私钥发布(钉点 d220086aa495)

  • package.json script publish:all → scripts/publish-plugins.mjs:发现插件、按 scope 编排、状态迁移写入 OSS(可复用 Desktop 发布桶环境变量)。
  • 内部预览免发布私钥(unsignedPreview):packages/cli/src/platform-release.mjs(PREVIEW_OFFICIAL_RELEASE_PREFIX / loadPreviewReleasePublisher)与 Desktop official-release-store.ts / package-verifier.ts 支持内部预览通道免发布私钥发布,首推时从已验签的正式目录导入历史版本并保留包完整性(SHA-256 / contractDigest)与数据 schema 迁移链覆盖校验(assertMigrationChainCovers)。
  • aida-cli dry-run 续发预览路径锚定与断点相对化修复。不改变 Plugin V2 运行时协议。

代码证据

引用核验检查固定 commit 的文件与范围;实现结论来自代码阅读。自动检查不证明生产环境已启用。

已核验实现

作者输入、不可变构建输出和 contractDigest 各有不同含义;digest 不是全包字节身份。

aida-pluginsdocs/plugin-v2-contract.md:1–121a33ce3733365db48413a4b97a0f4f65066856175
aida-desktopapps/desktop/electron/plugin-host/plugin-host.ts:96–1274346d79eb36402355e51118df0edf1f98586880c符号:export class PluginHost
已核验实现

当前官方目录全员同一货架,仅筛选 official;企业包不进入该目录。

aida-agentpackages/agent/src/distribution/desktop-release-service.ts:175–2057f2e519936b57902d4907ed8026fe1ecdd146e82符号:isOfficialDesktopRelease
aida-desktopapps/desktop/electron/plugin-host/plugin-host.ts:96–1274346d79eb36402355e51118df0edf1f98586880c符号:export class PluginHost
条件路径

离线客户端需要同步后才能获知撤销;本地验签不证明生产发布完成。

aida-desktopapps/desktop/electron/plugin-host/plugin-host.ts:96–1274346d79eb36402355e51118df0edf1f98586880c符号:export class PluginHost
已核验实现

plugins publish:all(scripts/publish-plugins.mjs)编排全部插件发布并把状态写入 OSS(可复用 Desktop 发布桶环境变量)。

aida-pluginsscripts/publish-plugins.mjs:195–235a33ce3733365db48413a4b97a0f4f65066856175符号:publishAll
aida-pluginsscripts/publish-plugins.mjs:71–111a33ce3733365db48413a4b97a0f4f65066856175符号:publishPlugin
aida-pluginspackage.json:18–19a33ce3733365db48413a4b97a0f4f65066856175符号:publish:all
已核验实现

内部 Preview 免签名发布:platform-release.mjs 支持 --unsigned-preview,通过 loadPreviewReleasePublisher 将构建产物发布到隔离前缀 official-distribution/preview/v1/(标记 verification: internal-preview),正式目录仍强制要求 Ed25519 签名。

aida-pluginspackages/cli/src/platform-release.mjs:64–90a33ce3733365db48413a4b97a0f4f65066856175符号:loadPreviewReleasePublisher
aida-agentpackages/agent/src/distribution/official-release-store.ts:80–927f2e519936b57902d4907ed8026fe1ecdd146e82符号:loadPreviewReleasePublisher