用途:arkcli +chat 封装数据面 Responses API(POST /responses),用于开放对话、问答、推理与追问。若用户带图/视频/音频但有明确产出形态(转写、字幕、OCR、字段提取、视频总结等),应改用 arkcli-understand;生成图片或视频改用 arkcli-gen。
主要能力:支持多模态,用 --input @photo.jpg 上传本地文件,按扩展名自动分流图/视/音/通用文件;支持 --stream 流式(先推理后回答)、--instructions 系统指令、--temperature/--top-p/--max-output-tokens 采样调节、--reasoning-effort 思考强度、--thinking 与 --caching 缓存控制;用 --store 持久化后以 --previous-response-id 接续多轮;支持 --tools web_search 或 --tools-file tools.json 及 --tool-choice、--max-tool-calls;严格 JSON 用 --text-format json_schema --text-schema <file> --text-strict,客户端会校验完整性。配套 arkcli chat get/delete/list-input-items 对 stored response 做 CRUD(仅操作 --store 过的)。
使用方式:执行前须先读取共享 SKILL.md 与 references 文档。最简用法为 arkcli +chat --model <id> "<prompt>";--model 缺省时回退到 active profile 的 resources.text.default。用户仅给 ep-... 且任务不明时先用 arkcli resources resolve 识别候选。临时 --api-key/--base-url/Endpoint 按执行上下文处理,不写入 profile。仅预览时用 --dry-run,本地构造请求摘要,不联网、不计费、不存储。
限制:一次用户要求只发起一次真实 +chat,失败或严格 JSON 无效时保留并报告,不自动重试。返回为 arkcli 扁平 schema,助手文本取 .content,而非 Responses 原生嵌套结构。stored response 过期需如实报告,不得静默去掉 previous-response-id。元数据 warn 只进 stderr,不阻断请求,声明取值集与服务器实际接受集可能不同。错误处理中不得自动轮转 Key、切 Profile 或修改默认资源。