dsh-at-fileA77
@omdsh-devDSH の入力欄で @ を打つと現在のワークスペースを検索し、ファイルやディレクトリのパスを挿入できる。プラグインが渡すのはパスのみで内容は読まず、開くかどうかは agent が判断する。
dsh plugin --profile web add github:omdsh-dev/dsh-at-file
作者が npm に公開していないため、このコマンドは git のソースを取得します。pnpm ≥ 10 は git 依存の prepare スクリプトを明示的な許可なしには実行しないので、初回インストールにはその profile の pnpm-workspace.yaml に allowBuilds の記述が必要です——これはこのパッケージのコードを自分のマシンで実行させることを意味します。あわせて #commit で固定することを勧めます。
--profile の後ろは自分で付ける profile 名です。使っているものに置き換えてください。
入力欄で @ を打つとピッカーが開き、一致したファイルやディレクトリのパスがそのまま下書きに入ります。選んだパスは参照バーに残り、開くことも削除することもできます。設計上の要となる判断は 0.3.0 で入りました:agent がステップを開始する前に、そのパスが現在のワークスペース内に実在するかを確認し、短い参照メッセージ(ワークスペース相対パスと種別を持つ workspace-reference)だけを追加します。参照先のファイルを開くことも、参照先ディレクトリの中身を列挙することもしません——見るかどうか、どのツールで見るかは、タスクに応じて agent が決めます。したがってファイル形式やサイズはこの経路に影響せず、PDF も他のワークスペースファイルとまったく同じパス参照フローを通ります。提出時に内容を読み、サイズ制限を課していたのは初期リリースだけです。
- ▸渡すのはパスで内容ではない:0.3.0 以降は workspace-reference メッセージを追加し、読むかどうかは agent が判断
- ▸そのため形式もサイズも無関係。PDF も他のファイルと同じフローを通る
- ▸完全一致・前方一致・コンパクト一致を上位に、/ を含む問い合わせはパスセグメント順で一致。→ キーでディレクトリに入れ、既定の索引は VCS・IDE メタデータ・依存ツリー・キャッシュ・ビルド成果物を除外
Codex 风格 @ 文件引用,行为边界写得清楚(只传路径不读内容),工程干净
README に貼るとこのページにリンクします。
