zyplayer-doc 发布官方 CLI zy-cli，已开源，支持自然语言驱动知识库操作，兼容主流 AI 编程工具。

如果说 2025 年是 "AI Agent 操作软件"的元年，那 CLI 就是 Agent 与软件之间最高效的桥梁。

今年年初，飞书开源了 lark-cli，5 天斩获 5500+ Stars，让 Claude Code、OpenClaw 等智能体能够直接在终端里操作飞书的文档、日历、邮箱、多维表格，紧随其后，Atlassian 推出了 Rovo Dev CLI 来操作 Jira 和 Confluence，Linear 也在建设自己的 CLI 工具。

现在，又一款开源知识库加入了这场 Agent-Native 的浪潮。

zyplayer-doc——一个面向团队知识管理的私有部署文档平台——发布了官方 CLI 工具 zy-cli，并已在 GitHub 和 Gitee 上完全开源。

什么是 Agent-Native CLI？

Agent-Native CLI 不是简单的命令行工具，它的设计目标不是"让人更快地敲命令"，而是让 AI Agent 能像人一样操作软件。

传统 API 集成的问题是：每个 AI 工具需要单独适配鉴权逻辑、理解请求格式、处理分页和错误码，对接一个平台可能就要写几百行适配代码。

Agent-Native CLI 的思路是反过来的：平台提供一套标准化的命令行接口，任何 AI 工具只需执行命令、读取输出，这是飞书 lark-cli 验证过的路线，也是 zy-cli 的核心理念。

zy-cli 提供了什么

zy-cli 将 zyplayer-doc 的核心能力封装为终端命令，覆盖以下场景：

文档管理

• 创建、更新、查询、删除文档，支持 Markdown 和富文本
• 从本地文件或 HTML 内容发布文档，自动处理图片上传和地址替换

附件管理

• 上传 Word、PDF、Excel 等格式文件作为知识库附件

空间与目录

• 创建和管理知识库空间、目录节点
• 支持空间内文档的移动、复制、引用

权限管理

• 为用户和部门授予空间或文档的查看、编辑权限
• 管理文档的公开分享状态

安全机制

• 首次使用需绑定设备码，采用一次性 UUID 防止重绑
• 所有请求经过 OpenAPI 签名验证

与 AI 工具的集成

安装绑定后，在任意支持子进程调用的 AI 助手中即可使用：

npm install -g zyplayer   # 安装
zy-cli config init        # 绑定设备（首次使用）

支持的工具包括 Qoder、Cursor、Claude Code、Codex、Trae、OpenClaw 等。

使用方式极其简单——不需要记任何命令，直接在 AI 对话框中用自然语言描述你要做什么，AI 会自动翻译为 zy-cli 命令并执行：

• “把这篇文章收藏到知识库” → AI 会抓取网页、过滤广告、上传图片、创建文档
• “把帮助中心目录上传到线上” → AI 会遍历本地文件夹、保持目录结构同步到知识库
• “新项目建空间和目录、加协作者” → AI 会依次创建空间、目录、分配权限

技术架构

zy-cli 本身是一个轻量的 Node.js CLI 应用，通过 commander.js 管理子命令，inquirer 处理交互式输入，与 zyplayer-doc 服务端的通信基于 OpenAPI 签名机制，所有请求均经过加密校验。

对于希望深度定制的开发者，zy-cli 的代码结构清晰，命令模块化设计，可以很容易地扩展自定义命令或集成到 CI/CD 流水线中。

开源地址

zy-cli 已在 GitHub 和 Gitee 上以 MIT 协议开放源代码：

• GitHub：https://github.com/zyplayer/zy-cli
• Gitee：https://gitee.com/zyplayer/zy-cli

欢迎 Star、Fork、Issue 和 PR，让知识库在 AI 时代也拥有自己的 Agent-Native 接口。