用途:etherpad-pp-cli 是 Etherpad(可扩展至数千并发用户的实时协作编辑器)的命令行驱动工具,用于在终端或智能体流程中管理 pad、作者、群组、会话与修订历史。
主要能力:创建、复制(含或不含历史)、移动、删除 pad;创建作者与群组并做 ID 映射;创建/删除会话;读写 pad 文本与 HTML、追加文本;获取只读链接与读写 pad ID;查看与保存、恢复、压缩修订;获取 HTML 差异;聊天消息追加与历史查询;列出 pad、群组、作者、会话及当前编辑用户;获取服务器统计与属性池;匿名化作者;发送自定义客户端消息。
安装与验证:npx -y @mvanhorn/printing-press-library install etherpad --cli-only;验证 etherpad-pp-cli --version。若 npx 失败,可用 go install github.com/mvanhorn/printing-press-library/library/productivity/etherpad/cmd/etherpad-pp-cli@latest(需 Go 1.26.6+)。
认证:etherpad-pp-cli auth set-token YOUR_TOKEN_HERE,或设置环境变量 ETHERPAD_OPENID;用 etherpad-pp-cli doctor 验证。
用法要点:任意命令可加 --agent(等价 --json --compact --no-input --no-color --yes);--select 过滤字段,--dry-run 预览,--deliver 支持 stdout、file:<path>、webhook:<url>;可用 which "<自然语言能力>" 查找命令;支持命名 profile 保存常用参数。读取本地或 API 数据时输出含 meta.source(live/local)与 results 的信封结构。
限制:需先安装并验证 CLI 在 PATH 中;认证令牌或 ETHERPAD_OPENID 必须有效;具体 Etherpad 服务端地址、版本兼容性与权限范围资料未提供;反馈默认仅本地存储,除非设置 ETHERPAD_FEEDBACK_ENDPOINT 并显式发送。