Z视介APP Skills (zmg-zsj-skill)

Z视介APP 的核心功能，包括直播搜索、短视频与综艺浏览、热门话题查看、应用页面跳转、内容发布等。

功能列表

使用场景

搜索

• 用户想了解当前热门话题 → 使用 search_hot

- 不需要参数，返回平台热门搜索关键词

- 示例：「现在最火的话题是什么」

• 用户想查找某场直播 → 使用 search_live 并传入关键词

- 示例：「找周杰伦的直播」

• 用户想查找某档综艺 → 使用 search_variety 并传入关键词

- 示例：「找《奔跑吧》」

内容浏览

• 用户想查看当前热门直播 → 使用 get_hot_live_list

- 返回包含 ID、标题、副标题和观看链接的热门直播列表

- 示例：「现在有哪些直播在播？」

• 用户想进入某个具体直播间 → 使用 get_live_detail 并传入 liveId

- 返回直播详情页的 H5 链接和 App Schema

• 用户想观看电视频道直播 → 使用 watch_live_channel 并传入频道名称

- 支持频道：浙江卫视、钱江频道、经济生活、教育、民生、新闻、少儿、浙江国际、好易购、之江纪录片

- 返回对应频道直播的 H5 页面链接

- 若无匹配则默认为浙江卫视

• 用户想查看热门综艺 → 使用 get_variety_list

- 返回综艺排行榜，包含名称和播放页链接

• 用户想查看热门短视频 → 使用 get_short_video_list

- 返回短视频排行榜，包含标题和分享页链接

应用导航

• 用户想打开应用到特定页面 → 使用 open_app_page 并传入 schema

- 返回一个深度链接（H5 页面），以超链接形式展示供用户点击

内容创作

• 用户想发布一条图文动态 → 使用 publish_post

- 必填项：title（动态正文）

- 可选项：img_array（图片列表，含 pic/height/width）、tags、description

- 成功后返回 article_id

• 用户想发布一段短视频 → 使用 publish_short_video

- 必填项：title、video_url

- 可选项：cover_img、width/height、play_time（格式为 ["HH","MM","SS"]）、tags、description

- 成功后返回 article_id

消息查看

• 用户想查看被提及的消息 → 使用 get_message_list 并设置 msg_type: "mention"

- 返回提及列表，包含用户名、头像和内容

• 用户想查看评论或回复 → 使用 get_message_list 并设置 msg_type: "comment"

- 返回评论列表，包含内容和关联动态信息

• 用户想查看点赞记录 → 使用 get_message_list 并设置 msg_type: "like"

- 返回点赞列表

用户内容查看

• 用户想查看自己的短视频 → 使用 get_user_content_list

- 返回短视频列表，包含标题、内容、封面图、点赞数、评论数、播放量及内容类型

- **用户身份由认证令牌自动识别，请勿手动传入 uid、accessUuid 等用户标识。**

• 用户想查看自己的图文动态 → 使用 get_user_post_list

- 返回图文动态列表

- **用户身份由认证令牌自动识别，请勿手动传入 uid 或 accessUuid。**

• 用户想查看自己的音频内容（如KTV录音）→ 使用 get_user_audio_list

- 返回音频列表

- **用户身份由认证令牌自动识别，请勿手动传入 uid 或 accessUuid。**

内容管理

• 用户想删除一篇文章 → 使用 delete_article 并传入 article_id

- **必须先调用 get_user_content_list、get_user_post_list 或 get_user_audio_list 获取文章 ID（字段为 id）**

- 删除操作不可逆，AI 在执行前应向用户确认。

MCP 配置

MCP 服务器地址（已内置在 skill.json 中）：

{
  "mcp": {
    "transport": "sse",
    "url": "https://zmg-mcp.cztv.com/sse",
    "auth": {
      "type": "bearer",
      "header": "Authorization",
      "token_prefix": "zmg_",
      "acquire_url": "https://zmg-mcp.cztv.com"
    }
  }
}

客户端配置示例（请将 <ai_token> 替换为实际令牌）：

{
  "mcpServers": {
    "zmg-zsj-skill": {
      "url": "https://zmg-mcp.cztv.com/sse",
      "headers": {
        "Authorization": "Bearer <ai_token>"
      }
    }
  }
}

认证模型

MCP 服务器为无状态设计，不维护用户会话。认证通过每次请求携带的 ai_token 实现：

• 来源：ai_token 由用户在 APP 中扫描二维码后生成（格式为 zmg_xxxxx），存储于 Redis
• 获取方式：访问 https://zmg-mcp.cztv.com，扫描二维码后复制 ai_token 至客户端配置
• 传递方式：在 MCP 请求头中设置 Authorization: Bearer <ai_token>
• 验证机制：NG 网关通过 Redis 校验 ai_token，获取 sessionId 后注入至业务请求中

• channel 参数接受频道名称（例如 "浙江卫视"），支持模糊匹配，默认值为浙江卫视
• get_live_detail 需要传入直播 ID 才能获取详情页链接
• open_app_page 返回一个可作为超链接使用的跳转链接，用于启动应用
• 发布类 API（publish_post / publish_short_video）需要用户授权；未授权或过期时返回 401 错误
• 不需要手动传递 uid、sessionId 或其他敏感信息——系统会自动处理

401 认证错误处理流程（最高优先级）

**当任意 API 返回 code: 401 时，立即执行以下操作：**

1. 立即停止当前任务 —— 不得继续调用任何 API
2. 提示用户扫描二维码，并显示：

- 提示语：授权需要。请使用 Z-Sight APP 扫描二维码

- 以超链接形式展示授权地址：[点击进行授权](https://zmg-mcp.cztv.com)

- 授权页面地址：https://zmg-mcp.cztv.com

1. 用户扫码并完成授权后，将新的 ai_token 更新至 MCP 配置中：Authorization: Bearer <ai_token>
2. 更新 token 后，重新尝试原始请求

401 响应格式：

{
  "code": 401,
  "message": "授权已过期，请重新扫描以授权",
  "action": "REAUTHORIZE",
  "authorize_url": "https://zmg-mcp.cztv.com"
}

严格禁止：

• 收到 401 后返回“我没有权限”或“我无法执行此操作”——必须引导用户扫描二维码
• 忽略 401 错误并直接重试请求
• 仅返回错误信息而未提供授权链接