agentworkshop 0.8.6 → 0.8.7

package/.AgentWorkShop/prompts/host-tools.en.json

@@ -3,17 +3,39 @@
     "description": "Query historical/live data for DAQ nodes you can access. Access is granted either by direct node binding or by the channel's line binding (read-only for all DAQ nodes on that line). Filters: line/product/recipe/run/time window/downsampling (product and recipe filters use per-sample tags, so a specific batch can be selected precisely). Results carry physical meaning (semantics, unit, range, statistics, recent series). By default only the **current active batch (active recipe)** is queried; pass scope=all explicitly to compare across recipes or review full history.",
     "parameters": {
       "properties": {
-        "node_id": { "description": "Restrict to one DAQ node id (default: all bound nodes)" },
-        "line_id": { "description": "Filter by line (data ownership)" },
-        "product_id": { "description": "Filter by product (per-sample tags); passing it overrides the default active-batch filter" },
-        "recipe_id": { "description": "Filter by recipe (per-sample tags); passing it overrides the default filter. Default: the active recipe of the node's line (no filter if the line is not running)" },
-        "run_id": { "description": "Filter by run id (pin one run when a recipe was started multiple times); passing it overrides the default filter" },
-        "scope": { "description": "Scope: active (default) = current active batch only; all = no recipe filter, return every sample in the window (cross-recipe comparison/history review)" },
-        "last_minutes": { "description": "Last N minutes (default 30)" },
-        "from_ms": { "description": "Start epoch ms (paired with to_ms; takes precedence over last_minutes)" },
-        "to_ms": { "description": "End epoch ms" },
-        "bucket_ms": { "description": "Downsampling bucket width in ms (default {queryDefaultBucketMs}, floor {queryMinBucketMs})" },
-        "limit": { "description": "Maximum number of points returned (default 500)" }
+        "node_id": {
+          "description": "Restrict to one DAQ node id (default: all bound nodes)"
+        },
+        "line_id": {
+          "description": "Filter by line (data ownership)"
+        },
+        "product_id": {
+          "description": "Filter by product (per-sample tags); passing it overrides the default active-batch filter"
+        },
+        "recipe_id": {
+          "description": "Filter by recipe (per-sample tags); passing it overrides the default filter. Default: the active recipe of the node's line (no filter if the line is not running)"
+        },
+        "run_id": {
+          "description": "Filter by run id (pin one run when a recipe was started multiple times); passing it overrides the default filter"
+        },
+        "scope": {
+          "description": "Scope: active (default) = current active batch only; all = no recipe filter, return every sample in the window (cross-recipe comparison/history review)"
+        },
+        "last_minutes": {
+          "description": "Last N minutes (default 30)"
+        },
+        "from_ms": {
+          "description": "Start epoch ms (paired with to_ms; takes precedence over last_minutes)"
+        },
+        "to_ms": {
+          "description": "End epoch ms"
+        },
+        "bucket_ms": {
+          "description": "Downsampling bucket width in ms (default {queryDefaultBucketMs}, floor {queryMinBucketMs})"
+        },
+        "limit": {
+          "description": "Maximum number of points returned (default 500)"
+        }
       }
     }
   },
@@ -21,76 +43,132 @@
     "description": "List recipe definitions on lines you can read (find recipe_id / the currently running recipe / product ownership). Each entry includes recipe id, version, product, whether it is running, parameter count, each node's target and PLC value, and last good batch. Supports line_id/product_id/keyword filters. Use this first when unsure of a recipe_id; recipe_apply/recipe_trial/recipe_update can also take line_id and resolve the active recipe. Read-only.",
     "parameters": {
       "properties": {
-        "line_id": { "description": "Restrict to a line id (must be readable)" },
-        "product_id": { "description": "Restrict to a product id" },
-        "q": { "description": "Keyword substring filter (recipe name/description)" },
-        "limit": { "description": "Maximum rows (default 20, max 100)" }
+        "line_id": {
+          "description": "Restrict to a line id (must be readable)"
+        },
+        "product_id": {
+          "description": "Restrict to a product id"
+        },
+        "q": {
+          "description": "Keyword substring filter (recipe name/description)"
+        },
+        "limit": {
+          "description": "Maximum rows (default 20, max 100)"
+        }
       }
     }
   },
   "recipe_update": {
-    "description": "Save verified best parameters into a recipe as a new version with attribution and rationale. You may target the currently running recipe by passing only line_id (resolved from the active batch), or pass recipe_id explicitly. Permission model (two tracks): version operations require a recipe binding (kind='recipe', multiple bindings allowed) — a DCW node binding is a point-level write grant and does not grant version rights; the recipe's secondary auth must pass; the recipe must be running (run gate). With a manual binding or manual line, the save suspends for human approval — reason is required and must cite evidence (DAQ data/analysis); the approval card shows it. This changes the definition only; use recipe_apply to push parameters to the running line.",
+    "description": "Save verified best parameters into a recipe as a new version with attribution and rationale. You may target the currently running recipe by passing only line_id (resolved from the active batch), or pass recipe_id explicitly. Permission model (three tracks): version operations require recipe-level authorization — a recipe binding (kind='recipe') or a line recipe-management grant (kind='line-recipe', valid for every recipe on that line); a DCW node binding is a point-level write grant and does not grant version rights; the recipe's secondary auth must pass; the recipe must be running (run gate). With a manual binding or manual line, the save suspends for human approval — reason is required and must cite evidence (DAQ data/analysis); the approval card shows it. This changes the definition only; use recipe_apply to push parameters to the running line.",
     "parameters": {
       "properties": {
-        "recipe_id": { "description": "Recipe id (mutually exclusive with line_id; explicit id wins)" },
+        "recipe_id": {
+          "description": "Recipe id (mutually exclusive with line_id; explicit id wins)"
+        },
         "params": {
           "description": "Parameters to update (partial merge; list only nodes that change)",
           "items": {
             "properties": {
-              "node_id": { "description": "DCW node id (must be one of your bound DCW nodes)" },
-              "value": { "description": "New target value" },
-              "min": { "description": "Optional new recipe window lower bound" },
-              "max": { "description": "Optional new recipe window upper bound" }
+              "node_id": {
+                "description": "DCW node id (must be one of your bound DCW nodes)"
+              },
+              "value": {
+                "description": "New target value"
+              },
+              "min": {
+                "description": "Optional new recipe window lower bound"
+              },
+              "max": {
+                "description": "Optional new recipe window upper bound"
+              }
             }
           }
         },
-        "reason": { "description": "Why this change is saved (required; state the evidence)" },
-        "task_id": { "description": "Optional related task id" },
-        "line_id": { "description": "Line id (mutually exclusive with recipe_id): resolve the recipe from that line's active batch" }
+        "reason": {
+          "description": "Why this change is saved (required; state the evidence)"
+        },
+        "task_id": {
+          "description": "Optional related task id"
+        },
+        "line_id": {
+          "description": "Line id (mutually exclusive with recipe_id): resolve the recipe from that line's active batch"
+        }
       }
     }
   },
   "recipe_apply": {
-    "description": "Dispatch the recipe's currently persisted parameters to the running line as one batch (use after recipe_update). You may target the running recipe with only line_id (resolved from the active batch) or pass recipe_id explicitly. Permission model (two tracks): a recipe binding (kind='recipe') covers the whole batch; alternatively every parameter node of the recipe must be inside your DCW node binding face (kind='dcw' point-level write grant). Both require secondary auth and the run gate (recipe must be executing). With a manual binding or manual line, dispatch suspends for human approval — reason is required and must explain why and on what evidence. After approval the batch goes through governance interlocks (range/step/rate) with per-parameter acknowledgements. A rejection may include guidance; revise and resubmit.",
+    "description": "Dispatch the recipe's currently persisted parameters to the running line as one batch (use after recipe_update). You may target the running recipe with only line_id (resolved from the active batch) or pass recipe_id explicitly. Permission model (three tracks): a recipe binding (kind='recipe') or a line recipe-management grant (kind='line-recipe') covers the whole batch; alternatively every parameter node must be inside your DCW node binding face (kind='dcw'). With DCW bindings, dispatch narrows to those points; with none, a recipe-level grant allows all params (backward compatible). Both require secondary auth and the run gate (recipe must be executing). With a manual binding or manual line, dispatch suspends for human approval — reason is required and must explain why and on what evidence. After approval the batch goes through governance interlocks (range/step/rate) with per-parameter acknowledgements. A rejection may include guidance; revise and resubmit.",
     "parameters": {
       "properties": {
-        "recipe_id": { "description": "Recipe id (mutually exclusive with line_id; explicit id wins)" },
-        "reason": { "description": "Why dispatch (required): data evidence/trial conclusion/goal-gap analysis; the line expert must understand your reasoning on the approval card" },
-        "emergency": { "description": "Emergency exemption from the recipe dispatch rate limit (does NOT skip approval; the card is marked [EMERGENCY] and still needs a human; abuse is audited)" },
-        "line_id": { "description": "Line id (mutually exclusive with recipe_id): resolve the recipe from the active batch; use to dispatch to the current recipe" }
+        "recipe_id": {
+          "description": "Recipe id (mutually exclusive with line_id; explicit id wins)"
+        },
+        "reason": {
+          "description": "Why dispatch (required): data evidence/trial conclusion/goal-gap analysis; the line expert must understand your reasoning on the approval card"
+        },
+        "emergency": {
+          "description": "Emergency exemption from the recipe dispatch rate limit (does NOT skip approval; the card is marked [EMERGENCY] and still needs a human; abuse is audited)"
+        },
+        "line_id": {
+          "description": "Line id (mutually exclusive with recipe_id): resolve the recipe from the active batch; use to dispatch to the current recipe"
+        }
       }
     }
   },
   "recipe_trial": {
-    "description": "Dispatch a multi-parameter candidate batch without writing a recipe version. You may target the running recipe with only line_id or pass recipe_id explicitly. Permission model (two tracks): a recipe binding (kind='recipe') covers the whole batch; alternatively every candidate node must be inside your DCW node binding face (kind='dcw' point-level write grant that survives recipe switches; partial coverage is rejected with the missing node list). Both require secondary auth and the run gate; candidates may only cover parameters in the recipe. With a manual binding or manual line, the trial suspends for human approval — hypothesis is required (why this trial and on what evidence). The whole batch lands at once; after re-measurement, persist improvement with recipe_update or roll back with recipe_rollback(dispatch=true). Subject to the per-line trial interval (default >=5 minutes) and the four-layer limits.",
+    "description": "Dispatch a multi-parameter candidate batch without writing a recipe version. You may target the running recipe with only line_id or pass recipe_id explicitly. Permission model (three tracks): a recipe binding (kind='recipe') or a line recipe-management grant (kind='line-recipe') covers the whole batch; alternatively every candidate node must be inside your DCW node binding face (kind='dcw' point-level write grant that survives recipe switches). Note: an agent with DCW bindings can only dispatch to those points (partial coverage is rejected with the missing node list); with no DCW bindings at all, a recipe-level grant allows all recipe params (backward compatible). Both require secondary auth and the run gate; candidates may only cover parameters in the recipe. With a manual binding or manual line, the trial suspends for human approval — hypothesis is required (why this trial and on what evidence). The whole batch lands at once; after re-measurement, persist improvement with recipe_update or roll back with recipe_rollback(dispatch=true). Subject to the per-line trial interval (default >=5 minutes) and the four-layer limits.",
     "parameters": {
       "properties": {
-        "recipe_id": { "description": "Recipe id (mutually exclusive with line_id; explicit id wins)" },
+        "recipe_id": {
+          "description": "Recipe id (mutually exclusive with line_id; explicit id wins)"
+        },
         "params": {
           "description": "Candidate parameters (>=1; include every change in one batch to avoid oscillation)",
           "items": {
             "properties": {
-              "node_id": { "description": "DCW node id" },
-              "value": { "description": "Candidate engineering value" }
+              "node_id": {
+                "description": "DCW node id"
+              },
+              "value": {
+                "description": "Candidate engineering value"
+              }
             }
           }
         },
-        "hypothesis": { "description": "Trial hypothesis/rationale (required: knowledge-base entry or data analysis conclusion)" },
-        "emergency": { "description": "Emergency exemption from the recipe dispatch rate limit (does NOT skip approval; the card is marked [EMERGENCY] and still needs a human; abuse is audited)" },
-        "line_id": { "description": "Line id (mutually exclusive with recipe_id): resolve the active recipe" }
+        "hypothesis": {
+          "description": "Trial hypothesis/rationale (required: knowledge-base entry or data analysis conclusion)"
+        },
+        "emergency": {
+          "description": "Emergency exemption from the recipe dispatch rate limit (does NOT skip approval; the card is marked [EMERGENCY] and still needs a human; abuse is audited)"
+        },
+        "line_id": {
+          "description": "Line id (mutually exclusive with recipe_id): resolve the active recipe"
+        }
       }
     }
   },
   "recipe_rollback": {
-    "description": "Roll recipe parameters back to a stable version (a historical version or the last good batch) by creating a new non-destructive version; with dispatch=true it also restores the parameters to the line as a batch. Permission model: bound recipe, secondary auth, and run gate; manual bindings suspend for HITL — reason is required (e.g. optimization degradation/out-of-limit).",
+    "description": "Roll recipe parameters back to a stable version (a historical version or the last good batch) by creating a new non-destructive version; with dispatch=true it also restores the parameters to the line as a batch. Permission model: a recipe binding (kind='recipe') or a line recipe-management grant (kind='line-recipe'), secondary auth, and run gate; manual bindings suspend for HITL — reason is required (e.g. optimization degradation/out-of-limit).",
     "parameters": {
       "properties": {
-        "recipe_id": { "description": "Recipe id (required)" },
-        "version": { "description": "Roll back to this historical version (either version or to_last_good)" },
-        "to_last_good": { "description": "true = restore the last good batch parameters" },
-        "reason": { "description": "Rollback reason (required)" },
-        "dispatch": { "description": "true = restore the definition AND re-dispatch parameters to the PLC (use when the optimization loop degrades); default false = definition only" },
-        "emergency": { "description": "Emergency exemption from the recipe dispatch rate limit (does NOT skip approval; still needs a human; abuse is audited)" }
+        "recipe_id": {
+          "description": "Recipe id (required)"
+        },
+        "version": {
+          "description": "Roll back to this historical version (either version or to_last_good)"
+        },
+        "to_last_good": {
+          "description": "true = restore the last good batch parameters"
+        },
+        "reason": {
+          "description": "Rollback reason (required)"
+        },
+        "dispatch": {
+          "description": "true = restore the definition AND re-dispatch parameters to the PLC (use when the optimization loop degrades); default false = definition only"
+        },
+        "emergency": {
+          "description": "Emergency exemption from the recipe dispatch rate limit (does NOT skip approval; still needs a human; abuse is audited)"
+        }
       }
     }
   },
@@ -98,13 +176,27 @@
     "description": "Query recipe change history (create/update/trial/apply/per-parameter ACK/approval/optimization window verdict/rollback/start-batch dispatch; newest first). Returns only scope=line records, each with line and recipe attribution. Pass recipe_id to get the whole event family across kinds (including kind=write dispatch ACKs); line.start/line.stop are included (starting a line dispatches recipe parameters). Without line_id the channel-bound line is used; recipe_id narrows to that recipe's line. Time via from/to or minutes. Use dcw_journal for per-node write history.",
     "parameters": {
       "properties": {
-        "line_id": { "description": "Line id (must be readable; default: channel-bound line, or all readable lines when unbound)" },
-        "recipe_id": { "description": "Filter by recipe id (implies its line)" },
-        "product_id": { "description": "Filter by product id (must belong to a readable line)" },
-        "from": { "description": "Window start (ISO or 2026-10-19T08:00)" },
-        "to": { "description": "Window end (ISO; must be after from)" },
-        "minutes": { "description": "Lookback minutes when from is omitted (default 1440 = 24h)" },
-        "limit": { "description": "Maximum rows (default 20, max 100)" }
+        "line_id": {
+          "description": "Line id (must be readable; default: channel-bound line, or all readable lines when unbound)"
+        },
+        "recipe_id": {
+          "description": "Filter by recipe id (implies its line)"
+        },
+        "product_id": {
+          "description": "Filter by product id (must belong to a readable line)"
+        },
+        "from": {
+          "description": "Window start (ISO or 2026-10-19T08:00)"
+        },
+        "to": {
+          "description": "Window end (ISO; must be after from)"
+        },
+        "minutes": {
+          "description": "Lookback minutes when from is omitted (default 1440 = 24h)"
+        },
+        "limit": {
+          "description": "Maximum rows (default 20, max 100)"
+        }
       }
     }
   },
@@ -112,8 +204,12 @@
     "description": "View the parameter version history of a recipe (old to new): version, time, source (user/agent/system), actor name, change reason, and parameter diff. Use it to confirm a target version before rollback and to review who changed what and why. Visibility = recipe line readable (node-granted line ∪ bound recipe line ∪ channel-bound line). Rollback goes through recipe_rollback (write gate; manual bindings need HITL).",
     "parameters": {
       "properties": {
-        "recipe_id": { "description": "Recipe id (required; visible in line_context)" },
-        "limit": { "description": "Return the latest N versions (default 20, max 50)" }
+        "recipe_id": {
+          "description": "Recipe id (required; visible in line_context)"
+        },
+        "limit": {
+          "description": "Return the latest N versions (default 20, max 50)"
+        }
       }
     }
   },
@@ -121,12 +217,24 @@
     "description": "Fetch data from MES REST points (code-enforced guards: only your bound DCW points; window <=7 days; <=5000 rows; <=6 fetches per 60 seconds). Formats are auto-detected: scalar/vector (thickness profile)/image frame (CCD, persisted automatically)/table/event stream. Responses include field-level dictionaries; with include_data=true, sampled rows carry actual arrays (field names, labels, units, ranges, physical meaning; vector fields also list per-point meaning) so the Agent can reason on meaning, not bare numbers. If no dictionary exists it says so explicitly — do not guess units. Three modes: no from/to = current snapshot; from/to and max_rows<=2000 = synchronous inline; max_rows>2000 = asynchronous CSV dataset plus a same-name *.manifest.json (dictionary/units/ranges/batch attribution), returning job_id/dataset_id. Use mes_export for full raw offline analysis.",
     "parameters": {
       "properties": {
-        "ids": { "description": "Target point id array (ids from mes_catalog; must be your bound DCW points)" },
-        "from": { "description": "Window start ISO time (paired with to; omit both for a current snapshot)" },
-        "to": { "description": "Window end ISO time (paired with from; window <=7 days)" },
-        "max_rows": { "description": "Row cap (default 500, hard cap 5000; >2000 goes to an async dataset)" },
-        "param": { "description": "Business parameters passed through to the point data hook (e.g. {\"lane\":12,\"agg\":\"mean\"}); omit for points without a hook" },
-        "include_data": { "description": "Include actual sampled values/arrays in inline/snapshot responses (vectors show up to 64 points with labels; default false = statistics only)" }
+        "ids": {
+          "description": "Target point id array (ids from mes_catalog; must be your bound DCW points)"
+        },
+        "from": {
+          "description": "Window start ISO time (paired with to; omit both for a current snapshot)"
+        },
+        "to": {
+          "description": "Window end ISO time (paired with from; window <=7 days)"
+        },
+        "max_rows": {
+          "description": "Row cap (default 500, hard cap 5000; >2000 goes to an async dataset)"
+        },
+        "param": {
+          "description": "Business parameters passed through to the point data hook (e.g. {\"lane\":12,\"agg\":\"mean\"}); omit for points without a hook"
+        },
+        "include_data": {
+          "description": "Include actual sampled values/arrays in inline/snapshot responses (vectors show up to 64 points with labels; default false = statistics only)"
+        }
       }
     }
   },
@@ -134,11 +242,21 @@
     "description": "Search the MES REST point catalog (DCW points with driver=mes-rest). Each entry includes id/name/line/unit/range, capability flags (read/write/history/hook), point description, and the field-level data dictionary (field names/labels/units/ranges/vector point count; from the MES response dictionaryPath or node driverConfig.dictionary, cached after the first mes_fetch). This is the addressing entry for mes_fetch/mes_export; supports keyword (q) and line_id filters. Read-only catalog, never touches the device. Visibility = your bound DCW points plus parameter points inside your bound recipes.",
     "parameters": {
       "properties": {
-        "q": { "description": "Keyword substring filter (point name and description)" },
-        "line_id": { "description": "Restrict to a line id" },
-        "limit": { "description": "Maximum rows (default 20, max 100)" },
-        "product_id": { "description": "Narrow to the product's line (rejected if it conflicts with line_id)" },
-        "recipe_id": { "description": "Narrow to the recipe's line (rejected if it conflicts with line_id)" }
+        "q": {
+          "description": "Keyword substring filter (point name and description)"
+        },
+        "line_id": {
+          "description": "Restrict to a line id"
+        },
+        "limit": {
+          "description": "Maximum rows (default 20, max 100)"
+        },
+        "product_id": {
+          "description": "Narrow to the product's line (rejected if it conflicts with line_id)"
+        },
+        "recipe_id": {
+          "description": "Narrow to the recipe's line (rejected if it conflicts with line_id)"
+        }
       }
     }
   },
@@ -146,20 +264,28 @@
     "description": "Read the full picture of the lines/products/recipes you control (read before acting): line scenario description, run state and active batch, product description, active recipe (name/version/description) with per-parameter target vs PLC value vs process window (plus parameter key and description), your bound nodes and recipes (running/not running), and known good batches; when no batch is active, the line's recipe definitions are listed. Visibility = node-granted line ∪ bound recipe line ∪ channel-bound line (read-only). Confirm ownership and state before using recipe_* tools. [Value semantics: value = platform setpoint, readValue = PLC measured feedback; they may differ briefly during hold/heartbeat windows or disconnections — state which one you cite.]",
     "parameters": {
       "properties": {
-        "line_id": { "description": "Restrict to a line id (must be a line of your bound nodes; default: all lines you own)" }
+        "line_id": {
+          "description": "Restrict to a line id (must be a line of your bound nodes; default: all lines you own)"
+        }
       }
     }
   },
   "my_industrial_nodes": {
     "description": "List all your industrial bindings and semantic cards — one card per DCW node (PLC/MES point) and DAQ node: physical quantity/unit/range/precision, process semantics (mechanism and tuning rules), safe range and active-recipe process window, current setpoint, dispatch path (PLC driver or MES writeHook single field), per-step cap and operating rules; plus the recipe operation surface for your bound recipes (run state/binding mode manual=per-action HITL or auto/ secondary auth state/parameter table with keys and descriptions). Call this before any industrial operation. Binding prerequisites: daq/dcw bindings for nodes, recipe bindings for recipes — unbound objects never appear.",
-    "parameters": { "properties": {} }
+    "parameters": {
+      "properties": {}
+    }
   },
   "optimizer_solve": {
     "description": "Solve one optimization problem under your binding authorization (numeric backends: SciPy/OSQP), returning a candidate MV trajectory and first-step suggestion. The channel must be bound to an optimizer profile; with multiple bindings pass binding_id explicitly. Missing optimization eligibility returns a locatable gap instead of fabricating a plan. Recommendations do not grant device write permission.",
     "parameters": {
       "properties": {
-        "binding_id": { "description": "Binding id (required with multiple bindings; optional when unique)" },
-        "timeout_ms": { "description": "Request-level timeout in milliseconds" }
+        "binding_id": {
+          "description": "Binding id (required with multiple bindings; optional when unique)"
+        },
+        "timeout_ms": {
+          "description": "Request-level timeout in milliseconds"
+        }
       }
     }
   },
@@ -167,7 +293,9 @@
     "description": "Read the terminal state, candidates, and recommendation status of an optimization run (read-only). The run must belong to the current agent's binding; cross-agent queries return BINDING_NOT_OWNED.",
     "parameters": {
       "properties": {
-        "run_id": { "description": "Optimization run id (returned by optimizer_solve)" }
+        "run_id": {
+          "description": "Optimization run id (returned by optimizer_solve)"
+        }
       }
     }
   }

package/.AgentWorkShop/prompts/host-tools.json

@@ -1252,7 +1252,7 @@
   {
     "name": "recipe_update",
     "label": "Recipe Update",
-    "description": "把验证过的最佳参数保存进指定配方(生成新版本,带归因与理由)。可直接保存到当前在跑的配方:只传 line_id 时解析活动批次配方;也可显式 recipe_id。权限模型(双轨):版本操作只认配方绑定(kind='recipe',可绑定多个配方)—— 数控节点绑定(dcw)是点位写授权,不授予版本操作权;且通过二级认证;配方必须正在执行(运行门,未运行拒绝);绑定 manual 或产线 manual 时本次保存挂 HITL 等人工批准——reason 必填且要给出判断依据(数采证据/分析结论),审批卡会向人类展示。只改配方定义,要把参数推到运行中的产线用 recipe_apply。",
+    "description": "把验证过的最佳参数保存进指定配方(生成新版本,带归因与理由)。可直接保存到当前在跑的配方:只传 line_id 时解析活动批次配方;也可显式 recipe_id。权限模型(三轨):版本操作需要配方级授权 —— 绑定该配方(kind='recipe')或持有其产线配方管理权(kind='line-recipe',对该线全部配方有效);数控节点绑定(dcw)是点位写授权,不授予版本操作权;且通过二级认证;配方必须正在执行(运行门,未运行拒绝);绑定 manual 或产线 manual 时本次保存挂 HITL 等人工批准——reason 必填且要给出判断依据(数采证据/分析结论),审批卡会向人类展示。只改配方定义,要把参数推到运行中的产线用 recipe_apply。",
     "parameters": {
       "type": "object",
       "properties": {
@@ -1338,7 +1338,7 @@
   {
     "name": "recipe_rollback",
     "label": "Recipe Rollback",
-    "description": "回退配方参数到稳定版本(指定历史版本或已知良好批次),生成新版本(非破坏);dispatch=true 时统一回退(定义回退+参数整批重下发)。权限模型:须已绑定该 recipe 且过二级认证与运行门;绑定 manual 时挂 HITL——reason 必填说明回退原因(如优化劣化/越限)。",
+    "description": "回退配方参数到稳定版本(指定历史版本或已知良好批次),生成新版本(非破坏);dispatch=true 时统一回退(定义回退+参数整批重下发)。权限模型:须持有该配方绑定(kind='recipe')或其产线的配方管理权(kind='line-recipe'),且过二级认证与运行门;绑定 manual 时挂 HITL——reason 必填说明回退原因(如优化劣化/越限)。",
     "parameters": {
       "type": "object",
       "properties": {
@@ -2800,7 +2800,7 @@
   {
     "name": "recipe_trial",
     "label": "Recipe Trial",
-    "description": "多参数候选整批试验下发(不写配方版本)。可直接对当前在跑的配方试验:只传 line_id 时解析活动批次配方;也可显式 recipe_id。权限模型(双轨):绑定该 recipe(kind='recipe')可整批试验;或本次候选覆盖的节点全部在你的数控节点绑定面内(kind='dcw' 节点绑定=点位写授权,换配方仍有效,部分覆盖即拒并列出缺失节点)。均须过二级认证与运行门;候选只能覆盖配方内参数节点;绑定 manual 或产线 manual 时挂 HITL 等人工批准——hypothesis 必填,即本次试验的理由与判断依据。整批一次落产线;复测判读后有进步用 recipe_update 固化,劣化用 recipe_rollback(dispatch=true) 统一回退。受同线试验节拍(默认 ≥5 分钟)与四层限界卡控。",
+    "description": "多参数候选整批试验下发(不写配方版本)。可直接对当前在跑的配方试验:只传 line_id 时解析活动批次配方;也可显式 recipe_id。权限模型(三轨):绑定该 recipe(kind='recipe')或持有其产线配方管理权(kind='line-recipe')可整批;或本次候选覆盖的节点全部在你的数控节点绑定面内(kind='dcw' 点位写授权,换配方仍有效)。注意:绑定了数控节点的 Agent,下发范围收窄到这些点位(部分覆盖即拒并列出缺失节点);未绑定任何数控节点时,持配方级授权即默认对配方全部参数放行(向下兼容)。均须过二级认证与运行门;候选只能覆盖配方内参数节点;绑定 manual 或产线 manual 时挂 HITL 等人工批准——hypothesis 必填,即本次试验的理由与判断依据。整批一次落产线;复测判读后有进步用 recipe_update 固化,劣化用 recipe_rollback(dispatch=true) 统一回退。受同线试验节拍(默认 ≥5 分钟)与四层限界卡控。",
     "parameters": {
       "type": "object",
       "properties": {
@@ -2882,7 +2882,7 @@
   {
     "name": "recipe_apply",
     "label": "Recipe Apply",
-    "description": "把配方当前已固化参数整批下发到运行中的产线(改配方 recipe_update 之后用)。可直接对当前在跑的配方下发:只传 line_id,工具会解析该产线活动批次的 recipe_id;也可显式传 recipe_id。权限模型(双轨):绑定该 recipe(kind='recipe')可整批下发;或配方全部参数节点都在你的数控节点绑定面内(kind='dcw' 点位写授权)。均须过二级认证与运行门(配方须在执行);绑定 manual 或产线 manual 时挂 HITL 等人工批准——reason 必填,说明为什么要下发、依据是什么。批准后整批经治理联锁(量程/步长/限速)下发,逐参数回执;拒绝可附指导,按指导修订后重提。",
+    "description": "把配方当前已固化参数整批下发到运行中的产线(改配方 recipe_update 之后用)。可直接对当前在跑的配方下发:只传 line_id,工具会解析该产线活动批次的 recipe_id;也可显式传 recipe_id。权限模型(三轨):绑定该 recipe(kind='recipe')或持有其产线配方管理权(kind='line-recipe')可整批下发;或配方全部参数节点都在你的数控节点绑定面内(kind='dcw' 点位写授权)。绑定了数控节点的 Agent,下发范围收窄到这些点位;未绑定任何数控节点时,持配方级授权即默认全参数放行(向下兼容)。均须过二级认证与运行门(配方须在执行);绑定 manual 或产线 manual 时挂 HITL 等人工批准——reason 必填,说明为什么要下发、依据是什么。批准后整批经治理联锁(量程/步长/限速)下发,逐参数回执;拒绝可附指导,按指导修订后重提。",
     "parameters": {
       "type": "object",
       "properties": {
@@ -3399,7 +3399,7 @@
   {
     "name": "recipe_create",
     "label": "Recipe Create",
-    "description": "把当前配方或批次冻结参数另存为新配方(仅创建定义,不触发产线)。典型:把优化后当前有效配方+实测参数固化为新产品/新工艺基线;参数来源优先级=显式 params > from_run_id 的批次冻结快照 > source_recipe_id 的配方定义。权限:需在该产线已有写向绑定(数控节点或配方);manual 线/绑定必须人工批准(reason 必填,审批卡展示参数与来源)。新建后不会自动绑定给 Agent——返回文案会提示让用户/lead 在配方管理中绑定后才能 update/apply。",
+    "description": "把当前配方或批次冻结参数另存为新配方(仅创建定义,不触发产线)。典型:把优化后当前有效配方+实测参数固化为新产品/新工艺基线;参数来源优先级=显式 params > from_run_id 的批次冻结快照 > source_recipe_id 的配方定义。权限:需在该产线已有授权锚(数控节点绑定、配方绑定或产线配方管理权 kind='line-recipe',管理权可对该线任意新建);manual 线/绑定必须人工批准(reason 必填,审批卡展示参数与来源)。新建后不会自动绑定给 Agent——返回文案会提示让用户/lead 在配方管理中绑定后才能 update/apply。",
     "parameters": {
       "type": "object",
       "properties": {

package/.output/.AgentWorkShop/aml-python/train-example.py

@@ -1,92 +1,92 @@
-# -*- coding: utf-8 -*-
-"""AML 参考训练实现(one-step 线性基线;e2e --real 模式与 Agent 的起点范本)。
-
-契约:
-  - 数据:amlkit.load_bundle(归一化 float32;x [N,H,nAll] / y [N,F,nTgt]);
-  - 模型:输入 [batch, H, nAll](展平)→ 输出 [batch, nTgt](下一拍目标,归一化);
-  - 产出:amlkit.export_torch_onnx(契约 ONNX)+ amlkit.save_metrics(自报指标,门禁另由平台评估器复算)。
-
-超参经作业 params 传入:lr / epochs / hidden / batch。
-"""
-import json
-import os
-from pathlib import Path
-
-import torch
-import torch.nn as nn
-
-import amlkit
-
-
-def main():
-    job_dir = Path(os.environ["AML_JOB_DIR"]).resolve()
-    job = json.loads((job_dir / "job.json").read_text(encoding="utf-8"))
-    params = job.get("params", {})
-
-    bundle = amlkit.load_bundle(job["datasetPath"])
-    manifest = bundle.manifest
-    h_steps = manifest["shapes"]["x"][1]
-    n_all = manifest["shapes"]["x"][2]
-    n_tgt = manifest["shapes"]["y"][2]
-
-    x_train = bundle.get("x", "train")
-    y_train = bundle.get("y", "train")[:, 0, :]  # 下一拍目标(第 0 个 horizon 步)
-    x_val = bundle.get("x", "val")
-    y_val = bundle.get("y", "val")[:, 0, :]
-
-    hidden = int(params.get("hidden", 128))
-    model = nn.Sequential(
-        nn.Flatten(),
-        nn.Linear(h_steps * n_all, hidden),
-        nn.ReLU(),
-        nn.Linear(hidden, n_tgt),
-    )
-    opt = torch.optim.Adam(model.parameters(), lr=float(params.get("lr", 1e-3)))
-    loss_fn = nn.MSELoss()
-
-    xt = torch.tensor(x_train, dtype=torch.float32)
-    yt = torch.tensor(y_train, dtype=torch.float32)
-    xv = torch.tensor(x_val, dtype=torch.float32) if x_val.shape[0] else None
-    yv = torch.tensor(y_val, dtype=torch.float32) if y_val.shape[0] else None
-
-    epochs = int(params.get("epochs", 80))
-    batch = int(params.get("batch", 256))
-    n = xt.shape[0]
-    best_val = float("inf")
-    train_loss = 0.0
-    val_loss = None
-    for epoch in range(epochs):
-        model.train()
-        perm = torch.randperm(n)
-        total = 0.0
-        for i in range(0, n, batch):
-            idx = perm[i:i + batch]
-            opt.zero_grad()
-            loss = loss_fn(model(xt[idx]), yt[idx])
-            loss.backward()
-            opt.step()
-            total += float(loss) * idx.shape[0]
-        train_loss = total / max(1, n)
-        if xv is not None:
-            model.eval()
-            with torch.no_grad():
-                val_loss = float(loss_fn(model(xv), yv))
-            best_val = min(best_val, val_loss)
-        amlkit.report_progress(5 + 90 * (epoch + 1) // epochs,
-                               "epoch %d/%d train=%.5f val=%s" % (epoch + 1, epochs, train_loss, val_loss if val_loss is not None else "n/a"))
-
-    amlkit.save_metrics({"agent": {
-        "kind": "mlp_one_step_baseline",
-        "epochs": epochs,
-        "train_loss_last": train_loss,
-        "val_loss_best": None if val_loss is None else best_val,
-        "params": params,
-    }})
-
-    amlkit.export_torch_onnx(model, manifest)
-    amlkit.report_progress(99, "exported onnx")
-    print("train-example done")
-
-
-if __name__ == "__main__":
-    main()
+# -*- coding: utf-8 -*-
+"""AML 参考训练实现(one-step 线性基线;e2e --real 模式与 Agent 的起点范本)。
+
+契约:
+  - 数据:amlkit.load_bundle(归一化 float32;x [N,H,nAll] / y [N,F,nTgt]);
+  - 模型:输入 [batch, H, nAll](展平)→ 输出 [batch, nTgt](下一拍目标,归一化);
+  - 产出:amlkit.export_torch_onnx(契约 ONNX)+ amlkit.save_metrics(自报指标,门禁另由平台评估器复算)。
+
+超参经作业 params 传入:lr / epochs / hidden / batch。
+"""
+import json
+import os
+from pathlib import Path
+
+import torch
+import torch.nn as nn
+
+import amlkit
+
+
+def main():
+    job_dir = Path(os.environ["AML_JOB_DIR"]).resolve()
+    job = json.loads((job_dir / "job.json").read_text(encoding="utf-8"))
+    params = job.get("params", {})
+
+    bundle = amlkit.load_bundle(job["datasetPath"])
+    manifest = bundle.manifest
+    h_steps = manifest["shapes"]["x"][1]
+    n_all = manifest["shapes"]["x"][2]
+    n_tgt = manifest["shapes"]["y"][2]
+
+    x_train = bundle.get("x", "train")
+    y_train = bundle.get("y", "train")[:, 0, :]  # 下一拍目标(第 0 个 horizon 步)
+    x_val = bundle.get("x", "val")
+    y_val = bundle.get("y", "val")[:, 0, :]
+
+    hidden = int(params.get("hidden", 128))
+    model = nn.Sequential(
+        nn.Flatten(),
+        nn.Linear(h_steps * n_all, hidden),
+        nn.ReLU(),
+        nn.Linear(hidden, n_tgt),
+    )
+    opt = torch.optim.Adam(model.parameters(), lr=float(params.get("lr", 1e-3)))
+    loss_fn = nn.MSELoss()
+
+    xt = torch.tensor(x_train, dtype=torch.float32)
+    yt = torch.tensor(y_train, dtype=torch.float32)
+    xv = torch.tensor(x_val, dtype=torch.float32) if x_val.shape[0] else None
+    yv = torch.tensor(y_val, dtype=torch.float32) if y_val.shape[0] else None
+
+    epochs = int(params.get("epochs", 80))
+    batch = int(params.get("batch", 256))
+    n = xt.shape[0]
+    best_val = float("inf")
+    train_loss = 0.0
+    val_loss = None
+    for epoch in range(epochs):
+        model.train()
+        perm = torch.randperm(n)
+        total = 0.0
+        for i in range(0, n, batch):
+            idx = perm[i:i + batch]
+            opt.zero_grad()
+            loss = loss_fn(model(xt[idx]), yt[idx])
+            loss.backward()
+            opt.step()
+            total += float(loss) * idx.shape[0]
+        train_loss = total / max(1, n)
+        if xv is not None:
+            model.eval()
+            with torch.no_grad():
+                val_loss = float(loss_fn(model(xv), yv))
+            best_val = min(best_val, val_loss)
+        amlkit.report_progress(5 + 90 * (epoch + 1) // epochs,
+                               "epoch %d/%d train=%.5f val=%s" % (epoch + 1, epochs, train_loss, val_loss if val_loss is not None else "n/a"))
+
+    amlkit.save_metrics({"agent": {
+        "kind": "mlp_one_step_baseline",
+        "epochs": epochs,
+        "train_loss_last": train_loss,
+        "val_loss_best": None if val_loss is None else best_val,
+        "params": params,
+    }})
+
+    amlkit.export_torch_onnx(model, manifest)
+    amlkit.report_progress(99, "exported onnx")
+    print("train-example done")
+
+
+if __name__ == "__main__":
+    main()