What makes image_to_ppt notable?

1.9K downloads. Trust evidence available

How should image_to_ppt be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

image_to_ppt

图片转PPT服务，将图片异步转换为 PPT 文件。 Skill: image_to_ppt Owner: scnet-sugon Summary: 图片转PPT服务，将图片异步转换为 PPT 文件。 Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-11T07:08:31.444Z | auto Initial release of image-to-ppt skill. - Provides asynchronous image-to-PPT conversion service via Scnet OCR API. - Supports automatic polling for task completion with configurable intervals and timeouts. - Outputs temporary PPT file download links on success, or user-

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.9k

Updated

Oct 9, 2026

Version

0.1.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.9K downloads reported by the source. Last updated 10/9/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 9, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 9, 2026
Adoption signal: 1.9K downloadsadoption · observed Oct 9, 2026
Latest release: 0.1.0release · observed Aug 11, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17aan1jdk93c5398r3ypc523d83hqys:image-to-ppt

Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-scnet-sugon-image-to-ppt/snapshot"

Documentation

CLAWHUB

21,772 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: image_to_ppt
description: 图片转PPT服务，将图片异步转换为 PPT 文件。
version: 1.0.0
author: SCNet
license: MIT
tags:
  - OCR
  - 文档转换
  - 图片转PPT

required_env_vars:
  - SCNET_API_KEY
optional_env_vars:
  - SCNET_API_BASE
  - SCNET_POLL_INTERVAL
  - SCNET_MAX_POLL_TIME
primary_credential: SCNET_API_KEY
dependencies:
  - python3
  - requests
input:
  - ocrType : 转换类型，IMAGE_TO_PPT
  - filePath : 待转换文件的本地路径
output: 转换后的 PPT（.pptx）文件下载地址
---
# Sugon-Scnet 图片转PPT服务技能

本技能封装了 Scnet OCR 服务，将图片异步转换为 PPT 文件，并通过轮询获取转换结果。

---

## 功能特性

- **图片转 PPT**：将图片内容转换为 `.pptx`。
- **异步任务 + 自动轮询**：提交任务后自动轮询状态，直到任务完成或超时。

## 前置配置

> **⚠️ 重要**：使用前需要申请 Scnet API Token

### 申请 API Token

1. 访问 [Scnet 官网](https://www.scnet.cn) 注册/登录
2. 在控制台申请 API 密钥（格式：`sc-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`）
3. 复制密钥备用

### 配置 Token

**手动配置（推荐）**
1. 在技能目录下创建 `config/.env` 文件，内容如下：
```ini
# =====  Sugon-Scnet 文档格式转化 API 配置 =====
# 申请地址：https://www.scnet.cn
SCNET_API_KEY=your_scnet_api_key_here

# API 基础地址（一般无需修改）
SCNET_API_BASE=https://api.scnet.cn/api/llm/v1

# 轮询配置（可选）
SCNET_POLL_INTERVAL=5
SCNET_MAX_POLL_TIME=600
```
2. 添加：`SCNET_API_KEY=你的密钥`
3. 设置文件权限为 600（仅所有者可读写）

**⚠️ 安全警告**：切勿将 API Key 直接粘贴到聊天对话中，否则可能被记录或泄露。

### Token 更新

Token 过期后调用会返回 401 或 403 错误。更新方法：重新申请 Token 并替换 config/.env 中的 SCNET_API_KEY。

### 依赖安装

本技能需要 Python 3.6+ 和 requests 库。请运行以下命令：

```bash
   pip install requests
```

---

## 使用方法

### 参数说明

| 参数名 | 类型 | 必填 | 描述 |
|--------|------|------|------|
| ocrType | string | 是 | 转换类型。必须为 IMAGE_TO_PPT（图片转 PPT） |
| filePath | string | 是 | 待转换文件的本地绝对路径。图片格式。 |

### 命令行调用示例

```bash
   python .claude/skills/image_to_ppt/scripts/main.py IMAGE_TO_PPT /path/to/image.png
```

### 在 AI 对话中使用

用户可以说：

- “把这张图片转换成 PPT，图片路径 /Users/name/Downloads/slide.png”

AI 会根据 description 中的关键词自动触发本技能。

### AI 调用建议

- 为避免触发 API 速率限制，请串行调用本技能，等待前一个任务完成后再发起下一个请求。
- 如果使用 OpenClaw 的 exec 工具，建议设置足够的 timeout，因为转换任务需要异步轮询。

### 配置选项

编辑 `config/.env` 文件：

| 变量名 | 默认值 | 说明 |
|--------|--------|------|
| SCNET_API_KEY | 必需 | Scnet API 密钥 |
| SCNET_API_BASE | https://api.scnet.cn/api/llm/v1 | API 基础地址（一般无需修改） |
| SCNET_POLL_INTERVAL | 5 | 轮询状态间隔（秒） |
| SCNET_MAX_POLL_TIME | 600 | 最大轮询等待时间（秒） |

### 输出

- 标准输出：转换成功时返回结果文件下载地址 JSON。
- 结果位于 `data[0].output.results` 中，为临时 MinIO 下载链接。
- 错误信息：如果发生错误，会输出以 `错误:` 开头的友好提示。

### 注意事项

- 输入文件必须与 `ocrType` 匹配：IMAGE_TO_PPT 输入图片。
- 下载地址为临时授权链接，请及时下载使用。
- 转换任务为异步处理，脚本会自动轮询直到完成或超时。

### 故障排除

| 问题 | 解决方案 |
|------|----------|
| 配置文件不存在 | 创建 config/.env 并填入 Token（参考前置配置） |
| API Key 无效/过期 | 重新申请 Token 并更新 `.env` 文件 |
| 文件不存在 | 检查提供的文件路径是否正确 |
| 网络连接失败 | 检查网络连接或防火墙设置 |
| 不支持的文件类型 | 确保文件扩展名为允许的类型（参考 API 文档） |
| 401/403/Unauthorized | Token 无效或过期，重新申请并配置 |
| 任务长时间 running | 可能是文件较大或服务繁忙，可增大 SCNET_MAX_POLL_TIME |
| 任务失败 | 查看返回的 error_code 和 error_message |

README.md

# image_to_ppt



## Getting started

To make it easy for you to get started with GitLab, here's a list of recommended next steps.

Already a pro? Just edit this README.md and make it your own. Want to make it easy? [Use the template at the bottom](#editing-this-readme)!

## Add your files

* [Create](https://docs.gitlab.com/ee/user/project/repository/web_editor.html#create-a-file) or [upload](https://docs.gitlab.com/ee/user/project/repository/web_editor.html#upload-a-file) files
* [Add files using the command line](https://docs.gitlab.com/topics/git/add_files/#add-files-to-a-git-repository) or push an existing Git repository with the following command:

```
cd existing_repo
git remote add origin https://github.com/SCNet-sugon/image_to_ppt.git
git branch -M main
git push -uf origin main
```


## Collaborate with your team

* [Invite team members and collaborators](https://docs.gitlab.com/ee/user/project/members/)
* [Create a new merge request](https://docs.gitlab.com/ee/user/project/merge_requests/creating_merge_requests.html)
* [Automatically close issues from merge requests](https://docs.gitlab.com/ee/user/project/issues/managing_issues.html#closing-issues-automatically)
* [Enable merge request approvals](https://docs.gitlab.com/ee/user/project/merge_requests/approvals/)
* [Set auto-merge](https://docs.gitlab.com/user/project/merge_requests/auto_merge/)

## Test and Deploy

Use the built-in continuous integration in GitLab.

* [Get started with GitLab CI/CD](https://docs.gitlab.com/ee/ci/quick_start/)
* [Analyze your code for known vulnerabilities with Static Application Security Testing (SAST)](https://docs.gitlab.com/ee/user/application_security/sast/)
* [Deploy to Kubernetes, Amazon EC2, or Amazon ECS using Auto Deploy](https://docs.gitlab.com/ee/topics/autodevops/requirements.html)
* [Use pull-based deployments for improved Kubernetes management](https://docs.gitlab.com/ee/user/clusters/agent/)
* [Set up protected environments](https://docs.gitlab.com/ee/ci/environments/protected_environments.html)

***

# Editing this README

When you're ready to make this README your own, just edit this file and use the handy template below (or feel free to structure it however you want - this is just a starting point!). Thanks to [makeareadme.com](https://www.makeareadme.com/) for this template.

## Suggestions for a good README

Every project is different, so consider which of these sections apply to yours. The sections used in the template are suggestions for most open source projects. Also keep in mind that while a README can be too long and detailed, too long is better than too short. If you think your README is too long, consider utilizing another form of documentation rather than cutting out information.

## Name
Choose a self-explaining name for your project.

## Description
Let people know what your project can do specifically. Provide context and add a link to any reference visitors might be unfamiliar with. A list of Features or a Background su

_meta.json

{
  "ownerId": "kn7ax58mnefnavcfwakqxpsgqn82tacy",
  "slug": "image-to-ppt",
  "version": "0.1.0",
  "publishedAt": 1786432111444
}

references/api-docs.md

# Scnet 文档格式转化服务 API 文档

## 1. 功能介绍

Scnet 文档格式转化服务，支持将文档异步转换为可编辑的 Office 文件（Word / PPT），适用于大批量文档处理场景。

核心流程：

1. **任务提交**：通过 `doc/convert/task` 接口提交待转换的文件 URL 或本地文件，获取任务 ID；
2. **状态查询**：通过 `ocrdoc/result` 接口轮询任务状态，获取处理结果；
3. **结果获取**：任务成功后返回转换后的 Word / PPT 文件下载地址。

### 支持的文件类型

**文档格式**

| 类型 | 扩展名 |
|------|--------|
| PDF | .pdf |

**图片格式**

| 类型 | 扩展名 |
|------|--------|
| JPEG | .jpg / .jpeg |
| PNG | .png |
| BMP | .bmp |
| TIFF | .tiff / .tif |
| WebP | .webp |

说明：请根据转换类别（`ocr_type`）选择对应的输入文件——`PDF_TO_WORD` 输入 PDF，`IMAGE_TO_WORD` 与 `IMAGE_TO_PPT` 输入图片。

---

## 2. 文档格式转化任务提交 API

将文档解析（还原）为可编辑的 Office 文件，任务成功后返回 Word（`.docx`）或 PPT（`.pptx`）的 MinIO 文件下载地址。任务提交后同样通过任务状态查询 API 轮询结果。

### 2.1 端点信息

| 项目 | 内容 |
|------|------|
| URL | POST `/api/llm/v1/doc/convert/task` |
| Content-Type | `multipart/form-data` |
| 认证 | `Authorization: Bearer <token>` |

### 2.2 请求参数

**Header 参数**

| 名称 | 类型 | 必填 | 示例值 |
|------|------|------|--------|
| Content-Type | string | 是 | multipart/form-data |
| Authorization | string | 是 | Bearer `<API Key>` |

**Form 参数**

| 名称 | 类型 | 必填 | 描述 |
|------|------|------|------|
| file | file | 否 | 本地上传的待转换文件。`file` 与 `file_url` 二选一，同时传入时优先使用 `file`。 |
| file_url | string | 否 | 待转换文件的公网可访问下载地址。`file` 与 `file_url` 二选一。 |
| ocr_type | string | 是 | 转换类别，可选值：`PDF_TO_WORD`（PDF 转 Word）、`IMAGE_TO_WORD`（图片转 Word）、`IMAGE_TO_PPT`（图片转 PPT）。 |
| page_index | string | 否 | 页码范围（如 `1` 或 `1-5`），默认全部解析。 |
| is_table_cls | boolean | 否 | 是否开启表格细分处理，默认 `false`。 |
| is_doc_ori | boolean | 否 | 是否开启文档方向矫正，默认 `false`。 |
| enforce_seal | boolean | 否 | 是否开启强制二次印章检测，默认 `false`。 |
| is_inline_formula | boolean | 否 | 是否开启行内公式检测，默认 `false`。 |

说明：`file` 与 `file_url` 二选一，必须至少提供一个，否则返回参数错误。

### 2.3 请求示例

**本地文件上传**

```bash
curl --location 'https://api.scnet.cn/api/llm/v1/doc/convert/task' \
--header 'Authorization: Bearer <API Key>' \
--form 'file=@"/path/to/document.pdf"' \
--form 'ocr_type="PDF_TO_WORD"'
```

**文件 URL 提交**

```bash
curl --location 'https://api.scnet.cn/api/llm/v1/doc/convert/task' \
--header 'Authorization: Bearer <API Key>' \
--form 'file_url="https://oss.ksai.scnet.cn:58043/ocr/doc/xxxxxx"' \
--form 'ocr_type="PDF_TO_WORD"'
```

### 2.4 响应参数

| 参数名称 | 参数类型 | 描述 |
|----------|----------|------|
| code | String | 状态码 |
| msg | String | 结果描述 |
| output | Object | 任务提交结果 |
| output.task_status | String | 任务状态（`pending` 待执行、`running` 执行中、`succeeded` 成功、`failed` 失败、`unknown` 任务不存在或未知状态） |
| output.task_id | String | 任务唯一标识，用于后续结果查询 |
| request_id | String | 请求唯一标识 |

### 2.5 响应示例

**成功响应**

```json
{
  "code": "0",
  "msg": "",
  "data": {
    "output": {
      "task_status": "pending",
      "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
  }
}
```

**失败响应**

```json
{
  "code": "10011",
  "msg": "Burst rate limit exceeded for model"
}
```

### 2.6 结果获取

文档格式转化任务通过任务状态查询 API 轮询状态。任务成功后，`output.results` 数组返回转换后的 Word 或 PPT 文件的 MinIO 下载地址。

```json
{
  "code": "0",
  "msg": "success"

assets/templates/fields-summary.md

# 文档格式转化任务字段说明

## 输出字段（submit_task 提交后返回）

| 字段 | 类型 | 说明 |
|------|------|------|
| code | String | 状态码，`0` 表示成功 |
| msg | String | 结果描述 |
| data | Object | 任务提交结果 |
| data.output.task_status | String | 任务状态（pending / running / succeeded / failed / unknown） |
| data.output.task_id | String | 任务唯一标识，用于后续结果查询 |
| request_id | String | 请求唯一标识 |

## 结果字段（ocrdoc/result 轮询成功后返回）

| 字段 | 类型 | 说明 |
|------|------|------|
| code | String | 状态码，`0` 表示成功 |
| msg | String | 结果描述 |
| data | Array | 任务结果列表（每个 task_id 对应一个元素） |
| data[].request_id | String | 请求唯一标识 |
| data[].output | Object | 任务结果 |
| data[].output.task_id | String | 任务唯一标识 |
| data[].output.task_status | String | 任务状态 |
| data[].output.submit_time | String | 任务提交时间 |
| data[].output.end_time | String | 任务结束时间（成功/失败时返回） |
| data[].output.results | Array | 结果文件下载地址列表（成功时返回） |
| data[].output.error_code | String | 错误码（失败时返回） |
| data[].output.error_message | String | 错误信息（失败时返回） |

## 下载地址说明

- `results` 中的下载地址后缀为 `.docx`（Word）或 `.pptx`（PPT）。
- 下载地址为临时授权链接，请及时使用。

Github ReposUpdated 9h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.