# @postonus/cli 中文文档

规范地址：https://npmcn.com/package/%40postonus/cli/

版本：0\.1\.10
npm 元数据更新时间：2026-11-02T05:00:47.129Z
中文译文更新时间：2026-11-02T05:27:32.465Z
软件包许可：UNLICENSED

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

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

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

- 包体积（解压后）：1.6 MB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.12\.0
- 运行依赖：7 个
- 首次发布：2026-08-23T14:33:13.793Z
- 最新版本发布：2026-11-02T05:00:46.939Z
- 已发布版本数：11（近 12 个月 11 个）

## 中文简介

从你的终端安排和发布社交帖子

## 安装

```sh
npm install @postonus/cli
```

也可以使用：`pnpm add @postonus/cli`、`yarn add @postonus/cli`、`bun add @postonus/cli`

## README

# @postonus / cli

从你的终端安排和发布社交帖子。

```bash
npm install -g @postonus/cli
postonus login
postonus post "shipping today" --to x,linkedin --optimal
```

需要Node.js 22.12或更新版本。需要一个 [Postonus](https://postonus.com/) 帐户。

不安装运行： `npx @postonus/cli whoami`

## 命令

| 命令 | 它是做什么的 |
| --- | --- |
| `login` / `logout` / `whoami` | 浏览器批准的登录，以及您的身份 |
| `channels list` | 连接的通道及其健康状况 |
| `channels connect` | 通过OAuth连接一个新通道 |
| `post <text>` | 安排一个帖子（从不立即发布） |
| `queue list` | 即将安排的职位 |
| `queue move <scheduleId> --at` | 重新安排一个排队的帖子 |
| `media upload <path…>` | 上传图片或视频用于帖子 |
| `best-times --to <platforms>` | 推荐投寄窗口 |

`postonus <command> --help` 他们身上的旗帜。

### 调度帖子

```bash
postonus post "shipping today" --to x,linkedin --optimal
postonus post --file draft.md --to linkedin --at 2026-08-01T09:30:00Z
postonus post --editor --to x --draft
postonus post "with a video" --to x --media ./demo.mp4 --optimal
cat draft.md | postonus post --to x --optimal
```

`post` 总是安排;它从不当场发表。选择一个时间 `--at <ISO timestamp>` 或者 `--optimal` 对于下一个推荐窗口，或使用 `--draft` 没有时间的节省。 `--dry-run` 显示会发生什么，然后停止。

## 脚本

每个命令都需要 `--json`，它在标准输出和 跳过所有交互渲染：

```bash
postonus queue list --json | jq -r '.queue[] | "\(.scheduledAt) \(.platform)"'
postonus post --file draft.md --to linkedin --at 2026-08-01T09:30:00Z --json
```

数据输出到标准输出，进度输出到标准输出，错误输出到标准输出，因此管道保持干净。退出 代码是 `0` 成功, `1` 失败, `2` 使用错误。没有TTY， CLI永远不会 提示-传递标志，并使用 `--no-input` 把丢失的一个变成一个 宁可犯错也不要等待。

### CI

集 `POSTONUS_API_KEY` 到仪表板上的API密钥。它优先于 存储会话，所以不是 `login` 步骤：

```yaml
- run: npx @postonus/cli post "$MESSAGE" --to x --optimal
  env:
    POSTONUS_API_KEY: ${{ secrets.POSTONUS_API_KEY }}
```

## 环境

| 变量 | 目的 |
| --- | --- |
| `POSTONUS_API_KEY` | 非交互使用的API密钥；覆盖 `login` |
| `POSTONUS_API_URL` | 与之交谈的仪表盘；默认为生产 |
| `EDITOR`/`VISUAL` | 编辑器由 `post --editor` |
| `NO_COLOR` | 禁用彩色输出 |
| `XDG_CONFIG_HOME` | 会话存储的位置；默认为 `~/.config` |

`postonus logout` 删除存储的凭据。

## 链接

-   [postonus.com](https://postonus.com/)
-   [报告问题](https://github.com/udayvunnam/experiments/issues)

## 常见问题

### @postonus/cli 是什么？

从你的终端安排和发布社交帖子

### 如何安装 @postonus/cli？

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

### @postonus/cli 支持 TypeScript 吗？

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

### @postonus/cli 支持 ESM 还是 CommonJS？

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

### @postonus/cli 需要什么版本的 Node\.js？

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

### @postonus/cli 可以商用吗？

@postonus/cli 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @postonus/cli 还在维护吗？

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