前言¶
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 智能体客户端调用。
