2.9 KiB

Raw Permalink Blame History

name	description
video-product-snapshot	Upload video to API for product analysis and 1688 keyword search. / 上传视频直接识别商品并在1688搜索同款。当用户提供视频想找商品时使用。

Video Product Snapshot — 视频商品截图

上传视频到 API，由多模态模型识别商品主体，生成中文关键词在 1688 上搜索找到同款商品。

运行

bun dist/run.js <command> [args] [--dry-run]

命令列表

命令	使用场景
`detect-video-and-search <video>`	推荐。上传视频到 API 识别商品，然后 1688 关键词搜索。
`detect-video <video>`	只识别商品描述和生成关键词，不搜图。
`search <image-path>`	已经有商品截图了，跳过检测直接搜图。
`session`	获取当前认证会话 token。

`detect-video` / `detect-video-and-search`

上传视频到 API 直接识别商品主体。

流程：

上传视频 → 获取公开 URL（复用现有上传接口）
调用 LiteLLM（Chat Completions + video_url）分析视频内容
识别商品名称、材质、颜色、功能
生成中文搜索关键词
1688 关键词搜索（detect-video-and-search）

依赖：

auth-rt client key（自动，无需额外配置）
LiteLLM 代理支持 video_url 内容类型
上传接口返回公开 URL

输出格式

`detect-video-and-search`

{
  "videoUrl": "https://...",
  "description": "白色帆布收纳盒，带提手，可折叠",
  "keyword": "帆布收纳盒",
  "searchResults": [
    { "num_iid": 123, "title": "...", "price": "15.00", "promotion_price": "12.00", "sales": 500, "detail_url": "..." }
  ]
}

结果展示格式

将 searchResults 格式化为 markdown 表格，每页 5 行（不足 5 行则全显示）：

#	商品名称	价格	销量	链接
1	{title}	¥{promotion_price \|\| price}	{sales ?? —}件	查看

有 promotion_price 用促销价，否则用原价
sales 缺失或为零时显示 —
始终用 markdown 表格展示，不要用列表

执行规则

视频命令（慢 — 用 sub-agent 执行）

涉及命令：detect-video-and-search、detect-video

使用 sessions_spawn 创建 sub-agent 执行，不要直接运行。

sessions_spawn(
  task: "Run this command and return the raw JSON output:\n\nbun dist/run.js <完整命令>\n\nCopy the entire JSON output as your reply.",
  label: "video-product-snapshot",
  runTimeoutSeconds: 300,
)

通知用户处理已开始，告知 runId
等待 sub-agent 返回结果，然后解析并展示

`search` 和 `session`（快 — 直接运行）

直接在本会话中运行，不需要 sub-agent。

通用规则

不要重试。 命令失败就直接报错。
信任工具输出。 CLI 内部已处理 session 管理和错误格式化。

2.9 KiB Raw Permalink Blame History Unescape Escape