From 24e3ac218fd696f3658840ebc2a769dc1069d62c Mon Sep 17 00:00:00 2001 From: clh02467605 Date: Wed, 30 Sep 2026 10:44:53 +0800 Subject: [PATCH 1/2] fix(runtime): allow GLOBAL_FLAGS before the command path --- packages/commands/package.json | 2 +- .../core/lib/remote-telemetry/tracker.cjs | 4 +- packages/core/package.json | 2 +- packages/runtime/package.json | 2 +- packages/runtime/src/args.ts | 78 ++++++++++++++++--- packages/runtime/src/resolve.ts | 6 +- packages/runtime/tests/args.test.ts | 48 +++++++++++- skills/bailian-cli/reference/config.md | 10 +-- skills/bailian-cli/reference/index.md | 6 +- skills/bailian-cli/reference/knowledge.md | 18 ++--- skills/bailian-cli/reference/skill.md | 26 +++---- skills/bailian-finetune/reference/index.md | 2 +- skills/bailian-gen/reference/image.md | 40 +++++----- skills/bailian-gen/reference/index.md | 2 +- skills/bailian-gen/reference/speech.md | 2 +- .../bailian-managed-agent/reference/index.md | 2 +- .../reference/managed-agent.md | 2 +- skills/bailian-sandbox/reference/index.md | 2 +- 18 files changed, 178 insertions(+), 76 deletions(-) diff --git a/packages/commands/package.json b/packages/commands/package.json index ae739d60c..06d65fc77 100644 --- a/packages/commands/package.json +++ b/packages/commands/package.json @@ -26,11 +26,11 @@ "./package.json": "./package.json" }, "publishConfig": { + "access": "public", "exports": { ".": "./dist/index.mjs", "./package.json": "./package.json" }, - "access": "public", "registry": "https://registry.npmjs.org/" }, "scripts": { diff --git a/packages/core/lib/remote-telemetry/tracker.cjs b/packages/core/lib/remote-telemetry/tracker.cjs index 4f4f7e8c7..1de5d9da5 100644 --- a/packages/core/lib/remote-telemetry/tracker.cjs +++ b/packages/core/lib/remote-telemetry/tracker.cjs @@ -709,7 +709,7 @@ module.exports = (function (e) { e = this._processData(this._queue, n); } catch (e) {} if (e && e.length < t) return ((this._queue = []), void this.send(e)); - for (var r, o = []; this._queue.length;) { + for (var r, o = []; this._queue.length; ) { o.push(this._queue.shift()); try { r = this._processData(o, n); @@ -1080,7 +1080,7 @@ module.exports = (function (e) { var u, p = D(a); try { - for (p.s(); !(u = p.n()).done;) { + for (p.s(); !(u = p.n()).done; ) { var l = u.value; if (!1 === e.test(l.mac)) return l.mac; } diff --git a/packages/core/package.json b/packages/core/package.json index ff459ac6c..9abacca3b 100644 --- a/packages/core/package.json +++ b/packages/core/package.json @@ -26,11 +26,11 @@ "./package.json": "./package.json" }, "publishConfig": { + "access": "public", "exports": { ".": "./dist/index.mjs", "./package.json": "./package.json" }, - "access": "public", "registry": "https://registry.npmjs.org/" }, "scripts": { diff --git a/packages/runtime/package.json b/packages/runtime/package.json index fe723310b..863877f97 100644 --- a/packages/runtime/package.json +++ b/packages/runtime/package.json @@ -26,11 +26,11 @@ "./package.json": "./package.json" }, "publishConfig": { + "access": "public", "exports": { ".": "./dist/index.mjs", "./package.json": "./package.json" }, - "access": "public", "registry": "https://registry.npmjs.org/" }, "scripts": { diff --git a/packages/runtime/src/args.ts b/packages/runtime/src/args.ts index bca2fb701..2c391ca2a 100644 --- a/packages/runtime/src/args.ts +++ b/packages/runtime/src/args.ts @@ -1,5 +1,5 @@ import type { FlagsDef, ParsedFlags } from "bailian-cli-core"; -import { UsageError } from "bailian-cli-core"; +import { GLOBAL_FLAGS, UsageError } from "bailian-cli-core"; function kebabToCamel(str: string): string { return str.replace(/-([a-z])/g, (_, c: string) => c.toUpperCase()); @@ -11,26 +11,82 @@ export function camelToKebab(str: string): string { } export interface ParsePathResult { - /** Command path: the leading run of bare tokens, e.g. ["speech", "recognize"]. */ + /** Command path: consecutive bare tokens after any leading global flags. */ path: string[]; - /** Everything from the first flag onward — handed to parseFlags later. */ + /** + * Flag region handed to parseFlags later. + * Includes peeled leading GLOBAL_FLAGS plus everything after the command path. + */ rest: string[]; hasHelpFlag: boolean; hasVersionFlag: boolean; } /** - * First pass — routing only. The command path is the leading run of bare - * (non-`-`) tokens; the first flag ends it ("command path first, then flags", - * oclif-style). There are no positionals, so nothing bare can legitimately - * follow a flag — and no flags precede the path, so this needs no schema. + * First-pass routing parse. + * - Known GLOBAL_FLAGS may appear before the command path (git/docker style). + * - Bare tokens form the command path; everything after the path goes into rest. + * - Unknown flags before the path throw UsageError (no silent root-help fallback). */ export function parsePath(argv: string[]): ParsePathResult { - let i = 0; - while (i < argv.length && !argv[i]!.startsWith("-")) i++; - const rest = argv.slice(i); + const leadingRest: string[] = []; + let index = 0; + + while (index < argv.length) { + const argument = argv[index]!; + if (!argument.startsWith("-")) break; + + if (!argument.startsWith("--")) { + throw new UsageError(`Unknown flag "${argument}". Use the --long form.`); + } + + const equalsIndex = argument.indexOf("="); + const rawKey = equalsIndex !== -1 ? argument.slice(2, equalsIndex) : argument.slice(2); + if (rawKey === "") { + throw new UsageError(`Unknown flag "${argument}".`); + } + + const flagKey = kebabToCamel(rawKey); + const flagDef = + flagKey in GLOBAL_FLAGS ? GLOBAL_FLAGS[flagKey as keyof typeof GLOBAL_FLAGS] : undefined; + if (!flagDef) { + throw new UsageError( + `Unknown flag "--${rawKey}" before the command path. Only global flags may appear before the command; put command-specific flags after it.`, + ); + } + + if (flagDef.type === "switch") { + leadingRest.push(argument); + index += 1; + continue; + } + + // Value-taking global flags: support --flag=value and --flag value. + if (equalsIndex !== -1) { + leadingRest.push(argument); + index += 1; + continue; + } + + const value = argv[index + 1]; + if (value === undefined || value.startsWith("--")) { + // Leave a missing value for parseFlags so trailing form keeps the same error path. + leadingRest.push(argument); + index += 1; + continue; + } + + leadingRest.push(argument, value); + index += 2; + } + + const pathStart = index; + while (index < argv.length && !argv[index]!.startsWith("-")) index += 1; + const path = argv.slice(pathStart, index); + const rest = leadingRest.concat(argv.slice(index)); + return { - path: argv.slice(0, i), + path, rest, hasHelpFlag: rest.includes("--help"), hasVersionFlag: rest.includes("--version"), diff --git a/packages/runtime/src/resolve.ts b/packages/runtime/src/resolve.ts index b04377313..4416ee337 100644 --- a/packages/runtime/src/resolve.ts +++ b/packages/runtime/src/resolve.ts @@ -20,8 +20,10 @@ export type Resolution = /** * Classify argv into a {@link Resolution}. Pure over (argv, registry): one - * `parsePath` scan for the command path + flag region, one `registry.locate` - * for the routing decision. Never throws. Trivially unit-testable. + * `parsePath` scan for the command path + flag region (leading GLOBAL_FLAGS + * allowed), one `registry.locate` for the routing decision. `parsePath` may + * throw UsageError for unknown flags before the command path; otherwise this + * function itself does not throw. Trivially unit-testable. */ export function resolve(argv: string[], registry: CommandRegistry): Resolution { const { path, rest, hasHelpFlag, hasVersionFlag } = parsePath(argv); diff --git a/packages/runtime/tests/args.test.ts b/packages/runtime/tests/args.test.ts index 845d98c04..99850b69d 100644 --- a/packages/runtime/tests/args.test.ts +++ b/packages/runtime/tests/args.test.ts @@ -12,7 +12,7 @@ const IMAGE_GENERATE_FLAGS = { } satisfies FlagsDef; const OPTS = { ...GLOBAL_FLAGS, ...IMAGE_GENERATE_FLAGS }; -// ---- parsePath: routing only (command path first, then flags) ---- +// ---- parsePath: routing (leading GLOBAL_FLAGS + command path + trailing flags) ---- test("parsePath splits leading bare tokens as the command path", () => { const r = parsePath(["image", "generate", "--prompt", "cat"]); @@ -20,7 +20,7 @@ test("parsePath splits leading bare tokens as the command path", () => { expect(r.rest).toEqual(["--prompt", "cat"]); }); -test("parsePath stops the path at the first flag", () => { +test("parsePath stops the path at the first trailing flag", () => { const r = parsePath(["speech"]); expect(r.path).toEqual(["speech"]); expect(r.rest).toEqual([]); @@ -31,6 +31,50 @@ test("parsePath detects --help and --version in the flag region", () => { const v = parsePath(["--version"]); expect(v.hasVersionFlag).toBe(true); expect(v.path).toEqual([]); + expect(v.rest).toEqual(["--version"]); +}); + +test("parsePath peels leading --config before the command path", () => { + const r = parsePath(["--config", "token-plan", "config", "show"]); + expect(r.path).toEqual(["config", "show"]); + expect(r.rest).toEqual(["--config", "token-plan"]); +}); + +test("parsePath peels leading --config=value before the command path", () => { + const r = parsePath(["--config=token-plan", "auth", "status"]); + expect(r.path).toEqual(["auth", "status"]); + expect(r.rest).toEqual(["--config=token-plan"]); +}); + +test("parsePath peels multiple leading global flags and keeps trailing flags", () => { + const r = parsePath(["--verbose", "--config", "token-plan", "text", "chat", "--prompt", "hi"]); + expect(r.path).toEqual(["text", "chat"]); + expect(r.rest).toEqual(["--verbose", "--config", "token-plan", "--prompt", "hi"]); +}); + +test("parsePath still accepts global flags after the command path", () => { + const r = parsePath(["config", "show", "--config", "token-plan", "--quiet"]); + expect(r.path).toEqual(["config", "show"]); + expect(r.rest).toEqual(["--config", "token-plan", "--quiet"]); +}); + +test("parsePath rejects unknown flags before the command path", () => { + expect(() => parsePath(["--prompt", "hi", "text", "chat"])).toThrowError( + expect.objectContaining({ + name: "UsageError", + exitCode: ExitCode.USAGE, + message: expect.stringContaining('Unknown flag "--prompt" before the command path'), + }), + ); +}); + +test("parsePath rejects short flags before the command path", () => { + expect(() => parsePath(["-h", "config", "show"])).toThrowError( + expect.objectContaining({ + name: "UsageError", + message: expect.stringContaining("Use the --long form"), + }), + ); }); // ---- parseFlags: typed parsing ---- diff --git a/skills/bailian-cli/reference/config.md b/skills/bailian-cli/reference/config.md index 9e3cc9b83..2ca6348b7 100644 --- a/skills/bailian-cli/reference/config.md +++ b/skills/bailian-cli/reference/config.md @@ -35,7 +35,7 @@ Index: [index.md](index.md) | `--base-url ` | string | no | API base URL | | `--region ` | string | no | Model Studio region (e.g. cn-beijing, ap-southeast-1); converted into --base-url. Token Plan only | | `--api-key ` | string | no | API key | -| `--key ` | string | no | Obfuscated API key from the web console (starts with "o1_"); decoded into --api-key | +| `--key ` | string | no | Obfuscated API key from the web console (starts with "o1\_"); decoded into --api-key | | `--model ` | string | yes | Default model name | | `--context-window ` | number | no | OpenClaw only: model context window in tokens (default: 256000) | | `--wire-api ` | string | no | Codex only: wire protocol (default: responses). "chat" only works with legacy Codex <= 0.80.0 | @@ -88,10 +88,10 @@ bl config list --output json #### Flags -| Flag | Type | Required | Description | -| ----------------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `--key ` | string | yes | Config key (language, base_url, output, output_dir, timeout, watermark, api_key, api_key_capabilities, access_token, access_key_id, access_key_secret, security_token, default_*_model, workspace_id) | -| `--value ` | string | yes | Value to set | +| Flag | Type | Required | Description | +| ----------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `--key ` | string | yes | Config key (language, base*url, output, output_dir, timeout, watermark, api_key, api_key_capabilities, access_token, access_key_id, access_key_secret, security_token, default*\*\_model, workspace_id) | +| `--value ` | string | yes | Value to set | #### Examples diff --git a/skills/bailian-cli/reference/index.md b/skills/bailian-cli/reference/index.md index b3f9c402a..578092dda 100644 --- a/skills/bailian-cli/reference/index.md +++ b/skills/bailian-cli/reference/index.md @@ -4,7 +4,7 @@ > Regenerate: `pnpm --filter bailian-cli run generate:reference`. Command **details** are in sibling `.md` files in this directory. -This index only covers groups owned by this skill. Other `bl` groups live in sibling bailian-* skills. +This index only covers groups owned by this skill. Other `bl` groups live in sibling bailian-\* skills. Use this index for the skill-scoped quick index and global flags. ## Quick index @@ -65,7 +65,7 @@ Use this index for the skill-scoped quick index and global flags. | `bl knowledge list` | API Key | List knowledge bases in the workspace | [knowledge.md](knowledge.md) | | `bl knowledge retrieve` | API Key | Retrieve from a Bailian knowledge base (deprecated, use `search` instead) | [knowledge.md](knowledge.md) | | `bl knowledge search` | API Key | Search a Bailian knowledge base (RAG semantic retrieval) | [knowledge.md](knowledge.md) | -| `bl knowledge service copy` | API Key | Copy a service into a new draft (name gets a copy_ prefix) | [knowledge.md](knowledge.md) | +| `bl knowledge service copy` | API Key | Copy a service into a new draft (name gets a copy\_ prefix) | [knowledge.md](knowledge.md) | | `bl knowledge service create` | API Key | Create a retrieval / Q&A service (initial status: draft, version: beta) | [knowledge.md](knowledge.md) | | `bl knowledge service delete` | API Key | Delete a retrieval / Q&A service (soft delete, idempotent) | [knowledge.md](knowledge.md) | | `bl knowledge service deploy` | API Key | Publish the beta draft of a service as a new version | [knowledge.md](knowledge.md) | @@ -126,7 +126,7 @@ Use this index for the skill-scoped quick index and global flags. | `bl quota update` | API Key | Update model rate limits (QPM/TPM) | [quota.md](quota.md) | | `bl search web` | API Key | Search the web using DashScope MCP WebSearch service | [search.md](search.md) | | `bl skill add` | No Auth | Install skills from the Bailian skill registry into local agents | [skill.md](skill.md) | -| `bl skill init` | No Auth | Install all bailian-* skills (one-shot bootstrap for new environments) | [skill.md](skill.md) | +| `bl skill init` | No Auth | Install all bailian-\* skills (one-shot bootstrap for new environments) | [skill.md](skill.md) | | `bl skill list` | No Auth | List registry skills and diff against local installs | [skill.md](skill.md) | | `bl skill remove` | No Auth | Remove locally installed skills (registry is untouched) | [skill.md](skill.md) | | `bl skill update` | No Auth | Update installed skills to the latest registry versions | [skill.md](skill.md) | diff --git a/skills/bailian-cli/reference/knowledge.md b/skills/bailian-cli/reference/knowledge.md index 052b72f7d..8e49e9972 100644 --- a/skills/bailian-cli/reference/knowledge.md +++ b/skills/bailian-cli/reference/knowledge.md @@ -34,7 +34,7 @@ Index: [index.md](index.md) | `bl knowledge list` | API Key | List knowledge bases in the workspace | | `bl knowledge retrieve` | API Key | Retrieve from a Bailian knowledge base (deprecated, use `search` instead) | | `bl knowledge search` | API Key | Search a Bailian knowledge base (RAG semantic retrieval) | -| `bl knowledge service copy` | API Key | Copy a service into a new draft (name gets a copy_ prefix) | +| `bl knowledge service copy` | API Key | Copy a service into a new draft (name gets a copy\_ prefix) | | `bl knowledge service create` | API Key | Create a retrieval / Q&A service (initial status: draft, version: beta) | | `bl knowledge service delete` | API Key | Delete a retrieval / Q&A service (soft delete, idempotent) | | `bl knowledge service deploy` | API Key | Publish the beta draft of a service as a new version | @@ -307,7 +307,7 @@ bl knowledge chunk delete --index-id idx-xxx --chunk-id chunk-a --yes #### Notes -- Use metadata._id as the chunk id and metadata.doc_id as the document id in chunk update/delete commands. +- Use metadata.\_id as the chunk id and metadata.doc_id as the document id in chunk update/delete commands. - Page size defaults to 20 (server default), max 100. #### Examples @@ -334,7 +334,7 @@ bl knowledge chunk list --index-id idx-xxx --doc-id file-xxx --page-size 50 | Flag | Type | Required | Description | | ----------------------- | ------ | -------- | ------------------------------------------------------------------------- | | `--index-id ` | string | yes | Knowledge base ID | -| `--chunk-id ` | string | yes | Chunk ID (metadata._id from the chunk list output) | +| `--chunk-id ` | string | yes | Chunk ID (metadata.\_id from the chunk list output) | | `--doc-id ` | string | yes | Document ID owning the chunk (metadata.doc_id from the chunk list output) | | `--content ` | string | no | New chunk content, 10-6000 chars; alternative to --content-file | | `--content-file ` | string | no | Read new content from a UTF-8 plain text file (.md/.txt etc.) | @@ -991,12 +991,12 @@ bl knowledge search --api-key $DASHSCOPE_API_KEY --query "test search" --agent-i ### `bl knowledge service copy` -| Field | Value | -| ------------------ | ---------------------------------------------------------- | -| **Name** | `knowledge service copy` | -| **Description** | Copy a service into a new draft (name gets a copy_ prefix) | -| **Authentication** | API Key | -| **Usage** | `bl knowledge service copy --agent-id [flags]` | +| Field | Value | +| ------------------ | ----------------------------------------------------------- | +| **Name** | `knowledge service copy` | +| **Description** | Copy a service into a new draft (name gets a copy\_ prefix) | +| **Authentication** | API Key | +| **Usage** | `bl knowledge service copy --agent-id [flags]` | #### Flags diff --git a/skills/bailian-cli/reference/skill.md b/skills/bailian-cli/reference/skill.md index 807eb6623..809838cd6 100644 --- a/skills/bailian-cli/reference/skill.md +++ b/skills/bailian-cli/reference/skill.md @@ -7,13 +7,13 @@ Index: [index.md](index.md) ## Commands in this group -| Command | Authentication | Description | -| ----------------- | -------------- | ---------------------------------------------------------------------- | -| `bl skill add` | No Auth | Install skills from the Bailian skill registry into local agents | -| `bl skill init` | No Auth | Install all bailian-* skills (one-shot bootstrap for new environments) | -| `bl skill list` | No Auth | List registry skills and diff against local installs | -| `bl skill remove` | No Auth | Remove locally installed skills (registry is untouched) | -| `bl skill update` | No Auth | Update installed skills to the latest registry versions | +| Command | Authentication | Description | +| ----------------- | -------------- | ----------------------------------------------------------------------- | +| `bl skill add` | No Auth | Install skills from the Bailian skill registry into local agents | +| `bl skill init` | No Auth | Install all bailian-\* skills (one-shot bootstrap for new environments) | +| `bl skill list` | No Auth | List registry skills and diff against local installs | +| `bl skill remove` | No Auth | Remove locally installed skills (registry is untouched) | +| `bl skill update` | No Auth | Update installed skills to the latest registry versions | ## Command details @@ -45,12 +45,12 @@ bl skill add --name spark-video,bailian-model-recommend ### `bl skill init` -| Field | Value | -| ------------------ | ---------------------------------------------------------------------- | -| **Name** | `skill init` | -| **Description** | Install all bailian-* skills (one-shot bootstrap for new environments) | -| **Authentication** | No Auth | -| **Usage** | `bl skill init` | +| Field | Value | +| ------------------ | ----------------------------------------------------------------------- | +| **Name** | `skill init` | +| **Description** | Install all bailian-\* skills (one-shot bootstrap for new environments) | +| **Authentication** | No Auth | +| **Usage** | `bl skill init` | #### Flags diff --git a/skills/bailian-finetune/reference/index.md b/skills/bailian-finetune/reference/index.md index 756194009..b0901457f 100644 --- a/skills/bailian-finetune/reference/index.md +++ b/skills/bailian-finetune/reference/index.md @@ -4,7 +4,7 @@ > Regenerate: `pnpm --filter bailian-cli run generate:reference`. Command **details** are in sibling `.md` files in this directory. -This index only covers groups owned by this skill. Other `bl` groups live in sibling bailian-* skills. +This index only covers groups owned by this skill. Other `bl` groups live in sibling bailian-\* skills. Use this index for the skill-scoped quick index and global flags. ## Quick index diff --git a/skills/bailian-gen/reference/image.md b/skills/bailian-gen/reference/image.md index a35c7d298..b90506efc 100644 --- a/skills/bailian-gen/reference/image.md +++ b/skills/bailian-gen/reference/image.md @@ -25,25 +25,25 @@ Index: [index.md](index.md) #### Flags -| Flag | Type | Required | Description | -| --------------------------- | ------- | -------- | ------------------------------------------------------------------------------------------------- | -| `--image ` | array | yes | Source image URL or local file path (repeatable for multi-image merge) | -| `--prompt ` | string | yes | Edit instruction text | -| `--model ` | string | no | Model ID (default: qwen-image-3.0) | -| `--size ` | string | no | Output image size: ratio (3:4, 16:9) or pixels (2048*2048) | -| `--n ` | number | no | Number of images (default: 1, max: 6) | -| `--seed ` | number | no | Random seed for reproducible results | -| `--negative-prompt ` | string | no | Negative prompt to exclude unwanted content | -| `--function ` | string | no | wanx*-imageedit function (default: description_edit). Examples: stylization_all, description_edit | -| `--prompt-extend ` | boolean | no | Enable prompt extend (true/false). Omit flag to use CLI default (true). | -| `--watermark ` | boolean | no | Enable watermark (true/false). Omit flag to use the Profile setting or CLI default (true). | -| `--out-dir ` | string | no | Download images to directory | -| `--out-prefix ` | string | no | Filename prefix (default: edited) | -| `--async` | switch | no | Return async task id without waiting | -| `--concurrent ` | number | no | Run N parallel requests (default: 1) | -| `--poll-interval ` | number | no | Polling interval when waiting (default: 3) | -| `--api-key ` | string | no | API key | -| `--base-url ` | string | no | API base URL | +| Flag | Type | Required | Description | +| --------------------------- | ------- | -------- | -------------------------------------------------------------------------------------------------- | +| `--image ` | array | yes | Source image URL or local file path (repeatable for multi-image merge) | +| `--prompt ` | string | yes | Edit instruction text | +| `--model ` | string | no | Model ID (default: qwen-image-3.0) | +| `--size ` | string | no | Output image size: ratio (3:4, 16:9) or pixels (2048\*2048) | +| `--n ` | number | no | Number of images (default: 1, max: 6) | +| `--seed ` | number | no | Random seed for reproducible results | +| `--negative-prompt ` | string | no | Negative prompt to exclude unwanted content | +| `--function ` | string | no | wanx\*-imageedit function (default: description_edit). Examples: stylization_all, description_edit | +| `--prompt-extend ` | boolean | no | Enable prompt extend (true/false). Omit flag to use CLI default (true). | +| `--watermark ` | boolean | no | Enable watermark (true/false). Omit flag to use the Profile setting or CLI default (true). | +| `--out-dir ` | string | no | Download images to directory | +| `--out-prefix ` | string | no | Filename prefix (default: edited) | +| `--async` | switch | no | Return async task id without waiting | +| `--concurrent ` | number | no | Run N parallel requests (default: 1) | +| `--poll-interval ` | number | no | Polling interval when waiting (default: 3) | +| `--api-key ` | string | no | API key | +| `--base-url ` | string | no | API base URL | #### Examples @@ -94,7 +94,7 @@ bl image edit --image ./photo.png --prompt "Replace the background with a beach" | --------------------------- | ------- | -------- | ------------------------------------------------------------------------------------------------------------------------ | | `--prompt ` | string | yes | Image description | | `--model ` | string | no | Model ID (default: qwen-image-3.0) | -| `--size ` | string | no | Image size: ratio (3:4, 16:9, 1:1) or pixels (2048*2048) | +| `--size ` | string | no | Image size: ratio (3:4, 16:9, 1:1) or pixels (2048\*2048) | | `--n ` | number | no | Number of images per request (default: 1, max: 6) | | `--seed ` | number | no | Random seed for reproducible generation | | `--negative-prompt ` | string | no | Negative prompt to exclude unwanted content | diff --git a/skills/bailian-gen/reference/index.md b/skills/bailian-gen/reference/index.md index 512e7df64..57bb32975 100644 --- a/skills/bailian-gen/reference/index.md +++ b/skills/bailian-gen/reference/index.md @@ -4,7 +4,7 @@ > Regenerate: `pnpm --filter bailian-cli run generate:reference`. Command **details** are in sibling `.md` files in this directory. -This index only covers groups owned by this skill. Other `bl` groups live in sibling bailian-* skills. +This index only covers groups owned by this skill. Other `bl` groups live in sibling bailian-\* skills. Use this index for the skill-scoped quick index and global flags. ## Quick index diff --git a/skills/bailian-gen/reference/speech.md b/skills/bailian-gen/reference/speech.md index 7bbc5a329..324e8021d 100644 --- a/skills/bailian-gen/reference/speech.md +++ b/skills/bailian-gen/reference/speech.md @@ -33,7 +33,7 @@ Index: [index.md](index.md) | Flag | Type | Required | Description | | --------------------------- | ------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--url ` | array | yes | Audio file URL or local file path (repeatable, max 100) | -| `--model ` | string | no | Model ID (default: configured Profile ASR model, otherwise fun-asr). Async: fun-asr / _-filetrans / paraformer-_; sync: qwen3-asr-flash* / fun-asr-flash* / qwen-audio-*-asr-flash | +| `--model ` | string | no | Model ID (default: configured Profile ASR model, otherwise fun-asr). Async: fun-asr / _-filetrans / paraformer-_; sync: qwen3-asr-flash* / fun-asr-flash* / qwen-audio-\*-asr-flash | | `--language ` | string | no | Language hint (e.g. zh, en, ja). Classic async/input-audio: language_hints; qwen3-filetrans: language; qwen3 sync: asr_options.language | | `--diarization` | switch | no | Enable automatic speaker diarization | | `--speaker-count ` | number | no | Expected number of speakers (requires --diarization) | diff --git a/skills/bailian-managed-agent/reference/index.md b/skills/bailian-managed-agent/reference/index.md index 7058a243b..2fcb704a6 100644 --- a/skills/bailian-managed-agent/reference/index.md +++ b/skills/bailian-managed-agent/reference/index.md @@ -4,7 +4,7 @@ > Regenerate: `pnpm --filter bailian-cli run generate:reference`. Command **details** are in sibling `.md` files in this directory. -This index only covers groups owned by this skill. Other `bl` groups live in sibling bailian-* skills. +This index only covers groups owned by this skill. Other `bl` groups live in sibling bailian-\* skills. Use this index for the skill-scoped quick index and global flags. ## Quick index diff --git a/skills/bailian-managed-agent/reference/managed-agent.md b/skills/bailian-managed-agent/reference/managed-agent.md index a830d3c95..da7a1dd04 100644 --- a/skills/bailian-managed-agent/reference/managed-agent.md +++ b/skills/bailian-managed-agent/reference/managed-agent.md @@ -1230,7 +1230,7 @@ bl managed-agent project build --project ./my-agent #### Notes - Without --project, creates a managed-agent/ subdirectory. Enter it before running other project commands. Use --project . to initialize in place or convert the current agents.yaml; existing project files are not overwritten. -- New projects include Skill, File, Vault, and Environment examples under each resource directory's _examples/. They are not referenced by agent.json and are excluded from Build/Publish. Copy an example outside _examples/ to enable it, then configure its Agent reference. +- New projects include Skill, File, Vault, and Environment examples under each resource directory's \_examples/. They are not referenced by agent.json and are excluded from Build/Publish. Copy an example outside \_examples/ to enable it, then configure its Agent reference. #### Examples diff --git a/skills/bailian-sandbox/reference/index.md b/skills/bailian-sandbox/reference/index.md index b501041ab..d3ef52161 100644 --- a/skills/bailian-sandbox/reference/index.md +++ b/skills/bailian-sandbox/reference/index.md @@ -4,7 +4,7 @@ > Regenerate: `pnpm --filter bailian-cli run generate:reference`. Command **details** are in sibling `.md` files in this directory. -This index only covers groups owned by this skill. Other `bl` groups live in sibling bailian-* skills. +This index only covers groups owned by this skill. Other `bl` groups live in sibling bailian-\* skills. Use this index for the skill-scoped quick index and global flags. ## Quick index From 1b4f6f3f156a90b211140084cef3a5868e730376 Mon Sep 17 00:00:00 2001 From: clh02467605 Date: Wed, 30 Sep 2026 10:53:53 +0800 Subject: [PATCH 2/2] chore: restore unrelated formatting changes Drop accidental package.json key reordering and tracker.cjs whitespace edits that were unrelated to the leading GLOBAL_FLAGS fix. --- packages/commands/package.json | 2 +- .../core/lib/remote-telemetry/tracker.cjs | 4 +- packages/core/package.json | 2 +- packages/runtime/package.json | 2 +- skills/bailian-cli/reference/config.md | 10 ++--- skills/bailian-cli/reference/index.md | 6 +-- skills/bailian-cli/reference/knowledge.md | 18 ++++----- skills/bailian-cli/reference/skill.md | 26 ++++++------ skills/bailian-finetune/reference/index.md | 2 +- skills/bailian-gen/reference/image.md | 40 +++++++++---------- skills/bailian-gen/reference/index.md | 2 +- skills/bailian-gen/reference/speech.md | 2 +- .../bailian-managed-agent/reference/index.md | 2 +- .../reference/managed-agent.md | 2 +- skills/bailian-sandbox/reference/index.md | 2 +- 15 files changed, 61 insertions(+), 61 deletions(-) diff --git a/packages/commands/package.json b/packages/commands/package.json index 06d65fc77..ae739d60c 100644 --- a/packages/commands/package.json +++ b/packages/commands/package.json @@ -26,11 +26,11 @@ "./package.json": "./package.json" }, "publishConfig": { - "access": "public", "exports": { ".": "./dist/index.mjs", "./package.json": "./package.json" }, + "access": "public", "registry": "https://registry.npmjs.org/" }, "scripts": { diff --git a/packages/core/lib/remote-telemetry/tracker.cjs b/packages/core/lib/remote-telemetry/tracker.cjs index 1de5d9da5..4f4f7e8c7 100644 --- a/packages/core/lib/remote-telemetry/tracker.cjs +++ b/packages/core/lib/remote-telemetry/tracker.cjs @@ -709,7 +709,7 @@ module.exports = (function (e) { e = this._processData(this._queue, n); } catch (e) {} if (e && e.length < t) return ((this._queue = []), void this.send(e)); - for (var r, o = []; this._queue.length; ) { + for (var r, o = []; this._queue.length;) { o.push(this._queue.shift()); try { r = this._processData(o, n); @@ -1080,7 +1080,7 @@ module.exports = (function (e) { var u, p = D(a); try { - for (p.s(); !(u = p.n()).done; ) { + for (p.s(); !(u = p.n()).done;) { var l = u.value; if (!1 === e.test(l.mac)) return l.mac; } diff --git a/packages/core/package.json b/packages/core/package.json index 9abacca3b..ff459ac6c 100644 --- a/packages/core/package.json +++ b/packages/core/package.json @@ -26,11 +26,11 @@ "./package.json": "./package.json" }, "publishConfig": { - "access": "public", "exports": { ".": "./dist/index.mjs", "./package.json": "./package.json" }, + "access": "public", "registry": "https://registry.npmjs.org/" }, "scripts": { diff --git a/packages/runtime/package.json b/packages/runtime/package.json index 863877f97..fe723310b 100644 --- a/packages/runtime/package.json +++ b/packages/runtime/package.json @@ -26,11 +26,11 @@ "./package.json": "./package.json" }, "publishConfig": { - "access": "public", "exports": { ".": "./dist/index.mjs", "./package.json": "./package.json" }, + "access": "public", "registry": "https://registry.npmjs.org/" }, "scripts": { diff --git a/skills/bailian-cli/reference/config.md b/skills/bailian-cli/reference/config.md index 2ca6348b7..9e3cc9b83 100644 --- a/skills/bailian-cli/reference/config.md +++ b/skills/bailian-cli/reference/config.md @@ -35,7 +35,7 @@ Index: [index.md](index.md) | `--base-url ` | string | no | API base URL | | `--region ` | string | no | Model Studio region (e.g. cn-beijing, ap-southeast-1); converted into --base-url. Token Plan only | | `--api-key ` | string | no | API key | -| `--key ` | string | no | Obfuscated API key from the web console (starts with "o1\_"); decoded into --api-key | +| `--key ` | string | no | Obfuscated API key from the web console (starts with "o1_"); decoded into --api-key | | `--model ` | string | yes | Default model name | | `--context-window ` | number | no | OpenClaw only: model context window in tokens (default: 256000) | | `--wire-api ` | string | no | Codex only: wire protocol (default: responses). "chat" only works with legacy Codex <= 0.80.0 | @@ -88,10 +88,10 @@ bl config list --output json #### Flags -| Flag | Type | Required | Description | -| ----------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `--key ` | string | yes | Config key (language, base*url, output, output_dir, timeout, watermark, api_key, api_key_capabilities, access_token, access_key_id, access_key_secret, security_token, default*\*\_model, workspace_id) | -| `--value ` | string | yes | Value to set | +| Flag | Type | Required | Description | +| ----------------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `--key ` | string | yes | Config key (language, base_url, output, output_dir, timeout, watermark, api_key, api_key_capabilities, access_token, access_key_id, access_key_secret, security_token, default_*_model, workspace_id) | +| `--value ` | string | yes | Value to set | #### Examples diff --git a/skills/bailian-cli/reference/index.md b/skills/bailian-cli/reference/index.md index 578092dda..b3f9c402a 100644 --- a/skills/bailian-cli/reference/index.md +++ b/skills/bailian-cli/reference/index.md @@ -4,7 +4,7 @@ > Regenerate: `pnpm --filter bailian-cli run generate:reference`. Command **details** are in sibling `.md` files in this directory. -This index only covers groups owned by this skill. Other `bl` groups live in sibling bailian-\* skills. +This index only covers groups owned by this skill. Other `bl` groups live in sibling bailian-* skills. Use this index for the skill-scoped quick index and global flags. ## Quick index @@ -65,7 +65,7 @@ Use this index for the skill-scoped quick index and global flags. | `bl knowledge list` | API Key | List knowledge bases in the workspace | [knowledge.md](knowledge.md) | | `bl knowledge retrieve` | API Key | Retrieve from a Bailian knowledge base (deprecated, use `search` instead) | [knowledge.md](knowledge.md) | | `bl knowledge search` | API Key | Search a Bailian knowledge base (RAG semantic retrieval) | [knowledge.md](knowledge.md) | -| `bl knowledge service copy` | API Key | Copy a service into a new draft (name gets a copy\_ prefix) | [knowledge.md](knowledge.md) | +| `bl knowledge service copy` | API Key | Copy a service into a new draft (name gets a copy_ prefix) | [knowledge.md](knowledge.md) | | `bl knowledge service create` | API Key | Create a retrieval / Q&A service (initial status: draft, version: beta) | [knowledge.md](knowledge.md) | | `bl knowledge service delete` | API Key | Delete a retrieval / Q&A service (soft delete, idempotent) | [knowledge.md](knowledge.md) | | `bl knowledge service deploy` | API Key | Publish the beta draft of a service as a new version | [knowledge.md](knowledge.md) | @@ -126,7 +126,7 @@ Use this index for the skill-scoped quick index and global flags. | `bl quota update` | API Key | Update model rate limits (QPM/TPM) | [quota.md](quota.md) | | `bl search web` | API Key | Search the web using DashScope MCP WebSearch service | [search.md](search.md) | | `bl skill add` | No Auth | Install skills from the Bailian skill registry into local agents | [skill.md](skill.md) | -| `bl skill init` | No Auth | Install all bailian-\* skills (one-shot bootstrap for new environments) | [skill.md](skill.md) | +| `bl skill init` | No Auth | Install all bailian-* skills (one-shot bootstrap for new environments) | [skill.md](skill.md) | | `bl skill list` | No Auth | List registry skills and diff against local installs | [skill.md](skill.md) | | `bl skill remove` | No Auth | Remove locally installed skills (registry is untouched) | [skill.md](skill.md) | | `bl skill update` | No Auth | Update installed skills to the latest registry versions | [skill.md](skill.md) | diff --git a/skills/bailian-cli/reference/knowledge.md b/skills/bailian-cli/reference/knowledge.md index 8e49e9972..052b72f7d 100644 --- a/skills/bailian-cli/reference/knowledge.md +++ b/skills/bailian-cli/reference/knowledge.md @@ -34,7 +34,7 @@ Index: [index.md](index.md) | `bl knowledge list` | API Key | List knowledge bases in the workspace | | `bl knowledge retrieve` | API Key | Retrieve from a Bailian knowledge base (deprecated, use `search` instead) | | `bl knowledge search` | API Key | Search a Bailian knowledge base (RAG semantic retrieval) | -| `bl knowledge service copy` | API Key | Copy a service into a new draft (name gets a copy\_ prefix) | +| `bl knowledge service copy` | API Key | Copy a service into a new draft (name gets a copy_ prefix) | | `bl knowledge service create` | API Key | Create a retrieval / Q&A service (initial status: draft, version: beta) | | `bl knowledge service delete` | API Key | Delete a retrieval / Q&A service (soft delete, idempotent) | | `bl knowledge service deploy` | API Key | Publish the beta draft of a service as a new version | @@ -307,7 +307,7 @@ bl knowledge chunk delete --index-id idx-xxx --chunk-id chunk-a --yes #### Notes -- Use metadata.\_id as the chunk id and metadata.doc_id as the document id in chunk update/delete commands. +- Use metadata._id as the chunk id and metadata.doc_id as the document id in chunk update/delete commands. - Page size defaults to 20 (server default), max 100. #### Examples @@ -334,7 +334,7 @@ bl knowledge chunk list --index-id idx-xxx --doc-id file-xxx --page-size 50 | Flag | Type | Required | Description | | ----------------------- | ------ | -------- | ------------------------------------------------------------------------- | | `--index-id ` | string | yes | Knowledge base ID | -| `--chunk-id ` | string | yes | Chunk ID (metadata.\_id from the chunk list output) | +| `--chunk-id ` | string | yes | Chunk ID (metadata._id from the chunk list output) | | `--doc-id ` | string | yes | Document ID owning the chunk (metadata.doc_id from the chunk list output) | | `--content ` | string | no | New chunk content, 10-6000 chars; alternative to --content-file | | `--content-file ` | string | no | Read new content from a UTF-8 plain text file (.md/.txt etc.) | @@ -991,12 +991,12 @@ bl knowledge search --api-key $DASHSCOPE_API_KEY --query "test search" --agent-i ### `bl knowledge service copy` -| Field | Value | -| ------------------ | ----------------------------------------------------------- | -| **Name** | `knowledge service copy` | -| **Description** | Copy a service into a new draft (name gets a copy\_ prefix) | -| **Authentication** | API Key | -| **Usage** | `bl knowledge service copy --agent-id [flags]` | +| Field | Value | +| ------------------ | ---------------------------------------------------------- | +| **Name** | `knowledge service copy` | +| **Description** | Copy a service into a new draft (name gets a copy_ prefix) | +| **Authentication** | API Key | +| **Usage** | `bl knowledge service copy --agent-id [flags]` | #### Flags diff --git a/skills/bailian-cli/reference/skill.md b/skills/bailian-cli/reference/skill.md index 809838cd6..807eb6623 100644 --- a/skills/bailian-cli/reference/skill.md +++ b/skills/bailian-cli/reference/skill.md @@ -7,13 +7,13 @@ Index: [index.md](index.md) ## Commands in this group -| Command | Authentication | Description | -| ----------------- | -------------- | ----------------------------------------------------------------------- | -| `bl skill add` | No Auth | Install skills from the Bailian skill registry into local agents | -| `bl skill init` | No Auth | Install all bailian-\* skills (one-shot bootstrap for new environments) | -| `bl skill list` | No Auth | List registry skills and diff against local installs | -| `bl skill remove` | No Auth | Remove locally installed skills (registry is untouched) | -| `bl skill update` | No Auth | Update installed skills to the latest registry versions | +| Command | Authentication | Description | +| ----------------- | -------------- | ---------------------------------------------------------------------- | +| `bl skill add` | No Auth | Install skills from the Bailian skill registry into local agents | +| `bl skill init` | No Auth | Install all bailian-* skills (one-shot bootstrap for new environments) | +| `bl skill list` | No Auth | List registry skills and diff against local installs | +| `bl skill remove` | No Auth | Remove locally installed skills (registry is untouched) | +| `bl skill update` | No Auth | Update installed skills to the latest registry versions | ## Command details @@ -45,12 +45,12 @@ bl skill add --name spark-video,bailian-model-recommend ### `bl skill init` -| Field | Value | -| ------------------ | ----------------------------------------------------------------------- | -| **Name** | `skill init` | -| **Description** | Install all bailian-\* skills (one-shot bootstrap for new environments) | -| **Authentication** | No Auth | -| **Usage** | `bl skill init` | +| Field | Value | +| ------------------ | ---------------------------------------------------------------------- | +| **Name** | `skill init` | +| **Description** | Install all bailian-* skills (one-shot bootstrap for new environments) | +| **Authentication** | No Auth | +| **Usage** | `bl skill init` | #### Flags diff --git a/skills/bailian-finetune/reference/index.md b/skills/bailian-finetune/reference/index.md index b0901457f..756194009 100644 --- a/skills/bailian-finetune/reference/index.md +++ b/skills/bailian-finetune/reference/index.md @@ -4,7 +4,7 @@ > Regenerate: `pnpm --filter bailian-cli run generate:reference`. Command **details** are in sibling `.md` files in this directory. -This index only covers groups owned by this skill. Other `bl` groups live in sibling bailian-\* skills. +This index only covers groups owned by this skill. Other `bl` groups live in sibling bailian-* skills. Use this index for the skill-scoped quick index and global flags. ## Quick index diff --git a/skills/bailian-gen/reference/image.md b/skills/bailian-gen/reference/image.md index b90506efc..a35c7d298 100644 --- a/skills/bailian-gen/reference/image.md +++ b/skills/bailian-gen/reference/image.md @@ -25,25 +25,25 @@ Index: [index.md](index.md) #### Flags -| Flag | Type | Required | Description | -| --------------------------- | ------- | -------- | -------------------------------------------------------------------------------------------------- | -| `--image ` | array | yes | Source image URL or local file path (repeatable for multi-image merge) | -| `--prompt ` | string | yes | Edit instruction text | -| `--model ` | string | no | Model ID (default: qwen-image-3.0) | -| `--size ` | string | no | Output image size: ratio (3:4, 16:9) or pixels (2048\*2048) | -| `--n ` | number | no | Number of images (default: 1, max: 6) | -| `--seed ` | number | no | Random seed for reproducible results | -| `--negative-prompt ` | string | no | Negative prompt to exclude unwanted content | -| `--function ` | string | no | wanx\*-imageedit function (default: description_edit). Examples: stylization_all, description_edit | -| `--prompt-extend ` | boolean | no | Enable prompt extend (true/false). Omit flag to use CLI default (true). | -| `--watermark ` | boolean | no | Enable watermark (true/false). Omit flag to use the Profile setting or CLI default (true). | -| `--out-dir ` | string | no | Download images to directory | -| `--out-prefix ` | string | no | Filename prefix (default: edited) | -| `--async` | switch | no | Return async task id without waiting | -| `--concurrent ` | number | no | Run N parallel requests (default: 1) | -| `--poll-interval ` | number | no | Polling interval when waiting (default: 3) | -| `--api-key ` | string | no | API key | -| `--base-url ` | string | no | API base URL | +| Flag | Type | Required | Description | +| --------------------------- | ------- | -------- | ------------------------------------------------------------------------------------------------- | +| `--image ` | array | yes | Source image URL or local file path (repeatable for multi-image merge) | +| `--prompt ` | string | yes | Edit instruction text | +| `--model ` | string | no | Model ID (default: qwen-image-3.0) | +| `--size ` | string | no | Output image size: ratio (3:4, 16:9) or pixels (2048*2048) | +| `--n ` | number | no | Number of images (default: 1, max: 6) | +| `--seed ` | number | no | Random seed for reproducible results | +| `--negative-prompt ` | string | no | Negative prompt to exclude unwanted content | +| `--function ` | string | no | wanx*-imageedit function (default: description_edit). Examples: stylization_all, description_edit | +| `--prompt-extend ` | boolean | no | Enable prompt extend (true/false). Omit flag to use CLI default (true). | +| `--watermark ` | boolean | no | Enable watermark (true/false). Omit flag to use the Profile setting or CLI default (true). | +| `--out-dir ` | string | no | Download images to directory | +| `--out-prefix ` | string | no | Filename prefix (default: edited) | +| `--async` | switch | no | Return async task id without waiting | +| `--concurrent ` | number | no | Run N parallel requests (default: 1) | +| `--poll-interval ` | number | no | Polling interval when waiting (default: 3) | +| `--api-key ` | string | no | API key | +| `--base-url ` | string | no | API base URL | #### Examples @@ -94,7 +94,7 @@ bl image edit --image ./photo.png --prompt "Replace the background with a beach" | --------------------------- | ------- | -------- | ------------------------------------------------------------------------------------------------------------------------ | | `--prompt ` | string | yes | Image description | | `--model ` | string | no | Model ID (default: qwen-image-3.0) | -| `--size ` | string | no | Image size: ratio (3:4, 16:9, 1:1) or pixels (2048\*2048) | +| `--size ` | string | no | Image size: ratio (3:4, 16:9, 1:1) or pixels (2048*2048) | | `--n ` | number | no | Number of images per request (default: 1, max: 6) | | `--seed ` | number | no | Random seed for reproducible generation | | `--negative-prompt ` | string | no | Negative prompt to exclude unwanted content | diff --git a/skills/bailian-gen/reference/index.md b/skills/bailian-gen/reference/index.md index 57bb32975..512e7df64 100644 --- a/skills/bailian-gen/reference/index.md +++ b/skills/bailian-gen/reference/index.md @@ -4,7 +4,7 @@ > Regenerate: `pnpm --filter bailian-cli run generate:reference`. Command **details** are in sibling `.md` files in this directory. -This index only covers groups owned by this skill. Other `bl` groups live in sibling bailian-\* skills. +This index only covers groups owned by this skill. Other `bl` groups live in sibling bailian-* skills. Use this index for the skill-scoped quick index and global flags. ## Quick index diff --git a/skills/bailian-gen/reference/speech.md b/skills/bailian-gen/reference/speech.md index 324e8021d..7bbc5a329 100644 --- a/skills/bailian-gen/reference/speech.md +++ b/skills/bailian-gen/reference/speech.md @@ -33,7 +33,7 @@ Index: [index.md](index.md) | Flag | Type | Required | Description | | --------------------------- | ------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--url ` | array | yes | Audio file URL or local file path (repeatable, max 100) | -| `--model ` | string | no | Model ID (default: configured Profile ASR model, otherwise fun-asr). Async: fun-asr / _-filetrans / paraformer-_; sync: qwen3-asr-flash* / fun-asr-flash* / qwen-audio-\*-asr-flash | +| `--model ` | string | no | Model ID (default: configured Profile ASR model, otherwise fun-asr). Async: fun-asr / _-filetrans / paraformer-_; sync: qwen3-asr-flash* / fun-asr-flash* / qwen-audio-*-asr-flash | | `--language ` | string | no | Language hint (e.g. zh, en, ja). Classic async/input-audio: language_hints; qwen3-filetrans: language; qwen3 sync: asr_options.language | | `--diarization` | switch | no | Enable automatic speaker diarization | | `--speaker-count ` | number | no | Expected number of speakers (requires --diarization) | diff --git a/skills/bailian-managed-agent/reference/index.md b/skills/bailian-managed-agent/reference/index.md index 2fcb704a6..7058a243b 100644 --- a/skills/bailian-managed-agent/reference/index.md +++ b/skills/bailian-managed-agent/reference/index.md @@ -4,7 +4,7 @@ > Regenerate: `pnpm --filter bailian-cli run generate:reference`. Command **details** are in sibling `.md` files in this directory. -This index only covers groups owned by this skill. Other `bl` groups live in sibling bailian-\* skills. +This index only covers groups owned by this skill. Other `bl` groups live in sibling bailian-* skills. Use this index for the skill-scoped quick index and global flags. ## Quick index diff --git a/skills/bailian-managed-agent/reference/managed-agent.md b/skills/bailian-managed-agent/reference/managed-agent.md index da7a1dd04..a830d3c95 100644 --- a/skills/bailian-managed-agent/reference/managed-agent.md +++ b/skills/bailian-managed-agent/reference/managed-agent.md @@ -1230,7 +1230,7 @@ bl managed-agent project build --project ./my-agent #### Notes - Without --project, creates a managed-agent/ subdirectory. Enter it before running other project commands. Use --project . to initialize in place or convert the current agents.yaml; existing project files are not overwritten. -- New projects include Skill, File, Vault, and Environment examples under each resource directory's \_examples/. They are not referenced by agent.json and are excluded from Build/Publish. Copy an example outside \_examples/ to enable it, then configure its Agent reference. +- New projects include Skill, File, Vault, and Environment examples under each resource directory's _examples/. They are not referenced by agent.json and are excluded from Build/Publish. Copy an example outside _examples/ to enable it, then configure its Agent reference. #### Examples diff --git a/skills/bailian-sandbox/reference/index.md b/skills/bailian-sandbox/reference/index.md index d3ef52161..b501041ab 100644 --- a/skills/bailian-sandbox/reference/index.md +++ b/skills/bailian-sandbox/reference/index.md @@ -4,7 +4,7 @@ > Regenerate: `pnpm --filter bailian-cli run generate:reference`. Command **details** are in sibling `.md` files in this directory. -This index only covers groups owned by this skill. Other `bl` groups live in sibling bailian-\* skills. +This index only covers groups owned by this skill. Other `bl` groups live in sibling bailian-* skills. Use this index for the skill-scoped quick index and global flags. ## Quick index