跳到主要内容

AI Coding

MeshStream 的 AI Coding 资料让 AI 编辑器基于官方 SDK 文档协助完成接入。Web、Android、iOS / macOS、Windows、Flutter、React Native 和 uni-app 均可使用同一套 MCP 与 Skills 工作流;执行结果仍以本地构建、播放和真实 P2P 互传证据为准。

现在能做什么​

AI Coding 分成两个层次:MCP 负责查事实和生成结构化集成方案,Skills 负责把方案落到项目工作流。它们都只读取公开文档,不读取客户代码、不接收 SDK Key,也不会替用户发布生产变更。

能力MCPSkills
文档、版本和错误码查询支持,返回来源链接支持,要求 AI 先查官方文档
按平台、框架、播放器生成接入计划get_integration_plan支持从项目代码识别上下文
跑官方 Demo / 从零接入返回步骤和验收清单支持 Codex、Cursor、Claude Code、CodeBuddy
功能扩展和故障排查返回公开规则保留现有播放器并执行最小改动
套餐、配额和用量规则get_billing_guidance引导到公开价格页和控制台
平台能力与验收边界get_platform_matrix按平台选择安装、示例和验证范围

配置 MCP​

在支持 MCP 的编辑器中,把下面这一项加入已有的 mcpServers,不要覆盖其他服务:

{
"meshstream-docs": {
"command": "npx",
"args": ["--yes", "@meshstream/docs-mcp@0.6.2"]
}
}

配置后可以直接提问:

调用 get_integration_plan,mode=from-zero,为 Vue 3 + hls.js + HLS 点播项目生成 MeshStream 最小接入方案,保留 CDN 回退,并列出真实 P2P 双端验收证据。

平台支持​

MCP 会根据 platform、framework、播放器和协议返回对应的安装、接入、高级用法和验收来源。Skills 会先识别当前项目,再选择对应平台的公开 SDK;不会把原生项目降级成 Web 示例。

平台适用项目官方接入文档
WebVue、React、原生 Web;hls.js、Shaka、dash.jsWeb 安装 · 快速接入
AndroidKotlin / Java 原生应用Android 安装 · 快速接入
iOS / macOSSwift / Objective-C、AVPlayerApple 安装 · 快速接入
WindowsC++ / Windows 原生播放器Windows 安装 · 快速接入
FlutterFlutter/Dart,调用 iOS 和 Android 原生 SDKFlutter 安装 · 快速接入
React NativeReact Native,调用 iOS 和 Android 原生 SDKReact Native 安装 · 快速接入
uni-appVue 3 + UTS,自定义基座或云打包uni-app 安装 · 快速接入

可以直接让 MCP 生成其他端方案,例如:

调用 get_integration_plan,platform=android,framework=Kotlin,player=Media3,protocol=HLS,mode=from-zero。
输出依赖、播放器连接、Android 回环代理配置、CDN 回退,以及两台真实 Android 设备的 P2P 上传/下载字节验收。

快速开始​

在项目根目录打开 Codex、Cursor、Claude Code 或 CodeBuddy,先把下面的任务完整粘贴到对话框:

请在当前项目中集成 MeshStream SDK。

执行顺序:
1. 识别目标平台、项目框架、播放器、媒体协议、包管理器和现有播放生命周期。
2. 阅读该平台对应的 MeshStream 官方安装、快速接入、统计和故障排查文档。
3. 使用当前公开渠道可安装的精确 SDK 版本,不猜测不存在的 API、版本或配置项。
4. 复用现有播放器,不替换源站、CDN、DRM 或业务鉴权;原生端使用对应平台的本地播放代理配置。
5. 保留 CDN 回退,并在播放结束、切源、页面隐藏或原生控制器销毁时释放 MeshStream 会话。
6. 修改代码后运行项目已有的构建和测试命令;移动端优先连接真实设备验证。
7. 报告目标平台、修改文件、实际 SDK 版本、构建结果、播放结果和仍未验证的设备/网络条件。

如果项目中没有可播放的媒体地址或 SDK Key,先生成需要我补充的清单,不要写入凭据。

原生与跨端项目接入任务​

Android、iOS / macOS、Windows、Flutter、React Native 和 uni-app 使用相同的任务模式,但必须读取对应平台文档并保留平台播放器生命周期:

在当前项目中接入 MeshStream:

- 先识别平台、框架、播放器、媒体协议和现有播放控制器。
- 使用对应平台官方安装页和快速接入页中的精确公开版本。
- 原生/跨端项目保留现有播放器、DRM、ABR、源站鉴权和 CDN 回退;不要把 Web API 或 Service Worker 代码移植到原生端。
- Android、iOS / macOS 使用 SDK 返回的本地播放代理地址,并完成对应网络安全配置。
- Flutter、React Native、uni-app 只调用已发布的原生依赖,不引用本地 AAR、Pod 或内部源码路径。
- Windows 按官方 C++ 头文件、库和播放器示例接入,检查 x64 架构和关闭释放。
- 在切源、后台、播放结束和控制器销毁时释放会话与连接。
- 先运行构建和单元测试,再用真实设备或目标架构验证播放、P2P 上传/下载字节和 CDN 回退。

输出平台、依赖版本、修改文件、构建结果、设备/系统、P2P 双端字节证据、回退结果和未执行项。

已发布工具​

官方工具的当前版本为 0.6.2,包含结构化集成规划、公开计费指引和 CodeBuddy 支持:

  • @meshstream/agent-skills:将接入、排错和 P2P 验收规则安装到 Codex、Cursor、Claude Code 或 CodeBuddy 项目。
  • @meshstream/docs-mcp:只读官方文档 MCP,不读取客户项目文件,也不执行生产操作。

在项目根目录安装编辑器规则:

npx --yes @meshstream/agent-skills@0.6.2 add --ide codex
npx --yes @meshstream/agent-skills@0.6.2 add --ide codebuddy

四种编辑器怎么使用​

命令必须在你的业务项目根目录执行;它只写入项目级规则,不会上传代码或读取凭据。安装后重新打开项目或新建一个对话,让编辑器加载规则:

编辑器安装命令生成文件使用方式
Codexnpx --yes @meshstream/agent-skills@0.6.2 add --ide codex.codex/skills/meshstream-sdk-integration/SKILL.md在项目中直接描述接入、排错或验收任务
Cursornpx --yes @meshstream/agent-skills@0.6.2 add --ide cursor.cursor/rules/meshstream-sdk-integration.mdc新建 Chat,按项目规则执行;需要时在 Rules 中启用该规则
Claude Codenpx --yes @meshstream/agent-skills@0.6.2 add --ide claude.claude/skills/meshstream-sdk-integration/SKILL.md新建会话后直接提问,或使用 /meshstream-sdk-integration 调用技能
CodeBuddynpx --yes @meshstream/agent-skills@0.6.2 add --ide codebuddy.codebuddy/skills/meshstream-sdk-integration/SKILL.md重启项目会话后直接提问,技能会按平台选择文档

一次安装全部编辑器规则:

npx --yes @meshstream/agent-skills@0.6.2 add --ide all --project .

已有规则不会被覆盖;确认要更新时显式加 --force。安装完成后可以这样开始:

读取 MeshStream SDK integration skill。先识别当前项目是 Android + Kotlin + Media3,
再调用 get_integration_plan 生成 from-zero 方案。不要套用 Web API;完成构建后列出真实设备的
P2P 上传/下载字节、CDN 回退和释放证据。

在支持 MCP 的编辑器配置中加入:

{
"mcpServers": {
"meshstream-docs": {
"command": "npx",
"args": ["--yes", "@meshstream/docs-mcp@0.6.2"]
}
}
}

Web 播放项目接入任务​

除了从零接入,还可以要求 AI 执行 demo、troubleshooting、feature-extension 或 docs 模式。每种模式都必须输出实际运行证据,不能只生成代码就宣称完成。

对于 Vue、React 或原生 Web 项目,可以继续使用这段任务。它要求 AI 保持现有播放器控制权,并验证 P2P 失败时播放仍能继续:

在当前 Web 播放页面接入 MeshStream:

- 播放器:请根据项目实际代码填写,例如 hls.js、Shaka 或 dash.js。
- 协议:请根据实际媒体地址填写 HLS 或 DASH。
- 使用稳定的 contentId;不要把带签名参数的完整 URL 当作长期内容标识。
- SDK Key 从环境变量读取,不要提交到 Git、日志或页面源码。
- 保留现有 ABR、DRM、源站请求头和播放器生命周期。
- 加速初始化失败、Tracker 不可用或 Peer 超时必须回退 CDN。
- 页面隐藏、切换媒体和销毁播放器时调用对应的 dispose/release。

完成后输出:
1. 修改文件和依赖版本;
2. 构建与测试命令及结果;
3. CDN 播放结果;
4. P2P 是否真正传输;
5. 未执行的真机、跨网络或生产验收项。

P2P 验收任务​

Peer 数量大于零只代表连接建立。需要两个使用同一内容标识的播放端,分别记录接收端下载和发送端上传字节:

请对当前 MeshStream 播放接入执行双端 P2P 验收:

1. 启动发送端并缓存至少一个可共享分片。
2. 再启动接收端,使用相同的 contentId、清晰度和媒体内容。
3. 记录带时间戳的 Peer 数、P2P 下载字节、P2P 上传字节、CDN 下载字节和 rebuffer 次数。
4. 只有接收端 P2P 下载字节增长且发送端 P2P 上传字节同步增长,才能报告真实互传通过。
5. 停止或阻断 P2P,确认播放器继续通过 CDN 播放。
6. 销毁两个会话,确认 WebSocket、Peer、监听器和定时器释放。

请将通过、失败、阻塞和未执行分别列出,不要用“Peer > 0”代替互传结论。

故障排查任务​

请排查 MeshStream 播放正常但没有 P2P 的问题,按以下顺序检查:

1. SDK Key、应用状态、额度和 bootstrap 响应;
2. contentId、协议、清晰度和 swarm 是否一致;
3. Tracker WebSocket 握手、announce 和 Peer 发现时间;
4. WebRTC、ICE、浏览器权限和网络限制;
5. P2P 分片是否真的命中,以及超时后的 CDN 回退;
6. session dispose 后是否仍有连接或定时器。

输出每一步的证据、结论和下一步动作,不要通过关闭错误日志来掩盖问题。

版本与凭据规则​

  • 只使用选择 SDK和对应安装页中已经公开的版本。
  • SDK Key 放在本地环境变量或受限的运行时配置中,不提交仓库。
  • 签名播放地址、Authorization、Cookie、SecretKey 和生产日志不要粘贴到 AI 对话中。
  • AI 生成的代码必须经过构建、播放、真实互传、CDN 回退和释放验证后才能上线。
  • 工具源码和发行记录见 MeshStream AI Tools。

下一步​