媒大大全网发稿平台，软文发布、权威官媒与海外媒体全网一站式推广

概述

媒大大 CLI 安装助手

以下步骤面向 AI Agent。本 bootstrap skill 只负责安装或升级媒大大 mdd CLI、写入接入配置、同步正式 mdd Skill 并完成环境自检。自检结束后必须停止，不继续执行媒体查询、稿件导入、报价、投放确认或订单查询。

核心原则

• 使用项目官方流程：固定执行“安装 CLI → 写入接入配置 → 同步 Agent Skill 并自检”。
• 只通过 CLI 接入：不从源码构建，不绕过 mdd 猜测或直接调用内部 API。
• 密钥不泄露：API Key 只用于 mdd config init，不得写入文档、源码、日志或回复正文。
• 完成即停止：mdd doctor 完成后结束 bootstrap 任务，业务操作交给正式 mdd Skill。

适用场景

• 用户要从 SkillHub / skills 市场安装媒大大能力。
• 用户首次接入 mdd CLI。
• 用户要重新安装或升级 CLI，并同步最新 Skill。
• 用户只需要标准安装命令或接入自检。

环境要求

开始前确认本机已安装：

• Node.js
• npm
• npx

默认使用 npm 全局安装，不引导普通用户从项目源码构建。

第 1 步：安装 CLI

npm install -g @meidada-cn/cli

这是项目网页接入指引使用的标准安装命令。安装失败时先报告 npm 原始错误，再检查 Node.js、npm、全局安装目录权限和网络；不要改用来源不明的安装包。

第 2 步：写入接入配置

mdd config init --api-url <当前媒大大站点地址> --api-key <YOUR_API_KEY>

• --api-url 和 --api-key 都是必填项。
• 站点地址必须使用用户当前媒大大环境的服务地址，CLI 会自动移除末尾多余的 /。
• API Key 必须在该站点的 /developer 页面创建，用途选择 CLI / Agent（CLI）。
• 如果安装提示词已经带有真实站点地址和密钥，按原值执行，不要改写。
• 如果仍是 <YOUR_API_KEY> 占位符，停止并请用户先创建或提供可用密钥；不要拿示例值继续。
• 命令成功后，CLI 会将配置写入本地配置文件，输出中只应展示脱敏后的 Key。

第 3 步：同步 Agent Skill 并自检

mdd skill sync --global && mdd doctor

• --global 等同于 --scope user，会把包内正式 mdd Skill 投影到本机已检测到的 Cursor、Claude Code、Codex 等 Agent 用户级约定位置。
• 如果用户明确只需当前项目使用，可执行 mdd skill sync && mdd doctor；项目级是 skill sync 的默认范围。
• mdd doctor 按顺序检查配置、站点连通性、Key 有效性和 Key 用途。
• 如果 Key 用途不是 CLI，提醒用户到 /developer 重建 CLI 用途的 Key，再重新配置并自检。
• 自检完成后停止，不运行 mdd media、mdd draft、mdd publish 或 mdd order。

标准接入命令

当站点地址和 Key 已准备好时，依次执行：

npm install -g @meidada-cn/cli
mdd config init --api-url <当前媒大大站点地址> --api-key <YOUR_API_KEY>
mdd skill sync --global && mdd doctor

升级与重新同步

已安装 CLI 时，优先执行 mdd upgrade，并按照 CLI 返回的安装方式与提示处理升级；不要擅自把 Volta、pnpm、Bun、Yarn 的安装方式改写成 npm。升级后执行：

mdd skill sync --global
mdd doctor

安装后的正式能力

安装完成后只需告知用户：正式 Skill 名称为 mdd。后续媒体查询、稿件处理、报价和投放应在正式 mdd Skill 下进行；参数契约以 mdd --help --json 为准。

投放确认必须由用户本人在网页完成。Agent 只能生成确认单并把确认链接交给用户，不能代替用户确认或尝试绕过人工确认。

故障排查

按以下顺序检查：

1. 确认 node、npm、npx 可用。
2. 重新执行 npm install -g @meidada-cn/cli，确认 mdd 命令可用。
3. 检查 mdd config init 使用的站点地址和 API Key 是否属于同一环境。
4. 执行 mdd config show，只核对脱敏配置，不输出完整 Key。
5. 执行 mdd skill sync --global && mdd doctor。

仍然失败时，只报告 CLI 返回的错误、退出码和下一步提示，不绕过 CLI 继续业务操作。