@fungi.computer/trellis

中文文档
0.15.3发布于 2026/11/16MITTypeScriptES Module近 30 天下载 1.1万

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

中文使用文档
文档目录8 节
  1. 尽你所能
  2. 在合并的基础上构建
  3. 拿来
  4. 换一下
  5. 工作流程是如何存储的
  6. 代理工具
  7. 构建和检查
  8. 许可证

特雷利斯( 特莱利斯 )@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

Trellis是Apps的启动程序之一 牡蛎,打开运行的 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

拿来

Trellis与其他起动App安装. 在已部署的牡蛎上(参见: 牡蛎快开始, (中文(简体) ), 运行 :

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数字 :

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。 。 。 .

方法它会做什么
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 和控件 盖子。 。 。 .

pnpm install
pnpm build
pnpm typecheck
pnpm test

弧/编辑/ 是图编辑器, 弧/运行/ 运行 审查和审查,以及 弧/触发/ 触发页. 后端/图书馆.ts 拥有草稿和出版物,以及 模板/ 将捆绑的模板保存为JSON. 代理工具 包含 后端/方法数 财务报告和审定财务报表 后端/图书馆方法,以及 软件包.json 声明 App 要求的权限 .

许可证

麻省理工学院. 见 自由主义。 。 。 .

版本与发布记录

@fungi.computer/trellis 共发布 58 个版本,首次发布于 2026/10/17;过去 12 个月发布了 58 个版本。

版本发布日期距今
0.15.3latest2026/11/16今天
0.15.22026/11/15今天
0.15.12026/11/15今天
0.15.02026/11/15今天
0.14.32026/11/151 天前
0.14.22026/11/141 天前

其他发布通道:next → 0.10.8。

关于 @fungi.computer/trellis 的常见问题

@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 和提交记录判断。