version: "1.0.1" name: siyuan-sisyphus-file-export description: CLI-only playbook for SiYuan assets and exports with siyuan-sisyphus. Use for uploads, Markdown export, document extraction, resource ZIP export, OCR text, templates, and safe asset maintenance.

Handle SiYuan Files and Exports with the CLI

File actions are the explicit exception to the normal remote-only data path: uploads and local exports may touch the machine running the server. Confirm local paths and scope first.

siyuan-sisyphus file upload-asset --assets-dir-path '/assets/' --local-file-path '/absolute/path/to/image.png' --json

siyuan-sisyphus file export-md --id '<doc-id>' --json

siyuan-sisyphus file extract-doc --id '<doc-id>' --output-dir '/tmp/siyuan-extract' --json

siyuan-sisyphus file export-resources --paths-json '["assets/file.png","assets/file.pdf"]' --json

siyuan-sisyphus file get-doc-assets --id '<doc-id>' --asset-type 'image' --json

siyuan-sisyphus file get-image-ocr-text --path 'assets/image.png' --json

Large uploads must stop and require explicit confirmation before retrying with the large-file confirmation field. A document extraction output directory may be cleared; use a task-specific empty directory. Before renaming, deleting, or removing unused assets, list the exact targets and obtain approval. Verify returned paths after the operation. Read siyuan-sisyphus help file upload-asset for current size and path constraints.