用途:本技能用于驱动 printing-press-rich-pp-cli 二进制,属于只读命令行工具,面向查看、导出、同步与分析场景,不适用于创建、更新、删除、发布、评论、点赞、邀请、下单、发送消息、预订、购买或修改远端状态等操作。
主要能力:支持 items 资源查看;支持以自然语言查询能力对应的命令,例如 printing-press-rich-pp-cli which "<capability in your own words>";agent 模式下追加 --agent,等效于 --json --compact --no-input --no-color,输出可管道化、可过滤(--select)、可预览(--dry-run),在本地 SQLite 可用时可离线同步或搜索,且全程无交互、只读。读取本地或 API 数据时输出带来源的信封结构,含 meta.source 与 results。
使用方式:先安装 CLI,执行 npx -y @mvanhorn/printing-press-library install printing-press-rich --cli-only,并用 printing-press-rich-pp-cli --version 验证;若提示 command not found,需将安装目录加入 $PATH 后再继续。授权先运行 printing-press-rich-pp-cli auth setup 获取密钥步骤,再设置 export RICH_AUTH_API_KEY="<your-key>";可用 echo "$TOKEN" | printing-press-rich-pp-cli auth set-token 持久化。运行 printing-press-rich-pp-cli doctor 验证配置。路径可通过 --home <dir> 或 PRINTING_PRESS_RICH_HOME=<dir> 重定位,也可用逐类环境变量如 PRINTING_PRESS_RICH_CONFIG_DIR、PRINTING_PRESS_RICH_DATA_DIR、PRINTING_PRESS_RICH_STATE_DIR、PRINTING_PRESS_RICH_CACHE_DIR。
自动学习:本 CLI 自带自记录学习循环,失败标志修正后会派生 flag_alias 候选,缺失剧本的查询族会在 teach 后自动合成 playbook_candidate。建议在新问题前运行 printing-press-rich-pp-cli recall "<user's question>" --agent,先读 warnings、candidates、playbook 与 notes,再按决策分支执行;候选需 trial 后确认或拒绝。最终解答后应无条件后台执行 teach,例如 printing-press-rich-pp-cli teach --query "<user's question>" --resource-type <type> --resource <id>,且勿在 teach 查询或笔记中写入姓名、邮箱、电话、账号等个人标识信息。
适用场景与限制:适用于需以只读方式检查、导出、同步和分析 items 的自动化场景,尤其适合 agent 尽量减少上下文的 JSON 管道调用。限制为该工具仅提供只读能力,不能执行任何写入或变更远端状态的操作;密钥与配置存放于 data 目录下 credentials.toml,存储的机密不写入 config.toml;MCP 场景需通过 MCP 主机配置传递路径,MCP 二进制不继承 CLI 标志;其他未在资料中说明的功能、收费、平台与效果暂未提供。