# @fungi\.computer/trellis 中文文档

规范地址：https://npmcn.com/package/%40fungi.computer/trellis/

版本：0\.15\.3
npm 元数据更新时间：2026-11-15T21:56:00.985Z
中文译文更新时间：2026-11-15T18:29:51.604Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40fungi.computer/trellis
原文对照：https://npmcn.com/package/%40fungi.computer/trellis/?lang=original
项目主页：https://github.com/fungi-computer/trellis#readme
源码仓库：https://github.com/fungi-computer/trellis

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：316 kB，49 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：19 个
- 首次发布：2026-10-16T18:05:14.714Z
- 最新版本发布：2026-11-15T21:56:00.773Z
- 近 30 天下载量：11099（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：58（近 12 个月 58 个）

## 中文简介

Trellis: 构建和运行 App 方法的工作流程, 牡蛎的 App

## 安装

```sh
npm install @fungi.computer/trellis
```

也可以使用：`pnpm add @fungi.computer/trellis`、`yarn add @fungi.computer/trellis`、`bun add @fungi.computer/trellis`

## README

# 特雷利斯( 特莱利斯 )`@fungi.computer/trellis`(中文(简体) )

Trellis 构建和运行工作流程: 输入您的 Apps 方法的图表, 已启动 以手方式,按时间表或按活动顺序.

![The Trellis editor with the Bonsai checks workflow: Workflow input, a Change script node and a Bonsai Checks.report step on the canvas, between the method Palette and the Inspector](https://npmcn.com/package/%40fungi.computer/trellis/docs/media/editor.png)

Trellis是Apps的启动程序之一 [牡蛎](https://github.com/fungi-computer/oyster),打开运行的 App 主机 在你自己的Cloudflare账户。 在牡蛎上,每个运行执行在 Cloudflare 工作流程, 和它的阶梯称为相同的 App方法 您的代理使用.

## 尽你所能

-   从中拖动方法 **调色板** 打开 **帆布**接通他们输入的口, ,并在 **检查员**Trellis 检查您编辑和 标记它 **有效** 当它可以运行.
-   添加审查步骤、等待、条件、重复和地图,或 a **代码** 节点 在有时间限制的沙盒中运行自己的 JavaScript .
-   **发布** 不可改变的版本,然后 **运行** 它与投入。 草稿从不 运行.
-   跟着跑 **运行**:每个步骤的状态、产出、持续时间和成本,以及 图像和视频预览。 批准或拒绝其中的审查步骤;只有一个人 可以回答检讨.
-   装入已出版的版本 **触发器** 开始于时间表,在 App 例如邦赛推倒或合并, 或来自网路 它结束到你的一个聊天.
-   打开 **时间表** 不选择工作流程或 允许Git进入。 它显示该装置的工作流量登记和 trellis可见的 Almanac 提醒和会话圈。 暂停 并删除给原所有人打电话,保留已接受的工作和历史. 代理读取和管理审批是独立的. 失踪或被拒绝的业主, 不完整的网页和无法获取的私人报道 计为空时间表。 出版物-文本武装留在触发器.
-   从 **模板**: Bonsai 检查(运行) `npm test` 每个更改和 上报结果 ) 带有每节评论的打印)和"故事板"+Save to git.
-   **导出**, (中文(简体) ), **导入** 财务报告和审定财务报表 **叉头** 工作流程作为JSON.

### 在合并的基础上构建

邦赛被录取了 Git 寿命周期请求通过此保留模板 **工作记录. runGraph** 用于已经注册的仓库。 输入是 注册的 App ID, 准确接受的 Git 修订和目标安装 名称; Bonsai 绑定是实时呼叫安装 。 这个模板 被公布的身份 被固定在呼叫者的发布源修订.

这三个步骤是: **建造 —— 核查 —— 安装**,带有结果卡. 核查等待建筑物的启动门,解码记录的释放和 检查其源码修改后再将其安装。 失败构建和 不匹配的释放停止在那里。 安装需要工作流程拥有的主管部门; 普通的App-起源电话不享受豁免。 本模板包含无 审查步骤或审查配置。 新权限仍需要所有者同意 并且必须保存运行中的释放.

![The Trellis editor in the light theme, with a Bonsai Repos.list step and a Workflow input on the canvas](https://npmcn.com/package/%40fungi.computer/trellis/docs/media/editor-light.png)

## 拿来

Trellis与其他起动App安装. 在已部署的牡蛎上(参见: [牡蛎快开始](https://github.com/fungi-computer/oyster#deploy-to-cloudflare), (中文(简体) ), 运行 :

```sh
export OYSTER_URL=https://oyster.<your-subdomain>.workers.dev
export OYSTER_OWNER_KEY=<your owner key>
npx oyster install-apps
```

安装者复制此寄存器和另外六个, 种子在您的 牡蛎与 `git push`,在您的计算机上构建并安装它们。 签名 时间 `$OYSTER_URL/login` 拿着车主的钥匙 打开Trellis 从Tourtois 桌面。 运行 `install-apps` 用于更新;每个 App 保留其数据.

## 换一下

每个已安装的 App 也是您可以在自己的牡蛎上叉出的一个模板. 叉头 Trellis 进入 Bonsai 仓库, 用普通复制它 `git`数字 :

```sh
curl -X POST -H "Authorization: Bearer $OYSTER_OWNER_KEY" -H 'content-type: application/json' \
  -d '{"appId":"app_trellis","name":"my-trellis"}' \
  $OYSTER_URL/apps/bonsai/methods/apps.fork
git -c http.extraHeader="Authorization: Bearer $OYSTER_OWNER_KEY" \
  clone $OYSTER_URL/git/bonsai/my-trellis.git
```

回复名称为您的叉子的 App id和寄存器 。 按下您的编辑, 打开 在 Bonsai 中保存并选择 **设置**,则 **构建安装( S)** 与那个 App ID 和您的承诺 `git:<sha>`。在 `trellis` 改为 替换运行中的 Trellis , 或者在新的 ID 中保留两者.

要从 GitHub 取而代之, 叉出此寄存器并指示安装器 你的叉子用着 `--repositories <base URL>` 财务报告和审定财务报表 `--ref <branch or tag>`编辑 安装者读取所有7个起动器 Apps 从该底部,所以将它们分叉在一个下 账户.

## 工作流程是如何存储的

草稿在Trellis自己的SQLite数据库中直播,并在您编辑时保存. 出版 写入 `workflows/<id>.json` 设备的 `trellis` git 仓库和 标记它 `<id>@v<n>`,所以所有运行过的版本都保持可读性. 挑个老的 版本菜单中的版本并选择 **恢复为草稿** 以再次编辑。 A 类 运行记录它从哪里开始的准确版本,而Oyster检查呼叫者的 在每个步骤之前再次权限.

## 代理工具

特工通过Oyster的MCP端点给Trellis打电话,或者在 `POST $OYSTER_URL/apps/trellis/methods/<name>` 有密钥; 见 [Git、 密钥和 MCP](https://github.com/fungi-computer/oyster#git-keys-and-mcp)。 。 。 .

| 方法 | 它会做什么 |
| --- | --- |
| `catalog` | 列出您安装的 Apps 方法, 或是 App 的完整端口类型 . |
| `listWorkflows` 编号 : `loadWorkflow` | 列出库,或读取一个工作流程. |
| `saveDraft` | 保存草稿, 并附带一个修改检查, 因此同步编辑时不会互相打乱 . |
| `publishWorkflow` 编号 : `listVersions` 编号 : `revertDraft` | 发布一个版本,列出版本,或者将一个版本恢复为草稿. |
| `runWorkflow` | 运行已发布的版本,可选择向聊天报告结束. |
| `listRuns` 编号 : `runStatus` 编号 : `cancel` | 列表运行,读取一跑的步骤和评论,或取消. |
| `arm` 编号 : `armEventTrigger` 联合国 `disarm` 双对 | 武器或解除时间表或事件触发器. |
| `exportWorkflow` 编号 : `importWorkflow` 编号 : `forkWorkflow` | 将工作流程以 JSON 的形式进出,或复制 1 . |

`answerReview` 也存在,但只有一个人才能回答复议.

## 构建和检查

Trellis是一款由Vite所建的回放App. 画布使用回放流和相片 [莫萨伊科语Name](https://github.com/fungi-computer/maosaico) 和控件 [盖子](https://github.com/fungi-computer/caps)。 。 。 .

```sh
pnpm install
pnpm build
pnpm typecheck
pnpm test
```

[弧/编辑/](https://npmcn.com/package/%40fungi.computer/trellis/src/editor/) 是图编辑器, [弧/运行/](https://npmcn.com/package/%40fungi.computer/trellis/src/runs/) 运行 审查和审查,以及 [弧/触发/](https://npmcn.com/package/%40fungi.computer/trellis/src/triggers/) 触发页. [后端/图书馆.ts](https://npmcn.com/package/%40fungi.computer/trellis/backend/library.ts) 拥有草稿和出版物,以及 [模板/](https://npmcn.com/package/%40fungi.computer/trellis/templates/) 将捆绑的模板保存为JSON. 代理工具 包含 [后端/方法数](https://npmcn.com/package/%40fungi.computer/trellis/backend/methods.ts) 财务报告和审定财务报表 [后端/图书馆方法](https://npmcn.com/package/%40fungi.computer/trellis/backend/library-methods.ts),以及 [软件包.json](https://npmcn.com/package/%40fungi.computer/trellis/package.json) 声明 App 要求的权限 .

## 许可证

麻省理工学院. 见 [自由主义](https://npmcn.com/package/%40fungi.computer/trellis/LICENSE)。 。 。 .

## 常见问题

### @fungi\.computer/trellis 是什么？

Trellis: 构建和运行 App 方法的工作流程, 牡蛎的 App

### 如何安装 @fungi\.computer/trellis？

在项目目录运行 npm install @fungi\.computer/trellis，或使用 pnpm add / yarn add / bun add。

### @fungi\.computer/trellis 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @fungi\.computer/trellis 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @fungi\.computer/trellis 可以商用吗？

@fungi\.computer/trellis 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @fungi\.computer/trellis 的下载量有多少？

根据 npm 官方下载统计，@fungi\.computer/trellis 在 2026/10/16 – 2026/11/14 这 30 天内被下载 11,099 次，日均约 370 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @fungi\.computer/trellis 还在维护吗？

最新版本 0\.15\.3 发布于 2026/11/16（今天）；至今共发布 58 个版本，其中过去 12 个月发布了 58 个；首次发布于 2026/10/17。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。