skillfree 0.1.39 → 0.1.40

package/SKILL.md

@@ -1,163 +1,161 @@
 ---
 name: skillfree
-description: SkillFree — 模型与技能严选平台。只保留每个任务类型最强的模型，按实际用量精确计费。写代码用Claude，文档分析用GPT，多模态用Gemini，生图用nano banana，生视频用Veo，文档OCR用合合，网页搜索用Tavily。
+description: SkillFree — 模型与技能严选平台。只保留每个任务类型最强的模型，按实际用量精确计费。写代码用Claude，文档分析用GPT，多模态用Gemini，生图用nano banana，生视频用Veo，文档OCR用合合，网页搜索用Tavily，做PPT用AI演示文稿。
 metadata: {"openclaw": {"primaryEnv": "SKILLFREE_API_KEY", "emoji": "🦞", "homepage": "https://skillfree.tech", "requires": {"bins": ["skillfree"], "env": ["SKILLFREE_API_KEY"]}}}
 ---
 
 # SkillFree — 模型与技能严选平台 🦞
 
-> 不堆模型数量，只选每个场景最好用的那一个。按实际 token / 秒精确计费，用多少扣多少。
+> 不堆模型数量，只选每个场景最好用的那一个。按实际用量精确计费，用多少扣多少。
 
 ---
 
-## 🧭 任务 → 模型 一览
+## 🧭 任务 → 严选工具 一览
 
-| 任务 | 严选模型 |
-|------|---------|
-| ✍️ 写代码 / 代码审查 / 重构 | Claude Sonnet 4.6 |
-| 📄 文档分析 / 报告生成 / 长文理解 | GPT-5.4 |
-| 🖼️ 图文混合 / 多模态理解 | Gemini 3.1 Pro |
-| 🎨 图像生成 | nano banana 2 / nano banana pro |
-| 🎬 视频生成 | Veo 3.1 Fast / Veo 3.1 |
-| 📑 扫描文档 OCR 解析 | 合合 图文混排 |
-| 🌐 实时网页搜索 | Tavily（独立技能） |
+| 任务类型 | 严选工具 | 计费方式 |
+|---------|---------|---------|
+| ✍️ 写代码 / 重构 / 技术文档 | Claude Sonnet 4.6 | 按 token |
+| 📄 文档分析 / 报告生成 | GPT-5.4 | 按 token |
+| 🖼️ 图文多模态理解 | Gemini 3.1 Pro | 按 token |
+| 🎨 图像生成 | nano banana 2 / pro | 按次 |
+| 🎬 视频生成 | Veo 3.1 Fast / Veo 3.1 | 按秒 |
+| 📑 扫描文档 OCR | 合合 图文混排 | 按量 |
+| 🌐 实时网页搜索 | Tavily | 按次 |
+| 📊 演示文稿 / PPT 生成 | **AI 演示文稿生成** ✨ | **按实际页数** |
 
 ---
 
-## 💬 对话模型（chat）
-
-计费方式：按实际消耗 token 精确结算（¥/百万 tokens）
+## 💬 模型严选（chat / image / video / ocr）
 
 ### ✍️ 写代码 — Claude
 
-Claude 对代码的理解深度在所有模型中最强：能追踪跨文件上下文、精准定位 bug、给出可直接运行的重构方案。技术写作也是强项。
-
 | 模型ID | 名称 | 输入 | 输出 |
 |--------|------|------|------|
-| `claude-sonnet-4-6` | Claude Sonnet 4.6 ⭐ | ¥28/1M | ¥140/1M |
-| `claude-sonnet-4-6-cc` | Claude Sonnet 4.6 CC | ¥28/1M | ¥140/1M |
-| `claude-opus-4-6` | Claude Opus 4.6 | ¥140/1M | ¥700/1M |
-| `claude-opus-4-6-cc` | Claude Opus 4.6 CC | ¥140/1M | ¥700/1M |
-
-```bash
-skillfree pilot --type chat --model claude-sonnet-4-6 \
-  --prompt "重构这段代码，提升可读性并添加类型注解"
-```
+| `claude-sonnet-4-6` | Claude Sonnet 4.6 ⭐ | ¥30/1M | ¥150/1M |
+| `claude-sonnet-4-6-cc` | Claude Sonnet 4.6 CC | ¥30/1M | ¥150/1M |
+| `claude-opus-4-6` | Claude Opus 4.6 | ¥150/1M | ¥750/1M |
 
-**Claude 适合：** 代码生成、bug 定位、重构、架构设计、技术文档
-**Claude 不适合：** 实时联网信息、图片理解
+**适合：** 代码生成、bug 定位、重构、架构设计、技术文档
 
 ---
 
 ### 📄 文档分析 — GPT
 
-GPT 擅长结构化文档处理：读懂复杂格式后输出层次清晰的分析，在商业报告、合同条款提炼、数据表格解读上表现最稳。
-
 | 模型ID | 名称 | 输入 | 输出 |
 |--------|------|------|------|
-| `gpt-5.4` | GPT-5.4 ⭐ | ¥23/1M | ¥140/1M |
-| `gpt-5.4-mini` | GPT-5.4 Mini | ¥7/1M | ¥42/1M |
+| `gpt-5.4` | GPT-5.4 ⭐ | ¥33/1M | ¥200/1M |
+| `gpt-5.4-mini` | GPT-5.4 Mini | ¥10/1M | ¥60/1M |
 
-```bash
-skillfree pilot --type chat --model gpt-5.4 \
-  --prompt "提取这份投资协议中的核心条款和风险点"
-```
-
-**GPT 适合：** 商业文档、合同分析、结构化摘要、数据提炼、报告生成
-**GPT-mini 适合：** 大批量简单文档处理，成本敏感场景
+**适合：** 商业文档、合同分析、结构化摘要、数据提炼、报告生成
 
 ---
 
 ### 🖼️ 多模态理解 — Gemini
 
-Gemini 原生多模态架构，图片、PDF、表格、文字混合输入时理解最准。超长上下文窗口，适合需要"同时看多份材料"的复杂分析场景。
-
 | 模型ID | 名称 | 输入 | 输出 |
 |--------|------|------|------|
-| `gemini-3.1-pro-preview` | Gemini 3.1 Pro ⭐ | ¥23/1M | ¥94/1M |
-| `gemini-3.1-flash-lite-preview` | Gemini 3.1 Flash Lite | ¥1/1M | ¥4/1M |
-
-```bash
-skillfree pilot --type chat --model gemini-3.1-pro-preview \
-  --prompt "分析这张财务图表的关键趋势" --file chart.png
-```
+| `gemini-3.1-pro-preview` | Gemini 3.1 Pro ⭐ | ¥33/1M | ¥134/1M |
+| `gemini-3.1-flash-lite-preview` | Gemini 3.1 Flash Lite | ¥1.1/1M | ¥4.3/1M |
 
-**Gemini Pro 适合：** 图文混合分析、多模态推理、超长文档、多文件联合分析
-**Gemini Flash Lite 适合：** 大批量简单图文识别，极低成本
+**适合：** 图文混合分析、多模态推理、超长文档
 
 ---
 
-## 🎨 图像生成 — nano banana 系列
-
-基于 Google Gemini 图像模型。对自然语言描述理解准确，风格多样，中英文 prompt 均可，生成速度快。
+### 🎨 图像生成 — nano banana
 
 | 模型ID | 展示名 | 价格 |
 |--------|--------|------|
 | `gemini-3.1-flash-image-preview` | **nano banana 2** ⭐ | ¥0.40/次 |
 | `gemini-3-pro-image-preview` | **nano banana pro** | ¥1.40/次 |
 
-```bash
-# 快速生成（推荐日常使用）
-skillfree pilot --type image --model gemini-3.1-flash-image-preview \
-  --prompt "赛博朋克上海夜景，霓虹灯反射在雨后街道" --output ./image.png
-
-# 旗舰品质（商业级创作）
-skillfree pilot --type image --model gemini-3-pro-image-preview \
-  --prompt "产品包装图，极简风格，白底" --output ./image.png
-```
-
-**nano banana 2：** 日常创作、概念图、插画，速度快性价比高
-**nano banana pro：** 复杂场景构图、艺术风格精控、商业级输出
-
 ---
 
-## 🎬 视频生成 — Google Veo
-
-Google Veo 系列，物理运动自然，画质细腻。文字描述直接生成视频，异步生成自动轮询返回结果，支持三档分辨率，**成功生成后才扣费**。
+### 🎬 视频生成 — Google Veo
 
 | 模型ID | 名称 | 720p | 1080p | 4K |
 |--------|------|------|-------|-----|
 | `veo-3.1-fast-generate-preview` | **Veo 3.1 Fast** ⭐ | ¥1.5/s | ¥1.5/s | ¥3.5/s |
 | `veo-3.1-generate-preview` | **Veo 3.1** | ¥3.5/s | ¥3.5/s | ¥5.5/s |
 
-```bash
-# 快速版（推荐）
-skillfree pilot --type video --model veo-3.1-fast-generate-preview \
-  --prompt "樱花花瓣在微风中缓缓飘落，日式庭院，电影感" \
-  --seconds 8 --size 1920x1080 --output ./video.mp4
-
-# 旗舰版（商业级）
-skillfree pilot --type video --model veo-3.1-generate-preview \
-  --prompt "产品展示视频，极简白色空间" \
-  --seconds 6 --size 3840x2160 --output ./video.mp4
-```
-
-**分辨率：** `1280x720`（720p）· `1920x1080`（1080p）· `3840x2160`（4K）
-**时长：** `--seconds 4 / 6 / 8`（默认 8 秒）
+异步生成，成功后才扣费，支持 4~8 秒时长。
 
 ---
 
-## 📑 文档 OCR 解析 — 合合信息
-
-合合（hehe）专注文档智能解析，扫描版 PDF、图片文字、复杂排版（表格、公式、图文混排）识别率业界顶级，输出标准 Markdown，是纸质文档数字化的最优选择。
+### 📑 OCR 解析 — 合合信息
 
 | 模型ID | 名称 | 计费 |
 |--------|------|------|
 | `hehe-tywd` | **合合 图文混排解析** | 按量计费 |
 
-```bash
-skillfree pilot --type ocr --model hehe-tywd --file ./contract_scan.pdf
-```
+**适合：** 扫描版合同、学术论文、含表格财务文档
+
+---
+
+### 🌐 实时搜索 — Tavily
+
+作为独立技能安装，可与对话模型组合构建搜索增强工作流。
+
+---
+
+## ✨ 技能严选
 
-**适合：** 扫描版合同 / 报告、学术论文、含表格的财务文档、复杂排版文件
+> 技能 = 多步骤自动化工作流，比单一模型调用更强大。按任务结果计费，不按 token。
 
 ---
 
-## 🌐 实时搜索 — Tavily
+### 📊 AI 演示文稿生成
+
+输入主题或大纲，自动生成 **8-12 页专业演示文稿**，返回在线预览 + PDF 导出，无需任何设计功底。
+
+**✅ 适合场景**
+- 投资路演 BP、融资材料
+- 产品发布 / 项目汇报 / 周会材料
+- 提案文档、课件、培训材料
+
+**💰 定价策略**
+
+| 页数规模 | 预估费用 | 说明 |
+|---------|---------|------|
+| 标准（8-10页）| **约 ¥2.6~3.5** | 普通主题描述 |
+| 丰富（10-12页）| **约 ¥3.5~4.5** | 详细大纲输入 |
+
+> **按实际生成量计费**，不是固定价格。生成页数越多、内容越丰富，费用越高。  
+> 生成失败自动退款，不收任何费用。
+
+**⏱ 生成时长：** 约 30~60 秒（异步任务，提交后轮询结果）
+
+**🔌 API 调用**
+
+```bash
+# 第一步：提交任务（立即返回，< 2 秒）
+curl -X POST https://skillfree.tech/v1/presentations \
+  -H "Authorization: Bearer YOUR_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "ai-presentation",
+    "inputs": {
+      "text": "百图生科融资路演BP，AI驱动蛋白质大模型药物发现平台，xTrimoPGLM千亿参数，已融资2亿美元",
+      "language": "zh-cn"
+    }
+  }'
+# 返回：{ "task_id": "xxx", "status": "processing", "estimated_credits": 300 }
+
+# 第二步：轮询结果（每隔 8~10 秒查一次）
+curl https://skillfree.tech/v1/tasks/{task_id} \
+  -H "Authorization: Bearer YOUR_API_KEY"
+# 完成：{ "status": "completed", "result_url": "https://...", "credits_used": 273 }
+# 失败：{ "status": "failed", "error": "...", "credits_used": 0 }
+```
+
+**📋 参数说明**
 
-Tavily 是专为 AI 优化的搜索引擎，返回结构化摘要和来源，而非原始网页链接。适合实时信息查询、竞品调研、新闻追踪，配合对话模型使用效果最佳。
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `inputs.text` | ✅ | 主题描述或大纲，越详细生成质量越高 |
+| `inputs.language` | 否 | 语言代码，默认 `zh-cn`；英文用 `en` |
+| `inputs.format` | 否 | 固定为 `presentation`（演示文稿）|
 
-Tavily 作为独立技能安装使用，可与 SkillFree 对话模型组合构建搜索增强工作流。
+**🌍 支持语言：** `zh-cn`（简体中文）· `zh-tw`（繁体）· `en`（英文）· `ja`（日文）· `ko`（韩文）及 50+ 语言
 
 ---
 

package/bin/skillfree.js

@@ -36,14 +36,15 @@ auth
 // ── pilot ─────────────────────────────────────────────────────────────────────
 program
   .command('pilot')
-  .description('AI 智能调度：chat | image | video | ocr')
-  .option('--type <type>',    '调用类型: chat | image | video | ocr', 'chat')
-  .option('--prompt <text>',  '输入提示词')
-  .option('--file <path>',    '输入文件路径（ocr 用）')
-  .option('--output <path>',  '输出文件路径')
-  .option('--model <model>',  '指定模型（可选，不填自动选最优）')
-  .option('--size <size>',    '图像尺寸 或 视频分辨率（默认 1024x1024 / 1920x1080）')
-  .option('--seconds <sec>',  '视频时长：4 | 6 | 8（默认 8）', '8')
+  .description('AI 智能调度：chat | image | video | ocr | presentation')
+  .option('--type <type>',     '调用类型: chat | image | video | ocr | presentation', 'chat')
+  .option('--prompt <text>',   '输入提示词')
+  .option('--file <path>',     '输入文件路径（ocr 用）')
+  .option('--output <path>',   '输出文件路径')
+  .option('--model <model>',   '指定模型（可选，不填自动选最优）')
+  .option('--size <size>',     '图像尺寸 或 视频分辨率（默认 1024x1024 / 1920x1080）')
+  .option('--seconds <sec>',   '视频时长：4 | 6 | 8（默认 8）', '8')
+  .option('--language <lang>', '演示文稿语言（默认 zh-cn）', 'zh-cn')
   .action(async (flags) => {
     const { pilot } = require('../scripts/commands/pilot')
     await pilot(flags).catch(e => { console.error('❌', e.message); process.exit(1) })
@@ -59,6 +60,27 @@ program
     await pilot({ type: 'chat', prompt, ...flags }).catch(e => { console.error('❌', e.message); process.exit(1) })
   })
 
+// ── ppt（演示文稿快捷方式）──────────────────────────────────────────────────
+program
+  .command('ppt <prompt>')
+  .description('AI 演示文稿生成（约 30-60 秒，按实际页数计费）')
+  .option('--language <lang>', '语言代码（默认 zh-cn；英文用 en）', 'zh-cn')
+  .action(async (prompt, flags) => {
+    const { createPresentation } = require('../scripts/commands/presentation')
+    await createPresentation({ prompt, language: flags.language })
+      .catch(e => { console.error('❌', e.message); process.exit(1) })
+  })
+
+// ── tasks ─────────────────────────────────────────────────────────────────────
+const tasks = program.command('tasks').description('任务管理')
+tasks
+  .command('get <taskId>')
+  .description('查询异步任务状态（视频、演示文稿等）')
+  .action(async (taskId) => {
+    const { getTask } = require('../scripts/commands/presentation')
+    await getTask(taskId).catch(e => { console.error('❌', e.message); process.exit(1) })
+  })
+
 // ── models ────────────────────────────────────────────────────────────────────
 program
   .command('models')

package/install.sh

@@ -33,7 +33,7 @@ cat << 'EOF'
 EOF
 echo -e "${NC}"
 echo -e "  ${DIM}🦞  模型与技能严选平台 — 只选每个场景最好用的那一个${NC}"
-echo -e "  ${DIM}    Claude · GPT · Gemini · nano banana · Veo · 合合 OCR${NC}"
+echo -e "  ${DIM}    Claude · GPT · Gemini · nano banana · Veo · 合合 OCR · AI演示文稿${NC}"
 echo ""
 echo -e "  ${DIM}────────────────────────────────────────────────────${NC}"
 echo ""
@@ -62,13 +62,13 @@ echo -e "  ${DIM}正在从 npm 安装 skillfree...${NC}"
 echo ""
 
 INSTALL_OK=false
-if npm install -g skillfree 2>&1 | sed 's/^/    /'; then
+if npm install -g skillfree@latest 2>&1 | sed 's/^/    /'; then
   INSTALL_OK=true
 else
   echo ""
   warn "权限不足，尝试 sudo..."
   echo ""
-  if sudo npm install -g skillfree 2>&1 | sed 's/^/    /'; then
+  if sudo npm install -g skillfree@latest 2>&1 | sed 's/^/    /'; then
     INSTALL_OK=true
   fi
 fi
@@ -146,6 +146,10 @@ echo -e "  ${CYAN}做一个视频：${NC}"
 echo -e "  ${DIM}  $ skillfree pilot --type video --prompt \"一只未来感龙虾在霓虹都市中行走，电影感运镜\" --seconds 8 --size 1920x1080 --output ./video.mp4${NC}"
 echo ""
 
+echo -e "  ${CYAN}生成一份演示文稿（30-60秒）：${NC}"
+echo -e "  ${DIM}  $ skillfree ppt \"百图生科融资路演BP，AI蛋白质大模型药物发现平台，已融资2亿美元\"${NC}"
+echo ""
+
 echo -e "  ${CYAN}解析一份合同/文档：${NC}"
 echo -e "  ${DIM}  $ skillfree pilot --type ocr --file ./contract.pdf --output ./result.md${NC}"
 echo ""

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillfree",
-  "version": "0.1.39",
+  "version": "0.1.40",
   "description": "🦞 一个 API，满足所有龙虾技能需求",
   "main": "bin/skillfree.js",
   "bin": {

package/scripts/commands/auth.js

@@ -12,14 +12,9 @@ function injectToOpenclaw(apiKey) {
   // 1. 写入 openclaw.json
   const openclawDir = path.join(os.homedir(), '.openclaw')
   const cfgPath = path.join(openclawDir, 'openclaw.json')
-  if (fs.existsSync(openclawDir) && fs.existsSync(cfgPath)) {
+  if (fs.existsSync(openclawDir)) {
     let cfg = {}
-    try {
-      cfg = JSON.parse(fs.readFileSync(cfgPath, 'utf8'))
-    } catch (e) {
-      console.warn('⚠️  openclaw.json 解析失败，跳过自动配置')
-      return
-    }
+    try { cfg = JSON.parse(fs.readFileSync(cfgPath, 'utf8')) } catch {}
     cfg.skills = cfg.skills || {}
     cfg.skills.entries = cfg.skills.entries || {}
     cfg.skills.entries['skillfree'] = {

package/scripts/commands/pilot.js

@@ -156,7 +156,14 @@ async function pilot(flags) {
     return
   }
 
-  throw new Error(`不支持的类型: ${type}\n可选: chat | image | video | ocr`)
+  // ── PRESENTATION（AI 演示文稿，异步轮询）────────────────────────────────────
+  if (type === 'presentation') {
+    const { createPresentation } = require('./presentation')
+    await createPresentation({ prompt, language: flags.language, format: flags.format })
+    return
+  }
+
+  throw new Error(`不支持的类型: ${type}\n可选: chat | image | video | ocr | presentation`)
 }
 
 module.exports = { pilot }

package/scripts/commands/presentation.js

@@ -0,0 +1,100 @@
+/**
+ * AI 演示文稿生成（异步任务 + 轮询）
+ * 底层走 /v1/presentations → 拿 task_id → 轮询 /v1/tasks/:taskId
+ */
+const { getApiKey, BASE_URL, checkCredits } = require('../lib/client')
+
+const POLL_INTERVAL_MS = 5000   // 每 5 秒轮询一次
+const MAX_WAIT_MS      = 120000 // 最多等 2 分钟
+
+async function createPresentation(params) {
+  const apiKey = getApiKey()
+
+  if (!params.prompt && !params.text) {
+    throw new Error('--prompt 是必需的（主题描述或大纲）')
+  }
+
+  const inputText = params.prompt || params.text
+  const language  = params.language || 'zh-cn'
+  const format    = params.format   || 'presentation'
+
+  await checkCredits()
+
+  // Step 1: 提交任务
+  console.log('📊 提交演示文稿生成任务...')
+  const submitRes = await fetch(`${BASE_URL}/v1/presentations`, {
+    method: 'POST',
+    headers: {
+      'Authorization': `Bearer ${apiKey}`,
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify({
+      model: 'ai-presentation',
+      inputs: { text: inputText, language, format },
+    }),
+  })
+
+  const submitData = await submitRes.json()
+  if (!submitRes.ok || !submitData.task_id) {
+    throw new Error(submitData.error || submitData.message || `提交失败：HTTP ${submitRes.status}`)
+  }
+
+  const taskId = submitData.task_id
+  const estimated = submitData.estimated_credits || 300
+  console.log(`⏳ 生成中（预计约 30-60 秒）...`)
+  console.log(`   task_id: ${taskId}`)
+  console.log(`   预计消耗: ${estimated} 积分（¥${(estimated / 100).toFixed(2)}）\n`)
+
+  // Step 2: 轮询结果
+  const deadline = Date.now() + MAX_WAIT_MS
+  while (Date.now() < deadline) {
+    await new Promise(r => setTimeout(r, POLL_INTERVAL_MS))
+
+    const pollRes = await fetch(`${BASE_URL}/v1/tasks/${taskId}`, {
+      headers: { 'Authorization': `Bearer ${apiKey}` },
+    })
+    const task = await pollRes.json()
+
+    if (task.status === 'completed') {
+      const credits = task.credits_used ?? estimated
+      console.log(`✅ 生成完成！（实际消耗 ${credits} 积分，¥${(credits / 100).toFixed(2)}）\n`)
+      console.log(`🔗 在线预览：${task.result_url}`)
+      if (task.upstream_id && task.upstream_id.startsWith('http')) {
+        console.log(`📄 PDF 导出：${task.upstream_id}`)
+      }
+      return task
+    }
+
+    if (task.status === 'failed') {
+      throw new Error(`生成失败：${task.error || '未知错误'}（积分已自动退还）`)
+    }
+
+    // processing → 继续等待
+    process.stdout.write('.')
+  }
+
+  throw new Error('生成超时（超过 2 分钟），请稍后用以下命令查询进度：\n  skillfree tasks get ' + taskId)
+}
+
+async function getTask(taskId) {
+  const apiKey = getApiKey()
+  const res = await fetch(`${BASE_URL}/v1/tasks/${taskId}`, {
+    headers: { 'Authorization': `Bearer ${apiKey}` },
+  })
+  const task = await res.json()
+
+  if (!res.ok) throw new Error(task.error || `HTTP ${res.status}`)
+
+  const statusIcon = { completed: '✅', failed: '❌', processing: '⏳' }[task.status] || '❓'
+  console.log(`\n${statusIcon} 任务 ${task.task_id}`)
+  console.log(`   状态：${task.status}`)
+  console.log(`   模型：${task.model}`)
+  if (task.result_url) console.log(`   在线预览：${task.result_url}`)
+  if (task.upstream_id?.startsWith('http')) console.log(`   PDF 导出：${task.upstream_id}`)
+  if (task.error)  console.log(`   错误：${task.error}`)
+  console.log(`   创建：${task.created_at}`)
+  console.log(`   更新：${task.updated_at}`)
+  return task
+}
+
+module.exports = { createPresentation, getTask }