@fungi.computer/shed

中文文档
0.7.8发布于 2026/11/15MITES Module近 30 天下载 8857

Shed: 您计算机上的终端, 及其端口和流程, 用于牡蛎

中文使用文档
文档目录7 节
  1. 尽你所能
  2. 拿来
  3. 换一下
  4. 代理工具
  5. 构建和检查
  6. 许可证
  7. 本地电影重放

谢德 (@fungi.computer/shed(中文(简体) )

Shed 在您的计算机上打开一个终端, 并开放端口和运行 进程一键离去.

Shed's terminal on the Computer: the Fungi banner, the light shell prompt in /workspace, and the Ports, Processes and Access controls in the footer

谢德是Apps的创始人之一 牡蛎,打开运行的 App 主机 在你自己的Cloudflare账户。 在Oyster上,计算机是一个 Linux 工作空间在 a Cloudflare集装箱;Shed在那里运行命令,而不是在你的笔记本电脑上运行.

尽你所能

  • 在即时光速提示时键入命令( T)ls, (中文(简体) ), rg TODO, (中文(简体) ), jq . package.json 和类似。 一个需要真实的 Linux 进程的命令, 例如 npm, (中文(简体) ), node 或交互式程序,在它的位置打开完整的终端.
  • 搜索和召回您最后的500个快速命令 此时薛德已打开.
  • 打开 进程 以观察什么是运行,什么已经退出,什么是 不确定,并停止运行进程.
  • 打开 港口并预览 在终点站旁边.
  • 打开 访问 查看Shed持有的计算机权限.

电脑总是作为耐用的工作空间存在. 它的容器可能是 停止; 运行命令再次启动 。 容器结束处理 停止,不要回来 当它开始。 关闭Shed不会停止进程.

Shed on a phone in the light theme: the light shell prompt in /workspace with the footer controls below

拿来

Shed与其他起动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 拿着车主的钥匙 从图尔图瓦开张 Shed 桌面。 运行 install-apps 用于更新;每个 App 保留其数据.

端口预览打开了第二个来源, 从未携带您的登录 。 牡蛎 当主机落下的时候,他们就转动 OYSTER_PREVIEW_ORIGIN没有它, 港口 仍会曝光和去除端口,并说预览已关闭.

换一下

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

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

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

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

代理工具

特工通过Oyster的MCP端点给Shed打电话,或者在 POST $OYSTER_URL/apps/shed/methods/<name> 有密钥; 见 Git、 密钥和 MCP。 。 。 .

方法它会做什么
runCommand({command, cwd?, timeoutMs?})运行 shell 命令最多45秒. 回返 stdout, (中文(简体) ), stderr, (中文(简体) ), exitCode, (中文(简体) ), stdoutTruncated 财务报告和审定财务报表 stderrTruncated (每溪64个基B),或 { error: code }. 拒绝预算也提供 kind 财务报告和审定财务报表 retryAfterMs。工作流量 Git 命令的使用 $FUNGI_GIT_REMOTE。 。 。 .
listProcesses({})列出计算机上多达64个进程. 始无所起.
listPorts({})最多64个转发端口。 始无所起.

工作流量(见 翠丽丝使用 a 第二套用于延长工作:

方法它会做什么
run({command, cwd})启动一个进程, 将其输出记录在 /workspace/.fungi/runs/,并等待它退出。 重试重用同样的过程.
start 编号 : stop开始一个过程而不等待, 或者停止一个.
logs({run, offset, length})读取最多128KiB的跑道日志.
expose({port})返回已曝光端口的预览 URL.

一个工作流程步骤可以被推倒或读取到一个寄存器. 它的命令 然后在其中找到无证书远程 $FUNGI_GIT_REMOTE,例如 git push "$FUNGI_GIT_REMOTE" HEAD:refs/heads/main中选择 计算机;主机有.

构建和检查

谢德是一款由Vite所建的React App. 它的终端与"鬼怪"和它的 控件来自 盖子。 。 。 .

pnpm install
pnpm build
pnpm typecheck
pnpm test

src/shed-app.tsx (英语) 拥有所选计算机、权限和 进程和端口列表. 斜弧/浅壳/ 是光线 快点, 斜弧/平面-平面.tsx 整个终点站,和 src/ sshed-trays.tsx (英语) 端口和处理托盘。 这个 代理工具在 后端/方法数,以及 软件包.json 声明 App 要求的权限 .

许可证

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

本地电影重放

TerminalPanel 可选择接受 onTerminalReady(handle) 在鬼魂和 它的字体度量标准已经准备好。 键入 TerminalFilmHandle 曝光情况 write, (中文(简体) ), reset 财务报告和审定财务报表 resize 和鬼怪的普通签名,加 await handle.paint() 在画布上绘制当前缓冲器 捕获它。 手柄跟随主题/ Width 渲染器替换并投掷 卸载后。 制作呼叫器省略回调; 终端会话和输入 永远归薛德所有 重放呼叫器应该重新设置,调整大小,写出框架,然后 等待时 paint(); 仅本地写回调不是画布补全 信号.

版本与发布记录

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

版本发布日期距今
0.7.8latest2026/11/15今天
0.7.72026/11/15今天
0.7.62026/11/15今天
0.7.52026/11/15今天
0.7.42026/11/151 天前
0.7.32026/11/141 天前

其他发布通道:next → 0.5.13。

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

@fungi.computer/shed 是什么?

Shed: 您计算机上的终端, 及其端口和流程, 用于牡蛎

如何安装 @fungi.computer/shed?

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

@fungi.computer/shed 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/fungi.computer__shed 是否存在。

@fungi.computer/shed 支持 ESM 还是 CommonJS?

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

@fungi.computer/shed 可以商用吗?

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

@fungi.computer/shed 的下载量有多少?

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

@fungi.computer/shed 还在维护吗?

最新版本 0.7.8 发布于 2026/11/15(今天);至今共发布 53 个版本,其中过去 12 个月发布了 53 个;首次发布于 2026/10/17。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。