Hscli – 一個可腳本化的 Help Scout CLI，適用於終端、CI 和 AI 代理

Hscli 是一個全新的開源命令行工具，專為 Help Scout 用户打造，旨在通過終端、CI 流水線和 AI 代理（如 Claude Code 和 Codex）實現高效、可腳本化的客户支持操作。所有命令均採用 JSON 輸出，並返回清晰的退出碼，確保自動化流程的可靠性和可預測性。

該工具提供了豐富的實用功能。例如，用户可以使用 hscli conv list --status active --output table 命令以表格形式查看所有活躍對話，包括對話 ID、主題、客户和狀態等關鍵信息。此外，通過 hscli conv bulk-status 命令，可以批量關閉帶有特定標籤的對話，例如一次性關閉所有標記為“已解決”的活躍對話。這些操作極大地簡化了日常客服工作。

Hscli 的設計理念圍繞四個核心原則：代理與工作流就緒、管道友好輸出、默認安全以及完整賬户備份。它支持多種輸出格式（表格、JSON、YAML、CSV），並內置 --jq 和 --fields 參數用於內聯過濾和投影。OAuth 令牌僅存儲在操作系統的密鑰鏈中，不會以明文形式寫入磁盤，且 API 調用限制在 Help Scout 主機範圍內。備份功能支持增量刷新、斷點續傳、刪除檢測和附件備份，非常適合在 CI 中作為夜間任務運行。

在實際應用中，Hscli 可以與 jq、xargs、cron 以及 CI 運行器等工具無縫組合。例如，運維人員可以將活躍對話通過管道傳遞給 AI 模型，由模型自動進行標籤和分配；或者設置定時任務進行賬户備份；還可以將報告數據以 CSV 格式流式傳輸到電子表格中進行分析。這些場景充分展示了 Hscli 在自動化工作流中的巨大潛力。

總之，Hscli 讓用户能夠用一行命令完成原本需要多次點擊的操作，從而顯著提升工作效率。無論是獨立的終端操作，還是集成到複雜的 CI/CD 流水線和 AI 代理中，Hscli 都能提供一致且可靠的體驗。