前言¶

在 DSH 的 web 客戶端裏，上傳文檔並讓模型讀取文本，是一個常見需求：需要選擇 PDF、DOCX、XLSX、TXT/MD/代碼文件，看到類似 chat.deepseek.com 的文件卡片，並把提取後的文本隨消息發給模型。

dsh-ds-attach 是 wqx-txdsyl 維護的一個 DeepSeek Harness 插件，提供附件上傳、DS 風格文件卡片、拖拽上傳、文本提取和消息內附件展示。下面介紹它的功能、安裝和配置。

這是什麼¶

dsh-ds-attach 是一個 DeepSeek Harness 插件，復刻 chat.deepseek.com 的附件上傳、DS 風格文件卡片、拖拽上傳和 PDF/DOCX/XLSX/TXT 文本提取/注入消息能力。

維護者爲 wqx-txdsyl，許可證爲 MIT。下面是已覈實的版本與依賴信息：

package.json: 0.1.0
peerDependencies: @deepseek-ai/cordis ^4.0.1
license: MIT

README 稱該插件依賴 pdfjs-dist、mammoth、xlsx，爲純 JS、無原生編譯。

核心功能¶

• 上傳入口：輸入框工具欄左側提供回形針上傳按鈕，可多選任意文檔或圖片；非圖片文件拖到頁面任意位置即上傳。
• 文件卡片：尺寸爲 240×64px，圓角 16px，邊框 1px，包含官方彩色文檔圖標和刪除按鈕。
• 狀態流轉：支持上傳中、解析中、完成、未提取到文本、上傳失敗。
• 文本提取：支持 PDF、DOCX、XLSX、TXT/MD/代碼；默認字符預算爲 15 萬字符，在段落邊界截斷。
• 消息展示：用戶消息中用自定義 user 節點渲染器顯示文件卡片，priority 爲 -1；卡片可顯示文件名、圖標、大小，點擊展開全文。
• 發送後清空：發送消息後，輸入框附件區自動清空。
• 圖片處理：圖片自動走 DSH 原生視覺附件管線。
• 掃描版 PDF：無文字層時自動渲染頁圖並調用視覺模型 OCR。
• 文本注入：提取文本隨消息結構化注入，供模型讀取。

host 側提供以下接口：

/ds-attach/upload
/ds-attach/file
/ds-attach/meta

文件存儲路徑如下：

$DSH_HOME/ds-attach/<sessionId>/

文件按會話隔離，並有路徑穿越防護。

安裝與啓用¶

先從 GitHub 安裝插件：

dsh plugin --profile web add github:wqx-txdsyl/dsh-ds-attach

也可以使用本地絕對路徑安裝：

dsh plugin --profile web add <本目錄絕對路徑>

安裝完成後，重啓 dsh web 使插件生效。

如果安裝插件時提示 allowBuilds，按提示添加即可。

典型用法¶

下面按使用步驟說明。

1、上傳文件：點擊回形針按鈕選擇文檔或圖片；非圖片文件也可以拖到頁面任意位置上傳。

2、查看解析狀態：文件卡片會顯示上傳中、解析中、完成、未提取到文本或上傳失敗。

3、發送消息：附件卡片隨用戶消息展示；輸入框附件區自動清空。

4、掃描版 PDF OCR：需要配置以下任一 key：

DEEPEYE_API_KEY
BOOK_OCR_API_KEY

未配置 key 時，會顯示未提取到文本。

OCR 默認使用智譜 glm-4v-flash，默認 baseUrl 如下：

https://open.bigmodel.cn/api/paas/v4

可調整的配置項如下：

DS_ATTACH_MAX_CHARS
DS_ATTACH_FORCE_OCR=1
DS_ATTACH_TEXTLAYER_ONLY=1
BOOK_OCR_SCALE
BOOK_OCR_CONCURRENCY
BOOK_OCR_CROP_TOP
BOOK_OCR_CROP_BOTTOM
BOOK_OCR_MODEL
BOOK_OCR_BASE_URL
BOOK_OCR_MAX_TOKENS
BOOK_OCR_TIMEOUT_MS

其中，BOOK_OCR_SCALE 默認 3，BOOK_OCR_CONCURRENCY 默認 2，BOOK_OCR_CROP_TOP 默認 0.07，BOOK_OCR_CROP_BOTTOM 默認 0.08；BOOK_OCR_CROP_TOP 和 BOOK_OCR_CROP_BOTTOM 設爲 0 可關閉裁剪。

字符預算可用 DS_ATTACH_MAX_CHARS 調整，默認 15 萬字符。

適用場景與注意¶

適合在 DSH web 客戶端中上傳 PDF、DOCX、XLSX、TXT/MD/代碼文件，並需要把文檔文本提供給模型讀取的場景。

注意以下幾點：

• 插件以當前 dsh 進程權限運行；安裝前應檢查源碼、依賴和許可證。
• 許可證爲 MIT，peerDependencies 爲 @deepseek-ai/cordis ^4.0.1。
• DS_ATTACH_FORCE_OCR=1 會強制 OCR；DS_ATTACH_TEXTLAYER_ONLY=1 會禁用 OCR。
• OCR 依賴 DEEPEYE_API_KEY 或 BOOK_OCR_API_KEY，未配置時無法完成掃描版 PDF 的 OCR。
• 社區目錄應視爲獨立插件目錄，不等同於 DeepSeek 官方應用商店。

鏈接¶

dsh-ds-attach 提供上傳、卡片展示、文本提取和消息注入能力，適合 DSH web 客戶端的文檔附件場景。

GitHub：

https://github.com/wqx-txdsyl/dsh-ds-attach

目錄頁：未提供已覈實 URL。