runtime-guide

runtime-guide

---

1. 产物落盘规范

1.1 工作目录

每次执行都使用 QwenPaw Data runtime 指定的当前产物目录。本文用 <current_artifacts> 表示：

普通对话：       <workspace>/artifacts/<session_id>
TaskGraph 节点： <workspace>/artifacts/<session_id>/<graph_id>/<node_id>

当前执行目录内结构如下：

<current_artifacts>/
├── plan.yaml                 # 原始 plan（来自 planner，不修改）
├── plan_v1.yaml              # 第一次修改后的 plan（如有）
├── plan_v2.yaml              # 第二次修改后的 plan（如有）
├── steps/                    # 步骤结果（每步完成后写入）
├── data/                     # 数据产物
│   ├── raw/                  # 原始获取的数据（从数据源拉取的原始结果）
│   └── processed/            # 计算处理后的数据（衍生指标、数据清洗结果等）
└── result.yaml               # 最终结果（执行完成后写入）

• plan.yaml 是原始计划，始终保留不修改
• 执行过程中如需调整计划，生成 plan_v1.yaml、plan_v2.yaml... 按修改顺序递增
• 执行时始终以最新版本的 plan 为准
• session_id 必须使用 runtime 提供的当前值，不自行生成
• 仅当 runtime 明确提供当前 graph_id 和 node_id 时才使用节点子目录；普通 对话直接使用 session 目录
• 不在 workspace 根或未隔离的 artifacts/ 下创建任务目录

1.2 数据文件

类型	存放位置	命名
原始数据	<current_artifacts>/data/raw/	<数据描述>.<ext>
计算结果	<current_artifacts>/data/processed/	<分析内容>_<结果描述>.<ext>

• 文件命名应自描述，能看出内容是什么
• 列名/字段名须有业务含义（如 date, dau, dau_wow, is_anomaly），不使用 col1, col2
• 每个关键的计算结果都要落盘到 data/processed/，包括清洗后的数据文件、衍生指标、归因结果、异常检测结果、维度交叉表等，确保结论可溯源、可复现

示例：

<current_artifacts>/data/raw/dau_daily_202603.csv
<current_artifacts>/data/processed/channel_attribution_result.csv

1.3 步骤结果

每个分析步骤完成后，落盘一份步骤结果，服务于过程审查和结果溯源。存放在当前执行 目录的 steps/ 子目录下：

<current_artifacts>/steps/
├── step_01_<步骤描述>.yaml
├── step_02_<步骤描述>.yaml
└── ...

每份步骤结果包含：

• 做了什么：本步骤执行的操作描述
• 产出文件：涉及的数据文件、中间结果的路径索引
• 代码：本步骤执行的关键代码或脚本（如有）
• 结论：本步骤的分析结论或发现

1.4 最终结果

执行完成后，在 <current_artifacts>/result.yaml 产出最终结果，包含：

• 完成状态：全部完成 / 部分完成 / 失败
• 核心结论：对分析目标的直接回答
• 支撑数据：结论依赖的数据文件
• 未解决问题：数据缺失、结果矛盾、未追踪的线索
• 后续建议：建议深入分析的方向