接入 AI-HIVE Connector
本 Skill 通过 AI-HIVE Connector 调用底层模型生成能力。CLI OAuth 模式接入流程：
- 首次安装：在 WorkBuddy 连接器列表中找到「AI-HIVE」，点击进入
- 完成授权：点击「连接」会弹出浏览器到 ai-hive.iclip.cn，在该网站登录 AI-HIVE 账户（无账户需先注册），点击授权
- 回到 WorkBuddy：授权完成后自动返回，Token 在本机保存（用户看不到）
- 日常使用：用户无需再次操作，直接调用本 Skill 即可
- 连接过期/失败：在 WorkBuddy 连接器列表中重新找到「AI-HIVE」，点击「重新连接」→ 完成浏览器 OAuth
- Token 安全：如 Token 疑似泄露，到 ai-hive.iclip.cn → 账户设置 → 撤销所有 Token
能力范围
AI-HIVE 文本生成 Skill 通过 AI-HIVE Connector 完成端到端文本任务。本 Skill 使用 AI-HIVE Connector 提供的以下工具：
get_user_info：查询当前账户与余额；不接收参数。list_models：用modelType="TEXT"列出当前可用文本模型及价格快照，返回publicModelId与pricingSnapshot。chat_text：使用服务端选定的模型与价格快照调用文本生成；扣费由服务端自动结算。
需要生图、生视频或上传大文件，请分别改用 image-creator 或 video-creator。
覆盖场景：周报纪要润色 / 长报告总结 / 合同要点提炼 / 邮件拟稿 / 评论分类 / 多语言翻译 / 多步推理 / 长文多段生成 / 流式输出。
典型触发：当用户说"润色这段周报"、"总结这份报告"、"提炼这份合同的要点"、"帮我拟一封邮件"、"把这条评论分类"、"写一段 200 字会议纪要"、"中翻英/英翻中"、"分三步推理这道题"等任意办公文本生成需求时使用本 Skill。用户只是询问 AI-HIVE 能力、参数、积分或价格时，直接回答，不调用付费工具。
Prompt 骨架（通用模板）
逐场景组装时，按以下字段结构化；缺省字段留空，不强行填充：
| 字段 | 含义 | 示例 |
|---|---|---|
| 用途 | 文档类型 | 周报 |
| 受众 | 给谁看 | 主管 |
| 核心内容 | 要点 / 素材 | 本周 3 项进展 |
| 结构 | 大纲层级 | 1.进展 2.风险 3.计划 |
| 语气 | 正式 / 轻松 | 正式 |
| 约束 | 字数 / 语言 / 格式 | ≤500 字、中文 |
| 保留项 | 必须保留的信息 | 数据口径不变 |
| 输出规格 | 格式 | Markdown |
组装顺序：用途 → 受众 → 核心内容 → 结构 → 语气 → 约束 → 保留项 → 输出规格。仅保留有值的字段。
调用流程
本 Skill 的标准调用顺序如下。每步有明确的输入与输出；上一步失败时不得跳到下一步。
Step 0：连接检查
- 用户已通过 AI-HIVE Connector 完成 OAuth CLI 流程（如未连接，引导用户连接）。
Step 1：账户与模型初查
- 调用
get_user_info检查账户与余额。 - 调用
list_models(modelType="TEXT")获取可用模型清单与价格快照。
Step 2：模型推荐与选派
- 对照
references/model-scenarios.md中各文本模型的擅长场景，结合用户任务的难度、篇幅、语言等特点匹配擅长模型。 - 结合
list_models返回的可用routingMode及其对应pricingSnapshot，权衡效果与成本，向用户说明推荐理由；不假设每个模型都提供固定三档路由。 - 若用户未指定偏好，默认推荐效果与成本均衡的选项。
- 用户确认
publicModelId与routingMode后，进入下一步。
Step 3：构造请求
- 把用户在
messages中表达的内容整理为对话历史。 - 将选中项的
publicModelId、routingMode与pricingSnapshot原样传入chat_text。
Step 4：执行
- 调用
chat_text；仅在选中模型支持且任务确有需要时设置thinkingEnabled。 - 失败时按
../references/error-catalog.md处理，不重试扣费。
Step 5：交付
- 把
content完整呈现给用户。 - 若仅是查询类需求（账户余额、可用模型），完成 Step 1 后可直接交付，不需要执行 Step 2-3。
适用场景
- 用户希望生成结构化文本，例如问答、摘要、改写、分类、推理或多步规划。
- 用户提供素材只是上下文背景，最终输出仍是文字。
- 用户希望确认账户余额或筛选适合当前任务的文本模型。
- 用户需要多语言生成（中文、英文、小语种）。
非适用场景
- 目标是图片或视频；必须切换到
image-creator或video-creator。 - 本地文件路径不可访问、未上传到对话或不在 Skill 可达范围。
- 用户要求绕过积分、版权或安全审核。
- 涉及明显违法、侵权、色情、暴力、仇恨、欺诈或其他敏感内容。
- 用户只是询问"AI-HIVE 能做什么"，并不要求真正生成；直接回答问题，不调用付费工具。
事实与合规边界
- 只使用工具真实返回的
publicModelId、pricingSnapshot、生成结果与错误代码；不编造积分、模型或任务状态。 - 不擅自构造或修改
pricingSnapshot；最终费用按 AI-HIVE 实际用量与账单计算。 - 不静默切换用户选定的模型或参数；余额不足或模型下线时返回错误并给出下一步。
- 不宣称对版权、商标或肖像权作法律判定；不索要、记录或写入用户 Token。
- 对未成年人、裸露、暴力、仇恨与违法内容采取保守判断；无法确认合规时停止创建并说明原因。
- Token 只在 AI-HIVE Connector 凭证设置中填写，不得在对话中粘贴。
输入检查
正式调用前逐项确认：
- 明确文本目标类型、目标语言、长度范围、输出格式（Markdown/JSON/纯文本）。
- 本地素材必须来自用户主动选择的文件，不读取非授权文件。
- 调用
get_user_info检查余额；不足时直接提示充值。 - 调用
list_models选定模型并保留服务端返回值，不在客户端改写。 - 用户对措辞、语气、规避词或受众有要求时合并到
messages，不得静默丢弃。 - 用户未给定格式时，先询问结构化输出要求，不自行选择。
调用示例
全部示例均基于上文"输入检查"，遵循
../references/tool-catalog.md与../references/error-catalog.md的口径。 用户表达 → AI 的多步行为 → 输出。
示例 1：周报总结
用户表达：把这份周报总结成 3 条要点。
AI 行为：
- 用户已把周报内容作为对话上下文。调用
get_user_info检查余额。 - 调用
list_models(modelType="TEXT")获取可用文本模型与价格快照。 - 对照
references/model-scenarios.md，长文摘要推荐 kimi-k2.6（长程）或 deepseek-v3.1-fast（快速），结合pricingSnapshot权衡后向用户说明推荐理由；用户确认publicModelId与routingMode。 - 构造
messages，包含周报原文 + "请总结为 3 条要点"。 - 调用
chat_text拿到总结。
输出：
- 模型与参数：服务端实际采用值
- 摘要：完整的 3 条要点
- 下一步：等待用户确认、改写或保存
示例 2：余额查询（只读）
用户表达：看下我的 AI-HIVE 账户余额。
AI 行为：
- 直接调用
get_user_info。 - 按
../references/error-catalog.md的脱敏规则遮盖余额以外的无关字段。
输出：
- 账户：xxxx
- 余额：x.xx 元
- 下一步：等待用户确认
示例 3：余额不足
用户表达：帮我写一段产品文案。
AI 行为：
get_user_info显示余额不足 → 不再调用付费工具。- 不重试扣费，也不调用
chat_text。 - 引导用户在 AI-HIVE 完成充值，充值后再调用。
输出：
- 状态：账户余额不足
- 下一步：充值后重试
工具参数
get_user_info
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| — | — | — | 不接收任何参数；返回账户与余额信息 |
list_models
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
modelType | string | 可选 | — | TEXT / IMAGE / VIDEO；本 Skill 显式传入 "TEXT" |
chat_text
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
publicModelId | string | ✅ | — | 来自 list_models 的当前模型 ID |
routingMode | string | ✅ | — | 选中模型实际返回的路由 |
messages | array | ✅ | — | 至少一条；每条包含 role、非空 content 与可选 mediaIds |
thinkingEnabled | boolean | 可选 | 服务端默认 | 仅在模型支持时使用 |
pricingSnapshot | object | ✅ | — | 选中模型与路由的价格快照，原样传入 |
费用授权
chat_text调用即按服务端计费，无需额外授权步骤。- 失败、被拒绝或余额不足时不重试扣费，只返回错误并询问用户下一步。
- 用户修改模型、路由、消息或
thinkingEnabled后必须重新调用，不复用旧结果。 - 模型未出现在
list_models返回中时，说明当前不可用并建议用户改用列表中的其他模型。
状态与错误处理
余额不足 / 请求被拒
AI-HIVE 官网：https://ai-hive.iclip.cn
充值路径（账户已存在）：
- 访问 https://ai-hive.iclip.cn → 登录 AI-HIVE 账户
- 进入「账户中心」/「钱包」/「充值」页面
- 选择充值套餐或自定义金额 → 完成支付
- 充值成功后回到 WorkBuddy，无需重新连接 Connector，直接重试任务
注册路径（首次用户）：
- 直接访问 https://ai-hive.iclip.cn/login，进入注册页面
- 使用手机号完成注册
- 登录 → 回到 WorkBuddy 重新连接 AI-HIVE Connector 即可
价格透明：
- 每次调用前可调
get_user_info查看当前余额 - 调用后实际扣费以服务端
pricingSnapshot为准 - 若工具明确提示余额不足，停止付费调用并展示可读消息
- 详细价格参考：https://ai-hive.iclip.cn/pricing
常见扣费场景参考（具体以服务端为准）：
- 文本生成：按 token 数计费
- 图片生成：按张数 + 分辨率计费
- 视频生成：按秒数 + 分辨率计费
其他被拒原因：
-
账户被风控：联系 AI-HIVE 客服（https://ai-hive.iclip.cn → 登录 → 设置 → 联系客服）
-
模型临时不可用：稍后重试或换模型
-
内容违规审核：调整 prompt 后重试（避免敏感内容）
-
成功：完整呈现
chat_text返回的内容。当前 MCP 工具为同步调用，不声称存在 SSE 流式片段。 -
服务端 5xx：展示工具返回的可读消息；不在客户端自动重试计费调用。
-
鉴权失败 / 连接过期：WorkBuddy → Connector 设置 → 找到 AI-HIVE → 点击"重新连接" → 完成浏览器 OAuth 流程；如仍失败，到 ai-hive.iclip.cn → 账户设置 → 撤销所有 Token → 重新发起授权
-
AI-HIVE 账户无余额：展示余额不足的可读消息，引导用户在 ai-hive.iclip.cn 完成充值后再试
-
AI-HIVE 服务端错误：按
error-catalog.md处理，不自行重试扣费 -
模型不存在或下线：以
list_models的当前返回为准，不自动改用其他模型替代。 -
超时或网络不明：保留工具原始错误，不声称已部分完成。
-
请求中断或超时：说明结果未确认，不臆测未返回内容。
输出模板
成功
- 模型与参数：服务端实际采用值
- 价格（如有）：仅服务端回写时显示
- 内容：完整文本
- 下一步：等待用户确认、改写或保存
失败
- 错误码：
failure.code（仅工具返回时展示） - 错误摘要：
failure.summary或工具可读消息 - 原因摘要：工具给出的可读描述
- 下一步建议：充值、改连 Connector、切换模型或稍后重试
部分失败
- 已成功片段：完整呈现
- 失败段：工具明确返回的失败摘要与时间戳
- 不得为失败段落猜测内容
