# @flowscripter/flowscripter-io-cli 中文文档

规范地址：https://npmcn.com/package/%40flowscripter/flowscripter-io-cli/

版本：3\.0\.15
npm 元数据更新时间：2026-11-12T06:21:45.530Z
中文译文更新时间：2026-11-15T01:13:20.971Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：135 kB，63 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：7 个
- peer 依赖：typescript ^7\.0\.2
- 首次发布：2026-08-17T09:26:16.881Z
- 最新版本发布：2026-11-12T06:21:45.116Z
- 近 30 天下载量：2262（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：39（近 12 个月 39 个）

## 中文简介

CLI 用于 [https://github.com/flowscripter/pluggable-io-framework 互联网档案馆的存檔,存档日期2014-12-21](https://github.com/flowscripter/pluggable-io-framework)

## 安装

```sh
npm install @flowscripter/flowscripter-io-cli
```

也可以使用：`pnpm add @flowscripter/flowscripter-io-cli`、`yarn add @flowscripter/flowscripter-io-cli`、`bun add @flowscripter/flowscripter-io-cli`

## README

# 流程描述器- io- cli

[![version](https://img.shields.io/github/v/release/flowscripter/flowscripter-io-cli?sort=semver)](https://github.com/flowscripter/flowscripter-io-cli/releases) [![build](https://img.shields.io/github/actions/workflow/status/flowscripter/flowscripter-io-cli/release-bun-executable.yml)](https://github.com/flowscripter/flowscripter-io-cli/actions/workflows/release-bun-executable.yml) [![license: MIT](https://img.shields.io/github/license/flowscripter/flowscripter-io-cli)](https://github.com/flowscripter/flowscripter-io-cli/blob/main/LICENSE)

> 用于 [可插接- io- 框架](https://github.com/flowscripter/pluggable-io-framework), (中文(简体) ), 发展于 [动态框架](https://github.com/flowscripter/dynamic-cli-framework)

## 安装

**页:1**: 当整个 Bun 运行时, 二进制是 10 兆字节的大小 包含.

#### 麦克OS

通过 [土生土长](https://brew.sh/)数字 :

`brew install flowscripter/tap/flowscripter-io-cli`

#### 链接

在终端:

`curl -fsSL https://raw.githubusercontent.com/flowscripter/flowscripter-io-cli/main/script/install.sh | sh`

#### 窗口

通过 [温格](https://github.com/microsoft/winget-cli)数字 :

`winget install Flowscripter.flowscripter-io-cli`

#### 手动安装

您可以下载并提取二进制拉链文件 [释放](https://github.com/flowscripter/flowscripter-io-cli/releases) 页 次.

## 地点

每个命令通过位置参数处理数据 : `--source` 财务报告和审定财务报表 `--dest` 页:1 `copy`编号 :`move`,以及 `--location` 为其他命令。 A 类 位置有一个 `protocol` 和每个已安装协议的一组字段:

-   `--location.protocol=file` 选择协议。 允许的值是 已安装的提供者插件的协议.
-   `--location.file.path=/data` 和选定协议的其他字段 取自该协议的提供者插件,并针对 这个.
-   对于 `file` (和其他带有文件夹的协议),一个带有 `filename` 地址一个文件,一个带有 `pattern` (例如: `*.txt`) 处理匹配文件 `path`,一个没有 处理整个问题 `path` 文件夹.

`flowscripter-io-cli <command> --help` 列出每个已安装的字段 协议.

## 图标

-   `list --location [--recursive] [--regex]` - 列出文件夹或文件 匹配图案位置, 每个项目一条 JSON 线
-   `get-properties --location` - 打印文件或文件夹的属性为 JSON
-   `set-properties --location [--last-modified] [--content-type] [--properties.<protocol>.<name>]` - 设置属性:上次修改的时间和 内容类型适用于每个协议,以及 `--properties` 持有一个组 每个协议对于自己的固定属性(例如:. `--properties.file.mode=384`(中文(简体) )
-   `delete --location` - 删除文件或文件夹
-   `copy --source --dest [--payload-kind]` - 复制文件、文件夹或 匹配模式的文件,尽可能使用直接提供者副本,与 单个文件的进度栏。 打印谈判过的传输路径, 譬如说. `path: file/js -> file/js, direct`
-   `move --source --dest [--payload-kind]` - 移动,行为与 `copy`
-   `hash --location [--algorithm] [--payload-kind]` - 读取一个文件 它的流直接,在框架的传输路径之外. `--algorithm` 这是其中之一 `sha1`, (中文(简体) ), `sha256` (默认,使用本地散货者), `sha384`, (中文(简体) ), `sha512` 或者说 `md5`

共同行为:

-   `--payload-kind` 实值 `auto` (默认,由登记处选择), `js` 或者说 `native`类型失败 已安装.
-   期间 `list`, (中文(简体) ), `copy`, (中文(简体) ), `move` 或者说 `hash`,第一个Ctrl -C停止优雅和 报告结果已停止,并取消第二个 Ctrl-C .
-   操作协议不支持(例如:. `list` 结束 `https`失败 a 协议不支持的错误.
-   命令行上省略的任何必要的参数都会被提示 互动,通过 [动态框架](https://github.com/flowscripter/dynamic-cli-framework)是因为 `ArgumentPrompterService`。 。 。 .

## 提供者插件

此软件包不依赖任何提供者插件 。 安装一个或多个 通过 CLI 自己的插件管理(由 [动态框架](https://github.com/flowscripter/dynamic-cli-framework)是因为 `plugin` 页:1 启动时发现它们 [动态插件框架](https://github.com/flowscripter/dynamic-plugin-framework)是因为 `NpmPluginRepository`,和若干议定书,或若干执行 一个协议,可以同时安装:

```
flowscripter-io-cli plugin:add @flowscripter/io-plugin-filesystem
```

## 使用量

安装后(见 [安装](https://npmcn.com/package/%40flowscripter/flowscripter-io-cli/#readme-installation):

```
flowscripter-io-cli plugin:add @flowscripter/io-plugin-filesystem
flowscripter-io-cli list --location.protocol=file --location.file.path=.
flowscripter-io-cli copy \
  --source.protocol=file --source.file.path=. --source.file.filename=a.txt \
  --dest.protocol=file --dest.file.path=. --dest.file.filename=b.txt
flowscripter-io-cli copy \
  --source.protocol=file --source.file.path=. --source.file.pattern='*.txt' \
  --dest.protocol=file --dest.file.path=backup
flowscripter-io-cli hash --location.protocol=file --location.file.path=. \
  --location.file.filename=a.txt --algorithm sha256
```

## 发展

安装依赖性 :

`bun install`

测试 :

`bun test`

格式 :

`bunx oxfmt`

林特:

`bunx oxlint index.ts src/ tests/`

## 功能测试

参见 [功能 测试/README.md](https://npmcn.com/package/%40flowscripter/flowscripter-io-cli/functional_tests/README.md)

## 文档

参见 [可插接- io- 框架](https://github.com/flowscripter/pluggable-io-framework), (中文(简体) ), [可插件- io- 框架- api](https://github.com/flowscripter/pluggable-io-framework-api) 财务报告和审定财务报表 [io- plugin 文件系统](https://github.com/flowscripter/io-plugin-filesystem) 合同和安排 国家领导才能是建立在.

## 许可证

麻省理工学院

## 常见问题

### @flowscripter/flowscripter-io-cli 是什么？

CLI 用于 https://github\.com/flowscripter/pluggable-io-framework 互联网档案馆的存檔,存档日期2014-12-21

### 如何安装 @flowscripter/flowscripter-io-cli？

在项目目录运行 npm install @flowscripter/flowscripter-io-cli，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：typescript（^7\.0\.2）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @flowscripter/flowscripter-io-cli 支持 TypeScript 吗？

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

### @flowscripter/flowscripter-io-cli 支持 ESM 还是 CommonJS？

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

### @flowscripter/flowscripter-io-cli 可以商用吗？

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

### @flowscripter/flowscripter-io-cli 的下载量有多少？

根据 npm 官方下载统计，@flowscripter/flowscripter-io-cli 在 2026/10/15 – 2026/11/13 这 30 天内被下载 2,262 次，日均约 75 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @flowscripter/flowscripter-io-cli 还在维护吗？

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