DeepSeek Harness 原生外掛，新增 `read_document` 工具處理內建 read 工具搞不定的 PDF / DOCX / XLSX 提取。MIT 授權，需要 harness 0.1.3+。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-09-06
授權條款
MIT
01它能幫你完成什麼？
讀取內建 read 工具拒絕的二進位文件（PDF / DOCX / XLSX）
結構化文字提取，外加編碼回退、分頁與依工作表讀取 XLSX 的能力，供模型取用
需要把二進位文件（PDF / DOCX / XLSX）餵給模型取用的 DeepSeek Harness 使用者
從已上傳的活頁簿中讀取指定的某個 Excel 工作表
`list_sheets` 列出工作表，`sheet` 參數整表讀取（無列數上限）；越界時報錯並列出可用工作表
處理表格資料、需要依工作表而非整份檔案讀取的 DeepSeek Harness 使用者
02如何將外掛接入 DeepSeek Harness？
先決條件
- Requires harness ≥ 0.1.3-alpha.1.
安裝步驟
- 01
$ curl -fsSL https://raw.githubusercontent.com/taxueseek/dsh-files/main/install.sh | sh
- 02
# restart dsh web
- 03
$ dsh plugin --profile web add git+https://github.com/taxueseek/dsh-files.git
- 04
# restart dsh web
驗證整合成功
作者未說明
03DSH 整合程度與能力邊界
DeepSeek Harness 原生外掛：提供 `read_document` 工具，補足 harness 0.1.3 內建 read 工具在 PDF / DOCX / XLSX 提取上的空缺，讀取經由 `ctx.fs` 並繼承工作階段沙箱
內容嗅探
已上傳文件的位元組→依據位元組判斷格式（PDF 標頭 / ZIP 成員 / UTF-8 / UTF-16 BOM / GB18030）；偽裝檔案被拒絕
編碼鏈
編碼未知的文本内容位元組→UTF-16 BOM → UTF-8（致命）→ GB18030（致命）→ 無 BOM 的 UTF-16；GBK 與無 BOM UTF-16 均可讀取
分頁讀取
文件控制代碼 + 列偏移/限制→列號 + 偏移/限制；每次呼叫的字符預算隨格式變化，超出則以剩餘列標記截斷
XLSX 依工作表讀取
已上傳的 .xlsx 活頁簿→`list_sheets` 列出工作表；`sheet` 參數整表讀取（無列數上限）；越界時報錯並列出可用工作表
協作式取消
進行中的解析→使用者取消 / 工作階段關閉時立即中止解析
04適合誰？何時不該用？
適合
- 需要把二進位文件（PDF / DOCX / XLSX）餵給模型取用的 DeepSeek Harness 使用者
- 處理表格資料、需要依工作表而非整份檔案讀取的 DeepSeek Harness 使用者
不適合
- 名為 dsh-files 的 npm 套件是一個無關的第三方佔位套件——只能透過官方安裝腳本或 `dsh plugin add` 的 git 指令安裝，切勿執行 `npm install dsh-files`。
05相容性、維護與安全提醒
- 名為 dsh-files 的 npm 套件是一個無關的第三方佔位套件——只能透過官方安裝腳本或 `dsh plugin add` 的 git 指令安裝，切勿執行 `npm install dsh-files`。
- 沒有文字層的 PDF 會回傳明確的提示而非提取出的文字——dsh-files 不會對掃描檔做 OCR。
- 需要 harness ≥ 0.1.3-alpha.1；更早的 harness 版本不被支援。
readme_verified
06常見問題
dsh-files 能做而內建 read 工具做不到的是什麼？
內建 read 工具會以 `FS_NOT_TEXT` 拒絕二進位內容。dsh-files 新增 `read_document` 工具，對 PDF / DOCX / XLSX 做結構化文字提取，並提供編碼回退、分頁與依工作表讀取 XLSX。
怎麼安裝 dsh-files？
執行 `curl -fsSL https://raw.githubusercontent.com/taxueseek/dsh-files/main/install.sh | sh`，或 `dsh plugin --profile web add git+https://github.com/taxueseek/dsh-files.git`，然後重新啟動 dsh web。需要 harness ≥ 0.1.3-alpha.1。
名為 dsh-files 的 npm 套件是同一個外掛嗎？
不是。名為 `dsh-files` 的 npm 套件是一個無關的第三方佔位套件——只能透過官方腳本或上方的 git 指令安裝。
掃描版的 PDF 會怎麼處理？
沒有文字層的 PDF 會回傳明確的提示，而不是空字串。dsh-files 不會對掃描文件做 OCR。
需要哪個 harness 版本？
需要 harness ≥ 0.1.3-alpha.1。
07相關的 DSH 工作流程
dsh-tui
作者 ccch1mneyyy
DSH's officially top-recommended TUI plugin — high performance, low overhead, cute pixel whale, smooth mouse interaction. One-command install via npm. / DSH 官方首推的 TUI 外掛，高效能低佔用，可愛畫素鯨魚，流暢滑鼠互動，npm 一鍵安裝
dsh-better-sidebar
作者 omdsh-dev
開放的側邊欄底座，支援三方拓展註冊新側邊欄頁面。內建檔案渲染編輯/終端/側邊對話/Git/子代理頁面 ｜ Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, side chat, Git, and sub-agent pages.
dsh-tianshu-tui
作者 huiliyi37
官方 DeepSeek Harness 的互動式終端 UI 外掛：自研 ANSI 極簡互動渲染、流式 Markdown/工具卡、16+ 主題、slash 命令與選擇器、輸入歷史與本地偏好持久化、LSP 診斷、memory記憶，很絲滑的開發體驗。
dsh-damage-pulse
作者 wssfk12138
DeepSeek Harness Token 餘額監控外掛：鯨魚娘待機/扣費/復甦動畫、峰谷計費、連續扣費飄字與會話費用統計。
08資料與來源
A DeepSeek Harness plugin that does exactly one thing: the **`read_document` tool** — structured text extraction for bin…
Reads go through `ctx.fs`, inheriting the session sandbox, same rights as the built-in read tool
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生；最後核實於 2026-09-06。發現錯誤？提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛，涵蓋各個分類。