Metadata-Version: 2.5
Name: paykka-kit
Version: 26.10.16
Summary: 统一 CLI 工具集
Requires-Python: >=3.13
Requires-Dist: httpx>=0.27
Requires-Dist: mistune>=3.0
Requires-Dist: platformdirs>=4.10.0
Requires-Dist: playwright>=1.52
Requires-Dist: requests>=2.34.2
Requires-Dist: rich>=15.0
Requires-Dist: typer>=0.27.0
Description-Content-Type: text/markdown

# paykka-kit

统一 CLI 工具集，入口命令为 `pk`。

## 常用命令

```bash
pk --help
pk --version
pk search "删除 topic"
pk schema rocketmq topic delete
pk rocketmq --help
```

`pk search` 和 `pk schema` 读取本地命令清单，输出 JSON，不需要连接服务端。

## 输出约定

stdout 只承载可供脚本消费的结果，包括 JSON、原始文本和文档正文。table、panel、进度、提示、警告和错误写入 stderr。例如：

```bash
pk -o json rocketmq topic list | jq .
pk apollo config list myapp --text > application.properties
pk xxljob log get 123 > execution.log
pk yuque doc get team/repo/doc > doc.md
```

`-o json` 的 stdout 是纯 JSON；`--quiet` 只抑制非必要的人类提示，不会隐藏错误或结果。

## 危险操作与文件输入

删除、覆盖及其他危险操作在交互终端中要求确认；非交互环境必须显式使用 `--force`。`--quiet` 不会跳过确认。部分旧命令保留 `-f`、`-y` 或 `--yes` 作为兼容别名。

支持 `@file` 的参数可从 UTF-8 文件读取内容，例如：

```bash
pk rocketmq topic send topic-a --body @message.txt --force
```

运行 `pk schema <命令路径>` 可查看命令的参数和能力声明。
