qwenpaw-data-cli

QwenPaw Data CLI

将 qwenpaw-data 作为外部任务执行入口。若当前 agent 已经运行在 QwenPaw Data 任务内部，不要递归启动另一个 qwenpaw-data 进程。

执行前检查

1. 运行 qwenpaw-data --help，确认命令存在且公开子命令为 plan、execute、run、chat 和 datasource。若命令不可用，报告需要先运行项目的 scripts/init_local.sh；不要搜索或直接调用 .venv/bin/qwenpaw-data，也不要自行安装或改写项目环境。

2. CLI 会自动加载项目根目录 .env 或 QWENPAW_DATA_ENV_FILE 指定的文件。不要读取、打印或手动 source dotenv 文件。模型命令会优先使用 QWENPAW_DATA_MODEL_*，未配置时回退到 LLM_MODEL、OPENAI_API_KEY 和 OPENAI_BASE_URL。

3. 使用 QWENPAW_DATA_CM_BASE_URL 指定 Data Bridge 地址；未配置时默认使用 http://127.0.0.1:8765。

4. 需要访问数据源时，先运行：

   qwenpaw-data datasource list
   

   从返回 JSON 的 items 中选择精确的 datasource_id。优先使用用户明确指定的 ID；名称或类型只有一个明确匹配时才自动选择；存在多个合理候选时向用户确认。不要从已掩码的凭据推断数据源。

5. 假定模型凭据和 MCP 配置已由运行环境提供。不要写入凭据或自行创建、覆盖 MCP 配置。

选择命令

直接完成普通任务

对不需要预先审阅或复用计划的一次性任务使用 run：

qwenpaw-data run --datasource-id "sales-prod" "分析最近 30 天销售额趋势"

需要传递较长、包含多行或容易被 shell 错误解释的请求时，将请求保存到文件并使用 --file：

qwenpaw-data run --file request.md --datasource-id "sales-prod"

位置 prompt 与 --file 互斥，不要同时传递。

审阅或复用计划

当用户要求先看计划、任务需要人工审阅，或 SOP 需要重复执行时，先生成 YAML：

qwenpaw-data plan --file request.md --datasource-id "sales-prod" --output plan.yaml

确认命令成功、plan.yaml 存在且内容符合任务目标后再执行：

qwenpaw-data execute plan.yaml --datasource-id "sales-prod"

在 plan 和 execute 中重复传入同一个 --datasource-id；该参数属于每次 CLI 请求的上下文，不要假定它已写入 SOP。

交互式对话

只在有人值守且终端支持标准输入时使用：

qwenpaw-data chat --datasource-id "sales-prod"

不要在无人值守的自动化流程中使用 chat，因为它会持续等待输入，直至收到 exit、quit 或 EOF。

选择输出模式

run 和 execute 默认启用流式输出。保留默认模式，持续读取文本增量、工具调用和工具结果，直至进程退出：

qwenpaw-data run --file request.md --datasource-id "sales-prod"
qwenpaw-data execute plan.yaml --datasource-id "sales-prod"

不要仅因短时间没有新输出就判定任务失败；使用支持长超时或会话轮询的命令执行工具，并确认进程是否仍在运行。

仅在同时满足以下条件时使用 --no-stream：

• 需要干净的最终回复以及 Execution summary；
• 调用方允许任务期间没有 stdout；
• 调用方提供足够长的超时或能够轮询进程状态。

qwenpaw-data run --no-stream --file request.md --datasource-id "sales-prod"
qwenpaw-data execute plan.yaml --no-stream --datasource-id "sales-prod"