docs: add TiDB Cloud Filesystem product documentation

TOC-ai.md

@@ -45,20 +45,10 @@
   - [Overview](/ai/ti/ti-overview.md)
   - [Install, Configure, and Update TiDB Cloud CLI](/ai/ti/reference/ti-install-configure-update.md)
   - [Manage TiDB Cloud Starter Instances](/ai/ti/guides/manage-starter-instances.md)
-  - Manage TiDB Cloud Filesystem
-    - [Manage Filesystem Resources](/ai/ti/guides/manage-filesystem-resources.md)
-    - [Configure Filesystem AI Providers](/ai/ti/guides/configure-filesystem-ai-providers.md)
-    - [Manage Filesystem Tokens](/ai/ti/guides/manage-filesystem-tokens.md)
-    - [Work with Filesystem Data](/ai/ti/guides/work-with-filesystem-data.md)
-    - [Manage Filesystem Layers and Checkpoints](/ai/ti/guides/manage-filesystem-layers.md)
-    - [Mount a TiDB Cloud Filesystem](/ai/ti/guides/mount-filesystem.md)
-    - [Manage Git Workspaces](/ai/ti/guides/manage-git-workspaces.md)
-    - [Use Filesystem Journals](/ai/ti/guides/use-filesystem-journals.md)
-    - [Manage Filesystem Vault Secrets](/ai/ti/guides/manage-filesystem-vault-secrets.md)
+  - [Manage TiDB Cloud Filesystem](/ai/ti/guides/manage-filesystems-via-cli.md)
   - Scenarios for Users and Automation
     - [Run a Daily TiDB Cloud CLI Workflow](/ai/ti/guides/ti-daily-workflow-example.md)
     - [Query TiDB Cloud Starter with Explicit SQL Roles](/ai/ti/guides/ti-query-sql-with-roles-example.md)
-    - [Share a TiDB Cloud Filesystem Across Machines](/ai/ti/guides/ti-share-filesystem-across-machines-example.md)
     - [Hand Off CI Artifacts Between Isolated Jobs with TiDB Cloud Filesystem](/ai/ti/guides/ti-ci-artifact-handoff-example.md)
   - Scenarios for AI Agents
     - [Use TiDB Cloud Filesystem in an Agent Sandbox](/ai/ti/guides/ti-agent-sandbox-example.md)

TOC-tidb-cloud-filesystem.md

@@ -0,0 +1,37 @@
+<!-- markdownlint-disable MD007 -->
+<!-- markdownlint-disable MD041 -->
+
+# Table of Contents
+
+## GET STARTED
+
+- [Introduction](/tidb-cloud-filesystem/filesystem-intro.md)
+- [Quick Start](/tidb-cloud-filesystem/filesystem-quick-start.md)
+- Key Concepts
+  - [Authorization](/tidb-cloud-filesystem/filesystem-authorization.md)
+  - [Layers and Checkpoints](/tidb-cloud-filesystem/filesystem-layers-checkpoints.md)
+
+## GUIDES
+
+- [Manage TiDB Cloud Filesystem](/tidb-cloud-filesystem/manage-filesystem-resources.md)
+- [Access an Existing TiDB Cloud Filesystem](/tidb-cloud-filesystem/access-filesystem.md)
+- [Work with Files and Directories](/tidb-cloud-filesystem/work-with-filesystem-data.md)
+- [Manage Filesystem Tokens](/tidb-cloud-filesystem/manage-filesystem-tokens.md)
+- [Share a TiDB Cloud Filesystem](/tidb-cloud-filesystem/filesystem-sharing.md)
+- Mount a Filesystem
+  - [Overview](/tidb-cloud-filesystem/filesystem-mount.md)
+  - [Linux](/tidb-cloud-filesystem/filesystem-mount-linux.md)
+  - [macOS](/tidb-cloud-filesystem/filesystem-mount-macos.md)
+  - [Docker and Docker Compose](/tidb-cloud-filesystem/filesystem-mount-docker.md)
+- [Manage Layers and Checkpoints](/tidb-cloud-filesystem/manage-filesystem-layers.md)
+- [Manage Git Workspaces](/tidb-cloud-filesystem/manage-git-workspaces.md)
+- [Use Filesystem Journals](/tidb-cloud-filesystem/use-filesystem-journals.md)
+- [Manage Filesystem Vault Secrets](/tidb-cloud-filesystem/manage-filesystem-vault-secrets.md)
+- [Configure Filesystem AI Providers](/tidb-cloud-filesystem/configure-filesystem-ai-providers.md)
+- [Automation and AI Agent Workflows](/tidb-cloud-filesystem/use-filesystem-for-automation-and-ai-agents.md)
+
+## REFERENCES
+
+- [Filesystem Command Reference](/tidb-cloud-filesystem/filesystem-command-reference.md)
+- [Regions and Limitations](/tidb-cloud-filesystem/filesystem-regions-and-limitations.md)
+- [Troubleshooting](/tidb-cloud-filesystem/filesystem-troubleshooting.md)

ai/_index.md

@@ -8,7 +8,7 @@ summary: Build AI applications and agent workflows with TiDB using SQL, integrat
 TiDB provides data and workspace capabilities for building AI applications and running AI agent workflows.
 
 - For application development, you can use SQL or [Python SDK for TiDB AI (`pytidb`)](https://github.com/pingcap/pytidb) with structured data, vector search, full-text search, hybrid search, and AI-powered retrieval.
-- For AI agents and automation, you can use [TiDB Cloud CLI (`ti`)](https://github.com/tidbcloud/ti-cli) to manage TiDB Cloud Starter instances and SQL workflows, and use TiDB Cloud Filesystems as persistent, shared storage across local machines, CI jobs, and ephemeral agent sandboxes. Filesystems also support mounted workspaces, Git workflows, journals, and delegated secrets.
+- For AI agents and automation, you can use [TiDB Cloud CLI (`ti`)](https://github.com/tidbcloud/ti-cli) to manage TiDB Cloud Starter instances and SQL workflows, and use [TiDB Cloud Filesystems](/tidb-cloud-filesystem/_index.md) as persistent, shared storage across local machines, CI jobs, and ephemeral agent sandboxes. Filesystems also support mounted workspaces, Git workflows, journals, and delegated secrets.
 
 ## Get started
 
@@ -101,8 +101,8 @@ The TiDB Cloud CLI (`ti`) lets users, scripts, CI jobs, and AI agents manage TiD
 | Understand what `ti` manages and when to use it | [TiDB Cloud CLI Overview](/ai/ti/ti-overview.md) |
 | Install and configure `ti`, then complete a first workflow | [Get Started with TiDB Cloud CLI](/ai/ti/ti-quick-start.md) |
 | Automate TiDB Cloud Starter instance, branch, and SQL operations | [Manage TiDB Cloud Starter Instances](/ai/ti/guides/manage-starter-instances.md) |
-| Persist and share files across machines, CI jobs, and sandboxes | [Manage Filesystem Resources](/ai/ti/guides/manage-filesystem-resources.md) and [Work with Filesystem Data](/ai/ti/guides/work-with-filesystem-data.md) |
-| Use mounted workspaces, Git workspaces, journals, or delegated secrets | [Mount a Filesystem](/ai/ti/guides/mount-filesystem.md), [Manage Git Workspaces](/ai/ti/guides/manage-git-workspaces.md), [Use Filesystem Journals](/ai/ti/guides/use-filesystem-journals.md), and [Manage Filesystem Vault Secrets](/ai/ti/guides/manage-filesystem-vault-secrets.md) |
+| Persist and share files across machines, CI jobs, and sandboxes | [Use TiDB Cloud Filesystem with TiDB Cloud CLI](/ai/ti/guides/manage-filesystems-via-cli.md) |
+| Use mounted workspaces, Git workspaces, journals, or delegated secrets | [Mount a Filesystem](/tidb-cloud-filesystem/filesystem-mount.md), [Manage Git Workspaces](/tidb-cloud-filesystem/manage-git-workspaces.md), [Use Filesystem Journals](/tidb-cloud-filesystem/use-filesystem-journals.md), and [Manage Filesystem Vault Secrets](/tidb-cloud-filesystem/manage-filesystem-vault-secrets.md) |
 | Follow an end-to-end automation or agent example | [Run a Daily TiDB Cloud CLI Workflow](/ai/ti/guides/ti-daily-workflow-example.md) or [Use TiDB Cloud Filesystem in an Agent Sandbox](/ai/ti/guides/ti-agent-sandbox-example.md) |
 | Look up commands, global options, output behavior, and errors | [TiDB Cloud CLI Command Reference](/ai/ti/reference/ti-cli-reference.md) |