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

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

版本：0\.7\.8
npm 元数据更新时间：2026-11-15T08:55:58.811Z
中文译文更新时间：2026-11-15T18:49:52.765Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：4.4 MB，33 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：20 个
- 首次发布：2026-10-16T18:05:00.868Z
- 最新版本发布：2026-11-15T08:55:58.597Z
- 近 30 天下载量：8857（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：53（近 12 个月 53 个）

## 中文简介

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

## 安装

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

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

## README

# 谢德 (`@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](https://npmcn.com/package/%40fungi.computer/shed/docs/media/terminal.png)

谢德是Apps的创始人之一 [牡蛎](https://github.com/fungi-computer/oyster),打开运行的 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](https://npmcn.com/package/%40fungi.computer/shed/docs/media/terminal-phone.png)

## 拿来

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

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

## 换一下

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

```sh
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](https://github.com/fungi-computer/oyster#git-keys-and-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个转发端口。 始无所起. |

工作流量(见 [翠丽丝](https://github.com/fungi-computer/trellis)使用 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. 它的终端与"鬼怪"和它的 控件来自 [盖子](https://github.com/fungi-computer/caps)。 。 。 .

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

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

## 许可证

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

## 本地电影重放

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

## 常见问题

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