@thinkingai/ae-cli 6.0.31 → 6.0.33

package/skills/ae-engage/references/config-table.md

@@ -0,0 +1,92 @@
+# engage-setting config-table
+
+> Capability ids: `engage-setting.config-table.{upload,save,list,query-data,update-data,delete}` · Domain: `engage`.
+
+## Commands
+
+```bash
+# 1. Upload and parse a config table file (base64 content) → caches rows under request-id
+ae-cli engage-setting config-table upload \
+  --project-id <project_id> --request-id <request_id> --file-name data.csv \
+  --file-content "$(base64 -i data.csv)"
+
+# 2. Persist the parsed rows as a new config table
+ae-cli engage-setting config-table save \
+  --project-id <project_id> --request-id <request_id> --info-name <table_name>
+
+# List config tables
+ae-cli engage-setting config-table list --project-id <project_id>
+
+# Query rows of a config table
+ae-cli engage-setting config-table query-data --project-id <project_id> --info-id <info_id>
+
+# Replace an existing config table's data with a freshly uploaded file
+ae-cli engage-setting config-table update-data \
+  --project-id <project_id> --request-id <request_id> --info-name <table_name> --info-id <info_id>
+
+# Delete a config table and its data (high-risk)
+ae-cli engage-setting config-table delete --project-id <project_id> --info-id <info_id> --yes
+```
+
+## Parameters
+
+### upload
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--request-id` | Yes | Client-supplied request id used to cache parsed rows for the subsequent save/update-data. |
+| `--file-name` | Yes | Original file name including extension (.csv/.xlsx). |
+| `--file-content` | Yes | Base64-encoded file content. |
+
+### save
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--request-id` | Yes | Request id returned by a prior upload. |
+| `--info-name` | Yes | Config table name. |
+
+### list
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+
+### query-data
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--info-id` | Yes | Config table ID. |
+
+### update-data
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--request-id` | Yes | Request id returned by a prior upload. |
+| `--info-name` | Yes | Config table name. |
+| `--info-id` | Yes | Config table ID to update. |
+
+### delete
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--info-id` | Yes | Config table ID to delete. |
+
+## Output
+
+- `upload`: `data.file_name`, `data.data_num` (parsed row count), `data.data_list` (preview of up to 10 rows, each with `data_key`, `data_value`).
+- `save`: `data.info_id` — created config table ID.
+- `list`: `data.items` (each with `id`, `project_id`, `info_id`, `info_name`, `creator_open_id`, `login_name`, `create_time`, `update_time`) and `data.total`.
+- `query-data`: `data.items` (each with `project_id`, `info_id`, `data_key`, `data_value`) and `data.total`.
+- `update-data` / `delete`: `data.success`.
+
+## Decision Rules
+
+- Creating or replacing a config table is a two-step flow: `upload` (parse + cache by `request-id`) then `save` (new table) or `update-data` (replace existing). Always use a fresh `--request-id` per upload.
+- The upload cache is keyed by `project-id` + `request-id`, expires after 10 minutes, and is consumed after a successful `save` or `update-data`.
+- Discover existing `info_id` values with `config-table list` first; never invent them.
+- `delete` is `high-risk-write` and requires `--yes` (or interactive confirmation).

package/skills/ae-engage/references/engage-scene-config-item.md

@@ -0,0 +1,69 @@
+# engage-scene config-item
+
+> Capability ids: `engage-scene.config-item.{list,create,update}` · Domain: `engage`.
+
+`config-item` 是配置中心（场景管理）里的配置项。create 走 multipart，可携带可选头像文件。
+
+## Commands
+
+```bash
+# List config items of a project
+ae-cli engage-scene config-item list --project-id <project_id>
+
+# Create a config item (business type, group, optional avatar)
+ae-cli engage-scene config-item create \
+  --project-id <project_id> --config-id <config_id> --config-name <name> \
+  --business-type <config_file|params> \
+  [--config-remark <remark>] [--group-id <group_id>] \
+  [--avatar-word '["A","B"]'] [--file-name avatar.png] [--file-content "$(base64 -i avatar.png)"]
+
+# Update a config item's basic info and bound channel
+ae-cli engage-scene config-item update \
+  --project-id <project_id> --config-id <config_id> \
+  [--config-name <name>] [--config-remark <remark>] [--business-type <type>] \
+  [--group-id <group_id>] [--channel-id <channel_id>]
+```
+
+## Parameters
+
+### list
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+
+### create
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--config-id` | Yes | Config item ID (unique within the project). |
+| `--config-name` | Yes | Config item display name (<=80 chars). |
+| `--business-type` | Yes | Business type: `config_file` or `params`. |
+| `--config-remark` | No | Remark (<=200 chars). |
+| `--group-id` | No | Group ID (0 = default group). |
+| `--avatar-word` | No | JSON array of avatar words for the icon. |
+| `--file-name` | No | Avatar file name incl. extension. |
+| `--file-content` | No | Base64-encoded avatar file content. |
+
+### update
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--config-id` | Yes | Config item ID to update. |
+| `--config-name` | No | New display name. |
+| `--config-remark` | No | New remark. |
+| `--business-type` | No | New business type. |
+| `--group-id` | No | New group ID. |
+| `--channel-id` | No | Config channel ID to bind. |
+
+## Output
+
+- `list`: `data.items` + `data.total`.
+- `create` / `update`: `data.success` — whether the operation succeeded.
+
+## Decision Rules
+
+- `create` / `update` are `write`; `list` is read.
+- Use `config-item list` (or `engage +config_item_list`) to discover existing config items first; never invent IDs.

package/skills/ae-engage/references/operation-log-query.md

@@ -5,7 +5,7 @@ Use this command to query aggregated operation records and application logs for
 > Capability id: `engage-flow.operation-log.query` · Domain: `engage`.
 
 ```bash
-ae-cli engage-flow operation-log query --project-id <project-id> --flow-uuid <flow-uuid>
+ae-cli engage-flow operation-log query --project-id <project-id> --flow-id <flow-id>
 ```
 
 The result contains `operation_record_list` and `app_log_list`, grouped by flow version.

package/skills/ae-engage/references/preset-event.md

@@ -0,0 +1,42 @@
+# engage-setting preset-event
+
+> Capability ids: `engage-setting.preset-event.{list,update}` · Domain: `engage`.
+
+## Commands
+
+```bash
+# Query the project preset-event config
+ae-cli engage-setting preset-event list --project-id <project_id>
+
+# Update the project preset-event config
+ae-cli engage-setting preset-event update --project-id <project_id> [--add-event-desc <qp>] [--active-event-desc <qp>] [--recharge-event-desc <qp>]
+```
+
+## Parameters
+
+### list
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+
+### update
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--add-event-desc` | No | Add-event qp definition. |
+| `--active-event-desc` | No | Active-event qp definition. |
+| `--recharge-event-desc` | No | Recharge-success-event qp definition. |
+
+At least one `*-event-desc` must be provided for `update`.
+
+## Output
+
+- `list`: `data.add_event_desc`, `data.active_event_desc`, `data.recharge_event_desc` (each may be `null`).
+- `update`: `data.success` — whether the config was updated.
+
+## Decision Rules
+
+- Use these commands when the user asks to query or configure preset events (预置事件) for the analysis workbench.
+- `update` replaces the provided desc fields; omitting a field clears it. Before clearing a field that is in use, the backend rejects the update if metrics still depend on it.

package/skills/ae-engage/references/push-language.md

@@ -0,0 +1,39 @@
+# engage-setting push-language
+
+> Capability ids: `engage-setting.push-language.{get,set}` · Domain: `engage`.
+
+## Commands
+
+```bash
+# Query the project push-language property field
+ae-cli engage-setting push-language get --project-id <project_id>
+
+# Set the project push-language property field
+ae-cli engage-setting push-language set --project-id <project_id> --push-language-column <prop_code>
+```
+
+## Parameters
+
+### get
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+
+### set
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--push-language-column` | Yes | User property code used as the push language field. |
+
+## Output
+
+- `get`: `data.push_language_column` — configured push-language property code, or `null` if unset.
+- `set`: `data.success` — whether the field was updated.
+
+## Decision Rules
+
+- Use these commands when the user asks to query or configure the project push-language (本地化) property field.
+- `--push-language-column` must be a real user property code; discover available properties via the analysis metadata commands first.
+- `set` is `write`; ordinary update, no confirmation gate.

package/skills/ae-engage/references/scene-config-channel.md

@@ -0,0 +1,58 @@
+# engage-scene config-channel
+
+> Capability ids: `engage-scene.config-channel.{create,update,query-log}` · Domain: `engage`.
+
+场景管理 / 配置中心 - 配置通道管理与操作日志。
+
+## Commands
+
+```bash
+# Create a config channel and enable it
+ae-cli engage-scene config-channel create \
+  --project-id <project_id> --channel-name <name> --channel-type <0|1> --config '<json string>'
+
+# Update a config channel's name and optionally its config
+ae-cli engage-scene config-channel update \
+  --project-id <project_id> --channel-id <channel_id> --channel-name <name> [--config '<json string>']
+
+# Query a config channel's operation log
+ae-cli engage-scene config-channel query-log --project-id <project_id> --channel-id <channel_id>
+```
+
+## Parameters
+
+### create
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--channel-name` | Yes | Channel name. |
+| `--channel-type` | Yes | Channel type: **0 webhook**, **1 client** (not the same as engage push `channelType`, where 1=webhook). |
+| `--config` | Yes | Channel-specific JSON config string. Webhook (`0`) requires `config.url`; client (`1`) must not include `url`. |
+
+### update
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--channel-id` | Yes | Channel ID to update. |
+| `--channel-name` | Yes | New channel name. |
+| `--config` | No | Channel-specific JSON config string. Omit to keep the current config (typical when renaming an enabled channel). Required when changing webhook URL, auth, or parameter definitions on a disabled channel. |
+
+### query-log
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--channel-id` | Yes | Channel ID whose operation log to query. |
+
+## Output
+
+- `create`: `data.channel_id` — the created channel ID.
+- `update`: `data.success`.
+- `query-log`: `data.items` + `data.total`.
+
+## Decision Rules
+
+- `create`/`update` are `write`; `query-log` is read.
+- Discover real `channel_id`s with `ae-cli engage +config_channel_list --project_id <project_id>` first.

package/skills/ae-engage/references/scene-config-group.md

@@ -0,0 +1,62 @@
+# engage-scene config-group
+
+> Capability ids: `engage-scene.config-group.{list,batch-add,update,batch-delete}` · Domain: `engage`.
+
+场景管理 / 配置中心 - 配置项分组管理。
+
+## Commands
+
+```bash
+# List config groups of a project
+ae-cli engage-scene config-group list --project-id <project_id>
+
+# Batch-create config groups
+ae-cli engage-scene config-group batch-add --project-id <project_id> --group-names '["g1","g2"]'
+
+# Rename a config group
+ae-cli engage-scene config-group update --project-id <project_id> --group-id <group_id> --group-name <name>
+
+# Batch-delete config groups (high-risk)
+ae-cli engage-scene config-group batch-delete --project-id <project_id> --group-ids '[1,2]' --yes
+```
+
+## Parameters
+
+### list
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+
+### batch-add
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--group-names` | Yes | JSON array of group names (<=80 chars each). |
+
+### update
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--group-id` | Yes | Group ID to update. |
+| `--group-name` | Yes | New group name (<=80 chars). |
+
+### batch-delete
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--group-ids` | Yes | JSON array of group IDs. |
+
+## Output
+
+- `list`: `data.items` + `data.total`.
+- `batch-add` / `batch-delete`: `data.success_num` + `data.fail_list` (looped single calls; non-atomic).
+- `update`: `data.success`.
+
+## Decision Rules
+
+- Discover real `group_id`s with `list` before update/delete; never invent IDs.
+- `batch-delete` is `high-risk-write` and requires `--yes`.

package/skills/ae-engage/references/scene-config-item.md

@@ -0,0 +1,68 @@
+# engage-scene config-item
+
+> Capability ids: `engage-scene.config-item.{list,create,update}` · Domain: `engage`.
+
+场景管理 / 配置中心 - 配置项管理。
+
+## Commands
+
+```bash
+# List config items of a project
+ae-cli engage-scene config-item list --project-id <project_id>
+
+# Create a config item (business type, group, optional avatar)
+ae-cli engage-scene config-item create \
+  --project-id <project_id> --config-id <config_id> --config-name <name> \
+  --business-type <config_file|params> \
+  [--config-remark <remark>] [--group-id <group_id>] \
+  [--avatar-word '["A"]'] [--file-name icon.png] [--file-content "$(base64 -i icon.png)"]
+
+# Update a config item's basic info and bound channel
+ae-cli engage-scene config-item update \
+  --project-id <project_id> --config-id <config_id> \
+  [--config-name <name>] [--config-remark <remark>] [--business-type <type>] \
+  [--group-id <group_id>] [--channel-id <channel_id>]
+```
+
+## Parameters
+
+### list
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+
+### create
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--config-id` | Yes | Config item ID (unique within the project). |
+| `--config-name` | Yes | Config item display name (<=80 chars). |
+| `--business-type` | Yes | Business type: `config_file` or `params`. |
+| `--config-remark` | No | Remark (<=200 chars). |
+| `--group-id` | No | Group ID (0 = default group). |
+| `--avatar-word` | No | JSON array of avatar words for the icon. |
+| `--file-name` | No | Avatar file name including extension. |
+| `--file-content` | No | Base64-encoded avatar file content. |
+
+### update
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--config-id` | Yes | Config item ID to update. |
+| `--config-name` | No | New display name. |
+| `--config-remark` | No | New remark. |
+| `--business-type` | No | New business type. |
+| `--group-id` | No | New group ID. |
+| `--channel-id` | No | Config channel ID to bind. |
+
+## Output
+
+- `list`: `data.items` + `data.total`.
+- `create` / `update`: `data.success` — whether the operation succeeded.
+
+## Decision Rules
+
+- `create` / `update` are `write`; `list` is read. Use `config-item list` (or `engage +config_item_list`) to discover real `config_id`s and group IDs; never invent IDs.

package/skills/ae-engage/references/scene-config-metric.md

@@ -0,0 +1,79 @@
+# engage-scene config-metric
+
+> Capability ids: `engage-scene.config-metric.{list,get,batch-add,update-rule,batch-delete}` · Domain: `engage`.
+
+场景管理 / 配置中心 - 配置项关联指标管理。
+
+## Commands
+
+```bash
+# List related metrics of a config item (optionally include preset metrics)
+ae-cli engage-scene config-metric list --project-id <project_id> --config-id <config_id> [--all-metric]
+
+# Get a related metric's detail
+ae-cli engage-scene config-metric get --project-id <project_id> --metric-id <metric_id>
+
+# Batch-relate TA (event-analysis) metrics to a config item
+ae-cli engage-scene config-metric batch-add --project-id <project_id> --config-id <config_id> --ta-metric-ids '[1,2]'
+
+# Update a config metric's event relation rule
+ae-cli engage-scene config-metric update-rule \
+  --project-id <project_id> --metric-id <metric_id> \
+  --event-list '[{"event_name":"e1","filter":"true"}]'
+
+# Batch-remove related metrics (high-risk)
+ae-cli engage-scene config-metric batch-delete --project-id <project_id> --config-id <config_id> --metric-ids '[1,2]' --yes
+```
+
+## Parameters
+
+### list
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--config-id` | Yes | Config item ID. |
+| `--all-metric` | No | Include preset metrics as well. |
+
+### get
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--metric-id` | Yes | Config metric primary ID. |
+
+### batch-add
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--config-id` | Yes | Config item ID. |
+| `--ta-metric-ids` | Yes | JSON array of TA metric IDs. |
+
+### update-rule
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--metric-id` | Yes | Config metric primary ID. |
+| `--event-list` | Yes | JSON array of event rules (`event_name` or `eventName`, plus `filter`). |
+
+### batch-delete
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--config-id` | Yes | Config item ID. |
+| `--metric-ids` | Yes | JSON array of config metric primary IDs. |
+
+## Output
+
+- `list`: `data.items` + `data.total`.
+- `get`: `data` — metric detail.
+- `batch-add` / `update-rule`: `data.success`.
+- `batch-delete`: `data.success`.
+
+## Decision Rules
+
+- Discover real metric IDs via `list`/`get`; never invent IDs.
+- `batch-delete` is `high-risk-write` and requires `--yes`.

package/skills/ae-engage/references/scene-config-param.md

@@ -0,0 +1,72 @@
+# engage-scene config-param
+
+> Capability ids: `engage-scene.config-param.{list,batch-add,update,batch-delete}` · Domain: `engage`.
+
+场景管理 / 配置中心 - 配置项参数管理。
+
+## Commands
+
+```bash
+# List params of a config item
+ae-cli engage-scene config-param list --project-id <project_id> --config-id <config_id>
+
+# Batch-add params to a config item
+ae-cli engage-scene config-param batch-add \
+  --project-id <project_id> --config-id <config_id> \
+  --params '[{"param_name":"title","param_display_name":"标题","param_type":"STRING","param_sub_type":"SHORT_TEXT","is_required":1}]'
+
+# Update a param
+ae-cli engage-scene config-param update \
+  --project-id <project_id> --config-id <config_id> --param-id <param_id> \
+  [--param-name <name>] [--param-display-name <name>] [--param-type <type>] \
+  [--param-sub-type <sub>] [--table-id <table_id>] [--param-placeholder <ph>] \
+  [--is-required 1] [--default-value <value>]
+
+# Batch-delete params (high-risk)
+ae-cli engage-scene config-param batch-delete --project-id <project_id> --param-ids '[1,2]' --yes
+```
+
+## Parameters
+
+### list
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--config-id` | Yes | Config item ID. |
+
+### batch-add
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--config-id` | Yes | Config item ID. |
+| `--params` | Yes | JSON array of params (`param_name`, `param_display_name`, `param_type`, `param_sub_type`, `table_id`, `param_placeholder`, `is_required`, `default_value`). `param_type` must be uppercase enum: `STRING`, `NUM`, `DATE`, `DATE_TIME`, `BOOLEAN`, `OBJ`, `SINGLE_SELECT`, `ARRAY`, `JSON`. For `STRING`/`ARRAY`, `param_sub_type` is required (e.g. `SHORT_TEXT`, `LONG_TEXT`, `NUM`). For `SINGLE_SELECT`, `table_id` is required. **`param_display_name` must be unique within the config item** — duplicate display names return `INVALID_CAPABILITY_REQUEST`. |
+
+### update
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--config-id` | Yes | Config item ID. |
+| `--param-id` | Yes | Param ID to update. |
+| others | No | See flag descriptions above. |
+
+### batch-delete
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--param-ids` | Yes | JSON array of param IDs. |
+
+## Output
+
+- `list`: `data.items` + `data.total`.
+- `batch-add` / `update`: `data.success`.
+- `batch-delete`: `data.success_num` + `data.fail_list` (looped single deletes; non-atomic).
+
+## Decision Rules
+
+- Use `list` to discover real `param_id`s before update/delete; never invent IDs.
+- `param_type` is case-sensitive; lowercase values like `"string"` are rejected with `PARAM_TYPE_INVALID`.
+- `batch-delete` is `high-risk-write` and requires `--yes`.

package/skills/ae-engage/references/scene-preset-metric.md

@@ -0,0 +1,45 @@
+# engage-scene preset-metric
+
+> Capability ids: `engage-scene.preset-metric.{get,set}` · Domain: `engage`.
+
+场景管理 / 配置中心 - 配置项预置指标（曝光/点击/参与）QP 配置。
+
+## Commands
+
+```bash
+# Get preset metric QP config of a config item
+ae-cli engage-scene preset-metric get --project-id <project_id> --config-id <config_id>
+
+# Set preset metric QP config
+ae-cli engage-scene preset-metric set \
+  --project-id <project_id> --config-id <config_id> \
+  [--impression-event-qp '<qp json>'] [--click-event-qp '<qp json>'] [--attend-event-qp '<qp json>']
+```
+
+## Parameters
+
+### get
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--config-id` | Yes | Config item ID. |
+
+### set
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--project-id` / `-p` | Yes | Numeric project ID. |
+| `--config-id` | Yes | Config item ID. |
+| `--impression-event-qp` | No | Impression event QP JSON string. |
+| `--click-event-qp` | No | Click event QP JSON string. |
+| `--attend-event-qp` | No | Attend event QP JSON string. |
+
+## Output
+
+- `get`: `data` — preset metric QP config.
+- `set`: `data.success` — whether the operation succeeded.
+
+## Decision Rules
+
+- `get` is read; `set` is `write`.