Knowfun.io API 技能

该技能帮助您调用 Knowfun.io OpenAPI，生成教育内容、海报、游戏和影片。

前提条件

使用此技能前，您需要：

1. 一个 Knowfun.io API Key（可从 https://www.knowfun.io/api-platform 获取）
2. 账户中拥有充足的积分

配置

将您的 API Key 设置为环境变量：

export KNOWFUN_API_KEY="kf_your_api_key_here"

或者，该技能将在需要时提示您输入 API Key。

可用命令

调用该技能后，支持以下操作：

1. 创建任务

通过创建任务来生成内容。支持四种类型：course、poster、game、film。

基础示例：

/knowfun create course "机器学习入门"
/knowfun create poster "气候变化事实"
/knowfun create game "Python 基础学习"
/knowfun create film "互联网发展史"

指定 URL 输入：

/knowfun create course https://example.com/document.pdf

2. 查询任务状态

根据任务 ID 查询其当前状态：

/knowfun status 

3. 获取任务详情

获取已完成任务的详细信息：

/knowfun detail 

4. 列出任务

列出最近创建的任务：

/knowfun list

5. 查询积分余额

查询您的账户积分余额：

/knowfun credits

6. 获取配置模式（Schema）

获取每种任务类型所支持的全部配置选项：

/knowfun schema

任务配置

每种任务类型均有特定的配置选项。完整说明请参见 api-reference.md。

课程（Course）配置

• contentStyle：detailed、concise、conversational
• contentLanguage：zh、en 等
• explainLanguage：zh、en 等
• voiceType：标准语音选项
• ttsStyle：classroom、professional 等

海报（Poster）配置

• usage：infographic（默认）、businessReports、marketing、illustration
• style：handDrawn（默认）、photorealistic、anime、sciFi、custom
• aspectRatio：1:1、16:9、9:16 等
• posterTitle：海报自定义标题

游戏（Game）配置

• gameType：story、interactive（默认）、explore、mission、roleplay、simulation、puzzle、arcade、card、word、timeline、custom
• customPrompt：自定义游戏描述

影片（Film）配置

• filmStyle：narration（默认）、story、documentary、tutorial、concept_explainer、case_study、animation、cinematic、promotional、custom
• aspectRatio：16:9（默认）、9:16、1:1
• visualStyle：自定义视觉风格描述

该技能的工作原理

1. 提取 API Key：首先检查是否已设置 KNOWFUN_API_KEY 环境变量
2. 解析命令：识别命令类型（create、status、list、credits、schema）及其参数
3. 发起 API 请求：使用 curl 调用 Knowfun.io API
4. 格式化响应：将结果以易读格式呈现
5. 错误处理：提供清晰的错误提示及排障建议

API 接口地址

该技能使用的基地址如下：

• 生产环境：https://api.knowfun.io

示例

完整的使用示例请参见 examples.md。

错误处理

常见错误及解决方法：

• 401 Unauthorized：请确认 API Key 正确且未过期
• 402 Insufficient Credits：请前往 https://knowfun.io 为账户充值
• 429 Rate Limit：稍等片刻后重试
• 400 Bad Request：请检查输入参数是否符合要求

参考文档

完整的 API 文档请参见 api-reference.md。

实现细节

当该技能被调用时，Claude 将执行以下步骤：

1. 验证 API Key 是否可用
2. 从 $ARGUMENTS 中解析命令及参数
3. 构造合适的 curl 命令调用 Knowfun.io API
4. 处理认证请求头（Authentication Headers）
5. 解析返回的 JSON 响应
6. 格式化结果以便展示
7. 提供可操作的后续步骤建议

该技能在 API 请求中使用 curl，在支持时使用 jq 进行 JSON 解析。