@@ -189,7 +189,7 @@ table.search(
.limit(3).to_list()
```
-この例では、ベクトル検索はクエリベクトル`text_vec`テーブルの`chunks`フィールドに格納されているベクトルと比較し、類似度スコアに基づいて意味的に最も関連性の高い上位3つの結果を返します。
+この例では、ベクトル検索はクエリベクトルを`chunks`テーブルの`text_vec`フィールドに格納されているベクトルと比較し、類似度スコアに基づいて意味的に最も関連性の高い上位3つの結果を返します。
`_distance`が近いほど、2つのベクトルはより類似していることを意味します。
diff --git a/ai/quickstart-via-sql.md b/ai/quickstart-via-sql.md
index 079d9c0fbba71..e3ba4f84092e6 100644
--- a/ai/quickstart-via-sql.md
+++ b/ai/quickstart-via-sql.md
@@ -6,19 +6,19 @@ aliases: ['/ja/tidb/stable/vector-search-get-started-using-sql/','/ja/tidb/dev/v
# SQL を介して TiDB + AI を使い始める {#get-started-with-tidb-ai-via-sql}
-TiDB は、MySQL 構文を拡張して[ベクトル検索](/ai/concepts/vector-search-overview.md)をサポートし、新しい [ベクトルデータ型](/ai/reference/vector-search-data-types.md)といくつかの[ベクトル関数](/ai/reference/vector-search-functions-and-operators.md)を導入します。
+TiDB は、MySQL 構文を拡張して[ベクトル検索](/ai/guides/vector-search-overview.md)をサポートし、新しい [ベクトルデータ型](/ai/reference/vector-search-data-types.md)といくつかの[ベクトル関数](/ai/reference/vector-search-functions-and-operators.md)を導入します。
このドキュメントでは、SQL文だけを使用して TiDBベクトル検索を開始する方法を説明します。 [MySQLコマンドラインクライアント](https://dev.mysql.com/doc/refman/8.4/en/mysql.html)を使用して、次の操作を実行する方法を学習します。
- TiDBに接続します。
- ベクトルテーブルを作成します。
-- ベクトル埋め込みを保存する。
+- ベクトル埋め込みを保存します。
- ベクトル検索クエリを実行します。
> **Note:**
>
> - ベクトル検索機能はパブリックプレビューであり、予告なく変更される場合があります。バグを発見した場合は、GitHubで[問題](https://github.com/pingcap/tidb/issues)を報告してください。
-> - ベクトル検索機能は、 [TiDB Self-Managed](/overview.md)および [{{{ .starter }}}](/tidb-cloud/select-cluster-tier.md#starter)で利用できます。TiDB Self-Managedの場合、TiDBのバージョンはv8.4.0以降である必要があります（v8.5.0以降を推奨）。
+> - ベクトル検索機能は、 [TiDB Self-Managed](/overview.md)および [{{{ .starter }}}](https://docs.pingcap.com/tidbcloud/select-cluster-tier/?plan=starter#starter)で利用できます。TiDB Self-Managedの場合、TiDBのバージョンはv8.4.0以降である必要があります（v8.5.0以降を推奨）。
## 前提条件 {#prerequisites}
@@ -72,7 +72,7 @@ mysql --comments --host 127.0.0.1 --port 4000 -u root
### ステップ2. ベクトルテーブルを作成する {#step-2-create-a-vector-table}
-テーブルを作成する際、 `VECTOR`データ型を指定することで、列を[ベクトル](/ai/concepts/vector-search-overview.md#vector-embedding)として定義できます。
+テーブルを作成する際、 `VECTOR`データ型を指定することで、列を[ベクトル](/ai/guides/vector-search-overview.md#vector-embedding)として定義できます。
例えば、3次元の`VECTOR`列を持つテーブル`embedded_documents`を作成するには、MySQL CLI を使用して次の SQL文を実行します。
@@ -95,7 +95,7 @@ Query OK, 0 rows affected (0.27 sec)
### ステップ3. ベクトル埋め込みをテーブルに挿入する {#step-3-insert-vector-embeddings-to-the-table}
-[ベクトル埋め込み](/ai/concepts/vector-search-overview.md#vector-embedding)を持つ3つのドキュメントを`embedded_documents`テーブルに挿入します。
+[ベクトル埋め込み](/ai/guides/vector-search-overview.md#vector-embedding)を持つ3つのドキュメントを`embedded_documents`テーブルに挿入します。
```sql
INSERT INTO embedded_documents
@@ -116,7 +116,7 @@ Records: 3 Duplicates: 0 Warnings: 0
>
> この例では、ベクトル埋め込みの次元を簡略化し、説明のために3次元ベクトルのみを使用しています。
>
-> 実際のアプリケーションでは、 [埋め込みモデル](/ai/concepts/vector-search-overview.md#embedding-model)は多くの場合、数百または数千の次元を持つベクトル埋め込みを生成します。
+> 実際のアプリケーションでは、 [埋め込みモデル](/ai/guides/vector-search-overview.md#embedding-model)は多くの場合、数百または数千の次元を持つベクトル埋め込みを生成します。
### ステップ4. ベクトルテーブルを照会する {#step-4-query-the-vector-table}
@@ -169,7 +169,7 @@ LIMIT 3;
検索結果の 3つの用語は、クエリされたベクトルからのそれぞれの距離によってソートされます。距離が小さいほど、対応する`document`の関連性が高くなります。
-したがって、出力結果から判断すると、泳いでいる動物は魚か、泳ぎの才能に恵まれた犬である可能性が最も高い。
+したがって、出力結果から判断すると、泳いでいる動物は魚か、泳ぎの才能に恵まれた犬である可能性が最も高いです。
## 参照 {#see-also}
diff --git a/ai/reference/vector-search-data-types.md b/ai/reference/vector-search-data-types.md
index e9838e6eb9d4c..a0f12a2d8c8fb 100644
--- a/ai/reference/vector-search-data-types.md
+++ b/ai/reference/vector-search-data-types.md
@@ -11,7 +11,7 @@ aliases: ['/ja/tidb/stable/vector-search-data-types/','/ja/tidbcloud/vector-sear
> **Note:**
>
> - ベクトルデータ型はパブリックプレビューであり、予告なく変更される可能性があります。バグを発見した場合は、GitHubで[問題](https://github.com/pingcap/tidb/issues)報告を行ってください。
-> - ベクトルデータ型は[TiDB Self-Managed](/overview.md) および [TiDB Cloud Starter](/tidb-cloud/select-cluster-tier.md#starter)で使用できます。TiDB Self-Managed の場合、TiDB バージョンは v8.4.0 以降である必要があります（v8.5.0 以降を推奨）。
+> - ベクトルデータ型は[TiDB Self-Managed](/overview.md) および [TiDB Cloud Starter](https://docs.pingcap.com/tidbcloud/select-cluster-tier/?plan=starter#starter)で使用できます。TiDB Self-Managed の場合、TiDB バージョンは v8.4.0 以降である必要があります（v8.5.0 以降を推奨）。
現在、次のベクトルデータ型が利用可能です。
@@ -77,7 +77,7 @@ INSERT INTO vector_table VALUES (1, '[0.3, 0.5, -0.1]'); -- 3 dimensions vector,
INSERT INTO vector_table VALUES (2, '[0.3, 0.5]'); -- 2 dimensions vector, OK
```
-ただし、ベクトル距離は同じ次元のベクトル間でのみ計算できるため、この列に[ベクトル検索インデックス](/ai/reference/vector-search-index.md)構築できないことに注意してください。
+ただし、ベクトル距離は同じ次元のベクトル間でのみ計算できるため、この列に[ベクトル検索インデックス](/ai/reference/vector-search-index.md)を構築できないことに注意してください。
## 比較 {#comparison}
@@ -93,7 +93,7 @@ INSERT INTO vector_table VALUES (2, '[0.3, 0.5]'); -- 2 dimensions vector,
異なる次元を持つ 2つのベクトルは、次の規則に従って辞書式比較を使用して比較されます。
- 2 つのベクトルは最初から要素ごとに比較され、各要素は数値的に比較されます。
-- 最初の不一致要素によって、どのベクトルが辞書式に他のベクトルより*小さい*か*大きいかが*決まります。
+- 最初の不一致要素によって、どのベクトルが辞書式に他のベクトルより*小さい*か*大きい*かが決まります。
- あるベクトルが別のベクトルの接頭辞である場合、短いベクトルは辞書順でもう一方より*小さく*なります。例えば、 `[1,2,3] < [1,2,3,0]` 。
- 同じ長さで同一の要素を持つベクトルは辞書的に*等しい*です。
- 空ベクトルは、辞書順で空でないベクトルよりも*小さい*。例えば、 `[] < [1]` 。
diff --git a/ai/reference/vector-search-functions-and-operators.md b/ai/reference/vector-search-functions-and-operators.md
index ea96191a634ef..565471da31566 100644
--- a/ai/reference/vector-search-functions-and-operators.md
+++ b/ai/reference/vector-search-functions-and-operators.md
@@ -11,7 +11,7 @@ aliases: ['/ja/tidb/stable/vector-search-functions-and-operators/','/ja/tidbclou
> **Note:**
>
> - ベクトル関数と演算子はパブリックプレビューであり、予告なく変更される可能性があります。バグを発見した場合は、GitHubで[問題](https://github.com/pingcap/tidb/issues)報告を行ってください。
-> - ベクトルデータ型は、 [TiDB Self-Managed](/overview.md) および [TiDB Cloud Starter](/tidb-cloud/select-cluster-tier.md#starter) で使用できます。TiDB Self-Managedの場合、TiDBバージョンはv8.4.0以降である必要があります（v8.5.0以降を推奨）。
+> - ベクトルデータ型は、 [TiDB Self-Managed](/overview.md) および [{{{ .starter }}}](https://docs.pingcap.com/tidbcloud/select-cluster-tier/?plan=starter#starter) で使用できます。TiDB Self-Managedの場合、TiDBバージョンはv8.4.0以降である必要があります（v8.5.0以降を推奨）。
## ベクトル関数 {#vector-functions}
@@ -75,7 +75,7 @@ aliases: ['/ja/tidb/stable/vector-search-functions-and-operators/','/ja/tidbclou
| [`<`](https://dev.mysql.com/doc/refman/8.0/en/comparison-operators.html#operator_less-than) | 小なり演算子 |
| [`<=`](https://dev.mysql.com/doc/refman/8.0/en/comparison-operators.html#operator_less-than-or-equal) | 以下演算子 |
| [`NOT BETWEEN ... AND ...`](https://dev.mysql.com/doc/refman/8.0/en/comparison-operators.html#operator_not-between) | 値が範囲内にないか確認する |
-| [`!=` 、 `<>`](https://dev.mysql.com/doc/refman/8.0/en/comparison-operators.html#operator_not-equal) | 等しくない演算子 |
+| [`!=` 、 `<>`](https://dev.mysql.com/doc/refman/8.0/en/comparison-operators.html#operator_not-equal) | 等しくない演算子 |
| [`NOT IN()`](https://dev.mysql.com/doc/refman/8.0/en/comparison-operators.html#operator_not-in) | 値が値のセット内にないかどうかを確認する |
ベクトルの比較方法の詳細については、 [ベクトルデータ型 | 比較](/ai/reference/vector-search-data-types.md#comparison)を参照してください。
@@ -108,7 +108,7 @@ VEC_L2_DISTANCE(vector1, vector2)
次の式を使用して、2つのベクトル間の[L2距離](https://en.wikipedia.org/wiki/Euclidean_distance) (ユークリッド距離) を計算します。
-$距離(p,q)=\sqrt {\sum \limits *{i=1}^{n}{(p* {i}-q_{i})^{2}}}$
+$距離(p,q)=\sqrt {\sum \limits _{i=1}^{n}{(p_{i}-q_{i})^{2}}}$
2つのベクトルの次元数は同じである必要があります。そうでない場合はエラーが返されます。
@@ -134,7 +134,7 @@ VEC_COSINE_DISTANCE(vector1, vector2)
次の式を使用して 2つのベクトル間の[コサイン距離](https://en.wikipedia.org/wiki/Cosine_similarity)を計算します。
-$距離(p,q)=1.0 - {\frac {\sum \limits *{i=1}^{n}{p* {i}q_{i}}}{{\sqrt {\sum \limits *{i=1}^{n}{p* {i}^{2}}}}\cdot {\sqrt {\sum \limits *{i=1}^{n}{q* {i}^{2}}}}}}$
+$距離(p,q)=1.0 - {\frac {\sum \limits _{i=1}^{n}{p_{i}q_{i}}}{{\sqrt {\sum \limits _{i=1}^{n}{p_{i}^{2}}}}\cdot {\sqrt {\sum \limits _{i=1}^{n}{q_{i}^{2}}}}}}$
2つのベクトルの次元数は同じである必要があります。そうでない場合はエラーが返されます。
@@ -162,7 +162,7 @@ VEC_NEGATIVE_INNER_PRODUCT(vector1, vector2)
次の数式を使用して、2つのベクトル間の[内積](https://en.wikipedia.org/wiki/Dot_product)の負の値を使用して距離を計算します。
-$DISTANCE(p,q)=- INNER_PROD(p,q)=-\sum \limits *{i=1}^{n}{p* {i}q_{i}}$
+$距離(p,q)=- INNER\_PROD(p,q)=-\sum \limits _{i=1}^{n}{p_{i}q_{i}}$
2つのベクトルの次元数は同じである必要があります。そうでない場合はエラーが返されます。
@@ -188,7 +188,7 @@ VEC_L1_DISTANCE(vector1, vector2)
次の式を使用して、2つのベクトル間の[L1距離](https://en.wikipedia.org/wiki/Taxicab_geometry) (マンハッタン距離) を計算します。
-$距離(p,q)=\sum \limits *{i=1}^{n}{|p* {i}-q_{i}|}$
+$距離(p,q)=\sum \limits _{i=1}^{n}{|p_{i}-q_{i}|}$
2つのベクトルの次元数は同じである必要があります。そうでない場合はエラーが返されます。
@@ -248,7 +248,7 @@ VEC_L2_NORM(vector)
次の式を使用してベクトルの[L2ノルム](https://en.wikipedia.org/wiki/Norm_(mathematics)) (ユークリッド ノルム) を計算します。
-$NORM(p)=\sqrt {\sum \limits *{i=1}^{n}{p* {i}^{2}}}$
+$NORM(p)=\sqrt {\sum \limits _{i=1}^{n}{p_{i}^{2}}}$
例：
diff --git a/ai/reference/vector-search-improve-performance.md b/ai/reference/vector-search-improve-performance.md
index 511b08def3633..33805a825df11 100644
--- a/ai/reference/vector-search-improve-performance.md
+++ b/ai/reference/vector-search-improve-performance.md
@@ -11,11 +11,11 @@ TiDBベクトル検索を使用すると、画像、ドキュメント、その
> **Note:**
>
> - ベクトル検索機能はパブリックプレビューです。予告なく変更される可能性があります。バグを発見した場合は、GitHubで[問題](https://github.com/pingcap/tidb/issues)報告を行ってください。
-> - ベクトル検索機能は[TiDB Self-Managed](/overview.md) と [TiDB Cloud Starter](/tidb-cloud/select-cluster-tier.md#starter)で利用可能です。TiDB Self-Managedの場合、TiDBバージョンはv8.4.0以降である必要があります（v8.5.0以降を推奨）。
+> - ベクトル検索機能は[TiDB Self-Managed](/overview.md) と [TiDB Cloud Starter](https://docs.pingcap.com/tidbcloud/select-cluster-tier/?plan=starter#starter)で利用可能です。TiDB Self-Managedの場合、TiDBバージョンはv8.4.0以降である必要があります（v8.5.0以降を推奨）。
## ベクトル列にベクトル検索インデックスを追加する {#add-vector-search-index-for-vector-columns}
-[ベクトル検索インデックス](/ai/reference/vector-search-index.md) 、リコール率がわずかに低下するだけのトレードオフで、ベクトル検索クエリのパフォーマンスを通常 10 倍以上大幅に向上させます。
+[ベクトル検索インデックス](/ai/reference/vector-search-index.md)は、再現率がわずかに低下するだけのトレードオフで、ベクトル検索クエリのパフォーマンスを通常 10 倍以上大幅に向上させます。
## ベクトルインデックスが完全に構築されていることを確認する {#ensure-vector-indexes-are-fully-built}
@@ -27,7 +27,7 @@ TiDBベクトル検索を使用すると、画像、ドキュメント、その
パフォーマンスを最適化するには、可能な限りベクトル次元を減らすことを検討してください。これは通常、別の埋め込みモデルへの切り替えが必要になります。モデルを切り替える際には、モデルの変更がベクトルクエリの精度に与える影響を評価する必要があります。
-OpenAI `text-embedding-3-large`などの特定の埋め込みモデルは[埋め込みの短縮](https://openai.com/index/new-embedding-models-and-api-updates/)サポートしています。これは、埋め込みの概念表現特性を失うことなく、ベクトルシーケンスの末尾からいくつかの数値を削除します。このような埋め込みモデルを使用して、ベクトルの次元を削減することもできます。
+OpenAI `text-embedding-3-large`などの特定の埋め込みモデルは[埋め込みの短縮](https://openai.com/index/new-embedding-models-and-api-updates/)をサポートしています。これは、埋め込みの概念表現特性を失うことなく、ベクトルシーケンスの末尾からいくつかの数値を削除します。このような埋め込みモデルを使用して、ベクトルの次元を削減することもできます。
## 結果からベクトル列を除外する {#exclude-vector-columns-from-the-results}
diff --git a/ai/reference/vector-search-index.md b/ai/reference/vector-search-index.md
index cd3d584a91a19..4ff5a12b34592 100644
--- a/ai/reference/vector-search-index.md
+++ b/ai/reference/vector-search-index.md
@@ -6,16 +6,16 @@ aliases: ['/ja/tidb/stable/vector-search-index/','/ja/tidbcloud/vector-search-in
# ベクトル検索インデックス {#vector-search-index}
-[ベクトル検索](/ai/concepts/vector-search-overview.md)文書で説明されているように、ベクトル検索は、与えられたベクトルとデータベースに格納されているすべてのベクトルとの距離を計算することで、与えられたベクトルの上位K近傍（KNN）を特定します。このアプローチは正確な結果をもたらしますが、テーブルに多数のベクトルが含まれている場合、テーブル全体のスキャンが必要となるため、処理速度が低下する可能性があります[^1]
+[ベクトル検索](/ai/guides/vector-search-overview.md)文書で説明されているように、ベクトル検索は、与えられたベクトルとデータベースに格納されているすべてのベクトルとの距離を計算することで、与えられたベクトルの上位K近傍（KNN）を特定します。このアプローチは正確な結果をもたらしますが、テーブルに多数のベクトルが含まれている場合、テーブル全体のスキャンが必要となるため、処理速度が低下する可能性があります[^1]
検索効率を向上させるために、TiDBでは近似KNN（ANN）検索用のベクトル検索インデックスを作成できます。ベクトル検索にベクトルインデックスを使用すると、TiDBは精度をわずかに低下させるだけでクエリパフォーマンスを大幅に向上させ、通常90%以上の検索再現率を維持できます。
> **Note:**
>
> - ベクトル検索機能はパブリックプレビューです。予告なく変更される可能性があります。バグを発見した場合は、GitHubで[問題](https://github.com/pingcap/tidb/issues)報告を行ってください。
-> - ベクトル検索機能は[TiDB Self-Managed](/overview.md)および[TiDB Cloud Starter](/tidb-cloud/select-cluster-tier.md#starter)で利用可能です。TiDB Self-Managedの場合、TiDBバージョンはv8.4.0以降である必要があります（v8.5.0以降を推奨）。
+> - ベクトル検索機能は[TiDB Self-Managed](/overview.md)および[{{{ .starter }}}](https://docs.pingcap.com/tidbcloud/select-cluster-tier/?plan=starter#starter)で利用可能です。TiDB Self-Managedの場合、TiDBバージョンはv8.4.0以降である必要があります（v8.5.0以降を推奨）。
-現在、TiDB は[HNSW（階層的ナビゲート可能なスモールワールド）](https://en.wikipedia.org/wiki/Hierarchical_navigable_small_world)ベクトル検索インデックス アルゴリズムをサポートしています。
+現在、TiDB は[HNSW（階層的ナビゲート可能なスモールワールド）](https://en.wikipedia.org/wiki/Hierarchical_navigable_small_world)ベクトル検索インデックスアルゴリズムをサポートしています。
## 制限 {#restrictions}
@@ -249,7 +249,7 @@ LIMIT 10;
- `vector_index.search.total` : インデックス内の検索にかかる合計時間。レイテンシーが大きい場合、通常、インデックスがコールド状態（一度もアクセスされていない、またはかなり前にアクセスされている状態）であるため、インデックス検索時に大量のI/O操作が発生します。複数のベクトルインデックスが並列で検索される可能性があるため、このフィールドは実際のクエリ時間よりも長くなる可能性があります。
- `vector_index.search.discarded_nodes` : 検索中に訪問されたが破棄されたベクトル行の数。これらの破棄されたベクトルは検索結果には考慮されません。この値が大きい場合、通常、 `UPDATE`または`DELETE`文によって多くの古い行が発生していることを示します。
-出力の解釈については、 [`EXPLAIN`](/sql-statements/sql-statement-explain.md) 、 [`EXPLAIN ANALYZE`](/sql-statements/sql-statement-explain-analyze.md) 、および[EXPLAIN コマンド](/explain-walkthrough.md)を参照してください。
+出力の解釈については、 [`EXPLAIN`](/sql-statements/sql-statement-explain.md) 、 [`EXPLAIN ANALYZE`](/sql-statements/sql-statement-explain-analyze.md) 、および[`EXPLAIN`ウォークスルー](/explain-walkthrough.md)を参照してください。
## 参照 {#see-also}
diff --git a/ai/reference/vector-search-limitations.md b/ai/reference/vector-search-limitations.md
index 1363185cf9e17..085b84eea8e33 100644
--- a/ai/reference/vector-search-limitations.md
+++ b/ai/reference/vector-search-limitations.md
@@ -11,11 +11,11 @@ aliases: ['/ja/tidb/stable/vector-search-limitations/','/ja/tidb/dev/vector-sear
> **Note:**
>
> - ベクトル検索機能はパブリックプレビューです。予告なく変更される場合があります。バグを発見した場合は、GitHubで[問題](https://github.com/pingcap/tidb/issues)を報告してください。
-> - ベクトル検索機能は、 [TiDB Self-Managed](/overview.md)および[{{{ .starter }}}](/tidb-cloud/select-cluster-tier.md#starter)で利用できます。TiDB Self-Managedの場合、TiDBのバージョンはv8.4.0以降である必要があります（v8.5.0以降を推奨）。
+> - ベクトル検索機能は、 [TiDB Self-Managed](/overview.md)および[{{{ .starter }}}](https://docs.pingcap.com/tidbcloud/select-cluster-tier/?plan=starter#starter)で利用できます。TiDB Self-Managedの場合、TiDBのバージョンはv8.4.0以降である必要があります（v8.5.0以降を推奨）。
## ベクトルデータ型の制限 {#vector-data-type-limitations}
-- それぞれ最大 16383 次元 [ベクトル](/ai/reference/vector-search-data-types.md)サポートします。
+- 各 [ベクトル](/ai/reference/vector-search-data-types.md)は、最大 16383 次元をサポートします。
- ベクトルデータ型は、 `NaN` 、 `Infinity` 、または`-Infinity`の値を格納することはできません。
- ベクトルデータ型は倍精度浮動小数点数を格納することはできません。ベクトル列に倍精度浮動小数点数を挿入または格納すると、TiDBはそれらを単精度浮動小数点数に変換します。
- ベクトル列は、主キーとして、または主キーの一部として使用することはできません。
@@ -33,18 +33,18 @@ aliases: ['/ja/tidb/stable/vector-search-limitations/','/ja/tidb/dev/vector-sear
- TiDB Cloudの機能：
- - [TiDB Cloudコンソールのデータ移行機能](/tidb-cloud/migrate-from-mysql-using-data-migration.md)MySQL ベクトルデータ型のTiDB Cloudへの移行または複製をサポートしていません。
+ - [TiDB Cloudコンソールのデータ移行機能](/tidb-cloud/migrate-from-mysql-using-data-migration.md)は、MySQL ベクトルデータ型のTiDB Cloudへの移行または複製をサポートしていません。
- TiDB Self-Managedツール：
- データのバックアップと復元には、 [BR](/br/backup-and-restore-overview.md)のバージョン8.4.0以降を使用していることを確認してください。ベクトルデータ型のテーブルをTiDBバージョン8.4.0より前のバージョンに復元することはサポートされていません。
- - [TiDB Data Migration (DM)](/dm/dm-overview.md) MySQLベクトルデータ型をTiDBに移行または複製することをサポートしていません。
- - [TiCDC](/ticdc/ticdc-overview.md)ベクトルデータ型をサポートしていないダウンストリームにベクトルデータをレプリケートすると、ベクトルデータ型が別のタイプに変更されます。詳細については、 [ベクトルデータ型との互換性](/ticdc/ticdc-compatibility.md#compatibility-with-vector-data-types)を参照してください。
+ - [TiDB Data Migration (DM)](/dm/dm-overview.md) は MySQLベクトルデータ型をTiDBに移行または複製することをサポートしていません。
+ - [TiCDC](/ticdc/ticdc-overview.md)がベクトルデータ型をサポートしていないダウンストリームにベクトルデータをレプリケートすると、ベクトルデータ型が別のタイプに変更されます。詳細については、 [ベクトルデータ型との互換性](/ticdc/ticdc-compatibility.md#compatibility-with-vector-data-types)を参照してください。
## フィードバック {#feedback}
お客様からのご意見を大切にし、いつでもお手伝いいたします。
-- [Discord](https://discord.gg/DQZ2dy3cuc?utm_source=doc)or [Slack](https://slack.tidb.io/invite?team=tidb-community&channel=everyone&ref=pingcap-docs)コミュニティに質問してください。
+- [Discord](https://discord.gg/DQZ2dy3cuc?utm_source=doc) または [Slack](https://slack.tidb.io/invite?team=tidb-community&channel=everyone&ref=pingcap-docs)コミュニティに質問してください。
- [TiDB Cloudのサポートチケットを送信してください](https://tidb.support.pingcap.com/servicedesk/customer/portals)
- [TiDB Self-Managedのサポートチケットを送信してください](/support.md)
diff --git a/ai/ti/guides/configure-filesystem-ai-providers.md b/ai/ti/guides/configure-filesystem-ai-providers.md
new file mode 100644
index 0000000000000..4af12a51bd654
--- /dev/null
+++ b/ai/ti/guides/configure-filesystem-ai-providers.md
@@ -0,0 +1,114 @@
+---
+title: TiDB Cloud Filesystem AI Providers を設定する
+summary: CLI を使用して、TiDB Cloud Filesystem のメディア抽出プロバイダと埋め込みプロバイダを確認および設定する方法を学びます。
+---
+
+# TiDB Cloud Filesystem AI Providers を設定する
+
+TiDB Cloud Filesystem では、オプションでメディアファイルからテキストを抽出し、保存されたコンテンツの埋め込みを生成できます。これらの機能を有効にするには、CLI を通じて 1 つ以上の AI プロバイダを設定します。
+
+## 前提条件 {#prerequisites}
+
+- [TiDB Cloud CLI をインストールして設定する](/ai/ti/reference/ti-install-configure-update.md)。
+- 対象の Filesystem ID を取得します。
+- 選択した AI プロバイダに必要な API キーを取得します。
+
+設定コマンドには、TiDB Cloud API 認証情報と明示的な Filesystem ID が必要です。プロバイダキーは `TI_FS_AI_PROVIDER_API_KEY` を通じて設定します。CLI はこのキーをローカルに永続化しません。Filesystem サービスはこのキーを暗号化して保存し、その後の設定出力ではマスクされた値のみを返します。
+
+対話型シェルでは、シェル履歴に残さずにプロバイダキーを読み取ってエクスポートします。
+
+```bash
+printf 'Provider API key: ' >&2
+read -r -s TI_FS_AI_PROVIDER_API_KEY
+printf '\n' >&2
+export TI_FS_AI_PROVIDER_API_KEY
+```
+
+CI では、マスクされたシークレットから `TI_FS_AI_PROVIDER_API_KEY` を注入します。プロバイダの設定が完了したら、この変数を unset してください。
+
+> **Note:**
+>
+> プロバイダ設定を有効化、再有効化、または置き換えると、Filesystem サービスは認証情報、接続性、およびモデル応答を検証するために、プロバイダエンドポイントへ小さな組み込みリクエストを送信します。この検証リクエストにより、プロバイダ側で課金が発生する場合があります。無効化のみ、またはプロンプトのみの更新では、検証リクエストは送信されません。
+
+## メディア抽出設定を確認する {#inspect-media-extraction-configuration}
+
+メディアタイプに対する有効な抽出設定を読み取ります。
+
+```shell
+ti fs describe-file-system-extract-configuration \
+ --file-system-id "
" \
+ --media-type image
+```
+
+## メディア抽出設定を更新する {#update-media-extraction-configuration}
+
+[`update-file-system-extract-configuration`](/ai/ti/reference/ti-fs-update-file-system-extract-configuration.md) を使用して、画像、音声、または動画の抽出を有効化、更新、または無効化します。たとえば、OpenAI 互換プロバイダを通じて画像抽出を設定するには、次のようにします。
+
+```shell
+ti fs update-file-system-extract-configuration \
+ --file-system-id "" \
+ --media-type image \
+ --enabled true \
+ --provider-api-base https://api.openai.com/v1 \
+ --provider-model "" \
+ --provider-protocol openai
+```
+
+`openai` プロトコルは、画像、音声、および動画の抽出をサポートします。`qwen-asr` プロトコルは、Alibaba Cloud Model Studio を通じた音声抽出でのみサポートされます。別のプロバイダのエンドポイントでも、必要な OpenAI 互換 API 仕様を実装していれば動作する可能性があります。Anthropic、Gemini、Vertex AI、Amazon Bedrock、および Azure OpenAI のネイティブインターフェースはサポートされていません。
+
+メディアタイプの抽出を無効にするには、次のようにします。
+
+```shell
+ti fs update-file-system-extract-configuration \
+ --file-system-id "" \
+ --media-type image \
+ --enabled false
+```
+
+## 埋め込み設定を確認する {#inspect-embedding-configuration}
+
+埋め込みがアプリケーション管理かデータベース管理かを確認します。
+
+```shell
+ti fs describe-file-system-embedding-configuration \
+ --file-system-id ""
+```
+
+## 埋め込み設定を更新する {#update-embedding-configuration}
+
+[`update-file-system-embedding-configuration`](/ai/ti/reference/ti-fs-update-file-system-embedding-configuration.md) を使用して、オプションのアプリケーション管理埋め込み設定を更新します。例:
+
+```shell
+ti fs update-file-system-embedding-configuration \
+ --file-system-id "" \
+ --enabled true \
+ --provider-api-base https://api.openai.com/v1 \
+ --provider-model text-embedding-3-small
+```
+
+アプリケーション管理埋め込みには、1024 次元ベクトルを返す OpenAI 互換エンドポイントが必要です。これらは、Shared Filesystems と、有効な埋め込みモードが `fts_only` である Native Filesystems で利用できます。Native Filesystem がデータベース管理の自動埋め込みを使用している場合、サービスはこの更新を拒否し、`source=database_auto` を報告します。
+
+プロバイダの設定が完了したら、現在のシェルからキーを削除します。
+
+```shell
+unset TI_FS_AI_PROVIDER_API_KEY
+```
+
+この設定を無効にするには、次のようにします。
+
+```shell
+ti fs update-file-system-embedding-configuration \
+ --file-system-id "" \
+ --enabled false
+```
+
+## 設定後のデータフロー {#data-flow-after-configuration}
+
+抽出を有効にすると、Filesystem サービスはメディアコンテンツを設定済みの抽出プロバイダに送信します。抽出されたテキストまたは説明は、設定済みの埋め込みプロバイダに送信されます。データに適したプロバイダアカウントと保持ポリシーを選択してください。
+
+タイムアウト、応答の消失、またはその他の判別しにくいネットワークエラーが原因で更新に失敗した場合は、再試行する前に対応する `describe-file-system-*-configuration` コマンドを実行してください。CLI が応答を受信していなくても、プロバイダ検証リクエストは成功して課金が発生している可能性があります。
+
+## 次のステップ {#what-s-next}
+
+- [TiDB Cloud Filesystem データを操作する](/ai/ti/guides/work-with-filesystem-data.md)
+- [TiDB Cloud Filesystem CLI コマンドリファレンス](/ai/ti/reference/ti-filesystem.md)
\ No newline at end of file
diff --git a/ai/ti/guides/manage-filesystem-layers.md b/ai/ti/guides/manage-filesystem-layers.md
new file mode 100644
index 0000000000000..07240c4d4ab84
--- /dev/null
+++ b/ai/ti/guides/manage-filesystem-layers.md
@@ -0,0 +1,116 @@
+---
+title: TiDB Cloud Filesystem のレイヤーとチェックポイントを管理する
+summary: TiDB Cloud Filesystem のレイヤーを安全に作成、確認、フォーク、チェックポイント、ロールバック、コミット、パック、復元する方法を学びます。
+---
+
+# TiDB Cloud Filesystem のレイヤーとチェックポイントを管理する
+
+レイヤーを使用すると、変更をコミットまたは破棄する前に、Filesystem のベースパス上で分離された変更を記録できます。
+
+## 前提条件 {#prerequisites}
+
+- [TiDB Cloud CLI をインストールして設定する](/ai/ti/reference/ti-install-configure-update.md)。
+- `--file-system-id` を渡す、`TI_FS_FILE_SYSTEM_ID` を設定する、または Filesystem を識別する FS トークンを指定して、Filesystem を選択します。
+- `--fs-token`、`TI_FS_TOKEN`、または選択した Filesystem 用に保存されているローカル認証情報を使用して、必要な読み取りまたは書き込み権限を持つ FS トークンを指定します。
+- レイヤーがオーバーレイするデータのベースパスを選択します。
+
+## レイヤーを作成して確認する {#create-and-inspect-a-layer}
+
+```shell
+ti fs create-layer \
+ --base-root-path /workspace \
+ --layer-name agent-task \
+ --durability-mode restore-safe \
+ --tag task=review
+```
+
+返されたレイヤー ID を使用して、変更を書き込み、確認します。
+
+```shell
+ti fs copy-file \
+ --from-local ./proposal.md \
+ --to-remote /workspace/proposal.md \
+ --layer-id ""
+
+ti fs describe-layer --layer-id ""
+ti fs diff-layer --layer-id ""
+```
+
+> **Note:**
+>
+> `--layer-id` を指定した `copy-file` は、再帰コピーをサポートしていません。ディレクトリツリーをレイヤーに投入するには、レイヤーを書き込み可能な FUSE マウントとしてマウントし、そのマウントパス経由でファイルをコピーしてください。
+
+同じ書き込み可能レイヤーを、複数のローカルパスに同時にマウントしないでください。既存のマウントを再利用するか、別の場所にレイヤーをマウントする前にアンマウントしてください。
+
+## チェックポイントを作成してレイヤーをフォークする {#create-a-checkpoint-and-fork-a-layer}
+
+```shell
+ti fs create-layer-checkpoint \
+ --layer-id "" \
+ --checkpoint-id seed \
+ --label "before review"
+
+ti fs fork-layer \
+ --parent-layer-ref "" \
+ --layer-name experiment \
+ --checkpoint-id seed
+```
+
+`list-layer-chain` を使用して、フォークの固定された祖先チェーンを確認します。
+
+```shell
+ti fs list-layer-chain --layer-ref experiment
+```
+
+チェックポイントマウントは読み取り専用です。チェックポイントから作業を続けるには、そこから新しい書き込み可能レイヤーをフォークしてください。
+
+## レイヤーでの作業を完了する {#finish-work-in-a-layer}
+
+> **Warning:**
+>
+> 書き込み可能な FUSE マウントを持つレイヤーのチェックポイントを作成する前に、[`drain-file-system`](/ai/ti/guides/mount-filesystem.md#drain-or-unmount) を実行してください。チェックポイントには、サービスに到達した変更のみが含まれます。レイヤーをロールバックまたはコミットする前に、drain を実行してから [`unmount-file-system`](/ai/ti/guides/mount-filesystem.md#drain-or-unmount) を実行してください。CLI はこれらの手順を自動では実行しません。
+
+レイヤーに対して、次のいずれかの操作を選択します。
+
+- レイヤーをロールバックして変更を破棄する場合:
+
+ ```shell
+ ti fs rollback-layer --layer-id ""
+ ```
+
+- レイヤーをコミットして変更をベースパスに適用する場合:
+
+ ```shell
+ ti fs commit-layer --layer-id ""
+ ```
+
+> **Note:**
+>
+> 同じレイヤーに対して、`rollback-layer` と `commit-layer` の両方を続けて実行しないでください。
+
+## ローカル状態を別のマシンに移動する {#move-local-state-to-another-machine}
+
+FUSE マウントが write-back キャッシュを使用している場合、一部のデータがローカルのオーバーレイディレクトリに残ることがあります。このローカル状態を別のマシンに移動するには、明示的なリモートアーカイブパスにパックします。
+
+```shell
+ti fs pack-file-system \
+ --mount-path /path/to/workspace \
+ --archive-path /workspace-overlay.tar.gz
+```
+
+移動先のマシンでは、アーカイブをローカルオーバーレイルートに復元します。
+
+```shell
+ti fs unpack-file-system \
+ --local-root /path/to/local-overlay \
+ --remote-root /workspace \
+ --mount-profile portable \
+ --archive-path /workspace-overlay.tar.gz
+```
+
+移動先のマシンで Filesystem をマウントするときは、同じローカルオーバーレイルートを使用してください。pack と unpack のすべてのオプションについては、[`pack-file-system`](/ai/ti/reference/ti-fs-pack-file-system.md) および [`unpack-file-system`](/ai/ti/reference/ti-fs-unpack-file-system.md) のリファレンスを参照してください。
+
+## 次のステップ {#what-s-next}
+
+- [TiDB Cloud Filesystem をマウントする](/ai/ti/guides/mount-filesystem.md)
+- [TiDB Cloud Filesystem CLI コマンドリファレンス](/ai/ti/reference/ti-filesystem.md)
diff --git a/ai/ti/guides/manage-filesystem-resources.md b/ai/ti/guides/manage-filesystem-resources.md
new file mode 100644
index 0000000000000..579d456f4d75d
--- /dev/null
+++ b/ai/ti/guides/manage-filesystem-resources.md
@@ -0,0 +1,85 @@
+---
+title: TiDB Cloud Filesystem リソースを管理する
+summary: TiDB Cloud CLI を使用して、TiDB Cloud Filesystem リソースを安全に作成、確認、チェック、選択、削除する方法を学びます。
+---
+
+# TiDB Cloud Filesystem リソースを管理する
+
+TiDB Cloud Filesystem は、AI エージェントと自動化ワークロード向けに設計されたサーバーレス分散ファイルシステムです。ローカルマシン、サンドボックス、または CI ランナーからのアクセスに依存せず、永続的で共有可能なファイル名前空間を提供します。
+
+TiDB Cloud CLI コマンドを通じてファイルに直接アクセスすることも、Filesystem をサポートされた環境にマウントしてローカルファイルシステムのように操作することもできます。これにより、エージェントの状態の保持、分離された環境間でのファイル共有、CI アーティファクトの受け渡し、再利用可能なワークスペースの管理に役立ちます。
+
+このドキュメントでは、[`ti fs` コマンド](/ai/ti/reference/ti-filesystem.md)を使用して Filesystem リソースを作成、確認、選択、削除する方法について説明します。
+
+## 前提条件 {#prerequisites}
+
+- [TiDB Cloud CLI をインストールして設定する](/ai/ti/reference/ti-install-configure-update.md)。
+- TiDB Cloud API 認証情報を使用してプロファイルを設定します。
+- `jq` をインストールするか、別の JSON プロセッサを使用してコマンド出力を安全に取得します。
+
+## Filesystem を作成する {#create-a-filesystem}
+
+Filesystem を作成し、返された ID と 1 回限りのオーナートークンを、誰でも読み取り可能ではないファイルに保存します。`--wait` フラグを指定すると、CLI はデータプレーンアクセスの準備が整うまでポーリングしてから結果を返します。
+
+```shell
+umask 077
+ti fs create-file-system \
+ --display-name agent-workspace \
+ --label environment=development \
+ --wait > ./filesystem.json
+
+export TI_FS_FILE_SYSTEM_ID="$(jq -r '.file_system_id' ./filesystem.json)"
+export TI_FS_TOKEN="$(jq -r '.fs_token' ./filesystem.json)"
+```
+
+> **Warning:**
+>
+> JSON レスポンスには `fs_token` が 1 回だけ含まれます。CLI はこのトークンをローカルの認証情報ディレクトリにも自動的に保存します。ただし、ローカルストレージが失われた場合、このトークンを再取得することはできません。バックアップコピーをシークレットマネージャーに保存し、その後 `filesystem.json` を削除してください。
+
+> **Note:**
+>
+> Filesystem のラベルには、認証情報、接続文字列、プライベートパス、または個人データを含めないでください。
+
+## Filesystem を一覧表示して確認する {#list-and-inspect-filesystems}
+
+有効なリージョンで利用可能な Filesystem を一覧表示します。
+
+```shell
+ti fs list-file-systems --output text
+```
+
+1 つの Filesystem の信頼できるメタデータを読み取ります。
+
+```shell
+ti fs describe-file-system --file-system-id ""
+```
+
+複数の Filesystem にアクセスできる場合は、`--file-system-id` を明示的に指定するか、`TI_FS_FILE_SYSTEM_ID` 環境変数を設定してください。CLI は Filesystem を自動的に選択しません。
+
+## アクセスをチェックする {#check-access}
+
+リソースの選択、エンドポイント解決、認証情報、および companion アクセスを検証します。
+
+```shell
+ti fs check-file-system --file-system-id ""
+```
+
+## Filesystem を削除する {#delete-a-filesystem}
+
+> **Warning:**
+>
+> Filesystem を削除する前に、その Filesystem に対するアクティブなローカルマウントをすべて drain してアンマウントしてください。CLI はこれを自動では実行しません。
+
+明示的な ID を指定して Filesystem を削除します。
+
+```shell
+ti fs delete-file-system --file-system-id ""
+```
+
+Filesystem の削除は非同期です。サービスがリクエストを受け付けると、CLI は Filesystem のステータスを `deleting` として報告し、一致するローカル認証情報を削除します。この出力は、リモートでの削除が完了したことを意味するものではありません。
+
+## 次のステップ {#what-s-next}
+
+- [TiDB Cloud Filesystem トークンを管理する](/ai/ti/guides/manage-filesystem-tokens.md)
+- [TiDB Cloud Filesystem データを操作する](/ai/ti/guides/work-with-filesystem-data.md)
+- [TiDB Cloud Filesystem CLI コマンドリファレンス](/ai/ti/reference/ti-filesystem.md)
diff --git a/ai/ti/guides/manage-filesystem-tokens.md b/ai/ti/guides/manage-filesystem-tokens.md
new file mode 100644
index 0000000000000..9fa5abdf9ac39
--- /dev/null
+++ b/ai/ti/guides/manage-filesystem-tokens.md
@@ -0,0 +1,79 @@
+---
+title: TiDB Cloud Filesystem トークンを管理する
+summary: TiDB Cloud Filesystem のアクセストークンをインポート、生成、スコープ設定、確認、無効化、更新、取り消しする方法を学びます。
+---
+
+# TiDB Cloud Filesystem トークンを管理する
+
+Filesystem トークンを使用すると、TiDB Cloud API 認証情報を共有せずに、ユーザーや自動化処理に TiDB Cloud Filesystem へのアクセスを付与できます。
+
+## 前提条件 {#prerequisites}
+
+- [TiDB Cloud CLI をインストールして設定する](/ai/ti/reference/ti-install-configure-update.md)。
+- オーナートークンの生成および TiDB Cloud 認証によるトークン管理を行うには、TiDB Cloud API 認証情報を設定し、Filesystem ID を取得します。
+- スコープ付きトークンの生成または bearer 認証によるトークン管理を行うには、オーナー FS トークンを取得します。`--fs-token` で渡すか、`TI_FS_TOKEN` を設定するか、明示的に選択した Filesystem 用に保存されたローカルトークンを使用できます。
+
+> **Note:**
+>
+> セキュリティリスクを避けるため、トークンの平文は秘密情報として扱ってください。トークンの作成およびローテーションのコマンドは、トークン発行時にのみ平文を返します。後からその平文を取得することはできません。
+
+## 既存のトークンをインポートする {#import-an-existing-token}
+
+`import-file-system-token` を実行すると、CLI はトークン形式を検証し、その中に埋め込まれた Filesystem ID を抽出し、リモートの stat リクエストを送信して接続性を確認し、トークンをローカルの認証情報ディレクトリに保存します。
+
+```shell
+ti fs import-file-system-token --from-file ./fs-token --region aws-us-east-1
+```
+
+## トークンを生成する {#generate-a-token}
+
+TiDB Cloud API 認証情報を使用して、別のオーナートークンを生成します。CLI は生成されたトークンをデフォルトではローカルに保存しないため、一度だけ返される平文レスポンスを安全に保存する必要があります。
+
+```shell
+umask 077
+ti fs generate-file-system-token \
+ --file-system-id "" \
+ --token-name ci \
+ --ttl 24h > ./ci-token.json
+```
+
+CLI に生成したトークンをローカル保存させるには、`--store-locally` を追加します。この Filesystem に対して別のトークンがすでに保存されている場合は、`--replace` を使用します。
+
+最小権限のアクセスを実現するには、オーナートークンからパスと操作が制限されたトークンを生成します。
+
+```shell
+ti fs generate-file-system-scoped-token \
+ --file-system-id "" \
+ --ttl 24h \
+ --allow /workspace:read,list > ./scoped-token.json
+```
+
+## トークンの状態を確認および変更する {#inspect-and-change-token-status}
+
+秘密情報を含まないトークンメタデータを一覧表示します。
+
+```shell
+ti fs list-file-system-tokens --file-system-id ""
+```
+
+トークンを一時的に停止するには [`disable-file-system-token`](/ai/ti/reference/ti-fs-disable-file-system-token.md) を使用し、再び有効にするには [`enable-file-system-token`](/ai/ti/reference/ti-fs-enable-file-system-token.md) を使用します。
+
+## トークンをローテーションまたは取り消しする {#rotate-or-revoke-a-token}
+
+トークンをローテーションするには [`refresh-file-system-token`](/ai/ti/reference/ti-fs-refresh-file-system-token.md) を使用します。ローカルに保存されたトークンを更新すると、CLI はローカルの認証情報ファイルを自動的に更新します。`--fs-token` または `TI_FS_TOKEN` で渡されたトークンを更新すると、CLI は新しいトークンを保存せずにコマンド出力として返します。
+
+> **Note:**
+>
+> refresh は冪等ではありません。リクエストが成功した可能性はあるもののレスポンスが失われた場合、古いトークンで再試行しないでください。代わりに、TiDB Cloud 認証情報を使用して新しいオーナートークンを生成してください。
+
+トークンを完全に取り消すには [`delete-file-system-token`](/ai/ti/reference/ti-fs-delete-file-system-token.md) を使用します。削除されたトークンがローカルに保存されているトークンと一致する場合、CLI はローカル認証情報を自動的に削除します。
+
+> **Note:**
+>
+> アクティブなローカルマウントで使用中のトークンをローテーション、無効化、または削除する前に、[`drain-file-system`](/ai/ti/guides/mount-filesystem.md#drain-or-unmount) を実行し、その後 [`unmount-file-system`](/ai/ti/guides/mount-filesystem.md#drain-or-unmount) を実行してください。CLI は既知のアクティブなマウントを確認し、トークンがまだ使用中であれば操作を拒否します。
+
+## 次のステップ {#what-s-next}
+
+- [TiDB Cloud Filesystem を複数のマシン間で共有する](/ai/ti/guides/ti-share-filesystem-across-machines-example.md)
+- [Agent Sandbox で TiDB Cloud Filesystem を使用する](/ai/ti/guides/ti-agent-sandbox-example.md)
+- [TiDB Cloud Filesystem CLI コマンドリファレンス](/ai/ti/reference/ti-filesystem.md)
diff --git a/ai/ti/guides/manage-filesystem-vault-secrets.md b/ai/ti/guides/manage-filesystem-vault-secrets.md
new file mode 100644
index 0000000000000..baa0c7aeb3aee
--- /dev/null
+++ b/ai/ti/guides/manage-filesystem-vault-secrets.md
@@ -0,0 +1,108 @@
+---
+title: TiDB Cloud Filesystem Vault Secrets を管理する
+summary: TiDB Cloud Filesystem Vault を使用して、シークレットを安全に保存、読み取り、委任、注入、監査、失効、およびマウントする方法を学びます。
+---
+
+# TiDB Cloud Filesystem Vault Secrets を管理する
+
+TiDB Cloud Filesystem Vault を使用すると、シークレットを保存し、ユーザーまたはエージェントに対してスコープを限定し有効期限付きのアクセスを委任し、平文をディスクに書き込むことなく認証情報をプロセスに注入できます。
+
+## 前提条件 {#prerequisites}
+
+- [TiDB Cloud CLI をインストールして設定する](/ai/ti/reference/ti-install-configure-update.md)。
+- `--file-system-id` を渡す、`TI_FS_FILE_SYSTEM_ID` を設定する、または Filesystem を識別する FS トークンを指定して、Filesystem を選択します。
+- オーナー操作の場合は、`--fs-token`、`TI_FS_TOKEN`、または選択した Filesystem 用にローカルに保存された認証情報を通じて、オーナー FS トークンを指定します。
+
+> **Note:**
+>
+> セキュリティリスクを避けるため、オーナートークンや委任されたトークンを表示、ログ出力、またはコミットしないでください。
+
+## シークレットを作成して読み取る {#create-and-read-a-secret}
+
+```shell
+ti fs-vault create-secret \
+ --secret-name db-prod \
+ --field DB_URL=mysql://example \
+ --field PASSWORD=@./password.txt
+
+ti fs-vault read-secret --secret-name db-prod
+```
+
+> **Note:**
+>
+> デフォルトの JSON 形式を含むすべての `read-secret` 出力形式には、平文のシークレット値が含まれます。出力は意図したプロセスにのみ渡してください。
+
+## 制限付きアクセスを委任する {#delegate-limited-access}
+
+短期間有効な読み取り grant を作成し、そのトークンを取得します。
+
+```shell
+export TI_VAULT_TOKEN="$(ti fs-vault create-grant \
+ --agent-id deploy-agent \
+ --scope db-prod/DB_URL \
+ --permission read \
+ --ttl 10m \
+ --token-only)"
+```
+
+コマンドラインのトークンよりも `TI_VAULT_TOKEN` を使用することを推奨します。コマンドラインの値は、プロセス一覧やシェル履歴に残る可能性があるためです。
+
+## シークレットをプロセスに注入する {#inject-a-secret-into-a-process}
+
+CLI は、平文をディスクに書き込むことなく、子プロセスに対してシークレットフィールドを環境変数として注入できます。次のコマンドを実行すると、CLI はシークレットを読み取り、各フィールドを環境変数（たとえば `DB_URL`、`PASSWORD`）として設定し、自身の認証用環境変数を子プロセスから削除してから、指定されたコマンドを実行します。
+
+```shell
+ti fs-vault run-with-secret --secret-path /n/vault/db-prod --
+```
+
+平文をディスクに書き込むよりも、プロセス注入を推奨します。
+
+`run-with-secret` によって注入されるフィールド名は、`[A-Z_][A-Z0-9_]*` に一致する必要があります。いずれかのフィールド名がこのパターンに一致しない場合、またはいずれかのフィールド値にサポートされていない制御文字が含まれる場合、コマンドは注入全体を拒否します。注入する予定のフィールドを作成する際は、大文字の環境変数形式の名前を使用してください。
+
+## アクセスを監査して失効する {#audit-and-revoke-access}
+
+```shell
+ti fs-vault list-audit-events \
+ --secret-name db-prod \
+ --agent-id deploy-agent \
+ --since 24h \
+ --limit 20
+
+ti fs-vault delete-grant \
+ --grant-id "" \
+ --revoked-by operator \
+ --reason rotated
+```
+
+失効すると、新たな操作の認可を防止できますが、プロセスがすでに読み取った値を消去することはできません。
+
+## 読み取り専用の Vault ビューをマウントする {#mount-a-read-only-vault-view}
+
+macOS または FUSE をサポートする Linux では、Vault シークレットの読み取り専用 FUSE ビューをマウントできます。CLI はマウントを作成し、マウントパス配下のファイルとしてシークレットフィールドを提供します（たとえば、`/path/to/vault/db-prod/DB_URL`）。
+
+マウントする前に、`TI_VAULT_TOKEN` を委任された Vault トークンに設定します。たとえば、[制限付きアクセスを委任する](#delegate-limited-access) で作成したトークンを使用できます。マウントコマンドには、`TI_VAULT_TOKEN` または `--vault-token` のいずれかが必要です。
+
+```shell
+mkdir -p /path/to/vault
+ti fs-vault mount-vault \
+ --mount-path /path/to/vault
+```
+
+アンマウントする前に、マウントを使用しているすべてのプロセスを停止してください。
+
+```shell
+ti fs-vault unmount-vault --mount-path /path/to/vault
+```
+
+Vault マウントは Windows では利用できません。シークレットの直接読み取りとプロセス注入には、マウントは不要です。
+
+## セキュリティに関する推奨事項 {#security-recommendations}
+
+- フィールドスコープは可能な限り最小にし、TTL は実用上可能な限り短くしてください。
+- 委任されたトークンを CLI 設定や操作ログに保存しないでください。
+- タスク完了後は grant を失効してください。
+
+## 次のステップ {#what-s-next}
+
+- [TiDB Cloud Filesystem Vault Secrets をエージェントに委任する](/ai/ti/guides/ti-vault-agent-secrets-example.md)
+- [TiDB Cloud Filesystem Vault CLI コマンドリファレンス](/ai/ti/reference/ti-filesystem-vault.md)
diff --git a/ai/ti/guides/manage-git-workspaces.md b/ai/ti/guides/manage-git-workspaces.md
new file mode 100644
index 0000000000000..9046b90d26da2
--- /dev/null
+++ b/ai/ti/guides/manage-git-workspaces.md
@@ -0,0 +1,66 @@
+---
+title: TiDB Cloud Filesystem 上で Git ワークスペースを管理する
+summary: マウントされた TiDB Cloud Filesystem 上で Git ワークスペースをクローン、hydrate、リンクされた worktree の作成、削除を行う方法を学びます。
+---
+
+# TiDB Cloud Filesystem 上で Git ワークスペースを管理する
+
+マウントされた TiDB Cloud Filesystem 上で Git ワークスペースのセットアップを高速化するには `ti fs-git` を使用します。日常的な作業では、引き続き通常の Git コマンドを使用できます。
+
+## 前提条件 {#prerequisites}
+
+- [TiDB Cloud CLI をインストールして設定する](/ai/ti/reference/ti-install-configure-update.md)。
+- FUSE を使用して [TiDB Cloud Filesystem をマウントする](/ai/ti/guides/mount-filesystem.md)。
+- `--file-system-id` を渡す、`TI_FS_FILE_SYSTEM_ID` を設定する、または対象の Filesystem を識別する FS トークンを指定して、マウント済み Filesystem を選択します。Git ワークスペース権限を持つ FS トークンを指定してください。
+- Git をインストールし、リポジトリの認証情報を個別に設定します。
+
+## ワークスペースをクローンする {#clone-a-workspace}
+
+```shell
+ti fs-git clone-git-workspace \
+ --repo-url https://github.com/pingcap/tidb.git \
+ --target-path /path/to/workspace/tidb
+```
+
+大規模なリポジトリの場合は、`--blobless --hydrate background` を追加すると、ディレクトリツリーをすぐに利用できるようになります。CLI は、clone コマンドの実行完了後に、クリーンなファイル内容と Git オブジェクトをダウンロードするバックグラウンドプロセスを開始します。コマンドが終了する前に hydration を完了させる必要があるワークフローでは、`--hydrate sync` を使用します。
+
+## 既存のワークスペースを hydrate する {#hydrate-an-existing-workspace}
+
+ワークスペースを `--blobless` 付きで clone した場合は、`hydrate-git-workspace` を実行して不足している Git オブジェクトを明示的に取得できます。
+
+```shell
+ti fs-git hydrate-git-workspace \
+ --target-path /path/to/workspace/tidb \
+ --timeout 30m
+```
+
+hydration は、作業ツリーの変更を破棄することなく、リモートリポジトリから不足している blob データを取得します。
+
+## リンクされた worktree を追加して使用する {#add-and-use-a-linked-worktree}
+
+```shell
+ti fs-git add-git-worktree \
+ --base-path /path/to/workspace/tidb \
+ --worktree-path /path/to/workspace/tidb-feature \
+ --branch-name feature-x
+```
+
+作成後は、リンクされた worktree 内で通常の Git コマンドを使用します。
+
+## worktree を削除する {#remove-a-worktree}
+
+```shell
+ti fs-git remove-git-worktree \
+ --worktree-path /path/to/workspace/tidb-feature
+```
+
+CLI はコミットされていない変更があるかどうかを確認し、worktree がダーティな場合は削除を拒否します。`--force` は、worktree 内のローカル変更を破棄してよいと判断した場合にのみ使用してください。
+
+> **Note:**
+>
+> 一時的なマシンを終了する前に、必要な変更を保存し、不要な worktree を削除して、Filesystem を正常にアンマウントしてください。
+
+## 次のステップ {#what-s-next}
+
+- [TiDB Cloud Filesystem 上でエージェント向けの Git ワークスペースを準備する](/ai/ti/guides/ti-git-workspace-for-agents-example.md)
+- [TiDB Cloud Filesystem Git CLI コマンドリファレンス](/ai/ti/reference/ti-filesystem-git.md)
diff --git a/ai/ti/guides/manage-starter-instances.md b/ai/ti/guides/manage-starter-instances.md
new file mode 100644
index 0000000000000..e5ff9ac9d9f68
--- /dev/null
+++ b/ai/ti/guides/manage-starter-instances.md
@@ -0,0 +1,87 @@
+---
+title: TiDB Cloud Starter インスタンスを管理する
+summary: TiDB Cloud CLI を使用して、Starter インスタンス、ブランチ、SQL ユーザー、接続、SQL ステートメントを作成および管理する方法を学びます。
+---
+
+# TiDB Cloud Starter インスタンスを管理する
+
+このドキュメントでは、TiDB Cloud CLI の `ti db` コマンドを使用して、ターミナルまたは自動化ワークフローから TiDB Cloud Starter インスタンス、ブランチ、および SQL アクセスを管理する方法について説明します。
+
+## 前提条件 {#prerequisites}
+
+- [TiDB Cloud CLI をインストールして設定する](/ai/ti/reference/ti-install-configure-update.md)。
+- TiDB Cloud Starter にアクセスできる認証情報を使用してプロファイルを設定します。
+
+## TiDB Cloud Starter インスタンスを作成する {#create-a-tidb-cloud-starter-instance}
+
+TiDB Cloud Starter インスタンスを作成し、アクティブになるまで待機します。
+
+```shell
+ti db create-db-cluster --db-cluster-type starter --db-cluster-name app-db --wait
+```
+
+## インスタンスを一覧表示する {#list-instances}
+
+有効なリージョン内の TiDB Cloud Starter インスタンスを一覧表示します。
+
+```shell
+ti db list-db-clusters --db-cluster-type starter --output text
+```
+
+TiDB Cloud Starter インスタンスの情報を取得するには、その ID を [`describe-db-cluster`](/ai/ti/reference/ti-db-describe-db-cluster.md) に渡します。
+
+## ブランチを管理する {#manage-branches}
+
+インスタンスから開発ブランチを作成します。
+
+```shell
+ti db create-db-cluster-branch \
+ --db-cluster-id "" \
+ --db-cluster-branch-name dev \
+ --wait
+```
+
+ブランチの一覧表示、詳細表示、および削除コマンドを使用して、そのライフサイクルを管理します。各コマンドの完全なオプションについては、[`ti db` コマンドリファレンス](/ai/ti/reference/ti-starter-database.md)を参照してください。
+
+## SQL アクセスを設定する {#configure-sql-access}
+
+インスタンス用の読み取り専用、読み取り/書き込み、および管理者 SQL ユーザーを作成または修復します。
+
+```shell
+ti db create-db-sql-users --db-cluster-id ""
+```
+
+保存されている認証情報をアプリケーション向けに整形します。
+
+```shell
+ti db format-db-connection-string \
+ --db-cluster-id "" \
+ --read-only \
+ --format env
+```
+
+## SQL を実行する {#execute-sql}
+
+明示的な SQL ロールを指定して 1 つのステートメントを実行します。
+
+```shell
+ti db execute-sql-statement \
+ --db-cluster-id "" \
+ --read-only \
+ --sql "SELECT 1"
+```
+
+読み取り専用、読み取り/書き込み、および管理操作を分離するワークフローについては、[明示的な SQL ロールで TiDB Cloud Starter をクエリする](/ai/ti/guides/ti-query-sql-with-roles-example.md)を参照してください。
+
+## インスタンスを削除する {#delete-an-instance}
+
+インスタンスが不要になったら、それを削除し、削除が確認できるようになるまで待機します。
+
+```shell
+ti db delete-db-cluster --db-cluster-id "" --wait
+```
+
+## 次のステップ {#what-s-next}
+
+- [TiDB Cloud Starter CLI コマンドリファレンス](/ai/ti/reference/ti-starter-database.md)
+- [日次の TiDB Cloud CLI ワークフローを実行する](/ai/ti/guides/ti-daily-workflow-example.md)
\ No newline at end of file
diff --git a/ai/ti/guides/mount-filesystem.md b/ai/ti/guides/mount-filesystem.md
new file mode 100644
index 0000000000000..3be3e6bd98853
--- /dev/null
+++ b/ai/ti/guides/mount-filesystem.md
@@ -0,0 +1,130 @@
+---
+title: TiDB Cloud Filesystem をマウントする
+summary: macOS、Linux、またはコンテナ内で TiDB Cloud Filesystem を安全にマウント、使用、drain、アンマウントする方法を学びます。
+---
+
+# TiDB Cloud Filesystem をマウントする
+
+TiDB Cloud CLI では、アプリケーションがローカルファイルシステムのパスを通じてリモートデータにアクセスする必要がある場合に、TiDB Cloud Filesystem をマウントできます。
+
+## 前提条件 {#prerequisites}
+
+- [TiDB Cloud CLI をインストールして設定する](/ai/ti/reference/ti-install-configure-update.md)。
+- `--file-system-id` を渡す、`TI_FS_FILE_SYSTEM_ID` を設定する、または Filesystem を識別する FS トークンを指定して、Filesystem を選択します。
+- `--fs-token`、`TI_FS_TOKEN`、または選択した Filesystem 用に保存されているローカル認証情報を通じて FS トークンを指定します。
+- Linux では、FUSE3 をインストールし、`/dev/fuse` へのアクセスを提供します。
+
+## マウントドライバーを選択する {#choose-a-mount-driver}
+
+| プラットフォーム | `--driver auto` | 注記 |
+|---|---|---|
+| macOS | WebDAV | FUSE サポートを使用するには macFUSE をインストールし、`--driver fuse` を選択します。 |
+| Linux | FUSE | WebDAV マウントはサポートされていません。 |
+| Windows | サポートされていません | マウントせずに `ti fs` のデータプレーンコマンドを使用します。 |
+
+## Filesystem をマウントする {#mount-the-filesystem}
+
+macOS または Linux では、ローカルパスを作成し、Filesystem をバックグラウンドでマウントします。
+
+```shell
+mkdir -p /path/to/workspace
+ti fs mount-file-system \
+ --file-system-id "" \
+ --mount-path /path/to/workspace
+```
+
+CLI はバックグラウンドのマウントプロセスを開始し、drain コマンドとアンマウントコマンドが正しいプロセスを見つけられるように、ローカルのマウントロケーターを書き込みます。
+
+サブツリーを公開するには `--remote-path` を使用し、書き込みを防ぐには `--read-only` を使用します。レイヤーまたは checkpoint をマウントするには、FUSE ドライバーを選択し、[`mount-file-system` リファレンス](/ai/ti/reference/ti-fs-mount-file-system.md)で説明されている適切な layer オプションを渡します。
+
+## コンテナ内でマウントする {#mount-in-a-container}
+
+イメージ内に FUSE3 をインストールするだけでは不十分です。ホストが `/dev/fuse` を公開し、コンテナがマウントを実行できるよう許可されている必要があります。Docker では、次と同等の設定を指定します。
+
+```shell
+docker run --rm -it \
+ --device /dev/fuse \
+ --cap-add SYS_ADMIN \
+ --security-opt apparmor=unconfined \
+ --env TI_FS_TOKEN \
+ --env TI_REGION_CODE \
+ --env TI_FS_FILE_SYSTEM_ID \
+
+```
+
+Docker Compose では、同じデバイス、ケーパビリティ、セキュリティ、および環境変数の設定を渡します。
+
+```yaml
+services:
+ agent:
+ image:
+ devices:
+ - /dev/fuse:/dev/fuse
+ cap_add:
+ - SYS_ADMIN
+ security_opt:
+ - apparmor=unconfined
+ environment:
+ TI_FS_TOKEN: ${TI_FS_TOKEN}
+ TI_REGION_CODE: ${TI_REGION_CODE}
+ TI_FS_FILE_SYSTEM_ID: ${TI_FS_FILE_SYSTEM_ID}
+```
+
+> **Warning:**
+>
+> `SYS_ADMIN` と制限のない AppArmor プロファイルは、コンテナ分離を弱めます。これらは、専用で信頼できるコンテナに対してのみ使用してください。FUSE アクセスを利用できない場合は、マウントせずに `ti fs` のデータコマンドを使用してください。
+
+## Ubuntu 26.04 のマウントパス {#ubuntu-2604-mount-paths}
+
+Ubuntu 26.04 は `/usr/bin/fusermount3` に AppArmor プロファイルを適用します。デフォルトでは、`/workspace` の代わりに、現在のユーザーのホームディレクトリ、`/mnt`、`/media`、`/tmp`、または `/run/user/` の配下にあるパスを使用してください。
+
+例:
+
+```shell
+mkdir -p "$HOME/workspace"
+ti fs mount-file-system \
+ --file-system-id "" \
+ --mount-path "$HOME/workspace"
+```
+
+アプリケーションが `/workspace` を必要とする場合は、次のルールを `/etc/apparmor.d/local/fusermount3` に追加します。
+
+```text
+mount fstype=@{fuse_types} options=(nosuid,nodev) options in (ro,rw,noatime,dirsync,nodiratime,noexec,sync) -> /workspace/{,**/},
+umount /workspace/{,**/},
+```
+
+その後、プロファイルを再読み込みします。
+
+```shell
+sudo apparmor_parser -r /etc/apparmor.d/fusermount3
+```
+
+関連するエラーについては、[TiDB Cloud CLI のトラブルシューティング](/ai/ti/reference/ti-troubleshooting.md)を参照してください。
+
+## drain またはアンマウントする {#drain-or-unmount}
+
+`unmount-file-system` を実行すると、CLI はマウントを停止する前に、開いているファイルハンドルと保留中の FUSE 処理を自動的にフラッシュします。
+
+```shell
+ti fs unmount-file-system --mount-path /path/to/workspace
+```
+
+FUSE マウントをオンラインのまま維持しつつ耐久性バリアが必要な場合（たとえば、レイヤーのチェックポイントを作成する前など）は、`drain-file-system` を明示的に実行します。このコマンドは、アンマウントせずに保留中の書き込みをフラッシュし、それらが完了するまで待機します。
+
+```shell
+ti fs drain-file-system --mount-path /path/to/workspace --timeout 30s
+```
+
+> **Note:**
+>
+> Drain は FUSE マウントでのみサポートされます。WebDAV マウントでは、通常のファイルクローズ操作を通じて書き込みがフラッシュされます。
+
+> **Warning:**
+>
+> 書き込みが保留中のまま、またはアンマウントがエラーを返した後に、マシンを停止しないでください。メモリ内の書き込みとローカルのみに存在するオーバーレイファイルが失われる可能性があります。FUSE マウントでは、シャットダウン前に `drain-file-system` を実行して、保留中の書き込みがリモート Filesystem に到達したことを確認してください。WebDAV マウントでは、アプリケーション内でファイルを閉じ、`unmount-file-system` が成功することを確認してください。
+
+## 次のステップ {#what-s-next}
+
+- [TiDB Cloud Filesystem の Layers と Checkpoints を管理する](/ai/ti/guides/manage-filesystem-layers.md)
+- [TiDB Cloud Filesystem CLI コマンドリファレンス](/ai/ti/reference/ti-filesystem.md)
diff --git a/ai/ti/guides/ti-agent-sandbox-example.md b/ai/ti/guides/ti-agent-sandbox-example.md
new file mode 100644
index 0000000000000..3a0ec0d5c661a
--- /dev/null
+++ b/ai/ti/guides/ti-agent-sandbox-example.md
@@ -0,0 +1,111 @@
+---
+title: エージェントサンドボックスで TiDB Cloud Filesystem を使う
+summary: 信頼できるマシン上で Filesystem をプロビジョニングし、TiDB Cloud API キーを使わずに、クリーンなエージェントサンドボックスへ設定不要でアクセスを提供します。
+---
+
+# エージェントサンドボックスで TiDB Cloud Filesystem を使う
+
+このワークフローでは、ユーザーの TiDB Cloud CLI 設定全体をサンドボックスにコピーすることなく、一時的なコーディングエージェントに対して永続的で共有可能なワークスペースを提供できます。サンドボックスのローカルディスクが使い捨てであっても、エージェントが成果物、リポジトリの状態、または以前のセッションや他のワーカーからのファイルを必要とし、サンドボックスごとにその状態を毎回再構築したくない場合に使用します。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェースは予告なく変更される場合があります。
+
+> **Note:**
+>
+> このワークフローを実際に試せる版として、[TiDB Cloud Filesystem for Agent Sandbox Lab](https://labs.tidb.io/labs/demo_901) を開いてください。このインタラクティブな演習では、エージェントサンドボックスで永続的な Filesystem を使用する方法を案内します。
+
+## 仕組み {#how-it-works}
+
+信頼できるマシンが一度だけ Filesystem をプロビジョニングします。サンドボックスには Filesystem のオーナートークンとリージョンコードだけが渡されるため、`ti configure`、コピーした `~/.ti/` ディレクトリ、または TiDB Cloud API キーなしで、通常のファイル操作やデータプレーン、マウント、Git、ジャーナル、vault のワークフローを利用できます。これにより、汎用オブジェクトストレージ API で必要となるアプリケーション固有のアップロードおよびダウンロードロジックも不要になります。このトークンは Filesystem を識別します。エージェントが一部のシークレットだけを必要とする場合は、オーナートークンの代わりに委任された vault トークンを使用してください。
+
+## 前提条件 {#prerequisites}
+
+- 信頼できるマシンに TiDB Cloud CLI をインストールして設定します。
+- リリースインストーラーを使用して、サンドボックスに TiDB Cloud CLI をインストールします。
+- 信頼できるマシンに `jq` をインストールします。
+- トークンの受け渡しには、安全なシークレットマネージャーまたは暗号化されたサンドボックス入力を使用します。
+
+## ステップ 1. 信頼できるマシンでプロビジョニングする {#step-1-provision-on-the-trusted-machine}
+
+```bash
+umask 077
+ti fs create-file-system --wait > ./filesystem.json
+export FILE_SYSTEM_ID="$(jq -r '.file_system_id' ./filesystem.json)"
+export TI_FS_TOKEN="$(jq -r '.fs_token' ./filesystem.json)"
+```
+
+トークンをシークレットマネージャーに保存し、コントロールプレーンのクリーンアップ用に `FILE_SYSTEM_ID` を記録し、Filesystem の作成に使用したリージョンコードも記録します。トークンを安全に保存した後、`filesystem.json` を削除してください。
+
+## ステップ 2. サンドボックスに最小限の環境を注入する {#step-2-inject-the-minimum-sandbox-environment}
+
+次の内容で、サンドボックスのシークレットまたは環境変数の仕組みを設定します。
+
+```bash
+TI_FS_TOKEN=
+TI_REGION_CODE=
+```
+
+サンドボックスには `TIDB_CLOUD_PUBLIC_KEY`、`TIDB_CLOUD_PRIVATE_KEY`、`ti configure`、または `~/.ti/` からコピーしたファイルは不要です。
+
+## ステップ 3. 直接アクセスを確認する {#step-3-verify-direct-access}
+
+サンドボックス内で次を実行します。
+
+```bash
+printf 'sandbox ready\n' | ti fs copy-file \
+ --from-stdin \
+ --to-remote /sandbox/status.txt
+
+ti fs read-file --path /sandbox/status.txt
+```
+
+期待される出力:
+
+```text
+sandbox ready
+```
+
+## ステップ 4. 必要に応じて Filesystem をマウントする {#step-4-optionally-mount-the-filesystem}
+
+Linux で FUSE を使用する場合:
+
+```bash
+mkdir -p "$HOME/workspace"
+ti fs mount-file-system \
+ --mount-path "$HOME/workspace" \
+ --driver fuse
+
+cat "$HOME/workspace/sandbox/status.txt"
+```
+
+macOS では、FUSE のインストールが不要な WebDAV を使用するため、`--driver fuse` を省略します。Git ワークスペース、レイヤー、online drain などの FUSE 固有の機能が必要な場合は、macFUSE をインストールして FUSE を選択してください。プラットフォーム要件とマウントパスの制限については、[TiDB Cloud Filesystem をマウントする](/ai/ti/guides/mount-filesystem.md) を参照してください。
+
+マウント後は、同じ FS 環境で `ti fs-git`、`ti fs-journal`、およびオーナーに認可された `ti fs-vault` コマンドを使用できます。エージェントが一部のシークレットフィールドだけを必要とする場合は、オーナートークンの代わりに委任された `TI_VAULT_TOKEN` を渡してください。
+
+## クリーンアップ {#cleanup}
+
+ライターを停止してアンマウントします。正常な FUSE アンマウントでは、保留中の作業が自動的にフラッシュおよび drain されます。
+
+```bash
+ti fs unmount-file-system --mount-path "$HOME/workspace"
+```
+
+FUSE マウントでは、マウントを維持したままリモートへの永続化を確認したい場合、`ti fs drain-file-system --mount-path "$HOME/workspace"` を別途使用します。`drain-file-system` は WebDAV ではサポートされていません。詳細は [drain またはアンマウント](/ai/ti/guides/mount-filesystem.md#drain-or-unmount) を参照してください。信頼できるマシンに戻って、次を実行します。
+
+```bash
+ti fs delete-file-system \
+ --file-system-id "$FILE_SYSTEM_ID"
+```
+
+## セキュリティと運用上の注意 {#security-and-operational-notes}
+
+- `TI_FS_TOKEN` はオーナー認証情報として扱ってください。
+- イメージ、リポジトリ、コマンドフラグ、または操作ログに配置しないでください。
+- サンドボックスを削除しても、リモートの Filesystem は削除されません。
+- 正常なアンマウントでは保留中の FUSE 書き込みが drain されますが、アンマウントせずにサンドボックスを削除しても drain されません。
+
+## 次のステップ {#what-s-next}
+
+- [TiDB Cloud Filesystem CLI コマンドリファレンス](/ai/ti/reference/ti-filesystem.md)
+- [TiDB Cloud CLI の設定と認証情報](/ai/ti/reference/ti-configuration-and-credentials.md)
diff --git a/ai/ti/guides/ti-ci-artifact-handoff-example.md b/ai/ti/guides/ti-ci-artifact-handoff-example.md
new file mode 100644
index 0000000000000..8f416bfcad7b5
--- /dev/null
+++ b/ai/ti/guides/ti-ci-artifact-handoff-example.md
@@ -0,0 +1,76 @@
+---
+title: TiDB Cloud Filesystem を使用して分離されたジョブ間で CI アーティファクトを受け渡す
+summary: ビルド出力を TiDB Cloud Filesystem に永続化し、完全な TiDB Cloud CLI プロファイルをコピーせずに後続の CI ジョブから利用します。
+---
+
+# TiDB Cloud Filesystem を使用して分離されたジョブ間で CI アーティファクトを受け渡す
+
+このワークフローでは、分離された CI ジョブまたはランナー間でアーティファクトを受け渡すための永続的な受け渡しポイントとして Filesystem を使用します。ビルド出力を生成ジョブの終了後も保持し、プロバイダー固有のアーティファクト API、保持モデル、ダウンロードワークフローを追加せずに、後続のコンシューマージョブで利用できるようにする必要がある場合に使用します。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェースは予告なく変更される場合があります。
+
+## 仕組み {#how-it-works}
+
+パイプラインは、1 つの Filesystem トークンとリージョンを両方のジョブに注入します。トークンは Filesystem を識別します。生成側ジョブは `/ci/${RUN_ID}/` のような今回の実行に固有のパス配下に出力をアップロードし、コンシューマー側ジョブは別のランナー上でその正確なパスからデータをダウンロードまたはストリーミングします。どちらのジョブにも TiDB Cloud API キーやコピーされた `~/.ti/` ディレクトリは不要です。
+
+## 前提条件 {#prerequisites}
+
+信頼できるマシンで [Filesystem を作成](/ai/ti/guides/manage-filesystem-resources.md#create-a-filesystem) し、次の値を保護された CI シークレットまたは変数として保存します。
+
+```text
+TI_FS_TOKEN
+TI_REGION_CODE
+```
+
+並行して実行されるパイプラインを分離するために、`RUN_ID` のような CI 生成の実行識別子を使用します。
+
+## 生成側ジョブ {#producer-job}
+
+アーティファクトをビルドしてからアップロードします。
+
+```bash
+tar -czf app.tar.gz ./dist
+ti fs copy-file \
+ --from-local ./app.tar.gz \
+ --to-remote "/ci/${RUN_ID}/app.tar.gz" \
+ --tag pipeline=build \
+ --description "artifact for run ${RUN_ID}"
+```
+
+## コンシューマー側ジョブ {#consumer-job}
+
+別のランナーからアーティファクトをダウンロードして検証します。
+
+```bash
+ti fs copy-file \
+ --from-remote "/ci/${RUN_ID}/app.tar.gz" \
+ --to-local ./app.tar.gz \
+ --create-parents
+
+tar -tzf app.tar.gz
+```
+
+標準入力を受け付けるコマンドの場合は、中間のローカルファイルを避けられます。
+
+```bash
+ti fs copy-file --from-remote "/ci/${RUN_ID}/app.tar.gz" --to-stdout \
+ | tar -tzf -
+```
+
+## クリーンアップと分離 {#cleanup-and-isolation}
+
+すべてのコンシューマーが完了した後で、今回の実行に固有のディレクトリのみを削除します。
+
+```bash
+ti fs delete-file --path "/ci/${RUN_ID}" --recursive
+```
+
+一意の実行 ID を使用し、個々のジョブから Filesystem 全体を削除しないでください。Filesystem の削除には信頼されたコントロールプレーンの設定が必要であり、別個の所有者操作として維持する必要があります。
+
+## 次のステップ {#what-s-next}
+
+- [TiDB Cloud Filesystem CLI コマンドリファレンス](/ai/ti/reference/ti-filesystem.md)
+- [TiDB Cloud CLI の設定と認証情報](/ai/ti/reference/ti-configuration-and-credentials.md)
+- [TiDB Cloud CLI のリージョン、セキュリティ、および制限事項](/ai/ti/reference/ti-regions-security-and-limitations.md)
\ No newline at end of file
diff --git a/ai/ti/guides/ti-daily-workflow-example.md b/ai/ti/guides/ti-daily-workflow-example.md
new file mode 100644
index 0000000000000..79ec50198fb71
--- /dev/null
+++ b/ai/ti/guides/ti-daily-workflow-example.md
@@ -0,0 +1,125 @@
+---
+title: 日次の TiDB Cloud CLI ワークフローを実行する
+summary: リソースを確認し、TiDB Cloud Starter インスタンスと Filesystem を管理し、TiDB Cloud CLI の更新を確認して、リソースをクリーンアップします。
+---
+
+# 日次の TiDB Cloud CLI ワークフローを実行する
+
+この例では、TiDB Cloud Starter と TiDB Cloud Filesystem にまたがる、一般的なオペレーターのワークフローを示します。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェースは、予告なく変更される場合があります。
+
+## 前提条件 {#prerequisites}
+
+- `ti` をインストールし、`ti configure` を実行します。
+- 組織に、1 つの TiDB Cloud Starter インスタンスと 1 つの Filesystem を作成できる容量があることを確認します。
+
+## ステップ 1. 現在のリソースを確認する {#step-1-inspect-current-resources}
+
+```bash
+ti db list-db-clusters --db-cluster-type starter --output text
+ti fs list-file-systems --output text
+```
+
+## ステップ 2. TiDB Cloud Starter インスタンスを作成する {#step-2-create-a-tidb-cloud-starter-instance}
+
+```bash
+ti db create-db-cluster \
+ --db-cluster-type starter \
+ --db-cluster-name daily-demo \
+ --dry-run
+
+export DB_CLUSTER_ID="$(ti db create-db-cluster \
+ --db-cluster-type starter \
+ --db-cluster-name daily-demo \
+ --wait \
+ --query id \
+ --output text)"
+```
+
+このコマンドは、返されたクラスター ID を `DB_CLUSTER_ID` に保存します。`--wait` が設定されているため、作成コマンドはクラスターがアクティブになった後に戻ります。後で再度確認することもできます。
+
+```bash
+ti db describe-db-cluster \
+ --db-cluster-id "$DB_CLUSTER_ID" \
+ --output text
+```
+
+## ステップ 3. SQL アクセスを確認する {#step-3-verify-sql-access}
+
+```bash
+ti db create-db-sql-users --db-cluster-id "$DB_CLUSTER_ID"
+ti db execute-sql-statement \
+ --db-cluster-id "$DB_CLUSTER_ID" \
+ --read-only \
+ --sql "SELECT CURRENT_TIMESTAMP AS checked_at" \
+ --output text
+```
+
+## ステップ 4. Filesystem を作成して使用する {#step-4-create-and-use-a-filesystem}
+
+```bash
+export TI_FS_FILE_SYSTEM_ID="$(ti fs create-file-system \
+ --wait \
+ --query file_system_id \
+ --output text)"
+
+printf 'daily workflow\n' | ti fs copy-file \
+ --from-stdin \
+ --to-remote /notes/today.txt
+
+ti fs list-files \
+ --path /notes \
+ --output text
+```
+
+`/notes/today.txt` 内のファイルにより、明示的に選択したリソースが使用可能であることを確認できます。
+
+## ステップ 5. 更新を確認する {#step-5-check-for-updates}
+
+インストール済みバージョンを変更せずに、新しいバージョンが利用可能かどうかを確認します。
+
+```bash
+ti update --check
+```
+
+更新をプレビューします。
+
+```bash
+ti update --dry-run
+```
+
+別のワークフローでアクティブな Filesystem または Vault マウントがある場合は、更新を適用する前にライターを停止してアンマウントしてください。これにより、`ti` と Filesystem ランタイムが一緒に更新されます。手順については、[TiDB Cloud CLI を更新する](/ai/ti/reference/ti-install-configure-update.md#update-tidb-cloud-cli) を参照してください。
+
+適切なタイミングで更新を適用します。
+
+```bash
+ti update
+```
+
+## クリーンアップ {#cleanup}
+
+```bash
+ti fs delete-file-system \
+ --file-system-id "$TI_FS_FILE_SYSTEM_ID"
+
+ti db delete-db-cluster \
+ --db-cluster-id "$DB_CLUSTER_ID"
+```
+
+> **Note:**
+>
+> ローカルの TiDB Cloud CLI 設定を削除しても、リモートリソースは削除されません。
+
+## セキュリティに関する注意 {#security-notes}
+
+- FS トークンや整形済みのデータベース接続文字列を出力しないでください。
+- 一意の自動化プレフィックスを使用し、その実行で作成されたリソースのみを削除してください。
+- 破壊的な操作は `--dry-run` で事前確認してください。
+
+## 次のステップ {#what-s-next}
+
+- [TiDB Cloud Starter CLI コマンドリファレンス](/ai/ti/reference/ti-starter-database.md)
+- [TiDB Cloud Filesystem CLI コマンドリファレンス](/ai/ti/reference/ti-filesystem.md)
\ No newline at end of file
diff --git a/ai/ti/guides/ti-git-workspace-for-agents-example.md b/ai/ti/guides/ti-git-workspace-for-agents-example.md
new file mode 100644
index 0000000000000..99057c205514a
--- /dev/null
+++ b/ai/ti/guides/ti-git-workspace-for-agents-example.md
@@ -0,0 +1,96 @@
+---
+title: TiDB Cloud Filesystem 上でエージェント向けの Git ワークスペースを準備する
+summary: 大規模な Git ワークスペースをすばやく利用可能にし、クリーンオブジェクトをバックグラウンドで hydrate して、完全なダウンロードが終わる前にエージェントが作業を開始できるようにします。
+---
+
+# TiDB Cloud Filesystem 上でエージェント向けの Git ワークスペースを準備する
+
+このワークフローでは、エージェントタスクの開始におけるクリティカルパスから、大規模リポジトリのクローンを取り除きます。完全なダウンロードが完了する前に、一時的なエージェントが大規模リポジトリを調査または変更する必要がある場合に使用します。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェースは、予告なく変更される場合があります。
+
+## 仕組み {#how-it-works}
+
+`ti fs-git clone-git-workspace --blobless --hydrate background` は、置き換え可能なエージェントランタイム間で共有できる Git ワークスペースを登録し、すべてのクリーン ブロブのダウンロードが完了する前にそのファイルツリーを公開します。このコマンドはすぐに戻るため、`ti` がバックグラウンドでクリーンツリーとローカル Git オブジェクトデータベースを hydrate している間に、エージェントはパスを調査して作業を開始できます。通常の clone とは異なり、初期オブジェクト転送はワークフロー全体をブロックしません。ネイティブの blobless partial clone のみを使う場合と異なり、バックグラウンド hydration により、エージェントのクリティカルパス上で繰り返し発生するオンデマンドフェッチを減らせます。hydration の完了前に到着した読み取りは、正確性を保つために引き続き Git の lazy fetch にフォールバックします。編集、commit、fetch、push は通常どおり Git が担当します。
+
+## 前提条件 {#prerequisites}
+
+- Filesystem を選択します。
+- Linux FUSE、または macFUSE を使用した macOS と明示的な `--driver fuse` を使用します。Git ワークスペースは、リモート Git ツリーとワークスペースの変更をマウントパスに統合するために FUSE に依存します。WebDAV マウントではこの統合は提供されません。
+- Git をインストールし、リポジトリ認証を設定します。
+
+## ステップ 1. ワークスペースをマウントする {#step-1-mount-a-workspace}
+
+```bash
+mkdir -p /path/to/workspace
+ti fs mount-file-system \
+ --mount-path /path/to/workspace \
+ --driver fuse \
+ --mount-profile coding-agent
+```
+
+## ステップ 2. ワークスペースを作成し、バックグラウンドで hydrate する {#step-2-create-the-workspace-and-hydrate-in-the-background}
+
+```bash
+ti fs-git clone-git-workspace \
+ --repo-url https://github.com/pingcap/tidb.git \
+ --target-path /path/to/workspace/tidb \
+ --blobless \
+ --hydrate background
+```
+
+これでワークスペースツリーが利用可能になり、hydration はバックグラウンドで継続します。エージェントには通常のコマンドで作業を開始させます。
+
+```bash
+find /path/to/workspace/tidb -maxdepth 2 -type f | head
+git -C /path/to/workspace/tidb status
+```
+
+決定的なベンチマークを実行する前、またはマウントを drain する前に、必要に応じて明示的に hydration の完了を待機できます。
+
+```bash
+ti fs-git hydrate-git-workspace \
+ --target-path /path/to/workspace/tidb \
+ --timeout 30m
+```
+
+## ステップ 3. エージェント worktree を作成する {#step-3-create-an-agent-worktree}
+
+```bash
+ti fs-git add-git-worktree \
+ --base-path /path/to/workspace/tidb \
+ --worktree-path /path/to/workspace/tidb-agent-task \
+ --branch-name agent-task
+```
+
+これでエージェントは通常のツールを使用できます。
+
+```bash
+git -C /path/to/workspace/tidb-agent-task status
+```
+
+worktree を削除する前に、必要な変更を commit または push してください。
+
+## クリーンアップ {#cleanup}
+
+```bash
+ti fs-git remove-git-worktree \
+ --worktree-path /path/to/workspace/tidb-agent-task
+
+ti fs unmount-file-system --mount-path /path/to/workspace
+```
+
+未コミットの変更を破棄してよい場合にのみ、worktree の削除で `--force` を使用してください。Filesystem のアンマウントでは自動的にグレースフルな drain が実行されます。アンマウントせずにリモート作業をフラッシュする必要がある場合にのみ、`ti fs drain-file-system` を個別に使用してください。
+
+## セキュリティおよび運用上の注意 {#security-and-operational-notes}
+
+- リポジトリ認証情報は `ti` ではなく Git によって管理されます。
+- `coding-agent` マウントプロファイルは、パフォーマンスのために Git メタデータ、依存関係ディレクトリ、キャッシュ、ビルド出力、およびその他の生成ファイルをローカルマシン上に保持します。
+- `coding-agent` プロファイルによってローカルに保持されるファイルは、一時的なマシンとともに消えます。必要な Git の変更は commit または push し、再構築できないその他のローカルファイルを保持するには、明示的な `--path` 値を指定して [`pack-file-system`](/ai/ti/reference/ti-fs-pack-file-system.md) を使用してください。
+
+## 次のステップ {#what-s-next}
+
+- [TiDB Cloud Filesystem Git CLI コマンドリファレンス](/ai/ti/reference/ti-filesystem-git.md)
+- [TiDB Cloud Filesystem CLI コマンドリファレンス](/ai/ti/reference/ti-filesystem.md)
diff --git a/ai/ti/guides/ti-journal-agent-workflow-example.md b/ai/ti/guides/ti-journal-agent-workflow-example.md
new file mode 100644
index 0000000000000..3fce3ad3cfd8d
--- /dev/null
+++ b/ai/ti/guides/ti-journal-agent-workflow-example.md
@@ -0,0 +1,96 @@
+---
+title: TiDB Cloud Filesystem Journal にエージェントワークフローを記録する
+summary: ジャーナルを作成し、構造化されたエージェントイベントを追記し、ワークフローを検索し、ジャーナルのハッシュチェーンを検証します。
+---
+
+# TiDB Cloud Filesystem Journal にエージェントワークフローを記録する
+
+このワークフローでは、計画、ツール呼び出し、テスト、リトライ、ハンドオフを、構造化され、順序付けられ、検証可能なイベント履歴として記録します。これは、オペレーターが最新の状態だけを示す変更可能なステータスファイルや、散在したコンソール出力に頼るのではなく、複数のワーカーにまたがって何が起きたかを再構築する必要がある場合に使用します。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェースは、予告なく変更される場合があります。
+
+## 仕組み {#how-it-works}
+
+Filesystem ジャーナルは、シーケンス情報、検索可能なフィールド、オプションの冪等性キー、ハッシュチェーン検証を備えた、構造化された追記専用エントリを保存します。通常のテキストファイルとは異なり、ジャーナルエントリは書き込まれた後に編集や切り詰めができず、プロデューサー側で独自のパース、並行処理、またはリトライ重複排除の仕組みを実装する必要もありません。エージェントは `task.started` や `test.finished` のような意味的イベントを追記し、オペレーターはワークフローをクエリして保存されたチェーンを検証できます。
+
+## 前提条件 {#prerequisites}
+
+設定済みのプロファイルまたは FS トークン環境を通じて Filesystem を選択します。
+
+## ステップ 1. ジャーナルを作成する {#step-1-create-the-journal}
+
+```bash
+ti fs-journal create-journal \
+ --journal-id jrn-agent-demo \
+ --journal-kind agent \
+ --title "dependency update" \
+ --actor agent:dependency-bot \
+ --label repository=demo \
+ --label environment=test
+```
+
+## ステップ 2. ワークフローイベントを追記する {#step-2-append-workflow-events}
+
+```bash
+ti fs-journal append-journal-entries \
+ --journal-id jrn-agent-demo \
+ --idempotency-key dependency-update-start \
+ --entry-json '{"type":"task.started","status":"running"}'
+
+ti fs-journal append-journal-entries \
+ --journal-id jrn-agent-demo \
+ --entry-json '{"type":"test.finished","status":"passed","suite":"unit"}' \
+ --entry-json '{"type":"task.finished","status":"completed"}'
+```
+
+ワークフローが同じ追記をリトライする可能性がある場合は、冪等性キーを指定し、その論理操作のすべてのリトライで同じキーを再利用します。これにより、サービスは重複エントリの保存を回避します。このオプションを省略すると新しいキーが生成され、リトライする予定のない追記にはそれが適切です。
+
+## ステップ 3. 読み取りと検索 {#step-3-read-and-search}
+
+```bash
+ti fs-journal read-journal-entries \
+ --journal-id jrn-agent-demo \
+ --after-seq 0 \
+ --limit 100 \
+ --output text
+
+ti fs-journal search-journal-entries \
+ --entry-type task.finished \
+ --status completed \
+ --label repository=demo \
+ --include-entries
+```
+
+`jrn-agent-demo` に対する順序付きの `read-journal-entries` の結果には、開始、テスト、完了の各イベントが含まれているはずです。
+
+> **Note:**
+>
+> `search-journal-entries` はジャーナル ID を受け付けないため、選択した Filesystem 内のすべてのジャーナルを検索します。この例では、同じラベルとイベントフィールドを持つ別のジャーナルも検索結果に一致する可能性があります。
+
+`--entry-type` と `--status` のフィルターは、各 `--entry-json` オブジェクト内の `type` フィールドと `status` フィールドに一致します。この例では、ペイロードに `"type":"task.finished"` と `"status":"completed"` を含むエントリを選択します。
+
+## ステップ 4. 整合性を検証する {#step-4-verify-integrity}
+
+```bash
+ti fs-journal verify-journal \
+ --journal-id jrn-agent-demo \
+ --output text
+```
+
+結果が成功であれば、保存されたシーケンスとハッシュチェーンに整合性があることを確認できます。
+
+## クリーンアップ {#cleanup}
+
+ジャーナルは追記専用であり、現在の公開 `ti` コマンドには削除コマンドがありません。使い捨てジャーナルを作成する実験では、専用のテスト Filesystem と、`jrn-test-` のような一意のジャーナル ID を使用してください。含まれているファイルやジャーナルがすべて不要になった場合にのみ、その Filesystem を削除してください。
+
+## セキュリティおよび運用上の注意 {#security-and-operational-notes}
+
+- API キー、パスワード、秘密情報を含む SQL テキスト、または生のファイル内容をジャーナルのペイロードに入れないでください。
+- ハッシュチェーン検証は保存済みチェーンの不整合を検出しますが、元のイベントが真実であったことまでは証明しません。
+
+## 次のステップ {#what-s-next}
+
+- [TiDB Cloud Filesystem Journal CLI コマンドリファレンス](/ai/ti/reference/ti-filesystem-journal.md)
+- [シークレットをエージェントに委任する](/ai/ti/guides/ti-vault-agent-secrets-example.md)
diff --git a/ai/ti/guides/ti-parallel-agent-dataset-example.md b/ai/ti/guides/ti-parallel-agent-dataset-example.md
new file mode 100644
index 0000000000000..10d5eed7ff5c2
--- /dev/null
+++ b/ai/ti/guides/ti-parallel-agent-dataset-example.md
@@ -0,0 +1,102 @@
+---
+title: TiDB Cloud Filesystem を使用して並列エージェント間で読み取り専用データセットを共有する
+summary: 1 つの非構造化データセットをアップロードし、同じ読み取り専用でマウントされた名前空間を複数のエージェントワーカーに公開します。
+---
+
+# TiDB Cloud Filesystem を使用して並列エージェント間で読み取り専用データセットを共有する
+
+このワークフローでは、複数の短命なワーカーに対して、各サンドボックスへ個別のコピーをダウンロードすることなく、1 つの共有コーパスを提供できます。並列のドキュメント処理エージェントや評価エージェントが、同じ PDF、画像、ログ、またはモデルアーティファクトに一貫してアクセスする必要がある場合に使用します。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェースは、予告なく変更される場合があります。
+
+## 仕組み {#how-it-works}
+
+所有者はコーパスを 1 回アップロードし、各ワーカー用にスコープ付きの読み取り専用 Filesystem トークンを作成します。各ワーカーは同じ Filesystem を選択し、コーパスを読み取り専用でマウントするため、通常のツールでストレージ SDK を使わずに 1 つの共通名前空間をたどることができます。これにより起動時間が短縮され、独立した特定時点のコピーを作成する必要がなくなります。ワーカーが結果を生成する場合は、データセット Filesystem ではなく、別の書き込み可能な出力 Filesystem 内の個別パスに書き込みます。
+
+## 前提条件 {#prerequisites}
+
+- 信頼できるマシンに TiDB Cloud CLI をインストールして設定します。
+- 各ワーカーに TiDB Cloud CLI と必要なマウント依存関係をインストールします。
+- 信頼できるマシンに `jq` をインストールします。
+- トークン転送には、安全なシークレットマネージャーまたは暗号化されたワーカー入力を使用します。
+
+## ステップ 1. コーパスをアップロードする {#step-1-upload-the-corpus}
+
+信頼できるマシンで次を実行します。
+
+```bash
+umask 077
+ti fs create-file-system --wait > ./filesystem.json
+export TI_FS_FILE_SYSTEM_ID="$(jq -r '.file_system_id' ./filesystem.json)"
+export TI_FS_TOKEN="$(jq -r '.fs_token' ./filesystem.json)"
+
+ti fs copy-file \
+ --from-local ./corpus \
+ --to-remote /datasets/corpus \
+ --recursive
+
+ti fs find-files \
+ --path /datasets/corpus \
+ --file-name-pattern "*.pdf" \
+ --output text
+
+# Create one short-lived, read-only scoped token per worker.
+ti fs generate-file-system-scoped-token \
+ --file-system-id "$TI_FS_FILE_SYSTEM_ID" \
+ --subject worker-1 \
+ --ttl 24h \
+ --allow /datasets/corpus:read,list > ./worker-1-token.json
+```
+
+シークレットマネージャーを通じて、`worker-1-token.json` の `fs_token` と Filesystem のリージョンコードを転送します。各ワーカーに対して一意のサブジェクトを指定して、トークン生成コマンドを繰り返します。所有者トークンは信頼できるマシン上にのみ保持し、トークンを安全に保存した後は JSON ファイルを削除してください。
+
+## ステップ 2. 各ワーカーでマウントする {#step-2-mount-in-each-worker}
+
+> **Warning:**
+>
+> 各ワーカーには、コーパスパス配下で `read` と `list` のみを許可するスコープ付きトークンを付与してください。`--read-only` マウントオプションは、マウント経由の意図しない書き込みを防ぎますが、トークンの権限自体を変更するものではありません。
+
+ワーカーのスコープ付きトークンを `TI_FS_TOKEN` として注入し、`TI_REGION_CODE` を Filesystem のリージョンに設定してから、次を実行します。
+
+```bash
+mkdir -p "$HOME/corpus"
+ti fs mount-file-system \
+ --mount-path "$HOME/corpus" \
+ --remote-path /datasets/corpus \
+ --read-only
+```
+
+ワーカーはストレージ SDK を使わずに標準ツールを使用できます。
+
+```bash
+find "$HOME/corpus" -type f -name '*.pdf' -print
+```
+
+## クリーンアップ {#cleanup}
+
+終了する前に、各ワーカーで Filesystem をアンマウントします。
+
+```bash
+ti fs unmount-file-system --mount-path "$HOME/corpus"
+```
+
+すべてのワーカーが Filesystem をアンマウントした後、データセットが不要であれば、信頼できるマシンからそれを削除します。
+
+```bash
+rm -f ./filesystem.json ./worker-*-token.json
+ti fs delete-file-system --file-system-id "$TI_FS_FILE_SYSTEM_ID"
+```
+
+## セキュリティおよび運用上の注意 {#security-and-operational-notes}
+
+- 所有者トークンをワーカーに配布しないでください。各ワーカーごとに個別の短命なスコープ付きトークンを生成し、読み取り専用アクセスが認証情報によって強制されるようにします。
+- ワーカーが同じ出力 Filesystem に書き込む場合は、エージェントまたは実行 ID ごとに結果パスを分割してください。
+- FUSE または WebDAV マウントを利用できないプラットフォームでは、`read-file`、`find-files`、および `copy-file --to-local` を直接使用してください。
+
+## 次のステップ {#what-s-next}
+
+- [TiDB Cloud Filesystem CLI コマンドリファレンス](/ai/ti/reference/ti-filesystem.md)
+- [エージェントサンドボックスで Filesystem を使用する](/ai/ti/guides/ti-agent-sandbox-example.md)
+- [TiDB Cloud CLI のリージョン、セキュリティ、および制限事項](/ai/ti/reference/ti-regions-security-and-limitations.md)
\ No newline at end of file
diff --git a/ai/ti/guides/ti-persistent-agent-state-example.md b/ai/ti/guides/ti-persistent-agent-state-example.md
new file mode 100644
index 0000000000000..df383e5675472
--- /dev/null
+++ b/ai/ti/guides/ti-persistent-agent-state-example.md
@@ -0,0 +1,98 @@
+---
+title: TiDB Cloud Filesystem を使用して使い捨てサンドボックス間でエージェントの状態を永続化する
+summary: エージェントのサンドボックスを置き換える際に、TiDB Cloud Filesystem 内でプラン、チェックポイント、出力、ワークフロー履歴を保持します。
+---
+
+# TiDB Cloud Filesystem を使用して使い捨てサンドボックス間でエージェントの状態を永続化する
+
+このワークフローでは、エージェントの計算環境を使い捨てのままにしつつ、プラン、中間結果、診断ファイル、ワークフロー履歴を TiDB Cloud Filesystem に保持します。置き換え用のサンドボックスは、ローカルディスクを保持するためだけに以前のサンドボックスを稼働させ続けることなく、タスクを再開できます。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェースは、予告なく変更される場合があります。
+
+## 仕組み {#how-it-works}
+
+信頼できるマシンが 1 つの Filesystem をプロビジョニングします。各サンドボックスには、Filesystem トークンとリージョンコードのみが渡されます。トークンは Filesystem を識別するため、エージェントは TiDB Cloud のコントロールプレーンキーを受け取ることなく、リモート名前空間に永続的なタスク状態を書き込み、ジャーナルにワークフロー遷移を記録できます。
+
+## 前提条件 {#prerequisites}
+
+- 信頼できるマシンに TiDB Cloud CLI をインストールして設定します。
+- 各サンドボックスに TiDB Cloud CLI をインストールします。
+- 信頼できるマシンに `jq` をインストールします。
+- トークン転送には、安全なシークレットマネージャーまたは暗号化されたサンドボックス入力を使用します。
+
+## ステップ 1. 状態保存用 Filesystem をプロビジョニングする {#step-1-provision-the-state-filesystem}
+
+信頼できるマシンで、次を実行します。
+
+```bash
+umask 077
+ti fs create-file-system --wait > ./filesystem.json
+export FILE_SYSTEM_ID="$(jq -r '.file_system_id' ./filesystem.json)"
+export TI_FS_TOKEN="$(jq -r '.fs_token' ./filesystem.json)"
+```
+
+`TI_FS_TOKEN` はシークレットマネージャーに保存し、クリーンアップ用に `FILE_SYSTEM_ID` を記録し、設定されたリージョンコードも記録します。これらの値を安全に保存した後、`filesystem.json` を削除します。
+
+## ステップ 2. 最初のサンドボックスを起動する {#step-2-start-the-first-sandbox}
+
+次の環境変数を注入します。
+
+```bash
+export TI_FS_TOKEN=""
+export TI_REGION_CODE=""
+```
+
+プランを書き込み、ワークフロージャーナルを作成します。
+
+```bash
+printf '%s\n' '# Plan' '1. inspect' '2. change' '3. verify' \
+ | ti fs copy-file --from-stdin --to-remote /tasks/task-42/plan.md
+
+ti fs-journal create-journal \
+ --journal-id task-42 \
+ --journal-kind agent \
+ --title "task 42" \
+ --actor agent:worker-1
+
+ti fs-journal append-journal-entries \
+ --journal-id task-42 \
+ --entry-json '{"type":"task.checkpoint","step":"inspection-complete"}'
+```
+
+`agent` ジャーナル種別は、このジャーナルをエージェントワークフローとして分類します。また、`--journal-kind` を省略した場合のデフォルト値でもあります。別のワークフロー分類が必要な場合、このオプションにはカスタム文字列を指定できます。
+
+## ステップ 3. 置き換え用サンドボックスで再開する {#step-3-resume-in-a-replacement-sandbox}
+
+同じ 2 つの FS 変数を新しいサンドボックスに注入し、永続状態を復元します。
+
+```bash
+ti fs read-file --path /tasks/task-42/plan.md
+ti fs-journal read-journal-entries --journal-id task-42 --after-seq 0
+```
+
+同じタスクパス配下に結果を書き続けます。並列エージェント同士が互いのファイルを上書きしないよう、一意のタスク ID を使用してください。
+
+## クリーンアップ {#cleanup}
+
+サンドボックスが Filesystem の使用を停止したら、信頼できるマシンからそれを削除します。
+
+```bash
+rm -f ./filesystem.json
+ti fs delete-file-system --file-system-id "$FILE_SYSTEM_ID"
+```
+
+Filesystem を削除すると、そのタスクファイルとジャーナルも削除されます。
+
+## セキュリティおよび運用上の注意 {#security-and-operational-notes}
+
+- FS トークンは所有者資格情報です。実行時のシークレットストアに保持し、イメージやタスクプロンプトには含めないでください。
+- 完了した直接データプレーン書き込みは、リモートから参照可能になります。マウントされた FUSE 書き込みについては、サンドボックスを削除する前に正常にアンマウントしてください。
+- ジャーナルは順序付けられたワークフローの証跡を保持し、タスクファイルは変更可能な作業状態を保持します。状態と履歴の両方が必要な場合は、両方を使用してください。
+
+## 次のステップ {#what-s-next}
+
+- [TiDB Cloud Filesystem CLI コマンドリファレンス](/ai/ti/reference/ti-filesystem.md)
+- [TiDB Cloud Filesystem Journal CLI コマンドリファレンス](/ai/ti/reference/ti-filesystem-journal.md)
+- [TiDB Cloud CLI の設定と認証情報](/ai/ti/reference/ti-configuration-and-credentials.md)
\ No newline at end of file
diff --git a/ai/ti/guides/ti-query-sql-with-roles-example.md b/ai/ti/guides/ti-query-sql-with-roles-example.md
new file mode 100644
index 0000000000000..02cf6ff1d650f
--- /dev/null
+++ b/ai/ti/guides/ti-query-sql-with-roles-example.md
@@ -0,0 +1,115 @@
+---
+title: 明示的な SQL ロールで TiDB Cloud Starter をクエリする
+summary: TiDB Cloud CLI で管理される SQL ユーザーを準備し、明示的な権限の意図に基づいて読み取り専用、読み書き、管理者ステートメントを実行します。
+---
+
+# 明示的な SQL ロールで TiDB Cloud Starter をクエリする
+
+このワークフローでは、3 つの SQL ロールを一度だけ準備し、その後は各ステートメントに対して最小権限のロールを明示的に選択します。各コマンドでデータベースパスワードを扱うことなく、対話的または自動化されたスキーマ操作、データ操作、検証作業に利用できます。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェイスは、予告なく変更される場合があります。
+
+## 仕組み {#how-it-works}
+
+従来のデータベース接続では、1 つの認証情報を使用し、その認証情報の権限がセッション中維持されます。これに対して、`ti db create-db-sql-users` は 3 つの固定 ID を作成し、それらの認証情報をローカルに保存します。`execute-sql-statement` を呼び出すたびに 1 つの ID を選択して 1 つのステートメントを実行するため、確認ステップで書き込み権限や管理者権限を保持し続ける必要がありません。
+
+| ロール | 用途 |
+| --- | --- |
+| `admin` | スキーマ変更と権限管理 |
+| `read-write` | アプリケーションデータの変更 |
+| `read-only` | クエリと検証 |
+
+## 前提条件 {#prerequisites}
+
+- `ti` を設定します。
+- アクティブな TiDB Cloud Starter インスタンス ID を選択します。
+
+## ステップ 1. SQL ユーザーを準備する {#step-1-prepare-sql-users}
+
+```bash
+ti db create-db-sql-users \
+ --db-cluster-id ""
+```
+
+このコマンドは冪等であり、`read_only`、`read_write`、`admin` の認証情報を作成または修復します。
+
+## ステップ 2. スキーマ変更には admin を使用する {#step-2-use-admin-for-schema-changes}
+
+```bash
+ti db execute-sql-statement \
+ --db-cluster-id "" \
+ --admin \
+ --sql "CREATE DATABASE IF NOT EXISTS role_demo"
+
+ti db execute-sql-statement \
+ --db-cluster-id "" \
+ --admin \
+ --database role_demo \
+ --sql "CREATE TABLE IF NOT EXISTS messages (id BIGINT PRIMARY KEY, body VARCHAR(255))"
+```
+
+## ステップ 3. データ変更には read-write を使用する {#step-3-use-read-write-for-data-changes}
+
+```bash
+ti db execute-sql-statement \
+ --db-cluster-id "" \
+ --read-write \
+ --database role_demo \
+ --sql "INSERT INTO messages(id, body) VALUES (1, 'hello') ON DUPLICATE KEY UPDATE body = VALUES(body)"
+```
+
+## ステップ 4. 検証には read-only を使用する {#step-4-use-read-only-for-verification}
+
+```bash
+ti db execute-sql-statement \
+ --db-cluster-id "" \
+ --read-only \
+ --database role_demo \
+ --sql "SELECT id, body FROM messages ORDER BY id" \
+ --output text
+```
+
+期待される結果には、ID `1` と body `hello` が含まれます。
+
+## ステップ 5. 接続環境を整形する {#step-5-format-a-connection-environment}
+
+表示する代わりに、出力を保護されたローカルファイルへ直接書き込みます。
+
+```bash
+umask 077
+ti db format-db-connection-string \
+ --db-cluster-id "" \
+ --read-only \
+ --database role_demo \
+ --format env \
+ --env-include-database-url > .env.tidb
+```
+
+`.env.tidb` をコミットしないでください。
+
+`--format env` を使用すると、このコマンドは `TIDB_HOST`、`TIDB_USER`、`TIDB_PASSWORD` などの個別の `TIDB_` 接続変数を書き出します。`--env-include-database-url` オプションを指定すると、単一の MySQL 接続 URL を受け付けるアプリケーション向けに `DATABASE_URL` の値も追加されます。
+
+## クリーンアップ {#cleanup}
+
+```bash
+ti db execute-sql-statement \
+ --db-cluster-id "" \
+ --admin \
+ --sql "DROP DATABASE role_demo"
+
+rm -f .env.tidb
+```
+
+## セキュリティに関する注意 {#security-notes}
+
+- 各ステートメントでは、最小権限の明示的なロールを使用してください。
+- `ti` は 1 回の呼び出しにつき 1 つの SQL ステートメントを受け付けます。
+- HTTPS はデフォルトの SQL 実行トランスポートです。代わりに直接 TLS MySQL 接続を開くには、`--transport mysql` を指定してください。CLI が自動的にトランスポートを切り替えることはありません。
+- 接続文字列および環境変数の出力には認証情報が含まれます。
+
+## 次のステップ {#what-s-next}
+
+- [TiDB Cloud Starter CLI コマンドリファレンス](/ai/ti/reference/ti-starter-database.md)
+- [TiDB Cloud CLI の設定と認証情報](/ai/ti/reference/ti-configuration-and-credentials.md)
\ No newline at end of file
diff --git a/ai/ti/guides/ti-share-filesystem-across-machines-example.md b/ai/ti/guides/ti-share-filesystem-across-machines-example.md
new file mode 100644
index 0000000000000..fd111e82567ec
--- /dev/null
+++ b/ai/ti/guides/ti-share-filesystem-across-machines-example.md
@@ -0,0 +1,118 @@
+---
+title: 複数マシン間で TiDB Cloud Filesystem を共有する
+summary: 1 つの Filesystem を作成し、2 台目のマシンから安全にアクセスして、データプレーンとマウントの可視性を確認します。
+---
+
+# 複数マシン間で TiDB Cloud Filesystem を共有する
+
+このワークフローでは、2 台のマシン上のユーザー、自動化処理、またはエージェントに対して、1 つの共有ワークスペースを提供します。`scp` やアーカイブのアップロードによる特定時点のコピーをやり取りすることなく、変更内容を両方のマシンから見える状態に保つ必要がある場合に使用します。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェースは、予告なく変更される場合があります。
+
+## 仕組み {#how-it-works}
+
+マシン A が Filesystem を作成し、マシン B 用に別個のオーナートークンを生成します。その後、両方のマシンはデータプレーンコマンドまたはマウントされたディレクトリを通じて同じリモート名前空間にアクセスするため、書き込みはフラッシュ後にどちらのインターフェースからも見えるようになります。これにより、手動でのスナップショット同期やオブジェクトストレージ固有の転送ロジックなしで、共有ディレクトリのような動作を実現できます。
+
+| 参加者 | 認証情報 | ワークフローでの役割 |
+| --- | --- | --- |
+| Machine A | 設定済みの `ti` プロファイルとその FS オーナートークン | Filesystem を作成および管理し、初期データを書き込み、マシン B 用のトークンを生成する |
+| Machine B | 自身の FS オーナートークンと Filesystem のリージョンコード | TiDB Cloud API キーやコピーしたプロファイルなしで Filesystem にアクセスする |
+| TiDB Cloud Filesystem | 該当なし | 両方のマシンが使用する共有リモート名前空間を提供する |
+
+マシンごとに別のトークンを使用すると、マシン A を中断することなくマシン B のアクセスを取り消せます。両方のトークンはオーナーアクセスを付与するため、シークレットとして転送および保管してください。
+
+## 前提条件 {#prerequisites}
+
+- マシン A で `ti` が設定済みであること。
+- 両方のマシンに `ti` がインストールされていること。
+- マシン A に `jq` がインストールされていること。
+- 安全なシークレット転送チャネルがあること。
+
+## Step 1. マシン A で Filesystem を作成する {#step-1-create-the-filesystem-on-machine-a}
+
+```bash
+umask 077
+ti fs create-file-system --wait > ./filesystem.json
+export FILE_SYSTEM_ID="$(jq -r '.file_system_id' ./filesystem.json)"
+export TI_FS_TOKEN="$(jq -r '.fs_token' ./filesystem.json)"
+
+ti fs generate-file-system-token \
+ --file-system-id "$FILE_SYSTEM_ID" \
+ --token-name machine-b \
+ --ttl 720h > ./machine-b-token.json
+
+printf 'from machine A\n' | ti fs copy-file \
+ --from-stdin \
+ --to-remote /shared/origin.txt
+```
+
+`machine-b-token.json` の `fs_token` はシークレットマネージャーを通じて転送し、正規のリージョンコードを伝えてください。コントロールプレーン操作のために `FILE_SYSTEM_ID` はマシン A に保持し、トークンを安全に保管した後は両方の JSON ファイルを削除してください。
+
+## Step 2. マシン B をメモリ内で設定する {#step-2-configure-machine-b-in-memory}
+
+```bash
+export TI_FS_TOKEN=""
+export TI_REGION_CODE=""
+```
+
+`TI_REGION_CODE` には、Filesystem を作成したリージョンを設定します。`ti configure` は不要です。
+
+## Step 3. マシン B で直接可視性を確認する {#step-3-verify-direct-visibility-on-machine-b}
+
+```bash
+ti fs read-file --path /shared/origin.txt
+printf 'from machine B\n' | ti fs copy-file --from-stdin --to-remote /shared/second.txt
+```
+
+## Step 4. マウントとデータプレーンの可視性を確認する {#step-4-verify-mount-and-data-plane-visibility}
+
+```bash
+mkdir -p /path/to/shared-workspace
+ti fs mount-file-system \
+ --mount-path /path/to/shared-workspace
+
+cat /path/to/shared-workspace/shared/origin.txt
+printf 'written through mount\n' > /path/to/shared-workspace/shared/mounted.txt
+
+# Graceful unmount flushes pending writes before the data-plane read.
+ti fs unmount-file-system --mount-path /path/to/shared-workspace
+ti fs read-file --path /shared/mounted.txt
+```
+
+最初の読み取りにより、データプレーン経由の書き込みがマウント経由で見えることを確認できます。最後の読み取りにより、マウント経由の書き込みがフラッシュ後にデータプレーンから見えることを確認できます。
+
+## クリーンアップ {#cleanup}
+
+### マシン B での作業 {#on-machine-b}
+
+Step 4 の graceful アンマウント後、現在のシェルから認証情報を削除します。
+
+```bash
+unset TI_FS_TOKEN TI_REGION_CODE
+```
+
+### マシン A での作業 {#on-machine-a}
+
+```bash
+rm -f ./filesystem.json ./machine-b-token.json
+
+ti fs list-file-system-tokens --file-system-id "$FILE_SYSTEM_ID" --output text
+ti fs delete-file-system-token \
+ --file-system-id "$FILE_SYSTEM_ID" \
+ --token-id ""
+ti fs delete-file-system \
+ --file-system-id "$FILE_SYSTEM_ID"
+```
+
+## セキュリティに関する注意事項 {#security-notes}
+
+- 各 FS トークンはオーナーアクセスを付与します。チャットやコマンド履歴ではなく、シークレットとして転送し、マシンごとに別のトークンを使用してください。
+- 複数のライターが同じパスを上書きする可能性があるため、ワークフローレベルで所有権を調整してください。
+- graceful アンマウントが完了する前にマシンを終了しないでください。FUSE マウントをオンラインのまま維持しつつリモート永続性が必要な場合にのみ、明示的な drain を使用してください。
+
+## 次のステップ {#what-s-next}
+
+- [TiDB Cloud Filesystem CLI コマンドリファレンス](/ai/ti/reference/ti-filesystem.md)
+- [Agent Sandbox で Filesystem を使用する](/ai/ti/guides/ti-agent-sandbox-example.md)
diff --git a/ai/ti/guides/ti-vault-agent-secrets-example.md b/ai/ti/guides/ti-vault-agent-secrets-example.md
new file mode 100644
index 0000000000000..07be0f180a882
--- /dev/null
+++ b/ai/ti/guides/ti-vault-agent-secrets-example.md
@@ -0,0 +1,111 @@
+---
+title: エージェントに TiDB Cloud Filesystem Vault シークレットを委任する
+summary: シークレットを保存し、1 つのフィールドへのアクセス権をエージェントに付与し、プロセスに注入し、アクセスを監査し、付与を取り消します。
+---
+
+# エージェントに TiDB Cloud Filesystem Vault シークレットを委任する
+
+このワークフローでは、Filesystem オーナートークンや完全なシークレットを共有することなく、エージェントに 1 つのシークレットフィールドへの一時的なアクセス権を付与できます。エージェントが 1 つのタスクのために認証情報を必要とする一方で、その値をプロンプト、`.env` ファイル、またはサンドボックスイメージに保持すべきでない場合に使用します。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェースは、予告なく変更される場合があります。
+
+## 仕組み {#how-it-works}
+
+Filesystem オーナーはシークレットを一度だけ保存し、必要なフィールドにスコープを限定した短期間有効な grant を作成します。エージェントは委任された vault トークンのみを受け取り、許可された値を子プロセスに注入できます。オーナーは監査イベントを確認し、Filesystem オーナー認証情報をローテーションしたり公開したりすることなく grant を取り消せます。
+
+## このアプローチを使う理由 {#why-use-this-approach}
+
+通常の環境変数やファイルでもシークレットを渡すことはできますが、スコープが限定され有効期限付きの委任や、アクセス監査証跡は作成できません。Filesystem オーナートークンを共有すると、1 つのシークレットフィールドに必要な範囲を超える広いアクセス権も付与されます。別のクラウドシークレットマネージャーでも同様の制御は可能ですが、各サンドボックスごとに別の ID、ポリシー、統合経路が必要になります。
+
+## 前提条件 {#prerequisites}
+
+- オーナーアクセス権のある Filesystem を選択します。
+- `jq` をインストールします。
+- 元のシークレット値を保護されたファイルに保存します。
+
+## ステップ 1. シークレットを作成する {#step-1-create-a-secret}
+
+```bash
+ti fs-vault create-secret \
+ --secret-name service-demo \
+ --field ENDPOINT=https://service.example \
+ --field API_TOKEN=@./api-token.txt
+```
+
+## ステップ 2. 最小権限の grant を作成する {#step-2-create-a-narrow-grant}
+
+```bash
+umask 077
+set -o noclobber
+ti fs-vault create-grant \
+ --agent-id example-agent \
+ --scope service-demo/ENDPOINT \
+ --permission read \
+ --ttl 10m \
+ --label-hint example > ./vault-grant.json
+set +o noclobber
+
+export TI_VAULT_TOKEN="$(jq -r '.token' ./vault-grant.json)"
+export GRANT_ID="$(jq -r '.grant_id' ./vault-grant.json)"
+```
+
+この保護されたファイルには、トークンを表示せずに 2 つのワンタイム値の両方が保存されます。トークンはシークレットマネージャーに保存し、grant を取り消せるように `GRANT_ID` は保持してください。
+
+## ステップ 3. 委任されたフィールドを使用する {#step-3-use-the-delegated-field}
+
+```bash
+ti fs-vault read-secret \
+ --secret-name service-demo \
+ --field ENDPOINT \
+ --format raw
+```
+
+許可されたフィールドをコマンドに注入します。
+
+```bash
+ti fs-vault run-with-secret \
+ --secret-path /n/vault/service-demo \
+ -- sh -c 'test -n "$ENDPOINT"'
+```
+
+`/n/vault/` プレフィックスは、完全なシークレットパスを受け付けるコマンドに対して Vault 名前空間を識別します。`service-demo` はステップ 1 で作成したシークレットを指します。`run-with-secret` は許可されたフィールドを読み取り、それらを子プロセス内の環境変数として設定し、その後 `--` の後ろのコマンドを実行します。このテストは、値を表示せずに `ENDPOINT` が存在する場合に正常終了します。すべての環境変数の値を表示するコマンドは使用しないでください。
+
+## ステップ 4. 監査して取り消す {#step-4-audit-and-revoke}
+
+```bash
+ti fs-vault list-audit-events \
+ --secret-name service-demo \
+ --agent-id example-agent \
+ --limit 20
+
+ti fs-vault delete-grant \
+ --grant-id "$GRANT_ID" \
+ --revoked-by operator \
+ --reason task-complete
+```
+
+ローカルトークンを unset します。
+
+```bash
+unset TI_VAULT_TOKEN
+```
+
+## クリーンアップ {#cleanup}
+
+```bash
+ti fs-vault delete-secret --secret-name service-demo
+rm -f ./api-token.txt ./vault-grant.json
+```
+
+## セキュリティおよび運用上の注意 {#security-and-operational-notes}
+
+- grant のスコープは、必要最小限のフィールドセットと、実用上最短の TTL に限定してください。
+- 取り消されたトークンは新しい読み取りを認可できませんが、プロセスがすでに読み取った値を消去することはできません。
+- プロセス一覧やシェル履歴に残る可能性があるため、シークレットをフラグで渡すことは避けてください。
+
+## 次のステップ {#what-s-next}
+
+- [TiDB Cloud Filesystem Vault CLI コマンドリファレンス](/ai/ti/reference/ti-filesystem-vault.md)
+- [TiDB Cloud CLI のリージョン、セキュリティ、および制限事項](/ai/ti/reference/ti-regions-security-and-limitations.md)
diff --git a/ai/ti/guides/use-filesystem-journals.md b/ai/ti/guides/use-filesystem-journals.md
new file mode 100644
index 0000000000000..728f1fc4d710d
--- /dev/null
+++ b/ai/ti/guides/use-filesystem-journals.md
@@ -0,0 +1,64 @@
+---
+title: TiDB Cloud Filesystem Journals を使う
+summary: Filesystem 内のエージェントおよび自動化イベント向けの追記専用ジャーナルを作成、追記、読み取り、検索、検証する方法を学びます。
+---
+
+# TiDB Cloud Filesystem Journals を使う
+
+ジャーナルは、TiDB Cloud Filesystem 上で実行されるエージェントワークフローおよび自動化パイプライン向けに、追記専用かつハッシュチェーン化されたイベントログを提供します。[`ti fs-journal` コマンド](/ai/ti/reference/ti-filesystem-journal.md)を使用して、ジャーナルの作成、順序付きイベントの追記、それらの検索または読み取り、ハッシュチェーンの検証を行います。
+
+## 前提条件 {#prerequisites}
+
+- [TiDB Cloud CLI をインストールして設定する](/ai/ti/reference/ti-install-configure-update.md)。
+- `--file-system-id` を渡す、`TI_FS_FILE_SYSTEM_ID` を設定する、または Filesystem を識別する FS トークンを指定して、Filesystem を選択します。
+- `--fs-token`、`TI_FS_TOKEN`、または選択した Filesystem 用に保存されているローカル認証情報を通じて、ジャーナル権限を持つ FS トークンを指定します。
+
+## ジャーナルを作成する {#create-a-journal}
+
+```shell
+ti fs-journal create-journal \
+ --journal-kind agent \
+ --title "review task" \
+ --actor agent:reviewer
+```
+
+返されたジャーナル ID を保存します。
+
+## エントリを追記する {#append-entries}
+
+```shell
+ti fs-journal append-journal-entries \
+ --journal-id "" \
+ --entry-json '{"type":"review_started"}'
+```
+
+サポートされる入力形式とエントリフィールドについては、[`append-journal-entries` リファレンス](/ai/ti/reference/ti-fs-journal-append-journal-entries.md)を参照してください。
+
+## エントリを読み取りおよび検索する {#read-and-search-entries}
+
+シーケンス順にエントリを読み取ります。
+
+```shell
+ti fs-journal read-journal-entries --journal-id ""
+```
+
+ジャーナルとエントリをまたいで検索します。
+
+```shell
+ti fs-journal search-journal-entries \
+ --entry-type review_started \
+ --include-entries
+```
+
+## ジャーナルを検証する {#verify-a-journal}
+
+ジャーナルのハッシュチェーンが完全であることを検証します。
+
+```shell
+ti fs-journal verify-journal --journal-id ""
+```
+
+## 次のステップ {#what-s-next}
+
+- [TiDB Cloud Filesystem Journal に Agent Workflow を記録する](/ai/ti/guides/ti-journal-agent-workflow-example.md)
+- [TiDB Cloud Filesystem Journal CLI コマンドリファレンス](/ai/ti/reference/ti-filesystem-journal.md)
diff --git a/ai/ti/guides/work-with-filesystem-data.md b/ai/ti/guides/work-with-filesystem-data.md
new file mode 100644
index 0000000000000..1ca05e9911f15
--- /dev/null
+++ b/ai/ti/guides/work-with-filesystem-data.md
@@ -0,0 +1,75 @@
+---
+title: TiDB Cloud Filesystem データを操作する
+summary: CLI を使用して、TiDB Cloud Filesystem 内のファイルやディレクトリをコピー、読み取り、整理、検索、確認する方法を学びます。
+---
+
+# TiDB Cloud Filesystem データを操作する
+
+TiDB Cloud CLI では、[`ti fs` コマンド](/ai/ti/reference/ti-filesystem.md)を使用して、ローカルストレージと TiDB Cloud Filesystem 間でデータを転送したり、リモート名前空間を管理したりできます。
+
+## 前提条件 {#prerequisites}
+
+- [TiDB Cloud CLI をインストールして設定する](/ai/ti/reference/ti-install-configure-update.md)。
+- [Filesystem を作成する](/ai/ti/guides/manage-filesystem-resources.md)か、既存の Filesystem へのアクセス権を取得します。
+- `--file-system-id` を渡す、`TI_FS_FILE_SYSTEM_ID` を設定する、または対象を識別する FS トークンを指定して、Filesystem を選択します。各操作に必要な権限を持つ FS トークンを指定してください。
+
+## データをコピーする {#copy-data}
+
+ローカルファイルをリモートパスにアップロードします。
+
+```shell
+ti fs copy-file --from-local ./report.md --to-remote /reports/report.md
+```
+
+[`copy-file`](/ai/ti/reference/ti-fs-copy-file.md) は、ダウンロード、ストリーミング、追記、再開、再帰コピーもサポートしています。
+
+## データを読み取り確認する {#read-and-inspect-data}
+
+ファイルまたはバイト範囲を標準出力に読み取ります。
+
+```shell
+ti fs read-file --path /reports/report.md --offset 0 --length 1024
+```
+
+ディレクトリを一覧表示し、1 つのパスを確認します。
+
+```shell
+ti fs list-files --path /reports --output text
+ti fs describe-file --path /reports/report.md
+```
+
+## 名前空間を整理する {#organize-the-namespace}
+
+対応するコマンドを使用して、ディレクトリを作成し、ファイルを移動し、データを削除します。
+
+```shell
+ti fs create-directory --path /reports/archive
+ti fs move-file --from-remote /draft.md --to-remote /reports/final.md
+ti fs delete-file --path /scratch --recursive
+```
+
+また、`chmod-file`、`create-symlink`、`create-hardlink` を使用して、POSIX スタイルのメタデータやリンクを管理することもできます。
+
+> **Warning:**
+>
+> `delete-file --recursive` は、対象ディレクトリとその内容を完全に削除します。コマンドを実行する前に、リモートパスを確認してください。
+
+## データを検索する {#search-for-data}
+
+パス配下のファイル内容を検索します。
+
+```shell
+ti fs search-file-content --path /reports --pattern "TODO"
+```
+
+名前、タイプ、タグ、サイズ、またはタイムスタンプでパスを検索します。
+
+```shell
+ti fs find-files --path /reports --file-name-pattern "*.md" --tag stage=review
+```
+
+## 次のステップ {#what-s-next}
+
+- [TiDB Cloud Filesystem のレイヤーとチェックポイントを管理する](/ai/ti/guides/manage-filesystem-layers.md)
+- [TiDB Cloud Filesystem をマウントする](/ai/ti/guides/mount-filesystem.md)
+- [TiDB Cloud Filesystem CLI コマンドリファレンス](/ai/ti/reference/ti-filesystem.md)
diff --git a/ai/ti/reference/ti-cli-reference.md b/ai/ti/reference/ti-cli-reference.md
new file mode 100644
index 0000000000000..3c62bdb415b33
--- /dev/null
+++ b/ai/ti/reference/ti-cli-reference.md
@@ -0,0 +1,167 @@
+---
+title: TiDB Cloud CLI (`ti`) コマンドリファレンス
+summary: TiDB Cloud CLI のコマンドグループ、構文、グローバルオプション、出力、dry-run の動作、ヘルプ形式、エラーを参照します。
+---
+
+# TiDB Cloud CLI (`ti`) コマンドリファレンス
+
+このページでは、[TiDB Cloud CLI (`ti`)](/ai/ti/ti-overview.md) コマンドに共通するコマンド構造と動作について説明します。個々のコマンドの構文とオプションについては、そのコマンドグループを選択するか、ドキュメントのナビゲーションを使用してください。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェースは、予告なく変更される場合があります。
+
+## 構文 {#syntax}
+
+```text
+ti [options] [global options]
+ti [options] [global options]
+```
+
+例:
+
+```bash
+ti configure --profile staging
+ti db list-db-clusters --db-cluster-type starter
+```
+
+`ti` 実行ファイルはロングオプションのみを受け付けます。`-p` のような 1 文字のオプションは拒否されます。
+
+生成される usage では、必須オプションを任意オプションより前に指定し、任意オプションは角括弧で囲みます。
+
+```text
+ti db describe-db-cluster
+ --db-cluster-id
+ [--output ]
+ [--view ]
+```
+
+値の型は山括弧で囲まれます。コマンドヘルプでは、各必須オプションの名前と型の後に `(required)` が付きます。
+
+```text
+--db-cluster-name (required) Starter DB cluster display name
+--wait Wait until the created cluster is active
+```
+
+## コマンドとコマンドグループ {#commands-and-command-groups}
+
+次の表を使用して、トップレベルのコマンドまたはコマンドグループのリファレンスを見つけてください。各コマンドページには、構文、オプション、例が含まれています。
+
+| コマンドまたはコマンドグループ | 目的 | リファレンス |
+| --- | --- | --- |
+| `configure` | ローカルプロファイル、API キー、デフォルトのリージョンを設定します。 | [`ti configure`](/ai/ti/reference/ti-configure.md) |
+| `update` | TiDB Cloud CLI の更新を確認してインストールします。 | [`ti update`](/ai/ti/reference/ti-update.md) |
+| `db` | TiDB Cloud Starter インスタンス、ブランチ、SQL ユーザー、接続、SQL ステートメントを管理します。 | [`ti db` コマンド](/ai/ti/reference/ti-starter-database.md) |
+| `fs` | Filesystem リソース、AI プロバイダー、トークン、データ、レイヤー、マウントを管理します。 | [`ti fs` コマンド](/ai/ti/reference/ti-filesystem.md) |
+| `fs-git` | マウントされた Filesystem 上の Git ワークスペースを管理します。 | [`ti fs-git` コマンド](/ai/ti/reference/ti-filesystem-git.md) |
+| `fs-journal` | 検証可能な Filesystem ジャーナルを管理します。 | [`ti fs-journal` コマンド](/ai/ti/reference/ti-filesystem-journal.md) |
+| `fs-vault` | Filesystem Vault シークレットと委任アクセスを管理します。 | [`ti fs-vault` コマンド](/ai/ti/reference/ti-filesystem-vault.md) |
+
+ターミナルで使用可能なコマンドを一覧表示するには、`ti help` または `ti help` を実行します。
+
+## グローバルオプション {#global-options}
+
+- `--debug`: 秘匿情報をマスクしたデバッグ出力を有効にします。
+- `--output `: 出力形式を `json` または `text` に設定します。\[default: json]
+- `--profile `: ローカルプロファイルを選択します。\[default: default]
+- `--query `: 出力をレンダリングする前に JMESPath 式を適用します。
+- `--region `: 現在のコマンドに対して、プロファイルのデフォルトリージョンコードを上書きします。例: `aws-us-east-1`
+
+コマンドページでは、`--help`、`--version`、およびすべてのコマンド固有オプションを個別に説明しています。
+
+## 出力 {#output}
+
+構造化データを返すコマンドは、デフォルトで JSON を使用します。
+
+```bash
+ti db list-db-clusters --db-cluster-type starter
+```
+
+人が読みやすい形式で表示するには、text 出力を使用します。
+
+```bash
+ti db list-db-clusters --db-cluster-type starter --output text
+```
+
+`ti fs read-file` や `ti fs copy-file --to-stdout` のような生バイト指向のコマンドは、ファイル内容を直接書き出します。
+
+## JMESPath クエリ {#jmespath-queries}
+
+`--query` は、コマンドが正常に実行された後、出力がレンダリングされる前に実行されます。
+
+```bash
+ti db list-db-clusters \
+ --db-cluster-type starter \
+ --query 'clusters[].{id:id,name:display_name,state:state}'
+```
+
+式が無効な場合は失敗し、コマンド結果が部分的な出力に置き換えられることはありません。
+
+## Dry-run {#dry-run}
+
+`--dry-run` をサポートする変更系のコントロールプレーンコマンドは、ローカルオプション、プロファイル、認証情報、リージョン、およびリクエスト形状を検証したうえで、リモート変更を行わずに実行計画を報告します。
+
+```bash
+ti db delete-db-cluster \
+ --db-cluster-id "" \
+ --dry-run
+```
+
+読み取り専用コマンドは `--dry-run` を拒否します。このオプションはグローバルなシミュレーションオプションではなく、コマンドヘルプに表示されている場合にのみ使用できます。
+
+## ヘルプ形式とバージョン形式 {#help-and-version-forms}
+
+コマンドを指定せずに `ti` を実行すると、終了コード `2` を返し、コンパクトなコマンドツリーの概要を標準エラー出力に出力します。
+
+```text
+ti [ERROR]: the following arguments are required: command
+
+The TiDB Cloud Command Line Interface is a unified tool to manage your TiDB Cloud Filesystem (FS) and Starter services.
+
+usage: ti [] [parameters]
+To see help information, you can run:
+
+ ti help
+ ti help
+ ti help
+```
+
+コマンドとオプションを表示するには、明示的なヘルプ形式を使用します。
+
+```bash
+ti help
+ti db help
+ti db create-db-cluster help
+ti --help
+ti --version
+```
+
+`help` はコマンド階層をたどるためのコマンドです。`--help` は各コマンドで使用でき、両方の形式が意図的に共存しています。`--version` オプションも各コマンドレベルで使用でき、同じ `ti` 実行ファイルのバージョンを報告します。
+
+## エラーと終了動作 {#errors-and-exit-behavior}
+
+人が読めるエラーは空行で始まり、安定したプレフィックスを使用します。
+
+```text
+ti [ERROR]:
+```
+
+エラーは標準エラー出力に書き込まれ、正常なコマンド出力は標準出力に書き込まれます。usage および設定の失敗は、リモート変更の前に非ゼロの終了コードを返します。実行時エラーおよびリモート API の失敗も非ゼロを返します。対話型設定が中断された場合は、終了コード `130` を返します。
+
+`--debug` では、秘匿情報をマスクしたリクエストおよび解決コンテキストを表示できます。API キー、FS トークン、DB パスワード、SQL テキスト、ファイル内容、接続文字列を表示してはなりません。
+
+## 関連ドキュメント {#related-documentation}
+
+設定、セキュリティ、互換性、トラブルシューティングの詳細については、次のドキュメントを参照してください。
+
+| ドキュメント | 目的 |
+| --- | --- |
+| [TiDB Cloud CLI のインストール、設定、更新](/ai/ti/reference/ti-install-configure-update.md) | リリースのインストール、プロファイルの設定、`ti` の更新とアンインストール |
+| [TiDB Cloud CLI の設定と認証情報](/ai/ti/reference/ti-configuration-and-credentials.md) | プロファイル、優先順位ルール、認証情報、ローカル状態を理解する |
+| [TiDB Cloud CLI のリージョン、セキュリティ、制限事項](/ai/ti/reference/ti-regions-security-and-limitations.md) | サポートされるリージョン、認証情報の境界、プラットフォームサポート、制限事項を確認する |
+| [`tdc` から TiDB Cloud CLI への移行](/ai/ti/reference/ti-migrate-from-tdc.md) | `tdc` v0.1.x からローカル状態と環境変数を移行する |
+| [TiDB Cloud CLI のトラブルシューティング](/ai/ti/reference/ti-troubleshooting.md) | 設定、認証、ルーティング、コマンド失敗を診断する |
+
+## リリースノート {#release-notes}
+
+TiDB Cloud CLI (`ti`) の最新の変更については、[TiDB Cloud CLI (`ti`) Release Notes](https://github.com/tidbcloud/ti-cli/releases) を参照してください。
\ No newline at end of file
diff --git a/ai/ti/reference/ti-configuration-and-credentials.md b/ai/ti/reference/ti-configuration-and-credentials.md
new file mode 100644
index 0000000000000..4828888165a34
--- /dev/null
+++ b/ai/ti/reference/ti-configuration-and-credentials.md
@@ -0,0 +1,247 @@
+---
+title: TiDB Cloud CLI の設定と認証情報
+summary: TiDB Cloud CLI のプロファイル、優先順位ルール、ローカル状態パス、Filesystem 認証情報、SQL 認証情報、マウントロケーター、および操作ログのリファレンスです。
+---
+
+# TiDB Cloud CLI の設定と認証情報
+
+`ti` は、プロダクトが所有するすべてのローカル状態を `~/.ti/` 配下に保存し、機密性のない設定と認証情報を分離します。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェースは、予告なく変更される場合があります。
+
+## 主なファイル {#main-files}
+
+```toml
+# ~/.ti/config
+[default]
+region_code = "aws-us-east-1"
+```
+
+```toml
+# ~/.ti/credentials
+[default]
+tidb_cloud_public_key = "..."
+tidb_cloud_private_key = "..."
+```
+
+認証情報ファイルは、プラットフォームが POSIX モードをサポートしている場合、所有者のみがアクセスできる権限を使用します。
+
+グローバル設定は、プロファイルおよび認証情報とは分離されています。
+
+```toml
+# ~/.ti/.preferences
+schema_version = 1
+
+[logging]
+enabled = true
+max_file_mb = 10
+max_files = 5
+
+[telemetry]
+enabled = false
+```
+
+ドットプレフィックス付きの設定ファイルは任意であり、通常のディレクトリ一覧では非表示になり、すべてのプロファイルに適用されます。新規インストール時および `ti configure` 実行時には、このファイルは作成されません。ユーザーが作成したファイルを読み取っても、その権限、コメント、書式は書き換えられません。
+
+## プロファイルの選択 {#profile-selection}
+
+プロファイル名前空間は、次の順序で選択されます。
+
+1. 明示的な `--profile`
+2. `TI_PROFILE`
+3. `default`
+
+明示的に空のプロファイルを指定することは無効です。
+
+## TiDB Cloud API 認証情報 {#tidb-cloud-api-credentials}
+
+認証情報の選択順序は次のとおりです。
+
+1. `TIDB_CLOUD_PUBLIC_KEY` と `TIDB_CLOUD_PRIVATE_KEY` のいずれかが設定されている場合は、その両方
+2. `~/.ti/credentials` の選択されたセクション
+
+2 つの環境変数は必ずセットで必要です。`ti` は、環境変数側の片方とファイル側の片方を混在させることはありません。
+
+配置先の選択順序は次のとおりです。
+
+1. 明示的なグローバル `--region`
+2. `TI_REGION_CODE`
+3. プロファイルの `region_code`
+
+コマンドフラグ、環境入力、保存済み設定、およびコマンドのデフォルト値は、フィールドごとに解決されます。そのため、API キーペアのようなアトミックな組み合わせでない限り、値は異なるレベルから取得される場合があります。
+
+## Starter プロジェクトの配置先 {#starter-project-placement}
+
+TiDB Cloud CLI は、プロジェクトセレクターを受け付けず、保存もしません。TiDB Cloud Starter インスタンスの作成ではプロジェクト配置先を省略し、TiDB Cloud がサーバー側のデフォルトプロジェクトを選択します。TiDB Cloud から返されるプロジェクトフィールドおよびラベルは、リソースメタデータとして引き続き表示されますが、後続のリクエストで再利用されることはありません。
+
+## Filesystem 認証情報とリモートインベントリ {#filesystem-credentials-and-remote-inventory}
+
+1 つのプロファイルで複数の Filesystem にアクセスできます。リージョン単位のリモートインベントリが、リソースの存在と状態に関する信頼できる情報源です。ローカル状態には、認証情報とそのルーティングヒントのみが保存されます。
+
+```text
+~/.ti/fs_credentials///credentials
+```
+
+この認証情報には、サーバーが割り当てた file system ID、正規のリージョンコード、選択された `api_key`、および任意の正式なトークンメタデータが含まれ、所有者のみがアクセスできる権限を使用します。`ti fs list-file-systems` はリモートリソースを読み取り、機密情報ではない `has_local_token` ヒントのみをテーブル結合します。
+
+1 つのリモート Filesystem に複数のトークンを持たせることはできますが、各プロファイルが Filesystem ごとに保存する選択済みトークンは最大 1 つです。ローカルストアは運用上の選択情報であり、リモートのトークンインベントリのレプリカではありません。プロビジョニングまたは古いインポートによって作成された認証情報には、`token_id`、`scope_kind`、`token_name`、`expires_at`、または `scopes` が含まれていない場合がありますが、それでもデータプレーン用途では有効です。また、`ti` は不足しているメタデータをトークン一覧の行から推測しません。
+
+`ti fs generate-file-system-token` は、`--store-locally` が設定されていない限り、選択済み認証情報を変更しません。`--replace` はローカルの選択のみを変更し、以前のリモートトークンは引き続き有効なままです。ローカル認証情報をソースとするリフレッシュでは、それがアトミックに置き換えられます。フラグまたは `TI_FS_TOKEN` をソースとするリフレッシュでは、置換後のプレーンテキストが返され、ローカル状態には書き込まれません。
+
+`ti fs generate-file-system-scoped-token` はオーナートークンのみを受け付け、その正式なパススコープをローカルに保存できます。トークン JWT 自体には Filesystem ID は含まれますが、トークンの種類、トークン ID、またはスコープは含まれません。そのため、明示的に指定されたトークンまたは環境変数のトークンは、ローカルで分類されるのではなく、認可のためにサービスへ渡されます。`TI_FS_TOKEN` にはオーナートークンまたはスコープ付きトークンのいずれも指定できます。利用可能な操作は、そのサーバー側の能力に依存します。
+
+オーナー FS トークンは、Filesystem データアクセスとトークンインベントリまたはライフサイクル操作を認可します。TiDB Cloud Filesystem リソースの作成、一覧表示、詳細表示、削除は認可しません。また、別のオーナートークンを生成することもできません。これらの操作には TiDB Cloud API 認証情報が必要です。さらに、`ti fs delete-file-system` では明示的な `--file-system-id` が必要です。`TI_FS_TOKEN` に埋め込まれた ID が、削除対象の Filesystem 選択に使われることはありません。
+
+リソースの選択順序は次のとおりです。
+
+1. 明示的な `--file-system-id`
+2. `TI_FS_FILE_SYSTEM_ID`
+3. 明示的に指定された FS トークンから ID を導出
+4. それ以外の場合は `fs.missing_file_system_id` で失敗
+
+`ti` は、保存済みデフォルトやローカル認証情報の数から Filesystem を推測することはありません。単一コマンドには `--file-system-id` を、シェル、サンドボックス、または自動化環境には `TI_FS_FILE_SYSTEM_ID` を使用してください。
+
+リモート `fs`、`fs-git`、`fs-journal`、およびオーナー `fs-vault` 操作における FS オーナー認証情報の選択順序は次のとおりです。
+
+1. 明示的な `--fs-token`
+2. `TI_FS_TOKEN`
+3. 選択されたリソース認証情報
+
+フラグはシェル履歴やプロセス一覧に残る可能性があるため、フラグよりも `TI_FS_TOKEN` を推奨します。
+
+## 設定不要の Filesystem 入力 {#config-free-filesystem-inputs}
+
+クリーンなサンドボックスで必要なのは次の内容だけです。
+
+```bash
+export TI_FS_TOKEN=""
+export TI_REGION_CODE="aws-us-east-1"
+```
+
+これらの値はメモリ内の名前空間のみを構成します。`ti` はトークンから ID を導出し、どちらの値も `~/.ti/` に書き込みません。`TI_FS_FILE_SYSTEM_ID` は任意ですが、指定する場合はトークンと一致している必要があります。リモート Filesystem のインベントリ、詳細表示、プロビジョニング、および削除には TiDB Cloud API 認証情報が必要です。FS トークンは Filesystem 削除の認可としては不要であり、受け付けられません。
+
+## DB SQL 認証情報 {#db-sql-credentials}
+
+生成される SQL 認証情報はクラスター単位です。
+
+```text
+~/.ti/db_users//credentials
+```
+
+```toml
+[read_only]
+username = "..."
+password = "..."
+
+[read_write]
+username = "..."
+password = "..."
+
+[admin]
+username = "..."
+password = "..."
+```
+
+`ti db create-db-sql-users` は、これらの安定したユーザーを作成または修復します。これらはメインの認証情報ファイルには保存されません。
+
+3 つのアクセスモードは、TiDB Cloud の組み込みデータベースロールに対応します。
+
+| `ti` access mode | TiDB Cloud built-in role | 想定用途 |
+| --- | --- | --- |
+| `read_only` | `role_readonly` | データを変更せずにクエリおよび検証を行う |
+| `read_write` | `role_readwrite` | アプリケーションデータのクエリおよび変更を行う |
+| `admin` | `role_admin` | スキーマ変更を行い、権限を管理する |
+
+TiDB Cloud の完全なロールモデルについては、[データベースユーザーとロールの管理](/tidb-cloud/configure-sql-users.md) を参照してください。
+
+## Companion 状態とマウントロケーター {#companion-state-and-mount-locators}
+
+インストーラーには `ti-drive9` が含まれており、これは `ti fs`、`ti fs-git`、`ti fs-journal`、および `ti fs-vault` の操作を実行する companion runtime です。これを直接呼び出すことはありません。登録された各 Filesystem には、分離された companion home があります。
+
+```text
+~/.ti/drive9-home///
+```
+
+`ti` ワークフローでは、この状態やスタンドアロンの `~/.drive9` 設定を編集しないでください。
+
+バックグラウンドの FS または vault マウントが成功すると、機密情報を含まないロケーターが書き込まれます。
+
+```text
+~/.ti/mounts/.locator.json
+```
+
+このロケーターには、同じ `HOME` から drain およびアンマウントを行うために必要な配置先情報と companion-home 情報が記録されます。FS トークンは含まれません。アンマウントが成功すると削除されます。
+
+## 操作ログ {#operation-logs}
+
+`ti` は、ローカルの JSON Lines 形式のイベントを秘匿化して次の場所に書き込みます。
+
+```text
+~/.ti/logs/ti.jsonl
+```
+
+このログは、テレメトリーではなく、ローカルの監査およびデバッグ用データです。コマンド名、フラグ名、プロファイルとリージョン、所要時間、終了コードと安定したエラーコード、HTTP メソッド/ステータス、操作、およびリクエスト ID を含む場合があります。フラグ値、SQL、ファイルパスとその内容、ペイロード、接続文字列、および認証情報は含まれません。
+
+1 つのプロセスに対して無効にするには、次を実行します。
+
+```bash
+TI_LOGGING=off ti db list-db-clusters --db-cluster-type starter
+```
+
+または、`~/.ti/.preferences` を作成または編集します。
+
+```toml
+schema_version = 1
+
+[logging]
+enabled = false
+```
+
+環境変数の値 `off`、`false`、`0`、`no` はロギングを無効にし、`on`、`true`、`1`、`yes` は有効にします。環境変数は設定より優先されます。無効な設定値が指定された場合、要求されたコマンドを失敗させることなく、操作ログは無効になります。
+
+既存のインストールで `[logging]` を `~/.ti/config` に保存している場合、それらの値は自動的に `~/.ti/.preferences` に移行されます。この移行では、プロファイルと認証情報は保持されます。`ti update` は、`~/.ti/` 配下の設定、プロファイル、認証情報、操作ログ、またはその他の状態を読み書きしません。
+
+## 匿名テレメトリー {#anonymous-telemetry}
+
+リリースビルドは、対象となるコマンドについて、ベストエフォートで 1 件の完了イベントを TiDB Cloud CLI のテレメトリーサービスに送信します。このイベントには、正規化されたコマンド、明示的に指定されたフラグ名、安定した終了コードとエラーコード、所要時間、リージョン、CLI バージョン、OS、アーキテクチャ、インストール元、およびランダムな仮名化されたインストール ID が含まれます。フラグ値、認証情報、トークン、SQL テキスト、ファイルパスまたはその内容、コマンド出力、API ペイロード、プロファイル名、またはクラウドリソース ID は含まれません。
+
+開発ビルドおよび認識された CI 環境では、デフォルトで無効です。help、version、コマンドなしの使用、およびすべての `ti update` モードは常に除外されます。テレメトリーを永続的に無効にするには、次のグローバル設定を追加します。
+
+```toml
+[telemetry]
+enabled = false
+```
+
+ファイルを変更せずに 1 つのプロセスに対して無効にするには、次を実行します。
+
+```bash
+TI_TELEMETRY=off ti db list-db-clusters --db-cluster-type starter
+```
+
+TiDB Cloud CLI は、最初の対象イベントに対して `~/.ti/.telemetry-installation-id` を遅延作成し、POSIX 権限が利用可能な場合は現在のユーザーのみに制限します。仮名化された ID をリセットするには、このファイルを削除してください。テレメトリーの配信は損失を伴う可能性があり、コマンド出力、エラー、または終了ステータスを変更することはありません。
+
+統合は、プロファイルやコマンドを変更せずに、明示的なプロセススコープのメタデータを付加できます。`TI_TELEMETRY_TAG` は最大 128 バイトの UTF-8 文字列を受け付けます。`TI_TELEMETRY_EXTRA` は、圧縮後 2 KiB までの完全な JSON 値 1 つを受け付けます。無効なメタデータ、禁止されたメタデータ、深くネストされたメタデータ、またはサイズ超過のメタデータは、コマンドに影響を与えることなく省略されます。どちらの値にも、認証情報、トークン、SQL、パス、個人データ、プロファイル名、またはクラウドリソース ID を含めないでください。
+
+```bash
+TI_TELEMETRY_TAG="e2b-preview" \
+TI_TELEMETRY_EXTRA='{"campaign":"launch","runtime":"e2b"}' \
+ti fs list-files --file-system-id --path /
+```
+
+## 機密情報 {#sensitive-values}
+
+次の値はシークレットとして扱ってください。
+
+- TiDB Cloud API の秘密鍵と公開鍵のペア
+- FS オーナートークン
+- DB SQL のユーザー名、パスワード、および接続文字列
+- 委任された vault トークンとシークレット値
+
+これらをソース管理、チケット、ログ、コマンド例、または保護されていないシェル履歴に保存しないでください。
+
+## 関連ドキュメント {#related-documentation}
+
+- [TiDB Cloud CLI のリージョン、セキュリティ、および制限事項](/ai/ti/reference/ti-regions-security-and-limitations.md)
+- [TiDB Cloud CLI のトラブルシューティング](/ai/ti/reference/ti-troubleshooting.md)
diff --git a/ai/ti/reference/ti-configure.md b/ai/ti/reference/ti-configure.md
new file mode 100644
index 0000000000000..a120d778ac40d
--- /dev/null
+++ b/ai/ti/reference/ti-configure.md
@@ -0,0 +1,71 @@
+---
+title: ti configure
+summary: ローカルの TiDB Cloud CLI プロファイルを対話形式または非対話形式で設定します。
+---
+
+# ti configure
+
+ローカルの TiDB Cloud CLI プロファイルを設定します。フラグを指定しない場合、これは対話形式で実行できる唯一の TiDB Cloud CLI コマンドです。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェースは、予告なく変更される場合があります。
+
+## 構文 {#syntax}
+
+```text
+ti configure
+ [--help]
+ [--non-interactive]
+ [--region-code ]
+ [--tidb-cloud-private-key ]
+ [--tidb-cloud-public-key ]
+ [--version]
+```
+
+## オプション {#options}
+
+- `--help`: ヘルプ情報を表示します。
+- `--non-interactive`: プロンプトを表示しません。対応するコマンドオプションまたは環境変数を使用して、リージョンコード、公開鍵、秘密鍵を指定します。これは、スクリプトまたは自動化環境で `ti` を実行する場合に便利です。
+- `--region-code `: デフォルトのリージョンコード。たとえば `aws-us-east-1` または `aws-ap-southeast-1` です。
+- `--tidb-cloud-private-key `: TiDB Cloud API 秘密鍵。
+- `--tidb-cloud-public-key `: TiDB Cloud API 公開鍵。
+- `--version`: バージョン情報を表示します。
+
+すべてのコマンドで共通のオプションについては、[グローバルオプション](/ai/ti/reference/ti-cli-reference.md#global-options) を参照してください。
+
+## 設定値のソース {#configuration-value-sources}
+
+次のコマンドオプションと環境変数は、同じ設定値を提供します。
+
+| 設定値 | コマンドオプション | 環境変数 |
+| --- | --- | --- |
+| デフォルトのリージョンコード | `--region-code` | `TI_REGION_CODE` |
+| TiDB Cloud API 公開鍵 | `--tidb-cloud-public-key` | `TIDB_CLOUD_PUBLIC_KEY` |
+| TiDB Cloud API 秘密鍵 | `--tidb-cloud-private-key` | `TIDB_CLOUD_PRIVATE_KEY` |
+
+各値について、明示的に指定されたコマンドオプションは、対応する環境変数よりも優先されます。`--non-interactive` を使用する場合、3 つすべての値がこれらのソースから解決される必要があります。
+
+## 例 {#examples}
+
+- `ti` を対話形式で設定する場合:
+
+ ```bash
+ # Enter the default region code and TiDB Cloud API keys when prompted.
+ ti configure
+ ```
+
+- 自動化向けに `ti` を設定する場合:
+
+ ```bash
+ # Supply all required values without interactive prompts.
+ TI_REGION_CODE="aws-us-east-1" \
+ TIDB_CLOUD_PUBLIC_KEY="" \
+ TIDB_CLOUD_PRIVATE_KEY="" \
+ ti configure --profile ci --non-interactive
+ ```
+
+## 関連ドキュメント {#related-documentation}
+
+- [TiDB Cloud CLI のインストール、設定、および更新](/ai/ti/reference/ti-install-configure-update.md)
+- [TiDB Cloud CLI の設定と認証情報](/ai/ti/reference/ti-configuration-and-credentials.md)
\ No newline at end of file
diff --git a/ai/ti/reference/ti-db-create-db-cluster-branch.md b/ai/ti/reference/ti-db-create-db-cluster-branch.md
new file mode 100644
index 0000000000000..ebd2e67e4a8fc
--- /dev/null
+++ b/ai/ti/reference/ti-db-create-db-cluster-branch.md
@@ -0,0 +1,55 @@
+---
+title: ti db create-db-cluster-branch
+summary: TiDB Cloud Starter クラスターのブランチを作成します。
+---
+
+# ti db create-db-cluster-branch
+
+1 つの TiDB Cloud Starter インスタンスに対してブランチを作成します。`--wait` を指定すると、ブランチが `ACTIVE` になるまで待機します。このコマンドは、ブランチを作成する前に親クラスターが Starter であることを検証します。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェイスは、予告なく変更される場合があります。
+
+## 構文 {#syntax}
+
+```text
+ti db create-db-cluster-branch
+ --db-cluster-branch-name
+ --db-cluster-id
+ [--dry-run]
+ [--help]
+ [--version]
+ [--wait]
+```
+
+## オプション {#options}
+
+- `--db-cluster-branch-name `: Starter DB クラスターのブランチ表示名。\[required]
+- `--db-cluster-id `: Starter DB クラスター ID。\[required]
+- `--dry-run`: 変更を適用せずにリクエストを検証します。
+- `--help`: ヘルプ情報を表示します。
+- `--version`: バージョン情報を表示します。
+- `--wait`: 作成されたブランチが `ACTIVE` になるまで待機してから戻ります。
+
+すべてのコマンドで共通のオプションについては、[グローバルオプション](/ai/ti/reference/ti-cli-reference.md#global-options) を参照してください。
+
+## 例 {#examples}
+
+- ブランチを作成し、アクティブになるまで待機する場合:
+
+ ```bash
+ # Wait until the new database branch can accept connections.
+ ti db create-db-cluster-branch --db-cluster-id "" --db-cluster-branch-name dev --wait
+ ```
+
+- ブランチ作成をプレビューする場合:
+
+ ```bash
+ # Validate the parent cluster and branch request without creating it.
+ ti db create-db-cluster-branch --db-cluster-id "" --db-cluster-branch-name preview --dry-run
+ ```
+
+## 関連ドキュメント {#related-documentation}
+
+- [TiDB Cloud Starter CLI コマンドリファレンス](/ai/ti/reference/ti-starter-database.md)
\ No newline at end of file
diff --git a/ai/ti/reference/ti-db-create-db-cluster.md b/ai/ti/reference/ti-db-create-db-cluster.md
new file mode 100644
index 0000000000000..ab65c8661b449
--- /dev/null
+++ b/ai/ti/reference/ti-db-create-db-cluster.md
@@ -0,0 +1,85 @@
+---
+title: ti db create-db-cluster
+summary: TiDB Cloud Starter クラスターを作成します。
+---
+
+# ti db create-db-cluster
+
+TiDB Cloud Starter インスタンスを作成します。必須の `--db-cluster-type` は `starter` である必要があり、暗黙的な型指定はありません。`--wait` を指定すると、クラスターが `ACTIVE` になるまで待機します。
+
+このリクエストではプロジェクトを選択しません。TiDB Cloud はサーバー側のプロジェクトルールに従ってインスタンスを割り当て、`ti` はレスポンス内のプロジェクトメタデータをそのまま保持します。`ti` を使用してプロジェクトを選択または設定することはできません。
+
+TiDB Cloud CLI は、返されたサービスプランを検証します。作成の受け付け後に検証が失敗した場合、`ti` はクラスター ID を報告し、調査用にそのインスタンスを保持します。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェースは、予告なく変更される場合があります。
+
+## 構文 {#syntax}
+
+```text
+ti db create-db-cluster
+ --db-cluster-name
+ --db-cluster-type
+ [--dry-run]
+ [--help]
+ [--monthly-spending-limit-usd-cents ]
+ [--version]
+ [--wait]
+```
+
+## オプション {#options}
+
+- `--db-cluster-name `: Starter DB クラスターの表示名です。\[required]
+- `--db-cluster-type `: DB クラスターのタイプです。`starter` である必要があります。\[required]
+- `--dry-run`: 変更を適用せずにリクエストを検証します。
+- `--help`: ヘルプ情報を表示します。
+- `--monthly-spending-limit-usd-cents `: 月間利用上限を米ドルセント単位で指定します。省略した場合、`ti` は利用上限を送信せず、TiDB Cloud がデフォルトのルールを適用します。詳細は、[TiDB Cloud Starter インスタンスの利用上限を管理する](/tidb-cloud/manage-serverless-spend-limit.md) を参照してください。
+- `--version`: バージョン情報を表示します。
+- `--wait`: 作成したクラスターが `ACTIVE` になるまで待機してから戻ります。
+
+すべてのコマンドで共通のオプションについては、[グローバルオプション](/ai/ti/reference/ti-cli-reference.md#global-options) を参照してください。
+
+## 例 {#examples}
+
+- クラスターを作成し、アクティブになるまで待機します。
+
+ ```bash
+ # Wait until the new TiDB Cloud Starter instance reaches the ACTIVE state.
+ ti db create-db-cluster --db-cluster-type starter --db-cluster-name app-db --wait
+ ```
+
+- クラスターを非同期で作成します。
+
+ ```bash
+ # Return after TiDB Cloud accepts creation so another process can poll the cluster.
+ ti db create-db-cluster --db-cluster-type starter --db-cluster-name background-db
+ ```
+
+- クラスター作成をプレビューします。
+
+ ```bash
+ # Validate the request and resolved defaults without creating a cluster.
+ ti db create-db-cluster --db-cluster-type starter --db-cluster-name app-db --dry-run
+ ```
+
+- 月間利用上限を設定します。
+
+ ```bash
+ # Create a paid TiDB Cloud Starter instance with a monthly limit expressed in US dollar cents.
+ ti db create-db-cluster --db-cluster-type starter --db-cluster-name production-db --monthly-spending-limit-usd-cents 1000 --wait
+ ```
+
+## 作成後の検証に失敗した場合 {#if-post-creation-verification-fails}
+
+TiDB Cloud が作成リクエストを受け付けたものの、`ti` が返されたリソースを Starter インスタンスとして検証できない場合は、エラー内のクラスター ID を確認してください。保持されたリソースは、次のコマンドで確認できます。
+
+```bash
+ti db describe-db-cluster --db-cluster-id ""
+```
+
+`ti` が引き続きサービスプランを検証できない場合は、TiDB Cloud コンソールでリソースを確認または削除してください。最初のリクエストでインスタンスが作成されたかどうかを確認するまでは、create コマンドを再実行しないでください。
+
+## 関連ドキュメント {#related-documentation}
+
+- [TiDB Cloud Starter CLI コマンドリファレンス](/ai/ti/reference/ti-starter-database.md)
\ No newline at end of file
diff --git a/ai/ti/reference/ti-db-create-db-sql-users.md b/ai/ti/reference/ti-db-create-db-sql-users.md
new file mode 100644
index 0000000000000..ac087c3537cc9
--- /dev/null
+++ b/ai/ti/reference/ti-db-create-db-sql-users.md
@@ -0,0 +1,63 @@
+---
+title: ti db create-db-sql-users
+summary: TiDB Cloud Starter インスタンス用に、TiDB Cloud CLI が管理する SQL ユーザーを作成します。
+---
+
+# ti db create-db-sql-users
+
+TiDB Cloud Starter インスタンス用に、`ti` が管理する 3 つの SQL ユーザー（read-only、read-write、admin）を作成または修復します。これらの認証情報はローカルに保存されるため、後続のコマンドで `--read-only`、`--read-write`、または `--admin` を使用して適切なユーザーを選択できます。
+
+これらのユーザーには、以下の事前定義されたアクセスレベルと組み込みの TiDB Cloud ロールがあります。
+
+| `ti` access mode | TiDB Cloud built-in role | 想定用途 |
+| --- | --- | --- |
+| `read_only` | `role_readonly` | データを変更せずにクエリおよび検証を行う |
+| `read_write` | `role_readwrite` | アプリケーションデータのクエリおよび変更を行う |
+| `admin` | `role_admin` | スキーマ変更を行い、権限を管理する |
+
+TiDB Cloud のロールモデルについては、[データベースユーザーとロールの管理](/tidb-cloud/configure-sql-users.md) を参照してください。
+
+`ti` は、生成されたユーザー名とパスワードを `~/.ti/db_users//credentials` に保存し、3 つのアクセスモードごとに個別の TOML セクションを作成します。POSIX 権限をサポートするシステムでは、認証情報ファイルは所有者のみが読み書きできます。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェイスは、予告なく変更される場合があります。
+
+## 構文 {#syntax}
+
+```text
+ti db create-db-sql-users
+ --db-cluster-id
+ [--dry-run]
+ [--help]
+ [--version]
+```
+
+## オプション {#options}
+
+- `--db-cluster-id `: Starter DB クラスター ID。\[required]
+- `--dry-run`: 変更を適用せずにリクエストを検証します。
+- `--help`: ヘルプ情報を表示します。
+- `--version`: バージョン情報を表示します。
+
+すべてのコマンドで共通のオプションについては、[グローバルオプション](/ai/ti/reference/ti-cli-reference.md#global-options) を参照してください。
+
+## 例 {#examples}
+
+- 管理対象の SQL ユーザーを作成します。
+
+ ```bash
+ # Create or reconcile the read-only, read-write, and admin SQL users.
+ ti db create-db-sql-users --db-cluster-id ""
+ ```
+
+- SQL ユーザー作成をプレビューします。
+
+ ```bash
+ # Show the three managed roles without changing SQL users or local credentials.
+ ti db create-db-sql-users --db-cluster-id "" --dry-run
+ ```
+
+## 関連ドキュメント {#related-documentation}
+
+- [TiDB Cloud Starter CLI コマンドリファレンス](/ai/ti/reference/ti-starter-database.md)
\ No newline at end of file
diff --git a/ai/ti/reference/ti-db-delete-db-cluster-branch.md b/ai/ti/reference/ti-db-delete-db-cluster-branch.md
new file mode 100644
index 0000000000000..37fa31cf84f03
--- /dev/null
+++ b/ai/ti/reference/ti-db-delete-db-cluster-branch.md
@@ -0,0 +1,48 @@
+---
+title: ti db delete-db-cluster-branch
+summary: TiDB Cloud Starter クラスターからブランチを削除します。
+---
+
+# ti db delete-db-cluster-branch
+
+TiDB Cloud Starter インスタンスから 1 つのブランチを削除します。このコマンドは、ブランチの読み取りまたは削除を行う前に、親クラスターが Starter であることを検証します。削除レスポンスはポーリングせずに返され、このコマンドでは `--wait` オプションは提供されません。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェースは、予告なく変更される場合があります。
+
+## 構文 {#syntax}
+
+```text
+ti db delete-db-cluster-branch
+ --db-cluster-branch-id
+ --db-cluster-id
+ [--dry-run]
+ [--help]
+ [--version]
+```
+
+## オプション {#options}
+
+- `--db-cluster-branch-id `: Starter DB クラスターのブランチ ID。\[required]
+- `--db-cluster-id `: Starter DB クラスター ID。\[required]
+- `--dry-run`: 変更を適用せずにリクエストを検証します。
+- `--help`: ヘルプ情報を表示します。
+- `--version`: バージョン情報を表示します。
+
+すべてのコマンドで共通のオプションについては、[グローバルオプション](/ai/ti/reference/ti-cli-reference.md#global-options) を参照してください。
+
+## 例 {#examples}
+
+- ブランチを削除する:
+
+ ```bash
+ # Delete only the selected branch from its parent TiDB Cloud Starter instance.
+ ti db delete-db-cluster-branch --db-cluster-id "" --db-cluster-branch-id ""
+ ```
+
+ブランチが表示されなくなったことを確認するには、`ti db list-db-cluster-branches --db-cluster-id ""` を実行します。
+
+## 関連ドキュメント {#related-documentation}
+
+- [TiDB Cloud Starter CLI コマンドリファレンス](/ai/ti/reference/ti-starter-database.md)
\ No newline at end of file
diff --git a/ai/ti/reference/ti-db-delete-db-cluster.md b/ai/ti/reference/ti-db-delete-db-cluster.md
new file mode 100644
index 0000000000000..3fce943be1b4d
--- /dev/null
+++ b/ai/ti/reference/ti-db-delete-db-cluster.md
@@ -0,0 +1,53 @@
+---
+title: ti db delete-db-cluster
+summary: TiDB Cloud Starter クラスターを削除します。
+---
+
+# ti db delete-db-cluster
+
+TiDB Cloud Starter インスタンスを削除します。削除が完了するまで待機するには、`--wait` を使用します。このコマンドは TiDB Cloud Starter インスタンスのみを受け付け、その他のクラスタータイプは拒否します。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェースは、予告なく変更される場合があります。
+
+## 構文 {#syntax}
+
+```text
+ti db delete-db-cluster
+ --db-cluster-id
+ [--dry-run]
+ [--help]
+ [--version]
+ [--wait]
+```
+
+## オプション {#options}
+
+- `--db-cluster-id `: Starter DB クラスター ID。\[required]
+- `--dry-run`: 変更を適用せずにリクエストを検証します。
+- `--help`: ヘルプ情報を表示します。
+- `--version`: バージョン情報を表示します。
+- `--wait`: TiDB Cloud が削除リクエストを受け付けた後、インスタンスが `DELETED` に到達するまでポーリングします。その後に `not found` または `permission denied` の応答が返された場合も、インスタンスを読み取れなくなっているため、削除完了として扱われます。
+
+すべてのコマンドで共通のオプションについては、[グローバルオプション](/ai/ti/reference/ti-cli-reference.md#global-options) を参照してください。
+
+## 例 {#examples}
+
+- クラスターを削除し、完了まで待機する場合:
+
+ ```bash
+ # Wait until TiDB Cloud reports the cluster deleted or no longer accessible.
+ ti db delete-db-cluster --db-cluster-id "" --wait
+ ```
+
+- クラスターを非同期で削除する場合:
+
+ ```bash
+ # Return after TiDB Cloud accepts deletion while cleanup continues remotely.
+ ti db delete-db-cluster --db-cluster-id ""
+ ```
+
+## 関連ドキュメント {#related-documentation}
+
+- [TiDB Cloud Starter CLI コマンドリファレンス](/ai/ti/reference/ti-starter-database.md)
\ No newline at end of file
diff --git a/ai/ti/reference/ti-db-describe-db-cluster-branch.md b/ai/ti/reference/ti-db-describe-db-cluster-branch.md
new file mode 100644
index 0000000000000..e463d41ad12a6
--- /dev/null
+++ b/ai/ti/reference/ti-db-describe-db-cluster-branch.md
@@ -0,0 +1,46 @@
+---
+title: ti db describe-db-cluster-branch
+summary: TiDB Cloud Starter クラスターのブランチを記述します。
+---
+
+# ti db describe-db-cluster-branch
+
+クラスター ID とブランチ ID を指定して、1 つのブランチを記述します。デフォルトの `FULL` ビューでは、TiDB Cloud API から取得可能な完全なブランチ詳細を返します。基本情報のみを取得するには、`--view BASIC` を使用します。このコマンドは、ブランチを読み取る前に親クラスターが Starter であることを確認します。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェースは、予告なく変更される場合があります。
+
+## 構文 {#syntax}
+
+```text
+ti db describe-db-cluster-branch
+ --db-cluster-branch-id
+ --db-cluster-id
+ [--help]
+ [--version]
+ [--view ]
+```
+
+## オプション {#options}
+
+- `--db-cluster-branch-id `: Starter DB クラスターのブランチ ID。\[required]
+- `--db-cluster-id `: Starter DB クラスター ID。\[required]
+- `--help`: ヘルプ情報を表示します。
+- `--version`: バージョン情報を表示します。
+- `--view `: 詳細レベル: `BASIC` または `FULL`。省略した場合、TiDB Cloud API は `FULL` を使用します。
+
+すべてのコマンドで共通のオプションについては、[グローバルオプション](/ai/ti/reference/ti-cli-reference.md#global-options) を参照してください。
+
+## 例 {#examples}
+
+- ブランチを記述する:
+
+ ```bash
+ # Return full lifecycle and connection details for one branch.
+ ti db describe-db-cluster-branch --db-cluster-id "" --db-cluster-branch-id "" --view FULL
+ ```
+
+## 関連ドキュメント {#related-documentation}
+
+- [TiDB Cloud Starter CLI コマンドリファレンス](/ai/ti/reference/ti-starter-database.md)
\ No newline at end of file
diff --git a/ai/ti/reference/ti-db-describe-db-cluster.md b/ai/ti/reference/ti-db-describe-db-cluster.md
new file mode 100644
index 0000000000000..b123dcd754eb2
--- /dev/null
+++ b/ai/ti/reference/ti-db-describe-db-cluster.md
@@ -0,0 +1,44 @@
+---
+title: ti db describe-db-cluster
+summary: TiDB Cloud Starter クラスターの詳細を表示します。
+---
+
+# ti db describe-db-cluster
+
+TiDB Cloud Starter インスタンスの情報を取得します。デフォルトの `BASIC` ビューでは、インスタンスの基本情報が返されます。TiDB Cloud API から取得可能な完全な詳細を要求するには、`--view FULL` を使用します。クラスターの API メタデータによって Starter であることを確認できない場合、このコマンドはそのクラスターを拒否します。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェースは、予告なく変更される場合があります。
+
+## 構文 {#syntax}
+
+```text
+ti db describe-db-cluster
+ --db-cluster-id
+ [--help]
+ [--version]
+ [--view ]
+```
+
+## オプション {#options}
+
+- `--db-cluster-id `: Starter DB クラスター ID。\[required]
+- `--help`: ヘルプ情報を表示します。
+- `--version`: バージョン情報を表示します。
+- `--view `: 詳細レベル: `BASIC` または `FULL`。省略した場合、TiDB Cloud API は `BASIC` を使用します。
+
+すべてのコマンドで共通のオプションについては、[グローバルオプション](/ai/ti/reference/ti-cli-reference.md#global-options) を参照してください。
+
+## 例 {#examples}
+
+- TiDB Cloud Starter インスタンスの情報を取得します。
+
+ ```bash
+ # Return the instance state, placement, and connection metadata.
+ ti db describe-db-cluster --db-cluster-id "" --view FULL
+ ```
+
+## 関連ドキュメント {#related-documentation}
+
+- [TiDB Cloud Starter CLI コマンドリファレンス](/ai/ti/reference/ti-starter-database.md)
\ No newline at end of file
diff --git a/ai/ti/reference/ti-db-execute-sql-statement.md b/ai/ti/reference/ti-db-execute-sql-statement.md
new file mode 100644
index 0000000000000..b3f9352e41b52
--- /dev/null
+++ b/ai/ti/reference/ti-db-execute-sql-statement.md
@@ -0,0 +1,87 @@
+---
+title: ti db execute-sql-statement
+summary: TiDB Cloud Starter クラスターに対して 1 つの SQL ステートメントを実行します。
+---
+
+# ti db execute-sql-statement
+
+TiDB Cloud Starter インスタンスに対して 1 つの SQL ステートメントを実行します。デフォルトのアクセスロールは read-write です。ロールは明示的に指定することを推奨します。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェースは、予告なく変更される場合があります。
+
+## 構文 {#syntax}
+
+```text
+ti db execute-sql-statement
+ --db-cluster-id
+ --sql
+ [--admin]
+ [--database ]
+ [--help]
+ [--read-only]
+ [--read-write]
+ [--transport ]
+ [--version]
+```
+
+## オプション {#options}
+
+- `--db-cluster-id `: Starter DB クラスター ID。\[required]
+- `--sql `: 実行する 1 つの SQL ステートメント。\[required]
+- `--admin`: 用意された admin DB SQL 認証情報を使用します。
+- `--database `: データベース / デフォルトスキーマ名。
+- `--help`: ヘルプ情報を表示します。
+- `--read-only`: 用意された `read_only` DB SQL 認証情報を使用します。
+- `--read-write`: 用意された `read_write` DB SQL 認証情報を使用します。
+- `--transport `: SQL 実行トランスポート: `https` または `mysql`。\[default: https]
+- `--version`: バージョン情報を表示します。
+
+すべてのコマンドで共通のオプションについては、[グローバルオプション](/ai/ti/reference/ti-cli-reference.md#global-options) を参照してください。
+
+## 例 {#examples}
+
+- デフォルトの read-write ロールでステートメントを実行する:
+
+ ```bash
+ # Use the default prepared role for normal application reads and writes.
+ ti db execute-sql-statement --db-cluster-id "" --sql "INSERT INTO app.events(message) VALUES ('ready')"
+ ```
+
+- read-only クエリを実行する:
+
+ ```bash
+ # Prevent the statement from using read-write or admin credentials.
+ ti db execute-sql-statement --db-cluster-id "" --read-only --sql "SELECT 1 AS ready" --output text
+ ```
+
+- 管理用ステートメントを実行する:
+
+ ```bash
+ # Use the admin role for schema creation or privilege management.
+ ti db execute-sql-statement --db-cluster-id "" --admin --sql "CREATE DATABASE IF NOT EXISTS app"
+ ```
+
+- MySQL フォールバックトランスポートを使用する:
+
+ ```bash
+ # Open a direct TLS MySQL connection when the workflow requires the MySQL protocol.
+ ti db execute-sql-statement --db-cluster-id "" --transport mysql --sql "SELECT CURRENT_TIMESTAMP"
+ ```
+
+## トランスポートを選択する {#choose-a-transport}
+
+デフォルトの `https` トランスポートは、ステートメントを TiDB Cloud HTTPS SQL API に送信します。`mysql` トランスポートは、インスタンスへの直接 TLS MySQL 接続を開き、ステートメントを 1 回実行してから接続を閉じます。`mysql` は、ネットワークまたはワークフローで MySQL プロトコルが特に必要な場合にのみ使用してください。
+
+CLI は、`https` から `mysql` へ自動的にフォールバックしたり、もう一方のトランスポートでステートメントを再試行したりしません。これにより、障害が曖昧な場合に書き込みステートメントが 2 回実行されることを防ぎます。
+
+## 出力 {#output}
+
+JSON 出力には、`fields`、`rows`、`row_count`、該当する場合は `rows_affected`、該当する場合は `last_insert_id`、`transport`、`access_mode`、および `cluster_id` が含まれます。`rows` 内の各項目は、カラム名をキーとするオブジェクトです。
+
+`--output text` を指定すると、クエリ結果はカラム見出しと行数を含むテーブルとして表示されます。行を返さないステートメントでは、影響を受けた行数と、利用可能な場合は最後の insert ID を含む `Query OK` メッセージが出力されます。
+
+## 関連ドキュメント {#related-documentation}
+
+- [TiDB Cloud Starter CLI コマンドリファレンス](/ai/ti/reference/ti-starter-database.md)
\ No newline at end of file
diff --git a/ai/ti/reference/ti-db-format-db-connection-string.md b/ai/ti/reference/ti-db-format-db-connection-string.md
new file mode 100644
index 0000000000000..7ec870ce165db
--- /dev/null
+++ b/ai/ti/reference/ti-db-format-db-connection-string.md
@@ -0,0 +1,79 @@
+---
+title: ti db format-db-connection-string
+summary: TiDB Cloud CLI で管理される SQL ユーザー向けの接続文字列を整形します。
+---
+
+# ti db format-db-connection-string
+
+保存されている SQL 認証情報を、読み書き、読み取り専用、または管理者アクセス用に整形します。ロールオプションを指定しない場合、このコマンドは `read_write` を使用します。このコマンドは、ローカルの SQL 認証情報を読み込む前に、クラスターが Starter であることを検証します。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェースは、予告なく変更される場合があります。
+
+## 構文 {#syntax}
+
+```text
+ti db format-db-connection-string
+ --db-cluster-id
+ [--admin]
+ [--database ]
+ [--env-database-url-name ]
+ [--env-include-database-url]
+ [--env-prefix ]
+ [--format ]
+ [--help]
+ [--read-only]
+ [--read-write]
+ [--version]
+```
+
+## オプション {#options}
+
+- `--db-cluster-id `: Starter DB クラスター ID。\[required]
+- `--admin`: 準備済みの管理者 DB SQL 認証情報を使用します。
+- `--database `: データベース名 / デフォルトスキーマ名。
+- `--env-database-url-name `: `--format env` 用の Database URL 変数名。\[default: DATABASE_URL]
+- `--env-include-database-url`: `--format env` とともに Database URL 変数を含めます。
+- `--env-prefix `: `--format env` 用の dotenv 変数プレフィックス。\[default: TIDB_]
+- `--format `: 接続文字列の形式: `mysql-uri`、`jdbc`、`go-sql-driver`、`sqlalchemy`、または `env`。\[default: mysql-uri]
+- `--help`: ヘルプ情報を表示します。
+- `--read-only`: 準備済みの `read_only` DB SQL 認証情報を使用します。
+- `--read-write`: 準備済みの `read_write` DB SQL 認証情報を使用します。
+- `--version`: バージョン情報を表示します。
+
+すべてのコマンドで共通のオプションについては、[グローバルオプション](/ai/ti/reference/ti-cli-reference.md#global-options) を参照してください。
+
+## 例 {#examples}
+
+- 読み書き用の MySQL URI を整形する:
+
+ ```bash
+ # Use the default application role in tools that accept a MySQL URI.
+ ti db format-db-connection-string --db-cluster-id "" --read-write --format mysql-uri
+ ```
+
+- 読み取り専用の dotenv 変数を整形する:
+
+ ```bash
+ # Emit environment assignments for a workload that must not modify data.
+ ti db format-db-connection-string --db-cluster-id "" --read-only --format env --env-prefix TIDB_
+ ```
+
+- 管理者 JDBC URL を整形する:
+
+ ```bash
+ # Generate a JDBC connection value with the prepared admin credentials.
+ ti db format-db-connection-string --db-cluster-id "" --admin --format jdbc --database app
+ ```
+
+- dotenv 出力に DATABASE_URL を含める:
+
+ ```bash
+ # Emit both component variables and a conventional DATABASE_URL value.
+ ti db format-db-connection-string --db-cluster-id "" --read-write --format env --env-include-database-url
+ ```
+
+## 関連ドキュメント {#related-documentation}
+
+- [TiDB Cloud Starter CLI コマンドリファレンス](/ai/ti/reference/ti-starter-database.md)
\ No newline at end of file
diff --git a/ai/ti/reference/ti-db-list-db-cluster-branches.md b/ai/ti/reference/ti-db-list-db-cluster-branches.md
new file mode 100644
index 0000000000000..570358f236b3a
--- /dev/null
+++ b/ai/ti/reference/ti-db-list-db-cluster-branches.md
@@ -0,0 +1,46 @@
+---
+title: ti db list-db-cluster-branches
+summary: TiDB Cloud Starter クラスターのブランチを一覧表示します。
+---
+
+# ti db list-db-cluster-branches
+
+1 つの TiDB Cloud Starter インスタンスのブランチを、必要に応じてページネーション付きで一覧表示します。このコマンドは、ブランチを一覧表示する前に親クラスターが Starter であることを検証します。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェイスは、予告なく変更される場合があります。
+
+## 構文 {#syntax}
+
+```text
+ti db list-db-cluster-branches
+ --db-cluster-id
+ [--help]
+ [--page-size ]
+ [--page-token ]
+ [--version]
+```
+
+## オプション {#options}
+
+- `--db-cluster-id `: Starter DB クラスター ID。\[required]
+- `--help`: ヘルプ情報を表示します。
+- `--page-size `: リクエストするブランチ数です。省略した場合、または `0` に設定した場合、API は最大 `10` 件を返します。API の最大値は `100` で、`100` を超える値は `100` に設定されます。
+- `--page-token `: 以前の list-db-cluster-branches 呼び出しで返されたページトークンです。
+- `--version`: バージョン情報を表示します。
+
+すべてのコマンドで共通のオプションについては、[グローバルオプション](/ai/ti/reference/ti-cli-reference.md#global-options) を参照してください。
+
+## 例 {#examples}
+
+- クラスターのブランチを一覧表示します。
+
+ ```bash
+ # Return all branches that belong to the selected TiDB Cloud Starter instance.
+ ti db list-db-cluster-branches --db-cluster-id ""
+ ```
+
+## 関連ドキュメント {#related-documentation}
+
+- [TiDB Cloud Starter CLI コマンドリファレンス](/ai/ti/reference/ti-starter-database.md)
\ No newline at end of file
diff --git a/ai/ti/reference/ti-db-list-db-clusters.md b/ai/ti/reference/ti-db-list-db-clusters.md
new file mode 100644
index 0000000000000..1bfdfc4db5180
--- /dev/null
+++ b/ai/ti/reference/ti-db-list-db-clusters.md
@@ -0,0 +1,87 @@
+---
+title: ti db list-db-clusters
+summary: TiDB Cloud Starter クラスターを一覧表示します。
+---
+
+# ti db list-db-clusters
+
+選択したリージョン内の TiDB Cloud Starter インスタンスを一覧表示します。必要に応じて、ページネーション、フィルタリング、並べ替え、JMESPath による射影を指定できます。必須の `--db-cluster-type` は `starter` である必要があります。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェースは、予告なく変更される場合があります。
+
+## 構文 {#syntax}
+
+```text
+ti db list-db-clusters
+ --db-cluster-type
+ [--filter ]
+ [--help]
+ [--order-by ]
+ [--page-size ]
+ [--page-token ]
+ [--version]
+```
+
+## オプション {#options}
+
+- `--db-cluster-type `: DB クラスターのタイプです。`starter` である必要があります。\[required]
+- `--filter `: TiDB Cloud Starter API のフィルタ式です。API は、`region.provider`、`region.name`、`state`、`projectId`、`clusterId`、`displayName`、`labels.` に対して、Google AIP スタイルの `=` および `AND` 式をサポートします。
+- `--help`: ヘルプ情報を表示します。
+- `--order-by `: TiDB Cloud Starter API の `orderBy` 式です。`ti` はこの値を解釈せず、そのまま API に渡します。
+- `--page-size `: 返される検証済みクラスターの数です。省略した場合、または `0` に設定した場合のデフォルトは `10` です。最大値は `1000` です。
+- `--page-token `: 以前の互換性のある list-db-clusters 呼び出しで返された、不透明な ti ページトークンです。
+- `--version`: バージョン情報を表示します。
+
+すべてのコマンドで共通のオプションについては、[グローバルオプション](/ai/ti/reference/ti-cli-reference.md#global-options) を参照してください。
+
+## 例 {#examples}
+
+- クラスターを一覧表示する:
+
+ ```bash
+ # Return TiDB Cloud Starter instances in the profile's configured region as structured JSON.
+ ti db list-db-clusters --db-cluster-type starter
+ ```
+
+- 別のリージョンのクラスターを一覧表示する:
+
+ ```bash
+ # Override the region for this invocation without changing the profile.
+ ti --region aws-us-west-2 db list-db-clusters --db-cluster-type starter
+ ```
+
+- クラスターのフィールドを選択する:
+
+ ```bash
+ # Reduce the result to IDs, names, and lifecycle states.
+ ti db list-db-clusters --db-cluster-type starter --query 'clusters[].{id:id,name:display_name,state:state}'
+ ```
+
+- アクティブなクラスターをフィルタリングする:
+
+ ```bash
+ # Combine this filter with the mandatory effective-region filter.
+ ti db list-db-clusters --db-cluster-type starter --filter 'state="ACTIVE"'
+ ```
+
+## リージョン解決 {#region-resolution}
+
+有効なリージョンは、グローバル `--region`、次に `TI_REGION_CODE`、次に選択したプロファイルの `region_code` の順に解決されます。ユーザー指定の `--filter` 式は、この必須のリージョンスコープと結合されるため、結果を他のリージョンに拡張することはできません。
+
+リージョンをまたぐインスタンスおよび非Starter インスタンスは除外されます。また、サービスプランまたはリージョン情報の欠落や競合により、選択したリージョン内の Starter インスタンスであることを `ti` が検証できない場合も、そのインスタンスは除外されます。
+
+## フィルタと並べ替えの動作 {#filter-and-ordering-behavior}
+
+`ti` は、ユーザー指定のフィルタ式および並べ替え式を TiDB Cloud Starter API に渡します。無効または未サポートの式は API によって拒否されます。API の仕様については、[TiDB Cloud API v1beta1 の概要](/api/tidb-cloud-api-v1beta1.md) を参照してください。
+
+## ページトークンの再利用 {#page-token-reuse}
+
+このコマンドは、1 つの結果ページを満たすために複数の TiDB Cloud API ページを取得でき、`ti` の `next_page_token` を返します。検証済みの結果外のリソースを含む可能性があるため、API の `total_size` は省略されます。
+
+ページトークンは、同じプロファイル、クラスタータイプ、リージョン、フィルタ、並べ替えでのみ再利用できます。再実行時のページが変更されている場合は、`--page-token` を付けずに一覧取得をやり直してください。
+
+## 関連ドキュメント {#related-documentation}
+
+- [TiDB Cloud Starter CLI コマンドリファレンス](/ai/ti/reference/ti-starter-database.md)
\ No newline at end of file
diff --git a/ai/ti/reference/ti-db-update-db-cluster.md b/ai/ti/reference/ti-db-update-db-cluster.md
new file mode 100644
index 0000000000000..b8342b976a9ad
--- /dev/null
+++ b/ai/ti/reference/ti-db-update-db-cluster.md
@@ -0,0 +1,55 @@
+---
+title: ti db update-db-cluster
+summary: TiDB Cloud Starter クラスターを更新します。
+---
+
+# ti db update-db-cluster
+
+TiDB Cloud Starter インスタンスの表示名または月間支出上限を更新します。`--db-cluster-name` または `--monthly-spending-limit-usd-cents` の少なくとも一方が必要です。このコマンドは Starter インスタンスのみを受け付けます。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェイスは、予告なく変更される場合があります。
+
+## 構文 {#syntax}
+
+```text
+ti db update-db-cluster
+ --db-cluster-id
+ [--db-cluster-name ]
+ [--dry-run]
+ [--help]
+ [--monthly-spending-limit-usd-cents ]
+ [--version]
+```
+
+## オプション {#options}
+
+- `--db-cluster-id `: Starter DB クラスター ID。\[required]
+- `--db-cluster-name `: 新しい Starter DB クラスターの表示名。
+- `--dry-run`: 変更を適用せずにリクエストを検証します。
+- `--help`: ヘルプ情報を表示します。
+- `--monthly-spending-limit-usd-cents `: 米ドルセント単位の月間支出上限。省略すると変更されません。
+- `--version`: バージョン情報を表示します。
+
+すべてのコマンドで共通のオプションについては、[グローバルオプション](/ai/ti/reference/ti-cli-reference.md#global-options) を参照してください。
+
+## 例 {#examples}
+
+- クラスター名を変更する:
+
+ ```bash
+ # Change the TiDB Cloud Starter instance display name without recreating it.
+ ti db update-db-cluster --db-cluster-id "" --db-cluster-name app-db-v2
+ ```
+
+- 支出上限の更新をプレビューする:
+
+ ```bash
+ # Validate a new monthly limit without applying the change.
+ ti db update-db-cluster --db-cluster-id "" --monthly-spending-limit-usd-cents 1000 --dry-run
+ ```
+
+## 関連ドキュメント {#related-documentation}
+
+- [TiDB Cloud Starter CLI コマンドリファレンス](/ai/ti/reference/ti-starter-database.md)
\ No newline at end of file
diff --git a/ai/ti/reference/ti-filesystem-git.md b/ai/ti/reference/ti-filesystem-git.md
new file mode 100644
index 0000000000000..03dd741b4fe43
--- /dev/null
+++ b/ai/ti/reference/ti-filesystem-git.md
@@ -0,0 +1,22 @@
+---
+title: TiDB Cloud Filesystem Git CLI コマンドリファレンス
+summary: クローン、hydrate、リンクされた Git worktree の管理を行う各 `ti fs-git` コマンドのリファレンスです。
+---
+
+# TiDB Cloud Filesystem Git CLI コマンドリファレンス
+
+`ti fs-git` は、マウントされた TiDB Cloud Filesystem パス上での Git ワークスペースのセットアップを高速化します。status、edit、add、commit、fetch、push には、引き続き通常の `git` コマンドを使用してください。
+
+## コマンド {#commands}
+
+| コマンド | 説明 |
+|---|---|
+| [`clone-git-workspace`](/ai/ti/reference/ti-fs-git-clone-git-workspace.md) | リポジトリをマウントされた Filesystem パスにクローンします。 |
+| [`hydrate-git-workspace`](/ai/ti/reference/ti-fs-git-hydrate-git-workspace.md) | 既存の fast または blobless ワークスペースに対して、クリーンな Git データを実体化します。 |
+| [`add-git-worktree`](/ai/ti/reference/ti-fs-git-add-git-worktree.md) | ベースワークスペースからリンクされた worktree を作成します。 |
+| [`remove-git-worktree`](/ai/ti/reference/ti-fs-git-remove-git-worktree.md) | リンクされた worktree を削除します。 |
+
+## 関連情報 {#see-also}
+
+- [TiDB Cloud Filesystem 上で Git ワークスペースを管理する](/ai/ti/guides/manage-git-workspaces.md)
+- [TiDB Cloud Filesystem 上で Agents 用の Git ワークスペースを準備する](/ai/ti/guides/ti-git-workspace-for-agents-example.md)
\ No newline at end of file
diff --git a/ai/ti/reference/ti-filesystem-journal.md b/ai/ti/reference/ti-filesystem-journal.md
new file mode 100644
index 0000000000000..7fbd7d446ba55
--- /dev/null
+++ b/ai/ti/reference/ti-filesystem-journal.md
@@ -0,0 +1,23 @@
+---
+title: TiDB Cloud Filesystem Journal CLI コマンドリファレンス
+summary: ジャーナルの作成、追記、読み取り、検索、検証を行うすべての `ti fs-journal` コマンドのリファレンスです。
+---
+
+# TiDB Cloud Filesystem Journal CLI コマンドリファレンス
+
+`ti fs-journal` は、エージェントおよびワークフローのイベントに対して、追記専用で検証可能な台帳を提供します。
+
+## コマンド {#commands}
+
+| コマンド | 説明 |
+|---|---|
+| [`create-journal`](/ai/ti/reference/ti-fs-journal-create-journal.md) | ジャーナルを作成します。 |
+| [`append-journal-entries`](/ai/ti/reference/ti-fs-journal-append-journal-entries.md) | ジャーナルにイベントを追記します。 |
+| [`read-journal-entries`](/ai/ti/reference/ti-fs-journal-read-journal-entries.md) | シーケンス順でジャーナルエントリを読み取ります。 |
+| [`search-journal-entries`](/ai/ti/reference/ti-fs-journal-search-journal-entries.md) | ジャーナルとエントリを検索します。 |
+| [`verify-journal`](/ai/ti/reference/ti-fs-journal-verify-journal.md) | ジャーナルのハッシュチェーンを検証します。 |
+
+## 関連情報 {#see-also}
+
+- [TiDB Cloud Filesystem Journal を使用する](/ai/ti/guides/use-filesystem-journals.md)
+- [TiDB Cloud Filesystem Journal にエージェントワークフローを記録する](/ai/ti/guides/ti-journal-agent-workflow-example.md)
\ No newline at end of file
diff --git a/ai/ti/reference/ti-filesystem-vault.md b/ai/ti/reference/ti-filesystem-vault.md
new file mode 100644
index 0000000000000..f52c5b1e764fe
--- /dev/null
+++ b/ai/ti/reference/ti-filesystem-vault.md
@@ -0,0 +1,31 @@
+---
+title: TiDB Cloud Filesystem Vault CLI コマンドリファレンス
+summary: シークレット、委任アクセス、監査イベント、プロセスインジェクション、およびマウントに関するすべての `ti fs-vault` コマンドのリファレンスです。
+---
+
+# TiDB Cloud Filesystem Vault CLI コマンドリファレンス
+
+TiDB Cloud Filesystem でシークレットと委任アクセスを管理するには、`ti fs-vault` を使用します。
+
+ほとんどのシークレット管理コマンドでは、`db-prod` のようにシークレットを名前で識別します。一方、`replace-secret` と `run-with-secret` では、正規の Vault パス `/n/vault/` を指定する必要があります。`/n/vault/` は Vault 名前空間のルートであるため、`/n/vault/db-prod` とシークレット名 `db-prod` は同じシークレットを指します。
+
+## コマンド {#commands}
+
+| コマンド | 説明 |
+|---|---|
+| [`create-secret`](/ai/ti/reference/ti-fs-vault-create-secret.md) | シークレットを作成します。 |
+| [`replace-secret`](/ai/ti/reference/ti-fs-vault-replace-secret.md) | シークレットを置き換えます。 |
+| [`read-secret`](/ai/ti/reference/ti-fs-vault-read-secret.md) | シークレットを読み取ります。 |
+| [`list-secrets`](/ai/ti/reference/ti-fs-vault-list-secrets.md) | シークレットを一覧表示します。 |
+| [`delete-secret`](/ai/ti/reference/ti-fs-vault-delete-secret.md) | シークレットを削除します。 |
+| [`create-grant`](/ai/ti/reference/ti-fs-vault-create-grant.md) | シークレットへの制限付きアクセスを委任します。 |
+| [`delete-grant`](/ai/ti/reference/ti-fs-vault-delete-grant.md) | 委任されたアクセスを取り消します。 |
+| [`list-audit-events`](/ai/ti/reference/ti-fs-vault-list-audit-events.md) | Vault の監査イベントを一覧表示します。 |
+| [`run-with-secret`](/ai/ti/reference/ti-fs-vault-run-with-secret.md) | シークレットをプロセスに注入します。 |
+| [`mount-vault`](/ai/ti/reference/ti-fs-vault-mount-vault.md) | 読み取り専用の Vault ビューをマウントします。 |
+| [`unmount-vault`](/ai/ti/reference/ti-fs-vault-unmount-vault.md) | Vault ビューをアンマウントします。 |
+
+## 関連情報 {#see-also}
+
+- [TiDB Cloud Filesystem Vault Secrets を管理する](/ai/ti/guides/manage-filesystem-vault-secrets.md)
+- [TiDB Cloud Filesystem Vault シークレットを Agent に委任する](/ai/ti/guides/ti-vault-agent-secrets-example.md)
diff --git a/ai/ti/reference/ti-filesystem.md b/ai/ti/reference/ti-filesystem.md
new file mode 100644
index 0000000000000..caa55b29e076e
--- /dev/null
+++ b/ai/ti/reference/ti-filesystem.md
@@ -0,0 +1,135 @@
+---
+title: TiDB Cloud Filesystem CLI コマンドリファレンス
+summary: Filesystem リソース、ファイル、レイヤー、パック、マウント向けのすべての `ti fs` コマンドを参照します。
+---
+
+# TiDB Cloud Filesystem CLI コマンドリファレンス
+
+`ti fs` を使用して TiDB Cloud Filesystem リソースをプロビジョニングし、コマンドまたはローカルマウントからそのデータにアクセスできます。
+
+コマンド構文では、角括弧（`[]`）は省略可能な項目を囲みます。丸括弧は必須の選択肢をグループ化し、縦棒（`|`）は代替候補を区切ります。たとえば、`(--ttl | --no-expiration)` は、2 つのオプションのうちちょうど 1 つを指定する必要があることを意味します。
+
+## リソースとトークンのコマンド {#resource-and-token-commands}
+
+| コマンド | 説明 |
+| --- | --- |
+| [`create-file-system`](/ai/ti/reference/ti-fs-create-file-system.md) | Filesystem とその初期オーナートークンを作成します。 |
+| [`list-file-systems`](/ai/ti/reference/ti-fs-list-file-systems.md) | 有効なリージョン内の Filesystem を一覧表示します。 |
+| [`describe-file-system`](/ai/ti/reference/ti-fs-describe-file-system.md) | ID で 1 つの Filesystem の詳細を表示します。 |
+| [`check-file-system`](/ai/ti/reference/ti-fs-check-file-system.md) | Filesystem の選択、ルーティング、認証情報、およびデータプレーンアクセスを確認します。 |
+| [`delete-file-system`](/ai/ti/reference/ti-fs-delete-file-system.md) | Filesystem を完全に削除します。 |
+| [`import-file-system-token`](/ai/ti/reference/ti-fs-import-file-system-token.md) | 既存の Filesystem トークンをローカルにインポートして選択します。 |
+| [`generate-file-system-token`](/ai/ti/reference/ti-fs-generate-file-system-token.md) | 追加のオーナートークンを生成します。 |
+| [`generate-file-system-scoped-token`](/ai/ti/reference/ti-fs-generate-file-system-scoped-token.md) | パス、操作、および有効期間で制限されたトークンを生成します。 |
+| [`list-file-system-tokens`](/ai/ti/reference/ti-fs-list-file-system-tokens.md) | シークレットを含まないトークンメタデータを一覧表示します。 |
+| [`enable-file-system-token`](/ai/ti/reference/ti-fs-enable-file-system-token.md) | 無効化されたトークンを再度有効にします。 |
+| [`disable-file-system-token`](/ai/ti/reference/ti-fs-disable-file-system-token.md) | トークンを一時的に無効にします。 |
+| [`delete-file-system-token`](/ai/ti/reference/ti-fs-delete-file-system-token.md) | トークンを完全に失効させます。 |
+| [`refresh-file-system-token`](/ai/ti/reference/ti-fs-refresh-file-system-token.md) | トークンをローテーションし、その置き換えトークンを 1 回だけ返します。 |
+
+### トークン管理の認可 {#token-management-authorization}
+
+オーナートークンがトークン管理を認可している場合、そのトークンはトークンの一覧表示、スコープ付きトークンの作成、およびオーナートークンまたはスコープ付きトークンの失効を実行できます。有効化または無効化できるのはスコープ付きトークンのみです。TiDB Cloud API 認証情報は、どちらの種類のトークンでも有効化、無効化、または失効できます。
+
+## AI プロバイダー設定コマンド {#ai-provider-configuration-commands}
+
+これらのコマンドは、メディアファイルからコンテンツを抽出し、埋め込みを生成するためのオプションのプロバイダーを設定します。通常の Filesystem リソース操作およびファイル操作では、AI プロバイダー設定は不要です。
+
+| コマンド | 説明 |
+| --- | --- |
+| [`describe-file-system-extract-configuration`](/ai/ti/reference/ti-fs-describe-file-system-extract-configuration.md) | メディア抽出プロバイダーの設定を表示します。 |
+| [`update-file-system-extract-configuration`](/ai/ti/reference/ti-fs-update-file-system-extract-configuration.md) | メディアコンテンツの抽出に使用するプロバイダーを更新します。 |
+| [`describe-file-system-embedding-configuration`](/ai/ti/reference/ti-fs-describe-file-system-embedding-configuration.md) | 埋め込みプロバイダーの設定を表示します。 |
+| [`update-file-system-embedding-configuration`](/ai/ti/reference/ti-fs-update-file-system-embedding-configuration.md) | 埋め込みの生成に使用するプロバイダーを更新します。 |
+
+## データおよび名前空間のコマンド {#data-and-namespace-commands}
+
+| コマンド | 説明 |
+| --- | --- |
+| [`copy-file`](/ai/ti/reference/ti-fs-copy-file.md) | ローカルストレージと Filesystem の間、または Filesystem 内でファイルをコピーします。 |
+| [`read-file`](/ai/ti/reference/ti-fs-read-file.md) | リモートファイルまたはバイト範囲を読み取ります。 |
+| [`list-files`](/ai/ti/reference/ti-fs-list-files.md) | リモートパス配下のエントリを一覧表示します。 |
+| [`describe-file`](/ai/ti/reference/ti-fs-describe-file.md) | リモートファイルまたはディレクトリの詳細を表示します。 |
+| [`move-file`](/ai/ti/reference/ti-fs-move-file.md) | リモートパスを移動または名前変更します。 |
+| [`delete-file`](/ai/ti/reference/ti-fs-delete-file.md) | リモートファイルまたはディレクトリを削除します。 |
+| [`create-directory`](/ai/ti/reference/ti-fs-create-directory.md) | リモートディレクトリを作成します。 |
+| [`chmod-file`](/ai/ti/reference/ti-fs-chmod-file.md) | POSIX スタイルのモードメタデータを変更します。 |
+| [`create-symlink`](/ai/ti/reference/ti-fs-create-symlink.md) | シンボリックリンクを作成します。 |
+| [`create-hardlink`](/ai/ti/reference/ti-fs-create-hardlink.md) | ハードリンクを作成します。 |
+| [`search-file-content`](/ai/ti/reference/ti-fs-search-file-content.md) | 抽出されたファイルコンテンツと説明を検索します。 |
+| [`find-files`](/ai/ti/reference/ti-fs-find-files.md) | 名前、タグ、日付、サイズ、またはタイプでファイルを検索します。 |
+
+## レイヤーとポータビリティのコマンド {#layer-and-portability-commands}
+
+| コマンド | 説明 |
+| --- | --- |
+| [`create-layer`](/ai/ti/reference/ti-fs-create-layer.md) | 分離された書き込み可能なレイヤーを作成します。 |
+| [`list-layers`](/ai/ti/reference/ti-fs-list-layers.md) | Filesystem 内のレイヤーを一覧表示します。 |
+| [`fork-layer`](/ai/ti/reference/ti-fs-fork-layer.md) | 親の tip またはチェックポイントから子レイヤーをフォークします。 |
+| [`list-layer-chain`](/ai/ti/reference/ti-fs-list-layer-chain.md) | レイヤーの固定された祖先チェーンを一覧表示します。 |
+| [`describe-layer`](/ai/ti/reference/ti-fs-describe-layer.md) | ID でレイヤーの詳細を表示します。 |
+| [`diff-layer`](/ai/ti/reference/ti-fs-diff-layer.md) | レイヤーに記録された変更を一覧表示します。 |
+| [`create-layer-checkpoint`](/ai/ti/reference/ti-fs-create-layer-checkpoint.md) | レイヤー内に永続的なチェックポイントを作成します。 |
+| [`delete-layer`](/ai/ti/reference/ti-fs-delete-layer.md) | レイヤーを論理的に破棄します。 |
+| [`rollback-layer`](/ai/ti/reference/ti-fs-rollback-layer.md) | 変更をコミットせずにレイヤーをロールバックします。 |
+| [`commit-layer`](/ai/ti/reference/ti-fs-commit-layer.md) | レイヤーの変更をベース Filesystem に適用します。 |
+| [`pack-file-system`](/ai/ti/reference/ti-fs-pack-file-system.md) | 選択したローカルオーバーレイ状態を Filesystem にアーカイブします。 |
+| [`unpack-file-system`](/ai/ti/reference/ti-fs-unpack-file-system.md) | アーカイブからローカルオーバーレイ状態を復元します。 |
+
+### レイヤー参照 {#layer-references}
+
+レイヤー参照には、レイヤー ID、一意のレイヤー名、または `tag:=` 形式のタグ参照を使用できます。たとえば `tag:run=123` です。名前とタグ参照は曖昧になる可能性があるため、自動化ではレイヤー ID を使用してください。
+
+### マウントプロファイルとローカルオーバーレイ {#mount-profiles-and-local-overlays}
+
+ローカルオーバーレイには、マウントプロファイルがリモート名前空間ではなくローカルマシン上に保持するファイルが保存されます。マウントプロファイルは、どのパスでそのオーバーレイを使用するかを定義します。
+
+| マウントプロファイル | 動作 |
+| --- | --- |
+| `coding-agent` | バージョン管理メタデータ、依存関係ディレクトリ、キャッシュ、ビルド出力、および一般的な一時パスをローカルオーバーレイに保持します。自動パックパスは選択しません。 |
+| `portable` | `coding-agent` と同じローカルパスルールを使用し、デフォルトで完全なオーバーレイをパックまたは unpack するため、マシン間やサンドボックスセッション間で移動できます。 |
+| `none` | ローカルオーバーレイのパスルーティングと、自動パックまたは unpack の動作を無効にします。 |
+
+## マウントコマンド {#mount-commands}
+
+| コマンド | 説明 |
+| --- | --- |
+| [`mount-file-system`](/ai/ti/reference/ti-fs-mount-file-system.md) | ローカルパスに Filesystem をマウントします。 |
+| [`drain-file-system`](/ai/ti/reference/ti-fs-drain-file-system.md) | 稼働中の FUSE マウントから保留中の書き込みをフラッシュします。 |
+| [`unmount-file-system`](/ai/ti/reference/ti-fs-unmount-file-system.md) | Filesystem をフラッシュしてアンマウントします。 |
+
+## コマンドエイリアス {#command-aliases}
+
+以下の `ti fs` コマンドには Unix スタイルのエイリアスがあります。たとえば、`ti fs cp` は `ti fs copy-file` と同等です。表に記載されていないコマンド（`pack-file-system` や `unpack-file-system` を含む）にはエイリアスがありません。
+
+| エイリアス | 正規コマンド |
+| --- | --- |
+| `cp` | `copy-file` |
+| `cat` | `read-file` |
+| `ls` | `list-files` |
+| `stat` | `describe-file` |
+| `mv` | `move-file` |
+| `rm` | `delete-file` |
+| `mkdir` | `create-directory` |
+| `chmod` | `chmod-file` |
+| `symlink` | `create-symlink` |
+| `hardlink` | `create-hardlink` |
+| `grep` | `search-file-content` |
+| `find` | `find-files` |
+| `mount` | `mount-file-system` |
+| `drain` | `drain-file-system` |
+| `umount` | `unmount-file-system` |
+
+エイリアスは、正規コマンドと同じオプション、認証、出力、クエリ、およびエラー動作を使用します。
+
+## 関連情報 {#see-also}
+
+- [TiDB Cloud Filesystem リソースを管理する](/ai/ti/guides/manage-filesystem-resources.md)
+- [TiDB Cloud Filesystem AI Providers を設定する](/ai/ti/guides/configure-filesystem-ai-providers.md)
+- [TiDB Cloud Filesystem トークンを管理する](/ai/ti/guides/manage-filesystem-tokens.md)
+- [TiDB Cloud Filesystem データを操作する](/ai/ti/guides/work-with-filesystem-data.md)
+- [Filesystem レイヤーと Checkpoint を管理する](/ai/ti/guides/manage-filesystem-layers.md)
+- [TiDB Cloud Filesystem をマウントする](/ai/ti/guides/mount-filesystem.md)
+- [TiDB Cloud Filesystem 上の Git ワークスペースを管理する](/ai/ti/guides/manage-git-workspaces.md)
+- [TiDB Cloud Filesystem Journals を使用する](/ai/ti/guides/use-filesystem-journals.md)
+- [TiDB Cloud Filesystem Vault Secrets を管理する](/ai/ti/guides/manage-filesystem-vault-secrets.md)
diff --git a/ai/ti/reference/ti-fs-check-file-system.md b/ai/ti/reference/ti-fs-check-file-system.md
new file mode 100644
index 0000000000000..8c7ca2d6e7c5a
--- /dev/null
+++ b/ai/ti/reference/ti-fs-check-file-system.md
@@ -0,0 +1,44 @@
+---
+title: ti fs check-file-system
+summary: TiDB Cloud Filesystem の接続性を確認します。
+---
+
+# ti fs check-file-system
+
+選択した Filesystem が正しく設定され、アクセス可能であることを、リージョン、認証情報、およびファイルアクセスを含めて検証します。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェースは、予告なく変更される場合があります。
+
+## 構文 {#syntax}
+
+```text
+ti fs check-file-system
+ [--file-system-id ]
+ [--fs-token ]
+ [--help]
+ [--version]
+```
+
+## オプション {#options}
+
+- `--file-system-id `: ファイルシステムを選択します。`TI_FS_FILE_SYSTEM_ID` を設定することもできます。
+- `--fs-token `: Filesystem トークンを設定します。省略した場合、このコマンドは `TI_FS_TOKEN` 環境変数を使用します。どちらも指定されていない場合、このコマンドは選択した Filesystem 用にローカルに保存されているトークンを使用します。
+- `--help`: ヘルプ情報を表示します。
+- `--version`: バージョン情報を表示します。
+
+すべてのコマンドで共通のオプションについては、[グローバルオプション](/ai/ti/reference/ti-cli-reference.md#global-options) を参照してください。
+
+## 例 {#examples}
+
+- Filesystem の接続性を確認します。
+
+ ```bash
+ # Verify that the selected token can reach and read the Filesystem root.
+ ti fs check-file-system --file-system-id
+ ```
+
+## 関連ドキュメント {#related-documentation}
+
+- [TiDB Cloud Filesystem CLI コマンドリファレンス](/ai/ti/reference/ti-filesystem.md)
\ No newline at end of file
diff --git a/ai/ti/reference/ti-fs-chmod-file.md b/ai/ti/reference/ti-fs-chmod-file.md
new file mode 100644
index 0000000000000..29a326f503b26
--- /dev/null
+++ b/ai/ti/reference/ti-fs-chmod-file.md
@@ -0,0 +1,50 @@
+---
+title: ti fs chmod-file
+summary: TiDB Cloud Filesystem 内のファイル権限を変更します。
+---
+
+# ti fs chmod-file
+
+リモートパスの POSIX モードメタデータを変更します。このコマンドのエイリアスは `ti fs chmod` です。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェースは、予告なく変更される場合があります。
+
+## 構文 {#syntax}
+
+```text
+ti fs chmod-file
+ --mode
+ --path
+ [--dry-run]
+ [--file-system-id ]
+ [--fs-token ]
+ [--help]
+ [--version]
+```
+
+## オプション {#options}
+
+- `--mode `: 0644 などの 8 進数値で指定する権限モードです。\[required]
+- `--path `: ファイルまたはディレクトリのパスです。\[required]
+- `--dry-run`: 変更を適用せずにリクエストを検証します。
+- `--file-system-id `: ファイルシステムを選択します。`TI_FS_FILE_SYSTEM_ID` を設定することもできます。
+- `--fs-token `: Filesystem トークンを設定します。省略した場合、このコマンドは `TI_FS_TOKEN` 環境変数を使用します。どちらも指定されていない場合、このコマンドは選択した Filesystem 用にローカルに保存されているトークンを使用します。
+- `--help`: ヘルプ情報を表示します。
+- `--version`: バージョン情報を表示します。
+
+すべてのコマンドで共通のオプションについては、[グローバルオプション](/ai/ti/reference/ti-cli-reference.md#global-options) を参照してください。
+
+## 例 {#examples}
+
+- リモートの権限メタデータを変更します。
+
+ ```bash
+ # Restrict the selected file to owner read and write access.
+ ti fs chmod-file --file-system-id --path /reports/final.md --mode 0600
+ ```
+
+## 関連ドキュメント {#related-documentation}
+
+- [TiDB Cloud Filesystem CLI コマンドリファレンス](/ai/ti/reference/ti-filesystem.md)
\ No newline at end of file
diff --git a/ai/ti/reference/ti-fs-commit-layer.md b/ai/ti/reference/ti-fs-commit-layer.md
new file mode 100644
index 0000000000000..524de96fd5f29
--- /dev/null
+++ b/ai/ti/reference/ti-fs-commit-layer.md
@@ -0,0 +1,48 @@
+---
+title: ti fs commit-layer
+summary: TiDB Cloud Filesystem のレイヤーをコミットします。
+---
+
+# ti fs commit-layer
+
+1 つのレイヤーを、そのベース Filesystem に適用します。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェースは、予告なく変更される場合があります。
+
+## 構文 {#syntax}
+
+```text
+ti fs commit-layer
+ --layer-id
+ [--dry-run]
+ [--file-system-id ]
+ [--fs-token ]
+ [--help]
+ [--version]
+```
+
+## オプション {#options}
+
+- `--layer-id `: レイヤー ID。\[required]
+- `--dry-run`: 変更を適用せずにリクエストを検証します。
+- `--file-system-id `: ファイルシステムを選択します。`TI_FS_FILE_SYSTEM_ID` を設定することもできます。
+- `--fs-token `: Filesystem トークンを設定します。省略した場合、このコマンドは `TI_FS_TOKEN` 環境変数を使用します。どちらも指定されていない場合、このコマンドは選択した Filesystem 用にローカルに保存されているトークンを使用します。
+- `--help`: ヘルプ情報を表示します。
+- `--version`: バージョン情報を表示します。
+
+すべてのコマンドで共通のオプションについては、[グローバルオプション](/ai/ti/reference/ti-cli-reference.md#global-options) を参照してください。
+
+## 例 {#examples}
+
+- レイヤーをコミットします。
+
+ ```bash
+ # Apply the selected layer's changes to its base Filesystem view.
+ ti fs commit-layer --file-system-id --layer-id ""
+ ```
+
+## 関連ドキュメント {#related-documentation}
+
+- [TiDB Cloud Filesystem CLI コマンドリファレンス](/ai/ti/reference/ti-filesystem.md)
\ No newline at end of file
diff --git a/ai/ti/reference/ti-fs-copy-file.md b/ai/ti/reference/ti-fs-copy-file.md
new file mode 100644
index 0000000000000..2897916f0539a
--- /dev/null
+++ b/ai/ti/reference/ti-fs-copy-file.md
@@ -0,0 +1,121 @@
+---
+title: ti fs copy-file
+summary: TiDB Cloud Filesystem との間、またはその内部でファイルをコピーします。
+---
+
+# ti fs copy-file
+
+ローカルパス、リモートパス、標準入力、標準出力の間でファイルをコピーします。このコマンドのエイリアスは `ti fs cp` です。
+
+以下のソースと宛先の組み合わせのうち、いずれか 1 つだけを指定してください。
+
+| ソース | 宛先 |
+| --- | --- |
+| `--from-local` | `--to-remote` |
+| `--from-stdin` | `--to-remote` |
+| `--from-remote` | `--to-local` |
+| `--from-remote` | `--to-stdout` |
+| `--from-remote` | `--to-remote` |
+
+`--append` は `--from-local` と `--to-remote` の組み合わせでのみサポートされます。標準入力またはリモートソースはサポートされません。
+
+> **Note:**
+>
+> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェースは、予告なく変更される場合があります。
+
+## 構文 {#syntax}
+
+```text
+ti fs copy-file
+ [--append]
+ [--create-parents]
+ [--description ]
+ [--dry-run]
+ [--file-system-id ]
+ [--from-local ]
+ [--from-remote ]
+ [--from-stdin]
+ [--fs-token ]
+ [--help]
+ [--layer-id ]
+ [--overwrite]
+ [--recursive]
+ [--resume]
+ [--tag ]
+ [--to-local ]
+ [--to-remote ]
+ [--to-stdout]
+ [--version]
+```
+
+## オプション {#options}
+
+- `--append`: ローカルファイルの内容を TiDB Cloud file system 内のファイルに追記します。
+- `--create-parents`: TiDB Cloud file system からコピーする際に、不足しているローカルの親ディレクトリを作成します。
+- `--description `: `--to-remote` 操作のファイル説明です。
+- `--dry-run`: 変更を適用せずにリクエストを検証します。
+- `--file-system-id `: ファイルシステムを選択します。`TI_FS_FILE_SYSTEM_ID` を設定することもできます。
+- `--from-local `: ローカルのソースパスです。
+- `--from-remote `: TiDB Cloud file system 内のソースパスです。
+- `--from-stdin`: 標準入力から読み取り、`--to-remote` に書き込みます。
+- `--fs-token 
