為 dsh Web 提供 Codex 風格 @file 參照的原生外掛：在對話框輸入 `@` 即可插入工作區相對的檔案 / 目錄路徑參照，無須貼上檔案內容。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-08-22
授權條款
MIT
01它能幫你完成什麼？
在 DeepSeek Harness Web 對話框中透過路徑參照工作區檔案
輸入 `@` 開啟工作區路徑選擇器，搜尋目前工作區並插入工作區相對路徑的檔案 / 目錄參照標記——Codex 風格的 @file 參照，無須貼上檔案內容
希望在 dsh Web 中按路徑指向檔案、而非把完整內容貼進提示詞的 DeepSeek Harness 使用者
指向檔案但把檔案內容擋在提示詞之外
外掛只插入 `<workspace-reference path=… kind=… />` 標記；它不會開啟檔案，也不會列出目錄內容，且只解析位於目前工作區內部的路徑
想要輕量檔案指標、同時讓 Agent 的實際讀取仍由其自身會話工具控制的團隊
02如何將外掛接入 DeepSeek Harness？
先決條件
- 已啟用 Web 介面（`dsh web`）及 Web 設定檔的 DeepSeek Harness
- 在 dsh Web 用戶端中已開啟、需要使用 @file 參照的某個工作區
安裝步驟
- 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=… />` 標記；任務需要時，Agent 可用自身會話工具檢查該路徑
不會開啟被參照檔案，也不會列出目錄內容檔案過濾器與選擇器設定
設定 → 檔案參照規則（全域 / 工作區、精確 / 正則、區分大小寫）與 `cordis.patch.yml` 選項→透過 `maxIndexedFiles` 與 `ignoreDirs` 得到受限的選擇器索引；變更會清空受影響範圍的索引快取，下一次 `@` 搜尋即使用已儲存規則
變更時清空受影響範圍的索引快取
04適合誰？何時不該用？
適合
- 希望在 dsh Web 中按路徑指向檔案、而非把完整內容貼進提示詞的 DeepSeek Harness 使用者
- 想要輕量檔案指標、同時讓 Agent 的實際讀取仍由其自身會話工具控制的團隊
05相容性、維護與安全提醒
- 需要 DeepSeek Harness 的 Web 介面（`dsh web`）及 Web 設定檔；外掛透過 `dsh plugin --profile web add …` 加入，且必須重啟 `dsh web`，Host 與瀏覽器用戶端才會載入新版本。
- 只接受工作區相對路徑；絕對路徑與逃逸出工作區的路徑會被忽略。外掛絕不讀取檔案內容——它只插入純路徑參照，因此實際檔案讀取仍由 Agent 自身的會話工具完成。預設忽略貼上的 `@` 標記。
- 路徑參照機制適用於 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=… />`）。它不會開啟檔案，也不會列出目錄內容；任務需要時，Agent 之後透過其自身會話工具讀取該路徑。
怎麼控制選擇器裡出現哪些檔案？
開啟 設定 → 檔案參照，加入全域與工作區規則（精確名稱或正則，可任選區分大小寫）。也可在 `~/.dsh/profiles/web/cordis.patch.yml` 中設定 `maxIndexedFiles` 與 `ignoreDirs`。
支援哪些 DeepSeek Harness 版本？
路徑參照機制適用於 0.3.0 及之後版本。更早版本會在送出時讀取檔案內容並強制檔案大小限制，因此舊安裝的行為不同。
07相關的 DSH 工作流程
petdex
作者 crafter-station
面向 Codex、Claude Code、DeepSeek Harness 等智慧體的動效寵物公共相簿。
dsh-deep-whale
作者 small-tailqwq
Whale Girl skin series for DeepSeek Harness. 適用於 DeepSeek Harness 的，鯨魚娘系列皮膚。
awesome-dsh-plugin
作者 anil-matcha
DeepSeek Harness 外掛生態精選列表，彙集優質外掛、工具與資源。
working-activity
作者 ccch1mneyyy
為 pi CLI 與 DSH 打造的生動工作狀態行擴充套件。
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。發現錯誤？提交更正。