# 设置

> 读取、修改和重置图表设置。

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


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

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

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

settings_get [#settings_get]

<ToolMeta label="Get chart settings" safety="read-only" safetyLabel="只读" origin="图表内核" source="https://github.com/TsekaLuk/KLineChartQuant/blob/1aa5e22c61313a34d08878ad895e604e0d4a85e9/packages/core/src/features/settings/settingsCommands.ts#L141" sourceLabel="源码" />

Read the current chart preferences (theme, grid, axes, time zone, tooltip, renderer, cache limit, colors) and the schema of writable keys with their allowed values.

**参数**

此工具不需要输入。

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

settings_update [#settings_update]

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

Apply one or more chart preferences immediately, e.g. \{"values":\{"theme":"light","showGridLines":false}}. Call settings\_get first for allowed keys and values. The same action backs the settings dialog, so the user sees the change at once.

**参数**

| 字段                  | 类型                  | 必填 | 约束 | 说明 |
| ------------------- | ------------------- | -- | -- | -- |
| <code>values</code> | <code>record</code> | 是  | —  |    |

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

```json
{
  "values": {}
}
```

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

settings_reset [#settings_reset]

<ToolMeta label="Reset chart settings" safety="destructive" safetyLabel="修改图表" mode="按序执行" origin="图表内核" source="https://github.com/TsekaLuk/KLineChartQuant/blob/1aa5e22c61313a34d08878ad895e604e0d4a85e9/packages/core/src/features/settings/settingsCommands.ts#L187" sourceLabel="源码" />

Restore chart preferences to their defaults. Pass "keys" to reset only those settings; omit it to reset everything. Returns the previous values.

**参数**

| 字段                | 类型                     | 必填 | 约束                                                       | 说明 |
| ----------------- | ---------------------- | -- | -------------------------------------------------------- | -- |
| <code>keys</code> | <code>string\[]</code> | —  | min items <code>1</code>; item min length <code>1</code> |    |

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

```json
{}
```

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