墨笔公众号诊断

概述

调用服务地址：https://mobi.yiciyueqian.cn/api/skills/mobi-wechat-official-account-diagnosis。

这是按次付费的托管 Skill：墨笔只采集、清洗并交付事实数据；使用当前 Agent 已选模型完成最终分析。

前置检查

确认当前 Agent 已安装 weixinpay 支付扩展。未安装时，说明当前环境不能完成微信付费，不要创建订单或尝试绕过支付。

获取数据包

调用 API 前先阅读 [references/api.md](references/api.md)。严格按以下流程执行：

1. 创建授权会话，并将返回的 authorizeUrl 展示给用户；等待用户在浏览器完成微信开放平台授权。
2. 轮询授权状态。仅当状态为 authorized 时继续；过期、找不到或失败时创建新的授权会话。
3. 调用预检接口，确认付款前必须补齐的材料。认证服务号且微信接口正常时不需要 Excel；未认证/个人号通常需要文章链接、内容分析 Excel 和用户分析 Excel；认证号只有在对应接口异常时才需要 Excel 兜底。
4. 用户提供预检要求的 Excel 附件后，用上传接口逐份提交。文章链接放入后续资源请求的 articleUrls，最多 5 条；个人号建议提供近一个月 3–5 条。
5. 用固定 JSON body 请求诊断资源。材料未齐时会返回 MATERIALS_INCOMPLETE，此时不得创建订单或要求用户付款。
6. 首次收到 402 时，保存响应 Header WeixinPay-Required 与 X-Out-Trade-No，并用前者作为 paymentCode 调用 weixinpay_pay；不要新建订单。
7. 支付成功后，必须以完全相同的 JSON body重试资源请求，并携带保存的 WeixinPay-Required 和 X-Out-Trade-No Header。
8. 收到 202 后，用返回的 taskId 与原 authorizationId 轮询任务。queued 或 running 时稍后继续；succeeded 时立即取得并使用一次性的 diagnosisData。

不要假定已交付的数据包可再次读取。不要用另一个授权、订单号或变更过的请求 body 恢复同一订单。

个人号与未认证号的 Excel 下载引导

仅当预检的 requiredSupplements 含对应类型时，才向用户展示以下指引；不要求补件的账号不要展示或要求上传。请用户在电脑浏览器登录 微信公众平台，下载原始 Excel 后回到当前对话上传：

• content（内容分析 Excel）：进入 数据分析 → 内容分析 → 流量分析，选择与诊断窗口一致的数据时间（单次最长 30 天），点击右上角 下载数据明细。
• user（用户分析 Excel）：进入 数据分析 → 用户分析，选择与内容分析尽量相同的时间范围，在 详细数据表格 右上角点击 下载表格。
• 只接受公众号后台原始导出的 .xls 或 .xlsx，单份最大 5 MB；不要要求 CSV、手动修改表头或自行汇总的数据。
• 未认证/个人号还应提供近一个月 3–5 条公众号文章链接（最多 5 条）。

生成最终报告

取得 diagnosisData 后，阅读 [references/diagnosis-data.md](references/diagnosis-data.md)，并使用用户当前选择的模型输出以下固定结构：

1. 数据可信度
2. 账号定位
3. 内容观察
4. 运营问题
5. 增长机会
6. 选题建议
7. 未来两周行动清单

遵守这些结论边界：

• 将 warnings、missingData、supplementWarning 以及指标的可用性、覆盖范围写入“数据可信度”，并降低对应结论的确定性。
• 缺失指标不是 0；不得把缺失的阅读、分享、粉丝或发布数据推断成账号事实。
• material.articles 只是最多 20 篇的样本，单篇 contentPreview 最多 1,200 字；不得将它们当作总发文量或发布频率。
• 仅根据数据包作答。数据不足时明确降级范围，并在行动清单中给出补数建议。
• dataSources 与单项指标 source 表明来源；公开网页文章字段缺失即为未知，不能推断封面、评论等状态。

错误处理与履约

• AUTHORIZATION_PENDING：提示用户完成授权后重试，不创建新订单。
• NOT_PAID：等待用户完成支付后，以原请求重试，不创建新订单。
• 任务 failed：停止重试并说明数据包未生成；此类授权、数据拉取或生成失败由墨笔发起退款。
• 墨笔成功交付完整 diagnosisData 即已履约。调用方模型余额不足、模型不可用或用户不满意最终分析内容，不触发墨笔退款。
• 本技能按次付费、不限使用次数。用户每次需要诊断时都可从「创建授权会话」重新发起，生成一份独立报告；同一笔订单交付后数据包即作废、不可复读，如需刷新结论或换号诊断，请新开一笔诊断（新的授权会话 + 新的订单），不要复用已交付订单的数据或订单号。