跳转到主要内容
应用目前处于 Alpha 测试阶段。 该功能可用，但仍在演进中。

​
概览

一旦你的应用已在本地构建并完成测试，你可以通过两种方式进行分发：
  • 发布到 npm — 将你的应用在 Twenty 应用市场上架，供任何工作区发现并安装。
  • 推送 tar 包 — 将你的应用部署到特定的 Twenty 服务器供内部使用，而无需公开发布。

​
发布到 npm

发布到 npm 可让你的应用在 Twenty 应用市场中被发现。 任何 Twenty 工作区都可以直接通过 UI 浏览、安装和升级应用市场中的应用。

​
要求

  • 一个 npm 账户
  • 你的包名必须使用 twenty-app- 前缀（例如，twenty-app-postcard-sender）

​
步骤

  1. 构建你的应用 — CLI 会编译你的 TypeScript 源码并生成应用清单：
yarn twenty app:build
  1. 发布到 npm — 将构建好的包推送到 npm 注册表：
npx twenty app:publish

​
自动发现

Twenty 应用市场目录会自动发现带有 twenty-app- 前缀的包。 发布后，你的应用会在几分钟内出现在应用市场中 — 无需手动注册或审批。

​
CI 发布

脚手架项目包含一个 GitHub Actions 工作流，会在每次发版时自动发布。 它会先运行 app:build，然后在构建输出目录中执行 npm publish --provenance： 
name: Publish
on:
  release:
    types: [published]

permissions:
  contents: read
  id-token: write

jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: "24"
          registry-url: https://registry.npmjs.org
      - run: yarn install --immutable
      - run: npx twenty app:build
      - run: npm publish --provenance --access public
        working-directory: .twenty/output
        env:
          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
对于其他 CI 系统（GitLab CI、CircleCI 等），同样适用以下三条命令：yarn install、npx twenty app:build，然后在 .twenty/output 目录下执行 npm publish。
npm provenance 可选，但建议启用。 使用 --provenance 发布会在你的 npm 列表中添加可信徽章，使用户可以验证该包是由公共 CI 流水线中的特定提交构建的。 有关设置说明，请参见 npm provenance 文档。

​
内部分发

对于你不希望公开的应用 — 例如专有工具、仅供企业使用的集成或实验性构建 — 你可以将 tar 包直接推送到某台 Twenty 服务器。

​
推送 tar 包

在一步中构建你的应用并将其部署到特定服务器： 
npx twenty app:publish --server <server-url>
该服务器上的任何工作区随后都可以在应用程序设置页面安装和升级该应用。

​
版本管理

要发布更新：
  1. 更新 package.json 中的 version 字段
  2. 使用 npx twenty app:publish --server <server-url> 推送新的 tar 包
  3. 该服务器上的工作区会在其设置中看到可用的升级
内部应用的作用范围仅限于它们被推送到的服务器。 它们不会出现在公共应用市场中，其他服务器上的工作区也无法安装。

​
应用类别

Twenty 会根据分发方式将应用归为三类：
类别工作原理在应用市场中可见？
开发通过 yarn twenty app:dev 运行的本地开发模式应用。 用于构建和测试。否
已发布使用 twenty-app- 前缀发布到 npm 的应用。 在应用市场上架，供任何工作区安装。是
内部通过 tar 包部署到特定服务器的应用。 仅对该服务器上的工作区可用。否
在构建你的应用时，从开发模式开始。 准备就绪后，选择用于广泛分发的已发布（npm），或用于私有部署的内部（tar 包）。