volcengine arkcli +chat
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../arkcli-shared/SKILL.md，其中包含认证闸门、配置排查与命令选择顺序
CRITICAL — +chat 在执行之前，务必先用 Read 工具读取 references/arkcli-chat.md，禁止直接盲目调用命令。
核心概念
--model缺省时 CLI 自动 fallback 到 active profile 的resources.text.default；用户显式传入不同值时按../arkcli-shared/references/profile-defaults.md做漂移提示。+chat是数据面 Responses API（POST /responses）的高层封装：一次请求即返回助手文本。- 支持多模态：用
--input @photo.jpg把本地文件随请求上传，模型可看图/看视频/听音频后回答。图片(.jpg/.png/.webp/...)、视频(.mp4/.mov/...)、音频(.mp3/.wav/.m4a/...)、通用文件按扩展名自动分流。 - 支持流式：
--stream模式逐段输出，先输出推理（thinking），再输出正式回答（response）。 - 支持进度提示：非流式调用在 5s 后开始向 stderr 输出
arkcli +chat: still running… elapsed Xs心跳行（每 10s 一次），避免长调用看不到任何输出；脚本场景可用--no-progress关闭。stdout 不受影响。 - 支持system instructions：
--instructions "..."注入系统级指令。 - 支持采样调节：
--temperature/--top-p/--max-output-tokens。 - 支持思考强度：
--reasoning-effort minimal|low|medium|high（仅在支持 reasoning 的模型上生效）。 - 支持多轮接续：
--store持久化本次响应，下一次用--previous-response-id <id>接续。 - 支持Tools：
--tools web_search（简单语法糖）或--tools-file tools.json（function 等完整形态），配合--tool-choice auto|required|none与--max-tool-calls。详见references/tools.md。 - 支持对账面命令：
arkcli chat get/delete/list-input-items <response-id>，对--store过的 response 做 CRUD，详见references/chat-meta.md。 - 支持缓存与思考：
--caching enabled|disabled（配--cache-prefix）控制服务端 prompt cache；--thinking auto|enabled|disabled控制思考阶段；--expire-at <epoch_sec>给 stored response 加过期。详见references/caching-thinking.md。 - 支持流式事件：
--stream --include-events输出原始 SDK 事件 NDJSON（每行一个 JSON），供 autotest / agent 程序化消费。详见references/stream-events.md。 - 支持可验证的严格 JSON：
--text-format json_schema --text-schema <file> --text-strict不只把约束传给服务端，还会在客户端确认响应完整、是直接 JSON 且符合 Schema；否则非零退出。严格流式会先缓冲，校验成功后才输出，避免泄出半截 JSON。详见references/text-format.md。 - 输出 schema（务必先看）：
+chat返回是 arkcli 扁平 schema（{id, model, content, reasoning_content, usage, ...}），不是 Responses API 原生output[].content[].text嵌套；助手文本直接用.content取。--format不会切换 shape。详见references/arkcli-chat.md的「返回值」段。 - 用户临时提供
--api-key/--base-url/ Endpoint 时，MUST 读取../arkcli-shared/references/execution-context.md。不要从 Key 文本猜套餐类型，也不要把临时值写入 profile。 --dry-run只在本地构造preview.v1请求摘要与无 secret 的执行上下文；不会读取在线元数据、刷新凭证、调用 Responses API、产生 token 用量或存储 response。在线依赖必须列为unresolved。
快速决策
走 +chat 的判据（三条全满足）：
- 用户带图/视频/音频但意图是开放对话/问答/推理/感想/评论（非固定产出形态）
- 不能映射到
arkcli-understand12 个子技能之一 - 或用户需要
--store/--previous-response-id多轮接续
转 arkcli-understand 的判据（任一满足即转）：
- 用户要「转写/语音转文字/语音识别/ASR」→ understand
- 用户要「字幕/打轴/SRT」→ understand
- 用户要「多人对话/标说话人/会议转写」→ understand
- 用户要「OCR/识别文字/识别图片文字/发票金额」→ understand
- 用户要「框出来/标框/bbox/视觉定位」→ understand
- 用户要「PDF 字段提取/文档提取/抽字段/合同提取」→ understand
- 用户要「视频总结/分段/章节总结」→ understand
- 用户要「视频问答/视频内容提问」→ understand
一句话：有 @file 且有明确产出形态 → understand；带图聊天/追问/开放感想 → chat。
- 用户要生成图片/视频（非对话）：转
../arkcli-gen/SKILL.md。
Agent 快速执行顺序
- 用户只给
ep-...且任务不明确 →arkcli resources resolve <ep-id> --format json；开放问答/追问才选择+chat。 - 用户给了临时 Key/Base URL/Endpoint → 按共享 execution-context 组合规则决定参数，不先切 profile。
- 不确定认证状态且没有完整 stateless 上下文时，先看
arkcli auth status；未登录/无 API Key 转../arkcli-auth/SKILL.md。 - 不确定模型名时，先转
../arkcli-models/SKILL.md。 --model必须是<name>-<primary_version>完整形式（或 Endpoint IDep-xxx）。primary_version格式不固定：6 位日期、8 位日期、带限定前缀、短数字、甚至空串都有（详见../arkcli-models/SKILL.md链路 0 的完整表格）——不要用正则自行猜测"看起来是否完整"。若用户只给了族名或不确定是否完整，先查primary_version再拼：刚models search/list过就直接复用返回里的字段，否则arkcli models get <name> --transform 'primary_version' | tr -d '"'（--transform输出带引号，必须剥掉）。跳过会直接 404InvalidEndpointOrModel.NotFound。- 需要流式输出时加
--stream；需要多模态时加--input @<file>（可多次）。
常见降级
- 模型名不确定：先
models search。 - endpoint ID 要用
+chat：直接传--model ep-xxx（endpoint 本身已决定模态，无需额外 flag）。 - Endpoint + 显式 API Key、未给 Base URL：CLI 会读取 Endpoint region 后派生 Base URL；无法取得权威 region 时再要求用户补
--base-url。 - 鉴权失败：转
../arkcli-auth/SKILL.md。
Responses API capability/access 错误的只读核对
用户已经给出 model does not have access to responses api 类错误时，本轮是排障，不是「再试一次」：
- 若已知精确、完整的版本化模型 ID，只执行
arkcli models get <model-id> --format json；禁止用models search的候选摘要代替单模型详情。 - 在
api_support数组中按name/key/path定位 Responses 项，以该项的supported为模型声明事实；不从模型名、lifecycle、tool 列表或其他 capability 反推。 supported=true但实际调用报 access 错误：说明「模型声明支持，当前 Endpoint / 账号访问路径不可用」；若用户还给了 Endpoint ID，可再只读resources resolve/infer endpoint get核对绑定与状态。supported=false才能说模型目录声明不支持；Responses 项缺失则说明元数据不足，不做猜测。
全程禁止再次执行 +chat、自动 models activate、切 profile 或修改默认资源。
命令一览
| 命令 | 说明 |
|---|---|
arkcli +chat --model <id> "<prompt>" |
最简用法：纯文本对话 |
arkcli +chat --model <id> --stream "<prompt>" |
流式输出（thinking + response 两段） |
arkcli +chat --model <id> --instructions "你是简洁助手" "<prompt>" |
系统级指令 |
arkcli +chat --model <id> --temperature 0.2 --max-output-tokens 256 "<prompt>" |
采样调节 |
arkcli +chat --model <id> --reasoning-effort high "<prompt>" |
提高思考强度 |
arkcli +chat --model <id> --input @file.jpg "<prompt>" |
多模态（本地文件，支持图/视/音） |
arkcli +chat --model <id> --input @a.jpg --input @b.jpg "<prompt>" |
多文件 |
arkcli +chat --model <id> --store "<prompt>" 拿到 id 后再 --previous-response-id <id> "<下一句>" |
持久化 + 多轮接续 |
arkcli +chat --model <id> --tools web_search --tool-choice auto "<prompt>" |
Tools: 联网检索 |
arkcli +chat --model <id> --tools-file tools.json --tool-choice required "<prompt>" |
Tools: 自定义 function |
arkcli chat get <response-id> |
拿回 store 过的 response（含 function_calls） |
arkcli chat list-input-items <response-id> --order desc --limit 5 |
列出输入项（多轮历史） |
arkcli chat delete <response-id> |
删除 store 过的 response |
arkcli +chat --model <id> --caching enabled --store "<prompt>" |
启用 prompt cache + 持久化 |
arkcli +chat --model <id> --thinking disabled --max-output-tokens 100 "<prompt>" |
关思考压短输出 |
arkcli +chat --model <id> --text-format json_object "<prompt>" |
强制模型出合法 JSON |
arkcli +chat --model <id> --text-format json_schema --text-schema schema.json --text-strict "<prompt>" |
用 JSON Schema 强约束 shape |
arkcli +chat --model <id> --stream --include-events "<prompt>" |
流式 NDJSON（每行一个 SDK 事件 JSON） |
arkcli +chat --model <id> --dry-run "<prompt>" |
无副作用预演；不调用 Responses API |
详细文档
+chat的所有参数、返回值、错误码、多模态文件自动上传机制等见references/arkcli-chat.md。+chat的 Tools 能力（--tools / --tools-file / --tool-choice / --max-tool-calls，含 function 与 web_search）见references/tools.md。chat get / chat delete / chat list-input-items三个对账面命令见references/chat-meta.md。这些命令操作的 response 必须是+chat --store过的。+chat的--caching / --cache-prefix / --thinking / --expire-at用法、回显字段与 autotest 对应见references/caching-thinking.md。+chat的--text-format / --text-schema / --text-schema-name / --text-strict用法见references/text-format.md。+chat的--stream --include-eventsNDJSON 流式事件输出见references/stream-events.md。