前言¶
DSH（DeepSeek Harness）的設計理念是「一切皆插件」，但在 DSH Desktop 桌面客戶端的原生實現中，文件上傳能力僅限於圖片。當需要 Agent 讀取文檔（如 docx、xlsx、pdf）時，官方的 Files API 僅支持 JPEG/PNG 等圖片格式，無法直接發送非圖片文件。dsh-periscope 通過直接修改 DSH 核心文件，補全了這一能力，支持拖入或粘貼任意文件，並讓 Agent 通過路徑讀取來處理這些文件。
它是什麼¶
dsh-periscope 是一個爲 DSH Desktop 提供通用文件附件能力的插件。它通過修改核心的 app.asar 文件，擴展了文件類型校驗與存儲邏輯。項目由 lmh-2026 維護，採用 MIT 許可證。
核心功能¶
- 通用文件附件：支持拖入或粘貼任意類型的文件（包括 docx、xlsx、pdf、txt、zip 等），不再侷限於圖片。
- 文件類型圖標：附件卡片會根據文件擴展名顯示彩色類型方塊，便於快速識別。
- 持久化落盤：文件保存到本地路徑
~/.dsh/attachments/v1/files/，會話歷史中會保留附件塊與完整的絕對路徑。 - 核心補丁：通過注入補丁文件到 DSH 核心包中，實現文件上傳邏輯的擴展。
安裝與啓用¶
本插件僅適配 Windows 平臺上的 DSH Desktop 客戶端，且依賴 Node.js 22+ 環境。
- 完全退出 DSH Desktop。
- 進入插件倉庫目錄，運行以下命令以繞過 PowerShell 執行策略限制並執行安裝腳本：
Set-ExecutionPolicy -Scope Process Bypass -Force
.\install.ps1
或者通過 npm 全局安裝後運行安裝器：
npm install dsh-periscope
npx dsh-periscope-install
安裝腳本會自動備份 app.asar，執行原位重打包，並校驗安裝結果。安裝完成後重新打開 DSH 即可生效。
典型用法¶
安裝完成後，在 DSH Desktop 的對話窗口中：
- 直接將任意文件（如
.docx或.pdf）拖入或粘貼到輸入框。 - 系統會生成帶類型圖標的附件卡片。
- 發送消息後，Agent 會通過路徑讀取該文件，並基於文件內容進行後續處理。
適用場景與注意¶
- 平臺限制：僅支持 Windows + DSH Desktop 客戶端形態，不支持 Web 版、CLI 或源碼形態。
- 權限要求：需要手動退出 DSH Desktop 進程才能運行安裝腳本。
- 升級維護：DSH 每次升級都會重新打包
app.asar，導致插件失效。每次升級後必須重新運行安裝腳本。 - 非官方行爲：插件通過直接修改核心文件實現，屬於非官方行爲，請自行評估風險。
結語¶
dsh-periscope 解決了 DSH Desktop 在文檔處理上的短板，通過路徑式消費讓 Agent 能夠像 Codex 一樣處理本地文件。對於需要在本地環境中開發或測試 Agent 的用戶，這是一個必要的工具。更多細節與源碼請訪問項目目錄頁或 GitHub 倉庫。
