@dazitech/cli 3.0.6 → 3.0.8

package/dist/examples/onto//351/224/200/345/224/256/347/244/272/344/276/213/setup/sales_ontology_init.py

@@ -0,0 +1,403 @@
+"""产品销售本体初始化脚本 — space__zlj
+
+初始化内容：
+1. 创建物理表（4 张：产品表、销售表、客户维表、渠道维表）
+2. 注册表到空间
+3. 注册表间关系（3 条：事实表 → 维表）
+4. 注册 Cube（5 个）及派生度量
+5. 定义对象类型（5 种）、绑定数据源、属性、链接
+6. 同步指标引用
+
+放置：项目/潘达石化/本体/ontos/产品销售本体方案/setup/sales_ontology_init.py
+发布：dazi onto script publish 项目/潘达石化/本体/ontos/产品销售本体方案/setup/sales_ontology_init.py --space space__zlj --type setup
+"""
+
+import json
+
+
+def main():
+    space_id = "space__zlj"
+    s = space.get(space_id)
+
+    output.print("=== 产品销售本体初始化 ===")
+    output.print(f"空间: {space_id}")
+
+    # 1. 创建物理表
+    output.print("\n[1/9] 创建物理表...")
+
+    s.sql.execute("""
+        CREATE TABLE IF NOT EXISTS product_master (
+            product_id String,
+            product_code String,
+            product_name String,
+            product_category String,
+            product_subcategory String,
+            brand String,
+            unit String,
+            list_price Float64,
+            cost_price Float64,
+            status String,
+            created_at DateTime DEFAULT now(),
+            updated_at DateTime DEFAULT now()
+        ) ENGINE = MergeTree()
+        ORDER BY (product_id)
+    """)
+    output.print("OK product_master")
+
+    s.sql.execute("""
+        CREATE TABLE IF NOT EXISTS customer_dimension (
+            customer_id String,
+            customer_code String,
+            customer_name String,
+            customer_region String,
+            customer_type String,
+            industry String,
+            created_at DateTime DEFAULT now()
+        ) ENGINE = MergeTree()
+        ORDER BY (customer_id)
+    """)
+    output.print("OK customer_dimension")
+
+    s.sql.execute("""
+        CREATE TABLE IF NOT EXISTS channel_dimension (
+            channel_id String,
+            channel_code String,
+            channel_name String,
+            channel_type String
+        ) ENGINE = MergeTree()
+        ORDER BY (channel_id)
+    """)
+    output.print("OK channel_dimension")
+
+    s.sql.execute("""
+        CREATE TABLE IF NOT EXISTS sales_order_fact (
+            order_id String,
+            order_line_id String,
+            order_date Date,
+            product_id String,
+            product_category String,
+            customer_id String,
+            customer_region String,
+            customer_type String,
+            channel_id String,
+            quantity Int32,
+            unit_price Float64,
+            discount_amount Float64,
+            sales_amount Float64,
+            currency String,
+            order_status String
+        ) ENGINE = MergeTree()
+        ORDER BY (order_date, order_id, order_line_id)
+    """)
+    output.print("OK sales_order_fact")
+
+    # 2. 注册表
+    output.print("\n[2/9] 注册表到空间...")
+
+    for tbl, label in [
+        ("product_master", "产品主数据表"),
+        ("customer_dimension", "客户维度表"),
+        ("channel_dimension", "销售渠道表"),
+        ("sales_order_fact", "销售订单事实表"),
+    ]:
+        s.tables.register(tbl, label=label)
+        s.tables.sync_columns(tbl)
+        output.print(f"OK {tbl}")
+
+    # 3. 注册表间关系（数据空间「表间关系」，供 JOIN / 侧栏展示）
+    output.print("\n[3/9] 注册表间关系...")
+
+    table_relationships = [
+        {
+            "from_table": "sales_order_fact",
+            "to_table": "product_master",
+            "join_sql": "sales_order_fact.product_id = product_master.product_id",
+            "join_keys": [{"from": "product_id", "to": "product_id"}],
+            "relationship_type": "many_to_one",
+            "description": "销售订单行关联产品主数据",
+        },
+        {
+            "from_table": "sales_order_fact",
+            "to_table": "customer_dimension",
+            "join_sql": "sales_order_fact.customer_id = customer_dimension.customer_id",
+            "join_keys": [{"from": "customer_id", "to": "customer_id"}],
+            "relationship_type": "many_to_one",
+            "description": "销售订单行关联客户",
+        },
+        {
+            "from_table": "sales_order_fact",
+            "to_table": "channel_dimension",
+            "join_sql": "sales_order_fact.channel_id = channel_dimension.channel_id",
+            "join_keys": [{"from": "channel_id", "to": "channel_id"}],
+            "relationship_type": "many_to_one",
+            "description": "销售订单行关联销售渠道",
+        },
+    ]
+    for rel in table_relationships:
+        rid = s.tables.add_relationship(**rel)
+        output.print(f"OK {rel['from_table']} -> {rel['to_table']} ({rid})")
+
+    # 4. 注册 Cube
+    output.print("\n[4/9] 注册 Cube...")
+
+    fact = "sales_order_fact"
+    common_measures = [
+        {"name": "quantity", "col": "quantity", "agg": "sum", "title": "销售数量"},
+        {"name": "sales_amount", "col": "sales_amount", "agg": "sum", "title": "销售金额"},
+        {"name": "discount", "col": "discount_amount", "agg": "sum", "title": "折扣金额"},
+        {"name": "order_count", "col": "order_id", "agg": "uniq", "title": "订单数"},
+        {"name": "line_count", "col": "order_line_id", "agg": "uniq", "title": "订单行数"},
+    ]
+
+    s.register_cube(
+        name="SalesCube",
+        table=fact,
+        title="销售分析主Cube",
+        measures=common_measures,
+        dimensions=[
+            {"name": "order_id", "col": "order_id", "type": "string", "title": "订单ID"},
+            {"name": "order_line_id", "col": "order_line_id", "type": "string", "title": "订单行ID"},
+            {"name": "order_date", "col": "order_date", "type": "date", "title": "订单日期"},
+            {"name": "product_id", "col": "product_id", "type": "string", "title": "产品ID"},
+            {"name": "product_category", "col": "product_category", "type": "string", "title": "产品大类"},
+            {"name": "customer_id", "col": "customer_id", "type": "string", "title": "客户ID"},
+            {"name": "customer_region", "col": "customer_region", "type": "string", "title": "销售区域"},
+            {"name": "channel_id", "col": "channel_id", "type": "string", "title": "渠道ID"},
+        ],
+    )
+    output.print("OK SalesCube")
+
+    s.register_cube(
+        name="ProductSalesCube",
+        table=fact,
+        title="产品销售Cube",
+        measures=[
+            {"name": "quantity", "col": "quantity", "agg": "sum", "title": "销售数量"},
+            {"name": "sales_amount", "col": "sales_amount", "agg": "sum", "title": "销售金额"},
+            {"name": "order_count", "col": "order_id", "agg": "uniq", "title": "订单数"},
+        ],
+        dimensions=[
+            {"name": "product_id", "col": "product_id", "type": "string", "title": "产品ID"},
+            {"name": "product_category", "col": "product_category", "type": "string", "title": "产品大类"},
+        ],
+    )
+    output.print("OK ProductSalesCube")
+
+    s.register_cube(
+        name="CustomerSalesCube",
+        table=fact,
+        title="客户销售Cube",
+        measures=[
+            {"name": "quantity", "col": "quantity", "agg": "sum", "title": "销售数量"},
+            {"name": "sales_amount", "col": "sales_amount", "agg": "sum", "title": "销售金额"},
+            {"name": "order_count", "col": "order_id", "agg": "uniq", "title": "订单数"},
+        ],
+        dimensions=[
+            {"name": "customer_id", "col": "customer_id", "type": "string", "title": "客户ID"},
+            {"name": "customer_region", "col": "customer_region", "type": "string", "title": "销售区域"},
+            {"name": "customer_type", "col": "customer_type", "type": "string", "title": "客户类型"},
+        ],
+    )
+    output.print("OK CustomerSalesCube")
+
+    s.register_cube(
+        name="ChannelSalesCube",
+        table=fact,
+        title="渠道销售Cube",
+        measures=[
+            {"name": "quantity", "col": "quantity", "agg": "sum", "title": "销售数量"},
+            {"name": "sales_amount", "col": "sales_amount", "agg": "sum", "title": "销售金额"},
+            {"name": "order_count", "col": "order_id", "agg": "uniq", "title": "订单数"},
+        ],
+        dimensions=[
+            {"name": "channel_id", "col": "channel_id", "type": "string", "title": "渠道ID"},
+        ],
+    )
+    output.print("OK ChannelSalesCube")
+
+    s.register_cube(
+        name="TimeSalesCube",
+        table=fact,
+        title="时间维度销售Cube",
+        measures=[
+            {"name": "sales_amount", "col": "sales_amount", "agg": "sum", "title": "销售金额"},
+            {"name": "quantity", "col": "quantity", "agg": "sum", "title": "销售数量"},
+            {"name": "order_count", "col": "order_id", "agg": "uniq", "title": "订单数"},
+        ],
+        dimensions=[
+            {"name": "order_date", "col": "order_date", "type": "date", "title": "订单日期"},
+            {"name": "year_month", "col": "order_date", "type": "string", "title": "年月"},
+            {"name": "quarter", "col": "order_date", "type": "string", "title": "季度"},
+            {"name": "year", "col": "order_date", "type": "date", "title": "年份"},
+        ],
+    )
+    output.print("OK TimeSalesCube")
+
+    # 5. 派生度量
+    output.print("\n[5/9] 配置派生度量...")
+
+    s.upsert_derived_measures(
+        "SalesCube",
+        [
+            {
+                "name": "avg_unit_price",
+                "title": "平均单价",
+                "expression": "if(SalesCube.quantity > 0, SalesCube.sales_amount / SalesCube.quantity, 0)",
+                "description": "销售金额/销量",
+            },
+            {
+                "name": "avg_order_value",
+                "title": "客单价",
+                "expression": "if(SalesCube.order_count > 0, SalesCube.sales_amount / SalesCube.order_count, 0)",
+                "description": "销售金额/订单数",
+            },
+        ],
+    )
+    s.upsert_derived_measures(
+        "ProductSalesCube",
+        [
+            {
+                "name": "avg_unit_price",
+                "title": "平均单价",
+                "expression": "if(ProductSalesCube.quantity > 0, ProductSalesCube.sales_amount / ProductSalesCube.quantity, 0)",
+                "description": "平均成交单价",
+            },
+        ],
+    )
+    s.upsert_derived_measures(
+        "CustomerSalesCube",
+        [
+            {
+                "name": "avg_order_value",
+                "title": "客单价",
+                "expression": "if(CustomerSalesCube.order_count > 0, CustomerSalesCube.sales_amount / CustomerSalesCube.order_count, 0)",
+                "description": "客户客单价",
+            },
+        ],
+    )
+    output.print("OK 派生度量")
+
+    # 6. 对象类型
+    output.print("\n[6/9] 定义对象类型...")
+
+    object_types = [
+        ("Product", "产品", "可售产品业务对象"),
+        ("Customer", "客户", "购买方业务对象"),
+        ("SalesChannel", "销售渠道", "渠道业务对象"),
+        ("SalesOrder", "销售订单", "订单/订单行业务对象"),
+        ("SalesAnalysis", "销售分析", "多维度销售指标聚合对象"),
+    ]
+    for code, name, desc in object_types:
+        s.onto.define_object_type(code, name, description=desc)
+        output.print(f"OK {code}")
+
+    # 7. 绑定数据源
+    output.print("\n[7/9] 绑定数据源...")
+
+    bindings = [
+        ("Product", "ProductSalesCube"),
+        ("Customer", "CustomerSalesCube"),
+        ("SalesChannel", "ChannelSalesCube"),
+        ("SalesOrder", "SalesCube"),
+        ("SalesAnalysis", "SalesCube"),
+    ]
+    for obj, cube in bindings:
+        s.onto.bind_source(obj, "dazi_cube", config={"cube": cube})
+        output.print(f"OK {obj} -> {cube}")
+
+    # 8. 属性
+    output.print("\n[8/9] 定义属性...")
+
+    def define_props(obj_code, props):
+        for code, name, role, qn in props:
+            s.onto.define_property(obj_code, code, name, semantic_role=role, qualified_name=qn)
+
+    define_props("Product", [
+        ("id", "产品ID", "dimension", "ProductSalesCube.product_id"),
+        ("category", "产品大类", "dimension", "ProductSalesCube.product_category"),
+        ("quantity", "累计销量", "measure", "ProductSalesCube.quantity"),
+        ("sales_amount", "累计销售额", "measure", "ProductSalesCube.sales_amount"),
+        ("order_count", "订单数", "measure", "ProductSalesCube.order_count"),
+        ("avg_unit_price", "平均单价", "measure", "ProductSalesCube.avg_unit_price"),
+    ])
+    output.print("OK Product 属性 (6)")
+
+    define_props("Customer", [
+        ("id", "客户ID", "dimension", "CustomerSalesCube.customer_id"),
+        ("region", "销售区域", "dimension", "CustomerSalesCube.customer_region"),
+        ("type", "客户类型", "dimension", "CustomerSalesCube.customer_type"),
+        ("sales_amount", "累计销售额", "measure", "CustomerSalesCube.sales_amount"),
+        ("order_count", "订单数", "measure", "CustomerSalesCube.order_count"),
+        ("avg_order_value", "客单价", "measure", "CustomerSalesCube.avg_order_value"),
+    ])
+    output.print("OK Customer 属性 (6)")
+
+    define_props("SalesChannel", [
+        ("id", "渠道ID", "dimension", "ChannelSalesCube.channel_id"),
+        ("sales_amount", "销售额", "measure", "ChannelSalesCube.sales_amount"),
+        ("order_count", "订单数", "measure", "ChannelSalesCube.order_count"),
+    ])
+    output.print("OK SalesChannel 属性 (3)")
+
+    define_props("SalesOrder", [
+        ("id", "订单ID", "dimension", "SalesCube.order_id"),
+        ("line_id", "订单行", "dimension", "SalesCube.order_line_id"),
+        ("date", "订单日期", "dimension", "SalesCube.order_date"),
+        ("quantity", "数量", "measure", "SalesCube.quantity"),
+        ("sales_amount", "销售金额", "measure", "SalesCube.sales_amount"),
+        ("unit_price", "成交单价", "measure", "SalesCube.avg_unit_price"),
+    ])
+    output.print("OK SalesOrder 属性 (6)")
+
+    define_props("SalesAnalysis", [
+        ("date", "日期", "dimension", "SalesCube.order_date"),
+        ("product_category", "产品大类", "dimension", "SalesCube.product_category"),
+        ("customer_region", "销售区域", "dimension", "SalesCube.customer_region"),
+        ("channel_id", "渠道", "dimension", "SalesCube.channel_id"),
+        ("quantity", "销量", "measure", "SalesCube.quantity"),
+        ("sales_amount", "销售额", "measure", "SalesCube.sales_amount"),
+        ("order_count", "订单数", "measure", "SalesCube.order_count"),
+        ("avg_order_value", "客单价", "measure", "SalesCube.avg_order_value"),
+    ])
+    output.print("OK SalesAnalysis 属性 (8)")
+
+    # 9. 链接类型
+    output.print("\n[9/9] 定义链接与同步指标...")
+
+    link_types = [
+        ("order_contains_product", "订单包含产品", "SalesOrder", "Product", "订单行对应产品"),
+        ("order_belongs_customer", "订单归属客户", "SalesOrder", "Customer", "订单归属客户"),
+        ("order_via_channel", "订单经渠道成交", "SalesOrder", "SalesChannel", "订单销售渠道"),
+        ("product_has_orders", "产品有订单", "Product", "SalesOrder", "产品被哪些订单购买"),
+        ("customer_places_orders", "客户下单", "Customer", "SalesOrder", "客户历史订单"),
+        ("analysis_by_product", "分析归因产品", "SalesAnalysis", "Product", "指标按产品切片"),
+        ("analysis_by_customer", "分析归因客户", "SalesAnalysis", "Customer", "指标按客户切片"),
+        ("analysis_by_channel", "分析归因渠道", "SalesAnalysis", "SalesChannel", "指标按渠道切片"),
+    ]
+    for code, name, from_obj, to_obj, desc in link_types:
+        s.onto.define_link_type(
+            code=code,
+            name=name,
+            from_object_type_code=from_obj,
+            to_object_type_code=to_obj,
+            description=desc,
+        )
+        output.print(f"OK {code}")
+
+    s.sync_metric_refs()
+    output.print("OK sync_metric_refs")
+
+    summary = {
+        "ok": True,
+        "space_id": space_id,
+        "tables": 4,
+        "table_relationships": 3,
+        "cubes": 5,
+        "object_types": 5,
+        "properties": 29,
+        "link_types": 8,
+    }
+
+    output.print("\n=== 产品销售本体初始化完成 ===")
+    output.success("初始化成功")
+    output.print("__JSON_SUMMARY__" + json.dumps(summary, ensure_ascii=True, default=str))

package/dist/examples/onto//351/224/200/345/224/256/347/244/272/344/276/213/setup/sales_seed_data.py

@@ -0,0 +1,124 @@
+"""产品销售演示数据灌入 — space__zlj
+
+前置：先执行 sales_ontology_init.py 建表。
+幂等：sales_order_fact 已有数据则跳过。
+
+放置：项目/潘达石化/本体/ontos/产品销售本体方案/setup/sales_seed_data.py
+发布：dazi onto script publish 项目/潘达石化/本体/ontos/产品销售本体方案/setup/sales_seed_data.py --space space__zlj --type data
+"""
+
+import json
+import random
+from datetime import date, datetime, timedelta
+
+_SEED_DT = datetime(2025, 1, 1, 0, 0, 0)
+
+
+def main():
+    space_id = "space__zlj"
+    s = space.get(space_id)
+
+    output.print("=== 产品销售演示数据灌入 ===")
+
+    try:
+        n = int(s.sql.query_one("SELECT count() FROM sales_order_fact") or 0)
+    except Exception:
+        n = 0
+    if n > 0:
+        output.print(f"sales_order_fact 已有 {n} 行，跳过灌数")
+        output.print("__JSON_SUMMARY__" + json.dumps({"ok": True, "skipped": True, "rows": n}, ensure_ascii=True))
+        return
+
+    products = [
+        {"product_id": "P001", "product_code": "OIL-92", "product_name": "92号汽油", "product_category": "成品油", "product_subcategory": "汽油", "brand": "潘达", "unit": "吨", "list_price": 8200.0, "cost_price": 7100.0, "status": "在售"},
+        {"product_id": "P002", "product_code": "OIL-0", "product_name": "0号柴油", "product_category": "成品油", "product_subcategory": "柴油", "brand": "潘达", "unit": "吨", "list_price": 7500.0, "cost_price": 6500.0, "status": "在售"},
+        {"product_id": "P003", "product_code": "CHEM-LLDPE", "product_name": "线性低密度聚乙烯", "product_category": "化工品", "product_subcategory": "聚乙烯", "brand": "潘达", "unit": "吨", "list_price": 9200.0, "cost_price": 8100.0, "status": "在售"},
+        {"product_id": "P004", "product_code": "CHEM-PP", "product_name": "聚丙烯PP", "product_category": "化工品", "product_subcategory": "聚丙烯", "brand": "潘达", "unit": "吨", "list_price": 8800.0, "cost_price": 7800.0, "status": "在售"},
+        {"product_id": "P005", "product_code": "LUB-BASE", "product_name": "润滑油基础油", "product_category": "润滑油", "product_subcategory": "基础油", "brand": "潘达", "unit": "吨", "list_price": 6800.0, "cost_price": 5900.0, "status": "在售"},
+        {"product_id": "P006", "product_code": "COKE-1", "product_name": "石油焦", "product_category": "副产品", "product_subcategory": "石油焦", "brand": "潘达", "unit": "吨", "list_price": 3200.0, "cost_price": 2600.0, "status": "在售"},
+    ]
+    for p in products:
+        p["created_at"] = _SEED_DT
+        p["updated_at"] = _SEED_DT
+
+    customers = [
+        {"customer_id": "C001", "customer_code": "CUS-001", "customer_name": "华东油品经销", "customer_region": "华东", "customer_type": "战略", "industry": "经销"},
+        {"customer_id": "C002", "customer_code": "CUS-002", "customer_name": "华北炼化贸易", "customer_region": "华北", "customer_type": "VIP", "industry": "贸易"},
+        {"customer_id": "C003", "customer_code": "CUS-003", "customer_name": "华南化工采购", "customer_region": "华南", "customer_type": "VIP", "industry": "化工"},
+        {"customer_id": "C004", "customer_code": "CUS-004", "customer_name": "西南区域物流", "customer_region": "西南", "customer_type": "普通", "industry": "物流"},
+        {"customer_id": "C005", "customer_code": "CUS-005", "customer_name": "华中制造集团", "customer_region": "华中", "customer_type": "普通", "industry": "制造"},
+    ]
+    for c in customers:
+        c["created_at"] = _SEED_DT
+
+    channels = [
+        {"channel_id": "CH01", "channel_code": "DIR", "channel_name": "直销", "channel_type": "直销"},
+        {"channel_id": "CH02", "channel_code": "DIST", "channel_name": "经销渠道", "channel_type": "经销"},
+        {"channel_id": "CH03", "channel_code": "B2B", "channel_name": "B2B平台", "channel_type": "线上"},
+    ]
+
+    s.sql.insert_rows("product_master", products)
+    s.sql.insert_rows("customer_dimension", customers)
+    s.sql.insert_rows("channel_dimension", channels)
+    output.print("OK 维表数据")
+
+    random.seed(627)
+    regions = {c["customer_id"]: c["customer_region"] for c in customers}
+    ctypes = {c["customer_id"]: c["customer_type"] for c in customers}
+    pcats = {p["product_id"]: p["product_category"] for p in products}
+    prices = {p["product_id"]: p["list_price"] for p in products}
+
+    fact_rows = []
+    line_seq = 1
+    start = date(2025, 1, 1)
+    end = date(2026, 6, 30)
+    days = (end - start).days + 1
+
+    for d_offset in range(days):
+        order_date = start + timedelta(days=d_offset)
+        if random.random() > 0.35:
+            continue
+        daily_orders = random.randint(2, 8)
+        for _ in range(daily_orders):
+            order_id = f"O{order_date.strftime('%Y%m%d')}{random.randint(100, 999)}"
+            customer_id = random.choice(list(regions.keys()))
+            channel_id = random.choice(["CH01", "CH02", "CH03"])
+            lines = random.randint(1, 3)
+            for _ in range(lines):
+                product_id = random.choice(list(pcats.keys()))
+                qty = random.randint(5, 200)
+                unit_price = round(prices[product_id] * random.uniform(0.92, 1.0), 2)
+                discount = round(unit_price * qty * random.uniform(0, 0.05), 2)
+                sales_amount = round(unit_price * qty - discount, 2)
+                fact_rows.append({
+                    "order_id": order_id,
+                    "order_line_id": f"L{line_seq:06d}",
+                    "order_date": order_date,
+                    "product_id": product_id,
+                    "product_category": pcats[product_id],
+                    "customer_id": customer_id,
+                    "customer_region": regions[customer_id],
+                    "customer_type": ctypes[customer_id],
+                    "channel_id": channel_id,
+                    "quantity": qty,
+                    "unit_price": unit_price,
+                    "discount_amount": discount,
+                    "sales_amount": sales_amount,
+                    "currency": "CNY",
+                    "order_status": random.choice(["已完成", "已完成", "已发货"]),
+                })
+                line_seq += 1
+
+    inserted = s.sql.insert_rows("sales_order_fact", fact_rows)
+    output.print(f"OK 销售事实表插入 {inserted} 行")
+
+    summary = {
+        "ok": True,
+        "space_id": space_id,
+        "products": len(products),
+        "customers": len(customers),
+        "channels": len(channels),
+        "fact_inserted": inserted,
+    }
+    output.success("灌数完成")
+    output.print("__JSON_SUMMARY__" + json.dumps(summary, ensure_ascii=True, default=str))

package/dist/prompts/flow/ai-workflow-playbook.md

@@ -58,9 +58,11 @@ dazi flow run flow-exec --dir . --type debug
 
 - [ ] `doctor` 为 ✅
 - [ ] 配置变更已 `push --canvas`
-- [ ] 代码变更已 `node push`
+- [ ] 改 `code.*` 后已 **`node push`**（先于 `node-exec`）
+- [ ] `node-exec` JSON `success: true`
+- [ ] 有 `output_variable_name` 时已 **`variable pull`** 且 `变量/<名>.json` 合理
 - [ ] `flow.json` 无代码正文
-- [ ] 测试通过后再声称完成
+- [ ] 以上均满足后再声称完成（禁止仅凭 exit code、禁止未 push 就测代码）
 
 ---
 

package/dist/prompts/flow/flow-design.md

@@ -66,12 +66,13 @@ dazi flow node new --type <node_type> --dir . --label "<节点名>"
 
 # 3) 修改 flow.json（节点配置与连线）+ 修改 节点/<名>/code.*
 
-# 4) 单节点测试
-dazi flow run node-exec --node <node_uuid> --dir .
-
-# 5) 提交（代码可用 node push；拓扑/配置变更必须 canvas push）
+# 4) 提交（先于测试；node-exec 跑的是平台已 push 的代码）
+dazi flow project push --dir . --canvas   # 若改了拓扑/配置
 dazi flow node push --node <node_uuid> --dir .
-dazi flow project push --dir . --canvas
+
+# 5) 单节点测试 + 核对输出变量
+dazi flow run node-exec --node <node_uuid> --dir .
+dazi flow variable pull --name <output_variable_name> --dir .   # 若节点配置了输出变量
 ```
 
 ## 一致性检查（回答末尾必须自检）
@@ -85,7 +86,9 @@ dazi flow project push --dir . --canvas
 
 设计/改代码**不能**只交付文件清单；必须进入 **改错循环**（详见 `flow/run-fix-loop` 与流程目录 `快速启动_<流程名>.md` §AI 自主运行与改错闭环）：
 
-1. 对每个代码节点执行 `node-exec`；必要时整流程 `flow-exec --type debug`
-2. 失败时读取 `_run/*.last-error.md`，按错误分类修复后重跑（默认最多 3 轮）
-3. 全部通过后再 `node push` / `project push --canvas`
-4. **禁止**未实际运行就声称「设计已完成/已通过」
+1. 改 `code.*` 后先 `node push`；改画布/配置先 `project push --canvas`
+2. 对每个代码节点执行 `node-exec`；有 `output_variable_name` 时 `variable pull` 核对
+3. 必要时整流程 `flow-exec --type debug`
+4. 失败时读取 `_run/*.last-error.md`，按错误分类修复后重跑（默认最多 3 轮，详见 `flow/run-fix-loop`）
+5. **成功判据**：push 成功 → node-exec `success: true` → variable 合理（若适用）
+6. **禁止**未 push 就测代码；**禁止**未实际运行就声称「设计已完成/已通过」