social-media-publisher

社交媒体发布

使用此技能，通过 PostPlus 管理的社交发布工作区创建、更新、列出、删除、安排或发布社交帖子。

所有权与身份验证边界

PostPlus 持有由平台所有的社交发布工作区。最终用户无需单独注册发布服务账号，也不应向 Agent 提供第三方发布服务凭据。

频道接入使用 PostPlus 邀请链接流程：

1. PostPlus Cloud 为目标社交平台创建邀请链接。
2. 用户在平台的 OAuth 页面授权其社交账号。
3. 生成的频道令牌存入 PostPlus 社交发布工作区。
4. PostPlus 使用用户的 PostPlus 账号 ID 标记该频道。

脚本接收的是由 PostPlus 托管的请求封装，而非隐藏的服务器凭据。

命令

每次调用运行一个操作。操作即子命令：

postplus publish <operation> --request <input.json> --output <result.json>

<input.json> 是该操作的发布 input 对象。CLI 会生成 operationId，并向 PostPlus 社交发布工作区发送请求。

产生副作用的操作（创建、安排、发布、删除）在产生任何费用之前，可能会返回报价确认挑战。遇到这种情况时，运行 postplus quote confirm --json --challenge-file <challenge.json>，然后使用 --quote-confirmation-token <token> 重试同一命令。

postplus publish analytics --request request.json --output result.json

遵循 CLI 的结构化结果和报告的下一步操作；不要根据自由文本消息推断恢复方式。 需要用户明确批准时，请等待；某项操作本身并不代表用户授权产生费用、发布或覆盖内容。 通过返回的检查点或操作继续同一操作；不要重新提交状态不确定的工作、重复已耗尽的恢复尝试，也不要通过切换提供方来绕过故障。

必需输入

• 与所选操作匹配的发布 input 对象：工作区／账号身份、集成 ID，以及所需的内容／媒体、帖子 ID 或群组 ID。

默认工作流

1. 确认频道是通过邀请链接流程接入的。
2. 列出频道以确认准确的集成 ID。
3. 为该操作构建发布 input 并运行命令。
4. 除非用户明确批准安排或发布，否则将可供审核的工作保留为 draft；实际发布／安排发布需要人工批准和当前频道凭据。

面向用户的阻塞情况

遇到以下情况时，停止操作并说明原因：

• 没有可用的 PostPlus 身份验证／会话；
• 频道不是通过邀请链接流程接入的；
• 缺少集成 ID，或该 ID 对应的频道尚未接入；
• 缺少必需的内容、媒体、帖子 ID 或群组 ID；
• 需要批准或报价确认；
• 发布类操作缺少授权资格或当前频道凭据；
• 托管服务返回稳定的产品错误。

不要泄露服务器端实现名称，也不要索取第三方发布服务凭据。不得绕过报价确认或审批边界。

移交

返回结构化预览／结果 JSON、需要时提供的批准或报价确认命令，或准确的产品错误及下一步边界。

公开命令边界

• 根据用户输入选择最匹配且范围最小的操作，并直接运行。

• 就绪情况诊断：postplus doctor --skill social-media-publisher。

• 仅在构造或修复未知请求结构时使用 postplus publish schema --json。

• 明确保持审批边界；未经人工批准且没有当前频道凭据，不要执行不可逆的发布操作。