接入 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:按text列出当前可用模型及价格快照,返回publicModelId与pricingSnapshot。chat_text:使用服务端选定的模型与价格快照调用文本生成;扣费由服务端自动结算。
需要生图、生视频或上传大文件,请分别改用 image-creator 或 video-creator。
覆盖场景:周报纪要润色 / 长报告总结 / 合同要点提炼 / 邮件拟稿 / 评论分类 / 多语言翻译 / 多步推理 / 长文多段生成 / 流式输出。
典型触发:当用户说"润色这段周报"、"总结这份报告"、"提炼这份合同的要点"、"帮我拟一封邮件"、"把这条评论分类"、"写一段 200 字会议纪要"、"中翻英/英翻中"、"分三步推理这道题"等任意办公文本生成需求时使用本 Skill。用户只是询问 AI-HIVE 能力、参数、积分或价格时,直接回答,不调用付费工具。
调用流程
本 Skill 的标准调用顺序如下。每步有明确的输入与输出;上一步失败时不得跳到下一步。
Step 0:连接检查
- 用户已通过 AI-HIVE Connector 完成 OAuth CLI 流程(如未连接,引导用户连接)。
Step 1:账户与模型初查
- 调用
get_user_info检查账户与余额。 - 调用
list_models(kind="text")获取可用模型清单与价格快照。
Step 2:模型推荐与选派
- 对照
references/model-scenarios.md中各文本模型的擅长场景,结合用户任务的难度、篇幅、语言等特点匹配擅长模型。 - 结合
list_models返回的pricingSnapshot(含 COST_FIRST / SPEED_FIRST / SUCCESS_FIRST 三档计费),权衡效果与成本,向用户说明推荐理由。 - 若用户未指定偏好,默认推荐效果与成本均衡的选项。
- 用户确认
publicModelId与routingMode后,进入下一步。
Step 3:构造请求
- 把用户在
messages中表达的内容整理为对话历史。 - 把 Step 1 返回的
model对象(含publicModelId与pricingSnapshot)作为chat_text.model入参。
Step 4:执行
- 调用
chat_text,按temperature/maxTokens等参数生成。 - 失败时按
../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(kind="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显示余额不足 → 收到INSUFFICIENT_BALANCE。- 不重试扣费,也不调用
chat_text。 - 引导用户在 AI-HIVE 完成充值,充值后再调用。
输出:
- 错误码:
INSUFFICIENT_BALANCE - 下一步:充值后重试
工具参数
get_user_info
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| — | — | — | 不接收任何参数;返回账户与余额信息 |
list_models
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
kind |
string | 可选 | "text" |
资源类型;本 Skill 仅关心 "text" |
cursor |
string | 可选 | 空 | 分页游标 |
chat_text
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model |
object | ✅ | — | 来自 list_models 的模型引用,含 publicModelId 与 pricingSnapshot |
messages |
array | ✅ | — | 对话历史与本轮输入;不允许伪造系统或用户消息 |
stream |
boolean | 可选 | false |
是否走流式响应 |
temperature |
number | 可选 | 服务端默认 | 越高越发散 |
maxTokens |
integer | 可选 | 服务端默认 | 单次输出最大 token 数 |
费用授权
chat_text调用即按服务端计费,无需额外授权步骤。- 失败、被拒绝或余额不足时不重试扣费,只返回错误并询问用户下一步。
- 用户修改模型、消息、
temperature或maxTokens后必须重新调用,不复用旧扣费配额。 - 模型暂时下线时返回
MODEL_UNAVAILABLE,建议用户改用其他模型。
状态与错误处理
成功:返回
content字段或流式片段;流式时按 SSE 拼装后呈现给用户。服务端 5xx:返回
errorCode与errorCategory;可建议用户稍后重试,不在客户端自动重试扣费。鉴权失败 / 连接过期:WorkBuddy → Connector 设置 → 找到 AI-HIVE → 点击"重新连接" → 完成浏览器 OAuth 流程;如仍失败,到 ai-hive.iclip.cn → 账户设置 → 撤销所有 Token → 重新发起授权
AI-HIVE 账户无余额:返回 INSUFFICIENT_BALANCE,引导用户在 ai-hive.iclip.cn 完成充值后再试
AI-HIVE 服务端错误:按
error-catalog.md处理,不自行重试扣费模型不存在或下线:返回
MODEL_UNAVAILABLE,不自动改用其他模型替代。超时或网络不明:保留工具原始错误,不声称已部分完成。
流式中断:只返回已接收的片段,不得臆测后续内容。
输出模板
成功
- 模型与参数:服务端实际采用值
- 价格(如有):仅服务端回写时显示
- 内容:完整文本或分段引用
- 下一步:等待用户确认、改写或保存
失败
- 错误码:
errorCode(安全展示) - 错误分类:
errorCategory - 原因摘要:工具给出的可读描述
- 下一步建议:充值、改连 Connector、切换模型或稍后重试
部分失败
- 已成功片段:完整呈现
- 失败段:错误码与时间戳
- 不得为失败段落猜测内容