From d38d5e16e4fc81179d6a92f60966dd64f419107b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:08:59 +0800
Subject: [PATCH 01/31] feat(phase-0): add rc reference overview

---
 docs/reference/rc/README.md | 67 +++++++++++++++++++++++++++++++++++++
 1 file changed, 67 insertions(+)
 create mode 100644 docs/reference/rc/README.md

diff --git a/docs/reference/rc/README.md b/docs/reference/rc/README.md
new file mode 100644
index 0000000..402aa1d
--- /dev/null
+++ b/docs/reference/rc/README.md
@@ -0,0 +1,67 @@
+# rc Command Reference
+
+This reference documents the operations exposed by `rc`, the RustFS S3-compatible command-line client. The structure follows the command-reference style used by MinIO `mc`: each operation describes its purpose, syntax, parameters, examples, and behavior, while keeping the examples specific to `rc`.
+
+`rc` supports both noun-first command groups and legacy command names. Prefer the noun-first groups for new scripts:
+
+| Operation | Preferred form | Legacy-compatible form |
+| --- | --- | --- |
+| Configure targets | [`rc alias`](alias.md) | none |
+| Bucket workflows | [`rc bucket`](bucket.md) | `rc ls`, `rc mb`, `rc rb`, `rc event`, `rc cors`, `rc version`, `rc anonymous`, `rc quota`, `rc ilm`, `rc replicate` |
+| Object workflows | [`rc object`](object.md) | `rc ls`, `rc cp`, `rc mv`, `rc rm`, `rc cat`, `rc head`, `rc stat`, `rc find`, `rc tree`, `rc share` |
+| Administrative workflows | [`rc admin`](admin.md) | none |
+| Streaming upload | [`rc pipe`](pipe.md) | none |
+| Difference reports | [`rc diff`](diff.md) | none |
+| Mirroring | [`rc mirror`](mirror.md) | none |
+| S3 Select | [`rc sql`](sql.md) | none |
+| Tags | [`rc tag`](tag.md) | none |
+| Shell completions | [`rc completions`](completions.md) | none |
+
+Legacy command pages remain documented for users migrating from MinIO `mc`-style workflows:
+
+- [`rc ls`](ls.md)
+- [`rc mb`](mb.md)
+- [`rc rb`](rb.md)
+- [`rc cat`](cat.md)
+- [`rc head`](head.md)
+- [`rc stat`](stat.md)
+- [`rc cp`](cp.md)
+- [`rc mv`](mv.md)
+- [`rc rm`](rm.md)
+- [`rc find`](find.md)
+- [`rc event`](event.md)
+- [`rc cors`](cors.md)
+- [`rc tree`](tree.md)
+- [`rc share`](share.md)
+- [`rc version`](version.md)
+- [`rc anonymous`](anonymous.md)
+- [`rc quota`](quota.md)
+- [`rc ilm`](ilm.md)
+- [`rc replicate`](replicate.md)
+
+## Path Format
+
+Remote paths use `ALIAS/BUCKET/KEY` form. An alias-only path such as `local/` refers to a configured S3-compatible service. A bucket path such as `local/photos` refers to a bucket. An object path such as `local/photos/2026/image.jpg` refers to a specific object key.
+
+## Output Modes
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |
+
+## Credentials
+
+Credentials are stored through aliases. Configure an alias before running remote operations:
+
+```bash
+rc alias set local http://localhost:9000 ACCESS_KEY SECRET_KEY
+```
+
+Do not put production credentials in examples, logs, issue descriptions, or screenshots.

From 66a7d874e12bf64ac1011679828c552f8a5de68f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:43 +0800
Subject: [PATCH 02/31] feat(phase-0): add rc alias reference

---
 docs/reference/rc/alias.md | 77 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 77 insertions(+)
 create mode 100644 docs/reference/rc/alias.md

diff --git a/docs/reference/rc/alias.md b/docs/reference/rc/alias.md
new file mode 100644
index 0000000..b3ccd7c
--- /dev/null
+++ b/docs/reference/rc/alias.md
@@ -0,0 +1,77 @@
+# rc alias
+
+## Purpose
+
+The `rc alias` operation manages named S3-compatible service endpoints in the local `rc` configuration. Use aliases to avoid repeating endpoint URLs and credentials in every command.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] alias <COMMAND>
+rc [GLOBAL OPTIONS] alias set [OPTIONS] <NAME> <ENDPOINT> <ACCESS_KEY> <SECRET_KEY>
+rc [GLOBAL OPTIONS] alias list [-l|--long]
+rc [GLOBAL OPTIONS] alias remove <NAME>
+```
+
+## Commands
+
+| Command | Description |
+| --- | --- |
+| `set` | Add a new alias or replace an existing alias. |
+| `list` | List configured aliases. |
+| `remove` | Remove an alias from local configuration. |
+
+## Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `NAME` | Local alias name, such as `local`, `s3`, or `rustfs`. |
+| `ENDPOINT` | S3-compatible endpoint URL, such as `http://localhost:9000`. |
+| `ACCESS_KEY` | Access key ID for the endpoint. |
+| `SECRET_KEY` | Secret access key for the endpoint. |
+| `--region` | AWS region to associate with the alias. Defaults to `us-east-1`. |
+| `--signature` | Signature version, `v4` or `v2`. Defaults to `v4`. |
+| `--bucket-lookup` | Bucket lookup style: `auto`, `path`, or `dns`. Defaults to `auto`. |
+| `--insecure` | Allow insecure TLS connections for this alias. |
+| `-l, --long` | Show full alias details when listing aliases. |
+
+## Examples
+
+Configure a local RustFS or MinIO-compatible service:
+
+```bash
+rc alias set local http://localhost:9000 ACCESS_KEY SECRET_KEY
+```
+
+Configure AWS S3 with an explicit region:
+
+```bash
+rc alias set s3 https://s3.amazonaws.com ACCESS_KEY SECRET_KEY --region us-east-1
+```
+
+List aliases with endpoint details:
+
+```bash
+rc alias list --long
+```
+
+Remove an alias:
+
+```bash
+rc alias remove old-local
+```
+
+## Behavior
+
+`alias set` overwrites an existing alias with the same name. `alias list` does not print secret keys. Commands that need a remote service resolve the alias name before creating an S3 or admin client.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From edcf25e337e89321369a417b015742592a15caf0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:43 +0800
Subject: [PATCH 03/31] feat(phase-0): add rc bucket reference

---
 docs/reference/rc/bucket.md | 97 +++++++++++++++++++++++++++++++++++++
 1 file changed, 97 insertions(+)
 create mode 100644 docs/reference/rc/bucket.md

diff --git a/docs/reference/rc/bucket.md b/docs/reference/rc/bucket.md
new file mode 100644
index 0000000..07e5228
--- /dev/null
+++ b/docs/reference/rc/bucket.md
@@ -0,0 +1,97 @@
+# rc bucket
+
+## Purpose
+
+The `rc bucket` operation is the preferred noun-first entry point for bucket-oriented workflows. It groups bucket listing, creation, deletion, notification, CORS, versioning, quota, anonymous access, lifecycle, and replication operations under one command family.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] bucket <COMMAND>
+rc bucket list [OPTIONS] <PATH>
+rc bucket create [OPTIONS] <ALIAS/BUCKET>
+rc bucket remove [OPTIONS] <ALIAS/BUCKET>
+rc bucket event <add|list|remove> ...
+rc bucket cors <list|set|remove> ...
+rc bucket version <enable|suspend|info|list> ...
+rc bucket quota <set|info|clear> ...
+rc bucket anonymous <set|set-json|get|get-json|list|links> ...
+rc bucket lifecycle <rule|tier|restore> ...
+rc bucket replication <add|update|list|status|remove|export|import> ...
+```
+
+## Commands
+
+| Command | Description |
+| --- | --- |
+| `list` | List buckets for an alias or list objects under a bucket path. |
+| `create` | Create a bucket. |
+| `remove` | Remove a bucket. |
+| `event` | Manage bucket notification rules. |
+| `cors` | Manage bucket CORS rules. |
+| `version` | Manage bucket versioning and object versions. |
+| `quota` | Manage bucket quota. |
+| `anonymous` | Manage anonymous bucket or prefix access. |
+| `lifecycle` | Manage lifecycle rules, remote tiers, and object restore requests. |
+| `replication` | Manage bucket replication rules and replication status. |
+
+## Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `PATH` | `ALIAS/`, `ALIAS/BUCKET`, or `ALIAS/BUCKET/PREFIX`. |
+| `--recursive` | Recursively list objects for `bucket list`. |
+| `--versions` | Include object versions when listing supported versioned buckets. |
+| `--summarize` | Show totals only for list output. |
+| `--ignore-existing` | Do not fail if the bucket already exists when creating it. |
+| `--with-versioning` | Enable versioning when creating the bucket. |
+| `--with-lock` | Enable object lock when creating the bucket. |
+| `--force` | Force destructive or capability-gated operations where supported. |
+| `--dangerous` | Remove a bucket even when incomplete multipart uploads exist. |
+
+## Examples
+
+List buckets for an alias:
+
+```bash
+rc bucket list local/
+```
+
+Create a versioned bucket with object lock:
+
+```bash
+rc bucket create local/archive --with-versioning --with-lock
+```
+
+List notification rules:
+
+```bash
+rc bucket event list local/archive
+```
+
+Set CORS from an XML or JSON file:
+
+```bash
+rc bucket cors set local/archive cors.xml
+```
+
+Check replication status:
+
+```bash
+rc bucket replication status local/archive
+```
+
+## Behavior
+
+Prefer `rc bucket ...` for new scripts. Legacy commands such as `rc mb`, `rc rb`, `rc event`, `rc cors`, `rc version`, `rc anonymous`, `rc quota`, `rc ilm`, and `rc replicate` remain available and delegate to the same implementations.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From ade5c88c13da6c87cadbff8ac25dfc35c7d80c3d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:43 +0800
Subject: [PATCH 04/31] feat(phase-0): add rc object reference

---
 docs/reference/rc/object.md | 90 +++++++++++++++++++++++++++++++++++++
 1 file changed, 90 insertions(+)
 create mode 100644 docs/reference/rc/object.md

diff --git a/docs/reference/rc/object.md b/docs/reference/rc/object.md
new file mode 100644
index 0000000..7e88227
--- /dev/null
+++ b/docs/reference/rc/object.md
@@ -0,0 +1,90 @@
+# rc object
+
+## Purpose
+
+The `rc object` operation is the preferred noun-first entry point for object workflows. It groups listing, copy, move, remove, metadata, preview, search, tree, and presigned URL operations.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] object <COMMAND>
+rc object list [OPTIONS] <ALIAS/BUCKET[/PREFIX]>
+rc object copy [OPTIONS] <SOURCE> <TARGET>
+rc object move [OPTIONS] <SOURCE> <TARGET>
+rc object remove [OPTIONS] <PATH>...
+rc object stat [OPTIONS] <ALIAS/BUCKET/KEY>
+rc object show [OPTIONS] <ALIAS/BUCKET/KEY>
+rc object head [OPTIONS] <ALIAS/BUCKET/KEY>
+rc object find [OPTIONS] <ALIAS/BUCKET[/PREFIX]>
+rc object tree [OPTIONS] <ALIAS/BUCKET[/PREFIX]>
+rc object share [OPTIONS] <ALIAS/BUCKET/KEY>
+```
+
+## Commands
+
+| Command | Description |
+| --- | --- |
+| `list` | List objects under a bucket path. |
+| `copy` | Copy local files to S3, S3 objects to local paths, or S3 objects between remote paths. |
+| `move` | Move objects or files by copying then deleting the source. |
+| `remove` | Remove one or more objects. |
+| `stat` | Show object metadata. |
+| `show` | Print the full object body. |
+| `head` | Print the first lines or bytes of an object. |
+| `find` | Search object keys with filters. |
+| `tree` | Display object keys as a tree. |
+| `share` | Generate a presigned object URL. |
+
+## Common Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `SOURCE` | Local path or remote `ALIAS/BUCKET/KEY`. Copy accepts one source and one target in this version. |
+| `TARGET` | Local destination or remote `ALIAS/BUCKET[/PREFIX]`. |
+| `PATH` | Remote object or prefix path. |
+| `--recursive` | Recurse into directories or prefixes for copy, list, remove, or tree operations. |
+| `--dry-run` | Print planned changes without mutating data where supported. |
+| `--versions` | Include versions where the backend supports object versioning. |
+| `--content-type` | Set content type for upload or streaming commands. |
+
+## Examples
+
+Upload a file:
+
+```bash
+rc object copy ./report.json local/reports/report.json
+```
+
+Download an object:
+
+```bash
+rc object copy local/reports/report.json ./report.json
+```
+
+Remove a prefix after previewing it:
+
+```bash
+rc object remove local/reports/tmp/ --recursive --dry-run
+rc object remove local/reports/tmp/ --recursive --force
+```
+
+Generate a one-day download URL:
+
+```bash
+rc object share local/reports/report.json --expire 1d
+```
+
+## Behavior
+
+Prefer `rc object ...` for new scripts. Legacy commands such as `rc cp`, `rc mv`, `rc rm`, `rc cat`, `rc head`, `rc stat`, `rc find`, `rc tree`, and `rc share` remain available for compatibility.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From 5abf63868f9e061e33a1bac23ca5246d27c043a2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:43 +0800
Subject: [PATCH 05/31] feat(phase-0): add rc admin reference

---
 docs/reference/rc/admin.md | 78 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 78 insertions(+)
 create mode 100644 docs/reference/rc/admin.md

diff --git a/docs/reference/rc/admin.md b/docs/reference/rc/admin.md
new file mode 100644
index 0000000..59e3fab
--- /dev/null
+++ b/docs/reference/rc/admin.md
@@ -0,0 +1,78 @@
+# rc admin
+
+## Purpose
+
+The `rc admin` operation manages RustFS or MinIO-compatible administrative APIs, including cluster information, healing, pools, expansion, decommissioning, rebalance workflows, IAM users, policies, groups, and service accounts.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] admin <COMMAND>
+rc admin info <cluster|server|disk> <ALIAS> [OPTIONS]
+rc admin heal <status|start|stop> <ALIAS> [OPTIONS]
+rc admin pool <list|status> <ALIAS> [POOL] [OPTIONS]
+rc admin expand <start|status|stop> <ALIAS>
+rc admin decommission <start|status|cancel> <ALIAS> <POOL> [OPTIONS]
+rc admin rebalance <start|status|stop> <ALIAS>
+rc admin user <ls|add|info|rm|enable|disable> ...
+rc admin policy <ls|create|info|rm|attach> ...
+rc admin group <ls|add|info|rm|enable|disable|add-members|rm-members> ...
+rc admin service-account <ls|create|info|rm> ...
+```
+
+## Commands
+
+| Command | Description |
+| --- | --- |
+| `info` | Display cluster, server, or disk information. |
+| `heal` | Start, stop, or inspect healing operations. |
+| `pool` | List pools and inspect pool status. |
+| `expand` | Manage post-expansion data rebalancing. Alias: `scale`. |
+| `decommission` | Manage server pool decommissioning. Alias: `decom`. |
+| `rebalance` | Manage post-expansion rebalancing. |
+| `user` | Manage IAM users. |
+| `policy` | Manage IAM policies and attachments. |
+| `group` | Manage IAM groups and group membership. |
+| `service-account` | Manage service accounts. |
+
+## Examples
+
+Show cluster information:
+
+```bash
+rc admin info cluster local
+```
+
+Start a deep heal for a prefix:
+
+```bash
+rc admin heal start local --bucket logs --prefix 2026/ --scan-mode deep
+```
+
+Create a user and attach a policy:
+
+```bash
+rc admin user add local analyst STRONG_PASSWORD
+rc admin policy attach local readonly --user analyst
+```
+
+Create a service account with a policy file:
+
+```bash
+rc admin service-account create local SA_ACCESS_KEY SA_SECRET_KEY --policy ./policy.json
+```
+
+## Behavior
+
+Admin operations use the configured alias to create an admin client. The credentials behind the alias must have permissions for the requested administrative API. The command accepts aliases with or without a trailing slash.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From 40ff977dfefde11fe86130f8d2727bb9ab32fc40 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:43 +0800
Subject: [PATCH 06/31] feat(phase-0): add rc ls reference

---
 docs/reference/rc/ls.md | 44 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 docs/reference/rc/ls.md

diff --git a/docs/reference/rc/ls.md b/docs/reference/rc/ls.md
new file mode 100644
index 0000000..bb52a78
--- /dev/null
+++ b/docs/reference/rc/ls.md
@@ -0,0 +1,44 @@
+# rc ls
+
+## Purpose
+
+`rc ls` lists buckets or objects. It is a legacy-compatible command; prefer `rc bucket list` for bucket workflows and `rc object list` for object workflows.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] ls [OPTIONS] <PATH>
+```
+
+## Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `PATH` | `ALIAS/` to list buckets, or `ALIAS/BUCKET[/PREFIX]` to list objects. |
+| `-r, --recursive` | Recursively list objects. |
+| `--versions` | Show object versions where supported. |
+| `--incomplete` | Include incomplete multipart uploads. |
+| `--summarize` | Show totals only. |
+
+## Examples
+
+```bash
+rc ls local/
+rc ls local/reports --recursive
+rc bucket list local/reports --versions
+```
+
+## Behavior
+
+When `PATH` contains only an alias, `rc ls` lists buckets. When it contains a bucket, it lists objects under the optional prefix.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From fd16f7ed81dd2e86ecb9b32860428f9405fe43a9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:43 +0800
Subject: [PATCH 07/31] feat(phase-0): add rc mb reference

---
 docs/reference/rc/mb.md | 44 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 docs/reference/rc/mb.md

diff --git a/docs/reference/rc/mb.md b/docs/reference/rc/mb.md
new file mode 100644
index 0000000..59870bd
--- /dev/null
+++ b/docs/reference/rc/mb.md
@@ -0,0 +1,44 @@
+# rc mb
+
+## Purpose
+
+`rc mb` creates a bucket. It is a legacy-compatible command; prefer `rc bucket create` for new scripts.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] mb [OPTIONS] <ALIAS/BUCKET>
+```
+
+## Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `ALIAS/BUCKET` | Target bucket path to create. |
+| `-p, --ignore-existing` | Treat an existing bucket as success. |
+| `--region` | Override the alias default region for bucket creation. |
+| `--with-lock` | Enable object locking on the new bucket. |
+| `--with-versioning` | Enable bucket versioning after creation. |
+
+## Examples
+
+```bash
+rc mb local/reports
+rc bucket create local/archive --with-versioning --with-lock
+rc mb local/reports --ignore-existing
+```
+
+## Behavior
+
+Bucket creation uses the endpoint and credentials from the alias. Object locking must be enabled when the bucket is created.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From 5ffa314ccebbe6091826bdf10feaa9ea5975cee9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:43 +0800
Subject: [PATCH 08/31] feat(phase-0): add rc rb reference

---
 docs/reference/rc/rb.md | 41 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 docs/reference/rc/rb.md

diff --git a/docs/reference/rc/rb.md b/docs/reference/rc/rb.md
new file mode 100644
index 0000000..442c872
--- /dev/null
+++ b/docs/reference/rc/rb.md
@@ -0,0 +1,41 @@
+# rc rb
+
+## Purpose
+
+`rc rb` removes a bucket. It is a legacy-compatible command; prefer `rc bucket remove` for new scripts.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] rb [OPTIONS] <ALIAS/BUCKET>
+```
+
+## Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `ALIAS/BUCKET` | Bucket path to remove. |
+| `--force` | Delete objects before removing a non-empty bucket. |
+| `--dangerous` | Remove the bucket even when incomplete multipart uploads exist. |
+
+## Examples
+
+```bash
+rc rb local/empty-bucket
+rc bucket remove local/old-bucket --force
+```
+
+## Behavior
+
+Without `--force`, the backend must allow deletion of the bucket as-is. Use destructive options carefully; they can delete object data before removing the bucket.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From 130bc8f795b24370c42a97ef95cd32090cf2c3f1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:43 +0800
Subject: [PATCH 09/31] feat(phase-0): add rc cat reference

---
 docs/reference/rc/cat.md | 42 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 docs/reference/rc/cat.md

diff --git a/docs/reference/rc/cat.md b/docs/reference/rc/cat.md
new file mode 100644
index 0000000..7158a73
--- /dev/null
+++ b/docs/reference/rc/cat.md
@@ -0,0 +1,42 @@
+# rc cat
+
+## Purpose
+
+`rc cat` prints the full contents of an object to stdout. It is a legacy-compatible command; prefer `rc object show` for new scripts.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] cat [OPTIONS] <ALIAS/BUCKET/KEY>
+```
+
+## Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `ALIAS/BUCKET/KEY` | Object path to read. |
+| `--offset` | Start reading at a byte offset. |
+| `--length` | Limit output to a byte length. |
+| `--version-id` | Read a specific object version. |
+
+## Examples
+
+```bash
+rc cat local/reports/summary.txt
+rc object show local/reports/summary.txt --version-id VERSION_ID
+```
+
+## Behavior
+
+Object bytes are written to stdout, so redirect output when reading binary objects.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From 83d31186139375cbe186588d55347b83b224b8f2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:43 +0800
Subject: [PATCH 10/31] feat(phase-0): add rc head reference

---
 docs/reference/rc/head.md | 42 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 docs/reference/rc/head.md

diff --git a/docs/reference/rc/head.md b/docs/reference/rc/head.md
new file mode 100644
index 0000000..c7b5357
--- /dev/null
+++ b/docs/reference/rc/head.md
@@ -0,0 +1,42 @@
+# rc head
+
+## Purpose
+
+`rc head` prints the beginning of an object. It is a legacy-compatible command; prefer `rc object head` for new scripts.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] head [OPTIONS] <ALIAS/BUCKET/KEY>
+```
+
+## Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `ALIAS/BUCKET/KEY` | Object path to preview. |
+| `-n, --lines` | Number of lines to print. Defaults to `10`. |
+| `-c, --bytes` | Number of bytes to print. |
+| `--version-id` | Read a specific object version. |
+
+## Examples
+
+```bash
+rc head local/logs/app.log --lines 20
+rc object head local/data/archive.bin --bytes 512
+```
+
+## Behavior
+
+Use `--bytes` for binary files or fixed-size previews. Use `--lines` for text objects.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From 8816a7edf8e3721a6d13a80366d27da65bd00c6d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:43 +0800
Subject: [PATCH 11/31] feat(phase-0): add rc stat reference

---
 docs/reference/rc/stat.md | 41 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 docs/reference/rc/stat.md

diff --git a/docs/reference/rc/stat.md b/docs/reference/rc/stat.md
new file mode 100644
index 0000000..7cd6a78
--- /dev/null
+++ b/docs/reference/rc/stat.md
@@ -0,0 +1,41 @@
+# rc stat
+
+## Purpose
+
+`rc stat` shows object metadata. It is a legacy-compatible command; prefer `rc object stat` for new scripts.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] stat [OPTIONS] <ALIAS/BUCKET/KEY>
+```
+
+## Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `ALIAS/BUCKET/KEY` | Object path to inspect. |
+| `--version-id` | Inspect a specific object version. |
+| `--rewind` | Inspect object state at a specific time where supported. |
+
+## Examples
+
+```bash
+rc stat local/reports/summary.json
+rc object stat local/reports/summary.json --json
+```
+
+## Behavior
+
+Metadata output includes object identity and storage metadata such as size, modified time, ETag, content type, and user metadata when available.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From 5ac96511571302577fef985c39426960b22ea723 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:43 +0800
Subject: [PATCH 12/31] feat(phase-0): add rc cp reference

---
 docs/reference/rc/cp.md | 59 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 59 insertions(+)
 create mode 100644 docs/reference/rc/cp.md

diff --git a/docs/reference/rc/cp.md b/docs/reference/rc/cp.md
new file mode 100644
index 0000000..b75cbe0
--- /dev/null
+++ b/docs/reference/rc/cp.md
@@ -0,0 +1,59 @@
+# rc cp
+
+## Purpose
+
+`rc cp` copies files and objects between local paths and S3-compatible remote paths. It is a legacy-compatible command; prefer `rc object copy` for new scripts.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] cp [OPTIONS] <SOURCE> <TARGET>
+```
+
+## Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `SOURCE` | Local file, local directory, or remote object/prefix path. This version accepts one source and one target. |
+| `TARGET` | Local or remote destination path. |
+| `-r, --recursive` | Recursively copy a directory or prefix. |
+| `--overwrite` | Overwrite destination data where supported. |
+| `--dry-run` | Show planned copies without copying data. |
+| `--preserve` | Preserve applicable metadata. |
+| `--content-type` | Set object content type for uploads. |
+| `--storage-class` | Set destination storage class for uploads where supported. |
+
+## Examples
+
+Upload a file:
+
+```bash
+rc cp ./report.json local/reports/report.json
+```
+
+Upload a directory recursively:
+
+```bash
+rc object copy ./reports/ local/reports/ --recursive
+```
+
+Copy between buckets:
+
+```bash
+rc cp local/reports/summary.json backup/reports/summary.json
+```
+
+## Behavior
+
+The last path is the target. Sources can mix local and remote paths only where the command can infer a valid copy direction. Use trailing slashes consistently when copying directory-like prefixes.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From f7e4687249a5227a58a9b994ad096a3310875290 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:43 +0800
Subject: [PATCH 13/31] feat(phase-0): add rc mv reference

---
 docs/reference/rc/mv.md | 42 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 docs/reference/rc/mv.md

diff --git a/docs/reference/rc/mv.md b/docs/reference/rc/mv.md
new file mode 100644
index 0000000..abfcb64
--- /dev/null
+++ b/docs/reference/rc/mv.md
@@ -0,0 +1,42 @@
+# rc mv
+
+## Purpose
+
+`rc mv` moves files or objects between local and S3-compatible locations. It is a legacy-compatible command; prefer `rc object move` for new scripts.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] mv [OPTIONS] <SOURCE> <TARGET>
+```
+
+## Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `SOURCE` | Local path or remote object/prefix path to move. |
+| `TARGET` | Local or remote destination path. |
+| `-r, --recursive` | Move a directory or prefix recursively. |
+| `--dry-run` | Show planned changes without moving data. |
+
+## Examples
+
+```bash
+rc mv local/inbox/report.json local/archive/report.json
+rc object move ./incoming/ local/inbox/ --recursive
+```
+
+## Behavior
+
+Move operations copy data to the target and remove the source after a successful copy. Review recursive moves with `--dry-run` before running destructive operations.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From 7191455536e928faae260121983db0c1ee2fd7d1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:43 +0800
Subject: [PATCH 14/31] feat(phase-0): add rc rm reference

---
 docs/reference/rc/rm.md | 46 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 docs/reference/rc/rm.md

diff --git a/docs/reference/rc/rm.md b/docs/reference/rc/rm.md
new file mode 100644
index 0000000..13f0bf8
--- /dev/null
+++ b/docs/reference/rc/rm.md
@@ -0,0 +1,46 @@
+# rc rm
+
+## Purpose
+
+`rc rm` removes objects. It is a legacy-compatible command; prefer `rc object remove` for new scripts.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] rm [OPTIONS] <PATH>...
+```
+
+## Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `PATH` | One or more remote object or prefix paths. |
+| `-r, --recursive` | Remove objects recursively under a prefix. |
+| `-f, --force` | Run without interactive confirmation where required. |
+| `--dry-run` | Show objects that would be removed. |
+| `--versions` | Remove object versions where supported. |
+| `--purge` | Remove all versions and delete markers under the target where supported. |
+| `--bypass` | Bypass governance retention if the backend and credentials allow it. |
+
+## Examples
+
+```bash
+rc rm local/reports/tmp.json
+rc object remove local/reports/tmp/ --recursive --dry-run
+rc object remove local/reports/tmp/ --recursive --force
+```
+
+## Behavior
+
+Recursive and version-aware deletions can remove many objects. Use `--dry-run` to inspect the target set before running destructive commands.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From 7245e3124ba85e830ed6be7c136cb70331ec2c55 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:43 +0800
Subject: [PATCH 15/31] feat(phase-0): add rc pipe reference

---
 docs/reference/rc/pipe.md | 41 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 docs/reference/rc/pipe.md

diff --git a/docs/reference/rc/pipe.md b/docs/reference/rc/pipe.md
new file mode 100644
index 0000000..b16cda0
--- /dev/null
+++ b/docs/reference/rc/pipe.md
@@ -0,0 +1,41 @@
+# rc pipe
+
+## Purpose
+
+`rc pipe` streams stdin directly into an object. Use it for generated data, shell pipelines, and backups that should not be written to a temporary local file first.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] pipe [OPTIONS] <ALIAS/BUCKET/KEY>
+```
+
+## Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `ALIAS/BUCKET/KEY` | Destination object path. |
+| `--content-type` | Object content type. Defaults to `application/octet-stream`. |
+| `--storage-class` | Storage class for the uploaded object. |
+
+## Examples
+
+```bash
+tar -czf - ./logs | rc pipe local/backups/logs.tar.gz --content-type application/gzip
+printf 'hello\n' | rc pipe local/tmp/hello.txt --content-type text/plain
+```
+
+## Behavior
+
+The command reads from stdin until EOF and uploads that stream as the destination object.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From eff6328a71389eb7e75d0bb2f7b55112074c3bc3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:43 +0800
Subject: [PATCH 16/31] feat(phase-0): add rc find reference

---
 docs/reference/rc/find.md | 48 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 docs/reference/rc/find.md

diff --git a/docs/reference/rc/find.md b/docs/reference/rc/find.md
new file mode 100644
index 0000000..288229f
--- /dev/null
+++ b/docs/reference/rc/find.md
@@ -0,0 +1,48 @@
+# rc find
+
+## Purpose
+
+`rc find` searches objects under a bucket path using name, path, size, time, and metadata filters. It is a legacy-compatible command; prefer `rc object find` for new scripts.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] find [OPTIONS] <ALIAS/BUCKET[/PREFIX]>
+```
+
+## Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `PATH` | Bucket or prefix to search. |
+| `--name` | Match object name with a glob-like pattern. |
+| `--older` | Match objects older than a duration such as `7d`. |
+| `--newer` | Match objects newer than a duration such as `1h`. |
+| `--larger` | Match objects larger than a size such as `10M`. |
+| `--smaller` | Match objects smaller than a size such as `500K`. |
+| `--maxdepth` | Limit search depth; `0` means unlimited. |
+| `--count` | Print only the number of matches. |
+| `--exec` | Execute a command for each match, using `{}` as the placeholder. |
+| `--print` | Print full paths instead of paths relative to the search root. |
+
+## Examples
+
+```bash
+rc find local/reports --name '*.json'
+rc object find local/logs --newer 1d --larger 10M
+```
+
+## Behavior
+
+Find evaluates filters against objects returned by the backend. Duration and size suffixes are parsed by `rc`, so use explicit units for scripts.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From c911a9832da1b337feef57600912490b67e5f65c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:43 +0800
Subject: [PATCH 17/31] feat(phase-0): add rc event reference

---
 docs/reference/rc/event.md | 46 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 docs/reference/rc/event.md

diff --git a/docs/reference/rc/event.md b/docs/reference/rc/event.md
new file mode 100644
index 0000000..0077a0e
--- /dev/null
+++ b/docs/reference/rc/event.md
@@ -0,0 +1,46 @@
+# rc event
+
+## Purpose
+
+`rc event` manages bucket notification rules. It is a legacy-compatible command; prefer `rc bucket event` for new scripts.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] event <COMMAND>
+rc event add [OPTIONS] <ALIAS/BUCKET> <ARN>
+rc event list [OPTIONS] <ALIAS/BUCKET>
+rc event remove [OPTIONS] <ALIAS/BUCKET> <ARN>
+```
+
+## Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `ALIAS/BUCKET` | Bucket whose notification configuration is managed. |
+| `ARN` | Notification target ARN. |
+| `--event EVENT` | Event filter. Can be supplied more than once. |
+| `--force` | Force operation even if capability detection fails. |
+
+## Examples
+
+```bash
+rc bucket event add local/reports arn:aws:sns:us-east-1:123456789012:topic --event s3:ObjectCreated:*
+rc event list local/reports
+rc bucket event remove local/reports arn:aws:sns:us-east-1:123456789012:topic
+```
+
+## Behavior
+
+Adding a rule configures notifications for the specified ARN. Removing a rule targets the matching ARN.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From e15afd9cba1aa7e4869bdccfe3bbef47ebb3382c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:43 +0800
Subject: [PATCH 18/31] feat(phase-0): add rc cors reference

---
 docs/reference/rc/cors.md | 48 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 docs/reference/rc/cors.md

diff --git a/docs/reference/rc/cors.md b/docs/reference/rc/cors.md
new file mode 100644
index 0000000..90cced3
--- /dev/null
+++ b/docs/reference/rc/cors.md
@@ -0,0 +1,48 @@
+# rc cors
+
+## Purpose
+
+`rc cors` manages bucket CORS configuration. It is a legacy-compatible command; prefer `rc bucket cors` for new scripts.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] cors <COMMAND>
+rc cors list <ALIAS/BUCKET>
+rc cors get <ALIAS/BUCKET>
+rc cors set [OPTIONS] <ALIAS/BUCKET> [SOURCE]
+rc cors remove <ALIAS/BUCKET>
+```
+
+## Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `ALIAS/BUCKET` | Bucket whose CORS rules are managed. |
+| `SOURCE` | JSON or XML CORS file. Use `-` to read from stdin. |
+| `--file` | Legacy flag for the CORS file; mutually exclusive with positional `SOURCE`. |
+| `--force` | Force operation even if capability detection fails. |
+
+## Examples
+
+```bash
+rc bucket cors list local/web
+rc bucket cors set local/web cors.xml
+cat cors.json | rc cors set local/web -
+rc cors remove local/web
+```
+
+## Behavior
+
+`list` and `get` read the current CORS rules. `set` replaces the bucket CORS configuration with the supplied JSON or XML document. `remove` clears the CORS configuration.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From ec3516e7fedc0b17d6b0700af35ec008668b896b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:43 +0800
Subject: [PATCH 19/31] feat(phase-0): add rc diff reference

---
 docs/reference/rc/diff.md | 42 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 docs/reference/rc/diff.md

diff --git a/docs/reference/rc/diff.md b/docs/reference/rc/diff.md
new file mode 100644
index 0000000..7c8b6bd
--- /dev/null
+++ b/docs/reference/rc/diff.md
@@ -0,0 +1,42 @@
+# rc diff
+
+## Purpose
+
+`rc diff` compares two locations and reports objects that are missing, different, or identical depending on selected options.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] diff [OPTIONS] <SOURCE> <TARGET>
+```
+
+## Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `SOURCE` | Local or remote source path. |
+| `TARGET` | Local or remote target path. |
+| `-r, --recursive` | Compare recursively. |
+| `--diff-only` | Show only differences instead of all compared entries. |
+
+## Examples
+
+```bash
+rc diff local/reports backup/reports --recursive
+rc diff ./reports local/reports --recursive --json
+```
+
+## Behavior
+
+Diff is read-only. Use it before copy, mirror, or remove workflows to inspect drift between two locations.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From 7b10b7441f0230be8f3d839fae0de4187926de21 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:43 +0800
Subject: [PATCH 20/31] feat(phase-0): add rc mirror reference

---
 docs/reference/rc/mirror.md | 45 +++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 docs/reference/rc/mirror.md

diff --git a/docs/reference/rc/mirror.md b/docs/reference/rc/mirror.md
new file mode 100644
index 0000000..c53bdc2
--- /dev/null
+++ b/docs/reference/rc/mirror.md
@@ -0,0 +1,45 @@
+# rc mirror
+
+## Purpose
+
+`rc mirror` synchronizes objects from a source location to a target location.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] mirror [OPTIONS] <SOURCE> <TARGET>
+```
+
+## Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `SOURCE` | Local or remote source directory, bucket, or prefix. |
+| `TARGET` | Local or remote destination directory, bucket, or prefix. |
+| `--overwrite` | Overwrite changed destination objects. |
+| `--remove` | Delete target objects that no longer exist in the source. |
+| `-n, --dry-run` | Show planned changes without applying them. |
+| `-P, --parallel` | Number of parallel transfer workers. Defaults to `4`. |
+
+## Examples
+
+```bash
+rc mirror ./site local/web/site --dry-run
+rc mirror ./site local/web/site --overwrite --remove
+rc mirror local/source backup/source --parallel 8
+```
+
+## Behavior
+
+Mirror is intended for prefix-level synchronization. Use `--dry-run` first when combining `--overwrite` and `--remove`.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From eb06d3b5886cefe9abc3e94a55a1ddb6738a6e29 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:43 +0800
Subject: [PATCH 21/31] feat(phase-0): add rc tree reference

---
 docs/reference/rc/tree.md | 44 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 docs/reference/rc/tree.md

diff --git a/docs/reference/rc/tree.md b/docs/reference/rc/tree.md
new file mode 100644
index 0000000..348a201
--- /dev/null
+++ b/docs/reference/rc/tree.md
@@ -0,0 +1,44 @@
+# rc tree
+
+## Purpose
+
+`rc tree` displays object keys in a tree-like view. It is a legacy-compatible command; prefer `rc object tree` for new scripts.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] tree [OPTIONS] <ALIAS/BUCKET[/PREFIX]>
+```
+
+## Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `PATH` | Bucket or prefix to display. |
+| `-L, --level` | Maximum tree depth. Defaults to `3`. |
+| `-d, --dirs-only` | Show only directory-like prefixes. |
+| `-f, --full-path` | Show full path prefixes. |
+| `-P, --pattern` | Include only keys matching a pattern. |
+| `-s, --size` | Show object sizes. |
+
+## Examples
+
+```bash
+rc tree local/reports -L 2
+rc object tree local/reports --recursive --size
+```
+
+## Behavior
+
+Tree output is optimized for human inspection of key organization. Use `rc object list --json` for machine-readable inventory.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From d501679a9ea67948592035c8467e95b03525f020 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:43 +0800
Subject: [PATCH 22/31] feat(phase-0): add rc share reference

---
 docs/reference/rc/share.md | 42 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 docs/reference/rc/share.md

diff --git a/docs/reference/rc/share.md b/docs/reference/rc/share.md
new file mode 100644
index 0000000..b8ce3b5
--- /dev/null
+++ b/docs/reference/rc/share.md
@@ -0,0 +1,42 @@
+# rc share
+
+## Purpose
+
+`rc share` generates presigned URLs for object sharing. It is a legacy-compatible command; prefer `rc object share` for new scripts.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] share [OPTIONS] <ALIAS/BUCKET/KEY>
+```
+
+## Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `ALIAS/BUCKET/KEY` | Object to share. |
+| `-e, --expire` | URL expiration duration. Defaults to `7d`. |
+| `--upload` | Generate an upload URL where supported. |
+| `--content-type` | Content type for upload-style URLs. |
+
+## Examples
+
+```bash
+rc share local/reports/summary.pdf --expire 24h
+rc object share local/uploads/inbox.bin --upload --expire 1h
+```
+
+## Behavior
+
+Presigned URLs inherit the permissions and endpoint behavior of the alias credentials. Treat generated URLs as temporary credentials until they expire.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From 7c9f107dbc12cab06814e689e1393689842f2412 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:43 +0800
Subject: [PATCH 23/31] feat(phase-0): add rc sql reference

---
 docs/reference/rc/sql.md | 43 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 docs/reference/rc/sql.md

diff --git a/docs/reference/rc/sql.md b/docs/reference/rc/sql.md
new file mode 100644
index 0000000..a3bc7ce
--- /dev/null
+++ b/docs/reference/rc/sql.md
@@ -0,0 +1,43 @@
+# rc sql
+
+## Purpose
+
+`rc sql` runs an S3 Select SQL expression against an object and streams query results to stdout.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] sql [OPTIONS] <ALIAS/BUCKET/KEY> --query <SQL>
+```
+
+## Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `ALIAS/BUCKET/KEY` | Object to query. |
+| `--query` | SQL expression to run. |
+| `--input-format` | Input format: `csv`, `json`, or `parquet` where supported. Defaults to `csv`. |
+| `--output-format` | Output format: `csv` or `json`. Defaults to `csv`. |
+| `--compression` | Compression type: `none`, `gzip`, or `bzip2`. Defaults to `none`. |
+
+## Examples
+
+```bash
+rc sql local/data/report.csv --query 'SELECT s._1 FROM S3Object s'
+rc sql local/data/events.jsonl --query 'SELECT * FROM S3Object' --input-format json --output-format json --compression gzip
+```
+
+## Behavior
+
+The backend must support S3 Select for the target object format. Query results are written to stdout, so redirect output when storing results.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From 16e6b4aac8db185993771f376f5ca461ea995269 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:44 +0800
Subject: [PATCH 24/31] feat(phase-0): add rc version reference

---
 docs/reference/rc/version.md | 48 ++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 docs/reference/rc/version.md

diff --git a/docs/reference/rc/version.md b/docs/reference/rc/version.md
new file mode 100644
index 0000000..3321551
--- /dev/null
+++ b/docs/reference/rc/version.md
@@ -0,0 +1,48 @@
+# rc version
+
+## Purpose
+
+`rc version` manages bucket versioning and lists object versions. It is a legacy-compatible command; prefer `rc bucket version` for new scripts.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] version <COMMAND>
+rc version enable <ALIAS/BUCKET>
+rc version suspend <ALIAS/BUCKET>
+rc version info <ALIAS/BUCKET>
+rc version list [OPTIONS] <ALIAS/BUCKET[/PREFIX]>
+```
+
+## Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `ALIAS/BUCKET` | Bucket whose versioning state is managed. |
+| `ALIAS/BUCKET[/PREFIX]` | Bucket or prefix whose versions are listed. |
+| `-n, --max` | Maximum number of versions to list. Defaults to `100`. |
+| `--force` | Force operation even if capability detection fails. |
+
+## Examples
+
+```bash
+rc bucket version enable local/reports
+rc version info local/reports
+rc bucket version list local/reports --max 200
+rc version suspend local/reports
+```
+
+## Behavior
+
+Versioning changes apply at the bucket level. Listing versions requires backend support for S3 versioning APIs.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From 02cd97c8c00e726c8abc14635749d7bc0217af3e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:44 +0800
Subject: [PATCH 25/31] feat(phase-0): add rc tag reference

---
 docs/reference/rc/tag.md | 46 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 docs/reference/rc/tag.md

diff --git a/docs/reference/rc/tag.md b/docs/reference/rc/tag.md
new file mode 100644
index 0000000..4c9ee58
--- /dev/null
+++ b/docs/reference/rc/tag.md
@@ -0,0 +1,46 @@
+# rc tag
+
+## Purpose
+
+`rc tag` manages bucket and object tags.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] tag <COMMAND>
+rc tag list [OPTIONS] <PATH>
+rc tag set [OPTIONS] <PATH> --tags KEY=VALUE [--tags KEY=VALUE ...]
+rc tag remove [OPTIONS] <PATH>
+```
+
+## Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `PATH` | Bucket path or object path whose tags are managed. |
+| `-t, --tags KEY=VALUE` | Tag key-value pair to set. May be repeated. |
+| `--version-id` | Target a specific object version where supported. |
+| `--force` | Force operation even if capability detection fails. |
+
+## Examples
+
+```bash
+rc tag set local/reports/summary.json --tags env=prod --tags owner=analytics
+rc tag list local/reports/summary.json
+rc tag remove local/reports/summary.json
+```
+
+## Behavior
+
+Tag operations use S3-compatible tagging APIs. Object-version targeting depends on backend support.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From 45bd0b888936e9c28538652cdee5761816a7b2ad Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:44 +0800
Subject: [PATCH 26/31] feat(phase-0): add rc anonymous reference

---
 docs/reference/rc/anonymous.md | 50 ++++++++++++++++++++++++++++++++++
 1 file changed, 50 insertions(+)
 create mode 100644 docs/reference/rc/anonymous.md

diff --git a/docs/reference/rc/anonymous.md b/docs/reference/rc/anonymous.md
new file mode 100644
index 0000000..aee0b33
--- /dev/null
+++ b/docs/reference/rc/anonymous.md
@@ -0,0 +1,50 @@
+# rc anonymous
+
+## Purpose
+
+`rc anonymous` manages anonymous bucket or prefix access. It is a legacy-compatible command; prefer `rc bucket anonymous` for new scripts.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] anonymous <COMMAND>
+rc anonymous set <private|public|download|upload> <PATH>
+rc anonymous set-json <FILE> <PATH>
+rc anonymous get <PATH>
+rc anonymous get-json <PATH>
+rc anonymous list <PATH>
+rc anonymous links [-r|--recursive] <PATH>
+```
+
+## Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `PATH` | Bucket or prefix path, `ALIAS/BUCKET[/PREFIX]`. |
+| `PERMISSION` | One of `private`, `public`, `download`, or `upload`. |
+| `FILE` | Policy JSON file for `set-json`. |
+| `-r, --recursive` | Recursively list public links. |
+
+## Examples
+
+```bash
+rc bucket anonymous set download local/public/reports
+rc anonymous get local/public/reports
+rc anonymous links local/public/reports --recursive
+rc anonymous set private local/public
+```
+
+## Behavior
+
+Setting prefix-level anonymous access replaces the bucket policy document with statements generated for the target prefix. Setting `private` is bucket-level because it clears the anonymous policy.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From 08fbdc1d22ec3c5d7ece17c58eaac6b597111d00 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:44 +0800
Subject: [PATCH 27/31] feat(phase-0): add rc quota reference

---
 docs/reference/rc/quota.md | 44 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 docs/reference/rc/quota.md

diff --git a/docs/reference/rc/quota.md b/docs/reference/rc/quota.md
new file mode 100644
index 0000000..65f8159
--- /dev/null
+++ b/docs/reference/rc/quota.md
@@ -0,0 +1,44 @@
+# rc quota
+
+## Purpose
+
+`rc quota` manages bucket quota. It is a legacy-compatible command; prefer `rc bucket quota` for new scripts.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] quota <COMMAND>
+rc quota set <ALIAS/BUCKET> <SIZE>
+rc quota info <ALIAS/BUCKET>
+rc quota clear <ALIAS/BUCKET>
+```
+
+## Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `ALIAS/BUCKET` | Bucket whose quota is managed. |
+| `SIZE` | Quota value in bytes or units such as `10G`, `500M`, or `10KB`. |
+
+## Examples
+
+```bash
+rc bucket quota set local/reports 100G
+rc quota info local/reports
+rc bucket quota clear local/reports
+```
+
+## Behavior
+
+Quota commands require backend support for bucket quota APIs. Clearing quota removes the configured bucket quota.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From cc33de4fad111b0e8dd673747a2b61ad75ac8623 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:44 +0800
Subject: [PATCH 28/31] feat(phase-0): add rc ilm reference

---
 docs/reference/rc/ilm.md | 75 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 75 insertions(+)
 create mode 100644 docs/reference/rc/ilm.md

diff --git a/docs/reference/rc/ilm.md b/docs/reference/rc/ilm.md
new file mode 100644
index 0000000..e90ba8f
--- /dev/null
+++ b/docs/reference/rc/ilm.md
@@ -0,0 +1,75 @@
+# rc ilm
+
+## Purpose
+
+`rc ilm` manages bucket lifecycle configuration, remote storage tiers, and restore requests for transitioned objects. It is a legacy-compatible command; prefer `rc bucket lifecycle` for new scripts.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] ilm <COMMAND>
+rc ilm rule <add|edit|list|remove|export|import> ...
+rc ilm tier <add|edit|list|info|remove> ...
+rc ilm restore [OPTIONS] <ALIAS/BUCKET/KEY>
+```
+
+## Rule Operations
+
+| Command | Description |
+| --- | --- |
+| `rule add` | Add an expiration or transition rule. |
+| `rule edit` | Edit an existing lifecycle rule. |
+| `rule list` | List lifecycle rules on a bucket. |
+| `rule remove` | Remove one rule by ID or all rules. |
+| `rule export` | Export lifecycle configuration as JSON. |
+| `rule import` | Import lifecycle configuration from JSON. |
+
+## Tier Operations
+
+| Command | Description |
+| --- | --- |
+| `tier add` | Add a remote storage tier. |
+| `tier edit` | Edit tier credentials. |
+| `tier list` | List configured tiers. |
+| `tier info` | Show tier statistics. |
+| `tier remove` | Remove a tier. |
+
+## Common Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `ALIAS/BUCKET` | Bucket whose lifecycle configuration is managed. |
+| `--id` | Lifecycle rule identifier. |
+| `--prefix` | Restrict a rule to a key prefix. |
+| `--tags` | Restrict a rule to tag filters. |
+| `--expiry-days` | Expire current objects after the specified number of days. |
+| `--transition-days` | Transition objects after the specified number of days. |
+| `--storage-class` | Remote tier or storage class for transition rules. |
+| `--all` | Remove all lifecycle rules where supported. |
+| `--days` | Number of days to keep a restored copy. Defaults to `1`. |
+| `--force` | Force operation even if capability detection fails. |
+
+## Examples
+
+```bash
+rc bucket lifecycle rule add local/reports --expiry-days 30 --prefix logs/
+rc ilm rule list local/reports
+rc ilm rule export local/reports > lifecycle.json
+rc ilm tier add rustfs WARM local --endpoint http://remote:9000 --access-key ACCESS_KEY --secret-key SECRET_KEY --bucket warm
+rc ilm restore local/reports/archive/object.dat --days 7
+```
+
+## Behavior
+
+Lifecycle behavior is applied by the storage service. Rule support, tier support, and restore support depend on backend capabilities.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From 57c981951b5b6e65b8d2217bc12d5be9f385374f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:44 +0800
Subject: [PATCH 29/31] feat(phase-0): add rc replicate reference

---
 docs/reference/rc/replicate.md | 61 ++++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 docs/reference/rc/replicate.md

diff --git a/docs/reference/rc/replicate.md b/docs/reference/rc/replicate.md
new file mode 100644
index 0000000..e12e7ee
--- /dev/null
+++ b/docs/reference/rc/replicate.md
@@ -0,0 +1,61 @@
+# rc replicate
+
+## Purpose
+
+`rc replicate` manages bucket replication configuration and status. It is a legacy-compatible command; prefer `rc bucket replication` for new scripts.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] replicate <COMMAND>
+rc replicate add [OPTIONS] --remote-bucket <TARGET_ALIAS/BUCKET> <SOURCE_ALIAS/BUCKET>
+rc replicate update [OPTIONS] --id <ID> <SOURCE_ALIAS/BUCKET>
+rc replicate list [OPTIONS] <SOURCE_ALIAS/BUCKET>
+rc replicate status [OPTIONS] <SOURCE_ALIAS/BUCKET>
+rc replicate remove [OPTIONS] <SOURCE_ALIAS/BUCKET>
+rc replicate export [OPTIONS] <SOURCE_ALIAS/BUCKET>
+rc replicate import [OPTIONS] <SOURCE_ALIAS/BUCKET> <FILE>
+```
+
+## Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `SOURCE_ALIAS/BUCKET` | Source bucket for replication. |
+| `--remote-bucket TARGET_ALIAS/BUCKET` | Destination bucket for a new rule. |
+| `--id` | Rule identifier to update or remove. |
+| `--replicate` | Comma-separated flags: `delete`, `delete-marker`, `existing-objects`. |
+| `--priority` | Rule priority. Defaults to `1` for new rules. |
+| `--storage-class` | Destination storage class override. |
+| `--bandwidth` | Bandwidth limit in bytes per second; `0` means unlimited. |
+| `--sync` | Enable synchronous replication. |
+| `--prefix` | Key prefix filter. |
+| `--healthcheck-seconds` | Health check interval. Defaults to `60` for new rules. |
+| `--disable-proxy` | Disable replication proxy. |
+| `--all` | Remove all rules. |
+| `--force` | Force operation even if capability detection fails. |
+
+## Examples
+
+```bash
+rc bucket version enable local/reports
+rc bucket version enable backup/reports
+rc bucket replication add local/reports --remote-bucket backup/reports --replicate delete,existing-objects
+rc replicate status local/reports
+rc replicate export local/reports > replication.json
+```
+
+## Behavior
+
+Replication generally requires versioning on source and destination buckets. The target bucket is resolved through its own alias, so configure both source and destination aliases before adding rules.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From 9678e9b997175ad0a42577a184e018f5812494a9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:09:44 +0800
Subject: [PATCH 30/31] feat(phase-0): add rc completions reference

---
 docs/reference/rc/completions.md | 46 ++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 docs/reference/rc/completions.md

diff --git a/docs/reference/rc/completions.md b/docs/reference/rc/completions.md
new file mode 100644
index 0000000..2fbe608
--- /dev/null
+++ b/docs/reference/rc/completions.md
@@ -0,0 +1,46 @@
+# rc completions
+
+## Purpose
+
+`rc completions` generates shell completion scripts for supported shells.
+
+## Syntax
+
+```bash
+rc [GLOBAL OPTIONS] completions <SHELL>
+```
+
+## Parameters
+
+| Parameter | Description |
+| --- | --- |
+| `SHELL` | One of `bash`, `elvish`, `fish`, `powershell`, or `zsh`. |
+
+## Examples
+
+Generate zsh completions:
+
+```bash
+rc completions zsh > _rc
+```
+
+Generate bash completions:
+
+```bash
+rc completions bash > rc.bash
+```
+
+## Behavior
+
+The command writes the completion script to stdout. Install the generated file according to the conventions of your shell and operating system.
+
+Global options shown in command syntax use the same meaning everywhere:
+
+| Option | Description |
+| --- | --- |
+| `--format auto\|human\|json` | Select automatic, human-readable, or JSON output. |
+| `--json` | Emit JSON output where the command supports structured output. |
+| `--no-color` | Disable terminal colors. |
+| `--no-progress` | Disable progress bars. |
+| `-q, --quiet` | Suppress non-error output. |
+| `--debug` | Enable debug logging. |

From 8ac86b4dc01fe01b20f8e4d394ba80d7b0c7b597 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=A9=AC=E7=99=BB=E5=B1=B1?= <cxymds@qq.com>
Date: Thu, 14 May 2026 16:19:46 +0800
Subject: [PATCH 31/31] feat(phase-0): address rc reference review feedback

---
 docs/reference/rc/cat.md    |  5 +++--
 docs/reference/rc/cp.md     |  6 +++---
 docs/reference/rc/mirror.md | 12 ++++++------
 3 files changed, 12 insertions(+), 11 deletions(-)

diff --git a/docs/reference/rc/cat.md b/docs/reference/rc/cat.md
index 7158a73..d840ec2 100644
--- a/docs/reference/rc/cat.md
+++ b/docs/reference/rc/cat.md
@@ -15,8 +15,8 @@ rc [GLOBAL OPTIONS] cat [OPTIONS] <ALIAS/BUCKET/KEY>
 | Parameter | Description |
 | --- | --- |
 | `ALIAS/BUCKET/KEY` | Object path to read. |
-| `--offset` | Start reading at a byte offset. |
-| `--length` | Limit output to a byte length. |
+| `--enc-key` | Encrypt or decrypt with the given base64-encoded key. |
+| `--rewind` | Read object state at a specific time where supported. |
 | `--version-id` | Read a specific object version. |
 
 ## Examples
@@ -24,6 +24,7 @@ rc [GLOBAL OPTIONS] cat [OPTIONS] <ALIAS/BUCKET/KEY>
 ```bash
 rc cat local/reports/summary.txt
 rc object show local/reports/summary.txt --version-id VERSION_ID
+rc cat local/reports/summary.txt --rewind 2026-05-01T00:00:00Z
 ```
 
 ## Behavior
diff --git a/docs/reference/rc/cp.md b/docs/reference/rc/cp.md
index b75cbe0..9c1e586 100644
--- a/docs/reference/rc/cp.md
+++ b/docs/reference/rc/cp.md
@@ -37,15 +37,15 @@ Upload a directory recursively:
 rc object copy ./reports/ local/reports/ --recursive
 ```
 
-Copy between buckets:
+Copy between buckets on the same alias:
 
 ```bash
-rc cp local/reports/summary.json backup/reports/summary.json
+rc cp local/reports/summary.json local/archive/summary.json
 ```
 
 ## Behavior
 
-The last path is the target. Sources can mix local and remote paths only where the command can infer a valid copy direction. Use trailing slashes consistently when copying directory-like prefixes.
+The last path is the target. Sources can mix local and remote paths only where the command can infer a valid copy direction. S3-to-S3 copies are limited to paths under the same alias in the current implementation; use `rc mirror` for remote-to-remote synchronization across aliases. Use trailing slashes consistently when copying directory-like prefixes.
 
 Global options shown in command syntax use the same meaning everywhere:
 
diff --git a/docs/reference/rc/mirror.md b/docs/reference/rc/mirror.md
index c53bdc2..edd27a1 100644
--- a/docs/reference/rc/mirror.md
+++ b/docs/reference/rc/mirror.md
@@ -2,7 +2,7 @@
 
 ## Purpose
 
-`rc mirror` synchronizes objects from a source location to a target location.
+`rc mirror` synchronizes objects from one remote S3-compatible location to another remote S3-compatible location.
 
 ## Syntax
 
@@ -14,8 +14,8 @@ rc [GLOBAL OPTIONS] mirror [OPTIONS] <SOURCE> <TARGET>
 
 | Parameter | Description |
 | --- | --- |
-| `SOURCE` | Local or remote source directory, bucket, or prefix. |
-| `TARGET` | Local or remote destination directory, bucket, or prefix. |
+| `SOURCE` | Remote source bucket or prefix path, in `ALIAS/BUCKET[/PREFIX]` form. |
+| `TARGET` | Remote destination bucket or prefix path, in `ALIAS/BUCKET[/PREFIX]` form. |
 | `--overwrite` | Overwrite changed destination objects. |
 | `--remove` | Delete target objects that no longer exist in the source. |
 | `-n, --dry-run` | Show planned changes without applying them. |
@@ -24,14 +24,14 @@ rc [GLOBAL OPTIONS] mirror [OPTIONS] <SOURCE> <TARGET>
 ## Examples
 
 ```bash
-rc mirror ./site local/web/site --dry-run
-rc mirror ./site local/web/site --overwrite --remove
 rc mirror local/source backup/source --parallel 8
+rc mirror local/web/site backup/web/site --dry-run
+rc mirror local/web/site backup/web/site --overwrite --remove
 ```
 
 ## Behavior
 
-Mirror is intended for prefix-level synchronization. Use `--dry-run` first when combining `--overwrite` and `--remove`.
+Mirror is intended for remote prefix-level synchronization. Local filesystem paths are not supported by the current implementation. Use `--dry-run` first when combining `--overwrite` and `--remove`.
 
 Global options shown in command syntax use the same meaning everywhere: