# 窗格

> 创建、排列和填充指标窗格。

Source: https://kcq.nebutra.com/zh/docs/agent/tools/panes


<Callout>
  由固定提交的图表源码生成（

  [`1aa5e22`](https://github.com/TsekaLuk/KLineChartQuant/blob/1aa5e22c61313a34d08878ad895e604e0d4a85e9/packages/core/src/foundation/agent/chartToolRegistry.ts)

  ）。工具说明保留模型实际收到的英文原文，不做翻译。
</Callout>

panes_list [#panes_list]

<ToolMeta label="List panes" safety="read-only" safetyLabel="只读" mode="可并行" origin="图表内核" source="https://github.com/TsekaLuk/KLineChartQuant/blob/1aa5e22c61313a34d08878ad895e604e0d4a85e9/packages/core/src/features/agent/impl/chartAgentController.ts#L483" sourceLabel="源码" />

List the current pane layout and capabilities. Use paneId values from this result when creating drawings or changing a pane.

**参数**

此工具不需要输入。

<ToolSchema name="panes_list" label="JSON Schema" />

pane_create [#pane_create]

<ToolMeta label="Create pane" safety="destructive" safetyLabel="修改图表" mode="按序执行" origin="图表内核" source="https://github.com/TsekaLuk/KLineChartQuant/blob/1aa5e22c61313a34d08878ad895e604e0d4a85e9/packages/core/src/features/agent/impl/chartAgentController.ts#L506" sourceLabel="源码" />

Create one indicator pane with a unique paneId, complete indicator params, and a registered sub-pane indicator that has renderers. Returns false when paneId exists or the indicator cannot render in a sub-pane.

**参数**

| 字段                       | 类型                  | 必填 | 约束                        | 说明 |
| ------------------------ | ------------------- | -- | ------------------------- | -- |
| <code>paneId</code>      | <code>string</code> | 是  | min length <code>1</code> |    |
| <code>indicatorId</code> | <code>string</code> | 是  | min length <code>1</code> |    |
| <code>params</code>      | <code>record</code> | 是  | —                         |    |

**最小输入** · 仅含必填字段，占位值由 schema 推导。

```json
{
  "paneId": "<paneId>",
  "indicatorId": "<indicatorId>",
  "params": {}
}
```

<ToolSchema name="pane_create" label="JSON Schema" />

pane_update [#pane_update]

<ToolMeta label="Update pane" safety="destructive" safetyLabel="修改图表" mode="按序执行" origin="图表内核" source="https://github.com/TsekaLuk/KLineChartQuant/blob/1aa5e22c61313a34d08878ad895e604e0d4a85e9/packages/core/src/features/agent/impl/chartAgentController.ts#L524" sourceLabel="源码" />

Update one pane layout patch. ratio is relative among visible panes; minHeightPx is a positive CSS-pixel constraint.

**参数**

| 字段                             | 类型                   | 必填 | 约束                        | 说明 |
| ------------------------------ | -------------------- | -- | ------------------------- | -- |
| <code>paneId</code>            | <code>string</code>  | 是  | min length <code>1</code> |    |
| <code>patch</code>             | <code>object</code>  | 是  | —                         |    |
| <code>patch.ratio</code>       | <code>number</code>  | —  | > <code>0</code>          |    |
| <code>patch.visible</code>     | <code>boolean</code> | —  | —                         |    |
| <code>patch.minHeightPx</code> | <code>number</code>  | —  | > <code>0</code>          |    |

**最小输入** · 仅含必填字段，占位值由 schema 推导。

```json
{
  "paneId": "<paneId>",
  "patch": {}
}
```

<ToolSchema name="pane_update" label="JSON Schema" />

pane_remove [#pane_remove]

<ToolMeta label="Remove pane" safety="destructive" safetyLabel="修改图表" mode="按序执行" origin="图表内核" source="https://github.com/TsekaLuk/KLineChartQuant/blob/1aa5e22c61313a34d08878ad895e604e0d4a85e9/packages/core/src/features/agent/impl/chartAgentController.ts#L538" sourceLabel="源码" />

Remove one user pane and its indicator content. System-owned mode panes cannot be removed.

**参数**

| 字段                  | 类型                  | 必填 | 约束                        | 说明 |
| ------------------- | ------------------- | -- | ------------------------- | -- |
| <code>paneId</code> | <code>string</code> | 是  | min length <code>1</code> |    |

**最小输入** · 仅含必填字段，占位值由 schema 推导。

```json
{
  "paneId": "<paneId>"
}
```

<ToolSchema name="pane_remove" label="JSON Schema" />

pane_move [#pane_move]

<ToolMeta label="Move pane" safety="destructive" safetyLabel="修改图表" mode="按序执行" origin="图表内核" source="https://github.com/TsekaLuk/KLineChartQuant/blob/1aa5e22c61313a34d08878ad895e604e0d4a85e9/packages/core/src/features/agent/impl/chartAgentController.ts#L552" sourceLabel="源码" />

Move one pane to a zero-based layout index without changing its indicator content.

**参数**

| 字段                       | 类型                   | 必填 | 约束                        | 说明 |
| ------------------------ | -------------------- | -- | ------------------------- | -- |
| <code>paneId</code>      | <code>string</code>  | 是  | min length <code>1</code> |    |
| <code>targetIndex</code> | <code>integer</code> | 是  | ≥ <code>0</code>          |    |

**最小输入** · 仅含必填字段，占位值由 schema 推导。

```json
{
  "paneId": "<paneId>",
  "targetIndex": 0
}
```

<ToolSchema name="pane_move" label="JSON Schema" />

pane_replace_content [#pane_replace_content]

<ToolMeta label="Replace pane content" safety="destructive" safetyLabel="修改图表" mode="按序执行" origin="图表内核" source="https://github.com/TsekaLuk/KLineChartQuant/blob/1aa5e22c61313a34d08878ad895e604e0d4a85e9/packages/core/src/features/agent/impl/chartAgentController.ts#L566" sourceLabel="源码" />

Replace an existing user pane indicator with a registered sub-pane indicator that has renderers and complete params. The pane layout is preserved; returns false when the indicator cannot render in a sub-pane.

**参数**

| 字段                       | 类型                  | 必填 | 约束                        | 说明 |
| ------------------------ | ------------------- | -- | ------------------------- | -- |
| <code>paneId</code>      | <code>string</code> | 是  | min length <code>1</code> |    |
| <code>indicatorId</code> | <code>string</code> | 是  | min length <code>1</code> |    |
| <code>params</code>      | <code>record</code> | 是  | —                         |    |

**最小输入** · 仅含必填字段，占位值由 schema 推导。

```json
{
  "paneId": "<paneId>",
  "indicatorId": "<indicatorId>",
  "params": {}
}
```

<ToolSchema name="pane_replace_content" label="JSON Schema" />

pane_update_content [#pane_update_content]

<ToolMeta label="Update pane content" safety="destructive" safetyLabel="修改图表" mode="按序执行" origin="图表内核" source="https://github.com/TsekaLuk/KLineChartQuant/blob/1aa5e22c61313a34d08878ad895e604e0d4a85e9/packages/core/src/features/agent/impl/chartAgentController.ts#L590" sourceLabel="源码" />

Replace the complete parameter object of one user pane indicator.

**参数**

| 字段                  | 类型                  | 必填 | 约束                        | 说明 |
| ------------------- | ------------------- | -- | ------------------------- | -- |
| <code>paneId</code> | <code>string</code> | 是  | min length <code>1</code> |    |
| <code>params</code> | <code>record</code> | 是  | —                         |    |

**最小输入** · 仅含必填字段，占位值由 schema 推导。

```json
{
  "paneId": "<paneId>",
  "params": {}
}
```

<ToolSchema name="pane_update_content" label="JSON Schema" />

panes_clear [#panes_clear]

<ToolMeta label="Clear panes" safety="destructive" safetyLabel="修改图表" mode="按序执行" origin="图表内核" source="https://github.com/TsekaLuk/KLineChartQuant/blob/1aa5e22c61313a34d08878ad895e604e0d4a85e9/packages/core/src/features/agent/impl/chartAgentController.ts#L603" sourceLabel="源码" />

Remove every user-created indicator pane and its content. Main and mode-owned panes are retained.

**参数**

此工具不需要输入。

<ToolSchema name="panes_clear" label="JSON Schema" />
