{"id":"b889216e-6470-4810-a3f8-731948186237","entityType":"agent","slug":"clawhub-dlazyai-dlazy-start","name":"智能体上手手册 Start","canonicalUrl":"https://www.xpersona.co/agent/clawhub-dlazyai-dlazy-start","canonicalPath":"/agent/clawhub-dlazyai-dlazy-start","generatedAt":"2026-10-09T21:36:12.242Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-09T10:19:28.947Z","emptyReason":null},"description":"Quickstart for AI orchestrators (Claude Code / Cursor / Codex / Copilot) driving @dlazy/cli. Covers install, auth, capability discovery, invoking cloud + local tools, polling async tasks, and recovering from common failures. AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。 Skill: 智能体上手手册 Start Owner: dlazyai Summary: Quickstart for AI orchestrators (Claude Code / Cursor / Codex / Copilot) driving @dlazy/cli. Covers install, auth, capability discovery, invoking cloud + local tools, polling async tasks, and recovering from common failures. AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。 Tags: latest:2.0.27 Version history: v2.0.","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 3K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s170j1ymymrxasgd00dsk7tckx84cf45:dlazy-start","sourceUrl":"https://clawhub.ai/dlazyai/dlazy-start","homepage":"https://clawhub.ai/dlazyai/skills/dlazy-start","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/dlazyai/dlazy-start","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/dlazyai/skills/dlazy-start","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":70,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Quickstart for AI orchestrators (Claude Code / Cursor / Codex / Copilot) driving @dlazy/cli. Covers install, auth, capability discovery, invoking cloud + local "},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T10:19:28.947Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T10:19:28.947Z","emptyReason":null},"stars":null,"forks":null,"downloads":2998,"packageName":null,"latestVersion":"2.0.27","tractionLabel":"3K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T10:19:28.947Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T10:19:28.947Z","lastCrawledAt":"2026-10-09T10:19:28.947Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T10:19:28.947Z","lastVerifiedAt":null,"highlights":[{"version":"2.0.27","createdAt":"2026-10-08T01:30:28.614Z","changelog":"例行版本更新 2026-10-08","fileCount":4,"zipByteSize":8383},{"version":"2.0.26","createdAt":"2026-10-04T01:30:28.313Z","changelog":"例行版本更新 2026-10-04","fileCount":4,"zipByteSize":8322},{"version":"2.0.25","createdAt":"2026-10-02T05:07:55.986Z","changelog":"例行版本更新 2026-10-02","fileCount":4,"zipByteSize":8326},{"version":"2.0.24","createdAt":"2026-09-30T01:29:52.457Z","changelog":"例行版本更新 2026-09-30","fileCount":4,"zipByteSize":8400},{"version":"2.0.23","createdAt":"2026-09-28T02:25:52.887Z","changelog":"例行版本更新 2026-09-28","fileCount":4,"zipByteSize":8303},{"version":"2.0.22","createdAt":"2026-09-28T01:28:34.713Z","changelog":"例行版本更新 2026-09-28","fileCount":4,"zipByteSize":8303},{"version":"2.0.21","createdAt":"2026-09-24T02:16:13.692Z","changelog":"例行版本更新 2026-09-24","fileCount":4,"zipByteSize":8608},{"version":"2.0.20","createdAt":"2026-09-22T01:27:05.711Z","changelog":"例行版本更新 2026-09-22","fileCount":4,"zipByteSize":8552}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s170j1ymymrxasgd00dsk7tckx84cf45:dlazy-start","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","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":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-dlazyai-dlazy-start/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-dlazyai-dlazy-start/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-dlazyai-dlazy-start/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-dlazyai-dlazy-start/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-dlazyai-dlazy-start/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-dlazyai-dlazy-start/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-09T21:36:12.239Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-dlazyai-dlazy-start/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-dlazyai-dlazy-start/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-dlazyai-dlazy-start/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-dlazyai-dlazy-start/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-09T10:19:28.947Z","emptyReason":null},"readme":"Skill: 智能体上手手册 Start\n\nOwner: dlazyai\n\nSummary: Quickstart for AI orchestrators (Claude Code / Cursor / Codex / Copilot) driving @dlazy/cli. Covers install, auth, capability discovery, invoking cloud + local tools, polling async tasks, and recovering from common failures. AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。\n\nTags: latest:2.0.27\n\nVersion history:\n\nv2.0.27 | 2026-10-08T01:30:28.614Z | user\n\n例行版本更新 2026-10-08\n\nv2.0.26 | 2026-10-04T01:30:28.313Z | user\n\n例行版本更新 2026-10-04\n\nv2.0.25 | 2026-10-02T05:07:55.986Z | user\n\n例行版本更新 2026-10-02\n\nv2.0.24 | 2026-09-30T01:29:52.457Z | user\n\n例行版本更新 2026-09-30\n\nv2.0.23 | 2026-09-28T02:25:52.887Z | user\n\n例行版本更新 2026-09-28\n\nv2.0.22 | 2026-09-28T01:28:34.713Z | user\n\n例行版本更新 2026-09-28\n\nv2.0.21 | 2026-09-24T02:16:13.692Z | user\n\n例行版本更新 2026-09-24\n\nv2.0.20 | 2026-09-22T01:27:05.711Z | user\n\n例行版本更新 2026-09-22\n\nv2.0.19 | 2026-09-20T01:35:04.762Z | user\n\n例行版本更新 2026-09-20\n\nv2.0.18 | 2026-09-18T01:57:03.448Z | user\n\n例行版本更新 2026-09-18\n\nv2.0.17 | 2026-09-14T01:26:52.833Z | user\n\n例行版本更新 2026-09-14\n\nv2.0.16 | 2026-09-10T01:24:49.370Z | user\n\n例行版本更新 2026-09-10\n\nv2.0.15 | 2026-09-08T01:28:24.705Z | user\n\n例行版本更新 2026-09-08\n\nv2.0.14 | 2026-09-07T01:35:46.611Z | user\n\n例行版本更新 2026-09-07\n\nv2.0.13 | 2026-09-04T01:31:20.139Z | user\n\n例行版本更新 2026-09-04\n\nv2.0.12 | 2026-09-02T01:26:17.610Z | user\n\n例行版本更新 2026-09-02\n\nv2.0.11 | 2026-08-31T03:05:35.075Z | user\n\n源码仓库迁移至 github.com/dlazy-ai/cli\n\nv2.0.10 | 2026-08-24T09:42:35.367Z | user\n\nRestore Chinese display name\n\nv2.0.9 | 2026-08-17T09:20:26.047Z | user\n\nRestore Chinese display name\n\nv2.0.8 | 2026-08-10T05:59:50.103Z | user\n\nRestore Chinese display name\n\nv2.0.7 | 2026-08-10T04:17:19.997Z | user\n\nRestore Chinese display name\n\nv2.0.6 | 2026-07-21T02:40:27.186Z | auto\n\n- Updated documentation in SKILL.md and SKILL-cn.md.\n- Removed the skill-card.md reference card file.\n- No functional or behavioral changes; documentation only.\n\nv2.0.5 | 2026-07-17T09:02:27.900Z | auto\n\n- Documentation updated in SKILL.md and SKILL-cn.md; no changes to functionality.\n- Reference file skill-card.md has been removed.\n- Version number remains unchanged in skill metadata.\n\nv2.0.4 | 2026-07-09T01:58:10.384Z | user\n\nset Chinese display name for CN search\n\nv2.0.3 | 2026-07-09T01:57:53.841Z | user\n\nset Chinese display name for CN search\n\nv2.0.2 | 2026-07-09T01:41:02.315Z | user\n\nset Chinese display name for CN search\n\nv1.3.0 | 2026-07-07T19:59:07.308Z | auto\n\n- Version number reverted from 2.0.1 to 1.3.0 in the skill metadata.\n- No user-facing content changes; documentation and quickstart instructions remain the same.\n- File update aligns version in SKILL.md with the specified 1.3.0 release.\n- Ensures consistency of version references across SKILL.md and SKILL-cn.md.\n\nv2.0.1 | 2026-07-07T18:53:57.416Z | auto\n\n- Updated CLI global flags, replacing `--output` with `--format` and documenting new output/download options (including `--save`).\n- Expanded the description to include a concise Chinese summary.\n- Updated instructions and examples to use `--format` instead of `--output` throughout.\n- Reference card, metadata, and usage tips revised to match latest CLI changes.\n- Removed obsolete skill-card.md file.\n\nv2.0.0 | 2026-06-02T10:00:38.263Z | auto\n\n- Updated documentation in both SKILL.md and SKILL-cn.md for clarity and completeness.\n- Removed the reference card file (skill-card.md) for simplification.\n- No changes to feature set or commands—documentation-only update.\n\nv1.0.0 | 2026-06-02T01:39:44.995Z | auto\n\ndlazy-start v2.0.0 is a comprehensive quickstart guide for AI orchestrators using @dlazy/cli.\n\n- Expanded documentation now covers install, authentication, capability discovery, invoking cloud and local tools, polling async tasks, and recovering from common failures.\n- Step-by-step walkthrough includes commands for discovering, describing, and invoking over 40 cloud and local tools.\n- Detailed troubleshooting and recovery tips for common errors and edge cases are included.\n- Local runtime installation processes (e.g., Remotion, yt-dlp) are clearly explained with fallback guidance.\n- Provides a concise reference card for quick command lookup and best practices.\n- Strong emphasis on correct tool discovery, validation, and anti-pattern avoidance for agent-driven workflows.\n\nArchive index:\n\nArchive v2.0.27: 4 files, 8383 bytes\n\nFiles: skill-card.md (2161b), SKILL-cn.md (6464b), SKILL.md (7014b), _meta.json (131b)\n\nFile v2.0.27:SKILL.md\n\n---\nname: dlazy-start\nversion: 2.0.6\ndescription: \"Quickstart for AI orchestrators (Claude Code / Cursor / Codex / Copilot) driving @dlazy/cli. Covers install, auth, capability discovery, invoking cloud + local tools, polling async tasks, and recovering from common failures. AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。\"\ntriggers:\n  - dLazy CLI Quickstart for AI Agents\nmetadata: {\"clawdbot\":{\"emoji\":\"🎬\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli\",\"installAlternative\":\"npx @dlazy/cli\",\"homepage\":\"https://dlazy.com\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"AGPL-3.0-or-later\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"You are operating @dlazy/cli for the user. Discovery first: run `dlazy tools list` to see available tools and `dlazy tools describe <name>` to inspect a tool's input/output schema and cost shape. Invoke with `dlazy <tool-name> --input @file.json` (or `--format json` for machine-readable envelopes). Poll long-running cloud tasks with `dlazy status <generateId>`. Install optional local runtimes with `dlazy doctor remotion --install` or `dlazy doctor yt-dlp --install`. Never claim a tool exists without verifying via `dlazy tools list`.\"}}\n---\n\n# 智能体上手手册 Start\n\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\n\nA minimal contract for AI orchestrators using `@dlazy/cli`. The CLI is a\ntool-dispatch surface: every registered cloud + local tool becomes a top-level\nsubcommand. There is no built-in project workspace or pipeline state machine —\nthose are agent-side concepts.\n\nLicense: AGPL-3.0-or-later.\n\n## What this skill teaches\n\nYou drive `@dlazy/cli` from auth through tool invocation:\n\n- **Cloud tools** (40+) — image / video / audio / text providers (Seedream,\n  Recraft, MJ, Veo, Seedance, Kling, ElevenLabs, …)\n- **Local tools** (40+) — `state_lock_profile`, `video_compose`,\n  `post_render_gate`, `scene_detect`, `frame_sampler`, `audio_mixer`,\n  `audio_probe`, `transcribe`, `subtitle`, `color_grade`, `extract_segment`,\n  `ffmpeg_run`, … (full list via `dlazy tools list`)\n- **CLI commands**: `auth`, `doctor`, `tools list`, `tools describe`,\n  `status`, plus one top-level subcommand per registered tool.\n\n---\n\n## Phase 0 — Install & auth\n\n```bash\n# Install once\nnpm install -g @dlazy/cli\n\n# Authenticate (device-code flow; works in remote shells)\ndlazy auth login\n```\n\nAlternate auth: `dlazy auth set YOUR_API_KEY`, or set the `DLAZY_API_KEY`\nenv var. Config lives at `~/.dlazy/config.json` (Windows:\n`%USERPROFILE%\\.dlazy\\`).\n\nGlobal flags every command accepts: `--api-key`, `--base-url`, `--verbose`,\n`--format <json|url|text>`, `--refresh-manifest`, `-l/--lang <locale>`.\n\n---\n\n## Phase 1 — Discover capabilities\n\n```bash\ndlazy --help                         # top-level command surface\ndlazy tools list                     # registered tools with type + cost shape\ndlazy tools describe <name>          # input/output JSON schema, hasCosts, examples\n```\n\nOptional local runtimes need a one-time install:\n\n```bash\ndlazy doctor remotion                # report Remotion composer state\ndlazy doctor remotion --install      # ~50s, installs the bundled composer\n\ndlazy doctor yt-dlp --install        # for video_downloader on YouTube et al.\ndlazy doctor yt-dlp --install --proxy http://127.0.0.1:1087\n```\n\nSome sandboxes restrict the tool surface via `DLAZY_DISABLED_TOOLS=<csv>`;\ndisabled tools are hidden from `dlazy --help` and refuse invocation with a\nclear `tool_disabled` error.\n\n---\n\n## Phase 2 — Invoke a tool\n\nEvery tool is a top-level subcommand:\n\n```bash\n# Inline flags (mirrors the input schema)\ndlazy gpt-image-2 --prompt \"cyberpunk cat at dusk\"\n\n# JSON input file (preferred for complex shapes)\ndlazy video_compose --input @work/compose.json --format json\n\n# Dry-run for validation only (no remote call, no credit consumption)\ndlazy seedance-2-0 --input @plan.json --dry-run\n```\n\nPer-tool help is generated from the schema:\n\n```bash\ndlazy <tool-name> --help\n```\n\nOutput modes:\n\n- `--format json` (default) — machine-readable envelope; parse with `jq`\n- `--format url` — bare URL when the tool produces a single asset\n- `--format text` — human-readable text payload\n- `--save <path>` — download the asset straight to disk (mkdir + retry handled for you)\n\n---\n\n## Phase 3 — Poll async cloud tasks\n\nLong-running generations return a `generateId` instead of the final asset:\n\n```bash\ndlazy status <generateId>\ndlazy status <generateId> --format json\n```\n\nRepeat until status is `succeeded` (then the asset URL is in the payload) or\n`failed` (with `error.code` + `error.message`).\n\n---\n\n## Phase 4 — Common failure recovery\n\n**`dlazy doctor remotion --install` fails on `npm install`:**\n- Check Node ≥ 18 (`node --version`).\n- Behind a corp proxy: set `npm_config_proxy` / `npm_config_https_proxy`.\n\n**`video_downloader` returns \"Sign in to confirm you're not a bot\":**\n- YouTube anti-bot challenge. Pass `\"cookies_from_browser\": \"chrome\"`\n  (or firefox / safari / edge) in the input JSON.\n\n**`video_compose` returns \"render_runtime=hyperframes not yet implemented\":**\n- HyperFrames runtime not shipped. Switch `edit_decisions.render_runtime` to\n  `remotion` or `ffmpeg`, then re-validate via `pre_render_validator`.\n\n**ElevenLabs STT returns an empty `words` array:**\n- Pass `timestamps_granularity: \"word\"` explicitly.\n\n**Need to know a tool's cost before invoking:**\n- `dlazy tools describe <name>` exposes `hasCosts` and the cost shape. Log\n  the estimate to a local file or your audit log before calling the tool.\n\n**Unknown command suggestion:**\n- `dlazy <typo>` returns `error: unknown command '<typo>'` plus a \"Did you\n  mean …?\" suggestion line based on edit distance. Trust the suggestion only\n  after confirming via `dlazy tools list`.\n\n---\n\n## Anti-patterns\n\n- Calling a tool whose existence you haven't verified via `dlazy tools list`.\n- Memorizing provider names from prior sessions instead of re-checking the\n  registry (tools come and go).\n- Silently swapping render runtime mid-pipeline (govern via `state_lock_profile`\n  + `post_render_gate` parity checks instead).\n- Calling paid generation without announcing provider / model / cost first.\n\n---\n\n## Reference card\n\n```\nINSTALL       npm install -g @dlazy/cli && dlazy auth login\nDISCOVER      dlazy tools list  |  dlazy tools describe <name>\nLOCAL RT      dlazy doctor remotion --install   (or yt-dlp)\nINVOKE        dlazy <tool-name> --input @file.json --format json\nDRY RUN       dlazy <tool-name> --input @file.json --dry-run\nPOLL          dlazy status <generateId>\nHELP          dlazy --help  |  dlazy <tool-name> --help\nRECOVER       dlazy doctor <target>  |  dlazy tools describe <name>\n```\n\nFile v2.0.27:_meta.json\n\n{\n  \"ownerId\": \"kn7c5wgeajfcfvdfb5ceemvdb984cjpd\",\n  \"slug\": \"dlazy-start\",\n  \"version\": \"2.0.27\",\n  \"publishedAt\": 1791423028614\n}\n\nFile v2.0.27:skill-card.md\n\n## Description:\n\nA quickstart for AI agents using the dLazy CLI to discover and run cloud and local media tools, authenticate, and monitor long-running tasks.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[dlazyai](https://clawhub.ai/user/dlazyai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and AI-agent users follow this quickstart to install and authenticate the dLazy CLI, inspect available tools and their costs, invoke media tools, and troubleshoot asynchronous tasks.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Installing the CLI or optional runtimes executes third-party packages in the local environment.\n\nMitigation: Install only from trusted sources, and pin or preinstall dependencies in controlled environments.\n\nRisk: API keys or browser cookies could expose credentials and active browser sessions.\n\nMitigation: Prefer device-code login over command-line keys; allow browser-cookie access only when explicitly intended for the target service.\n\nRisk: Cloud tool calls may consume paid credits or access remote media services.\n\nMitigation: Inspect the tool and its cost before invocation; use dry runs where available.\n\n## Reference(s):\n\n- [ClawHub skill listing](https://clawhub.ai/dlazyai/skills/dlazy-start)\n- [dLazy website](https://dlazy.com)\n- [dLazy CLI npm package](https://www.npmjs.com/package/@dlazy/cli)\n- [dLazy CLI repository (listed in skill metadata)](https://github.com/dlazy-ai/cli)\n\n## Skill Output:\n\n**Output Type(s):** [Guidance, Shell commands, Configuration instructions]\n\n**Output Format:** [Markdown with shell commands and JSON examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Tool responses may include JSON results or media URLs; long-running tasks require status polling.]\n\n## Skill Version(s):\n\n2.0.27 (source: ClawHub release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v2.0.27:SKILL-cn.md\n\n---\nname: dlazy-start\nversion: 2.0.6\ndescription: \"AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。\"\ntriggers:\n  - dLazy CLI 智能体上手手册\nmetadata: {\"clawdbot\":{\"emoji\":\"🎬\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli\",\"installAlternative\":\"npx @dlazy/cli\",\"homepage\":\"https://dlazy.com\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"AGPL-3.0-or-later\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"你正在为用户操作 @dlazy/cli。先探测:跑 `dlazy tools list` 看可用工具,`dlazy tools describe <名字>` 看单工具的 input/output schema 和成本。调用形态:`dlazy <工具名> --input @file.json`(或加 `--format json` 拿机读 envelope)。异步任务用 `dlazy status <generateId>` 轮询。需要本地 runtime 时跑 `dlazy doctor remotion --install` 或 `dlazy doctor yt-dlp --install`。在没用 `dlazy tools list` 核实之前,绝不声称某工具存在。\"}}\n---\n\n# 智能体上手手册 Start\n\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\n\n给 AI 编排器(Claude Code / Cursor / Codex / Copilot)用的最小契约。CLI 本质是一个工具分发壳:每个注册的云端/本地工具都会变成顶层 subcommand。CLI 不内置项目工作目录或 pipeline 状态机 —— 那些是上层 agent 的概念。\n\nLicense: AGPL-3.0-or-later。\n\n## 本 skill 教什么\n\n你从鉴权一路驱动 `@dlazy/cli` 到工具调用:\n\n- **云端工具**(40+) —— 图像 / 视频 / 音频 / 文本服务(Seedream / Recraft / MJ / Veo / Seedance / Kling / ElevenLabs / …)\n- **本地工具**(40+) —— `state_lock_profile`、`video_compose`、`post_render_gate`、`scene_detect`、`frame_sampler`、`audio_mixer`、`audio_probe`、`transcribe`、`subtitle`、`color_grade`、`extract_segment`、`ffmpeg_run`、…(完整列表跑 `dlazy tools list`)\n- **CLI 命令**: `auth`、`doctor`、`tools list`、`tools describe`、`status`,再加上每个注册工具对应的一个顶层 subcommand。\n\n---\n\n## Phase 0 — 安装与鉴权\n\n```bash\n# 一次性安装\nnpm install -g @dlazy/cli\n\n# 登录(设备码流程;远程终端也可用)\ndlazy auth login\n```\n\n备选鉴权:`dlazy auth set YOUR_API_KEY`,或设 `DLAZY_API_KEY` 环境变量。配置存在 `~/.dlazy/config.json`(Windows:`%USERPROFILE%\\.dlazy\\`)。\n\n所有命令都接受的全局 flag:`--api-key`、`--base-url`、`--verbose`、`--format <json|url|text>`、`--refresh-manifest`、`-l/--lang <locale>`。\n\n---\n\n## Phase 1 — 能力探测\n\n```bash\ndlazy --help                         # 顶层命令面\ndlazy tools list                     # 注册工具列表 + 类型 + 成本形态\ndlazy tools describe <名字>          # 单工具 input/output JSON schema + hasCosts + 示例\n```\n\n可选本地 runtime 需要一次性安装:\n\n```bash\ndlazy doctor remotion                # 报 Remotion composer 状态\ndlazy doctor remotion --install      # 约 50s,装 bundled composer\n\ndlazy doctor yt-dlp --install        # 用 video_downloader 拉 YouTube 等需要\ndlazy doctor yt-dlp --install --proxy http://127.0.0.1:1087\n```\n\n部分沙箱通过 `DLAZY_DISABLED_TOOLS=<逗号分隔>` 限制工具面;被禁用的工具不会出现在 `dlazy --help` 里,直接调会返回明确的 `tool_disabled` 错误。\n\n---\n\n## Phase 2 — 调用工具\n\n每个工具都是顶层 subcommand:\n\n```bash\n# 命令行 flag(对应 input schema)\ndlazy gpt-image-2 --prompt \"黄昏中的赛博朋克猫\"\n\n# JSON 输入文件(复杂结构推荐)\ndlazy video_compose --input @work/compose.json --format json\n\n# 干跑校验(不发远程调用,不扣额度)\ndlazy seedance-2-0 --input @plan.json --dry-run\n```\n\n每个工具的 help 是从 schema 生成的:\n\n```bash\ndlazy <工具名> --help\n```\n\n输出模式:\n\n- `--format json`(默认) —— 机读 envelope;用 `jq` 解析\n- `--format url` —— 单一素材产物时,直接给纯 URL\n- `--format text` —— 人读文本载荷\n- `--save <path>` —— 直接把素材下载到本地路径(自动 mkdir + 重试)\n\n---\n\n## Phase 3 — 轮询异步云任务\n\n长任务返回 `generateId` 而非素材:\n\n```bash\ndlazy status <generateId>\ndlazy status <generateId> --format json\n```\n\n反复轮询直到 `succeeded`(payload 里带素材 URL)或 `failed`(带 `error.code` + `error.message`)。\n\n---\n\n## Phase 4 — 常见失败恢复\n\n**`dlazy doctor remotion --install` 在 npm install 阶段失败:**\n- 检查 Node ≥ 18(`node --version`)。\n- 公司代理后面:设 `npm_config_proxy` / `npm_config_https_proxy`。\n\n**`video_downloader` 回复 \"Sign in to confirm you're not a bot\":**\n- YouTube 反爬挑战。input JSON 里加 `\"cookies_from_browser\": \"chrome\"`(或 firefox / safari / edge)。\n\n**`video_compose` 返回 \"render_runtime=hyperframes not yet implemented\":**\n- HyperFrames runtime 还没 ship。把 `edit_decisions.render_runtime` 切成 `remotion` 或 `ffmpeg`,再用 `pre_render_validator` 复检。\n\n**ElevenLabs STT 返回空 `words` 数组:**\n- 显式传 `timestamps_granularity: \"word\"`。\n\n**不知道工具成本就要调:**\n- `dlazy tools describe <名字>` 暴露 `hasCosts` 和成本形态。先把 estimate 写到本地审计日志,再调工具。\n\n**unknown command 提示:**\n- `dlazy <错字>` 返回 `error: unknown command '<typo>'` 加一条编辑距离推荐 \"Did you mean …?\"。先用 `dlazy tools list` 核实再信。\n\n---\n\n## 反模式\n\n- 没用 `dlazy tools list` 核实就调某工具。\n- 凭上次会话记忆写 provider 名,而不重新查注册表(工具会进出)。\n- pipeline 中途悄悄换 render runtime(用 `state_lock_profile` + `post_render_gate` parity 校验去管)。\n- 付费生成前不播报 provider / model / 成本。\n\n---\n\n## 速查卡\n\n```\n安装         npm install -g @dlazy/cli && dlazy auth login\n探测         dlazy tools list  |  dlazy tools describe <名字>\n本地 runtime  dlazy doctor remotion --install   (或 yt-dlp)\n调用         dlazy <工具名> --input @file.json --format json\n干跑         dlazy <工具名> --input @file.json --dry-run\n轮询         dlazy status <generateId>\n帮助         dlazy --help  |  dlazy <工具名> --help\n排障         dlazy doctor <目标>  |  dlazy tools describe <名字>\n```\n\nArchive v2.0.26: 4 files, 8322 bytes\n\nFiles: skill-card.md (2061b), SKILL-cn.md (6464b), SKILL.md (7014b), _meta.json (131b)\n\nFile v2.0.26:SKILL.md\n\n---\nname: dlazy-start\nversion: 2.0.6\ndescription: \"Quickstart for AI orchestrators (Claude Code / Cursor / Codex / Copilot) driving @dlazy/cli. Covers install, auth, capability discovery, invoking cloud + local tools, polling async tasks, and recovering from common failures. AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。\"\ntriggers:\n  - dLazy CLI Quickstart for AI Agents\nmetadata: {\"clawdbot\":{\"emoji\":\"🎬\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli\",\"installAlternative\":\"npx @dlazy/cli\",\"homepage\":\"https://dlazy.com\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"AGPL-3.0-or-later\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"You are operating @dlazy/cli for the user. Discovery first: run `dlazy tools list` to see available tools and `dlazy tools describe <name>` to inspect a tool's input/output schema and cost shape. Invoke with `dlazy <tool-name> --input @file.json` (or `--format json` for machine-readable envelopes). Poll long-running cloud tasks with `dlazy status <generateId>`. Install optional local runtimes with `dlazy doctor remotion --install` or `dlazy doctor yt-dlp --install`. Never claim a tool exists without verifying via `dlazy tools list`.\"}}\n---\n\n# 智能体上手手册 Start\n\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\n\nA minimal contract for AI orchestrators using `@dlazy/cli`. The CLI is a\ntool-dispatch surface: every registered cloud + local tool becomes a top-level\nsubcommand. There is no built-in project workspace or pipeline state machine —\nthose are agent-side concepts.\n\nLicense: AGPL-3.0-or-later.\n\n## What this skill teaches\n\nYou drive `@dlazy/cli` from auth through tool invocation:\n\n- **Cloud tools** (40+) — image / video / audio / text providers (Seedream,\n  Recraft, MJ, Veo, Seedance, Kling, ElevenLabs, …)\n- **Local tools** (40+) — `state_lock_profile`, `video_compose`,\n  `post_render_gate`, `scene_detect`, `frame_sampler`, `audio_mixer`,\n  `audio_probe`, `transcribe`, `subtitle`, `color_grade`, `extract_segment`,\n  `ffmpeg_run`, … (full list via `dlazy tools list`)\n- **CLI commands**: `auth`, `doctor`, `tools list`, `tools describe`,\n  `status`, plus one top-level subcommand per registered tool.\n\n---\n\n## Phase 0 — Install & auth\n\n```bash\n# Install once\nnpm install -g @dlazy/cli\n\n# Authenticate (device-code flow; works in remote shells)\ndlazy auth login\n```\n\nAlternate auth: `dlazy auth set YOUR_API_KEY`, or set the `DLAZY_API_KEY`\nenv var. Config lives at `~/.dlazy/config.json` (Windows:\n`%USERPROFILE%\\.dlazy\\`).\n\nGlobal flags every command accepts: `--api-key`, `--base-url`, `--verbose`,\n`--format <json|url|text>`, `--refresh-manifest`, `-l/--lang <locale>`.\n\n---\n\n## Phase 1 — Discover capabilities\n\n```bash\ndlazy --help                         # top-level command surface\ndlazy tools list                     # registered tools with type + cost shape\ndlazy tools describe <name>          # input/output JSON schema, hasCosts, examples\n```\n\nOptional local runtimes need a one-time install:\n\n```bash\ndlazy doctor remotion                # report Remotion composer state\ndlazy doctor remotion --install      # ~50s, installs the bundled composer\n\ndlazy doctor yt-dlp --install        # for video_downloader on YouTube et al.\ndlazy doctor yt-dlp --install --proxy http://127.0.0.1:1087\n```\n\nSome sandboxes restrict the tool surface via `DLAZY_DISABLED_TOOLS=<csv>`;\ndisabled tools are hidden from `dlazy --help` and refuse invocation with a\nclear `tool_disabled` error.\n\n---\n\n## Phase 2 — Invoke a tool\n\nEvery tool is a top-level subcommand:\n\n```bash\n# Inline flags (mirrors the input schema)\ndlazy gpt-image-2 --prompt \"cyberpunk cat at dusk\"\n\n# JSON input file (preferred for complex shapes)\ndlazy video_compose --input @work/compose.json --format json\n\n# Dry-run for validation only (no remote call, no credit consumption)\ndlazy seedance-2-0 --input @plan.json --dry-run\n```\n\nPer-tool help is generated from the schema:\n\n```bash\ndlazy <tool-name> --help\n```\n\nOutput modes:\n\n- `--format json` (default) — machine-readable envelope; parse with `jq`\n- `--format url` — bare URL when the tool produces a single asset\n- `--format text` — human-readable text payload\n- `--save <path>` — download the asset straight to disk (mkdir + retry handled for you)\n\n---\n\n## Phase 3 — Poll async cloud tasks\n\nLong-running generations return a `generateId` instead of the final asset:\n\n```bash\ndlazy status <generateId>\ndlazy status <generateId> --format json\n```\n\nRepeat until status is `succeeded` (then the asset URL is in the payload) or\n`failed` (with `error.code` + `error.message`).\n\n---\n\n## Phase 4 — Common failure recovery\n\n**`dlazy doctor remotion --install` fails on `npm install`:**\n- Check Node ≥ 18 (`node --version`).\n- Behind a corp proxy: set `npm_config_proxy` / `npm_config_https_proxy`.\n\n**`video_downloader` returns \"Sign in to confirm you're not a bot\":**\n- YouTube anti-bot challenge. Pass `\"cookies_from_browser\": \"chrome\"`\n  (or firefox / safari / edge) in the input JSON.\n\n**`video_compose` returns \"render_runtime=hyperframes not yet implemented\":**\n- HyperFrames runtime not shipped. Switch `edit_decisions.render_runtime` to\n  `remotion` or `ffmpeg`, then re-validate via `pre_render_validator`.\n\n**ElevenLabs STT returns an empty `words` array:**\n- Pass `timestamps_granularity: \"word\"` explicitly.\n\n**Need to know a tool's cost before invoking:**\n- `dlazy tools describe <name>` exposes `hasCosts` and the cost shape. Log\n  the estimate to a local file or your audit log before calling the tool.\n\n**Unknown command suggestion:**\n- `dlazy <typo>` returns `error: unknown command '<typo>'` plus a \"Did you\n  mean …?\" suggestion line based on edit distance. Trust the suggestion only\n  after confirming via `dlazy tools list`.\n\n---\n\n## Anti-patterns\n\n- Calling a tool whose existence you haven't verified via `dlazy tools list`.\n- Memorizing provider names from prior sessions instead of re-checking the\n  registry (tools come and go).\n- Silently swapping render runtime mid-pipeline (govern via `state_lock_profile`\n  + `post_render_gate` parity checks instead).\n- Calling paid generation without announcing provider / model / cost first.\n\n---\n\n## Reference card\n\n```\nINSTALL       npm install -g @dlazy/cli && dlazy auth login\nDISCOVER      dlazy tools list  |  dlazy tools describe <name>\nLOCAL RT      dlazy doctor remotion --install   (or yt-dlp)\nINVOKE        dlazy <tool-name> --input @file.json --format json\nDRY RUN       dlazy <tool-name> --input @file.json --dry-run\nPOLL          dlazy status <generateId>\nHELP          dlazy --help  |  dlazy <tool-name> --help\nRECOVER       dlazy doctor <target>  |  dlazy tools describe <name>\n```\n\nFile v2.0.26:_meta.json\n\n{\n  \"ownerId\": \"kn7c5wgeajfcfvdfb5ceemvdb984cjpd\",\n  \"slug\": \"dlazy-start\",\n  \"version\": \"2.0.26\",\n  \"publishedAt\": 1791077428313\n}\n\nFile v2.0.26:skill-card.md\n\n## Description:\n\nGuides AI agents through installing, authenticating, discovering, and using dLazy CLI tools, including asynchronous jobs and troubleshooting.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[dlazyai](https://clawhub.ai/user/dlazyai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and other AI-agent users use this quickstart to discover available dLazy CLI tools, authenticate, run local or cloud tasks, and recover from common errors.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The download troubleshooting instructions may access local browser session cookies.\n\nMitigation: Allow browser-cookie import only with the user's explicit, informed consent.\n\nRisk: Authentication keys and local configuration may expose credentials if logged or committed.\n\nMitigation: Keep DLAZY_API_KEY and ~/.dlazy/config.json out of logs and repositories.\n\nRisk: Installing an unreviewed CLI package may execute untrusted code.\n\nMitigation: Review before installing and use a trusted, pinned @dlazy/cli version where possible.\n\n## Reference(s):\n\n- [dLazy homepage](https://dlazy.com)\n- [dLazy CLI npm package](https://www.npmjs.com/package/@dlazy/cli)\n- [CLI repository listed in skill metadata](https://github.com/dlazy-ai/cli)\n- [ClawHub skill release](https://clawhub.ai/dlazyai/skills/dlazy-start)\n\n## Skill Output:\n\n**Output Type(s):** [Guidance, Shell commands, Configuration instructions]\n\n**Output Format:** [Markdown with shell commands and JSON examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Guidance covers tool discovery, authentication, asynchronous status checks, and troubleshooting.]\n\n## Skill Version(s):\n\n2.0.26 (source: ClawHub release; bundled guide states 2.0.6)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v2.0.26:SKILL-cn.md\n\n---\nname: dlazy-start\nversion: 2.0.6\ndescription: \"AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。\"\ntriggers:\n  - dLazy CLI 智能体上手手册\nmetadata: {\"clawdbot\":{\"emoji\":\"🎬\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli\",\"installAlternative\":\"npx @dlazy/cli\",\"homepage\":\"https://dlazy.com\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"AGPL-3.0-or-later\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"你正在为用户操作 @dlazy/cli。先探测:跑 `dlazy tools list` 看可用工具,`dlazy tools describe <名字>` 看单工具的 input/output schema 和成本。调用形态:`dlazy <工具名> --input @file.json`(或加 `--format json` 拿机读 envelope)。异步任务用 `dlazy status <generateId>` 轮询。需要本地 runtime 时跑 `dlazy doctor remotion --install` 或 `dlazy doctor yt-dlp --install`。在没用 `dlazy tools list` 核实之前,绝不声称某工具存在。\"}}\n---\n\n# 智能体上手手册 Start\n\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\n\n给 AI 编排器(Claude Code / Cursor / Codex / Copilot)用的最小契约。CLI 本质是一个工具分发壳:每个注册的云端/本地工具都会变成顶层 subcommand。CLI 不内置项目工作目录或 pipeline 状态机 —— 那些是上层 agent 的概念。\n\nLicense: AGPL-3.0-or-later。\n\n## 本 skill 教什么\n\n你从鉴权一路驱动 `@dlazy/cli` 到工具调用:\n\n- **云端工具**(40+) —— 图像 / 视频 / 音频 / 文本服务(Seedream / Recraft / MJ / Veo / Seedance / Kling / ElevenLabs / …)\n- **本地工具**(40+) —— `state_lock_profile`、`video_compose`、`post_render_gate`、`scene_detect`、`frame_sampler`、`audio_mixer`、`audio_probe`、`transcribe`、`subtitle`、`color_grade`、`extract_segment`、`ffmpeg_run`、…(完整列表跑 `dlazy tools list`)\n- **CLI 命令**: `auth`、`doctor`、`tools list`、`tools describe`、`status`,再加上每个注册工具对应的一个顶层 subcommand。\n\n---\n\n## Phase 0 — 安装与鉴权\n\n```bash\n# 一次性安装\nnpm install -g @dlazy/cli\n\n# 登录(设备码流程;远程终端也可用)\ndlazy auth login\n```\n\n备选鉴权:`dlazy auth set YOUR_API_KEY`,或设 `DLAZY_API_KEY` 环境变量。配置存在 `~/.dlazy/config.json`(Windows:`%USERPROFILE%\\.dlazy\\`)。\n\n所有命令都接受的全局 flag:`--api-key`、`--base-url`、`--verbose`、`--format <json|url|text>`、`--refresh-manifest`、`-l/--lang <locale>`。\n\n---\n\n## Phase 1 — 能力探测\n\n```bash\ndlazy --help                         # 顶层命令面\ndlazy tools list                     # 注册工具列表 + 类型 + 成本形态\ndlazy tools describe <名字>          # 单工具 input/output JSON schema + hasCosts + 示例\n```\n\n可选本地 runtime 需要一次性安装:\n\n```bash\ndlazy doctor remotion                # 报 Remotion composer 状态\ndlazy doctor remotion --install      # 约 50s,装 bundled composer\n\ndlazy doctor yt-dlp --install        # 用 video_downloader 拉 YouTube 等需要\ndlazy doctor yt-dlp --install --proxy http://127.0.0.1:1087\n```\n\n部分沙箱通过 `DLAZY_DISABLED_TOOLS=<逗号分隔>` 限制工具面;被禁用的工具不会出现在 `dlazy --help` 里,直接调会返回明确的 `tool_disabled` 错误。\n\n---\n\n## Phase 2 — 调用工具\n\n每个工具都是顶层 subcommand:\n\n```bash\n# 命令行 flag(对应 input schema)\ndlazy gpt-image-2 --prompt \"黄昏中的赛博朋克猫\"\n\n# JSON 输入文件(复杂结构推荐)\ndlazy video_compose --input @work/compose.json --format json\n\n# 干跑校验(不发远程调用,不扣额度)\ndlazy seedance-2-0 --input @plan.json --dry-run\n```\n\n每个工具的 help 是从 schema 生成的:\n\n```bash\ndlazy <工具名> --help\n```\n\n输出模式:\n\n- `--format json`(默认) —— 机读 envelope;用 `jq` 解析\n- `--format url` —— 单一素材产物时,直接给纯 URL\n- `--format text` —— 人读文本载荷\n- `--save <path>` —— 直接把素材下载到本地路径(自动 mkdir + 重试)\n\n---\n\n## Phase 3 — 轮询异步云任务\n\n长任务返回 `generateId` 而非素材:\n\n```bash\ndlazy status <generateId>\ndlazy status <generateId> --format json\n```\n\n反复轮询直到 `succeeded`(payload 里带素材 URL)或 `failed`(带 `error.code` + `error.message`)。\n\n---\n\n## Phase 4 — 常见失败恢复\n\n**`dlazy doctor remotion --install` 在 npm install 阶段失败:**\n- 检查 Node ≥ 18(`node --version`)。\n- 公司代理后面:设 `npm_config_proxy` / `npm_config_https_proxy`。\n\n**`video_downloader` 回复 \"Sign in to confirm you're not a bot\":**\n- YouTube 反爬挑战。input JSON 里加 `\"cookies_from_browser\": \"chrome\"`(或 firefox / safari / edge)。\n\n**`video_compose` 返回 \"render_runtime=hyperframes not yet implemented\":**\n- HyperFrames runtime 还没 ship。把 `edit_decisions.render_runtime` 切成 `remotion` 或 `ffmpeg`,再用 `pre_render_validator` 复检。\n\n**ElevenLabs STT 返回空 `words` 数组:**\n- 显式传 `timestamps_granularity: \"word\"`。\n\n**不知道工具成本就要调:**\n- `dlazy tools describe <名字>` 暴露 `hasCosts` 和成本形态。先把 estimate 写到本地审计日志,再调工具。\n\n**unknown command 提示:**\n- `dlazy <错字>` 返回 `error: unknown command '<typo>'` 加一条编辑距离推荐 \"Did you mean …?\"。先用 `dlazy tools list` 核实再信。\n\n---\n\n## 反模式\n\n- 没用 `dlazy tools list` 核实就调某工具。\n- 凭上次会话记忆写 provider 名,而不重新查注册表(工具会进出)。\n- pipeline 中途悄悄换 render runtime(用 `state_lock_profile` + `post_render_gate` parity 校验去管)。\n- 付费生成前不播报 provider / model / 成本。\n\n---\n\n## 速查卡\n\n```\n安装         npm install -g @dlazy/cli && dlazy auth login\n探测         dlazy tools list  |  dlazy tools describe <名字>\n本地 runtime  dlazy doctor remotion --install   (或 yt-dlp)\n调用         dlazy <工具名> --input @file.json --format json\n干跑         dlazy <工具名> --input @file.json --dry-run\n轮询         dlazy status <generateId>\n帮助         dlazy --help  |  dlazy <工具名> --help\n排障         dlazy doctor <目标>  |  dlazy tools describe <名字>\n```\n\nArchive v2.0.25: 4 files, 8326 bytes\n\nFiles: skill-card.md (2042b), SKILL-cn.md (6464b), SKILL.md (7014b), _meta.json (131b)\n\nFile v2.0.25:SKILL.md\n\n---\nname: dlazy-start\nversion: 2.0.6\ndescription: \"Quickstart for AI orchestrators (Claude Code / Cursor / Codex / Copilot) driving @dlazy/cli. Covers install, auth, capability discovery, invoking cloud + local tools, polling async tasks, and recovering from common failures. AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。\"\ntriggers:\n  - dLazy CLI Quickstart for AI Agents\nmetadata: {\"clawdbot\":{\"emoji\":\"🎬\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli\",\"installAlternative\":\"npx @dlazy/cli\",\"homepage\":\"https://dlazy.com\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"AGPL-3.0-or-later\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"You are operating @dlazy/cli for the user. Discovery first: run `dlazy tools list` to see available tools and `dlazy tools describe <name>` to inspect a tool's input/output schema and cost shape. Invoke with `dlazy <tool-name> --input @file.json` (or `--format json` for machine-readable envelopes). Poll long-running cloud tasks with `dlazy status <generateId>`. Install optional local runtimes with `dlazy doctor remotion --install` or `dlazy doctor yt-dlp --install`. Never claim a tool exists without verifying via `dlazy tools list`.\"}}\n---\n\n# 智能体上手手册 Start\n\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\n\nA minimal contract for AI orchestrators using `@dlazy/cli`. The CLI is a\ntool-dispatch surface: every registered cloud + local tool becomes a top-level\nsubcommand. There is no built-in project workspace or pipeline state machine —\nthose are agent-side concepts.\n\nLicense: AGPL-3.0-or-later.\n\n## What this skill teaches\n\nYou drive `@dlazy/cli` from auth through tool invocation:\n\n- **Cloud tools** (40+) — image / video / audio / text providers (Seedream,\n  Recraft, MJ, Veo, Seedance, Kling, ElevenLabs, …)\n- **Local tools** (40+) — `state_lock_profile`, `video_compose`,\n  `post_render_gate`, `scene_detect`, `frame_sampler`, `audio_mixer`,\n  `audio_probe`, `transcribe`, `subtitle`, `color_grade`, `extract_segment`,\n  `ffmpeg_run`, … (full list via `dlazy tools list`)\n- **CLI commands**: `auth`, `doctor`, `tools list`, `tools describe`,\n  `status`, plus one top-level subcommand per registered tool.\n\n---\n\n## Phase 0 — Install & auth\n\n```bash\n# Install once\nnpm install -g @dlazy/cli\n\n# Authenticate (device-code flow; works in remote shells)\ndlazy auth login\n```\n\nAlternate auth: `dlazy auth set YOUR_API_KEY`, or set the `DLAZY_API_KEY`\nenv var. Config lives at `~/.dlazy/config.json` (Windows:\n`%USERPROFILE%\\.dlazy\\`).\n\nGlobal flags every command accepts: `--api-key`, `--base-url`, `--verbose`,\n`--format <json|url|text>`, `--refresh-manifest`, `-l/--lang <locale>`.\n\n---\n\n## Phase 1 — Discover capabilities\n\n```bash\ndlazy --help                         # top-level command surface\ndlazy tools list                     # registered tools with type + cost shape\ndlazy tools describe <name>          # input/output JSON schema, hasCosts, examples\n```\n\nOptional local runtimes need a one-time install:\n\n```bash\ndlazy doctor remotion                # report Remotion composer state\ndlazy doctor remotion --install      # ~50s, installs the bundled composer\n\ndlazy doctor yt-dlp --install        # for video_downloader on YouTube et al.\ndlazy doctor yt-dlp --install --proxy http://127.0.0.1:1087\n```\n\nSome sandboxes restrict the tool surface via `DLAZY_DISABLED_TOOLS=<csv>`;\ndisabled tools are hidden from `dlazy --help` and refuse invocation with a\nclear `tool_disabled` error.\n\n---\n\n## Phase 2 — Invoke a tool\n\nEvery tool is a top-level subcommand:\n\n```bash\n# Inline flags (mirrors the input schema)\ndlazy gpt-image-2 --prompt \"cyberpunk cat at dusk\"\n\n# JSON input file (preferred for complex shapes)\ndlazy video_compose --input @work/compose.json --format json\n\n# Dry-run for validation only (no remote call, no credit consumption)\ndlazy seedance-2-0 --input @plan.json --dry-run\n```\n\nPer-tool help is generated from the schema:\n\n```bash\ndlazy <tool-name> --help\n```\n\nOutput modes:\n\n- `--format json` (default) — machine-readable envelope; parse with `jq`\n- `--format url` — bare URL when the tool produces a single asset\n- `--format text` — human-readable text payload\n- `--save <path>` — download the asset straight to disk (mkdir + retry handled for you)\n\n---\n\n## Phase 3 — Poll async cloud tasks\n\nLong-running generations return a `generateId` instead of the final asset:\n\n```bash\ndlazy status <generateId>\ndlazy status <generateId> --format json\n```\n\nRepeat until status is `succeeded` (then the asset URL is in the payload) or\n`failed` (with `error.code` + `error.message`).\n\n---\n\n## Phase 4 — Common failure recovery\n\n**`dlazy doctor remotion --install` fails on `npm install`:**\n- Check Node ≥ 18 (`node --version`).\n- Behind a corp proxy: set `npm_config_proxy` / `npm_config_https_proxy`.\n\n**`video_downloader` returns \"Sign in to confirm you're not a bot\":**\n- YouTube anti-bot challenge. Pass `\"cookies_from_browser\": \"chrome\"`\n  (or firefox / safari / edge) in the input JSON.\n\n**`video_compose` returns \"render_runtime=hyperframes not yet implemented\":**\n- HyperFrames runtime not shipped. Switch `edit_decisions.render_runtime` to\n  `remotion` or `ffmpeg`, then re-validate via `pre_render_validator`.\n\n**ElevenLabs STT returns an empty `words` array:**\n- Pass `timestamps_granularity: \"word\"` explicitly.\n\n**Need to know a tool's cost before invoking:**\n- `dlazy tools describe <name>` exposes `hasCosts` and the cost shape. Log\n  the estimate to a local file or your audit log before calling the tool.\n\n**Unknown command suggestion:**\n- `dlazy <typo>` returns `error: unknown command '<typo>'` plus a \"Did you\n  mean …?\" suggestion line based on edit distance. Trust the suggestion only\n  after confirming via `dlazy tools list`.\n\n---\n\n## Anti-patterns\n\n- Calling a tool whose existence you haven't verified via `dlazy tools list`.\n- Memorizing provider names from prior sessions instead of re-checking the\n  registry (tools come and go).\n- Silently swapping render runtime mid-pipeline (govern via `state_lock_profile`\n  + `post_render_gate` parity checks instead).\n- Calling paid generation without announcing provider / model / cost first.\n\n---\n\n## Reference card\n\n```\nINSTALL       npm install -g @dlazy/cli && dlazy auth login\nDISCOVER      dlazy tools list  |  dlazy tools describe <name>\nLOCAL RT      dlazy doctor remotion --install   (or yt-dlp)\nINVOKE        dlazy <tool-name> --input @file.json --format json\nDRY RUN       dlazy <tool-name> --input @file.json --dry-run\nPOLL          dlazy status <generateId>\nHELP          dlazy --help  |  dlazy <tool-name> --help\nRECOVER       dlazy doctor <target>  |  dlazy tools describe <name>\n```\n\nFile v2.0.25:_meta.json\n\n{\n  \"ownerId\": \"kn7c5wgeajfcfvdfb5ceemvdb984cjpd\",\n  \"slug\": \"dlazy-start\",\n  \"version\": \"2.0.25\",\n  \"publishedAt\": 1790917675986\n}\n\nFile v2.0.25:skill-card.md\n\n## Description:\n\nA quickstart for AI agents using the dLazy CLI to install and authenticate, discover and invoke media tools, poll tasks, and troubleshoot failures.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[dlazyai](https://clawhub.ai/user/dlazyai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and AI-agent users use this guide to set up the dLazy CLI, discover available tools and costs, run cloud or local media tasks, and handle asynchronous results and common errors.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Using browser-stored cookies for video downloads may expose sensitive session data.\n\nMitigation: Require explicit approval of the browser, profile, and site before using cookies_from_browser; prefer standard authentication or limited-scope exported cookies.\n\nRisk: Installing and running the CLI can invoke networked media tools and store authentication in local configuration.\n\nMitigation: Install only if you trust the dLazy CLI, protect its authentication configuration, and pin the npm package version when reproducibility matters.\n\n## Reference(s):\n\n- [ClawHub skill listing](https://clawhub.ai/dlazyai/skills/dlazy-start)\n- [dLazy homepage](https://dlazy.com)\n- [dLazy CLI npm package](https://www.npmjs.com/package/@dlazy/cli)\n- [dLazy CLI source (declared CLI reference)](https://github.com/dlazy-ai/cli)\n\n## Skill Output:\n\n**Output Type(s):** [Guidance, Shell commands, Configuration instructions]\n\n**Output Format:** [Markdown with CLI examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Includes JSON input examples and task-polling guidance.]\n\n## Skill Version(s):\n\n2.0.25 (source: ClawHub release; bundled frontmatter states 2.0.6)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v2.0.25:SKILL-cn.md\n\n---\nname: dlazy-start\nversion: 2.0.6\ndescription: \"AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。\"\ntriggers:\n  - dLazy CLI 智能体上手手册\nmetadata: {\"clawdbot\":{\"emoji\":\"🎬\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli\",\"installAlternative\":\"npx @dlazy/cli\",\"homepage\":\"https://dlazy.com\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"AGPL-3.0-or-later\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"你正在为用户操作 @dlazy/cli。先探测:跑 `dlazy tools list` 看可用工具,`dlazy tools describe <名字>` 看单工具的 input/output schema 和成本。调用形态:`dlazy <工具名> --input @file.json`(或加 `--format json` 拿机读 envelope)。异步任务用 `dlazy status <generateId>` 轮询。需要本地 runtime 时跑 `dlazy doctor remotion --install` 或 `dlazy doctor yt-dlp --install`。在没用 `dlazy tools list` 核实之前,绝不声称某工具存在。\"}}\n---\n\n# 智能体上手手册 Start\n\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\n\n给 AI 编排器(Claude Code / Cursor / Codex / Copilot)用的最小契约。CLI 本质是一个工具分发壳:每个注册的云端/本地工具都会变成顶层 subcommand。CLI 不内置项目工作目录或 pipeline 状态机 —— 那些是上层 agent 的概念。\n\nLicense: AGPL-3.0-or-later。\n\n## 本 skill 教什么\n\n你从鉴权一路驱动 `@dlazy/cli` 到工具调用:\n\n- **云端工具**(40+) —— 图像 / 视频 / 音频 / 文本服务(Seedream / Recraft / MJ / Veo / Seedance / Kling / ElevenLabs / …)\n- **本地工具**(40+) —— `state_lock_profile`、`video_compose`、`post_render_gate`、`scene_detect`、`frame_sampler`、`audio_mixer`、`audio_probe`、`transcribe`、`subtitle`、`color_grade`、`extract_segment`、`ffmpeg_run`、…(完整列表跑 `dlazy tools list`)\n- **CLI 命令**: `auth`、`doctor`、`tools list`、`tools describe`、`status`,再加上每个注册工具对应的一个顶层 subcommand。\n\n---\n\n## Phase 0 — 安装与鉴权\n\n```bash\n# 一次性安装\nnpm install -g @dlazy/cli\n\n# 登录(设备码流程;远程终端也可用)\ndlazy auth login\n```\n\n备选鉴权:`dlazy auth set YOUR_API_KEY`,或设 `DLAZY_API_KEY` 环境变量。配置存在 `~/.dlazy/config.json`(Windows:`%USERPROFILE%\\.dlazy\\`)。\n\n所有命令都接受的全局 flag:`--api-key`、`--base-url`、`--verbose`、`--format <json|url|text>`、`--refresh-manifest`、`-l/--lang <locale>`。\n\n---\n\n## Phase 1 — 能力探测\n\n```bash\ndlazy --help                         # 顶层命令面\ndlazy tools list                     # 注册工具列表 + 类型 + 成本形态\ndlazy tools describe <名字>          # 单工具 input/output JSON schema + hasCosts + 示例\n```\n\n可选本地 runtime 需要一次性安装:\n\n```bash\ndlazy doctor remotion                # 报 Remotion composer 状态\ndlazy doctor remotion --install      # 约 50s,装 bundled composer\n\ndlazy doctor yt-dlp --install        # 用 video_downloader 拉 YouTube 等需要\ndlazy doctor yt-dlp --install --proxy http://127.0.0.1:1087\n```\n\n部分沙箱通过 `DLAZY_DISABLED_TOOLS=<逗号分隔>` 限制工具面;被禁用的工具不会出现在 `dlazy --help` 里,直接调会返回明确的 `tool_disabled` 错误。\n\n---\n\n## Phase 2 — 调用工具\n\n每个工具都是顶层 subcommand:\n\n```bash\n# 命令行 flag(对应 input schema)\ndlazy gpt-image-2 --prompt \"黄昏中的赛博朋克猫\"\n\n# JSON 输入文件(复杂结构推荐)\ndlazy video_compose --input @work/compose.json --format json\n\n# 干跑校验(不发远程调用,不扣额度)\ndlazy seedance-2-0 --input @plan.json --dry-run\n```\n\n每个工具的 help 是从 schema 生成的:\n\n```bash\ndlazy <工具名> --help\n```\n\n输出模式:\n\n- `--format json`(默认) —— 机读 envelope;用 `jq` 解析\n- `--format url` —— 单一素材产物时,直接给纯 URL\n- `--format text` —— 人读文本载荷\n- `--save <path>` —— 直接把素材下载到本地路径(自动 mkdir + 重试)\n\n---\n\n## Phase 3 — 轮询异步云任务\n\n长任务返回 `generateId` 而非素材:\n\n```bash\ndlazy status <generateId>\ndlazy status <generateId> --format json\n```\n\n反复轮询直到 `succeeded`(payload 里带素材 URL)或 `failed`(带 `error.code` + `error.message`)。\n\n---\n\n## Phase 4 — 常见失败恢复\n\n**`dlazy doctor remotion --install` 在 npm install 阶段失败:**\n- 检查 Node ≥ 18(`node --version`)。\n- 公司代理后面:设 `npm_config_proxy` / `npm_config_https_proxy`。\n\n**`video_downloader` 回复 \"Sign in to confirm you're not a bot\":**\n- YouTube 反爬挑战。input JSON 里加 `\"cookies_from_browser\": \"chrome\"`(或 firefox / safari / edge)。\n\n**`video_compose` 返回 \"render_runtime=hyperframes not yet implemented\":**\n- HyperFrames runtime 还没 ship。把 `edit_decisions.render_runtime` 切成 `remotion` 或 `ffmpeg`,再用 `pre_render_validator` 复检。\n\n**ElevenLabs STT 返回空 `words` 数组:**\n- 显式传 `timestamps_granularity: \"word\"`。\n\n**不知道工具成本就要调:**\n- `dlazy tools describe <名字>` 暴露 `hasCosts` 和成本形态。先把 estimate 写到本地审计日志,再调工具。\n\n**unknown command 提示:**\n- `dlazy <错字>` 返回 `error: unknown command '<typo>'` 加一条编辑距离推荐 \"Did you mean …?\"。先用 `dlazy tools list` 核实再信。\n\n---\n\n## 反模式\n\n- 没用 `dlazy tools list` 核实就调某工具。\n- 凭上次会话记忆写 provider 名,而不重新查注册表(工具会进出)。\n- pipeline 中途悄悄换 render runtime(用 `state_lock_profile` + `post_render_gate` parity 校验去管)。\n- 付费生成前不播报 provider / model / 成本。\n\n---\n\n## 速查卡\n\n```\n安装         npm install -g @dlazy/cli && dlazy auth login\n探测         dlazy tools list  |  dlazy tools describe <名字>\n本地 runtime  dlazy doctor remotion --install   (或 yt-dlp)\n调用         dlazy <工具名> --input @file.json --format json\n干跑         dlazy <工具名> --input @file.json --dry-run\n轮询         dlazy status <generateId>\n帮助         dlazy --help  |  dlazy <工具名> --help\n排障         dlazy doctor <目标>  |  dlazy tools describe <名字>\n```\n\nArchive v2.0.24: 4 files, 8400 bytes\n\nFiles: skill-card.md (2175b), SKILL-cn.md (6464b), SKILL.md (7014b), _meta.json (131b)\n\nFile v2.0.24:SKILL.md\n\n---\nname: dlazy-start\nversion: 2.0.6\ndescription: \"Quickstart for AI orchestrators (Claude Code / Cursor / Codex / Copilot) driving @dlazy/cli. Covers install, auth, capability discovery, invoking cloud + local tools, polling async tasks, and recovering from common failures. AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。\"\ntriggers:\n  - dLazy CLI Quickstart for AI Agents\nmetadata: {\"clawdbot\":{\"emoji\":\"🎬\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli\",\"installAlternative\":\"npx @dlazy/cli\",\"homepage\":\"https://dlazy.com\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"AGPL-3.0-or-later\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"You are operating @dlazy/cli for the user. Discovery first: run `dlazy tools list` to see available tools and `dlazy tools describe <name>` to inspect a tool's input/output schema and cost shape. Invoke with `dlazy <tool-name> --input @file.json` (or `--format json` for machine-readable envelopes). Poll long-running cloud tasks with `dlazy status <generateId>`. Install optional local runtimes with `dlazy doctor remotion --install` or `dlazy doctor yt-dlp --install`. Never claim a tool exists without verifying via `dlazy tools list`.\"}}\n---\n\n# 智能体上手手册 Start\n\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\n\nA minimal contract for AI orchestrators using `@dlazy/cli`. The CLI is a\ntool-dispatch surface: every registered cloud + local tool becomes a top-level\nsubcommand. There is no built-in project workspace or pipeline state machine —\nthose are agent-side concepts.\n\nLicense: AGPL-3.0-or-later.\n\n## What this skill teaches\n\nYou drive `@dlazy/cli` from auth through tool invocation:\n\n- **Cloud tools** (40+) — image / video / audio / text providers (Seedream,\n  Recraft, MJ, Veo, Seedance, Kling, ElevenLabs, …)\n- **Local tools** (40+) — `state_lock_profile`, `video_compose`,\n  `post_render_gate`, `scene_detect`, `frame_sampler`, `audio_mixer`,\n  `audio_probe`, `transcribe`, `subtitle`, `color_grade`, `extract_segment`,\n  `ffmpeg_run`, … (full list via `dlazy tools list`)\n- **CLI commands**: `auth`, `doctor`, `tools list`, `tools describe`,\n  `status`, plus one top-level subcommand per registered tool.\n\n---\n\n## Phase 0 — Install & auth\n\n```bash\n# Install once\nnpm install -g @dlazy/cli\n\n# Authenticate (device-code flow; works in remote shells)\ndlazy auth login\n```\n\nAlternate auth: `dlazy auth set YOUR_API_KEY`, or set the `DLAZY_API_KEY`\nenv var. Config lives at `~/.dlazy/config.json` (Windows:\n`%USERPROFILE%\\.dlazy\\`).\n\nGlobal flags every command accepts: `--api-key`, `--base-url`, `--verbose`,\n`--format <json|url|text>`, `--refresh-manifest`, `-l/--lang <locale>`.\n\n---\n\n## Phase 1 — Discover capabilities\n\n```bash\ndlazy --help                         # top-level command surface\ndlazy tools list                     # registered tools with type + cost shape\ndlazy tools describe <name>          # input/output JSON schema, hasCosts, examples\n```\n\nOptional local runtimes need a one-time install:\n\n```bash\ndlazy doctor remotion                # report Remotion composer state\ndlazy doctor remotion --install      # ~50s, installs the bundled composer\n\ndlazy doctor yt-dlp --install        # for video_downloader on YouTube et al.\ndlazy doctor yt-dlp --install --proxy http://127.0.0.1:1087\n```\n\nSome sandboxes restrict the tool surface via `DLAZY_DISABLED_TOOLS=<csv>`;\ndisabled tools are hidden from `dlazy --help` and refuse invocation with a\nclear `tool_disabled` error.\n\n---\n\n## Phase 2 — Invoke a tool\n\nEvery tool is a top-level subcommand:\n\n```bash\n# Inline flags (mirrors the input schema)\ndlazy gpt-image-2 --prompt \"cyberpunk cat at dusk\"\n\n# JSON input file (preferred for complex shapes)\ndlazy video_compose --input @work/compose.json --format json\n\n# Dry-run for validation only (no remote call, no credit consumption)\ndlazy seedance-2-0 --input @plan.json --dry-run\n```\n\nPer-tool help is generated from the schema:\n\n```bash\ndlazy <tool-name> --help\n```\n\nOutput modes:\n\n- `--format json` (default) — machine-readable envelope; parse with `jq`\n- `--format url` — bare URL when the tool produces a single asset\n- `--format text` — human-readable text payload\n- `--save <path>` — download the asset straight to disk (mkdir + retry handled for you)\n\n---\n\n## Phase 3 — Poll async cloud tasks\n\nLong-running generations return a `generateId` instead of the final asset:\n\n```bash\ndlazy status <generateId>\ndlazy status <generateId> --format json\n```\n\nRepeat until status is `succeeded` (then the asset URL is in the payload) or\n`failed` (with `error.code` + `error.message`).\n\n---\n\n## Phase 4 — Common failure recovery\n\n**`dlazy doctor remotion --install` fails on `npm install`:**\n- Check Node ≥ 18 (`node --version`).\n- Behind a corp proxy: set `npm_config_proxy` / `npm_config_https_proxy`.\n\n**`video_downloader` returns \"Sign in to confirm you're not a bot\":**\n- YouTube anti-bot challenge. Pass `\"cookies_from_browser\": \"chrome\"`\n  (or firefox / safari / edge) in the input JSON.\n\n**`video_compose` returns \"render_runtime=hyperframes not yet implemented\":**\n- HyperFrames runtime not shipped. Switch `edit_decisions.render_runtime` to\n  `remotion` or `ffmpeg`, then re-validate via `pre_render_validator`.\n\n**ElevenLabs STT returns an empty `words` array:**\n- Pass `timestamps_granularity: \"word\"` explicitly.\n\n**Need to know a tool's cost before invoking:**\n- `dlazy tools describe <name>` exposes `hasCosts` and the cost shape. Log\n  the estimate to a local file or your audit log before calling the tool.\n\n**Unknown command suggestion:**\n- `dlazy <typo>` returns `error: unknown command '<typo>'` plus a \"Did you\n  mean …?\" suggestion line based on edit distance. Trust the suggestion only\n  after confirming via `dlazy tools list`.\n\n---\n\n## Anti-patterns\n\n- Calling a tool whose existence you haven't verified via `dlazy tools list`.\n- Memorizing provider names from prior sessions instead of re-checking the\n  registry (tools come and go).\n- Silently swapping render runtime mid-pipeline (govern via `state_lock_profile`\n  + `post_render_gate` parity checks instead).\n- Calling paid generation without announcing provider / model / cost first.\n\n---\n\n## Reference card\n\n```\nINSTALL       npm install -g @dlazy/cli && dlazy auth login\nDISCOVER      dlazy tools list  |  dlazy tools describe <name>\nLOCAL RT      dlazy doctor remotion --install   (or yt-dlp)\nINVOKE        dlazy <tool-name> --input @file.json --format json\nDRY RUN       dlazy <tool-name> --input @file.json --dry-run\nPOLL          dlazy status <generateId>\nHELP          dlazy --help  |  dlazy <tool-name> --help\nRECOVER       dlazy doctor <target>  |  dlazy tools describe <name>\n```\n\nFile v2.0.24:_meta.json\n\n{\n  \"ownerId\": \"kn7c5wgeajfcfvdfb5ceemvdb984cjpd\",\n  \"slug\": \"dlazy-start\",\n  \"version\": \"2.0.24\",\n  \"publishedAt\": 1790731792457\n}\n\nFile v2.0.24:skill-card.md\n\n## Description:\n\nA quickstart for AI agents using the dLazy CLI to install and authenticate, discover tools, invoke local and cloud capabilities, monitor long-running tasks, and troubleshoot failures.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[dlazyai](https://clawhub.ai/user/dlazyai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and AI-agent operators use this skill to set up dLazy CLI, discover available tools and their costs, run local or cloud tasks, and handle asynchronous results and common errors.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Browser-cookie reuse for video downloads can expose sensitive logged-in sessions.\n\nMitigation: Do not enable cookies_from_browser without explicit user consent; prefer device login or narrowly scoped credentials.\n\nRisk: Stored authentication credentials may be exposed if the local configuration is mishandled.\n\nMitigation: Protect ~/.dlazy/config.json and avoid sharing API keys.\n\nRisk: Cloud generation may incur charges or vary with installed CLI versions.\n\nMitigation: Confirm tool costs before generation and pin the npm package version for repeatable installs.\n\n## Reference(s):\n\n- [ClawHub skill listing](https://clawhub.ai/dlazyai/skills/dlazy-start)\n- [dLazy homepage](https://dlazy.com)\n- [dLazy CLI npm package](https://www.npmjs.com/package/@dlazy/cli)\n- [dLazy CLI source link in skill metadata](https://github.com/dlazy-ai/cli)\n\n## Skill Output:\n\n**Output Type(s):** [Guidance, Shell commands, Configuration instructions]\n\n**Output Format:** [Markdown with shell commands and JSON input examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Includes tool-discovery, invocation, status-polling, and troubleshooting guidance.]\n\n## Skill Version(s):\n\n2.0.24 (source: server-resolved release; included skill frontmatter states 2.0.6)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v2.0.24:SKILL-cn.md\n\n---\nname: dlazy-start\nversion: 2.0.6\ndescription: \"AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。\"\ntriggers:\n  - dLazy CLI 智能体上手手册\nmetadata: {\"clawdbot\":{\"emoji\":\"🎬\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli\",\"installAlternative\":\"npx @dlazy/cli\",\"homepage\":\"https://dlazy.com\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"AGPL-3.0-or-later\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"你正在为用户操作 @dlazy/cli。先探测:跑 `dlazy tools list` 看可用工具,`dlazy tools describe <名字>` 看单工具的 input/output schema 和成本。调用形态:`dlazy <工具名> --input @file.json`(或加 `--format json` 拿机读 envelope)。异步任务用 `dlazy status <generateId>` 轮询。需要本地 runtime 时跑 `dlazy doctor remotion --install` 或 `dlazy doctor yt-dlp --install`。在没用 `dlazy tools list` 核实之前,绝不声称某工具存在。\"}}\n---\n\n# 智能体上手手册 Start\n\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\n\n给 AI 编排器(Claude Code / Cursor / Codex / Copilot)用的最小契约。CLI 本质是一个工具分发壳:每个注册的云端/本地工具都会变成顶层 subcommand。CLI 不内置项目工作目录或 pipeline 状态机 —— 那些是上层 agent 的概念。\n\nLicense: AGPL-3.0-or-later。\n\n## 本 skill 教什么\n\n你从鉴权一路驱动 `@dlazy/cli` 到工具调用:\n\n- **云端工具**(40+) —— 图像 / 视频 / 音频 / 文本服务(Seedream / Recraft / MJ / Veo / Seedance / Kling / ElevenLabs / …)\n- **本地工具**(40+) —— `state_lock_profile`、`video_compose`、`post_render_gate`、`scene_detect`、`frame_sampler`、`audio_mixer`、`audio_probe`、`transcribe`、`subtitle`、`color_grade`、`extract_segment`、`ffmpeg_run`、…(完整列表跑 `dlazy tools list`)\n- **CLI 命令**: `auth`、`doctor`、`tools list`、`tools describe`、`status`,再加上每个注册工具对应的一个顶层 subcommand。\n\n---\n\n## Phase 0 — 安装与鉴权\n\n```bash\n# 一次性安装\nnpm install -g @dlazy/cli\n\n# 登录(设备码流程;远程终端也可用)\ndlazy auth login\n```\n\n备选鉴权:`dlazy auth set YOUR_API_KEY`,或设 `DLAZY_API_KEY` 环境变量。配置存在 `~/.dlazy/config.json`(Windows:`%USERPROFILE%\\.dlazy\\`)。\n\n所有命令都接受的全局 flag:`--api-key`、`--base-url`、`--verbose`、`--format <json|url|text>`、`--refresh-manifest`、`-l/--lang <locale>`。\n\n---\n\n## Phase 1 — 能力探测\n\n```bash\ndlazy --help                         # 顶层命令面\ndlazy tools list                     # 注册工具列表 + 类型 + 成本形态\ndlazy tools describe <名字>          # 单工具 input/output JSON schema + hasCosts + 示例\n```\n\n可选本地 runtime 需要一次性安装:\n\n```bash\ndlazy doctor remotion                # 报 Remotion composer 状态\ndlazy doctor remotion --install      # 约 50s,装 bundled composer\n\ndlazy doctor yt-dlp --install        # 用 video_downloader 拉 YouTube 等需要\ndlazy doctor yt-dlp --install --proxy http://127.0.0.1:1087\n```\n\n部分沙箱通过 `DLAZY_DISABLED_TOOLS=<逗号分隔>` 限制工具面;被禁用的工具不会出现在 `dlazy --help` 里,直接调会返回明确的 `tool_disabled` 错误。\n\n---\n\n## Phase 2 — 调用工具\n\n每个工具都是顶层 subcommand:\n\n```bash\n# 命令行 flag(对应 input schema)\ndlazy gpt-image-2 --prompt \"黄昏中的赛博朋克猫\"\n\n# JSON 输入文件(复杂结构推荐)\ndlazy video_compose --input @work/compose.json --format json\n\n# 干跑校验(不发远程调用,不扣额度)\ndlazy seedance-2-0 --input @plan.json --dry-run\n```\n\n每个工具的 help 是从 schema 生成的:\n\n```bash\ndlazy <工具名> --help\n```\n\n输出模式:\n\n- `--format json`(默认) —— 机读 envelope;用 `jq` 解析\n- `--format url` —— 单一素材产物时,直接给纯 URL\n- `--format text` —— 人读文本载荷\n- `--save <path>` —— 直接把素材下载到本地路径(自动 mkdir + 重试)\n\n---\n\n## Phase 3 — 轮询异步云任务\n\n长任务返回 `generateId` 而非素材:\n\n```bash\ndlazy status <generateId>\ndlazy status <generateId> --format json\n```\n\n反复轮询直到 `succeeded`(payload 里带素材 URL)或 `failed`(带 `error.code` + `error.message`)。\n\n---\n\n## Phase 4 — 常见失败恢复\n\n**`dlazy doctor remotion --install` 在 npm install 阶段失败:**\n- 检查 Node ≥ 18(`node --version`)。\n- 公司代理后面:设 `npm_config_proxy` / `npm_config_https_proxy`。\n\n**`video_downloader` 回复 \"Sign in to confirm you're not a bot\":**\n- YouTube 反爬挑战。input JSON 里加 `\"cookies_from_browser\": \"chrome\"`(或 firefox / safari / edge)。\n\n**`video_compose` 返回 \"render_runtime=hyperframes not yet implemented\":**\n- HyperFrames runtime 还没 ship。把 `edit_decisions.render_runtime` 切成 `remotion` 或 `ffmpeg`,再用 `pre_render_validator` 复检。\n\n**ElevenLabs STT 返回空 `words` 数组:**\n- 显式传 `timestamps_granularity: \"word\"`。\n\n**不知道工具成本就要调:**\n- `dlazy tools describe <名字>` 暴露 `hasCosts` 和成本形态。先把 estimate 写到本地审计日志,再调工具。\n\n**unknown command 提示:**\n- `dlazy <错字>` 返回 `error: unknown command '<typo>'` 加一条编辑距离推荐 \"Did you mean …?\"。先用 `dlazy tools list` 核实再信。\n\n---\n\n## 反模式\n\n- 没用 `dlazy tools list` 核实就调某工具。\n- 凭上次会话记忆写 provider 名,而不重新查注册表(工具会进出)。\n- pipeline 中途悄悄换 render runtime(用 `state_lock_profile` + `post_render_gate` parity 校验去管)。\n- 付费生成前不播报 provider / model / 成本。\n\n---\n\n## 速查卡\n\n```\n安装         npm install -g @dlazy/cli && dlazy auth login\n探测         dlazy tools list  |  dlazy tools describe <名字>\n本地 runtime  dlazy doctor remotion --install   (或 yt-dlp)\n调用         dlazy <工具名> --input @file.json --format json\n干跑         dlazy <工具名> --input @file.json --dry-run\n轮询         dlazy status <generateId>\n帮助         dlazy --help  |  dlazy <工具名> --help\n排障         dlazy doctor <目标>  |  dlazy tools describe <名字>\n```\n\nArchive v2.0.23: 4 files, 8303 bytes\n\nFiles: skill-card.md (1976b), SKILL-cn.md (6464b), SKILL.md (7014b), _meta.json (131b)\n\nFile v2.0.23:SKILL.md\n\n---\nname: dlazy-start\nversion: 2.0.6\ndescription: \"Quickstart for AI orchestrators (Claude Code / Cursor / Codex / Copilot) driving @dlazy/cli. Covers install, auth, capability discovery, invoking cloud + local tools, polling async tasks, and recovering from common failures. AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。\"\ntriggers:\n  - dLazy CLI Quickstart for AI Agents\nmetadata: {\"clawdbot\":{\"emoji\":\"🎬\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli\",\"installAlternative\":\"npx @dlazy/cli\",\"homepage\":\"https://dlazy.com\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"AGPL-3.0-or-later\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"You are operating @dlazy/cli for the user. Discovery first: run `dlazy tools list` to see available tools and `dlazy tools describe <name>` to inspect a tool's input/output schema and cost shape. Invoke with `dlazy <tool-name> --input @file.json` (or `--format json` for machine-readable envelopes). Poll long-running cloud tasks with `dlazy status <generateId>`. Install optional local runtimes with `dlazy doctor remotion --install` or `dlazy doctor yt-dlp --install`. Never claim a tool exists without verifying via `dlazy tools list`.\"}}\n---\n\n# 智能体上手手册 Start\n\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\n\nA minimal contract for AI orchestrators using `@dlazy/cli`. The CLI is a\ntool-dispatch surface: every registered cloud + local tool becomes a top-level\nsubcommand. There is no built-in project workspace or pipeline state machine —\nthose are agent-side concepts.\n\nLicense: AGPL-3.0-or-later.\n\n## What this skill teaches\n\nYou drive `@dlazy/cli` from auth through tool invocation:\n\n- **Cloud tools** (40+) — image / video / audio / text providers (Seedream,\n  Recraft, MJ, Veo, Seedance, Kling, ElevenLabs, …)\n- **Local tools** (40+) — `state_lock_profile`, `video_compose`,\n  `post_render_gate`, `scene_detect`, `frame_sampler`, `audio_mixer`,\n  `audio_probe`, `transcribe`, `subtitle`, `color_grade`, `extract_segment`,\n  `ffmpeg_run`, … (full list via `dlazy tools list`)\n- **CLI commands**: `auth`, `doctor`, `tools list`, `tools describe`,\n  `status`, plus one top-level subcommand per registered tool.\n\n---\n\n## Phase 0 — Install & auth\n\n```bash\n# Install once\nnpm install -g @dlazy/cli\n\n# Authenticate (device-code flow; works in remote shells)\ndlazy auth login\n```\n\nAlternate auth: `dlazy auth set YOUR_API_KEY`, or set the `DLAZY_API_KEY`\nenv var. Config lives at `~/.dlazy/config.json` (Windows:\n`%USERPROFILE%\\.dlazy\\`).\n\nGlobal flags every command accepts: `--api-key`, `--base-url`, `--verbose`,\n`--format <json|url|text>`, `--refresh-manifest`, `-l/--lang <locale>`.\n\n---\n\n## Phase 1 — Discover capabilities\n\n```bash\ndlazy --help                         # top-level command surface\ndlazy tools list                     # registered tools with type + cost shape\ndlazy tools describe <name>          # input/output JSON schema, hasCosts, examples\n```\n\nOptional local runtimes need a one-time install:\n\n```bash\ndlazy doctor remotion                # report Remotion composer state\ndlazy doctor remotion --install      # ~50s, installs the bundled composer\n\ndlazy doctor yt-dlp --install        # for video_downloader on YouTube et al.\ndlazy doctor yt-dlp --install --proxy http://127.0.0.1:1087\n```\n\nSome sandboxes restrict the tool surface via `DLAZY_DISABLED_TOOLS=<csv>`;\ndisabled tools are hidden from `dlazy --help` and refuse invocation with a\nclear `tool_disabled` error.\n\n---\n\n## Phase 2 — Invoke a tool\n\nEvery tool is a top-level subcommand:\n\n```bash\n# Inline flags (mirrors the input schema)\ndlazy gpt-image-2 --prompt \"cyberpunk cat at dusk\"\n\n# JSON input file (preferred for complex shapes)\ndlazy video_compose --input @work/compose.json --format json\n\n# Dry-run for validation only (no remote call, no credit consumption)\ndlazy seedance-2-0 --input @plan.json --dry-run\n```\n\nPer-tool help is generated from the schema:\n\n```bash\ndlazy <tool-name> --help\n```\n\nOutput modes:\n\n- `--format json` (default) — machine-readable envelope; parse with `jq`\n- `--format url` — bare URL when the tool produces a single asset\n- `--format text` — human-readable text payload\n- `--save <path>` — download the asset straight to disk (mkdir + retry handled for you)\n\n---\n\n## Phase 3 — Poll async cloud tasks\n\nLong-running generations return a `generateId` instead of the final asset:\n\n```bash\ndlazy status <generateId>\ndlazy status <generateId> --format json\n```\n\nRepeat until status is `succeeded` (then the asset URL is in the payload) or\n`failed` (with `error.code` + `error.message`).\n\n---\n\n## Phase 4 — Common failure recovery\n\n**`dlazy doctor remotion --install` fails on `npm install`:**\n- Check Node ≥ 18 (`node --version`).\n- Behind a corp proxy: set `npm_config_proxy` / `npm_config_https_proxy`.\n\n**`video_downloader` returns \"Sign in to confirm you're not a bot\":**\n- YouTube anti-bot challenge. Pass `\"cookies_from_browser\": \"chrome\"`\n  (or firefox / safari / edge) in the input JSON.\n\n**`video_compose` returns \"render_runtime=hyperframes not yet implemented\":**\n- HyperFrames runtime not shipped. Switch `edit_decisions.render_runtime` to\n  `remotion` or `ffmpeg`, then re-validate via `pre_render_validator`.\n\n**ElevenLabs STT returns an empty `words` array:**\n- Pass `timestamps_granularity: \"word\"` explicitly.\n\n**Need to know a tool's cost before invoking:**\n- `dlazy tools describe <name>` exposes `hasCosts` and the cost shape. Log\n  the estimate to a local file or your audit log before calling the tool.\n\n**Unknown command suggestion:**\n- `dlazy <typo>` returns `error: unknown command '<typo>'` plus a \"Did you\n  mean …?\" suggestion line based on edit distance. Trust the suggestion only\n  after confirming via `dlazy tools list`.\n\n---\n\n## Anti-patterns\n\n- Calling a tool whose existence you haven't verified via `dlazy tools list`.\n- Memorizing provider names from prior sessions instead of re-checking the\n  registry (tools come and go).\n- Silently swapping render runtime mid-pipeline (govern via `state_lock_profile`\n  + `post_render_gate` parity checks instead).\n- Calling paid generation without announcing provider / model / cost first.\n\n---\n\n## Reference card\n\n```\nINSTALL       npm install -g @dlazy/cli && dlazy auth login\nDISCOVER      dlazy tools list  |  dlazy tools describe <name>\nLOCAL RT      dlazy doctor remotion --install   (or yt-dlp)\nINVOKE        dlazy <tool-name> --input @file.json --format json\nDRY RUN       dlazy <tool-name> --input @file.json --dry-run\nPOLL          dlazy status <generateId>\nHELP          dlazy --help  |  dlazy <tool-name> --help\nRECOVER       dlazy doctor <target>  |  dlazy tools describe <name>\n```\n\nFile v2.0.23:_meta.json\n\n{\n  \"ownerId\": \"kn7c5wgeajfcfvdfb5ceemvdb984cjpd\",\n  \"slug\": \"dlazy-start\",\n  \"version\": \"2.0.23\",\n  \"publishedAt\": 1790562352887\n}\n\nFile v2.0.23:skill-card.md\n\n## Description:\n\nGuides AI agents through installing, authenticating, discovering, and using dLazy CLI tools, including asynchronous jobs and common failures.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[dlazyai](https://clawhub.ai/user/dlazyai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and AI-agent operators use this quickstart to set up dLazy CLI, discover available cloud and local tools, invoke them, and troubleshoot results.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Browser-cookie access for video downloads can expose authenticated sessions.\n\nMitigation: Do not permit automatic browser-cookie access; handle cookie-based workarounds manually for a specific task.\n\nRisk: API keys and saved CLI credentials may be exposed.\n\nMitigation: Prefer device-code login and protect API keys and ~/.dlazy/config.json.\n\nRisk: Installing the CLI or invoking paid provider tools can introduce package or cost exposure.\n\nMitigation: Verify or pin the npm package version where practical and review provider costs before paid calls.\n\n## Reference(s):\n\n- [ClawHub skill release](https://clawhub.ai/dlazyai/skills/dlazy-start)\n- [dLazy website](https://dlazy.com)\n- [dLazy CLI npm package](https://www.npmjs.com/package/@dlazy/cli)\n- [dLazy CLI source (listed in skill metadata)](https://github.com/dlazy-ai/cli)\n\n## Skill Output:\n\n**Output Type(s):** [Guidance, Shell commands, Configuration instructions]\n\n**Output Format:** [Markdown with shell command examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [None]\n\n## Skill Version(s):\n\n2.0.23 (source: ClawHub release; skill frontmatter lists 2.0.6)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v2.0.23:SKILL-cn.md\n\n---\nname: dlazy-start\nversion: 2.0.6\ndescription: \"AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。\"\ntriggers:\n  - dLazy CLI 智能体上手手册\nmetadata: {\"clawdbot\":{\"emoji\":\"🎬\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli\",\"installAlternative\":\"npx @dlazy/cli\",\"homepage\":\"https://dlazy.com\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"AGPL-3.0-or-later\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"你正在为用户操作 @dlazy/cli。先探测:跑 `dlazy tools list` 看可用工具,`dlazy tools describe <名字>` 看单工具的 input/output schema 和成本。调用形态:`dlazy <工具名> --input @file.json`(或加 `--format json` 拿机读 envelope)。异步任务用 `dlazy status <generateId>` 轮询。需要本地 runtime 时跑 `dlazy doctor remotion --install` 或 `dlazy doctor yt-dlp --install`。在没用 `dlazy tools list` 核实之前,绝不声称某工具存在。\"}}\n---\n\n# 智能体上手手册 Start\n\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\n\n给 AI 编排器(Claude Code / Cursor / Codex / Copilot)用的最小契约。CLI 本质是一个工具分发壳:每个注册的云端/本地工具都会变成顶层 subcommand。CLI 不内置项目工作目录或 pipeline 状态机 —— 那些是上层 agent 的概念。\n\nLicense: AGPL-3.0-or-later。\n\n## 本 skill 教什么\n\n你从鉴权一路驱动 `@dlazy/cli` 到工具调用:\n\n- **云端工具**(40+) —— 图像 / 视频 / 音频 / 文本服务(Seedream / Recraft / MJ / Veo / Seedance / Kling / ElevenLabs / …)\n- **本地工具**(40+) —— `state_lock_profile`、`video_compose`、`post_render_gate`、`scene_detect`、`frame_sampler`、`audio_mixer`、`audio_probe`、`transcribe`、`subtitle`、`color_grade`、`extract_segment`、`ffmpeg_run`、…(完整列表跑 `dlazy tools list`)\n- **CLI 命令**: `auth`、`doctor`、`tools list`、`tools describe`、`status`,再加上每个注册工具对应的一个顶层 subcommand。\n\n---\n\n## Phase 0 — 安装与鉴权\n\n```bash\n# 一次性安装\nnpm install -g @dlazy/cli\n\n# 登录(设备码流程;远程终端也可用)\ndlazy auth login\n```\n\n备选鉴权:`dlazy auth set YOUR_API_KEY`,或设 `DLAZY_API_KEY` 环境变量。配置存在 `~/.dlazy/config.json`(Windows:`%USERPROFILE%\\.dlazy\\`)。\n\n所有命令都接受的全局 flag:`--api-key`、`--base-url`、`--verbose`、`--format <json|url|text>`、`--refresh-manifest`、`-l/--lang <locale>`。\n\n---\n\n## Phase 1 — 能力探测\n\n```bash\ndlazy --help                         # 顶层命令面\ndlazy tools list                     # 注册工具列表 + 类型 + 成本形态\ndlazy tools describe <名字>          # 单工具 input/output JSON schema + hasCosts + 示例\n```\n\n可选本地 runtime 需要一次性安装:\n\n```bash\ndlazy doctor remotion                # 报 Remotion composer 状态\ndlazy doctor remotion --install      # 约 50s,装 bundled composer\n\ndlazy doctor yt-dlp --install        # 用 video_downloader 拉 YouTube 等需要\ndlazy doctor yt-dlp --install --proxy http://127.0.0.1:1087\n```\n\n部分沙箱通过 `DLAZY_DISABLED_TOOLS=<逗号分隔>` 限制工具面;被禁用的工具不会出现在 `dlazy --help` 里,直接调会返回明确的 `tool_disabled` 错误。\n\n---\n\n## Phase 2 — 调用工具\n\n每个工具都是顶层 subcommand:\n\n```bash\n# 命令行 flag(对应 input schema)\ndlazy gpt-image-2 --prompt \"黄昏中的赛博朋克猫\"\n\n# JSON 输入文件(复杂结构推荐)\ndlazy video_compose --input @work/compose.json --format json\n\n# 干跑校验(不发远程调用,不扣额度)\ndlazy seedance-2-0 --input @plan.json --dry-run\n```\n\n每个工具的 help 是从 schema 生成的:\n\n```bash\ndlazy <工具名> --help\n```\n\n输出模式:\n\n- `--format json`(默认) —— 机读 envelope;用 `jq` 解析\n- `--format url` —— 单一素材产物时,直接给纯 URL\n- `--format text` —— 人读文本载荷\n- `--save <path>` —— 直接把素材下载到本地路径(自动 mkdir + 重试)\n\n---\n\n## Phase 3 — 轮询异步云任务\n\n长任务返回 `generateId` 而非素材:\n\n```bash\ndlazy status <generateId>\ndlazy status <generateId> --format json\n```\n\n反复轮询直到 `succeeded`(payload 里带素材 URL)或 `failed`(带 `error.code` + `error.message`)。\n\n---\n\n## Phase 4 — 常见失败恢复\n\n**`dlazy doctor remotion --install` 在 npm install 阶段失败:**\n- 检查 Node ≥ 18(`node --version`)。\n- 公司代理后面:设 `npm_config_proxy` / `npm_config_https_proxy`。\n\n**`video_downloader` 回复 \"Sign in to confirm you're not a bot\":**\n- YouTube 反爬挑战。input JSON 里加 `\"cookies_from_browser\": \"chrome\"`(或 firefox / safari / edge)。\n\n**`video_compose` 返回 \"render_runtime=hyperframes not yet implemented\":**\n- HyperFrames runtime 还没 ship。把 `edit_decisions.render_runtime` 切成 `remotion` 或 `ffmpeg`,再用 `pre_render_validator` 复检。\n\n**ElevenLabs STT 返回空 `words` 数组:**\n- 显式传 `timestamps_granularity: \"word\"`。\n\n**不知道工具成本就要调:**\n- `dlazy tools describe <名字>` 暴露 `hasCosts` 和成本形态。先把 estimate 写到本地审计日志,再调工具。\n\n**unknown command 提示:**\n- `dlazy <错字>` 返回 `error: unknown command '<typo>'` 加一条编辑距离推荐 \"Did you mean …?\"。先用 `dlazy tools list` 核实再信。\n\n---\n\n## 反模式\n\n- 没用 `dlazy tools list` 核实就调某工具。\n- 凭上次会话记忆写 provider 名,而不重新查注册表(工具会进出)。\n- pipeline 中途悄悄换 render runtime(用 `state_lock_profile` + `post_render_gate` parity 校验去管)。\n- 付费生成前不播报 provider / model / 成本。\n\n---\n\n## 速查卡\n\n```\n安装         npm install -g @dlazy/cli && dlazy auth login\n探测         dlazy tools list  |  dlazy tools describe <名字>\n本地 runtime  dlazy doctor remotion --install   (或 yt-dlp)\n调用         dlazy <工具名> --input @file.json --format json\n干跑         dlazy <工具名> --input @file.json --dry-run\n轮询         dlazy status <generateId>\n帮助         dlazy --help  |  dlazy <工具名> --help\n排障         dlazy doctor <目标>  |  dlazy tools describe <名字>\n```\n\nArchive v2.0.22: 4 files, 8303 bytes\n\nFiles: skill-card.md (2021b), SKILL-cn.md (6464b), SKILL.md (7014b), _meta.json (131b)\n\nFile v2.0.22:SKILL.md\n\n---\nname: dlazy-start\nversion: 2.0.6\ndescription: \"Quickstart for AI orchestrators (Claude Code / Cursor / Codex / Copilot) driving @dlazy/cli. Covers install, auth, capability discovery, invoking cloud + local tools, polling async tasks, and recovering from common failures. AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。\"\ntriggers:\n  - dLazy CLI Quickstart for AI Agents\nmetadata: {\"clawdbot\":{\"emoji\":\"🎬\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli\",\"installAlternative\":\"npx @dlazy/cli\",\"homepage\":\"https://dlazy.com\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"AGPL-3.0-or-later\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"You are operating @dlazy/cli for the user. Discovery first: run `dlazy tools list` to see available tools and `dlazy tools describe <name>` to inspect a tool's input/output schema and cost shape. Invoke with `dlazy <tool-name> --input @file.json` (or `--format json` for machine-readable envelopes). Poll long-running cloud tasks with `dlazy status <generateId>`. Install optional local runtimes with `dlazy doctor remotion --install` or `dlazy doctor yt-dlp --install`. Never claim a tool exists without verifying via `dlazy tools list`.\"}}\n---\n\n# 智能体上手手册 Start\n\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\n\nA minimal contract for AI orchestrators using `@dlazy/cli`. The CLI is a\ntool-dispatch surface: every registered cloud + local tool becomes a top-level\nsubcommand. There is no built-in project workspace or pipeline state machine —\nthose are agent-side concepts.\n\nLicense: AGPL-3.0-or-later.\n\n## What this skill teaches\n\nYou drive `@dlazy/cli` from auth through tool invocation:\n\n- **Cloud tools** (40+) — image / video / audio / text providers (Seedream,\n  Recraft, MJ, Veo, Seedance, Kling, ElevenLabs, …)\n- **Local tools** (40+) — `state_lock_profile`, `video_compose`,\n  `post_render_gate`, `scene_detect`, `frame_sampler`, `audio_mixer`,\n  `audio_probe`, `transcribe`, `subtitle`, `color_grade`, `extract_segment`,\n  `ffmpeg_run`, … (full list via `dlazy tools list`)\n- **CLI commands**: `auth`, `doctor`, `tools list`, `tools describe`,\n  `status`, plus one top-level subcommand per registered tool.\n\n---\n\n## Phase 0 — Install & auth\n\n```bash\n# Install once\nnpm install -g @dlazy/cli\n\n# Authenticate (device-code flow; works in remote shells)\ndlazy auth login\n```\n\nAlternate auth: `dlazy auth set YOUR_API_KEY`, or set the `DLAZY_API_KEY`\nenv var. Config lives at `~/.dlazy/config.json` (Windows:\n`%USERPROFILE%\\.dlazy\\`).\n\nGlobal flags every command accepts: `--api-key`, `--base-url`, `--verbose`,\n`--format <json|url|text>`, `--refresh-manifest`, `-l/--lang <locale>`.\n\n---\n\n## Phase 1 — Discover capabilities\n\n```bash\ndlazy --help                         # top-level command surface\ndlazy tools list                     # registered tools with type + cost shape\ndlazy tools describe <name>          # input/output JSON schema, hasCosts, examples\n```\n\nOptional local runtimes need a one-time install:\n\n```bash\ndlazy doctor remotion                # report Remotion composer state\ndlazy doctor remotion --install      # ~50s, installs the bundled composer\n\ndlazy doctor yt-dlp --install        # for video_downloader on YouTube et al.\ndlazy doctor yt-dlp --install --proxy http://127.0.0.1:1087\n```\n\nSome sandboxes restrict the tool surface via `DLAZY_DISABLED_TOOLS=<csv>`;\ndisabled tools are hidden from `dlazy --help` and refuse invocation with a\nclear `tool_disabled` error.\n\n---\n\n## Phase 2 — Invoke a tool\n\nEvery tool is a top-level subcommand:\n\n```bash\n# Inline flags (mirrors the input schema)\ndlazy gpt-image-2 --prompt \"cyberpunk cat at dusk\"\n\n# JSON input file (preferred for complex shapes)\ndlazy video_compose --input @work/compose.json --format json\n\n# Dry-run for validation only (no remote call, no credit consumption)\ndlazy seedance-2-0 --input @plan.json --dry-run\n```\n\nPer-tool help is generated from the schema:\n\n```bash\ndlazy <tool-name> --help\n```\n\nOutput modes:\n\n- `--format json` (default) — machine-readable envelope; parse with `jq`\n- `--format url` — bare URL when the tool produces a single asset\n- `--format text` — human-readable text payload\n- `--save <path>` — download the asset straight to disk (mkdir + retry handled for you)\n\n---\n\n## Phase 3 — Poll async cloud tasks\n\nLong-running generations return a `generateId` instead of the final asset:\n\n```bash\ndlazy status <generateId>\ndlazy status <generateId> --format json\n```\n\nRepeat until status is `succeeded` (then the asset URL is in the payload) or\n`failed` (with `error.code` + `error.message`).\n\n---\n\n## Phase 4 — Common failure recovery\n\n**`dlazy doctor remotion --install` fails on `npm install`:**\n- Check Node ≥ 18 (`node --version`).\n- Behind a corp proxy: set `npm_config_proxy` / `npm_config_https_proxy`.\n\n**`video_downloader` returns \"Sign in to confirm you're not a bot\":**\n- YouTube anti-bot challenge. Pass `\"cookies_from_browser\": \"chrome\"`\n  (or firefox / safari / edge) in the input JSON.\n\n**`video_compose` returns \"render_runtime=hyperframes not yet implemented\":**\n- HyperFrames runtime not shipped. Switch `edit_decisions.render_runtime` to\n  `remotion` or `ffmpeg`, then re-validate via `pre_render_validator`.\n\n**ElevenLabs STT returns an empty `words` array:**\n- Pass `timestamps_granularity: \"word\"` explicitly.\n\n**Need to know a tool's cost before invoking:**\n- `dlazy tools describe <name>` exposes `hasCosts` and the cost shape. Log\n  the estimate to a local file or your audit log before calling the tool.\n\n**Unknown command suggestion:**\n- `dlazy <typo>` returns `error: unknown command '<typo>'` plus a \"Did you\n  mean …?\" suggestion line based on edit distance. Trust the suggestion only\n  after confirming via `dlazy tools list`.\n\n---\n\n## Anti-patterns\n\n- Calling a tool whose existence you haven't verified via `dlazy tools list`.\n- Memorizing provider names from prior sessions instead of re-checking the\n  registry (tools come and go).\n- Silently swapping render runtime mid-pipeline (govern via `state_lock_profile`\n  + `post_render_gate` parity checks instead).\n- Calling paid generation without announcing provider / model / cost first.\n\n---\n\n## Reference card\n\n```\nINSTALL       npm install -g @dlazy/cli && dlazy auth login\nDISCOVER      dlazy tools list  |  dlazy tools describe <name>\nLOCAL RT      dlazy doctor remotion --install   (or yt-dlp)\nINVOKE        dlazy <tool-name> --input @file.json --format json\nDRY RUN       dlazy <tool-name> --input @file.json --dry-run\nPOLL          dlazy status <generateId>\nHELP          dlazy --help  |  dlazy <tool-name> --help\nRECOVER       dlazy doctor <target>  |  dlazy tools describe <name>\n```\n\nFile v2.0.22:_meta.json\n\n{\n  \"ownerId\": \"kn7c5wgeajfcfvdfb5ceemvdb984cjpd\",\n  \"slug\": \"dlazy-start\",\n  \"version\": \"2.0.22\",\n  \"publishedAt\": 1790558914713\n}\n\nFile v2.0.22:skill-card.md\n\n## Description:\n\nGuides AI agents through installing, authenticating, discovering, and using @dlazy/cli tools for media workflows and troubleshooting.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[dlazyai](https://clawhub.ai/user/dlazyai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and AI-agent operators use this skill to set up @dlazy/cli, discover available media tools, run local or cloud tasks, poll results, and troubleshoot failures.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Unpinned npm or npx execution may run unreviewed package code.\n\nMitigation: Review the package, use a pinned trusted version where possible, and approve execution before installing or invoking it.\n\nRisk: Using browser cookies for video downloads may expose session material.\n\nMitigation: Do not permit cookie access unless the user explicitly approves sharing sessions for the specific site and understands how the CLI handles them.\n\nRisk: Paid provider calls, API credentials, downloads, and optional runtime installs can incur costs or access sensitive resources.\n\nMitigation: Confirm costs and request user approval before paid calls, credential use, downloads, or runtime installations.\n\n## Reference(s):\n\n- [ClawHub skill listing](https://clawhub.ai/dlazyai/skills/dlazy-start)\n- [dLazy homepage](https://dlazy.com)\n- [@dlazy/cli npm package](https://www.npmjs.com/package/@dlazy/cli)\n\n## Skill Output:\n\n**Output Type(s):** [Shell commands, Configuration instructions, Guidance]\n\n**Output Format:** [Markdown with shell and JSON examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [None]\n\n## Skill Version(s):\n\n2.0.22 (source: ClawHub release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v2.0.22:SKILL-cn.md\n\n---\nname: dlazy-start\nversion: 2.0.6\ndescription: \"AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。\"\ntriggers:\n  - dLazy CLI 智能体上手手册\nmetadata: {\"clawdbot\":{\"emoji\":\"🎬\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli\",\"installAlternative\":\"npx @dlazy/cli\",\"homepage\":\"https://dlazy.com\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"AGPL-3.0-or-later\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"你正在为用户操作 @dlazy/cli。先探测:跑 `dlazy tools list` 看可用工具,`dlazy tools describe <名字>` 看单工具的 input/output schema 和成本。调用形态:`dlazy <工具名> --input @file.json`(或加 `--format json` 拿机读 envelope)。异步任务用 `dlazy status <generateId>` 轮询。需要本地 runtime 时跑 `dlazy doctor remotion --install` 或 `dlazy doctor yt-dlp --install`。在没用 `dlazy tools list` 核实之前,绝不声称某工具存在。\"}}\n---\n\n# 智能体上手手册 Start\n\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\n\n给 AI 编排器(Claude Code / Cursor / Codex / Copilot)用的最小契约。CLI 本质是一个工具分发壳:每个注册的云端/本地工具都会变成顶层 subcommand。CLI 不内置项目工作目录或 pipeline 状态机 —— 那些是上层 agent 的概念。\n\nLicense: AGPL-3.0-or-later。\n\n## 本 skill 教什么\n\n你从鉴权一路驱动 `@dlazy/cli` 到工具调用:\n\n- **云端工具**(40+) —— 图像 / 视频 / 音频 / 文本服务(Seedream / Recraft / MJ / Veo / Seedance / Kling / ElevenLabs / …)\n- **本地工具**(40+) —— `state_lock_profile`、`video_compose`、`post_render_gate`、`scene_detect`、`frame_sampler`、`audio_mixer`、`audio_probe`、`transcribe`、`subtitle`、`color_grade`、`extract_segment`、`ffmpeg_run`、…(完整列表跑 `dlazy tools list`)\n- **CLI 命令**: `auth`、`doctor`、`tools list`、`tools describe`、`status`,再加上每个注册工具对应的一个顶层 subcommand。\n\n---\n\n## Phase 0 — 安装与鉴权\n\n```bash\n# 一次性安装\nnpm install -g @dlazy/cli\n\n# 登录(设备码流程;远程终端也可用)\ndlazy auth login\n```\n\n备选鉴权:`dlazy auth set YOUR_API_KEY`,或设 `DLAZY_API_KEY` 环境变量。配置存在 `~/.dlazy/config.json`(Windows:`%USERPROFILE%\\.dlazy\\`)。\n\n所有命令都接受的全局 flag:`--api-key`、`--base-url`、`--verbose`、`--format <json|url|text>`、`--refresh-manifest`、`-l/--lang <locale>`。\n\n---\n\n## Phase 1 — 能力探测\n\n```bash\ndlazy --help                         # 顶层命令面\ndlazy tools list                     # 注册工具列表 + 类型 + 成本形态\ndlazy tools describe <名字>          # 单工具 input/output JSON schema + hasCosts + 示例\n```\n\n可选本地 runtime 需要一次性安装:\n\n```bash\ndlazy doctor remotion                # 报 Remotion composer 状态\ndlazy doctor remotion --install      # 约 50s,装 bundled composer\n\ndlazy doctor yt-dlp --install        # 用 video_downloader 拉 YouTube 等需要\ndlazy doctor yt-dlp --install --proxy http://127.0.0.1:1087\n```\n\n部分沙箱通过 `DLAZY_DISABLED_TOOLS=<逗号分隔>` 限制工具面;被禁用的工具不会出现在 `dlazy --help` 里,直接调会返回明确的 `tool_disabled` 错误。\n\n---\n\n## Phase 2 — 调用工具\n\n每个工具都是顶层 subcommand:\n\n```bash\n# 命令行 flag(对应 input schema)\ndlazy gpt-image-2 --prompt \"黄昏中的赛博朋克猫\"\n\n# JSON 输入文件(复杂结构推荐)\ndlazy video_compose --input @work/compose.json --format json\n\n# 干跑校验(不发远程调用,不扣额度)\ndlazy seedance-2-0 --input @plan.json --dry-run\n```\n\n每个工具的 help 是从 schema 生成的:\n\n```bash\ndlazy <工具名> --help\n```\n\n输出模式:\n\n- `--format json`(默认) —— 机读 envelope;用 `jq` 解析\n- `--format url` —— 单一素材产物时,直接给纯 URL\n- `--format text` —— 人读文本载荷\n- `--save <path>` —— 直接把素材下载到本地路径(自动 mkdir + 重试)\n\n---\n\n## Phase 3 — 轮询异步云任务\n\n长任务返回 `generateId` 而非素材:\n\n```bash\ndlazy status <generateId>\ndlazy status <generateId> --format json\n```\n\n反复轮询直到 `succeeded`(payload 里带素材 URL)或 `failed`(带 `error.code` + `error.message`)。\n\n---\n\n## Phase 4 — 常见失败恢复\n\n**`dlazy doctor remotion --install` 在 npm install 阶段失败:**\n- 检查 Node ≥ 18(`node --version`)。\n- 公司代理后面:设 `npm_config_proxy` / `npm_config_https_proxy`。\n\n**`video_downloader` 回复 \"Sign in to confirm you're not a bot\":**\n- YouTube 反爬挑战。input JSON 里加 `\"cookies_from_browser\": \"chrome\"`(或 firefox / safari / edge)。\n\n**`video_compose` 返回 \"render_runtime=hyperframes not yet implemented\":**\n- HyperFrames runtime 还没 ship。把 `edit_decisions.render_runtime` 切成 `remotion` 或 `ffmpeg`,再用 `pre_render_validator` 复检。\n\n**ElevenLabs STT 返回空 `words` 数组:**\n- 显式传 `timestamps_granularity: \"word\"`。\n\n**不知道工具成本就要调:**\n- `dlazy tools describe <名字>` 暴露 `hasCosts` 和成本形态。先把 estimate 写到本地审计日志,再调工具。\n\n**unknown command 提示:**\n- `dlazy <错字>` 返回 `error: unknown command '<typo>'` 加一条编辑距离推荐 \"Did you mean …?\"。先用 `dlazy tools list` 核实再信。\n\n---\n\n## 反模式\n\n- 没用 `dlazy tools list` 核实就调某工具。\n- 凭上次会话记忆写 provider 名,而不重新查注册表(工具会进出)。\n- pipeline 中途悄悄换 render runtime(用 `state_lock_profile` + `post_render_gate` parity 校验去管)。\n- 付费生成前不播报 provider / model / 成本。\n\n---\n\n## 速查卡\n\n```\n安装         npm install -g @dlazy/cli && dlazy auth login\n探测         dlazy tools list  |  dlazy tools describe <名字>\n本地 runtime  dlazy doctor remotion --install   (或 yt-dlp)\n调用         dlazy <工具名> --input @file.json --format json\n干跑         dlazy <工具名> --input @file.json --dry-run\n轮询         dlazy status <generateId>\n帮助         dlazy --help  |  dlazy <工具名> --help\n排障         dlazy doctor <目标>  |  dlazy tools describe <名字>\n```\n\nArchive v2.0.21: 4 files, 8608 bytes\n\nFiles: skill-card.md (2781b), SKILL-cn.md (6464b), SKILL.md (7014b), _meta.json (131b)\n\nFile v2.0.21:SKILL.md\n\n---\nname: dlazy-start\nversion: 2.0.6\ndescription: \"Quickstart for AI orchestrators (Claude Code / Cursor / Codex / Copilot) driving @dlazy/cli. Covers install, auth, capability discovery, invoking cloud + local tools, polling async tasks, and recovering from common failures. AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。\"\ntriggers:\n  - dLazy CLI Quickstart for AI Agents\nmetadata: {\"clawdbot\":{\"emoji\":\"🎬\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli\",\"installAlternative\":\"npx @dlazy/cli\",\"homepage\":\"https://dlazy.com\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"AGPL-3.0-or-later\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"You are operating @dlazy/cli for the user. Discovery first: run `dlazy tools list` to see available tools and `dlazy tools describe <name>` to inspect a tool's input/output schema and cost shape. Invoke with `dlazy <tool-name> --input @file.json` (or `--format json` for machine-readable envelopes). Poll long-running cloud tasks with `dlazy status <generateId>`. Install optional local runtimes with `dlazy doctor remotion --install` or `dlazy doctor yt-dlp --install`. Never claim a tool exists without verifying via `dlazy tools list`.\"}}\n---\n\n# 智能体上手手册 Start\n\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\n\nA minimal contract for AI orchestrators using `@dlazy/cli`. The CLI is a\ntool-dispatch surface: every registered cloud + local tool becomes a top-level\nsubcommand. There is no built-in project workspace or pipeline state machine —\nthose are agent-side concepts.\n\nLicense: AGPL-3.0-or-later.\n\n## What this skill teaches\n\nYou drive `@dlazy/cli` from auth through tool invocation:\n\n- **Cloud tools** (40+) — image / video / audio / text providers (Seedream,\n  Recraft, MJ, Veo, Seedance, Kling, ElevenLabs, …)\n- **Local tools** (40+) — `state_lock_profile`, `video_compose`,\n  `post_render_gate`, `scene_detect`, `frame_sampler`, `audio_mixer`,\n  `audio_probe`, `transcribe`, `subtitle`, `color_grade`, `extract_segment`,\n  `ffmpeg_run`, … (full list via `dlazy tools list`)\n- **CLI commands**: `auth`, `doctor`, `tools list`, `tools describe`,\n  `status`, plus one top-level subcommand per registered tool.\n\n---\n\n## Phase 0 — Install & auth\n\n```bash\n# Install once\nnpm install -g @dlazy/cli\n\n# Authenticate (device-code flow; works in remote shells)\ndlazy auth login\n```\n\nAlternate auth: `dlazy auth set YOUR_API_KEY`, or set the `DLAZY_API_KEY`\nenv var. Config lives at `~/.dlazy/config.json` (Windows:\n`%USERPROFILE%\\.dlazy\\`).\n\nGlobal flags every command accepts: `--api-key`, `--base-url`, `--verbose`,\n`--format <json|url|text>`, `--refresh-manifest`, `-l/--lang <locale>`.\n\n---\n\n## Phase 1 — Discover capabilities\n\n```bash\ndlazy --help                         # top-level command surface\ndlazy tools list                     # registered tools with type + cost shape\ndlazy tools describe <name>          # input/output JSON schema, hasCosts, examples\n```\n\nOptional local runtimes need a one-time install:\n\n```bash\ndlazy doctor remotion                # report Remotion composer state\ndlazy doctor remotion --install      # ~50s, installs the bundled composer\n\ndlazy doctor yt-dlp --install        # for video_downloader on YouTube et al.\ndlazy doctor yt-dlp --install --proxy http://127.0.0.1:1087\n```\n\nSome sandboxes restrict the tool surface via `DLAZY_DISABLED_TOOLS=<csv>`;\ndisabled tools are hidden from `dlazy --help` and refuse invocation with a\nclear `tool_disabled` error.\n\n---\n\n## Phase 2 — Invoke a tool\n\nEvery tool is a top-level subcommand:\n\n```bash\n# Inline flags (mirrors the input schema)\ndlazy gpt-image-2 --prompt \"cyberpunk cat at dusk\"\n\n# JSON input file (preferred for complex shapes)\ndlazy video_compose --input @work/compose.json --format json\n\n# Dry-run for validation only (no remote call, no credit consumption)\ndlazy seedance-2-0 --input @plan.json --dry-run\n```\n\nPer-tool help is generated from the schema:\n\n```bash\ndlazy <tool-name> --help\n```\n\nOutput modes:\n\n- `--format json` (default) — machine-readable envelope; parse with `jq`\n- `--format url` — bare URL when the tool produces a single asset\n- `--format text` — human-readable text payload\n- `--save <path>` — download the asset straight to disk (mkdir + retry handled for you)\n\n---\n\n## Phase 3 — Poll async cloud tasks\n\nLong-running generations return a `generateId` instead of the final asset:\n\n```bash\ndlazy status <generateId>\ndlazy status <generateId> --format json\n```\n\nRepeat until status is `succeeded` (then the asset URL is in the payload) or\n`failed` (with `error.code` + `error.message`).\n\n---\n\n## Phase 4 — Common failure recovery\n\n**`dlazy doctor remotion --install` fails on `npm install`:**\n- Check Node ≥ 18 (`node --version`).\n- Behind a corp proxy: set `npm_config_proxy` / `npm_config_https_proxy`.\n\n**`video_downloader` returns \"Sign in to confirm you're not a bot\":**\n- YouTube anti-bot challenge. Pass `\"cookies_from_browser\": \"chrome\"`\n  (or firefox / safari / edge) in the input JSON.\n\n**`video_compose` returns \"render_runtime=hyperframes not yet implemented\":**\n- HyperFrames runtime not shipped. Switch `edit_decisions.render_runtime` to\n  `remotion` or `ffmpeg`, then re-validate via `pre_render_validator`.\n\n**ElevenLabs STT returns an empty `words` array:**\n- Pass `timestamps_granularity: \"word\"` explicitly.\n\n**Need to know a tool's cost before invoking:**\n- `dlazy tools describe <name>` exposes `hasCosts` and the cost shape. Log\n  the estimate to a local file or your audit log before calling the tool.\n\n**Unknown command suggestion:**\n- `dlazy <typo>` returns `error: unknown command '<typo>'` plus a \"Did you\n  mean …?\" suggestion line based on edit distance. Trust the suggestion only\n  after confirming via `dlazy tools list`.\n\n---\n\n## Anti-patterns\n\n- Calling a tool whose existence you haven't verified via `dlazy tools list`.\n- Memorizing provider names from prior sessions instead of re-checking the\n  registry (tools come and go).\n- Silently swapping render runtime mid-pipeline (govern via `state_lock_profile`\n  + `post_render_gate` parity checks instead).\n- Calling paid generation without announcing provider / model / cost first.\n\n---\n\n## Reference card\n\n```\nINSTALL       npm install -g @dlazy/cli && dlazy auth login\nDISCOVER      dlazy tools list  |  dlazy tools describe <name>\nLOCAL RT      dlazy doctor remotion --install   (or yt-dlp)\nINVOKE        dlazy <tool-name> --input @file.json --format json\nDRY RUN       dlazy <tool-name> --input @file.json --dry-run\nPOLL          dlazy status <generateId>\nHELP          dlazy --help  |  dlazy <tool-name> --help\nRECOVER       dlazy doctor <target>  |  dlazy tools describe <name>\n```\n\nFile v2.0.21:_meta.json\n\n{\n  \"ownerId\": \"kn7c5wgeajfcfvdfb5ceemvdb984cjpd\",\n  \"slug\": \"dlazy-start\",\n  \"version\": \"2.0.21\",\n  \"publishedAt\": 1790216173692\n}\n\nFile v2.0.21:skill-card.md\n\n## Description:\n\nQuickstart guidance for AI orchestrators driving @dlazy/cli, covering install, authentication, capability discovery, cloud and local tool invocation, async polling, and common failure recovery.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[dlazyai](https://clawhub.ai/user/dlazyai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and AI-agent operators use this skill to operate @dlazy/cli from an orchestrator such as Claude Code, Cursor, Codex, or Copilot. It helps agents install and authenticate the CLI, discover available tools, invoke cloud and local commands, poll long-running tasks, and recover from common CLI failures.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill depends on @dlazy/cli, which can call paid cloud tools and save generated outputs.\n\nMitigation: Install only from trusted package sources, use dry-run or tool description commands before paid calls, and announce provider, model, and cost before invoking generation tools.\n\nRisk: API keys may be supplied through command-line flags, config files, or environment variables.\n\nMitigation: Prefer device-code login or protected environment injection, avoid inline API keys when possible, and protect ~/.dlazy/config.json.\n\nRisk: Browser-cookie based downloads may use local browser session data.\n\nMitigation: Use cookies_from_browser only when the user explicitly accepts that local browser session data may be accessed for the download workflow.\n\nRisk: Optional local runtimes such as Remotion or yt-dlp may be installed by CLI doctor commands.\n\nMitigation: Run doctor install commands only in environments where npm-installed local runtimes are allowed and review proxy or runtime requirements first.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/dlazyai/skills/dlazy-start)\n- [dLazy homepage](https://dlazy.com)\n- [@dlazy/cli npm package](https://www.npmjs.com/package/@dlazy/cli)\n- [dLazy CLI source repository](https://github.com/dlazy-ai/cli)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown with inline shell command examples and CLI usage guidance]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Includes install, authentication, discovery, invocation, polling, dry-run, and troubleshooting guidance for @dlazy/cli.]\n\n## Skill Version(s):\n\n2.0.21 (source: server release metadata; artifact frontmatter says 2.0.6)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v2.0.21:SKILL-cn.md\n\n---\nname: dlazy-start\nversion: 2.0.6\ndescription: \"AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。\"\ntriggers:\n  - dLazy CLI 智能体上手手册\nmetadata: {\"clawdbot\":{\"emoji\":\"🎬\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli\",\"installAlternative\":\"npx @dlazy/cli\",\"homepage\":\"https://dlazy.com\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"AGPL-3.0-or-later\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"你正在为用户操作 @dlazy/cli。先探测:跑 `dlazy tools list` 看可用工具,`dlazy tools describe <名字>` 看单工具的 input/output schema 和成本。调用形态:`dlazy <工具名> --input @file.json`(或加 `--format json` 拿机读 envelope)。异步任务用 `dlazy status <generateId>` 轮询。需要本地 runtime 时跑 `dlazy doctor remotion --install` 或 `dlazy doctor yt-dlp --install`。在没用 `dlazy tools list` 核实之前,绝不声称某工具存在。\"}}\n---\n\n# 智能体上手手册 Start\n\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\n\n给 AI 编排器(Claude Code / Cursor / Codex / Copilot)用的最小契约。CLI 本质是一个工具分发壳:每个注册的云端/本地工具都会变成顶层 subcommand。CLI 不内置项目工作目录或 pipeline 状态机 —— 那些是上层 agent 的概念。\n\nLicense: AGPL-3.0-or-later。\n\n## 本 skill 教什么\n\n你从鉴权一路驱动 `@dlazy/cli` 到工具调用:\n\n- **云端工具**(40+) —— 图像 / 视频 / 音频 / 文本服务(Seedream / Recraft / MJ / Veo / Seedance / Kling / ElevenLabs / …)\n- **本地工具**(40+) —— `state_lock_profile`、`video_compose`、`post_render_gate`、`scene_detect`、`frame_sampler`、`audio_mixer`、`audio_probe`、`transcribe`、`subtitle`、`color_grade`、`extract_segment`、`ffmpeg_run`、…(完整列表跑 `dlazy tools list`)\n- **CLI 命令**: `auth`、`doctor`、`tools list`、`tools describe`、`status`,再加上每个注册工具对应的一个顶层 subcommand。\n\n---\n\n## Phase 0 — 安装与鉴权\n\n```bash\n# 一次性安装\nnpm install -g @dlazy/cli\n\n# 登录(设备码流程;远程终端也可用)\ndlazy auth login\n```\n\n备选鉴权:`dlazy auth set YOUR_API_KEY`,或设 `DLAZY_API_KEY` 环境变量。配置存在 `~/.dlazy/config.json`(Windows:`%USERPROFILE%\\.dlazy\\`)。\n\n所有命令都接受的全局 flag:`--api-key`、`--base-url`、`--verbose`、`--format <json|url|text>`、`--refresh-manifest`、`-l/--lang <locale>`。\n\n---\n\n## Phase 1 — 能力探测\n\n```bash\ndlazy --help                         # 顶层命令面\ndlazy tools list                     # 注册工具列表 + 类型 + 成本形态\ndlazy tools describe <名字>          # 单工具 input/output JSON schema + hasCosts + 示例\n```\n\n可选本地 runtime 需要一次性安装:\n\n```bash\ndlazy doctor remotion                # 报 Remotion composer 状态\ndlazy doctor remotion --install      # 约 50s,装 bundled composer\n\ndlazy doctor yt-dlp --install        # 用 video_downloader 拉 YouTube 等需要\ndlazy doctor yt-dlp --install --proxy http://127.0.0.1:1087\n```\n\n部分沙箱通过 `DLAZY_DISABLED_TOOLS=<逗号分隔>` 限制工具面;被禁用的工具不会出现在 `dlazy --help` 里,直接调会返回明确的 `tool_disabled` 错误。\n\n---\n\n## Phase 2 — 调用工具\n\n每个工具都是顶层 subcommand:\n\n```bash\n# 命令行 flag(对应 input schema)\ndlazy gpt-image-2 --prompt \"黄昏中的赛博朋克猫\"\n\n# JSON 输入文件(复杂结构推荐)\ndlazy video_compose --input @work/compose.json --format json\n\n# 干跑校验(不发远程调用,不扣额度)\ndlazy seedance-2-0 --input @plan.json --dry-run\n```\n\n每个工具的 help 是从 schema 生成的:\n\n```bash\ndlazy <工具名> --help\n```\n\n输出模式:\n\n- `--format json`(默认) —— 机读 envelope;用 `jq` 解析\n- `--format url` —— 单一素材产物时,直接给纯 URL\n- `--format text` —— 人读文本载荷\n- `--save <path>` —— 直接把素材下载到本地路径(自动 mkdir + 重试)\n\n---\n\n## Phase 3 — 轮询异步云任务\n\n长任务返回 `generateId` 而非素材:\n\n```bash\ndlazy status <generateId>\ndlazy status <generateId> --format json\n```\n\n反复轮询直到 `succeeded`(payload 里带素材 URL)或 `failed`(带 `error.code` + `error.message`)。\n\n---\n\n## Phase 4 — 常见失败恢复\n\n**`dlazy doctor remotion --install` 在 npm install 阶段失败:**\n- 检查 Node ≥ 18(`node --version`)。\n- 公司代理后面:设 `npm_config_proxy` / `npm_config_https_proxy`。\n\n**`video_downloader` 回复 \"Sign in to confirm you're not a bot\":**\n- YouTube 反爬挑战。input JSON 里加 `\"cookies_from_browser\": \"chrome\"`(或 firefox / safari / edge)。\n\n**`video_compose` 返回 \"render_runtime=hyperframes not yet implemented\":**\n- HyperFrames runtime 还没 ship。把 `edit_decisions.render_runtime` 切成 `remotion` 或 `ffmpeg`,再用 `pre_render_validator` 复检。\n\n**ElevenLabs STT 返回空 `words` 数组:**\n- 显式传 `timestamps_granularity: \"word\"`。\n\n**不知道工具成本就要调:**\n- `dlazy tools describe <名字>` 暴露 `hasCosts` 和成本形态。先把 estimate 写到本地审计日志,再调工具。\n\n**unknown command 提示:**\n- `dlazy <错字>` 返回 `error: unknown command '<typo>'` 加一条编辑距离推荐 \"Did you mean …?\"。先用 `dlazy tools list` 核实再信。\n\n---\n\n## 反模式\n\n- 没用 `dlazy tools list` 核实就调某工具。\n- 凭上次会话记忆写 provider 名,而不重新查注册表(工具会进出)。\n- pipeline 中途悄悄换 render runtime(用 `state_lock_profile` + `post_render_gate` parity 校验去管)。\n- 付费生成前不播报 provider / model / 成本。\n\n---\n\n## 速查卡\n\n```\n安装         npm install -g @dlazy/cli && dlazy auth login\n探测         dlazy tools list  |  dlazy tools describe <名字>\n本地 runtime  dlazy doctor remotion --install   (或 yt-dlp)\n调用         dlazy <工具名> --input @file.json --format json\n干跑         dlazy <工具名> --input @file.json --dry-run\n轮询         dlazy status <generateId>\n帮助         dlazy --help  |  dlazy <工具名> --help\n排障         dlazy doctor <目标>  |  dlazy tools describe <名字>\n```\n\nArchive v2.0.20: 4 files, 8552 bytes\n\nFiles: skill-card.md (2570b), SKILL-cn.md (6464b), SKILL.md (7014b), _meta.json (131b)\n\nFile v2.0.20:SKILL.md\n\n---\nname: dlazy-start\nversion: 2.0.6\ndescription: \"Quickstart for AI orchestrators (Claude Code / Cursor / Codex / Copilot) driving @dlazy/cli. Covers install, auth, capability discovery, invoking cloud + local tools, polling async tasks, and recovering from common failures. AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。\"\ntriggers:\n  - dLazy CLI Quickstart for AI Agents\nmetadata: {\"clawdbot\":{\"emoji\":\"🎬\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli\",\"installAlternative\":\"npx @dlazy/cli\",\"homepage\":\"https://dlazy.com\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"AGPL-3.0-or-later\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"You are operating @dlazy/cli for the user. Discovery first: run `dlazy tools list` to see available tools and `dlazy tools describe <name>` to inspect a tool's input/output schema and cost shape. Invoke with `dlazy <tool-name> --input @file.json` (or `--format json` for machine-readable envelopes). Poll long-running cloud tasks with `dlazy status <generateId>`. Install optional local runtimes with `dlazy doctor remotion --install` or `dlazy doctor yt-dlp --install`. Never claim a tool exists without verifying via `dlazy tools list`.\"}}\n---\n\n# 智能体上手手册 Start\n\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\n\nA minimal contract for AI orchestrators using `@dlazy/cli`. The CLI is a\ntool-dispatch surface: every registered cloud + local tool becomes a top-level\nsubcommand. There is no built-in project workspace or pipeline state machine —\nthose are agent-side concepts.\n\nLicense: AGPL-3.0-or-later.\n\n## What this skill teaches\n\nYou drive `@dlazy/cli` from auth through tool invocation:\n\n- **Cloud tools** (40+) — image / video / audio / text providers (Seedream,\n  Recraft, MJ, Veo, Seedance, Kling, ElevenLabs, …)\n- **Local tools** (40+) — `state_lock_profile`, `video_compose`,\n  `post_render_gate`, `scene_detect`, `frame_sampler`, `audio_mixer`,\n  `audio_probe`, `transcribe`, `subtitle`, `color_grade`, `extract_segment`,\n  `ffmpeg_run`, … (full list via `dlazy tools list`)\n- **CLI commands**: `auth`, `doctor`, `tools list`, `tools describe`,\n  `status`, plus one top-level subcommand per registered tool.\n\n---\n\n## Phase 0 — Install & auth\n\n```bash\n# Install once\nnpm install -g @dlazy/cli\n\n# Authenticate (device-code flow; works in remote shells)\ndlazy auth login\n```\n\nAlternate auth: `dlazy auth set YOUR_API_KEY`, or set the `DLAZY_API_KEY`\nenv var. Config lives at `~/.dlazy/config.json` (Windows:\n`%USERPROFILE%\\.dlazy\\`).\n\nGlobal flags every command accepts: `--api-key`, `--base-url`, `--verbose`,\n`--format <json|url|text>`, `--refresh-manifest`, `-l/--lang <locale>`.\n\n---\n\n## Phase 1 — Discover capabilities\n\n```bash\ndlazy --help                         # top-level command surface\ndlazy tools list                     # registered tools with type + cost shape\ndlazy tools describe <name>          # input/output JSON schema, hasCosts, examples\n```\n\nOptional local runtimes need a one-time install:\n\n```bash\ndlazy doctor remotion                # report Remotion composer state\ndlazy doctor remotion --install      # ~50s, installs the bundled composer\n\ndlazy doctor yt-dlp --install        # for video_downloader on YouTube et al.\ndlazy doctor yt-dlp --install --proxy http://127.0.0.1:1087\n```\n\nSome sandboxes restrict the tool surface via `DLAZY_DISABLED_TOOLS=<csv>`;\ndisabled tools are hidden from `dlazy --help` and refuse invocation with a\nclear `tool_disabled` error.\n\n---\n\n## Phase 2 — Invoke a tool\n\nEvery tool is a top-level subcommand:\n\n```bash\n# Inline flags (mirrors the input schema)\ndlazy gpt-image-2 --prompt \"cyberpunk cat at dusk\"\n\n# JSON input file (preferred for complex shapes)\ndlazy video_compose --input @work/compose.json --format json\n\n# Dry-run for validation only (no remote call, no credit consumption)\ndlazy seedance-2-0 --input @plan.json --dry-run\n```\n\nPer-tool help is generated from the schema:\n\n```bash\ndlazy <tool-name> --help\n```\n\nOutput modes:\n\n- `--format json` (default) — machine-readable envelope; parse with `jq`\n- `--format url` — bare URL when the tool produces a single asset\n- `--format text` — human-readable text payload\n- `--save <path>` — download the asset straight to disk (mkdir + retry handled for you)\n\n---\n\n## Phase 3 — Poll async cloud tasks\n\nLong-running generations return a `generateId` instead of the final asset:\n\n```bash\ndlazy status <generateId>\ndlazy status <generateId> --format json\n```\n\nRepeat until status is `succeeded` (then the asset URL is in the payload) or\n`failed` (with `error.code` + `error.message`).\n\n---\n\n## Phase 4 — Common failure recovery\n\n**`dlazy doctor remotion --install` fails on `npm install`:**\n- Check Node ≥ 18 (`node --version`).\n- Behind a corp proxy: set `npm_config_proxy` / `npm_config_https_proxy`.\n\n**`video_downloader` returns \"Sign in to confirm you're not a bot\":**\n- YouTube anti-bot challenge. Pass `\"cookies_from_browser\": \"chrome\"`\n  (or firefox / safari / edge) in the input JSON.\n\n**`video_compose` returns \"render_runtime=hyperframes not yet implemented\":**\n- HyperFrames runtime not shipped. Switch `edit_decisions.render_runtime` to\n  `remotion` or `ffmpeg`, then re-validate via `pre_render_validator`.\n\n**ElevenLabs STT returns an empty `words` array:**\n- Pass `timestamps_granularity: \"word\"` explicitly.\n\n**Need to know a tool's cost before invoking:**\n- `dlazy tools describe <name>` exposes `hasCosts` and the cost shape. Log\n  the estimate to a local file or your audit log before calling the tool.\n\n**Unknown command suggestion:**\n- `dlazy <typo>` returns `error: unknown command '<typo>'` plus a \"Did you\n  mean …?\" suggestion line based on edit distance. Trust the suggestion only\n  after confirming via `dlazy tools list`.\n\n---\n\n## Anti-patterns\n\n- Calling a tool whose existence you haven't verified via `dlazy tools list`.\n- Memorizing provider names from prior sessions instead of re-checking the\n  registry (tools come and go).\n- Silently swapping render runtime mid-pipeline (govern via `state_lock_profile`\n  + `post_render_gate` parity checks instead).\n- Calling paid generation without announcing provider / model / cost first.\n\n---\n\n## Reference card\n\n```\nINSTALL       npm install -g @dlazy/cli && dlazy auth login\nDISCOVER      dlazy tools list  |  dlazy tools describe <name>\nLOCAL RT      dlazy doctor remotion --install   (or yt-dlp)\nINVOKE        dlazy <tool-name> --input @file.json --format json\nDRY RUN       dlazy <tool-name> --input @file.json --dry-run\nPOLL          dlazy status <generateId>\nHELP          dlazy --help  |  dlazy <tool-name> --help\nRECOVER       dlazy doctor <target>  |  dlazy tools describe <name>\n```\n\nFile v2.0.20:_meta.json\n\n{\n  \"ownerId\": \"kn7c5wgeajfcfvdfb5ceemvdb984cjpd\",\n  \"slug\": \"dlazy-start\",\n  \"version\": \"2.0.20\",\n  \"publishedAt\": 1790040425711\n}\n\nFile v2.0.20:skill-card.md\n\n## Description:\n\nQuickstart for AI orchestrators driving @dlazy/cli through installation, authentication, capability discovery, cloud and local tool invocation, async task polling, and common failure recovery.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[dlazyai](https://clawhub.ai/user/dlazyai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and AI-agent operators use this skill to install, authenticate, inspect, and invoke @dlazy/cli tools from orchestrators such as Claude Code, Cursor, Codex, Copilot, and OpenClaw. It helps agents discover available commands before use, submit JSON inputs, poll long-running generation tasks, and recover from common CLI failures.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill directs agents to install and run an unpinned external @dlazy/cli package.\n\nMitigation: Review the package before use and prefer a pinned package version in controlled environments.\n\nRisk: Authentication can involve DLAZY_API_KEY and credentials stored in ~/.dlazy/config.json.\n\nMitigation: Keep API keys out of logs and shell history, restrict access to the config file, and use scoped credentials where available.\n\nRisk: Some tool calls can incur costs or write generated assets to local paths.\n\nMitigation: Confirm provider, model, and cost before paid calls, and choose --save destinations deliberately.\n\nRisk: The cookies_from_browser option can use local browser session data.\n\nMitigation: Use browser cookies only when necessary and only with accounts and environments approved for that workflow.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/dlazyai/skills/dlazy-start)\n- [dLazy homepage](https://dlazy.com)\n- [@dlazy/cli npm package](https://www.npmjs.com/package/@dlazy/cli)\n- [@dlazy/cli source metadata link](https://github.com/dlazy-ai/cli)\n\n## Skill Output:\n\n**Output Type(s):** [Guidance, Markdown, Shell commands, Configuration instructions]\n\n**Output Format:** [Markdown with inline bash code blocks and command examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Guides agent-produced CLI invocations, JSON input-file usage, status polling, and failure recovery steps.]\n\n## Skill Version(s):\n\n2.0.20 (source: server release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v2.0.20:SKILL-cn.md\n\n---\nname: dlazy-start\nversion: 2.0.6\ndescription: \"AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。\"\ntriggers:\n  - dLazy CLI 智能体上手手册\nmetadata: {\"clawdbot\":{\"emoji\":\"🎬\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli\",\"installAlternative\":\"npx @dlazy/cli\",\"homepage\":\"https://dlazy.com\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"AGPL-3.0-or-later\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"你正在为用户操作 @dlazy/cli。先探测:跑 `dlazy tools list` 看可用工具,`dlazy tools describe <名字>` 看单工具的 input/output schema 和成本。调用形态:`dlazy <工具名> --input @file.json`(或加 `--format json` 拿机读 envelope)。异步任务用 `dlazy status <generateId>` 轮询。需要本地 runtime 时跑 `dlazy doctor remotion --install` 或 `dlazy doctor yt-dlp --install`。在没用 `dlazy tools list` 核实之前,绝不声称某工具存在。\"}}\n---\n\n# 智能体上手手册 Start\n\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\n\n给 AI 编排器(Claude Code / Cursor / Codex / Copilot)用的最小契约。CLI 本质是一个工具分发壳:每个注册的云端/本地工具都会变成顶层 subcommand。CLI 不内置项目工作目录或 pipeline 状态机 —— 那些是上层 agent 的概念。\n\nLicense: AGPL-3.0-or-later。\n\n## 本 skill 教什么\n\n你从鉴权一路驱动 `@dlazy/cli` 到工具调用:\n\n- **云端工具**(40+) —— 图像 / 视频 / 音频 / 文本服务(Seedream / Recraft / MJ / Veo / Seedance / Kling / ElevenLabs / …)\n- **本地工具**(40+) —— `state_lock_profile`、`video_compose`、`post_render_gate`、`scene_detect`、`frame_sampler`、`audio_mixer`、`audio_probe`、`transcribe`、`subtitle`、`color_grade`、`extract_segment`、`ffmpeg_run`、…(完整列表跑 `dlazy tools list`)\n- **CLI 命令**: `auth`、`doctor`、`tools list`、`tools describe`、`status`,再加上每个注册工具对应的一个顶层 subcommand。\n\n---\n\n## Phase 0 — 安装与鉴权\n\n```bash\n# 一次性安装\nnpm install -g @dlazy/cli\n\n# 登录(设备码流程;远程终端也可用)\ndlazy auth login\n```\n\n备选鉴权:`dlazy auth set YOUR_API_KEY`,或设 `DLAZY_API_KEY` 环境变量。配置存在 `~/.dlazy/config.json`(Windows:`%USERPROFILE%\\.dlazy\\`)。\n\n所有命令都接受的全局 flag:`--api-key`、`--base-url`、`--verbose`、`--format <json|url|text>`、`--refresh-manifest`、`-l/--lang <locale>`。\n\n---\n\n## Phase 1 — 能力探测\n\n```bash\ndlazy --help                         # 顶层命令面\ndlazy tools list                     # 注册工具列表 + 类型 + 成本形态\ndlazy tools describe <名字>          # 单工具 input/output JSON schema + hasCosts + 示例\n```\n\n可选本地 runtime 需要一次性安装:\n\n```bash\ndlazy doctor remotion                # 报 Remotion composer 状态\ndlazy doctor remotion --install      # 约 50s,装 bundled composer\n\ndlazy doctor yt-dlp --install        # 用 video_downloader 拉 YouTube 等需要\ndlazy doctor yt-dlp --install --proxy http://127.0.0.1:1087\n```\n\n部分沙箱通过 `DLAZY_DISABLED_TOOLS=<逗号分隔>` 限制工具面;被禁用的工具不会出现在 `dlazy --help` 里,直接调会返回明确的 `tool_disabled` 错误。\n\n---\n\n## Phase 2 — 调用工具\n\n每个工具都是顶层 subcommand:\n\n```bash\n# 命令行 flag(对应 input schema)\ndlazy gpt-image-2 --prompt \"黄昏中的赛博朋克猫\"\n\n# JSON 输入文件(复杂结构推荐)\ndlazy video_compose --input @work/compose.json --format json\n\n# 干跑校验(不发远程调用,不扣额度)\ndlazy seedance-2-0 --input @plan.json --dry-run\n```\n\n每个工具的 help 是从 schema 生成的:\n\n```bash\ndlazy <工具名> --help\n```\n\n输出模式:\n\n- `--format json`(默认) —— 机读 envelope;用 `jq` 解析\n- `--format url` —— 单一素材产物时,直接给纯 URL\n- `--format text` —— 人读文本载荷\n- `--save <path>` —— 直接把素材下载到本地路径(自动 mkdir + 重试)\n\n---\n\n## Phase 3 — 轮询异步云任务\n\n长任务返回 `generateId` 而非素材:\n\n```bash\ndlazy status <generateId>\ndlazy status <generateId> --format json\n```\n\n反复轮询直到 `succeeded`(payload 里带素材 URL)或 `failed`(带 `error.code` + `error.message`)。\n\n---\n\n## Phase 4 — 常见失败恢复\n\n**`dlazy doctor remotion --install` 在 npm install 阶段失败:**\n- 检查 Node ≥ 18(`node --version`)。\n- 公司代理后面:设 `npm_config_proxy` / `npm_config_https_proxy`。\n\n**`video_downloader` 回复 \"Sign in to confirm you're not a bot\":**\n- YouTube 反爬挑战。input JSON 里加 `\"cookies_from_browser\": \"chrome\"`(或 firefox / safari / edge)。\n\n**`video_compose` 返回 \"render_runtime=hyperframes not yet implemented\":**\n- HyperFrames runtime 还没 ship。把 `edit_decisions.render_runtime` 切成 `remotion` 或 `ffmpeg`,再用 `pre_render_validator` 复检。\n\n**ElevenLabs STT 返回空 `words` 数组:**\n- 显式传 `timestamps_granularity: \"word\"`。\n\n**不知道工具成本就要调:**\n- `dlazy tools describe <名字>` 暴露 `hasCosts` 和成本形态。先把 estimate 写到本地审计日志,再调工具。\n\n**unknown command 提示:**\n- `dlazy <错字>` 返回 `error: unknown command '<typo>'` 加一条编辑距离推荐 \"Did you mean …?\"。先用 `dlazy tools list` 核实再信。\n\n---\n\n## 反模式\n\n- 没用 `dlazy tools list` 核实就调某工具。\n- 凭上次会话记忆写 provider 名,而不重新查注册表(工具会进出)。\n- pipeline 中途悄悄换 render runtime(用 `state_lock_profile` + `post_render_gate` parity 校验去管)。\n- 付费生成前不播报 provider / model / 成本。\n\n---\n\n## 速查卡\n\n```\n安装         npm install -g @dlazy/cli && dlazy auth login\n探测         dlazy tools list  |  dlazy tools describe <名字>\n本地 runtime  dlazy doctor remotion --install   (或 yt-dlp)\n调用         dlazy <工具名> --input @file.json --format json\n干跑         dlazy <工具名> --input @file.json --dry-run\n轮询         dlazy status <generateId>\n帮助         dlazy --help  |  dlazy <工具名> --help\n排障         dlazy doctor <目标>  |  dlazy tools describe <名字>\n```\n\nArchive v2.0.19: 4 files, 8585 bytes\n\nFiles: skill-card.md (2764b), SKILL-cn.md (6464b), SKILL.md (7014b), _meta.json (131b)\n\nFile v2.0.19:SKILL.md\n\n---\nname: dlazy-start\nversion: 2.0.6\ndescription: \"Quickstart for AI orchestrators (Claude Code / Cursor / Codex / Copilot) driving @dlazy/cli. Covers install, auth, capability discovery, invoking cloud + local tools, polling async tasks, and recovering from common failures. AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。\"\ntriggers:\n  - dLazy CLI Quickstart for AI Agents\nmetadata: {\"clawdbot\":{\"emoji\":\"🎬\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli\",\"installAlternative\":\"npx @dlazy/cli\",\"homepage\":\"https://dlazy.com\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"AGPL-3.0-or-later\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"You are operating @dlazy/cli for the user. Discovery first: run `dlazy tools list` to see available tools and `dlazy tools describe <name>` to inspect a tool's input/output schema and cost shape. Invoke with `dlazy <tool-name> --input @file.json` (or `--format json` for machine-readable envelopes). Poll long-running cloud tasks with `dlazy status <generateId>`. Install optional local runtimes with `dlazy doctor remotion --install` or `dlazy doctor yt-dlp --install`. Never claim a tool exists without verifying via `dlazy tools list`.\"}}\n---\n\n# 智能体上手手册 Start\n\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\n\nA minimal contract for AI orchestrators using `@dlazy/cli`. The CLI is a\ntool-dispatch surface: every registered cloud + local tool becomes a top-level\nsubcommand. There is no built-in project workspace or pipeline state machine —\nthose are agent-side concepts.\n\nLicense: AGPL-3.0-or-later.\n\n## What this skill teaches\n\nYou drive `@dlazy/cli` from auth through tool invocation:\n\n- **Cloud tools** (40+) — image / video / audio / text providers (Seedream,\n  Recraft, MJ, Veo, Seedance, Kling, ElevenLabs, …)\n- **Local tools** (40+) — `state_lock_profile`, `video_compose`,\n  `post_render_gate`, `scene_detect`, `frame_sampler`, `audio_mixer`,\n  `audio_probe`, `transcribe`, `subtitle`, `color_grade`, `extract_segment`,\n  `ffmpeg_run`, … (full list via `dlazy tools list`)\n- **CLI commands**: `auth`, `doctor`, `tools list`, `tools describe`,\n  `status`, plus one top-level subcommand per registered tool.\n\n---\n\n## Phase 0 — Install & auth\n\n```bash\n# Install once\nnpm install -g @dlazy/cli\n\n# Authenticate (device-code flow; works in remote shells)\ndlazy auth login\n```\n\nAlternate auth: `dlazy auth set YOUR_API_KEY`, or set the `DLAZY_API_KEY`\nenv var. Config lives at `~/.dlazy/config.json` (Windows:\n`%USERPROFILE%\\.dlazy\\`).\n\nGlobal flags every command accepts: `--api-key`, `--base-url`, `--verbose`,\n`--format <json|url|text>`, `--refresh-manifest`, `-l/--lang <locale>`.\n\n---\n\n## Phase 1 — Discover capabilities\n\n```bash\ndlazy --help                         # top-level command surface\ndlazy tools list                     # registered tools with type + cost shape\ndlazy tools describe <name>          # input/output JSON schema, hasCosts, examples\n```\n\nOptional local runtimes need a one-time install:\n\n```bash\ndlazy doctor remotion                # report Remotion composer state\ndlazy doctor remotion --install      # ~50s, installs the bundled composer\n\ndlazy doctor yt-dlp --install        # for video_downloader on YouTube et al.\ndlazy doctor yt-dlp --install --proxy http://127.0.0.1:1087\n```\n\nSome sandboxes restrict the tool surface via `DLAZY_DISABLED_TOOLS=<csv>`;\ndisabled tools are hidden from `dlazy --help` and refuse invocation with a\nclear `tool_disabled` error.\n\n---\n\n## Phase 2 — Invoke a tool\n\nEvery tool is a top-level subcommand:\n\n```bash\n# Inline flags (mirrors the input schema)\ndlazy gpt-image-2 --prompt \"cyberpunk cat at dusk\"\n\n# JSON input file (preferred for complex shapes)\ndlazy video_compose --input @work/compose.json --format json\n\n# Dry-run for validation only (no remote call, no credit consumption)\ndlazy seedance-2-0 --input @plan.json --dry-run\n```\n\nPer-tool help is generated from the schema:\n\n```bash\ndlazy <tool-name> --help\n```\n\nOutput modes:\n\n- `--format json` (default) — machine-readable envelope; parse with `jq`\n- `--format url` — bare URL when the tool produces a single asset\n- `--format text` — human-readable text payload\n- `--save <path>` — download the asset straight to disk (mkdir + retry handled for you)\n\n---\n\n## Phase 3 — Poll async cloud tasks\n\nLong-running generations return a `generateId` instead of the final asset:\n\n```bash\ndlazy status <generateId>\ndlazy status <generateId> --format json\n```\n\nRepeat until status is `succeeded` (then the asset URL is in the payload) or\n`failed` (with `error.code` + `error.message`).\n\n---\n\n## Phase 4 — Common failure recovery\n\n**`dlazy doctor remotion --install` fails on `npm install`:**\n- Check Node ≥ 18 (`node --version`).\n- Behind a corp proxy: set `npm_config_proxy` / `npm_config_https_proxy`.\n\n**`video_downloader` returns \"Sign in to confirm you're not a bot\":**\n- YouTube anti-bot challenge. Pass `\"cookies_from_browser\": \"chrome\"`\n  (or firefox / safari / edge) in the input JSON.\n\n**`video_compose` returns \"render_runtime=hyperframes not yet implemented\":**\n- HyperFrames runtime not shipped. Switch `edit_decisions.render_runtime` to\n  `remotion` or `ffmpeg`, then re-validate via `pre_render_validator`.\n\n**ElevenLabs STT returns an empty `words` array:**\n- Pass `timestamps_granularity: \"word\"` explicitly.\n\n**Need to know a tool's cost before invoking:**\n- `dlazy tools describe <name>` exposes `hasCosts` and the cost shape. Log\n  the estimate to a local file or your audit log before calling the tool.\n\n**Unknown command suggestion:**\n- `dlazy <typo>` returns `error: unknown command '<typo>'` plus a \"Did you\n  mean …?\" suggestion line based on edit distance. Trust the suggestion only\n  after confirming via `dlazy tools list`.\n\n---\n\n## Anti-patterns\n\n- Calling a tool whose existence you haven't verified via `dlazy tools list`.\n- Memorizing provider names from prior sessions instead of re-checking the\n  registry (tools come and go).\n- Silently swapping render runtime mid-pipeline (govern via `state_lock_profile`\n  + `post_render_gate` parity checks instead).\n- Calling paid generation without announcing provider / model / cost first.\n\n---\n\n## Reference card\n\n```\nINSTALL       npm install -g @dlazy/cli && dlazy auth login\nDISCOVER      dlazy tools list  |  dlazy tools describe <name>\nLOCAL RT      dlazy doctor remotion --install   (or yt-dlp)\nINVOKE        dlazy <tool-name> --input @file.json --format json\nDRY RUN       dlazy <tool-name> --input @file.json --dry-run\nPOLL          dlazy status <generateId>\nHELP          dlazy --help  |  dlazy <tool-name> --help\nRECOVER       dlazy doctor <target>  |  dlazy tools describe <name>\n```\n\nFile v2.0.19:_meta.json\n\n{\n  \"ownerId\": \"kn7c5wgeajfcfvdfb5ceemvdb984cjpd\",\n  \"slug\": \"dlazy-start\",\n  \"version\": \"2.0.19\",\n  \"publishedAt\": 1789868104762\n}\n\nFile v2.0.19:skill-card.md\n\n## Description:\n\nQuickstart for AI orchestrators driving @dlazy/cli through install, authentication, capability discovery, cloud and local tool invocation, async polling, and common failure recovery.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[dlazyai](https://clawhub.ai/user/dlazyai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and AI orchestrator operators use this skill to install and authenticate @dlazy/cli, inspect available tools, invoke cloud and local tools, poll asynchronous jobs, and recover from common CLI failures.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill relies on floating @dlazy/cli installs through npm or npx.\n\nMitigation: Prefer pinned package versions and review package changes before use.\n\nRisk: The CLI can use API keys and stores configuration under the user's home directory.\n\nMitigation: Keep API keys out of logs and chat transcripts, and use environment or config handling appropriate for the workspace.\n\nRisk: The CLI calls external dlazy network services and may invoke paid generation tools.\n\nMitigation: Trust the service before installing, inspect tool cost information with dlazy tools describe, and announce provider, model, and cost before paid calls.\n\nRisk: The --save option writes generated or downloaded assets to local paths.\n\nMitigation: Verify save destinations before execution to avoid overwriting or placing files in unintended locations.\n\nRisk: Browser-cookie use can expose a signed-in browser session to a downloader workflow.\n\nMitigation: Allow cookies_from_browser only when the user explicitly intends that site-specific signed-in session to be used.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/dlazyai/skills/dlazy-start)\n- [dlazy publisher profile](https://clawhub.ai/user/dlazyai)\n- [dLazy homepage](https://dlazy.com)\n- [@dlazy/cli npm package](https://www.npmjs.com/package/@dlazy/cli)\n- [@dlazy/cli source metadata link](https://github.com/dlazy-ai/cli)\n\n## Skill Output:\n\n**Output Type(s):** [Guidance, Markdown, Shell commands, Configuration]\n\n**Output Format:** [Markdown guidance with inline shell commands and JSON-oriented CLI usage patterns]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Guides the agent to verify available tools with dlazy tools list and dlazy tools describe before invoking commands.]\n\n## Skill Version(s):\n\n2.0.19 (source: server release evidence, created 2026-09-20)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v2.0.19:SKILL-cn.md\n\n---\nname: dlazy-start\nversion: 2.0.6\ndescription: \"AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。\"\ntriggers:\n  - dLazy CLI 智能体上手手册\nmetadata: {\"clawdbot\":{\"emoji\":\"🎬\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli\",\"installAlternative\":\"npx @dlazy/cli\",\"homepage\":\"https://dlazy.com\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"AGPL-3.0-or-later\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"你正在为用户操作 @dlazy/cli。先探测:跑 `dlazy tools list` 看可用工具,`dlazy tools describe <名字>` 看单工具的 input/output schema 和成本。调用形态:`dlazy <工具名> --input @file.json`(或加 `--format json` 拿机读 envelope)。异步任务用 `dlazy status <generateId>` 轮询。需要本地 runtime 时跑 `dlazy doctor remotion --install` 或 `dlazy doctor yt-dlp --install`。在没用 `dlazy tools list` 核实之前,绝不声称某工具存在。\"}}\n---\n\n# 智能体上手手册 Start\n\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\n\n给 AI 编排器(Claude Code / Cursor / Codex / Copilot)用的最小契约。CLI 本质是一个工具分发壳:每个注册的云端/本地工具都会变成顶层 subcommand。CLI 不内置项目工作目录或 pipeline 状态机 —— 那些是上层 agent 的概念。\n\nLicense: AGPL-3.0-or-later。\n\n## 本 skill 教什么\n\n你从鉴权一路驱动 `@dlazy/cli` 到工具调用:\n\n- **云端工具**(40+) —— 图像 / 视频 / 音频 / 文本服务(Seedream / Recraft / MJ / Veo / Seedance / Kling / ElevenLabs / …)\n- **本地工具**(40+) —— `state_lock_profile`、`video_compose`、`post_render_gate`、`scene_detect`、`frame_sampler`、`audio_mixer`、`audio_probe`、`transcribe`、`subtitle`、`color_grade`、`extract_segment`、`ffmpeg_run`、…(完整列表跑 `dlazy tools list`)\n- **CLI 命令**: `auth`、`doctor`、`tools list`、`tools describe`、`status`,再加上每个注册工具对应的一个顶层 subcommand。\n\n---\n\n## Phase 0 — 安装与鉴权\n\n```bash\n# 一次性安装\nnpm install -g @dlazy/cli\n\n# 登录(设备码流程;远程终端也可用)\ndlazy auth login\n```\n\n备选鉴权:`dlazy auth set YOUR_API_KEY`,或设 `DLAZY_API_KEY` 环境变量。配置存在 `~/.dlazy/config.json`(Windows:`%USERPROFILE%\\.dlazy\\`)。\n\n所有命令都接受的全局 flag:`--api-key`、`--base-url`、`--verbose`、`--format <json|url|text>`、`--refresh-manifest`、`-l/--lang <locale>`。\n\n---\n\n## Phase 1 — 能力探测\n\n```bash\ndlazy --help                         # 顶层命令面\ndlazy tools list                     # 注册工具列表 + 类型 + 成本形态\ndlazy tools describe <名字>          # 单工具 input/output JSON schema + hasCosts + 示例\n```\n\n可选本地 runtime 需要一次性安装:\n\n```bash\ndlazy doctor remotion                # 报 Remotion composer 状态\ndlazy doctor remotion --install      # 约 50s,装 bundled composer\n\ndlazy doctor yt-dlp --install        # 用 video_downloader 拉 YouTube 等需要\ndlazy doctor yt-dlp --install --proxy http://127.0.0.1:1087\n```\n\n部分沙箱通过 `DLAZY_DISABLED_TOOLS=<逗号分隔>` 限制工具面;被禁用的工具不会出现在 `dlazy --help` 里,直接调会返回明确的 `tool_disabled` 错误。\n\n---\n\n## Phase 2 — 调用工具\n\n每个工具都是顶层 subcommand:\n\n```bash\n# 命令行 flag(对应 input schema)\ndlazy gpt-image-2 --prompt \"黄昏中的赛博朋克猫\"\n\n# JSON 输入文件(复杂结构推荐)\ndlazy video_compose --input @work/compose.json --format json\n\n# 干跑校验(不发远程调用,不扣额度)\ndlazy seedance-2-0 --input @plan.json --dry-run\n```\n\n每个工具的 help 是从 schema 生成的:\n\n```bash\ndlazy <工具名> --help\n```\n\n输出模式:\n\n- `--format json`(默认) —— 机读 envelope;用 `jq` 解析\n- `--format url` —— 单一素材产物时,直接给纯 URL\n- `--format text` —— 人读文本载荷\n- `--save <path>` —— 直接把素材下载到本地路径(自动 mkdir + 重试)\n\n---\n\n## Phase 3 — 轮询异步云任务\n\n长任务返回 `generateId` 而非素材:\n\n```bash\ndlazy status <generateId>\ndlazy status <generateId> --format json\n```\n\n反复轮询直到 `succeeded`(payload 里带素材 URL)或 `failed`(带 `error.code` + `error.message`)。\n\n---\n\n## Phase 4 — 常见失败恢复\n\n**`dlazy doctor remotion --install` 在 npm install 阶段失败:**\n- 检查 Node ≥ 18(`node --version`)。\n- 公司代理后面:设 `npm_config_proxy` / `npm_config_https_proxy`。\n\n**`video_downloader` 回复 \"Sign in to confirm you're not a bot\":**\n- YouTube 反爬挑战。input JSON 里加 `\"cookies_from_browser\": \"chrome\"`(或 firefox / safari / edge)。\n\n**`video_compose` 返回 \"render_runtime=hyperframes not yet implemented\":**\n- HyperFrames runtime 还没 ship。把 `edit_decisions.render_runtime` 切成 `remotion` 或 `ffmpeg`,再用 `pre_render_validator` 复检。\n\n**ElevenLabs STT 返回空 `words` 数组:**\n- 显式传 `timestamps_granularity: \"word\"`。\n\n**不知道工具成本就要调:**\n- `dlazy tools describe <名字>` 暴露 `hasCosts` 和成本形态。先把 estimate 写到本地审计日志,再调工具。\n\n**unknown command 提示:**\n- `dlazy <错字>` 返回 `error: unknown command '<typo>'` 加一条编辑距离推荐 \"Did you mean …?\"。先用 `dlazy tools list` 核实再信。\n\n---\n\n## 反模式\n\n- 没用 `dlazy tools list` 核实就调某工具。\n- 凭上次会话记忆写 provider 名,而不重新查注册表(工具会进出)。\n- pipeline 中途悄悄换 render runtime(用 `state_lock_profile` + `post_render_gate` parity 校验去管)。\n- 付费生成前不播报 provider / model / 成本。\n\n---\n\n## 速查卡\n\n```\n安装         npm install -g @dlazy/cli && dlazy auth login\n探测         dlazy tools list  |  dlazy tools describe <名字>\n本地 runtime  dlazy doctor remotion --install   (或 yt-dlp)\n调用         dlazy <工具名> --input @file.json --format json\n干跑         dlazy <工具名> --input @file.json --dry-run\n轮询         dlazy status <generateId>\n帮助         dlazy --help  |  dlazy <工具名> --help\n排障         dlazy doctor <目标>  |  dlazy tools describe <名字>\n```\n\nArchive v2.0.18: 4 files, 8363 bytes\n\nFiles: skill-card.md (2144b), SKILL-cn.md (6464b), SKILL.md (7014b), _meta.json (131b)\n\nFile v2.0.18:SKILL.md\n\n---\nname: dlazy-start\nversion: 2.0.6\ndescription: \"Quickstart for AI orchestrators (Claude Code / Cursor / Codex / Copilot) driving @dlazy/cli. Covers install, auth, capability discovery, invoking cloud + local tools, polling async tasks, and recovering from common failures. AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。\"\ntriggers:\n  - dLazy CLI Quickstart for AI Agents\nmetadata: {\"clawdbot\":{\"emoji\":\"🎬\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli\",\"installAlternative\":\"npx @dlazy/cli\",\"homepage\":\"https://dlazy.com\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"AGPL-3.0-or-later\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"You are operating @dlazy/cli for the user. Discovery first: run `dlazy tools list` to see available tools and `dlazy tools describe <name>` to inspect a tool's input/output schema and cost shape. Invoke with `dlazy <tool-name> --input @file.json` (or `--format json` for machine-readable envelopes). Poll long-running cloud tasks with `dlazy status <generateId>`. Install optional local runtimes with `dlazy doctor remotion --install` or `dlazy doctor yt-dlp --install`. Never claim a tool exists without verifying via `dlazy tools list`.\"}}\n---\n\n# 智能体上手手册 Start\n\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\n\nA minimal contract for AI orchestrators using `@dlazy/cli`. The CLI is a\ntool-dispatch surface: every registered cloud + local tool becomes a top-level\nsubcommand. There is no built-in project workspace or pipeline state machine —\nthose are agent-side concepts.\n\nLicense: AGPL-3.0-or-later.\n\n## What this skill teaches\n\nYou drive `@dlazy/cli` from auth through tool invocation:\n\n- **Cloud tools** (40+) — image / video / audio / text providers (Seedream,\n  Recraft, MJ, Veo, Seedance, Kling, ElevenLabs, …)\n- **Local tools** (40+) — `state_lock_profile`, `video_compose`,\n  `post_render_gate`, `scene_detect`, `frame_sampler`, `audio_mixer`,\n  `audio_probe`, `transcribe`, `subtitle`, `color_grade`, `extract_segment`,\n  `ffmpeg_run`, … (full list via `dlazy tools list`)\n- **CLI commands**: `auth`, `doctor`, `tools list`, `tools describe`,\n  `status`, plus one top-level subcommand per registered tool.\n\n---\n\n## Phase 0 — Install & auth\n\n```bash\n# Install once\nnpm install -g @dlazy/cli\n\n# Authenticate (device-code flow; works in remote shells)\ndlazy auth login\n```\n\nAlternate auth: `dlazy auth set YOUR_API_KEY`, or set the `DLAZY_API_KEY`\nenv var. Config lives at `~/.dlazy/config.json` (Windows:\n`%USERPROFILE%\\.dlazy\\`).\n\nGlobal flags every command accepts: `--api-key`, `--base-url`, `--verbose`,\n`--format <json|url|text>`, `--refresh-manifest`, `-l/--lang <locale>`.\n\n---\n\n## Phase 1 — Discover capabilities\n\n```bash\ndlazy --help                         # top-level command surface\ndlazy tools list                     # registered tools with type + cost shape\ndlazy tools describe <name>          # input/output JSON schema, hasCosts, examples\n```\n\nOptional local runtimes need a one-time install:\n\n```bash\ndlazy doctor remotion                # report Remotion composer state\ndlazy doctor remotion --install      # ~50s, installs the bundled composer\n\ndlazy doctor yt-dlp --install        # for video_downloader on YouTube et al.\ndlazy doctor yt-dlp --install --proxy http://127.0.0.1:1087\n```\n\nSome sandboxes restrict the tool surface via `DLAZY_DISABLED_TOOLS=<csv>`;\ndisabled tools are hidden from `dlazy --help` and refuse invocation with a\nclear `tool_disabled` error.\n\n---\n\n## Phase 2 — Invoke a tool\n\nEvery tool is a top-level subcommand:\n\n```bash\n# Inline flags (mirrors the input schema)\ndlazy gpt-image-2 --prompt \"cyberpunk cat at dusk\"\n\n# JSON input file (preferred for complex shapes)\ndlazy video_compose --input @work/compose.json --format json\n\n# Dry-run for validation only (no remote call, no credit consumption)\ndlazy seedance-2-0 --input @plan.json --dry-run\n```\n\nPer-tool help is generated from the schema:\n\n```bash\ndlazy <tool-name> --help\n```\n\nOutput modes:\n\n- `--format json` (default) — machine-readable envelope; parse with `jq`\n- `--format url` — bare URL when the tool produces a single asset\n- `--format text` — human-readable text payload\n- `--save <path>` — download the asset straight to disk (mkdir + retry handled for you)\n\n---\n\n## Phase 3 — Poll async cloud tasks\n\nLong-running generations return a `generateId` instead of the final asset:\n\n```bash\ndlazy status <generateId>\ndlazy status <generateId> --format json\n```\n\nRepeat until status is `succeeded` (then the asset URL is in the payload) or\n`failed` (with `error.code` + `error.message`).\n\n---\n\n## Phase 4 — Common failure recovery\n\n**`dlazy doctor remotion --install` fails on `npm install`:**\n- Check Node ≥ 18 (`node --version`).\n- Behind a corp proxy: set `npm_config_proxy` / `npm_config_https_proxy`.\n\n**`video_downloader` returns \"Sign in to confirm you're not a bot\":**\n- YouTube anti-bot challenge. Pass `\"cookies_from_browser\": \"chrome\"`\n  (or firefox / safari / edge) in the input JSON.\n\n**`video_compose` returns \"render_runtime=hyperframes not yet implemented\":**\n- HyperFrames runtime not shipped. Switch `edit_decisions.render_runtime` to\n  `remotion` or `ffmpeg`, then re-validate via `pre_render_validator`.\n\n**ElevenLabs STT returns an empty `words` array:**\n- Pass `timestamps_granularity: \"word\"` explicitly.\n\n**Need to know a tool's cost before invoking:**\n- `dlazy tools describe <name>` exposes `hasCosts` and the cost shape. Log\n  the estimate to a local file or your audit log before calling the tool.\n\n**Unknown command suggestion:**\n- `dlazy <typo>` returns `error: unknown command '<typo>'` plus a \"Did you\n  mean …?\" suggestion line based on edit distance. Trust the suggestion only\n  after confirming via `dlazy tools list`.\n\n---\n\n## Anti-patterns\n\n- Calling a tool whose existence you haven't verified via `dlazy tools list`.\n- Memorizing provider names from prior sessions instead of re-checking the\n  registry (tools come and go).\n- Silently swapping render runtime mid-pipeline (govern via `state_lock_profile`\n  + `post_render_gate` parity checks instead).\n- Calling paid generation without announcing provider / model / cost first.\n\n---\n\n## Reference card\n\n```\nINSTALL       npm install -g @dlazy/cli && dlazy auth login\nDISCOVER      dlazy tools list  |  dlazy tools describe <name>\nLOCAL RT      dlazy doctor remotion --install   (or yt-dlp)\nINVOKE        dlazy <tool-name> --input @file.json --format json\nDRY RUN       dlazy <tool-name> --input @file.json --dry-run\nPOLL          dlazy status <generateId>\nHELP          dlazy --help  |  dlazy <tool-name> --help\nRECOVER       dlazy doctor <target>  |  dlazy tools describe <name>\n```\n\nFile v2.0.18:_meta.json\n\n{\n  \"ownerId\": \"kn7c5wgeajfcfvdfb5ceemvdb984cjpd\",\n  \"slug\": \"dlazy-start\",\n  \"version\": \"2.0.18\",\n  \"publishedAt\": 1789696623448\n}\n\nFile v2.0.18:skill-card.md\n\n## Description:\n\nQuickstart for AI orchestrators driving @dlazy/cli, covering install, authentication, capability discovery, tool invocation, async polling, and common recovery paths.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[dlazyai](https://clawhub.ai/user/dlazyai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and agent operators use this skill to install, authenticate, discover, invoke, and troubleshoot @dlazy/cli tools from AI coding assistants such as Claude Code, Cursor, Codex, and Copilot.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The dLazy CLI can exercise broad media-tool authority, network access, and persistent authentication.\n\nMitigation: Install and run it only in trusted environments, review tool schemas and costs before invocation, and scope API keys or configuration to the minimum needed workflow.\n\nRisk: Using cookies_from_browser can expose browser cookies that act like logged-in sessions.\n\nMitigation: Use browser cookies only with explicit intent for the minimum necessary site or account, and avoid sharing logs, prompts, or input files that may contain session material.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/dlazyai/skills/dlazy-start)\n- [dLazy homepage](https://dlazy.com)\n- [@dlazy/cli npm package](https://www.npmjs.com/package/@dlazy/cli)\n- [dLazy CLI source](https://github.com/dlazy-ai/cli)\n\n## Skill Output:\n\n**Output Type(s):** [guidance, markdown, shell commands, configuration]\n\n**Output Format:** [Markdown with inline bash command examples and JSON input references]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Agent-facing quickstart guidance for operating @dlazy/cli; invoked tools may return JSON, URLs, text, or saved files.]\n\n## Skill Version(s):\n\n2.0.18 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v2.0.18:SKILL-cn.md\n\n---\nname: dlazy-start\nversion: 2.0.6\ndescription: \"AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。\"\ntriggers:\n  - dLazy CLI 智能体上手手册\nmetadata: {\"clawdbot\":{\"emoji\":\"🎬\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli\",\"installAlternative\":\"npx @dlazy/cli\",\"homepage\":\"https://dlazy.com\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"AGPL-3.0-or-later\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"你正在为用户操作 @dlazy/cli。先探测:跑 `dlazy tools list` 看可用工具,`dlazy tools describe <名字>` 看单工具的 input/output schema 和成本。调用形态:`dlazy <工具名> --input @file.json`(或加 `--format json` 拿机读 envelope)。异步任务用 `dlazy status <generateId>` 轮询。需要本地 runtime 时跑 `dlazy doctor remotion --install` 或 `dlazy doctor yt-dlp --install`。在没用 `dlazy tools list` 核实之前,绝不声称某工具存在。\"}}\n---\n\n# 智能体上手手册 Start\n\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\n\n给 AI 编排器(Claude Code / Cursor / Codex / Copilot)用的最小契约。CLI 本质是一个工具分发壳:每个注册的云端/本地工具都会变成顶层 subcommand。CLI 不内置项目工作目录或 pipeline 状态机 —— 那些是上层 agent 的概念。\n\nLicense: AGPL-3.0-or-later。\n\n## 本 skill 教什么\n\n你从鉴权一路驱动 `@dlazy/cli` 到工具调用:\n\n- **云端工具**(40+) —— 图像 / 视频 / 音频 / 文本服务(Seedream / Recraft / MJ / Veo / Seedance / Kling / ElevenLabs / …)\n- **本地工具**(40+) —— `state_lock_profile`、`video_compose`、`post_render_gate`、`scene_detect`、`frame_sampler`、`audio_mixer`、`audio_probe`、`transcribe`、`subtitle`、`color_grade`、`extract_segment`、`ffmpeg_run`、…(完整列表跑 `dlazy tools list`)\n- **CLI 命令**: `auth`、`doctor`、`tools list`、`tools describe`、`status`,再加上每个注册工具对应的一个顶层 subcommand。\n\n---\n\n## Phase 0 — 安装与鉴权\n\n```bash\n# 一次性安装\nnpm install -g @dlazy/cli\n\n# 登录(设备码流程;远程终端也可用)\ndlazy auth login\n```\n\n备选鉴权:`dlazy auth set YOUR_API_KEY`,或设 `DLAZY_API_KEY` 环境变量。配置存在 `~/.dlazy/config.json`(Windows:`%USERPROFILE%\\.dlazy\\`)。\n\n所有命令都接受的全局 flag:`--api-key`、`--base-url`、`--verbose`、`--format <json|url|text>`、`--refresh-manifest`、`-l/--lang <locale>`。\n\n---\n\n## Phase 1 — 能力探测\n\n```bash\ndlazy --help                         # 顶层命令面\ndlazy tools list                     # 注册工具列表 + 类型 + 成本形态\ndlazy tools describe <名字>          # 单工具 input/output JSON schema + hasCosts + 示例\n```\n\n可选本地 runtime 需要一次性安装:\n\n```bash\ndlazy doctor remotion                # 报 Remotion composer 状态\ndlazy doctor remotion --install      # 约 50s,装 bundled composer\n\ndlazy doctor yt-dlp --install        # 用 video_downloader 拉 YouTube 等需要\ndlazy doctor yt-dlp --install --proxy http://127.0.0.1:1087\n```\n\n部分沙箱通过 `DLAZY_DISABLED_TOOLS=<逗号分隔>` 限制工具面;被禁用的工具不会出现在 `dlazy --help` 里,直接调会返回明确的 `tool_disabled` 错误。\n\n---\n\n## Phase 2 — 调用工具\n\n每个工具都是顶层 subcommand:\n\n```bash\n# 命令行 flag(对应 input schema)\ndlazy gpt-image-2 --prompt \"黄昏中的赛博朋克猫\"\n\n# JSON 输入文件(复杂结构推荐)\ndlazy video_compose --input @work/compose.json --format json\n\n# 干跑校验(不发远程调用,不扣额度)\ndlazy seedance-2-0 --input @plan.json --dry-run\n```\n\n每个工具的 help 是从 schema 生成的:\n\n```bash\ndlazy <工具名> --help\n```\n\n输出模式:\n\n- `--format json`(默认) —— 机读 envelope;用 `jq` 解析\n- `--format url` —— 单一素材产物时,直接给纯 URL\n- `--format text` —— 人读文本载荷\n- `--save <path>` —— 直接把素材下载到本地路径(自动 mkdir + 重试)\n\n---\n\n## Phase 3 — 轮询异步云任务\n\n长任务返回 `generateId` 而非素材:\n\n```bash\ndlazy status <generateId>\ndlazy status <generateId> --format json\n```\n\n反复轮询直到 `succeeded`(payload 里带素材 URL)或 `failed`(带 `error.code` + `error.message`)。\n\n---\n\n## Phase 4 — 常见失败恢复\n\n**`dlazy doctor remotion --install` 在 npm install 阶段失败:**\n- 检查 Node ≥ 18(`node --version`)。\n- 公司代理后面:设","readmeExcerpt":"Skill: 智能体上手手册 Start Owner: dlazyai Summary: Quickstart for AI orchestrators (Claude Code / Cursor / Codex / Copilot) driving @dlazy/cli. Covers install, auth, capability discovery, invoking cloud + local tools, polling async tasks, and recovering from common failures. AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。 Tags: latest:2.0.27 Version history: v2.0.","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"# Install once\nnpm install -g @dlazy/cli\n\n# Authenticate (device-code flow; works in remote shells)\ndlazy auth login"},{"language":"bash","snippet":"dlazy --help                         # top-level command surface\ndlazy tools list                     # registered tools with type + cost shape\ndlazy tools describe <name>          # input/output JSON schema, hasCosts, examples"},{"language":"bash","snippet":"dlazy doctor remotion                # report Remotion composer state\ndlazy doctor remotion --install      # ~50s, installs the bundled composer\n\ndlazy doctor yt-dlp --install        # for video_downloader on YouTube et al.\ndlazy doctor yt-dlp --install --proxy http://127.0.0.1:1087"},{"language":"bash","snippet":"# Inline flags (mirrors the input schema)\ndlazy gpt-image-2 --prompt \"cyberpunk cat at dusk\"\n\n# JSON input file (preferred for complex shapes)\ndlazy video_compose --input @work/compose.json --format json\n\n# Dry-run for validation only (no remote call, no credit consumption)\ndlazy seedance-2-0 --input @plan.json --dry-run"},{"language":"bash","snippet":"dlazy <tool-name> --help"},{"language":"bash","snippet":"dlazy status <generateId>\ndlazy status <generateId> --format json"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: dlazy-start\nversion: 2.0.6\ndescription: \"Quickstart for AI orchestrators (Claude Code / Cursor / Codex / Copilot) driving @dlazy/cli. Covers install, auth, capability discovery, invoking cloud + local tools, polling async tasks, and recovering from common failures. AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。\"\ntriggers:\n  - dLazy CLI Quickstart for AI Agents\nmetadata: {\"clawdbot\":{\"emoji\":\"🎬\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli\",\"installAlternative\":\"npx @dlazy/cli\",\"homepage\":\"https://dlazy.com\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"AGPL-3.0-or-later\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"You are operating @dlazy/cli for the user. Discovery first: run `dlazy tools list` to see available tools and `dlazy tools describe <name>` to inspect a tool's input/output schema and cost shape. Invoke with `dlazy <tool-name> --input @file.json` (or `--format json` for machine-readable envelopes). Poll long-running cloud tasks with `dlazy status <generateId>`. Install optional local runtimes with `dlazy doctor remotion --install` or `dlazy doctor yt-dlp --install`. Never claim a tool exists without verifying via `dlazy tools list`.\"}}\n---\n\n# 智能体上手手册 Start\n\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\n\nA minimal contract for AI orchestrators using `@dlazy/cli`. The CLI is a\ntool-dispatch surface: every registered cloud + local tool becomes a top-level\nsubcommand. There is no built-in project workspace or pipeline state machine —\nthose are agent-side concepts.\n\nLicense: AGPL-3.0-or-later.\n\n## What this skill teaches\n\nYou drive `@dlazy/cli` from auth through tool invocation:\n\n- **Cloud tools** (40+) — image / video / audio / text providers (Seedream,\n  Recraft, MJ, Veo, Seedance, Kling, ElevenLabs, …)\n- **Local tools** (40+) — `state_lock_profile`, `video_compose`,\n  `post_render_gate`, `scene_detect`, `frame_sampler`, `audio_mixer`,\n  `audio_probe`, `transcribe`, `subtitle`, `color_grade`, `extract_segment`,\n  `ffmpeg_run`, … (full list via `dlazy tools list`)\n- **CLI commands**: `auth`, `doctor`, `tools list`, `tools describe`,\n  `status`, plus one top-level subcommand per registered tool.\n\n---\n\n## Phase 0 — Install & auth\n\n```bash\n# Install once\nnpm install -g @dlazy/cli\n\n# Authenticate (device-code flow; works in remote shells)\ndlazy auth login\n```\n\nAlternate auth: `dlazy auth set YOUR_API_KEY`, or set the `DLAZY_API_KEY`\nenv var. Config lives at `~/.dlazy/config.json` (Windows:\n`%USERPROFILE%\\.dlazy\\`).\n\nGlobal flags every command accepts: `--api-key`, `--base-url`, `--verbose`,\n`--format <json|url|text>`, `--refresh-manifest`, `-l/--lang <locale>`.\n\n---\n\n## Phase 1 — Discover capabilities\n\n```bash\ndlazy --help                         # top-level command surface\ndlazy tools list           "},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7c5wgeajfcfvdfb5ceemvdb984cjpd\",\n  \"slug\": \"dlazy-start\",\n  \"version\": \"2.0.27\",\n  \"publishedAt\": 1791423028614\n}"},{"path":"skill-card.md","content":"## Description:\n\nA quickstart for AI agents using the dLazy CLI to discover and run cloud and local media tools, authenticate, and monitor long-running tasks.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[dlazyai](https://clawhub.ai/user/dlazyai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and AI-agent users follow this quickstart to install and authenticate the dLazy CLI, inspect available tools and their costs, invoke media tools, and troubleshoot asynchronous tasks.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Installing the CLI or optional runtimes executes third-party packages in the local environment.\n\nMitigation: Install only from trusted sources, and pin or preinstall dependencies in controlled environments.\n\nRisk: API keys or browser cookies could expose credentials and active browser sessions.\n\nMitigation: Prefer device-code login over command-line keys; allow browser-cookie access only when explicitly intended for the target service.\n\nRisk: Cloud tool calls may consume paid credits or access remote media services.\n\nMitigation: Inspect the tool and its cost before invocation; use dry runs where available.\n\n## Reference(s):\n\n- [ClawHub skill listing](https://clawhub.ai/dlazyai/skills/dlazy-start)\n- [dLazy website](https://dlazy.com)\n- [dLazy CLI npm package](https://www.npmjs.com/package/@dlazy/cli)\n- [dLazy CLI repository (listed in skill metadata)](https://github.com/dlazy-ai/cli)\n\n## Skill Output:\n\n**Output Type(s):** [Guidance, Shell commands, Configuration instructions]\n\n**Output Format:** [Markdown with shell commands and JSON examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Tool responses may include JSON results or media URLs; long-running tasks require status polling.]\n\n## Skill Version(s):\n\n2.0.27 (source: ClawHub release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."},{"path":"SKILL-cn.md","content":"---\nname: dlazy-start\nversion: 2.0.6\ndescription: \"AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。\"\ntriggers:\n  - dLazy CLI 智能体上手手册\nmetadata: {\"clawdbot\":{\"emoji\":\"🎬\",\"requires\":{\"bins\":[\"npm\",\"npx\"]},\"install\":\"npm install -g @dlazy/cli\",\"installAlternative\":\"npx @dlazy/cli\",\"homepage\":\"https://dlazy.com\",\"source\":\"https://github.com/dlazy-ai/cli\",\"author\":\"dlazyai\",\"license\":\"AGPL-3.0-or-later\",\"npm\":\"https://www.npmjs.com/package/@dlazy/cli\",\"configLocation\":\"~/.dlazy/config.json\",\"apiEndpoints\":[\"api.dlazy.com\",\"files.dlazy.com\"]},\"openclaw\":{\"systemPrompt\":\"你正在为用户操作 @dlazy/cli。先探测:跑 `dlazy tools list` 看可用工具,`dlazy tools describe <名字>` 看单工具的 input/output schema 和成本。调用形态:`dlazy <工具名> --input @file.json`(或加 `--format json` 拿机读 envelope)。异步任务用 `dlazy status <generateId>` 轮询。需要本地 runtime 时跑 `dlazy doctor remotion --install` 或 `dlazy doctor yt-dlp --install`。在没用 `dlazy tools list` 核实之前,绝不声称某工具存在。\"}}\n---\n\n# 智能体上手手册 Start\n\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\n\n给 AI 编排器(Claude Code / Cursor / Codex / Copilot)用的最小契约。CLI 本质是一个工具分发壳:每个注册的云端/本地工具都会变成顶层 subcommand。CLI 不内置项目工作目录或 pipeline 状态机 —— 那些是上层 agent 的概念。\n\nLicense: AGPL-3.0-or-later。\n\n## 本 skill 教什么\n\n你从鉴权一路驱动 `@dlazy/cli` 到工具调用:\n\n- **云端工具**(40+) —— 图像 / 视频 / 音频 / 文本服务(Seedream / Recraft / MJ / Veo / Seedance / Kling / ElevenLabs / …)\n- **本地工具**(40+) —— `state_lock_profile`、`video_compose`、`post_render_gate`、`scene_detect`、`frame_sampler`、`audio_mixer`、`audio_probe`、`transcribe`、`subtitle`、`color_grade`、`extract_segment`、`ffmpeg_run`、…(完整列表跑 `dlazy tools list`)\n- **CLI 命令**: `auth`、`doctor`、`tools list`、`tools describe`、`status`,再加上每个注册工具对应的一个顶层 subcommand。\n\n---\n\n## Phase 0 — 安装与鉴权\n\n```bash\n# 一次性安装\nnpm install -g @dlazy/cli\n\n# 登录(设备码流程;远程终端也可用)\ndlazy auth login\n```\n\n备选鉴权:`dlazy auth set YOUR_API_KEY`,或设 `DLAZY_API_KEY` 环境变量。配置存在 `~/.dlazy/config.json`(Windows:`%USERPROFILE%\\.dlazy\\`)。\n\n所有命令都接受的全局 flag:`--api-key`、`--base-url`、`--verbose`、`--format <json|url|text>`、`--refresh-manifest`、`-l/--lang <locale>`。\n\n---\n\n## Phase 1 — 能力探测\n\n```bash\ndlazy --help                         # 顶层命令面\ndlazy tools list                     # 注册工具列表 + 类型 + 成本形态\ndlazy tools describe <名字>          # 单工具 input/output JSON schema + hasCosts + 示例\n```\n\n可选本地 runtime 需要一次性安装:\n\n```bash\ndlazy doctor remotion                # 报 Remotion composer 状态\ndlazy doctor remotion --install      # 约 50s,装 bundled composer\n\ndlazy doctor yt-dlp --install        # 用 video_downloader 拉 YouTube 等需要\ndlazy doctor yt-dlp --install --proxy http://127.0.0.1:1087\n```\n\n部分沙箱通过 `DLAZY_DISABLED_TOOLS=<逗号分隔>` 限制工具面;被禁用的工具不会出现在 `dlazy --help` 里,直接调会返回明确的 `tool_disabled` 错误。\n\n---\n\n## Phase 2 — 调用工具\n\n每个工具都是顶层 subcommand:\n\n```bash\n# 命令行 flag(对应 input schema)\ndlazy gpt-image-2 --prompt \"黄昏中的赛博朋克猫\"\n\n# JSON 输入文件(复杂结构推荐)\ndlazy video_compose --input @work/compose.json --format json\n\n# 干跑校验(不发远程调用,不扣额度)\ndlazy seedance-2-0 --input @plan.json --dry-run\n```\n\n每个工具的 help 是从 schema 生成的:\n\n```bash\ndlazy <工具名> "}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"Quickstart for AI orchestrators (Claude Code / Cursor / Codex / Copilot) driving @dlazy/cli. Covers install, auth, capability discovery, invoking cloud + local tools, polling async tasks, and recovering from common failures. AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。 Skill: 智能体上手手册 Start Owner: dlazyai Summary: Quickstart for AI orchestrators (Claude Code / Cursor / Codex / Copilot) driving @dlazy/cli. Covers install, auth, capability discovery, invoking cloud + local tools, polling async tasks, and recovering from common failures. AI 编排器（Claude Code / Cursor / Codex / Copilot）驱动 @dlazy/cli 的快速上手手册。覆盖安装、鉴权、能力探测、调用云端/本地工具、轮询异步任务,以及常见故障恢复。 Tags: latest:2.0.27 Version history: v2.0.","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":853,"uniquenessScore":55,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T10:19:28.947Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-09T10:19:28.947Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T21:36:12.242Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"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!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"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","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}