hermes/dsh-vk-group
1
0 Fork 0
Code Issues 14 Pull Requests Actions Packages Projects Releases Wiki Activity

WP-6 · Загрузка медиа (vk_media_upload) #6

New Issue
Open
opened 2026-10-21 11:00:44 +00:00 by hermes · 0 comments
hermes commented 2026-10-21 11:00:44 +00:00
Owner
Copy link
Copy source

Цель

Один инструмент, загружающий все нужные типы вложений.

Типы

photo_wall, photo_message, doc, video, story.

Детали

  • Трёхшаговый протокол: getUploadServer → POST файла → save*.
  • Upload URL одноразовый: при ошибке загрузки — рестарт с шага 1 (перезапрос сервера), не повторный POST на тот же URL.
  • Источники: путь к файлу ({ kind: 'file', path }) и URL ({ kind: 'url', url }).
  • Формирование attachment-строки: photo{owner}_{id}, doc{owner}_{id}, video{owner}_{id}, story{owner}_{id}.
  • Крупные файлы — через ctx.jobs (фоновая задача с прогрессом).
  • exec.signal отменяет загрузку между чанками.

Acceptance

  • Каждый тип даёт корректный формат attachment.
  • Принудительная ошибка загрузки → ретрай начинается с getUploadServer.
  • Все 5 типов покрыты контракт-тестом.

Ссылки

wiki: Tools-Reference · Platform-VK-API · Architecture

## Цель Один инструмент, загружающий все нужные типы вложений. ## Типы `photo_wall`, `photo_message`, `doc`, `video`, `story`. ## Детали - Трёхшаговый протокол: `getUploadServer` → POST файла → `save*`. - **Upload URL одноразовый**: при ошибке загрузки — рестарт с шага 1 (перезапрос сервера), не повторный POST на тот же URL. - Источники: путь к файлу (`{ kind: 'file', path }`) и URL (`{ kind: 'url', url }`). - Формирование attachment-строки: `photo{owner}_{id}`, `doc{owner}_{id}`, `video{owner}_{id}`, `story{owner}_{id}`. - Крупные файлы — через `ctx.jobs` (фоновая задача с прогрессом). - `exec.signal` отменяет загрузку между чанками. ## Acceptance - Каждый тип даёт корректный формат attachment. - Принудительная ошибка загрузки → ретрай начинается с `getUploadServer`. - Все 5 типов покрыты контракт-тестом. ## Ссылки wiki: [[Tools-Reference]] · [[Platform-VK-API]] · [[Architecture]]
hermes added this to the M2 · Write surface (all 30 tools) milestone 2026-10-21 11:00:44 +00:00
hermes added the work-packagetools labels 2026-10-21 11:00:44 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Labels
Clear labels
client
docs
events
moderation
policy
priority:high
priority:low
priority:medium
tests
tools
ui
work-package
No labels tools work-package
Milestone
No items
No Milestone M2 · Write surface (all 30 tools)
Projects
Clear projects
No projects
Assignees
Clear assignees
hermes (Hermes Agent)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: hermes/dsh-vk-group#6