felo-ai 0.2.0 → 0.2.2

package/felo-slides/scripts/run_ppt_task.mjs

@@ -0,0 +1,251 @@
+#!/usr/bin/env node
+
+const DEFAULT_API_BASE = 'https://openapi.felo.ai';
+const DEFAULT_INTERVAL_SEC = 10;
+const DEFAULT_MAX_WAIT_SEC = 1800;
+const DEFAULT_TIMEOUT_SEC = 60;
+
+function usage() {
+  console.error(
+    [
+      'Usage:',
+      '  node felo-slides/scripts/run_ppt_task.mjs --query "your prompt" [options]',
+      '',
+      'Options:',
+      '  --query <text>        PPT prompt (required)',
+      '  --interval <seconds>  Poll interval, default 10',
+      '  --max-wait <seconds>  Max wait time, default 1800',
+      '  --timeout <seconds>   Request timeout, default 60',
+      '  --json                Print JSON output',
+      '  --verbose             Print polling status to stderr',
+      '  --help                Show this help',
+    ].join('\n')
+  );
+}
+
+function parseArgs(argv) {
+  const out = {
+    query: '',
+    intervalSec: DEFAULT_INTERVAL_SEC,
+    maxWaitSec: DEFAULT_MAX_WAIT_SEC,
+    timeoutSec: DEFAULT_TIMEOUT_SEC,
+    json: false,
+    verbose: false,
+  };
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const a = argv[i];
+    if (a === '--help' || a === '-h') {
+      out.help = true;
+    } else if (a === '--json') {
+      out.json = true;
+    } else if (a === '--verbose' || a === '-v') {
+      out.verbose = true;
+    } else if (a === '--query') {
+      out.query = argv[i + 1] ?? '';
+      i += 1;
+    } else if (a === '--interval') {
+      out.intervalSec = Number.parseInt(argv[i + 1] ?? '', 10);
+      i += 1;
+    } else if (a === '--max-wait') {
+      out.maxWaitSec = Number.parseInt(argv[i + 1] ?? '', 10);
+      i += 1;
+    } else if (a === '--timeout') {
+      out.timeoutSec = Number.parseInt(argv[i + 1] ?? '', 10);
+      i += 1;
+    } else if (!a.startsWith('-') && !out.query) {
+      out.query = a;
+    }
+  }
+
+  if (!Number.isFinite(out.intervalSec) || out.intervalSec <= 0) out.intervalSec = DEFAULT_INTERVAL_SEC;
+  if (!Number.isFinite(out.maxWaitSec) || out.maxWaitSec <= 0) out.maxWaitSec = DEFAULT_MAX_WAIT_SEC;
+  if (!Number.isFinite(out.timeoutSec) || out.timeoutSec <= 0) out.timeoutSec = DEFAULT_TIMEOUT_SEC;
+  return out;
+}
+
+function normalizeStatus(v) {
+  return String(v ?? '').trim().toUpperCase();
+}
+
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+function getMessage(payload) {
+  return (
+    payload?.message ||
+    payload?.error ||
+    payload?.msg ||
+    payload?.code ||
+    'Unknown error'
+  );
+}
+
+function isApiError(payload) {
+  const status = payload?.status;
+  const code = payload?.code;
+  if (typeof status === 'string' && status.toLowerCase() === 'error') return true;
+  if (typeof code === 'string' && code && code.toUpperCase() !== 'OK') return true;
+  return false;
+}
+
+async function fetchJson(url, init, timeoutMs) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const res = await fetch(url, { ...init, signal: controller.signal });
+    let body = {};
+    try {
+      body = await res.json();
+    } catch {
+      body = {};
+    }
+
+    if (!res.ok) {
+      throw new Error(`HTTP ${res.status}: ${getMessage(body)}`);
+    }
+    if (isApiError(body)) {
+      throw new Error(getMessage(body));
+    }
+    return body;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+function extractTaskUrls(historicalData, createData) {
+  const pptUrl = historicalData?.ppt_url || '';
+  const liveDocUrl =
+    historicalData?.live_doc_url ||
+    (historicalData?.live_doc_short_id || historicalData?.livedoc_short_id || createData?.livedoc_short_id
+      ? `https://felo.ai/livedoc/${historicalData?.live_doc_short_id || historicalData?.livedoc_short_id || createData?.livedoc_short_id}`
+      : '');
+  return {
+    pptUrl,
+    liveDocUrl,
+    displayUrl: pptUrl || liveDocUrl,
+  };
+}
+
+async function createTask(apiKey, apiBase, query, timeoutMs) {
+  const payload = await fetchJson(
+    `${apiBase}/v2/ppts`,
+    {
+      method: 'POST',
+      headers: {
+        Accept: 'application/json',
+        Authorization: `Bearer ${apiKey}`,
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify({ query }),
+    },
+    timeoutMs
+  );
+  const data = payload?.data ?? {};
+  if (!data.task_id) {
+    throw new Error('Unexpected response: missing task_id');
+  }
+  return data;
+}
+
+async function queryHistorical(apiKey, apiBase, taskId, timeoutMs) {
+  const payload = await fetchJson(
+    `${apiBase}/v2/tasks/${encodeURIComponent(taskId)}/historical`,
+    {
+      method: 'GET',
+      headers: {
+        Accept: 'application/json',
+        Authorization: `Bearer ${apiKey}`,
+      },
+    },
+    timeoutMs
+  );
+  return payload?.data ?? {};
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  if (args.help) {
+    usage();
+    process.exit(0);
+  }
+  if (!args.query) {
+    usage();
+    process.exit(1);
+  }
+
+  const apiKey = process.env.FELO_API_KEY?.trim();
+  if (!apiKey) {
+    console.error('ERROR: FELO_API_KEY not set');
+    process.exit(1);
+  }
+
+  const apiBase = (process.env.FELO_API_BASE?.trim() || DEFAULT_API_BASE).replace(/\/$/, '');
+  const timeoutMs = args.timeoutSec * 1000;
+  const intervalMs = args.intervalSec * 1000;
+  const maxWaitMs = args.maxWaitSec * 1000;
+
+  const createData = await createTask(apiKey, apiBase, args.query, timeoutMs);
+  const taskId = createData.task_id;
+  if (args.verbose) {
+    console.error(`Task ID: ${taskId}`);
+  }
+
+  const startAt = Date.now();
+  let lastStatus = '';
+
+  while (Date.now() - startAt <= maxWaitMs) {
+    const historicalData = await queryHistorical(apiKey, apiBase, taskId, timeoutMs);
+    const taskStatus = normalizeStatus(historicalData.task_status || historicalData.status);
+    const urls = extractTaskUrls(historicalData, createData);
+    lastStatus = taskStatus || 'UNKNOWN';
+
+    if (args.verbose) {
+      const elapsedSec = Math.floor((Date.now() - startAt) / 1000);
+      console.error(`[${elapsedSec}s] Status: ${lastStatus}`);
+    }
+
+    if (taskStatus === 'COMPLETED' || taskStatus === 'SUCCESS') {
+      if (!urls.displayUrl) {
+        throw new Error('Task completed but no ppt_url/live_doc_url is available');
+      }
+      if (args.json) {
+        console.log(
+          JSON.stringify(
+            {
+              status: 'ok',
+              data: {
+                task_id: taskId,
+                task_status: taskStatus,
+                ppt_url: urls.pptUrl || null,
+                live_doc_url: urls.liveDocUrl || null,
+                livedoc_short_id: createData.livedoc_short_id ?? historicalData.live_doc_short_id ?? historicalData.livedoc_short_id ?? null,
+                ppt_business_id: createData.ppt_business_id ?? null,
+              },
+            },
+            null,
+            2
+          )
+        );
+      } else {
+        console.log(urls.displayUrl);
+      }
+      return;
+    }
+
+    if (taskStatus === 'FAILED' || taskStatus === 'ERROR') {
+      throw new Error(`Task finished with status: ${taskStatus}`);
+    }
+
+    await sleep(intervalMs);
+  }
+
+  throw new Error(`Timed out after ${args.maxWaitSec}s. Last status: ${lastStatus || 'UNKNOWN'}`);
+}
+
+main().catch((err) => {
+  console.error(`ERROR: ${err?.message || err}`);
+  process.exit(1);
+});
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "felo-ai",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Felo AI CLI - real-time search from the terminal",
   "type": "module",
   "main": "src/cli.js",
@@ -28,6 +28,6 @@
     "felo-search": "^0.1.1"
   },
   "scripts": {
-    "test": "node --test tests/"
+    "test": "node --test \"tests/*.js\""
   }
 }

package/src/cli.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 import { createRequire } from 'module';
 import { Command } from 'commander';
@@ -30,7 +30,9 @@ program
       verbose: opts.verbose,
       timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
     });
-    process.exit(code);
+    process.exitCode = code;
+    // Defer exit so stdout/stderr can flush; avoids Node.js Windows UV_HANDLE_CLOSING assertion
+    setTimeout(() => process.exit(code), 0);
   });
 
 program
@@ -40,15 +42,15 @@ program
   .option('-j, --json', 'output raw JSON with task_id and live_doc_url')
   .option('-v, --verbose', 'show polling status')
   .option('-t, --timeout <seconds>', 'request timeout in seconds for each API call', '60')
-  .option('--poll-timeout <seconds>', 'max seconds to wait for task completion', '600')
+  .option('--poll-timeout <seconds>', 'max seconds to wait for task completion', '1200')
   .action(async (query, opts) => {
     const timeoutMs = parseInt(opts.timeout, 10) * 1000;
-    const pollTimeoutMs = parseInt(opts.pollTimeout, 10) * 1000 || 600000;
+    const pollTimeoutMs = parseInt(opts.pollTimeout, 10) * 1000 || 1_200_000;
     const code = await slides(query, {
       json: opts.json,
       verbose: opts.verbose,
       timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
-      pollTimeoutMs: Number.isNaN(pollTimeoutMs) ? 600000 : pollTimeoutMs,
+      pollTimeoutMs: Number.isNaN(pollTimeoutMs) ? 1_200_000 : pollTimeoutMs,
     });
     process.exitCode = code;
     // Defer exit so stderr can flush; reduces Node.js Windows assertion (UV_HANDLE_CLOSING)

package/src/slides.js

@@ -2,8 +2,8 @@ import { getApiKey, fetchWithTimeoutAndRetry, NO_KEY_MESSAGE } from './search.js
 
 const DEFAULT_API_BASE = 'https://openapi.felo.ai';
 const DEFAULT_REQUEST_TIMEOUT_MS = 60_000;
-const POLL_INTERVAL_MS = 3000;
-const MAX_POLL_TIMEOUT_MS = 600_000; // 10 minutes max wait
+const POLL_INTERVAL_MS = 10_000;
+const MAX_POLL_TIMEOUT_MS = 1_200_000; // 20 minutes max wait
 
 const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
 const STATUS_LINE_PAD = 50;
@@ -35,6 +35,10 @@ function clearStatusLine() {
   process.stderr.write(`\r${' '.repeat(STATUS_LINE_PAD)}\r`);
 }
 
+function normalizeTaskStatus(status) {
+  return String(status || '').trim().toUpperCase();
+}
+
 /**
  * Create a PPT task. Returns { task_id, livedoc_short_id, ppt_business_id } or throws.
  * Uses fetchWithTimeoutAndRetry for 5xx retry (per PPT Task API error codes).
@@ -76,7 +80,7 @@ async function createPptTask(apiKey, query, timeoutMs, apiBase) {
 }
 
 /**
- * Get task historical info. Returns { task_status, live_doc_url? } or throws.
+ * Get task historical info. Returns { task_status, ppt_url?, ppt_biz_id?, live_doc_url?, live_doc_short_id? } or throws.
  * Uses fetchWithTimeoutAndRetry for 5xx retry (per PPT Task API error codes).
  */
 async function getTaskHistorical(apiKey, taskId, timeoutMs, apiBase) {
@@ -111,8 +115,11 @@ async function getTaskHistorical(apiKey, taskId, timeoutMs, apiBase) {
   }
 
   return {
-    task_status: payload.task_status,
+    task_status: payload.task_status ?? payload.status,
+    ppt_url: payload.ppt_url,
+    ppt_biz_id: payload.ppt_biz_id,
     live_doc_url: payload.live_doc_url,
+    live_doc_short_id: payload.live_doc_short_id ?? payload.livedoc_short_id,
   };
 }
 
@@ -158,19 +165,28 @@ export async function slides(query, options = {}) {
       await sleep(pollIntervalMs);
 
       const historical = await getTaskHistorical(apiKey, taskId, requestTimeoutMs, apiBase);
-      lastStatus = historical.task_status;
+      const normalizedStatus = normalizeTaskStatus(historical.task_status);
+      lastStatus = normalizedStatus || historical.task_status;
 
+      const elapsed = Math.floor((Date.now() - startTime) / 1000);
       if (useLiveStatus) {
-        const elapsed = Math.floor((Date.now() - startTime) / 1000);
         spinIndex = (spinIndex + 1) % SPINNER_FRAMES.length;
         writeStatusLine(SPINNER_FRAMES[spinIndex], elapsed);
+      } else if (!options.verbose && !options.json) {
+        process.stderr.write(`  Generating... ${elapsed}s\n`);
       }
 
-      // Doc: historical returns task_status "COMPLETED"; polling section also mentions "SUCCESS"
-      const done = historical.task_status === 'COMPLETED' || historical.task_status === 'SUCCESS';
+      const done = normalizedStatus === 'COMPLETED' || normalizedStatus === 'SUCCESS';
       if (done) {
         if (useLiveStatus) clearStatusLine();
-        const url = historical.live_doc_url;
+        const pptUrl =
+          historical.ppt_url ||
+          (historical.ppt_biz_id ? `https://dev.felo.ai/slides/${historical.ppt_biz_id}` : null);
+        const liveDocUrl =
+          historical.live_doc_url ||
+          (historical.live_doc_short_id ? `https://felo.ai/livedoc/${historical.live_doc_short_id}` : null) ||
+          (createResult.livedoc_short_id ? `https://felo.ai/livedoc/${createResult.livedoc_short_id}` : null);
+        const url = pptUrl || liveDocUrl;
         if (options.json) {
           console.log(
             JSON.stringify(
@@ -178,9 +194,11 @@ export async function slides(query, options = {}) {
                 status: 'ok',
                 data: {
                   task_id: taskId,
-                  task_status: historical.task_status,
-                  live_doc_url: url,
-                  livedoc_short_id: createResult.livedoc_short_id,
+                  task_status: normalizedStatus || historical.task_status,
+                  ppt_url: pptUrl,
+                  ppt_biz_id: historical.ppt_biz_id ?? createResult.ppt_business_id,
+                  live_doc_url: liveDocUrl,
+                  livedoc_short_id: historical.live_doc_short_id ?? createResult.livedoc_short_id,
                   ppt_business_id: createResult.ppt_business_id,
                 },
               },
@@ -190,10 +208,13 @@ export async function slides(query, options = {}) {
           );
         } else {
           if (url) {
-            console.log(url);
+            if (pptUrl && !options.json) {
+              process.stderr.write('PPT ready. Open this link to preview:\n');
+            }
+            console.log(pptUrl || liveDocUrl);
           } else {
             if (useLiveStatus) clearStatusLine();
-            console.error('Error: Completed but no live_doc_url in response');
+            console.error('Error: Completed but no ppt_url or live_doc_url in response');
             return 1;
           }
         }
@@ -201,17 +222,16 @@ export async function slides(query, options = {}) {
       }
 
       if (
-        historical.task_status === 'FAILED' ||
-        historical.task_status === 'ERROR' ||
-        (historical.task_status !== 'RUNNING' && historical.task_status !== 'PENDING')
+        normalizedStatus === 'FAILED' ||
+        normalizedStatus === 'ERROR'
       ) {
         if (useLiveStatus) clearStatusLine();
-        console.error(`Error: Task finished with status: ${historical.task_status}`);
+        console.error(`Error: Task finished with status: ${normalizedStatus || historical.task_status}`);
         return 1;
       }
 
       if (options.verbose) {
-        process.stderr.write(`  Status: ${historical.task_status}\n`);
+        process.stderr.write(`  Status: ${normalizedStatus || historical.task_status || 'UNKNOWN'}\n`);
       }
     }
 

package/README.ja.md

@@ -1,87 +0,0 @@
-# Felo AI
-
-**何でも聞いて、AI で今の答えを。**
-
-Felo AI はターミナル用 CLI と Claude Code スキルを提供し、日本語・英語・中国語（簡体・繁体）・韓国語に対応しています。
-
-[![License](https://img.shields.io/badge/license-MIT-green)]()
-
----
-
-## 2つの機能
-
-Felo AI のコア機能は **リアルタイム検索** と **PPT 生成** です。ターミナルの CLI で使うほか、Claude Code のスキルとしても利用でき、検索は自動で発動します。
-
-### 機能1: リアルタイム検索
-
-最新情報を検索し、AI がまとめた回答を取得します。天気、ニュース、価格、ドキュメント、技術動向など、「今」の情報が必要なときに最適です。
-
-- **多言語対応**: お好みの言語で質問できます。
-- **ターミナル**: `felo search "質問"`
-- **Claude Code**: スキル導入後は自動で発動。手動では `/felo-ai 質問`
-- **例**: `felo search "東京の天気"`、`felo search "React 19 new features" --verbose`
-
-### 機能2: PPT 生成
-
-テーマや説明を一文で指定すると、PPT を自動作成します。処理はクラウドで実行され、完了後に**オンライン文書リンク**が返り、ブラウザで開いて確認・編集できます。
-
-- **ターミナル**: `felo slides "テーマや説明"`
-- **例**: `felo slides "Felo 製品紹介、3枚"`、`felo slides "Introduction to React" --poll-timeout 300`
-
----
-
-## インストールと設定
-
-### CLI のインストール
-
-```bash
-npm install -g felo-ai
-```
-
-インストールせずに実行: `npx felo-ai search "東京の天気"`  
-インストール後のコマンドは `felo` です。
-
-### API キー設定
-
-推奨（永続保存）:
-
-```bash
-felo config set FELO_API_KEY your-api-key-here
-```
-
-または環境変数: `export FELO_API_KEY="your-api-key-here"`（Linux/macOS）、`$env:FELO_API_KEY="your-api-key-here"`（Windows PowerShell）。
-
-API キーは [felo.ai](https://felo.ai)（設定 → API Keys）で取得してください。
-
-### コマンド一覧
-
-| コマンド | 説明 |
-|----------|------|
-| `felo search "<query>"` | リアルタイム検索 |
-| `felo slides "<prompt>"` | PPT 生成 |
-| `felo config set FELO_API_KEY <key>` | API キー保存 |
-| `felo config get/list/path/unset` | 設定の参照/一覧/パス/削除 |
-
----
-
-## Claude Code スキル
-
-スキルのインストール:
-
-```bash
-npx @claude/skills add felo-ai
-```
-
-`FELO_API_KEY` を設定後、「東京の今日の天気」「React 19 の新機能」などの質問で検索が自動発動します。PPT 生成は現状ターミナルの `felo slides` のみ対応です。
-
----
-
-## リンク
-
-- [Felo オープンプラットフォーム](https://openapi.felo.ai/docs/) — API キー取得
-- [API ドキュメント](https://openapi.felo.ai/docs/api-reference/v2/chat.html)
-- [その他の例](./docs/EXAMPLES.md) | [FAQ](./docs/FAQ.md) | [GitHub Issues](https://github.com/Felo-Inc/felo-skills/issues)
-
----
-
-**他の言語 / Other languages:** [简体中文](README.zh-CN.md) | [English](README.en.md) | [한국어](README.ko.md) | [繁體中文](README.zh-TW.md)

package/README.ko.md

@@ -1,87 +0,0 @@
-# Felo AI
-
-**무엇이든 물어보고, AI로 최신 답을 받으세요.**
-
-Felo AI는 터미널 CLI와 Claude Code 스킬을 제공하며, 한국어·영어·중국어(간체·번체)·일본어를 지원합니다.
-
-[![License](https://img.shields.io/badge/license-MIT-green)]()
-
----
-
-## 두 가지 핵심 기능
-
-Felo AI의 핵심 기능은 **실시간 검색**과 **PPT 생성**입니다. 터미널 CLI로 사용하거나 Claude Code 스킬로 사용할 수 있으며, 검색은 자동으로 트리거됩니다.
-
-### 기능 1: 실시간 검색
-
-최신 정보를 검색하고 AI가 정리한 답변을 받습니다. 날씨, 뉴스, 가격, 문서, 기술 동향 등 「지금」 정보가 필요할 때 적합합니다.
-
-- **다국어 지원**: 원하는 언어로 질문하면 됩니다.
-- **터미널**: `felo search "질문"`
-- **Claude Code**: 스킬 설치 후 자동 트리거, 또는 `/felo-ai 질문` 입력
-- **예시**: `felo search "서울 날씨"`, `felo search "React 19 new features" --verbose`
-
-### 기능 2: PPT 생성
-
-주제나 설명을 한 문장으로 주면 PPT를 자동 생성합니다. 작업은 클라우드에서 실행되며, 완료 후 **온라인 문서 링크**를 반환해 브라우저에서 열어 확인·편집할 수 있습니다.
-
-- **터미널**: `felo slides "주제 또는 설명"`
-- **예시**: `felo slides "Felo 제품 소개, 3장"`, `felo slides "Introduction to React" --poll-timeout 300`
-
----
-
-## 설치 및 설정
-
-### CLI 설치
-
-```bash
-npm install -g felo-ai
-```
-
-설치 없이 실행: `npx felo-ai search "서울 날씨"`  
-설치 후 사용하는 명령은 `felo` 입니다.
-
-### API 키 설정
-
-권장(영구 저장):
-
-```bash
-felo config set FELO_API_KEY your-api-key-here
-```
-
-또는 환경 변수: `export FELO_API_KEY="your-api-key-here"` (Linux/macOS), `$env:FELO_API_KEY="your-api-key-here"` (Windows PowerShell).
-
-API 키는 [felo.ai](https://felo.ai)(설정 → API Keys)에서 발급받을 수 있습니다.
-
-### 명령어 요약
-
-| 명령 | 설명 |
-|------|------|
-| `felo search "<query>"` | 실시간 검색 |
-| `felo slides "<prompt>"` | PPT 생성 |
-| `felo config set FELO_API_KEY <key>` | API 키 저장 |
-| `felo config get/list/path/unset` | 설정 조회/목록/경로/삭제 |
-
----
-
-## Claude Code 스킬
-
-스킬 설치:
-
-```bash
-npx @claude/skills add felo-ai
-```
-
-`FELO_API_KEY` 설정 후, Claude Code에서 「서울 오늘 날씨」「React 19 새 기능」 같은 질문을 하면 검색이 자동으로 실행됩니다. PPT 생성은 현재 터미널의 `felo slides` 로만 지원됩니다.
-
----
-
-## 링크
-
-- [Felo 오픈 플랫폼](https://openapi.felo.ai/docs/) — API 키 발급
-- [API 문서](https://openapi.felo.ai/docs/api-reference/v2/chat.html)
-- [더 많은 예시](./docs/EXAMPLES.md) | [FAQ](./docs/FAQ.md) | [GitHub Issues](https://github.com/Felo-Inc/felo-skills/issues)
-
----
-
-**다른 언어 / Other languages:** [简体中文](README.zh-CN.md) | [English](README.en.md) | [日本語](README.ja.md) | [繁體中文](README.zh-TW.md)

package/README.zh-CN.md

@@ -1,87 +0,0 @@
-# Felo AI
-
-**随时提问，用 AI 获取当下最新答案。**
-
-Felo AI 提供终端 CLI 与 Claude Code 技能，支持简体中文、英文、日文、韩文、繁体中文等多语言。
-
-[![License](https://img.shields.io/badge/license-MIT-green)]()
-
----
-
-## 两大能力
-
-Felo AI 提供两个核心能力：**实时搜索** 与 **PPT 生成**。可在终端用 CLI 使用，也可在 Claude Code 中通过技能使用（搜索支持自动触发）。
-
-### 能力一：实时搜索
-
-联网搜索最新信息，由 AI 整合成可直接使用的回答。适合查天气、新闻、价格、文档、技术动态等一切需要「当下」信息的场景。
-
-- **支持多语言**：用你习惯的语言提问即可。
-- **终端**：`felo search "你的问题"`
-- **Claude Code**：安装技能后自动触发，或输入 `/felo-ai 你的问题`
-- **示例**：`felo search "杭州明天天气"`、`felo search "React 19 new features" --verbose`
-
-### 能力二：生成 PPT
-
-根据一句描述或主题，自动生成 PPT。任务在云端执行，完成后返回**在线文档链接**，浏览器打开即可查看/编辑。
-
-- **终端**：`felo slides "你的主题或描述"`
-- **示例**：`felo slides "Felo 产品介绍，3 页"`、`felo slides "Introduction to React" --poll-timeout 300`
-
----
-
-## 安装与配置
-
-### 安装 CLI
-
-```bash
-npm install -g felo-ai
-```
-
-不安装直接运行：`npx felo-ai search "东京天气"`  
-安装后命令为 `felo`。
-
-### 配置 API Key
-
-推荐（持久保存）：
-
-```bash
-felo config set FELO_API_KEY your-api-key-here
-```
-
-或设置环境变量：`export FELO_API_KEY="your-api-key-here"`（Linux/macOS），`$env:FELO_API_KEY="your-api-key-here"`（Windows PowerShell）。
-
-API Key 请在 [felo.ai](https://felo.ai)（设置 → API Keys）获取。
-
-### 命令一览
-
-| 命令 | 说明 |
-|------|------|
-| `felo search "<query>"` | 实时搜索 |
-| `felo slides "<prompt>"` | 生成 PPT |
-| `felo config set FELO_API_KEY <key>` | 保存 API Key |
-| `felo config get/list/path/unset` | 查看/列出/定位/删除配置 |
-
----
-
-## Claude Code 技能
-
-安装技能：
-
-```bash
-npx @claude/skills add felo-ai
-```
-
-配置 `FELO_API_KEY` 后，在 Claude Code 中问「东京今天天气」「React 19 新特性」等问题会自动触发搜索。PPT 生成目前仅支持终端 `felo slides`。
-
----
-
-## 链接
-
-- [Felo 开放平台](https://openapi.felo.ai/docs/) — 获取 API Key
-- [API 文档](https://openapi.felo.ai/docs/api-reference/v2/chat.html)
-- [更多示例](./docs/EXAMPLES.md) | [FAQ](./docs/FAQ.md) | [GitHub Issues](https://github.com/Felo-Inc/felo-skills/issues)
-
----
-
-**其他语言 / Other languages:** [English](README.en.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [繁體中文](README.zh-TW.md)