Codex 風の @file メンションを dsh Web に提供するネイティブプラグイン：コンポーザで `@` を入力するだけで、ファイル内容を貼らずにワークスペース相対のファイル／ディレクトリ・パス参照を挿入できます。
DSH 統合
ネイティブ実行
作者による申告
安全性監査
未監査
最終検証日
2026-08-22
ライセンス
MIT
01どんなタスクに使えるのか？
DeepSeek Harness Web のコンポーザからワークスペースのファイルをパスで参照する
`@` を入力するとワークスペース・パスピッカーが開き、現在のワークスペースを検索してワークスペース相対のファイル／ディレクトリ・パスを参照マーカーとして挿入します——ファイル内容を貼り付けずに済む Codex 風の @file メンションです
ファイル全体をプロンプトに貼る代わりに、パスでエージェントにファイルを指し示したい DeepSeek Harness Web 利用者
ファイルを指し示しつつ、ファイル内容はプロンプトの外に保つ
プラグインは `<workspace-reference path=… kind=… />` マーカーだけを挿入します。ファイルを開いたりディレクトリ内容を列挙したりせず、アクティブなワークスペース内にあるパスだけを解決します
軽量なファイル・ポインタが欲しいが、実際の読み取りはエージェント自身のセッションツールに任せたいチーム
02DeepSeek Harness への導入方法
前提条件
- Web インターフェース（`dsh web`）と Web プロファイルを備えた DeepSeek Harness
- @file メンションを使いたいワークスペースが dsh Web クライアントで開かれていること
インストール手順
- 01
Web プロファイルに追加します（README はアーカイブ URL を記載；リポジトリは現在 `fsmargoo` 配下で公開）：`dsh plugin --profile web add https://github.com/omdsh-dev/dsh-at-file/archive/refs/tags/v0.6.7.tar.gz`
$ dsh plugin --profile web add https://github.com/omdsh-dev/dsh-at-file/archive/refs/tags/v0.6.7.tar.gz
- 02
`dsh web` を再起動し、Host とブラウザクライアントがバージョン `0.6.7` を読み込むようにします
$ dsh web
- 03
（任意）`~/.dsh/profiles/web/cordis.patch.yml` でピッカーを設定します（例：`maxIndexedFiles: 10000`）、その後プロファイルを再読み込み
導入成功の確認
- `dsh web` 再起動後、コンポーザを開いて `@` を入力するとワークスペース・パスピッカーが表示され、ファイル／ディレクトリの参照を挿入できます
03DSH 統合と能力の範囲
DeepSeek Harness（dsh）のネイティブな Web プラグインです。`dsh plugin --profile web add …` で Web プロファイルにインストールし、dsh Web のコンポーザで `@` を入力するとワークスペース・パスピッカーが開き、ファイル／ディレクトリの参照を挿入できます。dsh Host（独自の Host 接続）に接続し、設定は `~/.dsh/profiles/web/cordis.patch.yml` から読み込みます。
@ パスピッカー
dsh Web コンポーザで `@` の後に入力されるクエリ→ランク付けされたワークスペースのファイル／ディレクトリ結果（ファイル名一致、`/` によるパスセグメント一致、ArrowRight でのディレクトリ掘り下げ）、ワークスペース相対パスを挿入
workspace-reference マーカー
ピッカーで選択されたファイルまたはディレクトリ→ドラフトに残る `<workspace-reference path=… kind=… />` マーカー。必要に応じてエージェントは自身のセッションツールでそのパスを確認できます
参照ファイルを開いたり、ディレクトリ内容を列挙したりしませんファイルフィルタとピッカー設定
設定 → ファイルメンションのルール（グローバル／ワークスペース、Exact／ Regex、大文字小文字区別）と `cordis.patch.yml` のオプション→`maxIndexedFiles` と `ignoreDirs` による絞り込み済みピッカー索引。変更時は該当スコープの索引キャッシュをクリアし、次回の `@` 検索から保存済みルールが使われます
変更時に該当スコープの索引キャッシュをクリアします
04誰に向いているのか？使うべきでない場面は？
向いている用途
- ファイル全体をプロンプトに貼る代わりに、パスでエージェントにファイルを指し示したい DeepSeek Harness Web 利用者
- 軽量なファイル・ポインタが欲しいが、実際の読み取りはエージェント自身のセッションツールに任せたいチーム
05互換性・メンテナンス・セキュリティ上の注意
- DeepSeek Harness の Web インターフェース（`dsh web`）と Web プロファイルが必要です。プラグインは `dsh plugin --profile web add …` で追加し、`dsh web` の再起動によって Host とブラウザクライアントが新バージョンを読み込みます。
- ワークスペース相対パスのみを受け付けます。絶対パスやワークスペース外へ抜けるパスは無視されます。プラグインがファイル内容を読むことはありません——パスのみの参照を挿入するため、実際の読み取りはエージェント自身のセッションツールに委ねられます。貼り付けられた `@` トークンは既定で無視されます。
- パス参照の仕組みはバージョン 0.3.0 以降に適用されます。それ以前のリリースは送信時にファイル内容を読み取り、ファイルサイズ制限を課していました。そのため古いインストールでは挙動が異なります。
MIT・活発にメンテナンス中（最新リリース v0.6.7、2026-08-20）
06よくある質問
dsh-at-file を DeepSeek Harness にインストールするには？
`dsh plugin --profile web add …` で Web プロファイルに追加します（README は v0.6.7 のアーカイブ URL を記載）。その後 `dsh web` を再起動すると Host とブラウザクライアントが新バージョンを読み込みます。`lib/` 配下のビルド成果物はコミットされているため、ビルド手順は不要です。
`@` を入力すると何が起きますか？
dsh Web コンポーザ内にワークスペース・パスピッカーが開きます。ファイル名で検索したり、`/`（例：`src/view`）でパスセグメントを一致させたり、ArrowRight でディレクトリに入ったりして、ファイルやディレクトリの参照をドラフトに挿入できます。
プラグインはファイル内容を読み取ったり露出したりしますか？
いいえ。ワークスペース相対パスの参照（`<workspace-reference path=… kind=… />`）だけを挿入します。ファイルを開いたりディレクトリ内容を列挙したりせず、必要に応じてエージェントが後から自身のセッションツールでそのパスを読み取ります。
ピッカーにどのファイルが表示されるかを制御するには？
設定 → ファイルメンションを開き、グローバルとワークスペースのルール（Exact 名／ Regex、大文字小文字の区別は任意）を追加します。`~/.dsh/profiles/web/cordis.patch.yml` で `maxIndexedFiles` と `ignoreDirs` を設定することもできます。
対応している DeepSeek Harness のバージョンは？
パス参照の仕組みはバージョン 0.3.0 以降に適用されます。それ以前のリリースは送信時にファイル内容を読み取りサイズ制限を課していたため、古いインストールでは挙動が異なります。
07関連する DSH ワークフロー
petdex
by crafter-station
Claude Code、DeepSeek Harness、Gemini CLI などで使えるアニメーションペットの公開ギャラリー
dsh-deep-whale
by small-tailqwq
DSH Web GUI 用の鯨っ娘テーマスキン（深海メイド工房 maid-atelier、ライト/ダーク両モード対応、CC BY-NC-SA 4.0）
awesome-dsh-plugin
by anil-matcha
DeepSeek Harness（dsh）エコシステム向け厳選プラグインリスト
working-activity
by ccch1mneyyy
pi CLI と DSH 向けの動きのある Working-line 拡張
08データと出典
Workspace path references for the DeepSeek Harness web interface. Type `@` in the composer to search the current workspa…
dsh plugin --profile web add https://github.com/omdsh-dev/dsh-at-file/archive/refs/tags/v0.6.7.tar.gz
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日：2026-08-22。誤りを見つけた場合は、修正を送信してください。