본문으로 건너뛰기
cccskills
무료GitHub에 공개

byted-tos-doc-process

Previews and exports documents stored in Volcengine TOS: generate PDF/PNG/JPG previews, read page counts, resolve HTML preview URLs, and batch-export PDF pages as images. Use this skill when the user needs to convert or preview office documents (Word, Excel, PPT, PDF), export specific pages as images, get document page counts, or generate HTML preview links — even if they don't explicitly mention 'doc-preview' or 'document conversion'.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

연동 도구ExcelWord
설치 방법 보기

포함된 파일(14)

  • SKILL.md5.5 KB
  • LICENSE11.1 KB
  • README.md5.5 KB
  • REFERENCE.md7.9 KB
  • requirements.txt4 B
  • scripts/doc_batch_screenshot.py4.6 KB
  • scripts/doc_preview_html_url.py12.2 KB
  • scripts/doc_preview_jpg.py7.8 KB
  • scripts/doc_preview_params.py3.6 KB
  • scripts/doc_preview_pdf.py7.2 KB
  • scripts/doc_preview_png.py8.0 KB
  • scripts/doc_preview_process.py12.1 KB
  • scripts/doc_total_page.py7.6 KB
  • WORKFLOWS.md10.7 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Volcengine TOS Document Process

Preview and convert office documents stored in Volcengine TOS — PDF/PNG/JPG conversion, page count, HTML preview URL, and page-range export.

Setup (once per environment)

Install dependencies on first use:

cd {baseDir}
pip install -r {baseDir}/requirements.txt

Then run scripts with Python 3.7+:

python3 {baseDir}/scripts/<script>.py <args>

If you see a ModuleNotFoundError for tos, reinstall dependencies.

Environment Variables

This skill relies on the TOS identity declared in the metadata block. Common runtime variables are:

Environment VariableRequiredDescription
TOS_ACCESS_KEYYesTOS access key ID
TOS_SECRET_KEYYesTOS secret access key
TOS_ENDPOINTYesTOS endpoint URL
TOS_REGIONYesTOS region
TOS_BUCKETYesSource bucket that stores the document
TOS_OBJECT_KEYNoSource object key of the document. Can be overridden with --key
TOS_SECURITY_TOKENNoSTS session token when using temporary credentials

Quick start (common tasks)

# Convert document to PDF
python3 {baseDir}/scripts/doc_preview_pdf.py --key report.docx --output preview.pdf

# Preview page 2 as PNG
python3 {baseDir}/scripts/doc_preview_png.py --key report.docx --page 2 --output page_2.png

# Preview page 2 as JPG
python3 {baseDir}/scripts/doc_preview_jpg.py --key report.docx --page 2 --output page_2.jpg

# Get total page count
python3 {baseDir}/scripts/doc_total_page.py --key report.docx --dest-type pdf

# Resolve HTML preview URL
python3 {baseDir}/scripts/doc_preview_html_url.py --key report.docx

# Batch export page range to TOS
python3 {baseDir}/scripts/doc_preview_process.py --key report.docx \
  --dest-type jpg --img-mode 1 --start-page 1 --end-page 3 \
  --saveas-bucket "output-bucket" --saveas-object "export/page_{Page}.jpg"

# Batch screenshot a PDF page range
python3 {baseDir}/scripts/doc_batch_screenshot.py --key test.pdf \
  --format png --start-page 1 --end-page 3 \
  --saveas-object "skill-test/doc/{Page}.png"

Available scripts

ScriptPurpose
scripts/doc_preview_pdf.pyConvert document to PDF and save locally.
scripts/doc_preview_png.pyRender a single page as PNG.
scripts/doc_preview_jpg.pyRender a single page as JPG.
scripts/doc_total_page.pyRead total page count via x-tos-total-page header.
scripts/doc_preview_html_url.pyResolve the final HTML preview URL (follows redirects and extracts tokens).
scripts/doc_preview_process.pyGeneric doc-preview with full parameter control; supports TOS-to-TOS export.
scripts/doc_preview_params.pyHelper library to build x-tos-doc-* query parameters consistently.
scripts/doc_batch_screenshot.pyBatch-export PDF pages as images through doc-preview batch mode.

All scripts support --key to override TOS_OBJECT_KEY. Structured scripts also support --json for machine-readable output, and doc_preview_process.py / doc_total_page.py support --dry-run to preview the resolved request. Run any script with -h for full usage.

Out of scope

  • Editing document contents (this skill is read-only preview/conversion).
  • Generic object storage tasks unrelated to document preview.
  • Local office conversion workflows that do not involve TOS.

Rules

  • Authentication: Authentication is provided by the TOS identity declared in the metadata block above. Object selection can be overridden per script with --key.
  • Pre-signed URL pattern: Document preview uses pre-signed URLs with x-tos-process=doc-preview and x-tos-doc-* query parameters, not the direct process keyword of get_object. Use doc_preview_params.py to build parameters consistently.
  • Batch screenshot constraint: doc_batch_screenshot.py currently requires a PDF source object and persists results back to TOS with a {Page} placeholder.
  • Save-as encoding: For doc-preview query-based save-as, the helper script automatically URL-safe-Base64 encodes x-tos-save-bucket and x-tos-save-object to match backend expectations.
  • Custom domain note: For buckets created after Jan 03, 2024, online HTML preview may require a custom domain rather than the default TOS domain.
  • Parameter source of truth: Official Volcengine TOS documentation is authoritative for the full doc-preview parameter matrix. When uncertain, check REFERENCE.md.
  • Language: Reply in the user's preferred language.

Further reading

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Deploy, update, validate, and troubleshoot the AgentKit hybrid-cloud customer-service demo in this directory. Use when a user asks an AI coding agent to follow the README, deploy or update the demo, configure OpenAPI/Runtime/Knowledge/Memory/Sandbox/MCP/Skills/A2A, run customer-view validation, or record manual platform steps and failures.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

bytedance/agentkit-samples4742026년 10월 20일 업데이트

Generate deterministic SVG algorithmic artwork. Invoke when the user asks for geometric, generative, or algorithmic visual art.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

bytedance/agentkit-samples4742026년 10월 20일 업데이트

通过本地 Python CLI 和 OpenAPI 客户端管理、排查火山云手机资源。适用于查询实例和资源、截图、执行命令、查看任务、检查应用、主机和机房容量、标签、DNS、路由,以及操作已授权的测试云手机实例。

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

bytedance/agentkit-samples4742026년 10월 20일 업데이트

Launch and continue the Volcengine AI Research survey workflow for concept testing, audience design, questionnaire drafting, interview guide generation, execution confirmation, progress checks, and result queries. Use this skill when the user wants to create, revise, confirm, execute, or follow up on a real AI research survey task in ABCompass instead of doing generic brainstorming, copywriting, translation, summarization, or broad market discussion.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

bytedance/agentkit-samples4742026년 10월 20일 업데이트

Create and check long-running video material evaluation tasks. Use this skill when the user wants to submit videos for evaluation, check an existing video evaluation task list, or fetch the result of a previously created video evaluation task. This skill is not a general-purpose video upload skill because upload is allowed only as an internal step of task creation. Authentication uses an API key passed as an Authorization bearer token.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

bytedance/agentkit-samples4742026년 10월 20일 업데이트

火山引擎 AntiDDoSPro 高防域名只读巡检。用户要查域名健康、攻击、流量、CC/WAF/区域封禁、智能防护或 CCAI 状态时使用。

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

bytedance/agentkit-samples4742026년 10월 20일 업데이트

bytedance의 스킬 모두 보기

이 스킬의 문제 신고