@unityclaw/skills 1.0.6 → 1.0.9

package/unityclaw-image-generation/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-image-generation
 description: Generate high-quality images using Gemini or JiMeng (Doubao) models
-version: 1.0.1
+version: 1.0.9
 metadata:
   openclaw:
     requires:
@@ -22,6 +22,7 @@ metadata:
 # UnityClaw Image Generation
 
 Generate high-quality images using Gemini or JiMeng (Doubao) AI models.
+This skill keeps JiMeng as one unified entry (no separate v3 skill).
 
 ## Installation
 
@@ -89,6 +90,12 @@ if (result.success && result.response?.data) {
 }
 ```
 
+You can pass local files directly and SDK will auto-upload them:
+
+```typescript
+attachment: [{ path: './files/reference.jpg' }]
+```
+
 ## Available APIs
 
 ### Gemini Image Generation
@@ -117,30 +124,56 @@ const result = await client.image.geminiV2({
 
 ### JiMeng Image Generation
 
+> **IMPORTANT:** JiMeng uses different parameters than Gemini. Pay attention to the `size` and `model_selector` values.
+
 ```typescript
-// Basic usage
+// Basic usage (defaults to Seedream 5.0 Lite model)
 const result = await client.image.jimeng({
   prompt: '一只可爱的猫咪在花园里玩耍',
-  size: { value: '1024x1024', label: '1:1' }
+  size: { value: '2048x2048', label: '2K 1:1' }
 });
 
-// With all options
+// With Seedream 5.0 Lite (supports web_search, 2K and 3K resolutions)
 const result = await client.image.jimeng({
   prompt: 'A serene Japanese garden in autumn',
   attachment: [{ tmp_url: 'https://...', name: 'style.jpg' }],
-  size: { value: '1024x1024', label: '1:1' },
-  model_selector: { value: 'general', label: 'General' },
-  web_search: { value: true, label: 'Enable' },
+  size: { value: '2048x2048', label: '2K 1:1' },
+  model_selector: { value: 'doubao-seedream-5-0-260128', label: 'Seedream 5.0 Lite' },
+  web_search: { value: 'true', label: 'Enable' },
   image_count: { value: 4, label: '4 images' }
 });
 
-// JiMeng V3
-const result = await client.image.jimengV3({
+// With Seedream 4.5 (supports 4K resolution, no web_search)
+const result = await client.image.jimeng({
   prompt: 'A mystical forest with glowing mushrooms',
-  size: { value: '1024x1024', label: '1:1' }
+  size: { value: '4096x4096', label: '4K 1:1' },
+  model_selector: { value: 'doubao-seedream-4-5-251128', label: 'Seedream 4.5' }
 });
+
 ```
 
+#### JiMeng Size Options
+
+| Resolution | 5.0 Lite | 4.5 | Size Values |
+|------------|----------|-----|-------------|
+| 2K | ✅ | ✅ | `2048x2048`, `1728x2304`, `2304x1728`, `2848x1600`, `1600x2848`, `2496x1664`, `1664x2496`, `3136x1344` |
+| 3K | ✅ | ❌ | `3072x3072`, `2592x3456`, `3456x2592`, `4096x2304`, `2304x4096`, `3744x2496`, `2496x3744`, `4704x2016` |
+| 4K | ❌ | ✅ | `4096x4096`, `3520x4704`, `4704x3520`, `5504x3040`, `3040x5504`, `4992x3328`, `3328x4992`, `6240x2656` |
+
+> **Note:** `web_search` only works with Seedream 5.0 Lite model.
+
+## Troubleshooting (`/api/jimeng/image`)
+
+If you see backend errors like `{"code":1254500}`, check these first:
+
+- Do not use `jimeng/image/v3` size values (for example `1152x896`) on `/api/jimeng/image`.
+- For `/api/jimeng/image`, use 2K/3K/4K size values such as:
+  `2048x2048`, `3072x3072`, `4096x4096`.
+- Model and size must match:
+  - `doubao-seedream-5-0-260128` does **not** support 4K.
+  - `doubao-seedream-4-5-251128` does **not** support 3K.
+- `web_search=true` only works with `doubao-seedream-5-0-260128`.
+
 ## Parameter Types
 
 ### GeminiImageParams
@@ -158,11 +191,12 @@ const result = await client.image.jimengV3({
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
 | `prompt` | `string \| TextFieldItem[]` | Yes | Text description (supports Chinese) |
-| `attachment` | `AttachmentFieldItem[]` | No | Reference images |
-| `size` | `LabelFieldItem` | Yes | Size: `'1024x1024'` (1:1), `'896x1152'` (9:16), `'1152x896'` (16:9) |
-| `model_selector` | `LabelFieldItem` | No | Model type |
-| `web_search` | `LabelFieldItem` | No | Enable web search for references |
-| `image_count` | `LabelFieldItem \| number` | No | Number of images to generate |
+| `attachment` | `AttachmentFieldItem[]` | No | Reference images for style transfer |
+| `size` | `LabelFieldItem` | Yes | Size: `'2048x2048'` (2K), `'3072x3072'` (3K), `'4096x4096'` (4K) and more |
+| `model_selector` | `LabelFieldItem` | No | Model: `'doubao-seedream-5-0-260128'` (5.0 Lite) or `'doubao-seedream-4-5-251128'` (4.5) |
+| `web_search` | `LabelFieldItem` | No | Enable web search (5.0 Lite only): `'true'` or `'false'` |
+| `image_count` | `LabelFieldItem \| number` | No | Number of images to generate (0-5) |
+| `model` | `string` | No | Direct model override |
 
 ## Examples
 
@@ -267,4 +301,13 @@ console.log('Task Folder:', result.taskFolder); // e.g., "~/Documents/tasks/2026
 ## Related Skills
 
 - [unityclaw-image-compress](../unityclaw-image-compress/SKILL.md) - Compress generated images
-- [unityclaw-video-generation-sora](../unityclaw-video-generation-sora/SKILL.md) - Generate videos with Sora
+- [unityclaw-video-generation-kling](../unityclaw-video-generation-kling/SKILL.md) - Generate videos
+
+<!-- SDK_VERSION_RULE_START -->
+## SDK Version Check Rule
+
+- Before invoking this skill, check local `@unityclaw/sdk` version.
+- Required minimum SDK version: `1.0.9`
+- If local SDK version is lower than this skill version, stop and prompt user to upgrade SDK first.
+- Suggested command: `npm i @unityclaw/sdk@latest`
+<!-- SDK_VERSION_RULE_END -->

package/unityclaw-media-analysis/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-media-analysis
 description: Analyze video and audio content to extract subtitles, summaries, and insights
-version: 1.0.1
+version: 1.0.9
 metadata:
   openclaw:
     requires:
@@ -96,18 +96,17 @@ await client.media.analyze({
 
 ### analyzeVideo()
 
-Analyze a video file directly.
+Analyze a video file directly (SDK helper on top of `/api/media_analysis`).
 
 ```typescript
 await client.media.analyzeVideo({
   file: { tmp_url: string; type?: string; name?: string; size?: number };
-  prompt?: string;
 }): Promise<APIResponse<MediaAnalysisResult>>
 ```
 
 ### analyzeSocialVideo()
 
-Analyze social media videos (TikTok, YouTube, etc.).
+Analyze social media videos by URL (SDK helper on top of `/api/media_analysis`).
 
 ```typescript
 await client.media.analyzeSocialVideo({
@@ -172,8 +171,8 @@ const result = await client.media.analyzeSocialVideo({
   url: 'https://www.tiktok.com/@user/video/123456789'
 });
 
-if (result.code === 0 && result.data) {
-  console.log('Content:', result.data.summary);
+if (result.success && result.response?.data) {
+  console.log('Content:', result.response.data.summary);
 }
 ```
 
@@ -188,8 +187,8 @@ const result = await client.media.analyzeVideo({
   }
 });
 
-if (result.code === 0 && result.data) {
-  console.log('Meeting summary:', result.data.summary);
+if (result.success && result.response?.data) {
+  console.log('Meeting summary:', result.response.data.summary);
 }
 ```
 
@@ -204,8 +203,8 @@ const result = await client.media.analyzeVideo({
   prompt: 'Extract all code snippets and programming concepts mentioned in this tutorial'
 });
 
-if (result.code === 0 && result.data) {
-  console.log('Analysis:', result.data.summary);
+if (result.success && result.response?.data) {
+  console.log('Analysis:', result.response.data.summary);
 }
 ```
 
@@ -242,9 +241,9 @@ const result = await client.media.analyze({
   ]
 });
 
-if (result.code === 0 && result.data) {
-  console.log('Podcast summary:', result.data.summary);
-  console.log('Transcript:', result.data.subtitle);
+if (result.success && result.response?.data) {
+  console.log('Podcast summary:', result.response.data.summary);
+  console.log('Transcript:', result.response.data.subtitle);
 }
 ```
 
@@ -259,8 +258,8 @@ const result = await client.media.analyzeVideo({
   prompt: 'Extract action items, decisions made, and key discussion points'
 });
 
-if (result.code === 0 && result.data) {
-  console.log('Meeting Notes:', result.data.summary);
+if (result.success && result.response?.data) {
+  console.log('Meeting Notes:', result.response.data.summary);
 }
 ```
 
@@ -271,9 +270,9 @@ const result = await client.media.analyze({
   url: [{ link: 'https://youtube.com/watch?v=lecture-id' }]
 });
 
-if (result.code === 0 && result.data) {
-  console.log('Lecture Summary:', result.data.summary);
-  console.log('Full Transcript:', result.data.subtitle);
+if (result.success && result.response?.data) {
+  console.log('Lecture Summary:', result.response.data.summary);
+  console.log('Full Transcript:', result.response.data.subtitle);
 }
 ```
 
@@ -347,4 +346,13 @@ console.log('Task Folder:', result.taskFolder);
 ## Related Skills
 
 - [unityclaw-document-translation](../unityclaw-document-translation/SKILL.md) - Translate transcripts
-- [unityclaw-video-generation-sora](../unityclaw-video-generation-sora/SKILL.md) - Generate videos
+- [unityclaw-video-generation-kling](../unityclaw-video-generation-kling/SKILL.md) - Generate videos
+
+<!-- SDK_VERSION_RULE_START -->
+## SDK Version Check Rule
+
+- Before invoking this skill, check local `@unityclaw/sdk` version.
+- Required minimum SDK version: `1.0.9`
+- If local SDK version is lower than this skill version, stop and prompt user to upgrade SDK first.
+- Suggested command: `npm i @unityclaw/sdk@latest`
+<!-- SDK_VERSION_RULE_END -->

package/unityclaw-media-download-xhs/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: unityclaw-media-download-xhs
+description: Download Xiaohongshu media and return cover/video URLs
+version: 1.0.9
+metadata:
+  openclaw:
+    requires:
+      env:
+        - UNITYCLAW_API_KEY
+      bins:
+        - node
+        - npm
+    primaryEnv: UNITYCLAW_API_KEY
+    emoji: "📥"
+    homepage: https://unityclaw.com
+    install:
+      - kind: node
+        package: "@unityclaw/sdk"
+        bins: []
+---
+
+# UnityClaw Xiaohongshu Download
+
+Download media metadata from Xiaohongshu links.
+
+```typescript
+import { UnityClawClient } from '@unityclaw/sdk';
+
+const client = new UnityClawClient();
+const result = await client.media.downloadXiaohongshu({
+  url: [{ link: 'https://www.xiaohongshu.com/explore/xxxx' }],
+});
+
+if (result.success && result.response?.data) {
+  console.log(result.response.data.cover_url, result.response.data.video_urls);
+}
+```
+
+- API: `/api/xiaohongshu/download`
+- field-feishu: `xiaohongshu/download`
+
+<!-- SDK_VERSION_RULE_START -->
+## SDK Version Check Rule
+
+- Before invoking this skill, check local `@unityclaw/sdk` version.
+- Required minimum SDK version: `1.0.9`
+- If local SDK version is lower than this skill version, stop and prompt user to upgrade SDK first.
+- Suggested command: `npm i @unityclaw/sdk@latest`
+<!-- SDK_VERSION_RULE_END -->

package/unityclaw-media-stats/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: unityclaw-media-stats
+description: Extract social media post metrics (play, like, comment, share, etc.) from links
+version: 1.0.9
+metadata:
+  openclaw:
+    requires:
+      env:
+        - UNITYCLAW_API_KEY
+      bins:
+        - node
+        - npm
+    primaryEnv: UNITYCLAW_API_KEY
+    emoji: "📈"
+    homepage: https://unityclaw.com
+    install:
+      - kind: node
+        package: "@unityclaw/sdk"
+        bins: []
+---
+
+# UnityClaw Media Stats
+
+Get media metrics from social video links.
+
+```typescript
+import { UnityClawClient } from '@unityclaw/sdk';
+
+const client = new UnityClawClient();
+const result = await client.media.stats({
+  link: [{ link: 'https://www.xiaohongshu.com/explore/xxxx' }],
+});
+
+if (result.success && result.response?.data) {
+  console.log(result.response.data.play_count, result.response.data.like_count);
+}
+```
+
+- API: `/api/media_stats`
+- field-feishu: `media_stats`
+
+<!-- SDK_VERSION_RULE_START -->
+## SDK Version Check Rule
+
+- Before invoking this skill, check local `@unityclaw/sdk` version.
+- Required minimum SDK version: `1.0.9`
+- If local SDK version is lower than this skill version, stop and prompt user to upgrade SDK first.
+- Suggested command: `npm i @unityclaw/sdk@latest`
+<!-- SDK_VERSION_RULE_END -->

package/unityclaw-media-user-info/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: unityclaw-media-user-info
+description: Extract social media user profile metrics from homepage links
+version: 1.0.9
+metadata:
+  openclaw:
+    requires:
+      env:
+        - UNITYCLAW_API_KEY
+      bins:
+        - node
+        - npm
+    primaryEnv: UNITYCLAW_API_KEY
+    emoji: "👤"
+    homepage: https://unityclaw.com
+    install:
+      - kind: node
+        package: "@unityclaw/sdk"
+        bins: []
+---
+
+# UnityClaw Media User Info
+
+Get user profile information from social media homepage links.
+
+```typescript
+import { UnityClawClient } from '@unityclaw/sdk';
+
+const client = new UnityClawClient();
+const result = await client.media.userInfo({
+  link: [{ link: 'https://www.xiaohongshu.com/user/profile/xxxx' }],
+});
+
+if (result.success && result.response?.data) {
+  console.log(result.response.data.user_id, result.response.data.follower_count);
+}
+```
+
+- API: `/api/media_user_info`
+- field-feishu: `media_user_info`
+
+<!-- SDK_VERSION_RULE_START -->
+## SDK Version Check Rule
+
+- Before invoking this skill, check local `@unityclaw/sdk` version.
+- Required minimum SDK version: `1.0.9`
+- If local SDK version is lower than this skill version, stop and prompt user to upgrade SDK first.
+- Suggested command: `npm i @unityclaw/sdk@latest`
+<!-- SDK_VERSION_RULE_END -->

package/unityclaw-video-frame-extract/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: unityclaw-video-frame-extract
+description: Extract first/last/specified-time frame from video attachments
+version: 1.0.9
+metadata:
+  openclaw:
+    requires:
+      env:
+        - UNITYCLAW_API_KEY
+      bins:
+        - node
+        - npm
+    primaryEnv: UNITYCLAW_API_KEY
+    emoji: "🖼️"
+    homepage: https://unityclaw.com
+    install:
+      - kind: node
+        package: "@unityclaw/sdk"
+        bins: []
+---
+
+# UnityClaw Video Frame Extract
+
+Extract one frame from video at first frame, last frame, or specific `mm:ss`.
+
+```typescript
+import { UnityClawClient } from '@unityclaw/sdk';
+
+const client = new UnityClawClient();
+const result = await client.media.extractFrame({
+  attachment: [{ path: './files/demo.mp4' }],
+  frame_option: 'first',
+});
+
+if (result.success && result.response?.data?.[0]) {
+  console.log(result.response.data[0].content);
+}
+```
+
+- API: `/api/video/frame`
+- field-feishu: `video/frame`
+
+<!-- SDK_VERSION_RULE_START -->
+## SDK Version Check Rule
+
+- Before invoking this skill, check local `@unityclaw/sdk` version.
+- Required minimum SDK version: `1.0.9`
+- If local SDK version is lower than this skill version, stop and prompt user to upgrade SDK first.
+- Suggested command: `npm i @unityclaw/sdk@latest`
+<!-- SDK_VERSION_RULE_END -->

package/unityclaw-video-generation-jimeng-doubao/SKILL.md

@@ -0,0 +1,79 @@
+---
+name: unityclaw-video-generation-jimeng-doubao
+description: Generate videos with JiMeng or Doubao models (text-to-video and image-to-video)
+version: 1.0.9
+metadata:
+  openclaw:
+    requires:
+      env:
+        - UNITYCLAW_API_KEY
+      bins:
+        - node
+        - npm
+    primaryEnv: UNITYCLAW_API_KEY
+    emoji: "🎬"
+    homepage: https://unityclaw.com
+    install:
+      - kind: node
+        package: "@unityclaw/sdk"
+        bins: []
+---
+
+# UnityClaw Video Generation - JiMeng & Doubao
+
+Use this skill when the task matches `client.video.jimeng(...)` or `client.video.doubao(...)`.
+
+## When To Use
+
+- JiMeng: explicit `action` + `aspect_ratio` flow
+- Doubao: `resolution` + `ratio` flow, optional image input
+
+## Quick Start
+
+```typescript
+import { UnityClawClient } from '@unityclaw/sdk';
+
+const client = new UnityClawClient();
+
+const result = await client.video.doubao({
+  prompt: 'A cinematic drone shot of mountains at sunrise',
+  resolution: '1080p',
+  ratio: '16:9',
+  duration: 5,
+});
+
+if (result.success && result.response?.data) {
+  console.log(result.response.data[0].content);
+}
+```
+
+## API Map
+
+- `client.video.jimeng(...)`
+: fields: `action`, `prompt`, `attachment`, `aspect_ratio`
+- `client.video.doubao(...)`
+: fields: `prompt`, `attachment`, `resolution`, `ratio`, `duration`
+
+## Local File Input
+
+```typescript
+attachment: [{ path: './files/first-frame.jpg' }]
+```
+
+SDK will auto-upload local files and fill `tmp_url`.
+
+## Notes For Agent
+
+- Prefer `doubao` for generic prompts if user did not specify model family.
+- For JiMeng, ensure `action` and `aspect_ratio` are provided.
+- For Doubao, prefer numeric duration values (`5`, `10`) instead of string duration.
+- Always check `result.success` first, then read `result.response.data`.
+
+<!-- SDK_VERSION_RULE_START -->
+## SDK Version Check Rule
+
+- Before invoking this skill, check local `@unityclaw/sdk` version.
+- Required minimum SDK version: `1.0.9`
+- If local SDK version is lower than this skill version, stop and prompt user to upgrade SDK first.
+- Suggested command: `npm i @unityclaw/sdk@latest`
+<!-- SDK_VERSION_RULE_END -->

package/unityclaw-video-generation-kling/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-video-generation-kling
 description: Generate AI videos using Kling model with multi-version support
-version: 1.0.1
+version: 1.0.9
 metadata:
   openclaw:
     requires:
@@ -264,6 +264,14 @@ console.log('Downloaded Videos:', result.attachments);
 
 ## Related Skills
 
-- [unityclaw-video-generation-sora](../unityclaw-video-generation-sora/SKILL.md) - OpenAI Sora
-- [unityclaw-video-generation-veo](../unityclaw-video-generation-veo/SKILL.md) - Google Veo
-- [unityclaw-video-generation-other](../unityclaw-video-generation-other/SKILL.md) - Other video models
+- [unityclaw-video-generation-jimeng-doubao](../unityclaw-video-generation-jimeng-doubao/SKILL.md) - JiMeng and Doubao video models
+- [unityclaw-video-generation-wan-minimax](../unityclaw-video-generation-wan-minimax/SKILL.md) - Wan and MiniMax video models
+
+<!-- SDK_VERSION_RULE_START -->
+## SDK Version Check Rule
+
+- Before invoking this skill, check local `@unityclaw/sdk` version.
+- Required minimum SDK version: `1.0.9`
+- If local SDK version is lower than this skill version, stop and prompt user to upgrade SDK first.
+- Suggested command: `npm i @unityclaw/sdk@latest`
+<!-- SDK_VERSION_RULE_END -->

package/unityclaw-video-generation-wan-minimax/SKILL.md

@@ -0,0 +1,79 @@
+---
+name: unityclaw-video-generation-wan-minimax
+description: Generate videos with Wan and MiniMax models for cinematic or controllable workflows
+version: 1.0.9
+metadata:
+  openclaw:
+    requires:
+      env:
+        - UNITYCLAW_API_KEY
+      bins:
+        - node
+        - npm
+    primaryEnv: UNITYCLAW_API_KEY
+    emoji: "🎞️"
+    homepage: https://unityclaw.com
+    install:
+      - kind: node
+        package: "@unityclaw/sdk"
+        bins: []
+---
+
+# UnityClaw Video Generation - Wan & MiniMax
+
+Use this skill when the task matches `client.video.wan(...)` or `client.video.minimax(...)`.
+
+## When To Use
+
+- Wan: stronger control on model/shot style (`model`, `shot_type`, `size`, `duration`)
+- MiniMax: Hailuo model family workflows (`model`, `size`, `duration`)
+
+## Quick Start
+
+```typescript
+import { UnityClawClient } from '@unityclaw/sdk';
+
+const client = new UnityClawClient();
+
+const result = await client.video.wan({
+  prompt: 'A samurai crossing a snowy bridge in cinematic style',
+  model: 'wan2.6-t2v',
+  size: '1280*720',
+  duration: '5',
+  shot_type: 'single',
+});
+
+if (result.success && result.response?.data) {
+  console.log(result.response.data[0].content);
+}
+```
+
+## API Map
+
+- `client.video.wan(...)`
+: fields: `prompt`, `attachment`, `model`, `size`, `duration`, `shot_type`
+- `client.video.minimax(...)`
+: fields: `prompt`, `attachment`, `model`, `size`, `duration`
+
+## Local File Input
+
+```typescript
+attachment: [{ path: './files/reference.jpg' }]
+```
+
+SDK will auto-upload local files and fill `tmp_url`.
+
+## Notes For Agent
+
+- If model family is not specified, default to Wan for cinematic control.
+- Keep prompt concise and explicit; avoid overlong instructions.
+- Always check `result.success` first, then read `result.response.data`.
+
+<!-- SDK_VERSION_RULE_START -->
+## SDK Version Check Rule
+
+- Before invoking this skill, check local `@unityclaw/sdk` version.
+- Required minimum SDK version: `1.0.9`
+- If local SDK version is lower than this skill version, stop and prompt user to upgrade SDK first.
+- Suggested command: `npm i @unityclaw/sdk@latest`
+<!-- SDK_VERSION_RULE_END -->