read - ファイル読み取り

ファイルの内容を読み取ります。テキストファイル、PDF、Office ドキュメント（Word / Excel / PPT）、画像（メタデータを返す）などに対応しています。

依存関係

追加の依存関係は不要で、デフォルトで利用可能です。

パラメータ	型	必須	説明
`path`	string	はい	ファイルパス。相対パスはワークスペースディレクトリを基準とします
`offset`	integer	いいえ	開始行番号（1始まり）。負の値は末尾から数え、`-50` なら最後の50行
`limit`	integer	いいえ	読み取る行数
`pages`	string	いいえ	PDF のみ有効。`3`、`1-5`、`10-` のようなページ範囲。デフォルトは先頭20ページ、1回あたり最大20ページ

各行の先頭に行番号と縦線が付きます。Agent が位置を特定しやすく、search_files の出力とも揃えるためです：

from config import conf

def main():
   print(conf())

行番号は表示用であり、ファイルの内容ではありません。edit で編集する際、oldText / newText に 1| のような接頭辞を含めないでください。含めると拒否されます。

1回の読み取りは 2000 行または 50KB が上限です。超過分は切り詰められ、末尾に offset で続きを読む方法が示されます。

API キーを保管する ~/.cow/.env は本ツールでは読み取れません。env_config ツールをご利用ください。