dianju-ofd-tools

``` name: dianju-ofd-tools description: An OFD document processing tool that can convert local PDF and OFD files to each other and extract content from OFD files. version:1.0.0 email:support-ofd@dianju.com ``` # OFD Tools Skill ## Quick Start ``` npx dianju-ofd-tools --APP_ID=xxx --APP_KEY=xxx --API_URL=http://ip:port/DCS ``` APP_ID：appid APP_KEY：appkey API_URL：The system API address ## Features ### 1. PDF to OFD Conversion - **Tool Name:** `pdf_to_ofd` - **Description:** Convert local PDF files to OFD format - **Parameters:** ```json { "filePath": "string" // Absolute path to local PDF file } ``` - **Returns:** Temporary download link for the generated OFD file ### 2. OFD to PDF Conversion - **Tool Name:** `ofd_to_pdf` - **Description:** Convert local OFD files to PDF format - **Parameters:** ```json { "filePath": "string" // Absolute path to local OFD file } ``` - **Returns:** Temporary download link for the generated PDF file ### 3. OFD Content Extraction - **Tool Name:** `get_ofd_content` - **Description:** Extract text content from local OFD files - **Parameters:** ```json { "filePath": "string" // Absolute path to local OFD file } ``` - **Returns:** JSON array of extracted text content ## Usage Examples ### Example 1: Convert PDF to OFD ```bash ofd-tools pdf_to_ofd --filePath "/path/to/input.pdf" ``` ### Example 2: Convert OFD to PDF ```bash ofd-tools ofd_to_pdf --filePath "/path/to/input.ofd" ``` ### Example 3: Extract OFD Content ```bash ofd-tools get_ofd_content --filePath "/path/to/input.ofd" ``` ## Notes 1. **File Paths:** Ensure the local file path is correct (absolute path recommended for non-current directory files). 2. **Temporary Links:** The `ofd_to_pdf` and `pdf_to_ofd` services return temporary download links for converted files; check link validity before use. 3. **Link Expiry:** OFD download links may expire after a set time; download the file promptly. 4. **File Integrity:** Always verify the integrity of the generated OFD file before sharing or using it. 5. **Performance:** Large files may take longer to process; avoid interrupting the conversion process. 6. **Logging:** Enable logging with `ENABLE_LOGGING=true` for troubleshooting; logs can be output to files with `LOG_TO_FILE=true`. ## Error Handling - **File Not Found:** Ensure the file path is correct and the file exists - **Permission Denied:** Check file permissions and ensure the tool has read access - **Conversion Failed:** Verify the input file is valid and not corrupted - **Network Issues:** Check internet connectivity when using external conversion services ## Support For issues or questions, contact support at support-ofd@dianju.com.