file_translator

File Translator Plugin

Translate common Office documents inside Dify while keeping layout, fonts, and basic styling intact.

Overview

Field	Value
Author	xuyangyang
Version	0.0.1
Plugin Type	Tool Provider
Supported UI	Apps, Workflows, Agents

The plugin wraps several file translators (TXT / DOCX / XLSX / PPTX). Each tool downloads the source file, streams text to an LLM in token-aware batches, then writes the translated content back to a copy of the original document.

Provided Tools

Tool YAML	Purpose
	Line-preserving text file translation
	Paragraph/run-preserving Word translation
	Cell-preserving Excel translation
	Shape/run-preserving PowerPoint translation

All tools expose the same parameter set; only the output format changes.

Features

Structure-aware rewriting keeps paragraphs, bullet points, and table cells aligned.
Automatic batching with retry and fallback ensures long documents are covered, even when a chunk exceeds the model’s token limit.
Uses whatever LLM configuration you supply through Dify (temperature, model name, max tokens, etc.).
Generates predictable filenames such as .

Installation

Package the plugin:
Upload the generated in Dify’s Plugin Management console.
Enable the tools you need for your App/Workflow.

No extra environment variables or API keys are required beyond the LLM credentials already configured in Dify.

Usage

In a workflow node (or tool call), select one of the translators.
Supply the required parameters:

Type	Required	Notes
string	Yes	Dify-uploaded file URL or accessible HTTP(S) link.
string	Yes	Used to infer extension and generate the output name.
object	Yes	Full LLM configuration object (e.g. from previous node or App settings).
string	No	Defaults to . Accepts language names or codes understood by the LLM.
int	No	Max tokens per request (default 1800, clamped to 200–6000).
int	No	Optional overlap for context continuity (default 60).

Collect the response:
- A binary blob message containing the translated document.
- A text summary confirming completion.

Output

File MIME type matches the input format (, , , ).
Original filename is preserved with appended before the extension.
When the source has no translatable content, the original file is returned unchanged with an informational message.

Requirements

The plugin’s runtime depends on:

These are pulled automatically during packaging/execution.

Notes & Limitations

Excel support requires . Legacy files should be converted first.
Formatting is preserved at run/cell level; complex scripting, animations, or embedded objects are not modified.
If the LLM fails to translate a line after backoff retries, the original text is left in place to avoid data loss.
PPT translation now splits oversized chunks recursively so every slide receives an attempt even when token limits are tight.

Development

To run the plugin locally for debugging:

Ensure is configured with your Dify remote debugging credentials (see for details).

License

Distributed under the MIT License. See for full text.