用途:这是 Printing Press 生成的只读 CLI,面向 OAuth2 设备码(device-code)授权形态的固定场景,用于检查、导出、同步与分析数据,不用于创建、更新、删除、发布等会改变远端状态的请求。
安装与验证:通过 npx -y @mvanhorn/printing-press-library install printing-press-oauth2 --cli-only 安装,默认二进制目录在 macOS/Linux 为 $HOME/.local/bin,Windows 为 %LOCALAPPDATA%\Programs\PrintingPress\bin,并需将该目录加入 $PATH;用 printing-press-oauth2-pp-cli --version 验证。
认证:运行 printing-press-oauth2-pp-cli auth setup 查看设置,设置 DEVICE_CODE_CLIENT_ID 后执行 printing-press-oauth2-pp-cli auth login --device-code,打开验证 URL 输入用户码,令牌本地保存并自动刷新;可用 doctor 检查。
主要能力:items 命令列出条目;which 可将自然语言能力查询映射到命令;--agent 等价于 --json --compact --no-input --no-color,输出 JSON 便于管道处理;--select 保留字段子集,支持点号路径;--dry-run 预览请求;sync/search 在本地 SQLite 可用时可离线。输出可能带 meta/results 信封,需解析 .results 和 .meta.source。
路径与状态:可用 --home 或 PRINTING_PRESS_OAUTH2_HOME,以及 PRINTING_PRESS_OAUTH2_CONFIG_DIR、DATA_DIR、STATE_DIR、CACHE_DIR 等按类型环境变量;解析顺序为按类型环境变量、--home、PRINTING_PRESS_OAUTH2_HOME、XDG、平台默认。凭据存放在 data 目录的 credentials.toml。MCP 需在主机配置中通过 env 传递路径。
学习循环:内置自动学习,建议先 recall 查询、按候选人/playbook 决策、事后 teach。资料未说明具体功能范围、收费、价格、平台与效果,均暂未提供。