SuperAPI AI 工具集

tk-pr-media

办公与效率

查看项目

更新于 10-20 18:48

技能介绍

tk-pr-media 是 tiger-kit 技能集中的一项技能,用于将本地图片、GIF、MP4 附件上传到现有 GitHub PR 正文或指定评论。它仅响应用户明确提出的媒体请求,或精确的 tk-pr-open 通用清单交接(evidence_required: true)。

用途:处理针对现有 GitHub PR 或精确 tk-pr-open 交接的一次有界上传:验证并暂存本地图片,上传仓库范围的 GitHub 附件,最小化更新 PR 正文或选定评论,并验证源 Markdown 与已上传图片对象。默认目标是 PR 正文。

主要能力:

  • 复用或插入 ## 스크린샷 标题,保留正文无关内容。
  • 对于清单产物,使用提供的准则、角色、精确 display_route、状态/区域、视口和比较信息生成说明,不根据文件名、OCR、原始 URL 或生产者身份推导。
  • 支持可选的 MP4 视频补充附件,仅在 publication_selected: true 或用户明确选择该精确产物/目标时上传。
  • 支持选定的 GIF 帧组装,需使用经审核的扩展,指定 .gif 名称和与帧序列匹配的延迟,并保留所有帧上限/缩减/超大警告。
  • 使用 gh-attach 或 CDP 路由执行上传;仅在 CDP 被选中或扩展路由无法使用目标写入能力时读取 CDP 回退文档。
  • 当需要仅限人工的主机操作时,通过 tk-wizard 进行有界交接,在完成信号前不上传。
  • 通过 GitHub API 或等效方式仅更新请求的正文或评论。
  • 在 Pass 前重新读取目标并验证每个生成的图片 token 字节级精确出现一次、配对角色/说明正确关联、每个资产可解码 image/* 字节、每个链接上传对象可从上传引用到达。浏览器会话渲染为可选,并在回执中报告是否检查。
  • 在所有退出路径上删除本次运行拥有的暂存文件,使用运行中已记录的完整绝对路径。

使用方式:

  1. 确认来源、当前 PR 和执行仓库,来自常规本地图片文件或有效的生产者证据交接。读取现有 PR 正文。
  2. 管理 ## 스크린샷 标题,为每对图片添加标题、预期行为句子、角色标题(如 수정 전 / 수정 후)、图片行和说明行。
  3. 选择并执行合格路由(gh-attach 或 CDP)。
  4. 如需人工操作,交接给 tk-wizard 并在完成后恢复精确的仓库、目标、图片集和路由。
  5. 更新目标并验证。
  6. 记录执行回执,包含仓库、PR/目标、源图像、路由、入口、生成 Markdown、远程引用、验证结果、更改状态、清理状态和状态。

适用场景:为 GitHub PR 添加本地截图、GIF 或视频证据;处理 tk-pr-open 的证据交接;更新 PR 正文或指定评论中的媒体附件。

限制:

  • 不创建或合并 PR、不更改审阅者、不发布版本、不插入评论(除非用户明确选择评论目标)。
  • 不绕过 tk-browser-verify,不使用 Orca 或屏幕控制作为自动浏览器回退。
  • 不覆盖预先存在的草稿或点击评论、关闭并评论或其他提交按钮。
  • 不基于公共/私有可见性选择路由,不声称仅凭占位符、Markdown 存在、固定延迟或未渲染 API 响应就成功。
  • 不记录或返回签名 URL、JWT 或含秘密的原始查询字符串;仅对显示输出中的秘密值进行脱敏。
  • 生成的图片 Markdown token 必须字节级精确保留,包括 alt、URL 和渲染参数。
  • 仅在任务授权时创建工件;默认仓库输出到 .tigerkit/。
  • 对于 tk-pr-open,如果必需证据缺失或无效,标记证据交接为 Blocked,不还原已创建的 PR。
  • 失败处理:等待缺失扩展或未审核上游选择或人工 tk-wizard 完成信号时返回 Pending;未知来源、草稿或拒绝安装且未选择 CDP 路由时返回 Blocked;无法验证认证、图片字节验证或上传引用可达性时返回 Unverifiable;上传、远程引用验证或清理错误时返回 Fail。

输出:终端响应以 ## GitHub media upload 开头,包含 ## Uploaded、## Verification、## Cleanup(如适用),并以恰好一行 Status: Pass|Fail|Pending|Blocked|Unverifiable 结束结果部分。仅在安全时公开资产 URL 并脱敏签名参数。

分类:办公与效率(office)。