sophhub 0.1.2 → 0.1.4

package/README.md

@@ -40,7 +40,7 @@ sophhub list --type store --json
 
 ### 下载 Skill
 
-下载到当前目录：
+下载单个 Skill 到当前目录：
 
 ```bash
 sophhub download weather
@@ -52,6 +52,13 @@ sophhub download weather
 sophhub download didi-ride -o ./my-skills
 ```
 
+批量下载某个类型的所有 Skill：
+
+```bash
+sophhub download --type builtin -o ./skills
+sophhub download --type store -o ./skills
+```
+
 ### 查看版本
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sophhub",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "SophHub CLI - Manage and download AI Agent skills",
   "type": "module",
   "bin": {

package/skills/VERSIONS.md

@@ -2,7 +2,7 @@
 
 | Skill | Type | Version | Updated At | Display Name | Description |
 | --- | --- | --- | --- | --- | --- |
-| clawhub | builtin | 1.0.0 | 2026-04-08 |  |  |
+| skillhub | builtin | 1.0.0 | 2026-04-09 |  |  |
 | flight-booking | builtin | 1.1.0 | 2026-04-08 |  |  |
 | inventory-management | builtin | 1.0.0 | 2026-04-08 |  |  |
 | schedule-reminder | builtin | 1.0.0 | 2026-04-08 |  |  |
@@ -23,5 +23,7 @@
 | weather | builtin | 1.0.0 | 2026-04-08 |  |  |
 | web-scraper | builtin | 1.0.0 | 2026-04-08 |  |  |
 | website-builder | builtin | 1.0.0 | 2026-04-08 |  |  |
+| aippt | store | 1.0.0 | 2026-04-09 | AI PPT 生成 | 根据主题、文件、网址或大纲自动生成演示文稿 |
 | didi-ride | store | 1.0.0 | 2026-04-09 | 滴滴出行 | 打车、路线规划、周边搜索、订单查询 |
 | flyai | store | 1.0.10 | 2026-04-09 | 飞猪旅行 | 机票、酒店、景点门票、旅行搜索与预订 |
+| lawding-contract-review | store | 1.0.0 | 2026-04-09 | 合同审查 | 合同审核、备份、合同到期提醒、应付应收提醒、违约提醒 |

package/skills/builtin/skillhub/SKILL.md

@@ -0,0 +1,111 @@
+---
+name: skillhub
+description: 当用户要求搜索、安装 skill （包括Sophnet/Sophclaw平台和clawhub社区） 时使用此 skill。
+---
+
+# SkillHub
+
+统一的技能安装入口，整合 **SophHub**（Sophnet 平台 Sophclaw 产品的技能商店，优先）和 **ClawHub**（社区商店，兜底）。
+
+## 安装流程
+
+当用户需要安装一个技能时，按以下顺序操作：
+
+### 第一步：从 SophHub 商店查找
+
+```bash
+npx -y sophhub list --type store
+```
+
+检查输出中是否有符合用户需求的技能。
+
+- **找到合适的技能** → 将技能名称和描述反馈给用户，让用户确认是否安装。
+- 用户确认安装后，执行下载：
+
+```bash
+npx -y sophhub download <技能名称> -o <目标目录>
+```
+
+其中 `<目标目录>` 为当前技能工作目录（通常是 `~/.openclaw/skills/` 或由环境决定的目录）。
+
+- **没有找到合适的技能** → 进入第二步。
+
+### 第二步：从 ClawHub 查找（兜底）
+
+如果 SophHub 商店中没有匹配的技能，使用 ClawHub 查找：
+
+```bash
+clawhub search "<用户需求关键词>"
+```
+
+如果找到合适的技能，反馈给用户确认后安装：
+
+```bash
+clawhub install <技能名称>
+```
+
+## SophHub CLI 参考
+
+列出所有商店类型的技能：
+
+```bash
+npx -y sophhub list --type store
+```
+
+列出所有技能（含内置技能）：
+
+```bash
+npx -y sophhub list
+```
+
+以 JSON 格式输出（便于程序解析）：
+
+```bash
+npx -y sophhub list --type store --json
+```
+
+下载指定技能到目标目录：
+
+```bash
+npx -y sophhub download <技能名称> -o <目标目录>
+```
+
+## ClawHub CLI 参考
+
+安装
+
+```bash
+npm i -g clawhub
+```
+
+搜索
+
+```bash
+clawhub search "postgres backups"
+```
+
+安装技能
+
+```bash
+clawhub install my-skill
+clawhub install my-skill --version 1.2.3
+```
+
+更新技能
+
+```bash
+clawhub update my-skill
+clawhub update --all
+```
+
+列出已安装技能
+
+```bash
+clawhub list
+```
+
+说明
+
+- 默认注册中心：https://clawhub.com（可通过 CLAWHUB_REGISTRY 或 --registry 覆盖）
+- 默认工作目录：当前目录（回退到 OpenClaw 工作空间）；安装目录：./skills（可通过 --workdir / --dir / CLAWHUB_WORKDIR 覆盖）
+- 更新命令会对本地文件计算哈希、匹配版本，并升级到最新版本（除非指定了 --version）

package/skills/store/aippt/SKILL.md

@@ -0,0 +1,235 @@
+---
+name: aippt
+description: Generate PPT or presentations with Docmee AiPPT. Use when the user asks to create PPT, slides, courseware, decks, or upload a custom PPT template and generate a presentation from a topic, file, URL, pasted text, or Markdown outline.
+---
+
+# aippt
+
+基于文多多 AiPPT（`docmee.cn`）的 PPT 生成 skill。
+
+它保留了现有 `aippt` skill 的统一入口思路：
+
+- 根据输入自动识别生成模式
+- 输出本地 `.pptx` 文件
+- 支持标题/主题、文件、网页 URL、纯文本、Markdown 大纲
+- 支持上传自定义模板并在生成时指定模板
+- 支持在生成完成后调用接口更换 PPT 模板
+- 支持传入已有 `pptId` 直接更换模板
+
+## 工作目录
+
+所有命令都在当前 skill 目录执行：
+
+```bash
+SKILL_DIR="/path/to/skills/aippt-new"
+cd "$SKILL_DIR"
+```
+
+## Python 环境
+
+脚本通过 `uv` 运行：
+
+```bash
+cd "$SKILL_DIR"
+uv sync
+uv run scripts/ppt.py --title "AI 行业洞察"
+```
+
+## 认证
+
+`scripts/auth.py` 会自动按以下顺序读取 API Key：
+
+1. 环境变量 `DOCMEE_API_KEY`
+2. 技能目录中的本地文件 `docmee_api_key.json`
+
+服务端调用默认直接把 API Key 作为 `token` 使用，无需额外创建临时 token。
+
+### 首次调用规则
+
+首次使用本 skill 前，先运行：
+
+```bash
+cd "$SKILL_DIR"
+uv run scripts/auth.py
+```
+
+如果提示缺少 API Key：
+
+1. 不要继续生成 PPT。
+2. 先向用户索取文多多 API Key。
+3. 同时把注册链接发给用户：`https://docmee.cn/open`
+4. 用户提供 key 后，立刻保存到 skill 本地文件：
+
+```bash
+cd "$SKILL_DIR"
+uv run scripts/auth.py --set-key "ak_xxx"
+```
+
+5. 保存成功后，会在 skill 同级目录下创建 `docmee_api_key.json`，后续直接复用。
+6. 再继续后续 PPT 操作。
+
+后续调用默认直接复用 `docmee_api_key.json`，不再重复询问。
+
+可单独验证认证：
+
+```bash
+cd "$SKILL_DIR"
+uv run scripts/auth.py
+```
+
+可查看本地 key 文件路径：
+
+```bash
+cd "$SKILL_DIR"
+uv run scripts/auth.py --show-path
+```
+
+## 统一入口
+
+主入口是 `scripts/ppt.py`。
+
+### 自动识别规则
+
+| 输入 | 模式 |
+|---|---|
+| `--file report.docx/pdf/pptx/txt/xlsx/...` | 上传文件生成 |
+| `--file outline.md` | Markdown 大纲生成 |
+| `--url https://...` | 网页 URL 生成 |
+| `--content "# 标题\n## 章节"` | Markdown 大纲生成 |
+| `--content "一段普通文本"` | 纯文本生成 |
+| `--content-file outline.md` | Markdown 大纲生成 |
+| `--content-file notes.txt` | 纯文本生成 |
+| 无文件/URL/内容 | 主题智能生成 |
+
+### 命令行参数
+
+```bash
+uv run scripts/ppt.py \
+  --title TITLE \
+  [--ppt-id PPT_ID] \
+  [--file FILE_PATH] \
+  [--url URL] \
+  [--content TEXT] \
+  [--content-file FILE] \
+  [--template-id ID] \
+  [--template-file FILE] \
+  [--replace-template-id ID] \
+  [--replace-template-file FILE] \
+  [--replace-template-sync] \
+  [--style "深蓝 科技"] \
+  [--outline-content TEXT] \
+  [--outline-file FILE] \
+  [--output /path/to/output.pptx]
+```
+
+### 典型用法
+
+```bash
+cd "$SKILL_DIR"
+
+# 主题智能生成
+uv run scripts/ppt.py --title "2026 年 AI 趋势"
+
+# 上传文件生成
+uv run scripts/ppt.py --title "年度报告" --file /path/to/report.docx
+
+# 网页生成
+uv run scripts/ppt.py --title "文章解读" --url "https://example.com/article"
+
+# 纯文本生成
+uv run scripts/ppt.py --title "AI 发展" --content "人工智能正在重塑软件和硬件产业。"
+
+# Markdown 大纲生成
+uv run scripts/ppt.py --title "技术方案" --content-file /path/to/outline.md
+
+# 使用已有模板
+uv run scripts/ppt.py --title "产品发布会" --template-id 12345
+
+# 上传自定义模板并生成
+uv run scripts/ppt.py \
+  --title "品牌方案" \
+  --file /path/to/brand-brief.docx \
+  --template-file /path/to/brand-template.pptx
+
+# 上传模板并覆盖已有模板 ID
+uv run scripts/ppt.py \
+  --title "品牌方案" \
+  --file /path/to/brand-brief.docx \
+  --template-id 12345 \
+  --template-file /path/to/brand-template.pptx
+
+# 先生成，再更换为另一个模板
+uv run scripts/ppt.py \
+  --title "品牌方案" \
+  --file /path/to/brand-brief.docx \
+  --replace-template-id 67890
+
+# 先生成，再上传模板文件并更换
+uv run scripts/ppt.py \
+  --title "品牌方案" \
+  --file /path/to/brand-brief.docx \
+  --replace-template-file /path/to/brand-template.pptx
+
+# 对已有 PPT 直接更换模板
+uv run scripts/ppt.py \
+  --ppt-id YOUR_PPT_ID \
+  --replace-template-id 67890
+
+# 对已有 PPT 直接上传模板文件并更换
+uv run scripts/ppt.py \
+  --ppt-id YOUR_PPT_ID \
+  --replace-template-file /path/to/brand-template.pptx
+
+# 指定风格提示
+uv run scripts/ppt.py --title "AI 芯片" --style "深蓝 科技"
+```
+
+## 生成流程
+
+### 普通模式
+
+1. 自动识别输入模式
+2. 若提供 `--template-file`，先上传自定义模板
+3. 若未指定模板，则随机获取一个模板
+4. 生成大纲
+5. 生成大纲内容
+6. 按模板生成 PPT
+7. 若提供 `--replace-template-id` 或 `--replace-template-file`，生成后调用更换模板接口
+8. 下载 `.pptx` 到本地
+
+### Markdown 直出模式
+
+当输入是 Markdown 大纲时：
+
+1. 自动识别为 Markdown 模式
+2. 若提供 `--template-file`，先上传模板
+3. 若未指定模板，则随机获取一个模板
+4. 直接按 Markdown 大纲生成 PPT
+5. 若提供 `--replace-template-id` 或 `--replace-template-file`，生成后调用更换模板接口
+6. 下载 `.pptx` 到本地
+
+### 已有 PPT 直换模板模式
+
+当提供 `--ppt-id` 时：
+
+1. 读取已有 PPT 的 `pptId`
+2. 使用 `--replace-template-id` / `--replace-template-file`，若未提供则回退到 `--template-id` / `--template-file`
+3. 直接调用更换模板接口
+4. 下载更新后的 `.pptx` 到本地
+
+## 输出
+
+默认输出目录：
+
+```text
+/home/node/.openclaw/workspace/media/inbound/ppt/
+```
+
+也可以通过 `--output` 指定保存路径。
+
+脚本执行完成后，会同时输出：
+
+- **保存路径**：本地 `.pptx` 文件路径（`PPT 下载完成，保存路径: ...`）
+- **下载链接**：文件的下载 URL（`PPT 下载链接: ...`）
+
+生成完毕后，请同时将保存路径和下载链接告知用户。

package/skills/store/aippt/pyproject.toml

@@ -0,0 +1,8 @@
+[project]
+name = "aippt-new"
+version = "0.1.0"
+description = "Skill for generating PPT via Docmee AiPPT APIs"
+requires-python = ">=3.10"
+dependencies = [
+    "requests>=2.28.0",
+]

package/skills/store/aippt/scripts/auth.py

@@ -0,0 +1,122 @@
+#!/usr/bin/env python3
+"""AIPPT-NEW 鉴权模块：自动获取并保存 Docmee API Key。
+
+API Key 解析顺序：
+  1. 环境变量 DOCMEE_API_KEY
+  2. 技能目录中的本地文件 docmee_api_key.json
+
+命令行：
+  python auth.py
+  python auth.py --set-key "ak_xxx"
+  python auth.py --clear-key
+  python auth.py --show-path
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import stat
+import sys
+from pathlib import Path
+
+
+SKILL_DIR = Path(__file__).resolve().parent.parent
+API_KEY_FILE = SKILL_DIR / "docmee_api_key.json"
+REGISTER_URL = "https://docmee.cn/open"
+
+
+def get_api_key_file_path() -> Path:
+    return API_KEY_FILE
+
+
+def _read_local_api_key() -> str:
+    path = get_api_key_file_path()
+    try:
+        with path.open("r", encoding="utf-8") as file:
+            payload = json.load(file)
+    except FileNotFoundError:
+        return ""
+    except (OSError, json.JSONDecodeError):
+        return ""
+    return str(payload.get("apiKey", "")).strip()
+
+
+def save_api_key(api_key: str) -> Path:
+    value = api_key.strip()
+    if not value:
+        raise RuntimeError("API Key 为空，无法保存")
+
+    path = get_api_key_file_path()
+    payload = {"apiKey": value}
+    with path.open("w", encoding="utf-8") as file:
+        json.dump(payload, file, ensure_ascii=False, indent=2)
+        file.write("\n")
+
+    try:
+        path.chmod(stat.S_IRUSR | stat.S_IWUSR)
+    except OSError:
+        pass
+    return path
+
+
+def clear_api_key() -> bool:
+    path = get_api_key_file_path()
+    if not path.exists():
+        return False
+    path.unlink()
+    return True
+
+
+def resolve_api_key() -> str:
+    """自动获取 API Key：优先环境变量，其次技能目录本地文件。"""
+    key = os.environ.get("DOCMEE_API_KEY", "").strip()
+    if key:
+        return key
+
+    key = _read_local_api_key()
+    if key:
+        return key
+
+    raise RuntimeError(
+        "未找到 DOCMEE_API_KEY。请先向用户索取文多多 API Key 并执行 "
+        f'`uv run scripts/auth.py --set-key "ak_xxx"` 保存。注册链接：{REGISTER_URL}'
+    )
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="AIPPT-NEW 鉴权工具")
+    parser.add_argument("--set-key", dest="set_key", default=None, help="保存 Docmee API Key")
+    parser.add_argument("--clear-key", action="store_true", help="删除已保存的 Docmee API Key")
+    parser.add_argument("--show-path", action="store_true", help="显示本地 API Key 文件路径")
+    args = parser.parse_args()
+
+    try:
+        if args.show_path:
+            print(get_api_key_file_path())
+            return 0
+
+        if args.clear_key:
+            deleted = clear_api_key()
+            if deleted:
+                print(f"已删除本地 API Key 文件: {get_api_key_file_path()}")
+            else:
+                print(f"本地 API Key 文件不存在: {get_api_key_file_path()}")
+            return 0
+
+        if args.set_key is not None:
+            path = save_api_key(args.set_key)
+            print(f"API Key 保存成功: {path}")
+            return 0
+
+        api_key = resolve_api_key()
+        print(f"API Key 获取成功: {api_key[:8]}...{api_key[-4:]}")
+        return 0
+    except RuntimeError as exc:
+        print(f"错误：{exc}", file=sys.stderr)
+        return 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())