dsh-plugin-doc-forge
Manifest validDocument Forge para DeepSeek Harness: toolkit de PDFs y Office por lotes (unir, dividir, rotar, imagenes a PDF, extraer texto y Office a PDF) con rutas permitidas y sin sobrescribir originales.
dsh-plugin-doc-forge — Document Forge
Toolkit de documentos por lotes para DeepSeek Harness: une, divide, rota e importa PDFs y convierte documentos de Office a PDF, con rutas permitidas, sin sobrescribir originales y con auditoría. Expone las tools como mcp__docs__*.
English · Cómo funciona · MIT
Herramientas (7)
| Tool | Qué hace |
|---|---|
mcp__docs__status | Binarios detectados (pdftotext, LibreOffice), rutas permitidas, salida, modo y límites. |
mcp__docs__pdf_merge | Une 2+ PDFs en uno, respetando el orden de los archivos. |
mcp__docs__pdf_split | Divide por rangos ("1-3,4-6") o en una página por archivo. |
mcp__docs__pdf_rotate | Rota 90/180/270° las páginas indicadas (o todas) sin tocar el original. |
mcp__docs__images_to_pdf | Convierte PNG/JPG en un PDF: página ajustada, A4 o Letter. |
mcp__docs__pdf_extract_text | Extrae texto con pdftotext local (inline o a .txt). Sin OCR. |
mcp__docs__office_to_pdf | Convierte DOCX/XLSX/PPTX/ODT/ODS/ODP a PDF con LibreOffice local. |
pdf_merge, pdf_split, pdf_rotate, images_to_pdf funcionan sin binarios externos: el motor PDF va incluido en el bundle.
Requisitos
- Node ≥ 20 (lo aporta el harness).
- Nada obligatorio extra para las operaciones de PDF.
- Opcional para
pdf_extract_text:pdftotext(poppler/xpdf). En Windows, Git for Windows lo trae enC:\Program Files\Git\mingw64\biny el plugin lo autodetecta; también puedes instalarlo conwinget install oschwartz10612.Popplero apuntarDSH_DOCS_PDFTOTEXT. - Opcional para
office_to_pdf: LibreOffice. Instálalo conwinget install TheDocumentFoundation.LibreOfficeo defineDSH_DOCS_SOFFICE. Si falta,statuslo indica y la tool devuelve un error con instrucciones.
Configuración
Archivo: <DSH_HOME>\doc-forge\config.json (el postinstall lo crea con allowedPaths = tu perfil).
{
"allowedPaths": ["C:\\Users\\tu-usuario"],
"sofficePath": "",
"pdftotextPath": "",
"note": "Las rutas vacías se autodetectan."
}
allowedPaths: carpetas desde las que se puede leer y escribir. Las salidas por defecto van a<DSH_HOME>\cache\doc-forge.sofficePath/pdftotextPath: ruta explícita al binario (vacío = autodetección).rateLimitPerMinute: opcional, límite de escrituras por minuto (por defecto 12).
Variables de entorno: DSH_DOCS_MODE=read-only, DSH_DOCS_SOFFICE, DSH_DOCS_PDFTOTEXT.
Ejemplos de pedidos
- «Une estos tres PDFs en uno y guárdalo en el escritorio.»
- «Divide el PDF en una página por archivo.»
- «Saca solo las páginas 1-3 y 7 en un PDF nuevo.»
- «Rota la página 2 noventa grados.»
- «Pasa estas fotos a un solo PDF en A4.»
- «Extrae el texto del contrato y resúmelo.»
- «Convierte este DOCX a PDF.»
Seguridad
- Rutas permitidas (
allowedPaths): no lee ni escribe fuera de ellas. - Nunca sobrescribe: la salida jamás puede ser una entrada y si el destino existe se crea un nombre único (
-1,-2…). - Escritura con confirmación:
pdf_merge,pdf_split,pdf_rotate,images_to_pdf,office_to_pdfypdf_extract_textconoutputexigenconfirm:truey pedido explícito del usuario. - Modo read-only (
DSH_DOCS_MODE=read-only): solo status y extracción de texto en memoria. - Límites: 200 MB por archivo, 400 MB por lote, 5.000 páginas, 200 archivos por división, 60 s por operación (timeout cooperativo), 12 escrituras/minuto.
- Auditoría en
<DSH_HOME>\cache\doc-forge\audit.jsonl(operaciones y fallos). - Sin comandos arbitrarios: los argumentos de los binarios se construyen desde parámetros validados.
Instalación
Desde DSH → Settings → Plugins instala github:thegabopacheco-sudo/dsh-plugin-doc-forge y permite el script de instalación.
dsh plugin --profile <perfil> add github:thegabopacheco-sudo/dsh-plugin-doc-forge
El postinstall copia el runtime a <DSH_HOME>\plugins\doc-forge y crea la config base.
Verificación
node --check server.mjs
npm run build:bundle
node test/connect-test.mjs
powershell -NoProfile -ExecutionPolicy Bypass -File ..\tools\verify-artifact.ps1 -Slug doc-forge -ServerVar DOCS_SERVER
Los tests generan PDFs (pdf-lib), imágenes (Pillow o ffmpeg) y un DOCX (python-docx) locales, y verifican merge/split/rotate/imágenes/texto, seguridad de rutas, confirmación, read-only y auditoría. No usan red.
Licencia
MIT © thegabopacheco-sudo
Comments
Loading…
Similar plugins
by jetformat
DeepSeek Harness plugin for Jetformat: Office to PDF and PDF tools via the local CLI
★ 2
MIT
TypeScript
Sep 27, 2026
dsh plugin --profile web add @jetformat/dsh-pluginby zhtx2024
PDF parsing toolkit for DeepSeek Harness: pdf_info, pdf_extract_text, pdf_render_page with hybrid pdfjs/built-in engines and system-font rendering for non-embedded CJK PDFs.
★ 10
↓ 734/wk
MIT
JavaScript
Aug 20, 2026
dsh plugin --profile web add @zhtx2026/dsh-pdfby bauerelizabeth07139
DeepSeek Harness plugin: convert Word .docx to PDF with the dxpdf Rust/Skia engine — no Microsoft Office, no LibreOffice, no network. It repairs the schema-invalid constructs WPS Office writes and restores Word's odd/even page parity.
★ 0
MIT
JavaScript
Oct 6, 2026
dsh plugin --profile web add dsh-plugin-dxpdfby Z8906
读取 Office / PDF 前先转成 Markdown,用一行路径代替整份全文 —— 省 token 的 DSH bundle 插件。0 npm 依赖,转换全在本地,产物归你所有,卸载自动清理 Python 环境。 Convert Office/PDF to Markdown before reading in DeepSeek Harness — one path instead of the whole document.
★ 1
MIT
JavaScript
Nov 8, 2026
dsh plugin --profile web add dsh-plugin-office-markdownby zhangjiabo522
DeepSeek Harness 文档工具插件:read/create/edit PDF/DOCX/XLSX/PPTX/CSV/Markdown(read_document、create_document、edit_document)
★ 0
MIT
TypeScript
Aug 15, 2026
dsh plugin --profile web add @deepseek-ai/dsh-tool-docby Sqhao-O
Fully local document intelligence for DeepSeek Harness. Parse PDF, Office files, images, and scanned documents with offline OCR. | DeepSeek Harness 全本地文档智能插件,支持 PDF、Office、图片与离线 OCR
★ 15
↓ 220/wk
MIT
TypeScript
Nov 6, 2026
dsh plugin --profile web add dsh-doc