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 助手中即可使用：
bash
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 协议开放源代码：
欢迎 Star、Fork、Issue 和 PR，让知识库在 AI 时代也拥有自己的 Agent-Native 接口。