ja-JP/about_QiitaDrive.help.txt

TOPIC
    about_QiitaDrive
 
SHORT DESCRIPTION
    Qiita API v2 に接続し、記事をファイルシステムとして閲覧する PowerShell プロバイダです。
 
LONG DESCRIPTION
    QiitaDrive は PowerShell の NavigationCmdletProvider を実装し、Qiita の記事をドライブとして
    マウントします。dir, cd, Get-Content などの標準コマンドで記事を閲覧できます。
 
  ドライブのマウント
 
    # OAuth 認証 (ブラウザが開きます)
    New-QiitaDrive
 
    # トークン指定
    New-QiitaDrive -Token $env:QIITA_TOKEN
 
    # Qiita Team
    New-QiitaDrive -Name MyTeam -Team myteamname
 
  フォルダ構造
 
    Qiita:\
    +-- CachedItems\ キャッシュ済みの記事一覧
    +-- ItemDetails\ 記事の詳細情報
    | +-- <記事名>\
    | +-- Comments\ コメント (Get-Content 対応)
    | +-- Likes\ いいねしたユーザー
    | +-- Stockers\ ストックしたユーザー
    +-- LatestItems\ Qiita 全体の新着記事
    +-- Tags\ タグ別の記事を閲覧
    | +-- PowerShell\ タグ内の記事
    +-- Users\ ユーザー別の記事を閲覧
    | +-- ytsuda\ ユーザーの記事
    +-- Search\ 記事を検索
    | +-- query\ 検索結果
    +-- Me\ 自分の記事・ストック・フォロー
    | +-- Items\ 投稿した記事
    | +-- Stocks\ ストックした記事
    | +-- Followers\ フォロワー
    | | +-- ytsuda\ ユーザーの記事
    | +-- FollowingTags\ フォロー中のタグ
    | | +-- Git\ タグ内の記事
    | +-- FollowingUsers\ フォロー中のユーザー
    | +-- ytsuda\ ユーザーの記事
    +-- Team\ チーム管理 (Team 接続時のみ)
        +-- Members\
        +-- Invitations\
        +-- Groups\
        +-- Templates\
 
  dir (Get-ChildItem)
 
    # タグ内の記事一覧 (既定: 20件)
    dir Qiita:\Tags\PowerShell
 
    # 件数指定
    dir Qiita:\Tags\PowerShell -First 50
 
    # ページネーション
    dir Qiita:\Tags\PowerShell -First 20 -Skip 40
 
    # キャッシュを無視して再取得
    dir Qiita:\Tags\PowerShell -Force
 
    # 再帰表示 (フォルダ + 記事)
    dir Qiita:\ -Recurse
 
    -First と -Skip は QiitaDrive 固有の動的パラメータです。
    既定では20件取得します。API の制限により、1回のリクエストで最大100件です。
 
  cd (Set-Location)
 
    # タグフォルダに移動
    cd Qiita:\Tags\PowerShell
 
    # 検索結果に移動 (自動的に検索実行)
    cd Qiita:\Search\PowerShell 入門
 
    # ユーザーの記事に移動
    cd Qiita:\Users\ytsuda
 
    タブ補完が使用できます。Tags フォルダでは人気タグ上位100件が補完候補になります。
 
  Get-Content (記事の本文を読む)
 
    # 記事の本文を表示
    Get-Content Qiita:\Tags\PowerShell\abc1234_Title.md
 
    # パイプラインで利用
    Get-Content Qiita:\Me\Items\abc1234_Title.md | Select-String "pattern"
 
    記事の本文は初回アクセス時に API から取得され、キャッシュされます。
    出力は Markdown 形式で、タイトル・著者・日付・タグのヘッダー付きです。
 
  Copy-QiitaItem (記事をファイルにコピー)
 
    # 1件コピー
    Copy-QiitaItem Qiita:\Me\Items\abc1234_Title.md C:\articles\
 
    # ワイルドカードで一括コピー
    Copy-QiitaItem Qiita:\Tags\PowerShell\*.md C:\temp\
 
    # パターン指定
    Copy-QiitaItem Qiita:\Me\Items\*git*.md C:\articles\
 
    # パイプラインでコピー
    dir Qiita:\Me\Items -First 10 | Copy-QiitaItem -Destination C:\backup\
 
    PowerShell の Copy-Item は異なるプロバイダ間のコピーに対応していないため、
    この関数が代替手段を提供します。
 
  自分の記事をトラックする
 
    # 自分の全記事を一覧(いいね・ストック・PV 付き)
    dir Qiita:\Me\Items -First 100
 
    # いいね数でランキング
    dir Qiita:\Me\Items -First 100 | Sort-Object LikesCount -Descending |
        Select-Object Title, LikesCount, StocksCount, PageViewsCount
 
    # 統計サマリー
    dir Qiita:\Me\Items -First 100 |
        Measure-Object -Property LikesCount, StocksCount, PageViewsCount -Sum -Average
 
    # 記事のパフォーマンスを CSV にエクスポート
    dir Qiita:\Me\Items -First 100 |
        Select-Object Title, LikesCount, StocksCount, PageViewsCount, CommentsCount, CreatedAt |
        Export-Csv -Path my-articles.csv -NoTypeInformation
 
    # 自分の記事をローカルにバックアップ
    cd Qiita:\Me\Items; dir -First 100
    Copy-QiitaItem * C:\backup\qiita\
 
    Me\Items では PageViewsCount(PV 数)が取得でき、Private(限定公開)フラグも確認できます。
 
  フォロー中のユーザー / フォロワーの記事を閲覧する
 
    # フォロー中のユーザー一覧
    dir Qiita:\Me\FollowingUsers
 
    # フォロワー一覧
    dir Qiita:\Me\Followers
 
    # 特定ユーザーの記事
    dir Qiita:\Me\FollowingUsers\someone
 
    # フォロー中ユーザーの記事をまとめてコピー
    dir Qiita:\Me\FollowingUsers\someone | Copy-QiitaItem -Destination C:\articles\
 
  Invoke-Item (既定のアプリで開く)
 
    # 記事を一時ファイルとして保存し、既定のアプリで開く
    ii Qiita:\Tags\PowerShell\abc1234_Title.md
 
    # フォルダの場合は Qiita Web ページをブラウザで開く
    ii Qiita:\Tags\PowerShell
 
  Get-QiitaItem (URL/ID で記事を取得)
 
    # URL で記事を取得 (Body 含む QiitaItem)
    Get-QiitaItem https://qiita.com/ytsuda/items/1c6bf5d89a0b4e...
 
    # 短縮 ID で取得 (キャッシュ内のみ)
    Get-QiitaItem 1c6bf5d
 
    # パイプラインで複数
    "id1", "id2" | Get-QiitaItem
 
  Resolve-QiitaPath (URL/ID をプロバイダパスに変換)
 
    # URL → プロバイダパス
    Resolve-QiitaPath https://qiita.com/ytsuda/items/1c6bf5d89a0b4e...
 
    # パイプラインで Get-Content に渡す
    Resolve-QiitaPath https://qiita.com/... | Get-Content
 
  Search-QiitaContent (キャッシュ済み記事の本文を検索)
 
    # キャッシュ済み記事から正規表現で検索
    Search-QiitaContent "PowerShell"
 
    # 特定パス内を検索
    Search-QiitaContent "pattern" -Path Qiita:\Tags\PowerShell
 
  Open-QiitaPage (Qiita Web ページを開く)
 
    # 記事ページを開く
    Open-QiitaPage Qiita:\Tags\PowerShell\abc1234_Title.md
 
    # パイプラインから
    dir Qiita:\Me\Items | Select-Object -First 1 | Open-QiitaPage
 
  Remove-Item (キャッシュの削除)
 
    # 検索クエリのキャッシュを削除
    Remove-Item Qiita:\Search\古いクエリ
 
    # タグフォルダのキャッシュを削除
    Remove-Item Qiita:\Tags\PowerShell
 
    # ワイルドカードで一括削除
    cd Qiita:\Tags; Remove-Item *
 
    QiitaDrive は読み取り専用です。
    Remove-Item は Tags, Users, Search, ItemDetails フォルダのキャッシュ削除に対応しています。
 
  キャッシュの動作
 
    QiitaDrive はインメモリキャッシュを使用します。
 
    - 記事メタデータ: dir 実行時に自動キャッシュ
    - 記事本文: Get-Content 実行時に自動キャッシュ
    - タグメタデータ: タグフォルダへの初回アクセス時にキャッシュ
    - キャッシュに TTL はありません
    - dir -Force でフォルダ単位のキャッシュを再取得
    - Clear-QiitaCache で明示的にクリア
 
  記事のファイル名
 
    記事は {短縮ID}_{タイトル}.md の形式で表示されます。
 
        c3f4_MCP 時代の到来とアプリ開発の新常識.md
 
    短縮 ID は Git と同様のアルゴリズムで、キャッシュ内の全記事で一意になる
    最短長 (既定4文字) が自動計算されます。
 
SEE ALSO
    New-QiitaDrive
    Get-QiitaItem
    Resolve-QiitaPath
    Copy-QiitaItem
    Search-QiitaContent
    Open-QiitaPage
    Clear-QiitaCache