jimmynorman/office-suite-dsh

🌟 Office Suíte DSH

面向 DeepSeek Harness (DSH) 的专业插件
处理办公文件：PDF、Word、Excel、PowerPoint——读取、创建、修改、转换。

Node.js >=18
DSH Plugin
License MIT
[Status]()

📋 这是什么？

Office Suíte DSH 是一个面向 DSH 的集成插件，提供 16 个专业工具 用于处理办公文档。它不是一个外部查看器：它是你 DSH 环境中的原生组成部分。

🎯 工作理念

graph LR
A[用户输入命令] --> B{DSH 识别文件？PDF/Word/Excel/PowerPoint}
B -->|是| C[插件自动处理]
B -->|否| D[手动工具可用]
C --> E[结果集成到对话中]
D --> E

✨ 可视化特性

| 图标 | 功能 | 描述 |
|:-----:|:-------:|:-----------|
| 📄 | PDF | 读取内容、创建新文件、修改、合并、提取页面 |
| 📝 | Word | 读取 DOCX、创建带格式文档、修改、转换为 HTML/文本 |
| 📊 | Excel | 读取 XLSX、创建工作表、修改数据、转换 CSV |
| 🎯 | PowerPoint | 创建演示文稿、模板、演讲者备注 |

⚙️ 配置

你可以在 dsh.config.yml 中配置该插件：

plugins:
dsh-tool-office:
enabled: true        # 启用/禁用工具
safePaths: true      # 将路径限制在工作区（安全）
workspaceDir: "."    # 允许的根目录

🛡️ 安全说明

- Excel 依赖（xlsx）：该插件使用 sheetjs/xlsx 库，该库存在一个已知的 原型污染 漏洞（GHSA-4r6h-8v6p-xvw6）。只有在你打开来自不可信来源的 Excel 文件时，这才会构成风险。 对于使用你自己文件的典型场景，风险可以忽略不计。
- 路径访问：默认情况下，该插件以运行 DSH 的用户的权限运行。你可以在配置中启用 safePaths 模式，将操作限制在特定目录内。
- 本地隐私：所有读取、创建和转换操作均 100% 在本地 执行。任何数据都不会发送到外部服务器。

🚀 快速安装（1 条命令）

从任何已安装 DSH 的目录
node install-global.js

或使用 npm
npm run install-global

预期结果

✅ DSH 已找到：C:\Users\...\.dsh
✅ 插件已全局安装
✅ 配置已更新（dsh.config.yml）
✅ 依赖已安装（108 个包）
✅ 16 个工具可用

🛠️ 16 个工具

read_pdf            → 读取 PDF
create_pdf          → 创建 PDF
modify_pdf          → 修改 PDF
merge_pdfs          → 合并 PDF
extract_pdf_pages   → 提取页面

read_word           → 读取 Word
create_word         → 创建 DOCX
modify_word         → 修改 DOCX
word_to_text        → DOCX → TXT
word_to_html        → DOCX → HTML

read_excel          → 读取 XLSX → JSON
create_excel        → 创建 XLSX
modify_excel        → 修改 XLSX
excel_to_csv        → XLSX → CSV
csv_to_excel        → CSV → XLSX
read_excel_cell     → 读取特定单元格
get_excel_stats     → Excel 统计信息

create_powerpoint           → 完整 PPTX
create_simple_powerpoint    → 简单 PPTX
create_powerpoint_from_template → 模板
get_powerpoint_info         → 功能信息

💡 快速示例
javascript
// 在 DSH 控制台中
await tools.execute('create_pdf', {
file_path: './informe.pdf',
title: 'Informe Mensual',
content: 'Contenido del informe...',
author: 'Equipo DSH'
});

🔗 插件工作流
mermaid
flowchart TD
A[用户] -->|输入命令或拖拽文件| B{DSH 检测到文件？}
B -->|PDF/DOCX/XLSX/PPTX| C[插件自动处理]
B -->|不是文件| D[通过 tools.execute 手动调用工具]
C --> E[结果集成到对话中]
D --> E
E --> F[用户继续工作]

📁 项目结构

office-suite-dsh/
├── src/
│   ├── index.js              → 主插件（620 行，16 个工具）
│   ├── pdf-tools.js          → PDF 读取/创建/修改
│   ├── word-tools.js         → DOCX：读取、创建、转换
│   ├── excel-tools.js        → XLSX：读取、创建、统计
│   └── powerpoint-tools.js   → PPTX：创建、模板
├── tests/
│   └── basic-tests.js        → 自动化测试套件
├── install-global.js         → 自动安装程序（单条命令）
├── install.js                → 本地安装程序
├── examples.js               → 12 个实用示例
└── package.json

🧪 包含的测试

运行：npm test 或 node tests/basic-tests.js

- ✅ 创建/读取 PDF
- ✅ 创建/读取 Word
- ✅ 创建/读取/修改 Excel
- ✅ 创建 PowerPoint
- ✅ 转换格式（Word↔HTML、Excel↔CSV）

📝 更新日志

查看 CHANGELOG.md 获取完整历史记录。

🔗 链接

- 插件： C:\Users\User\.dsh\plugins\dsh-tool-office
- 配置： D:\Documents\GitHub\Pruebas\dsh.config.yml
- 安装程序： node install-global.js