@unityclaw/skills 1.1.2 → 1.1.4

package/unityclaw-document-translation/SKILL.md

@@ -1,318 +0,0 @@
----
-name: unityclaw-document-translation
-description: Translate documents between multiple languages while preserving formatting
-version: 1.1.2
-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 Document Translation
-
-Translate documents between multiple languages while preserving original formatting and structure.
-
-## Installation
-
-```bash
-npm install @unityclaw/sdk
-```
-
-## Configuration
-
-Set your API key using one of these methods:
-
-```bash
-# Method 1: Use SDK CLI (recommended - persists across sessions)
-npx @unityclaw/sdk config set apiKey your-api-key
-
-# Method 2: Environment variable
-export UNITYCLAW_API_KEY=your-api-key
-```
-
-## Response Structure
-
-> **IMPORTANT:** The result has a nested structure. Use `result.success` to check overall success, and access data via `result.response.data`.
-
-```typescript
-interface UnityClawResult {
-  success: boolean;        // ✅ Use this to check if SDK call succeeded
-  taskId: string;          // Task identifier
-  taskFolder: string;      // Path to task folder with logs
-  duration: number;        // Request duration in ms
-  response: {              // API response object
-    code: number;          // 0 = success
-    data: Array<{          // ✅ Result data here
-      name: string;
-      contentType: string;
-      content: string;     // URL to translated document
-    }> | null;
-  };
-  logs: Array<{ timestamp; level; message }>;
-  attachments: any[];
-}
-```
-
-## Quick Start
-
-```typescript
-import { UnityClawClient } from '@unityclaw/sdk';
-
-const client = new UnityClawClient();
-
-const result = await client.document.translate({
-  attachment: [
-    { path: './files/document.pdf' }
-  ],
-  source_language: { value: 'en', label: 'English' },
-  target_language: { value: 'zh', label: 'Chinese' }
-});
-
-// ✅ Correct: Check result.success, access data via result.response.data
-if (result.success && result.response?.data) {
-  console.log('Translated document:', result.response.data);
-}
-```
-
-## API Reference
-
-### translate()
-
-Translate a document from one language to another.
-
-```typescript
-await client.document.translate({
-  attachment: AttachmentFieldItem[];
-  source_language: LabelFieldItem | string;
-  target_language: LabelFieldItem | string;
-}): Promise<APIResponse<AttachmentResult[]>>
-```
-
-## Parameters
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `attachment` | `AttachmentFieldItem[]` | Yes | Document(s) to translate |
-| `source_language` | `LabelFieldItem \| string` | Yes | Source language code |
-| `target_language` | `LabelFieldItem \| string` | Yes | Target language code |
-
-## Supported Languages
-
-| Code | Language |
-|------|----------|
-| `en` | English |
-| `zh` | Chinese (Simplified) |
-| `zh-TW` | Chinese (Traditional) |
-| `ja` | Japanese |
-| `ko` | Korean |
-| `es` | Spanish |
-| `fr` | French |
-| `de` | German |
-| `pt` | Portuguese |
-| `ru` | Russian |
-| `ar` | Arabic |
-| `it` | Italian |
-| `nl` | Dutch |
-| `pl` | Polish |
-| `tr` | Turkish |
-| `vi` | Vietnamese |
-| `th` | Thai |
-| `id` | Indonesian |
-
-## Supported Document Formats
-
-- PDF (.pdf)
-- Word (.doc, .docx)
-- PowerPoint (.ppt, .pptx)
-- Excel (.xls, .xlsx)
-- Text (.txt)
-- RTF (.rtf)
-
-## Examples
-
-### PDF Translation
-
-```typescript
-const client = new UnityClawClient();
-
-const result = await client.document.translate({
-  attachment: [
-    { tmp_url: 'https://example.com/report.pdf', name: 'report.pdf' }
-  ],
-  source_language: { value: 'en', label: 'English' },
-  target_language: { value: 'zh', label: 'Chinese' }
-});
-
-if (result.success && result.response?.data) {
-  console.log('Translated PDF:', result.response.data[0].content);
-}
-```
-
-### Word Document Translation
-
-```typescript
-const result = await client.document.translate({
-  attachment: [
-    { tmp_url: 'https://example.com/contract.docx', name: 'contract.docx' }
-  ],
-  source_language: 'en',
-  target_language: 'ja'
-});
-```
-
-### Simple String Parameters
-
-```typescript
-// Use simple strings for language codes
-const result = await client.document.translate({
-  attachment: [
-    { tmp_url: 'https://example.com/doc.pdf', name: 'doc.pdf' }
-  ],
-  source_language: 'en',
-  target_language: 'zh'
-});
-```
-
-### Batch Translation
-
-```typescript
-const documents = [
-  { tmp_url: 'https://example.com/doc1.pdf', name: 'doc1.pdf' },
-  { tmp_url: 'https://example.com/doc2.pdf', name: 'doc2.pdf' },
-  { tmp_url: 'https://example.com/doc3.pdf', name: 'doc3.pdf' }
-];
-
-const result = await client.document.translate({
-  attachment: documents,
-  source_language: { value: 'en', label: 'English' },
-  target_language: { value: 'zh', label: 'Chinese' }
-});
-
-if (result.success && result.response?.data) {
-  result.response.data.forEach((doc, i) => {
-    console.log(`Document ${i + 1}: ${doc.content}`);
-  });
-}
-```
-
-### Multi-Language Translation
-
-```typescript
-const translateTo = async (
-  documentUrl: string,
-  targetLanguages: string[]
-) => {
-  const client = new UnityClawClient();
-  const results = await Promise.all(
-    targetLanguages.map(lang =>
-      client.document.translate({
-        attachment: [{ tmp_url: documentUrl, name: 'document.pdf' }],
-        source_language: 'en',
-        target_language: lang
-      })
-    )
-  );
-
-  return results;
-};
-
-// Translate English document to multiple languages
-const translations = await translateTo(
-  'https://example.com/english-doc.pdf',
-  ['zh', 'ja', 'ko', 'es', 'fr']
-);
-```
-
-### Chinese to English
-
-```typescript
-const result = await client.document.translate({
-  attachment: [
-    { tmp_url: 'https://example.com/chinese-doc.pdf', name: 'chinese.pdf' }
-  ],
-  source_language: { value: 'zh', label: 'Chinese' },
-  target_language: { value: 'en', label: 'English' }
-});
-```
-
-## Response Format
-
-```typescript
-interface AttachmentResult {
-  name: string;
-  contentType: 'attachment/url';
-  content: string;  // URL to translated document
-}
-```
-
-## Error Handling
-
-```typescript
-const result = await client.document.translate({
-  attachment: [{ tmp_url: 'https://...', name: 'doc.pdf' }],
-  source_language: 'en',
-  target_language: 'zh'
-});
-
-if (!result.success) {
-  console.error('Request failed');
-  console.log('Check logs:', result.logs);
-  return;
-}
-
-if (result.response?.code !== 0) {
-  console.error('API error:', result.response);
-  return;
-}
-
-// Success
-console.log('Success:', result.response.data);
-```
-
-## Task Folders
-
-Each execution creates a task folder:
-
-```typescript
-const result = await client.document.translate({
-  attachment: [{ tmp_url: 'https://...', name: 'doc.pdf' }],
-  source_language: 'en',
-  target_language: 'zh'
-});
-
-console.log('Task ID:', result.taskId);
-console.log('Task Folder:', result.taskFolder);
-console.log('Downloaded Files:', result.attachments);
-```
-
-## Best Practices
-
-1. **Format Preservation**: Original formatting is maintained
-2. **Large Documents**: May take longer for extensive documents
-3. **Language Detection**: Specify source language for accuracy
-4. **Quality Review**: Review translations for context-specific terms
-
-## Related Skills
-
-- [unityclaw-document-convert](../unityclaw-document-convert/SKILL.md) - Convert document formats
-- [unityclaw-media-analysis](../unityclaw-media-analysis/SKILL.md) - Analyze video/audio content
-
-<!-- SDK_VERSION_RULE_START -->
-## SDK Version Check Rule
-
-- Before invoking this skill, check local `@unityclaw/sdk` version.
-- Required minimum SDK version: `1.1.2`
-- 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-idp-business-extraction/SKILL.md

@@ -1,63 +0,0 @@
----
-name: unityclaw-idp-business-extraction
-description: Extract fields from business documents (business license, business card)
-version: 1.1.2
-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 IDP - Business Extraction
-
-Use this skill for business document extraction:
-- `business_license`
-- `business_card`
-
-## SDK APIs
-
-```typescript
-await client.idp.businessLicense({ attachments: [{ path: './files/business-license.jpg' }] });
-await client.idp.businessCard({ attachments: [{ path: './files/business-card.jpg' }] });
-```
-
-Or generic API:
-
-```typescript
-await client.idp.extract('business_license', {
-  attachments: [{ path: './files/business-license.jpg' }]
-});
-```
-
-## Input
-
-```typescript
-{
-  attachments: AttachmentInput[]
-}
-```
-
-## Notes
-
-- This skill groups enterprise scenarios to avoid over-generic routing.
-- Output fields vary between license and card extraction.
-
-<!-- SDK_VERSION_RULE_START -->
-## SDK Version Check Rule
-
-- Before invoking this skill, check local `@unityclaw/sdk` version.
-- Required minimum SDK version: `1.1.2`
-- 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-idp-contract-extraction/SKILL.md

@@ -1,63 +0,0 @@
----
-name: unityclaw-idp-contract-extraction
-description: Extract structured fields from contract files
-version: 1.1.2
-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 IDP - Contract Extraction
-
-Use this skill for contract parsing:
-- `contract`
-
-## SDK APIs
-
-```typescript
-await client.idp.contract({
-  attachments: [{ path: './files/contract.pdf' }]
-});
-```
-
-Or generic API:
-
-```typescript
-await client.idp.extract('contract', {
-  attachments: [{ path: './files/contract.pdf' }]
-});
-```
-
-## Input
-
-```typescript
-{
-  attachments: AttachmentInput[]
-}
-```
-
-## Notes
-
-- Preferred for long contract OCR + key field extraction scenarios.
-- Read extracted data from `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.1.2`
-- 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-idp-invoice-extraction/SKILL.md

@@ -1,65 +0,0 @@
----
-name: unityclaw-idp-invoice-extraction
-description: Extract fields from invoice and ticket documents (VAT, train, taxi)
-version: 1.1.2
-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 IDP - Invoice Extraction
-
-Use this skill for invoice/ticket extraction:
-- `vat_invoice`
-- `train_invoice`
-- `taxi_invoice`
-
-## SDK APIs
-
-```typescript
-await client.idp.vatInvoice({ attachments: [{ path: './files/vat-invoice.pdf' }] });
-await client.idp.trainInvoice({ attachments: [{ path: './files/train-ticket.jpg' }] });
-await client.idp.taxiInvoice({ attachments: [{ path: './files/taxi-invoice.jpg' }] });
-```
-
-Or generic API:
-
-```typescript
-await client.idp.extract('vat_invoice', {
-  attachments: [{ path: './files/vat-invoice.pdf' }]
-});
-```
-
-## Input
-
-```typescript
-{
-  attachments: AttachmentInput[]
-}
-```
-
-## Notes
-
-- Files can be image/PDF according to each underlying IDP type.
-- Output schema differs by type; parse from `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.1.2`
-- 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-idp-personal-documents/SKILL.md

@@ -1,69 +0,0 @@
----
-name: unityclaw-idp-personal-documents
-description: Extract structured fields from personal identity documents (ID card, vehicle license, bank card)
-version: 1.1.2
-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 IDP - Personal Documents
-
-Use this skill for personal document extraction:
-- `id_card`
-- `vehicle_license`
-- `bank_card`
-
-## SDK APIs
-
-```typescript
-await client.idp.idCard({ attachments: [{ path: './files/id-card.jpg' }] });
-await client.idp.vehicleLicense({ attachments: [{ path: './files/vehicle-license.jpg' }] });
-await client.idp.bankCard({ attachments: [{ path: './files/bank-card.jpg' }] });
-```
-
-Or generic API:
-
-```typescript
-await client.idp.extract('id_card', {
-  attachments: [{ path: './files/id-card.jpg' }]
-});
-```
-
-## Input
-
-```typescript
-{
-  attachments: AttachmentInput[]
-}
-```
-
-`AttachmentInput` supports:
-- `tmp_url`
-- local path (`path` / `localPath` / `filePath`), SDK auto-uploads to `/api/upload`
-
-## Notes
-
-- This category is split from invoice/business/contract to improve skill routing success.
-- Output fields vary by type; read from `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.1.2`
-- 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 -->