From 718c244faa97af2cdb7b6c8aeed6bc3e87bf7a82 Mon Sep 17 00:00:00 2001 From: wb-liuxuehuan Date: Sat, 10 Oct 2026 14:02:50 +0800 Subject: [PATCH 1/3] =?UTF-8?q?refactor(usage):=20=E5=B0=86=E4=BB=A3?= =?UTF-8?q?=E5=B8=81=E8=AE=A1=E5=88=92=E9=A2=9D=E5=BA=A6=E7=AA=97=E5=8F=A3?= =?UTF-8?q?=E4=BB=8E5=E5=B0=8F=E6=97=B6=E5=92=8C1=E5=91=A8=E6=94=B9?= =?UTF-8?q?=E4=B8=BA=E6=9C=88=E5=BA=A6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 移除5小时和1周的使用百分比与重置时间字段 - 新增月度使用百分比和重置时间字段支持 - 修改使用数据解析逻辑，适配月度字段 - 更新额度展示文本，显示“Monthly quota”及相关提示 - 修改相关单元测试用例以支持月度额度窗口 - 更新端到端测试，确保月度额度数据正确渲染和验证 --- .../commands/src/commands/usage/token-plan.ts | 33 +++----- .../tests/e2e/usage-token-plan.e2e.test.ts | 18 ++-- .../commands/tests/token-plan-usage.test.ts | 82 ++++++------------- 3 files changed, 38 insertions(+), 95 deletions(-) diff --git a/packages/commands/src/commands/usage/token-plan.ts b/packages/commands/src/commands/usage/token-plan.ts index 2716a94bd..9e308850a 100644 --- a/packages/commands/src/commands/usage/token-plan.ts +++ b/packages/commands/src/commands/usage/token-plan.ts @@ -5,24 +5,18 @@ import { printQuotaBox, readNumber } from "./quota-box.ts"; const TOKEN_PLAN_USAGE_API = "zeldaHttp.apikeyMgr./tokenplan/personal/api/v2/usage"; interface TokenPlanUsage { - per5HourPercentage?: number; - per5HourResetTime?: number; - per1WeekPercentage?: number; - per1WeekResetTime?: number; + per1MonthPercentage?: number; + per1MonthResetTime?: number; } function readUsage(result: unknown): TokenPlanUsage { const response = unwrapResponse(result as Record); const usage: TokenPlanUsage = {}; - const per5HourPercentage = readNumber(response.per5HourPercentage); - if (per5HourPercentage !== undefined) usage.per5HourPercentage = per5HourPercentage; - const per5HourResetTime = readNumber(response.per5HourResetTime); - if (per5HourResetTime !== undefined) usage.per5HourResetTime = per5HourResetTime; - const per1WeekPercentage = readNumber(response.per1WeekPercentage); - if (per1WeekPercentage !== undefined) usage.per1WeekPercentage = per1WeekPercentage; - const per1WeekResetTime = readNumber(response.per1WeekResetTime); - if (per1WeekResetTime !== undefined) usage.per1WeekResetTime = per1WeekResetTime; + const per1MonthPercentage = readNumber(response.per1MonthPercentage); + if (per1MonthPercentage !== undefined) usage.per1MonthPercentage = per1MonthPercentage; + const per1MonthResetTime = readNumber(response.per1MonthResetTime); + if (per1MonthResetTime !== undefined) usage.per1MonthResetTime = per1MonthResetTime; return usage; } @@ -32,18 +26,11 @@ function printView(usage: TokenPlanUsage, generatedAt: number): void { "Token Plan Usage", [ { - label: "5-hour quota", + label: "Monthly quota", emptyMessage: - "The 5-hour limit may be unlimited; verify in the Bailian Token Plan console.", - percentage: usage.per5HourPercentage, - resetTime: usage.per5HourResetTime, - }, - { - label: "1-week quota", - emptyMessage: - "The 1-week limit may be unlimited; verify in the Bailian Token Plan console.", - percentage: usage.per1WeekPercentage, - resetTime: usage.per1WeekResetTime, + "The monthly limit may be unlimited; verify in the Bailian Token Plan console.", + percentage: usage.per1MonthPercentage, + resetTime: usage.per1MonthResetTime, }, ], generatedAt, diff --git a/packages/commands/tests/e2e/usage-token-plan.e2e.test.ts b/packages/commands/tests/e2e/usage-token-plan.e2e.test.ts index 2e2a9a817..63fe287cd 100644 --- a/packages/commands/tests/e2e/usage-token-plan.e2e.test.ts +++ b/packages/commands/tests/e2e/usage-token-plan.e2e.test.ts @@ -50,28 +50,20 @@ describe.skipIf(!isConsoleE2EReady())("e2e: usage token-plan（Console）", () = if (isConsoleAuthFailure(result)) return; expect(result.exitCode, result.stderr).toBe(0); const data = parseStdoutJson<{ - per5HourPercentage?: number; - per5HourResetTime?: number; - per1WeekPercentage?: number; - per1WeekResetTime?: number; + per1MonthPercentage?: number; + per1MonthResetTime?: number; }>(result.stdout); - const fields = [ - data.per5HourPercentage, - data.per5HourResetTime, - data.per1WeekPercentage, - data.per1WeekResetTime, - ]; + const fields = [data.per1MonthPercentage, data.per1MonthResetTime]; for (const field of fields) { if (field !== undefined) expect(field).toBeTypeOf("number"); } }); - test("usage token-plan 默认渲染生成时间与两个额度窗口", async () => { + test("usage token-plan 默认渲染生成时间与月额度窗口", async () => { const result = await runCommandE2e(USAGE_ROUTES, ["usage", "token-plan"]); if (isConsoleAuthFailure(result)) return; expect(result.exitCode, result.stderr).toBe(0); expect(result.stdout).toContain("Generated at:"); - expect(result.stdout).toContain("5-hour quota"); - expect(result.stdout).toContain("1-week quota"); + expect(result.stdout).toContain("Monthly quota"); }); }); diff --git a/packages/commands/tests/token-plan-usage.test.ts b/packages/commands/tests/token-plan-usage.test.ts index 9f144bd27..7335067d0 100644 --- a/packages/commands/tests/token-plan-usage.test.ts +++ b/packages/commands/tests/token-plan-usage.test.ts @@ -32,18 +32,11 @@ async function runTokenPlan(response: Record, output?: string): } as never); } -function makeUsageResponse( - per5HourPercentage?: number, - per1WeekPercentage = per5HourPercentage, -): Record { +function makeUsageResponse(per1MonthPercentage?: number): Record { const usage: Record = {}; - if (per5HourPercentage !== undefined) { - usage.per5HourPercentage = per5HourPercentage; - if (per5HourPercentage !== 0) usage.per5HourResetTime = 1_786_000_000_000; - } - if (per1WeekPercentage !== undefined) { - usage.per1WeekPercentage = per1WeekPercentage; - if (per1WeekPercentage !== 0) usage.per1WeekResetTime = 1_786_100_000_000; + if (per1MonthPercentage !== undefined) { + usage.per1MonthPercentage = per1MonthPercentage; + if (per1MonthPercentage !== 0) usage.per1MonthResetTime = 1_786_000_000_000; } return wrapResponse(usage); @@ -86,7 +79,7 @@ describe("usage token-plan view", () => { expect(renderedOutput).not.toContain("\u2588".repeat(11)); }); - test("accepts missing reset times when the quota usage is zero", async () => { + test("accepts a missing reset time when the quota usage is zero", async () => { const output = captureStdout(); await runTokenPlan(makeUsageResponse(0)); @@ -94,83 +87,54 @@ describe("usage token-plan view", () => { expect(output.join("")).toContain("Resets: not applicable (no usage yet)"); }); - test("allows one unused quota window without masking another reset time", async () => { + test("renders the monthly reset time when usage is present", async () => { const output = captureStdout(); - await runTokenPlan(makeUsageResponse(0, 0.5)); + await runTokenPlan(makeUsageResponse(0.5)); - const renderedOutput = output.join(""); - expect(renderedOutput).toContain("Resets: not applicable (no usage yet)"); - expect(renderedOutput).toMatch(/Resets: \d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}/); + expect(output.join("")).toMatch(/Resets: \d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}/); }); - test("renders missing quota windows as possibly unlimited", async () => { + test("renders a missing monthly quota as possibly unlimited", async () => { const output = captureStdout(); await runTokenPlan(makeUsageResponse()); - const renderedOutput = output.join(""); - expect(renderedOutput).toContain( - "The 5-hour limit may be unlimited; verify in the Bailian Token Plan console.", - ); - expect(renderedOutput).toContain( - "The 1-week limit may be unlimited; verify in the Bailian Token Plan console.", - ); - }); - - test("renders only the missing quota window as possibly unlimited", async () => { - const output = captureStdout(); - - await runTokenPlan(makeUsageResponse(undefined, 0.5)); - - const renderedOutput = output.join(""); - expect(renderedOutput).toContain( - "The 5-hour limit may be unlimited; verify in the Bailian Token Plan console.", - ); - expect(renderedOutput).not.toContain( - "The 1-week limit may be unlimited; verify in the Bailian Token Plan console.", + expect(output.join("")).toContain( + "The monthly limit may be unlimited; verify in the Bailian Token Plan console.", ); - expect(renderedOutput).toMatch(/Resets: \d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}/); }); - test("renders a window with a missing percentage as possibly unlimited even when its reset time is present", async () => { + test("renders the monthly window as possibly unlimited when its percentage is missing even if the reset time is present", async () => { const output = captureStdout(); - await runTokenPlan(wrapResponse({ per5HourResetTime: 1_786_000_000_000 })); + await runTokenPlan(wrapResponse({ per1MonthResetTime: 1_786_000_000_000 })); expect(output.join("")).toContain( - "The 5-hour limit may be unlimited; verify in the Bailian Token Plan console.", + "The monthly limit may be unlimited; verify in the Bailian Token Plan console.", ); }); test("treats non-numeric quota fields as absent instead of failing", async () => { const output = captureStdout(); - await runTokenPlan( - wrapResponse({ per5HourPercentage: "not-a-number", per1WeekPercentage: Number.NaN }), - ); + await runTokenPlan(wrapResponse({ per1MonthPercentage: "not-a-number" })); - const renderedOutput = output.join(""); - expect(renderedOutput).toContain( - "The 5-hour limit may be unlimited; verify in the Bailian Token Plan console.", - ); - expect(renderedOutput).toContain( - "The 1-week limit may be unlimited; verify in the Bailian Token Plan console.", + expect(output.join("")).toContain( + "The monthly limit may be unlimited; verify in the Bailian Token Plan console.", ); }); }); describe("usage token-plan json", () => { - test("outputs the four core usage fields with --output json", async () => { + test("outputs the monthly usage fields with --output json", async () => { const output = captureStdout(); - await runTokenPlan(makeUsageResponse(0.5, 0.25), "json"); + await runTokenPlan(makeUsageResponse(0.5), "json"); expect(JSON.parse(output.join(""))).toEqual({ - per5HourPercentage: 0.5, - per5HourResetTime: 1_786_000_000_000, - per1WeekPercentage: 0.25, - per1WeekResetTime: 1_786_100_000_000, + per1MonthPercentage: 0.5, + per1MonthResetTime: 1_786_000_000_000, }); }); @@ -186,10 +150,10 @@ describe("usage token-plan json", () => { const output = captureStdout(); await runTokenPlan( - wrapResponse({ per5HourPercentage: "not-a-number", per1WeekPercentage: 0 }), + wrapResponse({ per1MonthPercentage: "not-a-number", per1MonthResetTime: 1_786_000_000_000 }), "json", ); - expect(JSON.parse(output.join(""))).toEqual({ per1WeekPercentage: 0 }); + expect(JSON.parse(output.join(""))).toEqual({ per1MonthResetTime: 1_786_000_000_000 }); }); }); From 588304af350be9124fcabbeb160e8580dc22dcc9 Mon Sep 17 00:00:00 2001 From: "lisheng.lisheng" Date: Mon, 12 Oct 2026 14:47:57 +0800 Subject: [PATCH 2/3] chore(release): prepare 2.2.0 --- CHANGELOG.md | 6 +++ CHANGELOG.zh.md | 6 +++ packages/cli/package.json | 2 +- packages/commands/package.json | 4 +- packages/core/package.json | 4 +- packages/kscli/package.json | 2 +- packages/runtime/package.json | 4 +- skills/bailian-cli/SKILL.md | 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/SKILL.md | 2 +- skills/bailian-finetune/reference/index.md | 2 +- skills/bailian-gen/SKILL.md | 2 +- skills/bailian-gen/reference/image.md | 40 +++++++++---------- skills/bailian-gen/reference/index.md | 2 +- skills/bailian-gen/reference/speech.md | 2 +- skills/bailian-managed-agent/SKILL.md | 2 +- .../bailian-managed-agent/reference/index.md | 2 +- .../reference/managed-agent.md | 2 +- skills/bailian-protocol/SKILL.md | 2 +- skills/bailian-sandbox/SKILL.md | 2 +- skills/bailian-sandbox/reference/index.md | 2 +- skills/bailian-web-search/SKILL.md | 2 +- 25 files changed, 83 insertions(+), 71 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index e1f9e274b..a71ff88d0 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,12 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and [中文版](CHANGELOG.zh.md) · [README](README.md) · [Contributing](CONTRIBUTING.md) +## [2.2.0] - 2026-10-12 + +### Changed + +- **Token Plan usage window** — `bl usage token-plan` now reports a single monthly quota (usage percentage and reset time) instead of the previous 5-hour and 1-week windows. + ## [2.1.0] - 2026-09-28 ### Added diff --git a/CHANGELOG.zh.md b/CHANGELOG.zh.md index 98ac308a0..7ed339ef8 100644 --- a/CHANGELOG.zh.md +++ b/CHANGELOG.zh.md @@ -6,6 +6,12 @@ [English](CHANGELOG.md) · [README](README.zh.md) · [参与贡献](CONTRIBUTING.zh.md) +## [2.2.0] - 2026-10-12 + +### 变更 + +- **Token Plan 额度窗口** —— `bl usage token-plan` 现在只展示月度额度（使用百分比与重置时间），不再显示此前的 5 小时和 1 周窗口。 + ## [2.1.0] - 2026-09-28 ### 新增 diff --git a/packages/cli/package.json b/packages/cli/package.json index 8cc4be7ff..162bbba0f 100644 --- a/packages/cli/package.json +++ b/packages/cli/package.json @@ -1,6 +1,6 @@ { "name": "bailian-cli", - "version": "2.1.0", + "version": "2.2.0", "description": "CLI for Aliyun Model Studio (DashScope) AI Platform.", "keywords": [ "agent", diff --git a/packages/commands/package.json b/packages/commands/package.json index ae739d60c..2103d03ec 100644 --- a/packages/commands/package.json +++ b/packages/commands/package.json @@ -1,6 +1,6 @@ { "name": "bailian-cli-commands", - "version": "2.1.0", + "version": "2.2.0", "description": "Command library for bailian-cli products (knowledge, memory, media, …). See https://www.npmjs.com/package/bailian-cli for usage.", "homepage": "https://bailian.console.aliyun.com/cli", "bugs": { @@ -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/package.json b/packages/core/package.json index ff459ac6c..102b23b19 100644 --- a/packages/core/package.json +++ b/packages/core/package.json @@ -1,6 +1,6 @@ { "name": "bailian-cli-core", - "version": "2.1.0", + "version": "2.2.0", "description": "Core SDK for bailian-cli. See https://www.npmjs.com/package/bailian-cli for usage.", "homepage": "https://bailian.console.aliyun.com/cli", "bugs": { @@ -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/kscli/package.json b/packages/kscli/package.json index 357b3ec3a..fb4ad05d7 100644 --- a/packages/kscli/package.json +++ b/packages/kscli/package.json @@ -1,6 +1,6 @@ { "name": "knowledge-studio-cli", - "version": "2.1.0", + "version": "2.2.0", "description": "Lightweight RAG CLI for Aliyun Model Studio — focused on knowledge-base retrieval.", "keywords": [ "alibaba-cloud", diff --git a/packages/runtime/package.json b/packages/runtime/package.json index fe723310b..fa09252f5 100644 --- a/packages/runtime/package.json +++ b/packages/runtime/package.json @@ -1,6 +1,6 @@ { "name": "bailian-cli-runtime", - "version": "2.1.0", + "version": "2.2.0", "description": "Runtime framework for bailian-cli (createCli, registry, args, output, pipeline). See https://www.npmjs.com/package/bailian-cli for usage.", "homepage": "https://bailian.console.aliyun.com/cli", "bugs": { @@ -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/SKILL.md b/skills/bailian-cli/SKILL.md index 0e6f8f3b5..da206b307 100644 --- a/skills/bailian-cli/SKILL.md +++ b/skills/bailian-cli/SKILL.md @@ -1,7 +1,7 @@ --- name: bailian-cli metadata: - version: "2.1.0" + version: "2.2.0" requires: bins: ["bl"] description: >- 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/SKILL.md b/skills/bailian-finetune/SKILL.md index fa0f3be74..dd4991e34 100644 --- a/skills/bailian-finetune/SKILL.md +++ b/skills/bailian-finetune/SKILL.md @@ -1,7 +1,7 @@ --- name: bailian-finetune metadata: - version: "2.1.0" + version: "2.2.0" requires: bins: ["bl"] description: >- 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/SKILL.md b/skills/bailian-gen/SKILL.md index f2761219f..451629250 100644 --- a/skills/bailian-gen/SKILL.md +++ b/skills/bailian-gen/SKILL.md @@ -1,7 +1,7 @@ --- name: bailian-gen metadata: - version: "2.1.0" + version: "2.2.0" requires: bins: ["bl"] description: >- 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/SKILL.md b/skills/bailian-managed-agent/SKILL.md index 5ac26be42..a9f2b6ed1 100644 --- a/skills/bailian-managed-agent/SKILL.md +++ b/skills/bailian-managed-agent/SKILL.md @@ -1,7 +1,7 @@ --- name: bailian-managed-agent metadata: - version: "2.1.0" + version: "2.2.0" requires: bins: ["bl"] description: >- 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-protocol/SKILL.md b/skills/bailian-protocol/SKILL.md index 27d92c21d..46c00253e 100644 --- a/skills/bailian-protocol/SKILL.md +++ b/skills/bailian-protocol/SKILL.md @@ -1,7 +1,7 @@ --- name: bailian-protocol metadata: - version: "2.1.0" + version: "2.2.0" requires: bins: ["bl"] description: >- diff --git a/skills/bailian-sandbox/SKILL.md b/skills/bailian-sandbox/SKILL.md index 4cb1bc0a3..33d9e570a 100644 --- a/skills/bailian-sandbox/SKILL.md +++ b/skills/bailian-sandbox/SKILL.md @@ -1,7 +1,7 @@ --- name: bailian-sandbox metadata: - version: "2.1.0" + version: "2.2.0" requires: bins: ["bl"] description: >- 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 diff --git a/skills/bailian-web-search/SKILL.md b/skills/bailian-web-search/SKILL.md index 6ba66101d..4948b5126 100644 --- a/skills/bailian-web-search/SKILL.md +++ b/skills/bailian-web-search/SKILL.md @@ -1,7 +1,7 @@ --- name: bailian-web-search metadata: - version: "2.1.0" + version: "2.2.0" requires: bins: ["bl"] description: >- From 89428673bf41802eeee773ba68324beea7afde3e Mon Sep 17 00:00:00 2001 From: "lisheng.lisheng" Date: Mon, 12 Oct 2026 14:54:03 +0800 Subject: [PATCH 3/3] chore(release): fix package.json formatting for 2.2.0 --- packages/commands/package.json | 2 +- 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 +- 14 files changed, 59 insertions(+), 59 deletions(-) diff --git a/packages/commands/package.json b/packages/commands/package.json index 2103d03ec..644b67861 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/package.json b/packages/core/package.json index 102b23b19..af542b123 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 fa09252f5..6402e51df 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