@xtalpi/agentic-lab-skills 0.0.10 → 0.0.11

package/skills/lab-flow-designer/embedded-template/valves//347/244/272/344/276/213/346/225/260/346/215/256/344/270/216/346/240/241/351/252/214/351/227/250/346/216/247.md

@@ -1,114 +1,114 @@
-# 示例数据与校验门控
-
-## 概述
-
-演示与真实 Fragment 门控相同的文档结构：**门控 YAML**、**化合物数据查询方式**、**字段映射**、**数据处理规则**、**start/complete 分工**。生成业务流程注册包时，按流程说明替换各节内容；脚本实现须对照 [references/agentic-lab-sdk.md](../../references/agentic-lab-sdk.md)。
-
-## 关联脚本
-
-**脚本路径**: [scripts/示例数据与校验门控.js](scripts/示例数据与校验门控.js)
-
-该脚本导出 `Processer` 类，实现 `start` 和 `complete` 方法。
-
-## 触发方式
-
-人工触发
-
-> 人工触发门控执行顺序：前置处理（脚本 `start`）→ 人工处理（页面）→ 后置处理（脚本 `complete`）。自动触发门控使用 `run` 方法替代 `start` + `complete`，详见 [references/agentic-lab-processer.md](../../references/agentic-lab-processer.md)。
-
-## 模型引用
-
-> 本门控无关联 3D 模型，本节仅作版式示意。实际生成时，无模型引用的门控省略本节。
-
-| 属性 | 值 |
-|------|-----|
-| 名称 | example-valve-model |
-| 版本 | 1.0.0 |
-
-## 门控 YAML（与流程说明对齐）
-
-流程说明中可能使用 `Stash:` 等键表示目标池；生成脚本时按 [agentic-lab-sdk.md](../../references/agentic-lab-sdk.md) 获取出口池，以返回的 **`pool.name`**（或文档中的池显示名称）匹配目标池（`valve_id` 来自 `Processer` 入参）。
-
-```yaml
-valve_id: valve_example_1
-name: 示例数据与校验门控
-order: 1
-input:
-  primary: 入口池
-output:
-  - pool: 出口池
-    condition: 示例：校验通过且已回填必要字段
-```
-
-## 化合物数据查询方式（映射到 Agentic Lab SDK）
-
-| 流程说明中的表述 | 推荐 SDK 调用 |
-|----------------|---------------|
-| 查化合物库存 / 可用量 / 库存汇总 | 按 [agentic-lab-sdk.md](../../references/agentic-lab-sdk.md) 中的化合物库存查询方法 |
-
-## 字段映射（示例：知识库 → ticket.detail）
-
-> **仅供结构演示**：下表中的加工数据名、库侧列名、`detail` 键仅为说明「表格长什么样、如何对齐 snake_case」，**不**绑定任何具体业务；其它流程须整表替换为用户流程说明中的映射。
-
-流程说明中的「门控加工数据 ↔ 库字段」表，在脚本里写入 `ticket.detail` 时建议与 **pools Schema 的「字段」列（snake_case）** 对齐。以下为示意（真实以流程文档表格为准）：
-
-| 门控加工数据 | chemical_record（示例列名） | detail 键（示例） |
-|-------------|------------------------------|------------------|
-| 性状(Chemist) | chemistProperty | chemist_property |
-| 可分装判断 | dispensable | dispensable |
-| 可舀粉判断 | feasibilityOfDipensing | feasibility_of_dipensing |
-
-（真实流程以用户提供的流程说明 Markdown 中表格为准。）
-
-## 数据处理规则（脚本注释应对齐序号）
-
-> **同上**：`1.1` 等序号格式应对齐流程文档；下列规则摘要与动作为**占位示意**（偏分装场景），生成其它业务包时须按流程说明中的规则表重写。
-
-| 序号 | 规则摘要 | 业务动作（示意） |
-|------|----------|------------------|
-| 1.1 | 汇总需求量 | `detail.requested_amount = sum(target_amount_n)` |
-| 1.2 | 缺料判定 | 结合化合物库存查询（SDK）汇总可用量与 `requested_amount` 比较 |
-| 1.3 | 容差默认 | 目标量 >0 且容差空 → 默认 0.5 mg |
-| 1.4 | 缺料标记 | `source_barcode` 空 → `是否缺料` = 缺料 |
-
-## 执行流程
-
-**门控执行顺序：前置处理（脚本 `start`）→ 人工处理（页面）→ 后置处理（脚本 `complete`）**
-
-### 前置处理
-
-| 配置项 | 类别 | 默认值 / 占位 | 说明 |
-| ------ | ---- | -------------- | ---- |
-| bookid | 参数 | 1 | Orbit 页面对应的 BookId，用于拼装 `orbit_link` |
-
-| 规则摘要 | 条件要点 | 业务动作或结果 |
-| -------- | -------- | -------------- |
-| 查询入口池 | 门控启动 | 按 SDK 查询入口池 tickets（分页遵守主 SKILL.md 编写指引 §2） |
-| 查化合物数据 | 有 compound 查询需求 | 按 SDK 查询化合物库存数据 |
-| 写回 detail | 查询完成 | 按映射表与规则表写回 `ticket.detail` → 按 SDK 更新 tickets |
-| 拼装 orbit_link | 返回前 | `PageUrl.replace('{bookid}', bookid)` |
-
-**start 返回**：`{ orbit_link, ticket_ids }`
-
-### 人工处理
-
-##### 界面形态与数据绑定
-
-1. **界面类型**：超级表格
-2. **数据来源**：前置处理写入 `ticket.detail` 的字段
-3. **操作按钮**：刷新 / 检查 / 提交（由 `lab-orbit-component-builder` 技能生成 UI）
-
-### 后置处理
-
-| 规则摘要 | 条件要点 | 业务动作或结果 |
-| -------- | -------- | -------------- |
-| 获取出口池 | 按 SDK 获取出口池 | 按 `pool.name` 匹配出口池 |
-| 更新入口池状态 | 出口池确定 | 入口池 tickets 更新为 `status: 'finished'` → 按 SDK 更新 tickets |
-| 映射出口池记录 | 状态更新完成 | 按出口池 Schema 构建 `new_tickets`（含 `flow_id`、`pool_id`、`order_id`、`detail`、`status: 'created'`、`parent_ticket_id`） |
-
-**complete 返回**：`{ new_tickets }`（由引擎自动创建，脚本不直接追加 tickets）
-
-## 输入/输出
-
-- **输入池**: 入口池
-- **输出池**: 出口池（多出口时与 YAML 中各 `pool`/`Stash` 目标池名称一致）
+# 示例数据与校验门控
+
+## 概述
+
+演示与真实 Fragment 门控相同的文档结构：**门控 YAML**、**化合物数据查询方式**、**字段映射**、**数据处理规则**、**start/complete 分工**。生成业务流程注册包时，按流程说明替换各节内容；脚本实现须对照 [references/agentic-lab-sdk.md](../../references/agentic-lab-sdk.md)。
+
+## 关联脚本
+
+**脚本路径**: [scripts/示例数据与校验门控.js](scripts/示例数据与校验门控.js)
+
+该脚本导出 `Processer` 类，实现 `start` 和 `complete` 方法。
+
+## 触发方式
+
+人工触发
+
+> 人工触发门控执行顺序：前置处理（脚本 `start`）→ 人工处理（页面）→ 后置处理（脚本 `complete`）。自动触发门控使用 `run` 方法替代 `start` + `complete`，详见 [references/agentic-lab-processer.md](../../references/agentic-lab-processer.md)。
+
+## 模型引用
+
+> 本门控无关联 3D 模型，本节仅作版式示意。实际生成时，无模型引用的门控省略本节。
+
+| 属性 | 值 |
+|------|-----|
+| 名称 | example-valve-model |
+| 版本 | 1.0.0 |
+
+## 门控 YAML（与流程说明对齐）
+
+流程说明中可能使用 `Stash:` 等键表示目标池；生成脚本时按 [agentic-lab-sdk.md](../../references/agentic-lab-sdk.md) 获取出口池，以返回的 **`pool.name`**（或文档中的池显示名称）匹配目标池（`valve_id` 来自 `Processer` 入参）。
+
+```yaml
+valve_id: valve_example_1
+name: 示例数据与校验门控
+order: 1
+input:
+  primary: 入口池
+output:
+  - pool: 出口池
+    condition: 示例：校验通过且已回填必要字段
+```
+
+## 化合物数据查询方式（映射到 Agentic Lab SDK）
+
+| 流程说明中的表述 | 推荐 SDK 调用 |
+|----------------|---------------|
+| 查化合物库存 / 可用量 / 库存汇总 | 按 [agentic-lab-sdk.md](../../references/agentic-lab-sdk.md) 中的化合物库存查询方法 |
+
+## 字段映射（示例：知识库 → ticket.detail）
+
+> **仅供结构演示**：下表中的加工数据名、库侧列名、`detail` 键仅为说明「表格长什么样、如何对齐 snake_case」，**不**绑定任何具体业务；其它流程须整表替换为用户流程说明中的映射。
+
+流程说明中的「门控加工数据 ↔ 库字段」表，在脚本里写入 `ticket.detail` 时建议与 **pools Schema 的「字段」列（snake_case）** 对齐。以下为示意（真实以流程文档表格为准）：
+
+| 门控加工数据 | chemical_record（示例列名） | detail 键（示例） |
+|-------------|------------------------------|------------------|
+| 性状(Chemist) | chemistProperty | chemist_property |
+| 可分装判断 | dispensable | dispensable |
+| 可舀粉判断 | feasibilityOfDipensing | feasibility_of_dipensing |
+
+（真实流程以用户提供的流程说明 Markdown 中表格为准。）
+
+## 数据处理规则（脚本注释应对齐序号）
+
+> **同上**：`1.1` 等序号格式应对齐流程文档；下列规则摘要与动作为**占位示意**（偏分装场景），生成其它业务包时须按流程说明中的规则表重写。
+
+| 序号 | 规则摘要 | 业务动作（示意） |
+|------|----------|------------------|
+| 1.1 | 汇总需求量 | `detail.requested_amount = sum(target_amount_n)` |
+| 1.2 | 缺料判定 | 结合化合物库存查询（SDK）汇总可用量与 `requested_amount` 比较 |
+| 1.3 | 容差默认 | 目标量 >0 且容差空 → 默认 0.5 mg |
+| 1.4 | 缺料标记 | `source_barcode` 空 → `是否缺料` = 缺料 |
+
+## 执行流程
+
+**门控执行顺序：前置处理（脚本 `start`）→ 人工处理（页面）→ 后置处理（脚本 `complete`）**
+
+### 前置处理
+
+| 配置项 | 类别 | 默认值 / 占位 | 说明 |
+| ------ | ---- | -------------- | ---- |
+| bookid | 参数 | 1 | Orbit 页面对应的 BookId，用于拼装 `orbit_link` |
+
+| 规则摘要 | 条件要点 | 业务动作或结果 |
+| -------- | -------- | -------------- |
+| 查询入口池 | 门控启动 | 按 SDK 查询入口池 tickets（分页遵守主 SKILL.md 编写指引 §2） |
+| 查化合物数据 | 有 compound 查询需求 | 按 SDK 查询化合物库存数据 |
+| 写回 detail | 查询完成 | 按映射表与规则表写回 `ticket.detail` → 按 SDK 更新 tickets |
+| 拼装 orbit_link | 返回前 | `PageUrl.replace('{bookid}', bookid)` |
+
+**start 返回**：`{ orbit_link, ticket_ids }`
+
+### 人工处理
+
+##### 界面形态与数据绑定
+
+1. **界面类型**：超级表格
+2. **数据来源**：前置处理写入 `ticket.detail` 的字段
+3. **操作按钮**：刷新 / 检查 / 提交（由 `lab-orbit-component-builder` 技能生成 UI）
+
+### 后置处理
+
+| 规则摘要 | 条件要点 | 业务动作或结果 |
+| -------- | -------- | -------------- |
+| 获取出口池 | 按 SDK 获取出口池 | 按 `pool.name` 匹配出口池 |
+| 更新入口池状态 | 出口池确定 | 入口池 tickets 更新为 `status: 'finished'` → 按 SDK 更新 tickets |
+| 映射出口池记录 | 状态更新完成 | 按出口池 Schema 构建 `new_tickets`（含 `flow_id`、`pool_id`、`order_id`、`detail`、`status: 'created'`、`parent_ticket_id`） |
+
+**complete 返回**：`{ new_tickets }`（由引擎自动创建，脚本不直接追加 tickets）
+
+## 输入/输出
+
+- **输入池**: 入口池
+- **输出池**: 出口池（多出口时与 YAML 中各 `pool`/`Stash` 目标池名称一致）

package/skills/lab-flow-designer/references/agentic-lab-processer.md

@@ -1,122 +1,122 @@
-> Agentic Lab 门控脚本
->
-> `this.context` 上可用的 SDK 方法详见 [agentic-lab-sdk.md](agentic-lab-sdk.md)。本文件定义 `Processer` 类的 `start`/`complete`（人工触发门控）与 `run`（自动触发门控）输入输出类型与代码风格。
-
-### 类型定义
-
-#### start
-
-```typescript
-interface StartExecutionParams {
-  valve_id: number;
-  pool_ids: number[];
-  [propName: string]: any;
-}
-
-interface StartExecutionResult {
-  orbit_link: string;
-  ticket_ids: number[];
-  [propName: string]: any;
-}
-
-async start(params: StartExecutionParams): Promise<StartExecutionResult>
-```
-
-#### complete
-
-```typescript
-interface CompleteExecutionParams {
-  valve_id: number;
-  tickets: Record<string, any>[];
-  [propName: string]: any;
-}
-
-interface CompleteExecutionResult {
- new_tickets?: Record<string, any>[]; // 待新增的tickets，由引擎创建到数据表
- [propName: string]: any;
-}
-
-async complete(params: CompleteExecutionParams): Promise<CompleteExecutionResult>
-```
-
-#### run（自动触发门控专用）
-
-自动触发门控不经过人工处理阶段，使用 `run` 替代 `start` + `complete`。`run` 合并了前置与后置处理：接收 `valve_id` 与 `pool_ids`（同 `start`），直接返回 `new_tickets`（同 `complete`），无需 `orbit_link` 或 `ticket_ids`。
-
-```typescript
-interface RunExecutionParams {
-  valve_id: number;
-  pool_ids: number[];
-  [propName: string]: any;
-}
-
-interface RunExecutionResult {
-  new_tickets?: Record<string, any>[]; // 待新增的tickets，由引擎创建到数据表
-  [propName: string]: any;
-}
-
-async run(params: RunExecutionParams): Promise<RunExecutionResult>
-```
-
-
-### 示例（人工触发门控）
-
-```javascript
-class Processer {
-  // context: 执行引擎提供的SDK
-  constructor(context) {
-    this.context = context;
-    console.info(`[Processer] v${__ARTIFACT_VERSION__} (skill: ${__ARTIFACT_SKILL__})`);
-  }
-
-  // params: { valve_id, pool_ids }
-  async start(params) {
-    // 按 agentic-lab-sdk.md 查询入口池数据
-    // 按需调用 SDK 方法查询化合物/工站/流程等外部数据
-    // 将查询结果写回 ticket.detail
-    // 按 agentic-lab-sdk.md 更新 tickets
-    return {
-      orbit_link: 'https://...',
-      ticket_ids: [/* 待处理 ticket ID */],
-    }
-  }
-
-  // params: { valve_id, tickets }
-  async complete(params) {
-    // 按 agentic-lab-sdk.md 获取出口池
-    // 按业务规则筛选可流入出口池的 tickets
-    // 将入口池 tickets 更新为 finished 状态
-    // 按出口池 Schema 映射 new_tickets（脚本不直接追加 tickets，交由引擎自动创建）
-    return {
-      new_tickets: [/* 按出口池映射的新 tickets */]
-    }
-  }
-}
-```
-
-完整可运行代码参考见 [`embedded-template/scripts/示例数据与校验门控.js`](../embedded-template/scripts/示例数据与校验门控.js)。
-
-### 示例（自动触发门控）
-
-```javascript
-class Processer {
-  // context: 执行引擎提供的SDK
-  constructor(context) {
-    this.context = context;
-    console.info(`[Processer] v${__ARTIFACT_VERSION__} (skill: ${__ARTIFACT_SKILL__})`);
-  }
-
-  // params: { valve_id, pool_ids }
-  async run(params) {
-    // 按 agentic-lab-sdk.md 查询入口池数据
-    // 按需调用 SDK 方法查询化合物/工站/流程等外部数据
-    // 执行业务逻辑（无人工处理阶段）
-    // 按 agentic-lab-sdk.md 获取出口池
-    // 将入口池 tickets 更新为 finished 状态
-    // 按出口池 Schema 映射 new_tickets
-    return {
-      new_tickets: [/* 按出口池映射的新 tickets */]
-    }
-  }
-}
-```
+> Agentic Lab 门控脚本
+>
+> `this.context` 上可用的 SDK 方法详见 [agentic-lab-sdk.md](agentic-lab-sdk.md)。本文件定义 `Processer` 类的 `start`/`complete`（人工触发门控）与 `run`（自动触发门控）输入输出类型与代码风格。
+
+### 类型定义
+
+#### start
+
+```typescript
+interface StartExecutionParams {
+  valve_id: number;
+  pool_ids: number[];
+  [propName: string]: any;
+}
+
+interface StartExecutionResult {
+  orbit_link: string;
+  ticket_ids: number[];
+  [propName: string]: any;
+}
+
+async start(params: StartExecutionParams): Promise<StartExecutionResult>
+```
+
+#### complete
+
+```typescript
+interface CompleteExecutionParams {
+  valve_id: number;
+  tickets: Record<string, any>[];
+  [propName: string]: any;
+}
+
+interface CompleteExecutionResult {
+ new_tickets?: Record<string, any>[]; // 待新增的tickets，由引擎创建到数据表
+ [propName: string]: any;
+}
+
+async complete(params: CompleteExecutionParams): Promise<CompleteExecutionResult>
+```
+
+#### run（自动触发门控专用）
+
+自动触发门控不经过人工处理阶段，使用 `run` 替代 `start` + `complete`。`run` 合并了前置与后置处理：接收 `valve_id` 与 `pool_ids`（同 `start`），直接返回 `new_tickets`（同 `complete`），无需 `orbit_link` 或 `ticket_ids`。
+
+```typescript
+interface RunExecutionParams {
+  valve_id: number;
+  pool_ids: number[];
+  [propName: string]: any;
+}
+
+interface RunExecutionResult {
+  new_tickets?: Record<string, any>[]; // 待新增的tickets，由引擎创建到数据表
+  [propName: string]: any;
+}
+
+async run(params: RunExecutionParams): Promise<RunExecutionResult>
+```
+
+
+### 示例（人工触发门控）
+
+```javascript
+class Processer {
+  // context: 执行引擎提供的SDK
+  constructor(context) {
+    this.context = context;
+    console.info(`[Processer] v${__ARTIFACT_VERSION__} (skill: ${__ARTIFACT_SKILL__})`);
+  }
+
+  // params: { valve_id, pool_ids }
+  async start(params) {
+    // 按 agentic-lab-sdk.md 查询入口池数据
+    // 按需调用 SDK 方法查询化合物/工站/流程等外部数据
+    // 将查询结果写回 ticket.detail
+    // 按 agentic-lab-sdk.md 更新 tickets
+    return {
+      orbit_link: 'https://...',
+      ticket_ids: [/* 待处理 ticket ID */],
+    }
+  }
+
+  // params: { valve_id, tickets }
+  async complete(params) {
+    // 按 agentic-lab-sdk.md 获取出口池
+    // 按业务规则筛选可流入出口池的 tickets
+    // 将入口池 tickets 更新为 finished 状态
+    // 按出口池 Schema 映射 new_tickets（脚本不直接追加 tickets，交由引擎自动创建）
+    return {
+      new_tickets: [/* 按出口池映射的新 tickets */]
+    }
+  }
+}
+```
+
+完整可运行代码参考见 [`embedded-template/scripts/示例数据与校验门控.js`](../embedded-template/scripts/示例数据与校验门控.js)。
+
+### 示例（自动触发门控）
+
+```javascript
+class Processer {
+  // context: 执行引擎提供的SDK
+  constructor(context) {
+    this.context = context;
+    console.info(`[Processer] v${__ARTIFACT_VERSION__} (skill: ${__ARTIFACT_SKILL__})`);
+  }
+
+  // params: { valve_id, pool_ids }
+  async run(params) {
+    // 按 agentic-lab-sdk.md 查询入口池数据
+    // 按需调用 SDK 方法查询化合物/工站/流程等外部数据
+    // 执行业务逻辑（无人工处理阶段）
+    // 按 agentic-lab-sdk.md 获取出口池
+    // 将入口池 tickets 更新为 finished 状态
+    // 按出口池 Schema 映射 new_tickets
+    return {
+      new_tickets: [/* 按出口池映射的新 tickets */]
+    }
+  }
+}
+```