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

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

版本：0\.17\.5
npm 元数据更新时间：2026-11-15T21:56:11.137Z
中文译文更新时间：2026-11-15T18:30:59.165Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：3.1 MB，28 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：18 个
- 首次发布：2026-10-16T18:05:46.558Z
- 最新版本发布：2026-11-15T21:56:10.959Z
- 近 30 天下载量：10989（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：66（近 12 个月 66 个）

## 中文简介

打印: 将图像和视频生成到您的计算机上的画廊, 牡蛎的 App

## 安装

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

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

## README

# 印刷(`@fungi.computer/prints`(中文(简体) )

打印会从一个提示生成图像和视频,并把它们保存在一个画廊上 你的电脑.

![Prints: the Library rail with All prints, Favorites and the folder tree on the left; on the right the open folder's folder tiles above a wall of prints, each with its model badge, above the prompt bar](https://npmcn.com/package/%40fungi.computer/prints/docs/media/gallery.png)

打印是启动 Apps of [牡蛎](https://github.com/fungi-computer/oyster),打开运行的 App 主机 在你自己的Cloudflare账户。 在牡蛎上,印刷品与工人AI和 将每个文件保存到计算机上的文件夹, Cloudflare 中的 Linux 工作空间 集装箱.

## 尽你所能

-   输入一个提示,选择一个模型和一个大小,并生成一个图像或视频. 每个 文件保存其模型的本地格式: 模型支持它的 PNG, JPEG 否则,MP4用于视频.
-   将您自己的图像添加为样式参考, 在接受它们的模型上 .
-   上传文件到同一文件夹, 或者为图片库选择另一个文件夹 .
-   在文件夹内组织 。 图书馆栏杆显示文件夹为树状, 带有 **所有指纹** 财务报告和审定财务报表 **爱好** {\\fn华文仿宋\\fs16\\1cHD1D1D1}在它上面 创建字符等文件夹和 位置, 将打印和文件夹拖到它们上, 从行菜单中重命名 , 或选择 **选择** 财务报告和审定财务报表 **移动到..**· ; **撤销** 退后一点 一颗心 最喜欢你整个团队的指纹 文件夹是真实的文件夹 电脑 墨卡普和你的特工也看见了 新指纹和上传土地 您正在查看的文件夹中 .
-   先浏览最新画廊 。 单击一幅图片以查看其内装 印刷品; **左边** 财务报告和审定财务报表 **对** 穿过已装满的墙 **英格兰** 返回最后视图的平板. **在墨盒中打开** 是明确的编辑 操作计算机上的文件.
-   **打开输出** 从代理或最近输出的行打开同一个查看器。 A 类 新打开的请求在您查看另一个打印时选择其输出; **图像信息** 仍然是一项明确的行动.
-   打开视频播放声音和本地播放控件; 退出 别闹了 如果浏览器拒绝自动播放,请按 Play. 视频聚焦箭头 键寻求而不是更改指纹。 枢纽和牡蛎允许 App-window 满屏.
-   步入加载文件或待决生成,而不离开取景器 . 视频工作显示他们的直播时间已过; 视频在您工作期间结束 看着它的占位符暂停 刚刚到现场看电视剧 这个 重试一个失败的文件 读取/ 重审或重试并删除一个失败的工作 地点 更改文件夹, 计算机或连接会关闭查看器 .
-   打开 **图像信息** 或从有重点的画廊平板上取出(按: **一、导 言**) (中文(简体) ).
-   切换 **实际规模** 以看到其自然像素维度的图像。 滚动 带有浏览器本土滚动的图像; 焦点滚动-视图箭头 pan 而不是脚印。 把它切掉再装好 步骤到 其他打印或重新打开的取景器开始安装.
-   **下载** 来自查看器或图像信息的图像。 下载会减少 即时和行并保持 AI 标记和打印的 ID; 文件在 电脑不变.
-   **份额** 由图像信息生成的打印,由主机提供 Fungi Hub does:一个公开的,只读的页面显示图片或视频,带有其 离开时才提示 **页面** 继续 打印是私人的,直到你转身 分享,并关闭它 停止链接立即。 变化 **页面** 而共享则创造了新的链接.
-   从平板或从 **活动**键 窗口状态栏。 重试恢复同样的尝试而不是生成 再来一次 **继续** 重新装入后捡取未完成的图像 .

![Prints on a phone in the light theme: the Folders button, the Folder, All and Favorites switch, folder tiles and a two-column wall above the prompt bar](https://npmcn.com/package/%40fungi.computer/prints/docs/media/gallery-phone.png)

## 拿来

印刷品与其他起动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` 带有所有者密钥并打开来自图尔图瓦的打印 桌面。 运行 `install-apps` 用于更新;每个 App 保留其数据。 生成 在你的Cloudflare账户上使用工人AI.

## 换一下

每个已安装的 App 也是您可以在自己的牡蛎上叉出的一个模板. 叉头 打印到 Bonsai 寄存器, 用普通复制它 `git`数字 :

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

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

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

## 代理工具

特工通过牡蛎的MCP端点调用打印器,或者在 `POST $OYSTER_URL/apps/prints/methods/<name>` 有密钥; 见 [Git、 密钥和 MCP](https://github.com/fungi-computer/oyster#git-keys-and-mcp)。 。 。 .

| 方法 | 它会做什么 |
| --- | --- |
| `listModels` | 列出图像和视频模型,并列出其大小,设置以及每个引用次数. |
| `generateImage` | 从一个提示生成一个图像并保存到相册文件夹中 。 可选 `characters` 名称保存字符以保持一致. |
| `generateVideo` | 产生一相相. 虽然它有效,但方法返回 `{kind: "pending", retryAfterMs}`;在此延迟之后用相同的输入再次呼叫. |
| `listCharacters` | 列出保存的字符:名称、描述和参考图像路径。 使用名称作为 `characters` 或者说 `@name`。 。 。 . |
| `listStyles` | 列出保存和内置样式:名称和文本。 使用名称作为 `style`。 。 。 . |
| `listOutputs` | 列出此 App 所制作的最新打印. `folder` 财务报告和审定财务报表 `recursive` 列出一个文件夹或它下的所有文件;每个项目都有其模型和一个视频的持续时间. |
| `getOutput` | 按文件路径读取一个打印,从任何文件夹读取:它的快取,模型,字符,样式以及它使用的参考图像. |
| `openOutput` | 每通电话可读取128个KiB,每通1个打印. |
| `listFolders` | 列出库中文件夹的子文件夹. |
| `moveFiles` | 将文件或文件夹移动到库文件夹( E)`createFolder` {\\fn黑体\\fs20\\shad2\\2aH82\\3aH20\\4aH33\\fscx95\\3cH592001\\be1}让它成为现实 {\\fn黑体\\fs20\\shad2\\2aH82\\3aH20\\4aH33\\fscx95\\3cH592001\\be1}让它成为现实 用它来代替 `mv`:指印保持其及时性,参考和最爱. |
| `describeFiles` | 最多24个路径: 是否打印出每个文件,其模式,视频的持续时间以及是否是最喜欢的. |
| `setFavorite` | 喜欢或不喜欢整个团队的文件. `listFavorites` 列出他们. |

`generateImage` 财务报告和审定财务报表 `generateVideo` 选择 `folder`,相对于 图书馆文件夹( e)`Characters/Mira`,并保存在那里;如果缺少它,它将被创建.

每一代都携带请求ID(`media_request_` 和21个小写字母 或数字。 用同样的标识重试,输入可以恢复同一代人 而不是付钱给另一个。 引用是文件路径, 如 `[{ path: "/canon/style.png" }]`在一个有电脑代理附件的主机里, `{ computerId: "computer-b", path: "/canon/style.png" }` 从任何附件读取 电脑使用电脑自己的读取授权。 奥米 `computerId` 联 合 国 选中的计算机; 输出仍然保存在那里 。 撤销或拒绝读取停止 在提供者发送前生成。 呼叫者不会通过图像字节或 URL . 参考文献不仅限于 App 的库文件夹: 计算机补助金 这是边界.

`listModels` 包括标签 `priceEstimate` 用于默认设置 (包括示例即时而不引用). `basis: "team-price"` 包含 (a) 东道方目前的团队标记; `"provider-cost"` 是无标记的提供者 估计数。 图像结果 `costMilliunits` 和人可读 `receipt` 使用情况 媒体承认收费 而不是目录提示 收据写着收费 纯粹 `priceEstimate` 是一个估计。 变化的维度、步骤、快 或者引用可以改变电荷.

设定可选 `settings.steps` 仅供 `input.steps` 没有 `"fixed"`; 服从 `input.maxSteps` 这里 忽略使用模型默认值 . 拒绝保留了Media的有限提供者诊断. 键入 `provider.reason === "credits_exhausted"` 意思是Cloudflare AI 网关不能 而不是小组的信用拒绝。 检查账户的信用和 cloudflare仪表板上的帐单 AI Gateway 或选择工人AI 模型; 不重试 `retryable: false` 结果.

## 构建和检查

打印是使用 Vite 构建的 React App , 控制来自 [盖子](https://github.com/fungi-computer/caps)后端保存文件夹 选项、恢复记录和 App 自己完成的打印索引 SQLite数据库.

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

[src/媒体Pane.tsx](https://npmcn.com/package/%40fungi.computer/prints/src/MediaPane.tsx) 把作曲家,画廊和 活动状态键在一起. [src/media-generation.ts (中文(简体) )](https://npmcn.com/package/%40fungi.computer/prints/src/media-generation.ts) 拥有尝试和重复, [src/media-gallery.ts (中文(简体) )](https://npmcn.com/package/%40fungi.computer/prints/src/media-gallery.ts) 页:1 画廊和上传,以及 [后端/打印-index.ts](https://npmcn.com/package/%40fungi.computer/prints/backend/prints-index.ts) 记录每个完成的打印。 代理工具在 [后端/方法数](https://npmcn.com/package/%40fungi.computer/prints/backend/methods.ts),以及 [软件包.json](https://npmcn.com/package/%40fungi.computer/prints/package.json) 声明 App 要求的权限 .

## 许可证

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

## 常见问题

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

打印: 将图像和视频生成到您的计算机上的画廊, 牡蛎的 App

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

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

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

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

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

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

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

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

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

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

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

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