用途：freshservice-pp-cli 是驱动 Freshservice IT服务管理（ITSM）的命令行工具，供 AI 代理查询、创建、更新工单、资产、变更记录、知识库等 ITSM 数据。
主要能力：提供 tickets、assets、changes、requesters、agents、groups、contracts、vendors、solutions 等实体的增删改查；特色能力包括 breach-risk（预测未来 N 小时内将违反 SLA 的工单）、dept-sla（按部门统计 SLA 合规率）、my-queue（汇总待办工单与待批变更）、search（跨工单、资产、变更和知识库的统一全文搜索）、workload（代理负载表）、oncall-gap（值班缺口）、change-collisions（维护窗口冲突）、recurrence（重复症状聚类）、kb-gaps（知识库缺口）、orphan-assets（闲置资产）。
使用方式：先安装 CLI，可用 npx -y @mvanhorn/printing-press-library install freshservice --cli-only，失败时回退到 go install（需 Go 1.26.6+）。用 --version 验证，并确保安装目录在 PATH 中。认证需设置 FRESHSERVICE_APIKEY 和 FRESHSERVICE_DOMAIN，再用 doctor 检查连通性。任意命令加 --agent 即启用 --json --compact --no-input --no-color --yes，输出 JSON，可用 --select 裁剪字段、--dry-run 预览、--deliver 指定 stdout、file 或 webhook 输出。可用 which "<自然语言能力>" 查找命令，或安装 MCP 服务。
适用场景：工单分流、变更审批、资产盘点、SLA 合规报告及跨实体关联分析。
限制：需具备 Freshservice 账号与 API 令牌；部分搜索和同步命令需本地 SQLite 存储；Webhook 失败会返回非零并以 stderr 记录状态；其余细节暂未提供。