前言¶
DeepSeek Harness (DSH) 採用插件化架構，文檔處理是智能體開發中的常見需求。傳統方式往往依賴模擬鼠標鍵盤操作，效率低且不可靠。dsh-r7-office 旨在解決這一問題，它作爲 DeepSeek Harness 插件或獨立 MCP 服務器，通過操作 OOXML 原始數據和調用本地 R7-Office 引擎，實現對 DOCX、XLSX、PPTX 和 PDF 文檔的讀寫、編輯和轉換。
插件概覽¶
- 名稱：dsh-r7-office
- 維護者：blazar-source
- 定位：R7-Office 文檔處理插件與 MCP 服務器
- 許可證：MIT
核心功能¶
- 格式保留編輯：在進行替換或編輯時，保持原始 XML 樣式、字體、顏色和編號層級。未涉及的部分會逐字節保留。
- 全格式支持：支持 DOCX、XLSX、PPTX 和 PDF。
- 內置驗證：提供
r7_validate功能，用於在變更前後檢查包的完整性。 - 雙模式運行：可作爲 DeepSeek Harness 插件，或作爲獨立的 MCP 服務器運行。
- 可選實時桌面橋接：通過 WebSocket 連接 R7-Office Desktop，對用戶已打開的文檔進行實時驅動（僅 Windows 驗證）。
安裝與配置¶
環境要求¶
- Node.js >= 20.0.0
安裝爲 DeepSeek Harness 插件¶
將插件目錄作爲 Bundle 安裝到 Harness 中：
dsh plugin --profile <profile> add /absolute/path/to/dsh-r7-office
激活成功後，系統會註冊相應的工具（如 r7_inspect, r7_read 等）並開啓可選的桌面橋接端口。
作爲獨立 MCP 服務器運行¶
插件支持標準輸入輸出 (stdio) 的 MCP 協議。
啓動服務：
npm start
或手動測試 MCP 服務器：
echo '{"rpc":"2.0","id":1,"method":"tools/list"}' | node src/mcp/cli.js
典型用法¶
插件包含多套測試用例，可用於驗證安裝與功能：
npm test：便攜式測試套件（不依賴 R7-Office）。npm run test:r7：R7 依賴測試（需要安裝 R7-Office）。npm run test:live：R7-Office 文件管道測試。npm run test:harness：DeepSeek Harness 插件激活測試。
注意事項¶
- 非官方項目：這是一個社區維護的項目，與 АО «Р7» (R7-Office) 或 DeepSeek 無關。
- 自行安裝 R7-Office：插件不包含 R7-Office 的代碼或二進制文件，必須自行安裝並獲取許可。
- 權限與安全：插件以當前 DSH 進程的權限運行，請確保安裝前檢查源碼與許可證。
- 桌面橋接限制：實時桌面橋接功能僅在 Windows 上經過驗證。
總結¶
dsh-r7-office 爲 DeepSeek Harness 提供了標準化的文檔處理能力，適合需要精細控制文檔格式（如保留樣式、編號層級）的場景。通過 MCP 協議，它也能被其他 AI 智能體客戶端調用。
