bailian-cli 1.0.0-beta.0 → 1.0.1

package/skill/reference/memory.md

@@ -0,0 +1,195 @@
+# `bl memory` commands
+
+> Auto-generated from `packages/cli/src/commands/catalog.ts`. Do not edit by hand.
+> Regenerate: `pnpm --filter bailian-cli run generate:reference` (runs automatically on `build`).
+
+Index: [index.md](index.md)
+
+## Commands in this group
+
+| Command | Description |
+| --- | --- |
+| `bl memory add` | Add memory from messages or custom content |
+| `bl memory delete` | Delete a memory node |
+| `bl memory list` | List memory nodes for a user |
+| `bl memory profile create` | Create a user profile schema for memory profiling |
+| `bl memory profile get` | Get user profile by schema ID and user ID |
+| `bl memory search` | Search memory nodes by query or messages |
+| `bl memory update` | Update a memory node content |
+
+## Command details
+
+### `bl memory add`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `memory add` |
+| **Description** | Add memory from messages or custom content |
+| **Usage** | `bl memory add --user-id <id> [--messages <json>] [--content <text>] [flags]` |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--user-id <id>` | string | yes | User ID (required) |
+| `--messages <json>` | string | no | Messages JSON array: [{"role":"user","content":"..."},...] |
+| `--content <text>` | string | no | Custom content text to memorize |
+| `--profile-schema <id>` | string | no | Profile schema ID for user profiling |
+| `--memory-library-id <id>` | string | no | Memory library ID (isolate memory space) |
+
+#### Examples
+
+```bash
+bl memory add --user-id user1 --content "用户喜欢Python编程"
+```
+
+```bash
+bl memory add --user-id user1 --messages '[{"role":"user","content":"我喜欢旅行"}]'
+```
+
+```bash
+bl memory add --user-id user1 --content "住在北京" --profile-schema schema_xxx
+```
+
+### `bl memory delete`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `memory delete` |
+| **Description** | Delete a memory node |
+| **Usage** | `bl memory delete --node-id <id> --user-id <id>` |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--node-id <id>` | string | yes | Memory node ID (required) |
+| `--user-id <id>` | string | yes | User ID (required) |
+| `--memory-library-id <id>` | string | no | Memory library ID (non-default library) |
+
+#### Examples
+
+```bash
+bl memory delete --node-id node_xxx --user-id user1
+```
+
+### `bl memory list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `memory list` |
+| **Description** | List memory nodes for a user |
+| **Usage** | `bl memory list --user-id <id> [flags]` |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--user-id <id>` | string | yes | User ID (required) |
+| `--page-size <n>` | number | no | Results per page (default: 10) |
+| `--page <n>` | number | no | Page number (default: 1) |
+| `--memory-library-id <id>` | string | no | Memory library ID |
+
+#### Examples
+
+```bash
+bl memory list --user-id user1
+```
+
+```bash
+bl memory list --user-id user1 --page-size 20 --page 2
+```
+
+### `bl memory profile create`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `memory profile create` |
+| **Description** | Create a user profile schema for memory profiling |
+| **Usage** | `bl memory profile create --name <name> --attributes <json> [flags]` |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--name <name>` | string | yes | Schema name (required) |
+| `--description <text>` | string | no | Schema description |
+| `--attributes <json>` | string | yes | Attributes JSON array: [{"name":"age","description":"年龄"}] |
+
+#### Examples
+
+```bash
+bl memory profile create --name "user_basic" --attributes '[{"name":"age","description":"年龄"},{"name":"hobby","description":"爱好"}]'
+```
+
+### `bl memory profile get`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `memory profile get` |
+| **Description** | Get user profile by schema ID and user ID |
+| **Usage** | `bl memory profile get --schema-id <id> --user-id <id>` |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--schema-id <id>` | string | yes | Profile schema ID (required) |
+| `--user-id <id>` | string | yes | User ID (required) |
+
+#### Examples
+
+```bash
+bl memory profile get --schema-id schema_xxx --user-id user1
+```
+
+### `bl memory search`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `memory search` |
+| **Description** | Search memory nodes by query or messages |
+| **Usage** | `bl memory search --user-id <id> [--query <text>] [flags]` |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--user-id <id>` | string | yes | User ID (required) |
+| `--query <text>` | string | no | Search query text |
+| `--messages <json>` | string | no | Messages JSON array for context-based search |
+| `--top-k <n>` | number | no | Number of results to return (default: 10) |
+| `--memory-library-id <id>` | string | no | Memory library ID |
+
+#### Examples
+
+```bash
+bl memory search --user-id user1 --query "编程偏好"
+```
+
+```bash
+bl memory search --user-id user1 --messages '[{"role":"user","content":"推荐一本书"}]' --top-k 5
+```
+
+### `bl memory update`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `memory update` |
+| **Description** | Update a memory node content |
+| **Usage** | `bl memory update --node-id <id> --user-id <id> --content <text>` |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--node-id <id>` | string | yes | Memory node ID (required) |
+| `--user-id <id>` | string | yes | User ID (required) |
+| `--content <text>` | string | yes | New content for the memory node (required) |
+| `--memory-library-id <id>` | string | no | Memory library ID (non-default library) |
+
+#### Examples
+
+```bash
+bl memory update --node-id node_xxx --user-id user1 --content "更新后的记忆内容"
+```

package/skill/reference/model.md

@@ -0,0 +1,51 @@
+# `bl model` commands
+
+> Auto-generated from `packages/cli/src/commands/catalog.ts`. Do not edit by hand.
+> Regenerate: `pnpm --filter bailian-cli run generate:reference` (runs automatically on `build`).
+
+Index: [index.md](index.md)
+
+## Commands in this group
+
+| Command | Description |
+| --- | --- |
+| `bl model list` | List available foundation models |
+
+## Command details
+
+### `bl model list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `model list` |
+| **Description** | List available foundation models |
+| **Usage** | `bl model list [flags]` |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--name <name>` | string | no | Filter by model name (keyword search) |
+| `--page <n>` | number | no | Page number (default: 1) |
+| `--page-size <n>` | number | no | Results per page (default: 50) |
+| `--provider <name>` | array | no | Filter by model provider (repeatable) |
+| `--capability <name>` | array | no | Filter by capability (repeatable) |
+| `--region <region>` | string | no | API region (default: cn-beijing) |
+
+#### Examples
+
+```bash
+bl model list
+```
+
+```bash
+bl model list --name qwen
+```
+
+```bash
+bl model list --page-size 20
+```
+
+```bash
+bl model list --output json
+```

package/skill/reference/omni.md

@@ -0,0 +1,74 @@
+# `bl omni` commands
+
+> Auto-generated from `packages/cli/src/commands/catalog.ts`. Do not edit by hand.
+> Regenerate: `pnpm --filter bailian-cli run generate:reference` (runs automatically on `build`).
+
+Index: [index.md](index.md)
+
+## Commands in this group
+
+| Command | Description |
+| --- | --- |
+| `bl omni` | Multimodal chat with text + audio output (Qwen-Omni) |
+
+## Command details
+
+### `bl omni`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `omni` |
+| **Description** | Multimodal chat with text + audio output (Qwen-Omni) |
+| **Usage** | `bl omni --message <text> [flags]` |
+| **API docs** | [/model-studio/qwen-omni](https://help.aliyun.com/zh/model-studio/model-studio/qwen-omni) |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--message <text>` | array | yes | Message text (repeatable, prefix role: to set role) |
+| `--model <model>` | string | no | Model ID (default: qwen3.5-omni-plus) |
+| `--system <text>` | string | no | System prompt |
+| `--image <url>` | array | no | Image URL or local file (repeatable) |
+| `--audio <url>` | array | no | Audio URL or local file (repeatable) |
+| `--video <url>` | array | no | Video file URL / local path, or comma-separated frame URLs |
+| `--voice <voice>` | string | no | Output voice (default: Cherry). Options: Chelsie, Cherry, Ethan, Serena, Tina |
+| `--audio-format <fmt>` | string | no | Audio output format (default: wav) |
+| `--audio-out <path>` | string | no | Save audio to file (default: auto-generate) |
+| `--text-only` | boolean | no | Output text only, no audio generation |
+| `--max-tokens <n>` | number | no | Maximum tokens to generate |
+| `--temperature <n>` | number | no | Sampling temperature (0.0, 2.0] |
+
+#### Examples
+
+```bash
+bl omni --message "你好，你是谁？"
+```
+
+```bash
+bl omni --message "描述这张图片" --image ./photo.jpg
+```
+
+```bash
+bl omni --message "这段音频在说什么？" --audio https://example.com/audio.wav
+```
+
+```bash
+bl omni --message "总结这个视频" --video https://example.com/video.mp4
+```
+
+```bash
+bl omni --message "这个视频讲了什么" --video ./local-video.mp4 --text-only
+```
+
+```bash
+bl omni --message "用四川话回答：今天天气怎么样" --voice Serena
+```
+
+```bash
+bl omni --message "Hello" --text-only --output json
+```
+
+```bash
+bl omni --message "朗读这段话" --audio-out greeting.wav
+```

package/skill/reference/search.md

@@ -0,0 +1,48 @@
+# `bl search` commands
+
+> Auto-generated from `packages/cli/src/commands/catalog.ts`. Do not edit by hand.
+> Regenerate: `pnpm --filter bailian-cli run generate:reference` (runs automatically on `build`).
+
+Index: [index.md](index.md)
+
+## Commands in this group
+
+| Command | Description |
+| --- | --- |
+| `bl search web` | Search the web using DashScope MCP WebSearch service |
+
+## Command details
+
+### `bl search web`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `search web` |
+| **Description** | Search the web using DashScope MCP WebSearch service |
+| **Usage** | `bl search web --query <text> [flags]` |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--query <text>` | string | yes | Search query text |
+| `--count <n>` | number | no | Number of search results (default: 10) |
+| `--list-tools` | boolean | no | List available MCP tools and exit |
+
+#### Examples
+
+```bash
+bl search web --query "阿里云百炼最新功能"
+```
+
+```bash
+bl search web --query "TypeScript 5.9 new features" --count 5
+```
+
+```bash
+bl search web --query "今日新闻"
+```
+
+```bash
+bl search web --list-tools
+```

package/skill/reference/speech.md

@@ -0,0 +1,141 @@
+# `bl speech` commands
+
+> Auto-generated from `packages/cli/src/commands/catalog.ts`. Do not edit by hand.
+> Regenerate: `pnpm --filter bailian-cli run generate:reference` (runs automatically on `build`).
+
+Index: [index.md](index.md)
+
+## Commands in this group
+
+| Command | Description |
+| --- | --- |
+| `bl speech recognize` | Recognize speech from audio files (FunAudio-ASR) |
+| `bl speech synthesize` | Synthesize speech from text (CosyVoice TTS) |
+
+## Command details
+
+### `bl speech recognize`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `speech recognize` |
+| **Description** | Recognize speech from audio files (FunAudio-ASR) |
+| **Usage** | `bl speech recognize --url <audio-url> [flags]` |
+| **API docs** | [/developer-reference/recording-file-recognition](https://help.aliyun.com/zh/model-studio/developer-reference/recording-file-recognition) |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--url <url>` | array | yes | Audio file URL or local file path (repeatable, max 100) |
+| `--model <model>` | string | no | Model ID (default: fun-asr) |
+| `--language <lang>` | string | no | Language hint (e.g. zh, en, ja) |
+| `--diarization` | boolean | no | Enable automatic speaker diarization |
+| `--speaker-count <n>` | number | no | Expected number of speakers (requires --diarization) |
+| `--vocabulary-id <id>` | string | no | Hot-word vocabulary ID for improved accuracy |
+| `--channel-id <n>` | number | no | Audio channel ID (default: 0) |
+| `--out <path>` | string | no | Save full transcription result to JSON file |
+| `--no-wait` | boolean | no | Return task ID immediately without polling |
+| `--poll-interval <seconds>` | number | no | Polling interval in seconds (default: 2) |
+
+#### Examples
+
+```bash
+bl speech recognize --url https://example.com/audio.mp3
+```
+
+```bash
+bl speech recognize --url https://example.com/a.mp3 --url https://example.com/b.mp3
+```
+
+```bash
+bl speech recognize --url https://example.com/meeting.wav --diarization --speaker-count 3
+```
+
+```bash
+bl speech recognize --url https://example.com/audio.mp3 --language zh
+```
+
+```bash
+bl speech recognize --url https://example.com/audio.mp3 --vocabulary-id vocab-abc123
+```
+
+```bash
+bl speech recognize --url https://example.com/audio.mp3 --out result.json
+```
+
+```bash
+bl speech recognize --url https://example.com/audio.mp3 --no-wait --quiet
+```
+
+### `bl speech synthesize`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `speech synthesize` |
+| **Description** | Synthesize speech from text (CosyVoice TTS) |
+| **Usage** | `bl speech synthesize --text <text> [flags]` |
+| **API docs** | [/developer-reference/cosyvoice](https://help.aliyun.com/zh/model-studio/developer-reference/cosyvoice) |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--text <text>` | string | yes | Text to synthesize into speech |
+| `--text-file <path>` | string | no | Read text from a file instead of --text |
+| `--model <model>` | string | no | Model ID (default: cosyvoice-v3-flash). System voices available for cosyvoice-v3-flash |
+| `--voice <voice>` | string | no | Voice ID. Use --list-voices to see system voices for cosyvoice-v3-flash; for v3.5-flash provide a clone/design voice ID |
+| `--list-voices` | boolean | no | List available system voices for the selected model and exit |
+| `--format <format>` | string | no | Audio format: mp3, pcm, wav, opus (default: mp3) |
+| `--sample-rate <rate>` | string | no | Audio sample rate in Hz (e.g. 24000) |
+| `--volume <volume>` | string | no | Volume 0-100 (default: 50) |
+| `--rate <rate>` | string | no | Speech rate 0.5-2.0 (default: 1.0) |
+| `--pitch <pitch>` | string | no | Pitch multiplier 0.5-2.0 (default: 1.0) |
+| `--seed <seed>` | string | no | Random seed 0-65535 for reproducible synthesis |
+| `--language <lang>` | string | no | Language hint (e.g. zh, en, ja, ko, fr, de) |
+| `--instruction <text>` | string | no | Natural language instruction to control speech style (e.g. "请用温柔的语调"） |
+| `--enable-ssml` | boolean | no | Enable SSML markup parsing in input text |
+| `--out <path>` | string | no | Save audio to file (default: auto-generate in temp dir) |
+| `--stream` | boolean | no | Stream raw PCM audio to stdout (pipe to player) |
+
+#### Examples
+
+```bash
+bl speech synthesize --list-voices --model cosyvoice-v3-flash
+```
+
+```bash
+bl speech synthesize --text "你好，我是千问" --voice <voice_id>
+```
+
+```bash
+bl speech synthesize --text "Hello world" --voice <voice_id> --language en
+```
+
+```bash
+bl speech synthesize --text-file script.txt --out speech.wav --voice <voice_id>
+```
+
+```bash
+bl speech synthesize --text "今天天气真好" --voice <voice_id> --instruction "请用温柔的语调说话"
+```
+
+```bash
+bl speech synthesize --text "Hello" --voice <voice_id> --format wav --sample-rate 24000
+```
+
+```bash
+# Stream to audio player (macOS)
+```
+
+```bash
+bl speech synthesize --text "你好" --voice <voice_id> --stream | afplay -
+```
+
+```bash
+# Pipe to ffplay
+```
+
+```bash
+bl speech synthesize --text "Hello" --voice <voice_id> --stream | ffplay -nodisp -autoexit -f s16le -ar 24000 -ac 1 -
+```

package/skill/reference/text.md

@@ -0,0 +1,65 @@
+# `bl text` commands
+
+> Auto-generated from `packages/cli/src/commands/catalog.ts`. Do not edit by hand.
+> Regenerate: `pnpm --filter bailian-cli run generate:reference` (runs automatically on `build`).
+
+Index: [index.md](index.md)
+
+## Commands in this group
+
+| Command | Description |
+| --- | --- |
+| `bl text chat` | Send a chat completion (OpenAI compatible, DashScope) |
+
+## Command details
+
+### `bl text chat`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `text chat` |
+| **Description** | Send a chat completion (OpenAI compatible, DashScope) |
+| **Usage** | `bl text chat --message <text> [flags]` |
+| **API docs** | [/compatibility-of-openai-with-dashscope](https://help.aliyun.com/zh/model-studio/compatibility-of-openai-with-dashscope) |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--model <model>` | string | no | Model ID (default: qwen3.6-plus) |
+| `--message <text>` | array | yes | Message text (repeatable, prefix role: to set role) |
+| `--messages-file <path>` | string | no | JSON file with messages array (use - for stdin) |
+| `--system <text>` | string | no | System prompt |
+| `--max-tokens <n>` | number | no | Maximum tokens to generate (default: 4096) |
+| `--temperature <n>` | number | no | Sampling temperature (0.0, 2.0] |
+| `--top-p <n>` | number | no | Nucleus sampling threshold |
+| `--stream` | boolean | no | Stream response tokens (default: on in TTY) |
+| `--tool <json-or-path>` | array | no | Tool definition as JSON or file path (repeatable) |
+| `--enable-thinking` | boolean | no | Enable thinking/reasoning mode (for qwen3/qwq models) |
+| `--thinking-budget <n>` | number | no | Max tokens for thinking (default: 4096) |
+
+#### Examples
+
+```bash
+bl text chat --message "What is Qwen?"
+```
+
+```bash
+bl text chat --model qwen-max --system "You are a coding assistant." --message "Write fizzbuzz in Python"
+```
+
+```bash
+bl text chat --message "Hello" --message "assistant:Hi!" --message "How are you?"
+```
+
+```bash
+cat conversation.json | bl text chat --messages-file - --stream
+```
+
+```bash
+bl text chat --message "Hello" --output json
+```
+
+```bash
+bl text chat --model qwq-plus --message "Solve 1+1" --enable-thinking
+```

package/skill/reference/update.md

@@ -0,0 +1,32 @@
+# `bl update` commands
+
+> Auto-generated from `packages/cli/src/commands/catalog.ts`. Do not edit by hand.
+> Regenerate: `pnpm --filter bailian-cli run generate:reference` (runs automatically on `build`).
+
+Index: [index.md](index.md)
+
+## Commands in this group
+
+| Command | Description |
+| --- | --- |
+| `bl update` | Update bl to the latest version |
+
+## Command details
+
+### `bl update`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `update` |
+| **Description** | Update bl to the latest version |
+| **Usage** | `bl update` |
+
+#### Options
+
+_No command-specific options._
+
+#### Examples
+
+```bash
+bl update
+```

package/skill/reference/usage.md

@@ -0,0 +1,43 @@
+# `bl usage` commands
+
+> Auto-generated from `packages/cli/src/commands/catalog.ts`. Do not edit by hand.
+> Regenerate: `pnpm --filter bailian-cli run generate:reference` (runs automatically on `build`).
+
+Index: [index.md](index.md)
+
+## Commands in this group
+
+| Command | Description |
+| --- | --- |
+| `bl usage free` | Query free-tier quota for a model |
+
+## Command details
+
+### `bl usage free`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `usage free` |
+| **Description** | Query free-tier quota for a model |
+| **Usage** | `bl usage free --model <model> [flags]` |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--model <model>` | string | yes | Model name to query (e.g. qwen3-max, qwen-turbo) |
+| `--region <region>` | string | no | API region (default: cn-beijing) |
+
+#### Examples
+
+```bash
+bl usage free --model qwen3-max
+```
+
+```bash
+bl usage free --model qwen-turbo --output json
+```
+
+```bash
+bl usage free --model qwen3-max --region cn-beijing
+```