在 DeepSeek Harness 的 Web 界面中開發智能體時，將本地文件內容注入模型上下文通常需要手動複製粘貼或使用額外的工具。dsh-at-file 插件簡化了這一流程，它允許通過 @ 符號在工作區中選擇文件，並將其內容注入提示詞，而無需複製粘貼或額外的工具往返。
功能說明¶
該插件提供以下核心能力：
- 工作區文件引用：在 Web composer 中輸入
@，即可列出當前工作區的文件。 - 過濾候選者：支持按文件名（basename）、路徑前綴或子字符串進行篩選。
- 自動注入：選擇文件後，其內容會被注入到模型上下文中，無需手動複製。
- 日誌記錄：注入的消息會被記錄在會話日誌中，並標記爲
at-file來源，確保輸入可重建。
安裝¶
使用 DeepSeek Harness 的 CLI 安裝插件。插件需要安裝到 web profile：
dsh plugin --profile web add github:MisRightW/dsh-at-file
# 或者從 Git URL 安裝
dsh plugin --profile web add https://github.com/MisRightW/dsh-at-file.git
# 或者從 npm 包安裝
dsh plugin --profile web add dsh-at-file
注意：首次從 GitHub 安裝時，pnpm 會請求允許構建包，請按提示操作。
使用步驟¶
- 在 DeepSeek Harness 的 Web GUI 中打開一個會話，並選擇對應的工作區目錄。
- 在 composer 輸入框中輸入
@。 - 在彈出的文件列表中選擇文件，支持使用 basename（如
@main）、路徑前綴（如@src/m）或子字符串進行過濾，使用箭頭鍵選擇，按 Enter 確認。 - 發送提示詞。所有可解析的
@path令牌會在發送前被展開爲注入的文件內容塊；無法解析或超大的令牌將保持爲普通文本。
配置項¶
Host 端通過 cordis.patch.yml 接受以下配置：
| Key | Default | Meaning |
|---|---|---|
maxFiles |
1000 | 單次列表調用返回的最大索引行數 |
maxDepth |
8 | 目錄索引的最大遍歷深度 |
maxBytes |
65536 | 單個文件注入的字節上限，超過則不索引 |
maxReferences |
8 | 每次預步驟展開的最大引用數 |
skipDirectories |
.git, node_modules, dist, build, out, coverage, __pycache__, .venv |
不會被索引的目錄名（不區分大小寫） |
差異說明¶
該插件與 DeepSeek Harness 倉庫內的樹內實現功能一致，但在 UI 細節上存在差異：
- 草稿芯片：不支持渲染選中的路徑（樹內版本支持）。
- 本地化：菜單組標題顯示爲原始來源名
file，而非本地化文本（樹內版本支持）。 - 權限：插件以當前 DSH 進程的權限運行，請確保安裝前檢查源碼與許可證。
生態與鏈接¶
該插件爲社區貢獻，由開發者 MisRightW 維護，遵循 MIT 許可證。其源碼與文檔位於 GitHub。社區目錄提供了更多插件的發現與集成方式。
