# @fabiofiorita/porcelain 中文文档

规范地址：https://npmcn.com/package/%40fabiofiorita/porcelain/

版本：0\.75\.1
npm 元数据更新时间：2026-10-31T23:26:56.521Z
中文译文更新时间：2026-11-01T03:08:54.554Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40fabiofiorita/porcelain
原文对照：https://npmcn.com/package/%40fabiofiorita/porcelain/?lang=original
项目主页：https://github.com/FabioFiorita/porcelain
源码仓库：https://github.com/FabioFiorita/porcelain

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

- 包体积（解压后）：27.2 MB，497 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=24\.20\.0 \<25
- 运行依赖：7 个
- 首次发布：2026-08-21T21:34:46.698Z
- 最新版本发布：2026-10-31T23:26:56.071Z
- 已发布版本数：39（近 12 个月 39 个）

## 中文简介

从浏览器、Mac或手机上查看编码代理的更改

## 安装

```sh
npm install @fabiofiorita/porcelain
```

也可以使用：`pnpm add @fabiofiorita/porcelain`、`yarn add @fabiofiorita/porcelain`、`bun add @fabiofiorita/porcelain`

## README

# @fabiofiorita /瓷(0.75.1)

用于普通Node安装的Porcelain审查服务器和捆绑的web应用程序。

## 快速启动

主机需要Node 24+、Git和其平台支持的文件监视器：

```sh
npx @fabiofiorita/porcelain@latest serve

# Permit other devices on the local network to connect:
npx @fabiofiorita/porcelain@latest serve --lan

# Install this exact CLI version as a user service (Linux):
npx @fabiofiorita/porcelain@latest service install

# Update the installed service to the newest published version:
porcelain service update
```

国家生活在 `~/.porcelain/`;通过 `--data-directory` 把它放在某个地方 别的。使用 `porcelain serve --help` 对于所有选项。

在配对设备之前，没有任何东西可以到达服务器。关于机器运行 它, `porcelain pair "Phone" --address <the address serve printed>` 输出一个 链接，工作一次；在设备上打开它。地址必须是1 此服务器响应at，浏览器中的未配对屏幕显示 整个命令已经填好了那个设备的来源。 `porcelain devices` 列出配对的和 `porcelain revoke <id>` 结束它。编码代理通过MCP与 `porcelain mcp`，它不需要凭据：它只到达一个本地套接字 进程在这台机器上可以打开。

## 后台服务

`porcelain service install|status|update|recover|uninstall` 管理系统 Linux下的用户服务。方法之外持久化调用的包版本 NPX缓存和写入 `porcelain` 命令 `~/.local/bin` 它运行；它 打印如何将该文件夹添加到 `PATH` 当它错过了，又独自留下了一个 `porcelain` 这是它没有写的。

`porcelain service update` 控件安装最新发布的版本 与设置→更新相同的更新程序，等待它完成并表示是否更新 已更新，已是当前或失败。 `npx @fabiofiorita/porcelain@<version> service update` 而是安装那个精确的版本。

`porcelain share lan on` 在本地网络上共享服务 `porcelain share` 显示了它是如何共享的。共享保存在数据中 目录，以便它在重新启动和更新中幸存下来。

更新会在新的运行时迁移之前停止服务并备份SQLite 它。旧的CLI拒绝替换新的运行时，除非 `service update --allow-downgrade` 是显式的。卸载将删除 服务，运行时和 `porcelain` 命令的同时保留数据； 配置、日志和数据库备份。以常规方式运行service命令 用户，不要使用sudo。

## 库开发

```sh
pnpm build:package

# Inspect the exact publishable archive:
cd dist-porcelain && npm pack
```

`dist-porcelain/` 是从完成的web和服务器构建生成的。不 手工编辑。

## 常见问题

### @fabiofiorita/porcelain 是什么？

从浏览器、Mac或手机上查看编码代理的更改

### 如何安装 @fabiofiorita/porcelain？

在项目目录运行 npm install @fabiofiorita/porcelain，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 porcelain，可以用 npx porcelain 直接运行。

### @fabiofiorita/porcelain 支持 TypeScript 吗？

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

### @fabiofiorita/porcelain 支持 ESM 还是 CommonJS？

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

### @fabiofiorita/porcelain 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24\.20\.0 \<25。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @fabiofiorita/porcelain 可以商用吗？

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

### @fabiofiorita/porcelain 还在维护吗？

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