CLI
使用 SocQ CLI 实现终端工作流程、自动化,并将标准化任务结果导出为 JSON、JSONL、CSV 或表格。
@socq/cli 软件包尚未在公共 npm 注册表中提供。以下命令记录了即将推出的软件包,并且可以在开发过程中从 SocQ devtools 存储库中使用。
安装并验证
包发布后:
对于 CI,设置 SOCQ_API_KEY 而不是使用交互式登录。在正常终端使用中避免使用 --api-key,因为命令参数可能保留在 shell 历史记录或进程列表中。
发现端点
在构建自动化之前使用 describe,以便该命令使用 Capability Registry 中的当前输入架构和计费信息。
完成首次采集
动态命令直接映射到:
当输入来自文件时,使用稳定的通用形式:
恢复而不重新提交
如果命令在采集完成之前返回,请保留任务 ID:
不要因为本地等待超时而再次提交原始采集。恢复现有任务。
标记 Agent Skill 执行来源
正常的 CLI 提交记录为 request_source="cli"。当 Agent Skill 回退到 CLI 时,在提交命令上传递源标记:
SOCQ_REQUEST_SOURCE=skill 提供相同的行为。新任务则记录为skill-cli;任务轮询命令不需要标记。
输出格式