更新日志

bailian-cli 系列包的所有重要变更都记录在此。

格式遵循 Keep a Changelog,版本号遵循 语义化版本。bailian-cli、bailian-cli-core、bailian-cli-runtime、bailian-cli-commands、knowledge-studio-cli 共享一个版本号。

English · README · 参与贡献

[2.1.0] - 2026-09-28

新增

• 文本微调参数 —— bl finetune text create 现在支持任务名、优先级、LoRA、评估、Checkpoint、数据集切分和数据增强参数；bl finetune get 返回更完整的任务元数据与超参数。

修复

• Windows Skill 安装 —— 处理传统路径长度限制，并可在运行中的 Agent 占用目录时原地更新已安装的 Skill。

内部

• 调整发布顺序，在 npm latest 前发布二进制，并对 macOS 发布二进制进行 ad-hoc 签名。

[2.0.0] - 2026-09-22

新增

• 原生 MCP 注册 —— 新增 bl mcp connect 和 bl mcp disconnect，支持在 Agent 原生配置中接入或移除百炼 MCP 服务：
  • 支持 streamable-http 与 SSE，可指定单个 Agent 或使用 --agent all。
  • 支持 Codex、Claude Code、Cursor、Qoder、Qoder Work、QwenWork、Qwen Code、Gemini、OpenCode、OpenClaw、DeepSeek Harness、ZCode 和 WorkBuddy。
  • 不会覆盖非 CLI 管理的同名配置；移除时会保留已被用户修改的注册项。
• 扩展 Skill 分发范围 —— Skill 安装和更新新增支持 WorkBuddy、Trae CLI 与 DeepSeek DSH，并使用各自的全局 Skill 目录。

修复

• Skill 操作预览 —— bl skill init、add、update 和 remove 现在会正确响应 --dry-run，只读展示计划操作的 Skill、Agent 和目标路径；无效请求的失败状态与实际执行保持一致。
• Skill 清理安全性 —— bl skill remove 的预览与实际执行现在使用相同的托管链接发现范围，可识别历史托管链接，并在删除前重新校验目标，避免误删已变化或不再由 CLI 管理的内容。

[1.28.0] - 2026-09-20

新增

• Agent 安全命令 —— bl agents security overview（最近 24 小时的防护总览）与 bl agents security alerts（告警列表，支持风险等级、资产类型、状态、厂商、分页与排序等筛选）。两者均对接按 workspace 区分的 AgentStudio 域名，遵循统一的 text / json / --quiet / --dry-run 约定。域名默认由 --workspace-id 推导，也可通过 --base-url / DASHSCOPE_BASE_URL / auth login --base-url 指向某个 workspace 或预发源覆盖（例如 https://<workspace-id>.cn-beijing.maas.aliyuncs.com/api/v1/agentstudio）。

内部

• 补充 Agent 安全 E2E 覆盖（help、缺 workspace 的 usage 错误、dry-run 域名推导与 --base-url 覆盖、query string 筛选、枚举快失败），并为新的 agents 组生成 bailian-cli 技能 reference。

[1.27.0] - 2026-09-18

新增

• 监控、日志与告警 —— 新增 bl monitor、bl log 和 bl alert 命令组，支持查看模型调用量、失败、耗时、Token 用量、审计与推理日志、调用链，配置数据投递并管理告警。
• 模型发现与示例代码 —— 新增 bl model search，可按相关度搜索模型目录；新增 bl model code，可获取开箱即用的 SDK 调用示例。

变更

• 模型目录 —— bl model list 新增输入/输出模态筛选，默认隐藏已下线模型，并可通过 --include-deprecated 将其包含在结果中。

修复

• 语音音色 —— bl speech synthesize --list-voices 现在支持查看 qwen-audio-3.0-tts-plus 和 qwen-audio-3.0-tts-flash 的内置音色及对应文档。
• Unix 二进制分发 —— 为 macOS 和 Linux 增加带校验和的 .tar.gz 发布资产，使安装流程可不依赖 unzip，同时保留 .zip 资产以兼容现有流程。

[1.26.0] - 2026-09-17

变更

• 简化认证方式 —— 默认推荐使用控制台登录，需要时可自动创建普通 API Key。已有普通 API Key 和 Token Plan 订阅 Key 统一使用 bl auth login --api-key <API_KEY> 登录。
• API Key 自动校验与地域识别 —— API Key 会在保存前进行校验，CLI 自动选择可用地域，并在适用时完成 Token Plan 配置。

[1.25.0] - 2026-09-14

新增

• Token Plan harness 权益额度 —— bl token-plan harness-quota 查看 Token Plan harness 权益额度用量（Console 认证），联合 harness 列表与已发放权益，展示已用/总额度、使用比例和重置时间；待发放权益的 harness 以「发放中」状态列出。
• 通过 --type official_tool|infrastructure 筛选 harness 列表；支持额度框输出或 --output json。

[1.24.0] - 2026-09-11

新增

• Sandbox 实例与模版生命周期命令，支持自动轮询构建状态和 --async 异步提交。
• bl sandbox official-images 与模版 --image 参数，内置代码解释器、浏览器和全能型镜像预设。
• bl sandbox file upload 使用 source=sandbox_template 上传模版挂载文件，返回的 File ID 可用于 mntConfig。
• Sandbox 复用 --base-url、环境变量和 Profile 配置，未配置时通过工作空间拼接接入地址。
• 独立的 bailian-sandbox Skill，提供命令参考和实例连接指南。

修复

• 模版构建轮询失败时保留已提交的 templateID 和 buildID，便于先查询已有构建，避免重复提交。

安全

• Sandbox REST 调用使用百炼 Bearer 鉴权，不依赖 E2B SDK 或 E2B API Key；连接凭据和 dry-run 环境变量默认脱敏。

[1.23.0] - 2026-09-10

新增

• Profile 级水印控制 —— 可通过 bl config set --key watermark --value true|false 设置图片生成与编辑、视频生成与编辑以及参考生视频命令的默认水印行为。
• ASR 准确率增强 —— bl speech recognize 现支持通过 --vocabulary 传入即时热词、通过 --context 增强上下文词表，以及通过 --vocabulary-id 使用适用于对应 ASR 模型的预编译热词表。
• 语音热词表管理 —— 新增 bl speech vocabulary create|list|get|update|delete，用于管理可复用的预编译热词表。

[1.22.0] - 2026-09-08

变更

• 项目初始化 —— managed-agent project init 默认创建 ./managed-agent 子目录；如需原地初始化，请使用 --project .。(BREAKING)
• Build 确认机制 —— managed-agent project build 无需确认，并且不再接受 --yes。使用 --dry-run 可只读预览；Publish 仍需显式确认。(BREAKING)
• Managed Agent SDK —— 升级至 0.7.1。Build 自动关联 Agent 目录下已启用的资源，保留显式引用、Skill 版本和 File 挂载路径；Environment 或 Vault 选择存在歧义时，在写入前报错。

修复

• 项目诊断 —— 提供可操作的项目根目录提示，并展示 Build 校验失败的具体原因。
• YAML 初始化路径 —— 创建成功及文件已存在的错误信息均展示 YAML 绝对路径。

内部

• 补充项目初始化和 Build 回归覆盖，移除本地闭环 E2E 测试中过时的 Build 确认参数。

[1.21.0] - 2026-09-07

新增

• Managed Agent 目录项目 —— 支持初始化、校验、构建和发布本地项目，按 Agent 组织资源配置，并提供资源示例。
• 本地项目版本管理 —— 无需 Git 即可启停快照版本管理、查看和预览历史，以及恢复项目文件。
• 项目 Workbench —— 在浏览器中编辑资源、审阅变更、发布更新和管理本地版本。

变更

• Playground 版本选择 —— 启动前查询 npm，复用版本一致的本地安装，否则按需下载最新版；保留显式版本和启动文件覆盖。
• Managed Agent SDK —— 升级至 0.7.0，通过 SDK 子路径复用项目目录和版本服务。

[1.20.0] - 2026-09-03

Managed Agent 现在同时提供 YAML-first 基础设施管理与百炼 AgentStudio 资源、运行时 API 操作。

新增

• Managed Agent API 命令 —— 新增 Agent、Environment、Skill、Vault、Deployment、Session 和 File 的列表、详情、搜索、版本、上传、下载、运行、暂停、归档、事件及诊断等操作。
• 基于 YAML 的单资源创建 —— agent create、environment create、skill create、vault create、vault credential create 和 deployment create 会更新 agents.yaml，并且只 Apply 目标资源，不受无关资源 Drift 阻塞。
• Agent Skill 挂载 —— 创建 Agent 时支持引用已有的自定义或官方 Skill ID，也支持本地 Skill 目录和 ZIP 文件。

变更

• Managed Agent CLI 限定为百炼 Provider —— bl managed-agent 现在只面向百炼，移除 Provider 选择参数，并拒绝包含其他 Provider 的配置。
• 运行时变更增加确认 —— Deployment 运行/暂停/恢复、Session 归档/删除以及 File 删除操作需要显式进行高风险确认。

修复

• Managed Agent 错误输出 —— Apply 和单资源创建失败时会保留底层 Provider 的具体诊断，不再只显示 Apply failed.。

安全

• 凭证仅在内存中解析并从进程环境清除；Vault Credential 声明通过环境变量引用 Secret，不会持久化明文。

[1.19.0] - 2026-09-01

新增

• bl quota delete — 清除指定模型的全部自定义 QPM/TPM 限流配置。

变更

• 高风险操作确认 — 高风险命令会在 --help 和 Skill 命令参考中展示风险说明。未传入 --yes 时，高风险操作不会执行；JSON 输出会返回退出码 7 和 error.type: "requires_confirmation"。确认后可添加 --yes 重新执行；--dry-run 无需确认。

[1.18.2] - 2026-09-01

变更

• 删除与清除操作增加确认 —— bl finetune delete、bl deploy delete、bl dataset delete 和 bl quota update --delete 现在会在执行前要求确认；非交互场景请传入 --yes。

修复

• Skill 安装可靠性 —— bl skill init 现在会重试临时性网络故障；备份清理受阻时，已完成的 Skill 更新不再被误报为失败。

[1.18.1] - 2026-08-28

已移除

• 移除 bl auth login 的 API Key 校验。

[1.18.0] - 2026-08-27

新增

• Profile API Key 自动回退 —— 当前 Profile 不支持某条命令时，自动使用 default 中的 API Key 和接入地址，无需手动切换 Profile；显式凭证仍然优先。
• 语音合成与识别支持独立默认模型 —— Profile 支持分别配置 TTS 和 ASR 默认模型。
• Wan3.0 文件生视频 —— bl video generate --file 支持本地文件或 URL，并校验互斥输入。

变更

• 视频默认模型升级至 Wan3.0 —— 普通 API Key 的文生、图生和参考生视频默认使用 wan3.0-video，并支持首尾帧与参考音频；Token Plan 默认模型保持不变。
• 扩展 Token Plan 预设 —— 登录后自动补充语音默认模型和缺失能力，同时保留用户已有配置。
• 优化语音与 Skill 安装体验 —— 流式语音合成默认输出 PCM；Skill 安装文档补充兼容 Node 18 的降级方式及 Node.js、Git 前置条件。

[1.17.1] - 2026-08-22

修复

• knowledge create 的 --description 更新为必填 —— 对齐服务端对知识库描述的必填校验：新增 --description 参数并设为必填，在发出请求前于本地校验 1–500 个字符的长度限制。bl knowledge create / kscli kb create 调用需带上该参数。
• knowledge service update 对服务端自己返回的配置字段误报警告 —— 通过 --policy 等标量参数更新草稿配置时，CLI 会先读取完整草稿再合并回写；草稿中的 user_system_prompt、anti_leak_prompt、refusal_prompt、credibility_prompt、session_file_parse_mode 以及 enable_thinking / enable_temperature / enable_credibility / enable_max_completion_tokens 此前不被 CLI 识别，导致每次更新都刷出一串 unknown agent_config field passed through 警告。配置本身始终被正确写入，现在不再误报。

新增

• bailian-web-search 路由技能 —— bl skill init 现在会一并安装专门的联网搜索路由技能，让 agent 直接选中正确的搜索入口，不再靠猜。
• Knowledge Studio CLI 命令手册 —— 完整的 kscli 参考文档，覆盖知识库、文档、切片、集合/类目、文件、检索/问答服务以及 search/chat，每条命令均附可运行示例。

变更

• 描述类参数说明写清该填什么 —— 数据集合与服务的 --description 帮助文案现在会说明该字段的用途（在列表中区分同类项；服务描述供 agent 判断该调用哪个服务），不再只是重复「必填」。
• knowledge retrieve --rerank-model 补充前置条件说明 —— 帮助文案现在会说明目标知识库必须已配置重排序模型，否则任何取值都会被拒绝。

[1.17.0] - 2026-08-18

新增

• 百炼原生 Managed Agent Deployment —— agents.yaml 中声明的 deployments 现在会创建原生 AgentStudio 资源，支持服务端 Cron 调度、本地文件资源上传、通过 destroy 归档，以及在下次 apply 时迁移旧版模拟 Deployment state。
• CLI 中英文体验 —— 可通过 bl config set 或 Config UI 将 language 设置为 en-US 或 zh-CN，在英文和中文的 CLI Help、Quick Start、命令示例及 Config UI 之间切换；所选语言跟随当前激活的配置。

修复

• Free Tier Auto-Stop 控制 —— bl usage freetier --off 现在可在免费额度尚有剩余时关闭 Auto-Stop；状态展示会反映实际开关状态，并仅查询筛选后的模型，避免触发服务端批量查询上限。

[1.16.0] - 2026-08-17

CLI 迎来知识库全生命周期管理：从创建配置知识库、上传文档、调优切片，到部署检索/问答服务，均可通过 bl knowledge 与 kscli 完成。

新增

• 知识库管理 —— bl knowledge create / list / info / update / delete 覆盖知识库的完整生命周期；bl knowledge stats 查询指定过去时间段内的文档数量与用量统计。
• 文档管理 —— bl knowledge doc upload 支持上传本地文件或整个目录（递归扫描，自动跳过不支持的格式及 node_modules 等工具目录）；doc list / status / tag / delete 覆盖文档生命周期其余环节，doc import-oss 支持从 OSS 导入文档。
• 检索 / 问答服务管理 —— bl knowledge service list / get / create / update / deploy / delete / copy 管理检索与问答服务配置，支持将草稿部署为正式版本。
• 切片管理 —— bl knowledge chunk add / list / update / delete 查看并精调文档切片。
• 数据中心管理 —— bl knowledge category list / add / delete、bl knowledge file list / get / delete、bl knowledge collection create / get 管理类目、原始文件与数据集。
• 检索与问答支持指定服务版本 —— bl knowledge search 和 bl knowledge chat 新增 --agent-version，可调用 beta（草稿）配置进行调试，或指定已发布的版本号。
• kscli 同步支持 —— 全部新知识库命令在 Knowledge Studio CLI 中以更短路径提供，如 kscli kb list、kscli doc upload、kscli service deploy。

移除

• 移除 bl knowledge search --query-history —— 该参数此前并未实际生效；多轮场景请改用 bl knowledge chat 并通过 --message 传入对话历史。

内部

• 请求现在携带静态的 OpenAPI 来源标识请求头，用于后端渠道归因。
• 新增知识库 E2E 测试套件，含冷启动、内容运营、切片调优、服务调优、数据面五条用户旅程场景。

[1.15.1] - 2026-08-17

新增

• 模型权限管理 —— bl permission list 查看各模型的推理 / 微调 / 部署授权；bl permission grant 与 bl permission revoke 负责授予和回收，支持 --all 一键为工作区全部模型（含后续新增模型）开启推理授权。

变更

• bl quota request 更名为 bl quota update —— 通过 --rpm/--tpm 设置单模型 QPM/TPM，新增 --delete 一键清除自定义限制；未指定的字段保持当前值，旧命令 quota request 仍作为别名可用。
• bl quota list 重构 —— 改从模型限制接口读取数据，单表展示模型级与工作区级的请求/用量限制及异步队列/并发限制。
• bl model list 不再需要控制台登录 —— 模型目录与 --enrich 参数结构端点均为公开接口。
• bl skill init 输出精简 —— 单技能状态改为 success/failed（原为 installed），新增 success/partial/failed 汇总结果；移除 publishedAt 与 agents 字段。

[1.15.0] - 2026-08-14

新增

• bl text chat 支持 Responses API —— 可通过 --api responses 调用 DashScope Responses API，支持流式输出、工具定义和结构化 JSON 输出；默认仍使用 Chat Completions。
• 订阅套餐用量视图 —— bl usage token-plan 支持查看 5 小时和每周额度，bl usage coding-plan 支持查看 5 小时、每周和每月额度；两者均提供文本与 JSON 输出。
• 命令帮助展示鉴权要求 —— Help 输出现在会明确标注命令需要 API Key、控制台登录还是阿里云 OpenAPI 凭证。

变更

• 扩展语音识别模型支持 —— bl speech recognize 现在会将异步文件转写和同步 Flash ASR 模型路由至对应的 DashScope API，并为暂不支持的实时模型提供明确提示。
• 增强 MCP 传输兼容性 —— MCP 命令现在可为兼容的百炼及自定义端点从 Streamable HTTP 自动回退至经典 SSE。

修复

• 二进制方式升级 CLI 成功后，现在会同步刷新已安装的 Agent Skills。
• 修复 Token Plan 额度不可用或缺少重置时间时的展示问题。
• 修复 Qwen3 文件转写结果处理，使等待模式和 --out 能够正常工作。
• 修复 MCP SSE 分块解析、响应头超时、中止清理和回退状态匹配问题。
• JSON 输出中的网络错误现在会在 cause.code 中保留 errno。

[1.14.3] - 2026-08-12

修复

• 免费额度兼容性 —— bl usage free 和 bl usage freetier 现在使用最新的 Bailian Commerce 控制台 API 查询、开通和关闭免费额度，并统一处理异步任务轮询。

[1.14.2] - 2026-08-07

新增

• bl skill init —— 一次性将全部官方 bailian-* Skill 安装到本机检测到的 AI Agent。

变更

• Skill 命令接口 —— Skill 管理命令现在默认输出适合 Agent 工作流的 JSON；bl skill add 和 bl skill update 使用明确的 --all 与 --name 选择参数。

[1.14.1] - 2026-08-05

新增

• 百炼 Skill 按领域拆分 —— 通过 npx skills add modelstudioai/cli --all -g 可统一安装图片与视频生成、模型微调、Managed Agent 和共享执行协议等专用 Skill，提升任务路由准确性并减少无关上下文。

变更

• 默认图片模型升级至 Qwen-Image 3.0 —— 普通 API Key 用户的图片生成、图片编辑、Pipeline、配置 UI 和相关文档现在默认使用 qwen-image-3.0。
• 扩展 Coding Agent 兼容范围 —— Skill 安装与更新现在能够识别更多 Coding Agent，保留已有安装链接，并自动将 Skill 补充到新识别的 Agent。

[1.14.0] - 2026-08-04

新增

• 免 Node.js 的二进制安装 — 支持 macOS Apple Silicon / Intel、Linux x64 和 Windows x64；npm 安装方式继续保留。
• 指定版本更新 — 二进制和 npm 安装均可通过 bl update --to <version> 更新或切换到指定版本。

变更

• 二进制自更新 — 二进制安装现在通过独立的发布通道检查和下载更新；执行 bl update 时不会覆盖正在运行的程序，下次运行自动使用新版本。

[1.13.1] - 2026-08-03

变更

• 默认文本模型升级至 Qwen3.8-Max — bl text chat、Pipeline、API Key 登录校验、配置 UI 和 Managed Agent 初始化模板现在默认使用 qwen3.8-max；Token Plan 也由预览版切换至正式版。

[1.13.0] - 2026-07-30

新增

• bl config ui 技能 / MCP / 代理 / 资产清单 — 在本地 Web UI 中浏览已安装的技能、MCP 服务器、编码代理和生成的资产，点击打开右侧详情抽屉：
  • 技能：将 SKILL.md 渲染为 Markdown（支持 GFM 表格），展示本地/远程来源徽章，支持上传 .zip 压缩包将技能安装到任意受支持代理的技能目录。
  • MCP：查看和编辑 JSON 配置，支持密钥掩码与掩码保真写回；支持在 Claude Code、Qwen Code、OpenCode、Cursor、Windsurf、Gemini、Qoder Work、OpenClaw 和 Claude Desktop 中创建、更新、删除 MCP 条目。
  • 代理：从 UI 一键启动编码代理（需对应 CLI 二进制在 PATH 中）。
  • 资产：按类别分组、按时间排序的浏览器，支持预览、本地打开和删除。
• 模型目录建议芯片 — 在配置 UI 的每个 default_*_model 字段下方展示按类别分组的模型名称，点击即可填入。
• Profile 磁贴网格 — 配置文件以磁贴网格展示，新增添加磁贴和设计一致的新建 Profile 弹窗。

变更

• 配置 UI 布局：可折叠分组侧边栏（带图标和持久化状态）、响应式断点、更宽的主区域、吸顶视图标题、右侧抽屉式编辑。

修复

• 修复软链接技能目录未被正确识别为已安装来源的问题。
• 配置文件检测现支持基于环境变量的路径和旧版配置方案。

[1.12.0] - 2026-07-28

新增

• bl config agent --key / --region —— 百炼控制台生成的命令可直接运行：--key 接收控制台编码后的 API Key 并在本地解码（与 --api-key 二选一）；--region 根据地域名自动派生 Token Plan 接入地址（与 --base-url 二选一）。
• bl config agent --context-window —— 设置写入 OpenClaw 配置的上下文窗口大小（默认 256000）。
• bl config agent --wire-api —— 选择写入 Codex 配置的通信协议；chat 仅保留给 Codex 0.80.0 及更早版本（会显示警告）。

变更

• bl config agent 配置 Codex 时默认写入 wire_api = "responses"，以适配已不再支持 chat 的新版 Codex。
• bl config agent 配置 Qwen Code 时改用 DASHSCOPE_API_KEY 环境变量，不再使用 BAILIAN_CLI_API_KEY。

修复

• bl config agent 写入的配置现已与各 Agent 官方格式对齐：Claude Code 尊重 CLAUDE_CONFIG_DIR 并清理残留的 ANTHROPIC_API_KEY；Qwen Code 采用 v3 配置 schema 并正确写入凭证，避免被系统级 OPENAI_API_KEY 干扰；OpenCode 支持带注释和尾部逗号的 JSONC 配置文件；OpenClaw 会将主模型注册进模型白名单并补齐计费元数据；Hermes 改用官方扁平 model.* 结构；Codex 写入官方 env_key 并支持 auth.json 兜底。
• bl config agent 写入配置时现会保留用户已有配置：合并而非覆盖，避免重复添加 provider 条目，并保留用户自定义的显示名。

[1.11.2] - 2026-07-28

变更

• MCP 工具或 WebSearch 因对应服务未开通而不可用时，CLI 现在会提供开通指引和市场直达链接；对于使用旧版 SSE 连接的 WebSearch，还会提示重新开通以切换至 Streamable HTTP。

修复

• 修复文本对话与 API Key 登录校验因传递不受支持的 enable_thinking 参数值而产生的兼容性错误。文本对话仅在用户明确开启思考模式时传递该参数，登录校验则改用兼容模型且不再传递该参数。

[1.11.1] - 2026-07-28

新增

• bl image edit 新增 --function 参数，支持为万相图片编辑模型（如 wanx2.1-imageedit）指定编辑功能。

修复

• 修复部分图片模型在图片生成与编辑时的调用失败和尺寸参数错误，并完善 Qwen-Image、Wan/Wanx、Z-Image 系列及 wanx-v1 日期版本的兼容性。

[1.11.0] - 2026-07-28

新增

• bl managed-agent —— 通过统一 CLI 声明式管理 Managed Agent 基础设施；百炼 Provider 对接 AgentStudio，并支持 Claude、Qoder 和 Ark：
  • init / validate / plan / apply / destroy —— 基于 agents.yaml 初始化、校验、预览和执行资源变更，以及销毁已托管资源。
  • state list / state show / state rm / state import —— 查看和管理本地资源状态，包括纳管已有远端资源或仅解除本地跟踪。
  • session create / session list / session get / session delete / session run / session send / session events —— 完整的会话生命周期操作，支持流式响应和结构化的 --output json 输出。
  • skill-list —— 浏览自定义与官方 Skill；使用 --source all 可一次返回两个来源。

变更

• 模型 Base URL 现在统一仅保留 URL Origin；传入的路径、查询参数和 Fragment 不再参与后续 API 请求路径拼接。

修复

• 安装指南不再推荐已移除的 --non-interactive，改为说明显式传入必填参数，并使用 --output json 或 NO_COLOR=1 适配非交互环境。

[1.10.1] - 2026-07-22

变更

• Token Plan 默认模型已更新为当前文本、图片，以及文生视频、图生视频和参考生视频的专用模型。
• 百炼 CLI Skill 现在能更准确地区分百炼专属任务与普通宿主 Agent 任务，并避免在已授权的工作流中重复征求同意。
• 已发布的 CLI 包现在支持 Node.js 18.17 及以上版本，最低版本要求由 Node.js 22.12 下调至 18.17。

修复

• Token Plan 现在能在图片编辑、图生视频、参考生视频和视觉理解中正确处理本地图片，无需另行托管为 URL。

[1.10.0] - 2026-07-19

新增

• bl config agent —— 一键配置 Claude Code、Qwen Code、OpenCode、OpenClaw、Hermes Agent 和 Codex 接入百炼模型服务。

变更

• 百炼 CLI Skill 现在只将匹配的百炼任务与多模态任务路由到 bl，并会在调用与平台无关的远程或计费能力前征求同意。

修复

• 完整执行 bl auth logout 时会同时清除模型 Base URL，避免后续登录继承失效的自定义或 Token Plan 接入地址。

[1.9.0] - 2026-07-17

新增

• 支持 Token Plan —— 登录后即可直接调用支持的模型，无需手动配置接入地址。
• 命名 Config Profile —— 支持创建、切换和管理相互隔离的配置，登录后会自动激活当前 Profile。
• Console Access Token 自动化 —— 支持生成并自动刷新 Console Access Token。
• bl workspace init —— 一站式完成百炼工作空间初始化和所需服务开通。

修复

• 提升配置安全性与一致性，包括密钥脱敏和自定义配置字段保留。

[1.8.3] - 2026-07-16

修复

• 修复 Windows 上 bl text chat --messages-file - 将标准输入当作 /dev/stdin 文件路径读取的问题；通过管道传入的 JSON 消息现在可以从标准输入正常读取。（#103）

[1.8.2] - 2026-07-15

变更

• bl model list 现在默认以 JSON 输出；需要表格视图请传 --output text。

修复

• bl model list --enrich 现在能正确返回每个模型的输入参数 schema（predictConfig）；此前因未解包控制台网关响应信封而始终为空。

[1.8.1] - 2026-07-14

变更

• 扩展 Command Pack 白名单，允许加载额外的内部命令扩展。

[1.8.0] - 2026-07-13

新增

• bl model list —— 浏览百炼模型市场：列出模型家族，或用 --model 查看单个家族的完整详情；支持按 provider、能力、特性、上下文窗口过滤，分页（--page / --page-size）、价格展示，以及 --enrich 获取更丰富的元数据。
• bl usage summary —— 统一用量视图，一屏合并免费额度与近期用量概览；--days 设置概览时间窗口（默认 7 天）。
• Command Pack 宿主支持 —— 新增面向白名单内部命令扩展包的加载能力。
• 音频与图像精调 —— 在原有文本流程之外新增 bl finetune audio create（CosyVoice 语音合成）与 bl finetune image create（万相图像生成）。bl finetune image create 支持 --generation-type t2i|i2i 显式选择文生图或图生图训练。
• 音频与图像部署 —— bl deploy audio create 与 bl deploy image create 可将精调后的语音合成与图像模型部署为推理接入点。
• 多模态数据集校验 —— bl dataset upload 与 bl dataset validate 现在支持使用 tts、image schema 的 .zip 压缩包，可校验包内引用的媒体文件，图像数据压缩包上限提升至 1 GB。

变更

• 精调与部署命令按模态拆分（BREAKING）：bl finetune create → bl finetune text create，bl deploy create → bl deploy text create。请更新使用旧路径的脚本。
• 部署参数重命名（BREAKING）：部署创建命令的 --template-id 更名为 --deploy-spec。
• 精调状态退出行为变更（BREAKING）：bl finetune watch 不再使用退出码 3 表示任务运行中；运行中与成功均返回 0，失败与取消使用 CLI 的常规错误流程。
• bl deploy audio create 默认使用 --plan mu（按模型单元计费，符合 CosyVoice 部署契约）；文本与图像仍默认 lora。
• bl finetune audio create 现在会校验 CosyVoice 训练数据：音频必须为 .wav，每条 wav_fn 必须以 train/ 开头，且只接受一个训练文件。
• bl quota list 与 bl quota check 现在会基于监控数据展示真实的 RPM/TPM 用量与限额，新增 RPM Left / TPM Left 列及剩余额度进度条。
• bl usage free 的输出现在与 bl usage summary 共用渲染逻辑，免费额度表格更一致。
• bl advisor recommend 不再依赖独立的意图识别模型来分析你的需求。

已移除

• 移除 bl advisor recommend 使用的 tongyi-intent-detect-v3 集成（BREAKING），同时移除 intent_detect_base_url 配置字段与 DASHSCOPE_INTENT_DETECT_BASE_URL 环境变量。

修复

• Skill 命令参考文档生成现在直接读取产品命令源码，并在发布检查中保持稳定格式。

[1.7.0] - 2026-07-09

新增

• bl auth login --open-api 现在可以保存阿里云 OpenAPI AK/SK 凭据，供 Token Plan 命令使用；bl auth status 会分别展示 API Key、控制台和 OpenAPI 凭据状态，bl auth logout --open-api 可只清除 OpenAPI 凭据。
• kscli 的 help 与示例现在展示为 kscli search、kscli chat、kscli retrieve 等 Knowledge Studio 独立入口路径。

变更

• Token Plan 命令统一使用 OpenAPI AK/SK 凭据流程，支持登录持久化凭据和 ALIBABA_CLOUD_ACCESS_KEY_ID / ALIBABA_CLOUD_ACCESS_KEY_SECRET 环境变量。
• 鉴权 flag 现在只对可使用它们的命令生效。把模型、控制台或 OpenAPI 凭据 flag 传给错误的命令时，现在会报 unknown flag，而不是接受后忽略。
• help 与命令参考现在只展示当前命令鉴权域适用的 flag，更容易区分模型、控制台和 OpenAPI 凭据。
• 缺少必填 flag 时现在返回用法错误并以退出码 2 退出，不再进入交互式补全或打印 help 后以退出码 0 退出。
• 图片、视频、语音任务类命令现在统一用 --async 表示提交任务后不等待；--concurrent 只在支持并发请求的命令上展示。
• 命令默认输出为文本；仅在显式设置 --output json、DASHSCOPE_OUTPUT=json 或配置文件要求 JSON 时输出 JSON。
• 更新检查节流调整为每天一次，并可在非 TTY / agent 场景展示更新提示。
• 代理配置现在只读取大写 HTTP_PROXY / HTTPS_PROXY / NO_PROXY，忽略小写代理环境变量。
• bl auth login 成功后不再额外打印 onboarding quick start 内容。

已移除

• 移除 bl knowledge retrieve 已废弃的 AK/SK 鉴权；知识库命令请使用 DashScope API Key。
• 移除 --no-color、--non-interactive 和 --no-wait。纯文本输出使用 NO_COLOR=1，提交任务后不等待使用 --async。
• 移除删除 / 登出类命令的 --yes 与交互式确认提示；执行破坏性操作前请用 --dry-run 预览。

修复

• 需要凭据的 --dry-run 路径现在会跳过鉴权前置检查，例如 Token Plan 可在未配置凭据时先打印请求信息。
• --verbose 的模型请求日志恢复输出请求方法、URL、鉴权来源与响应状态等信息。

[1.6.1] - 2026-07-03

变更

• bl vision describe 的示例与 skill 参考文档中的模型 id 由旧版 qwen-vl-plus 更新为 qwen3-vl-plus，与命令默认模型保持一致。

[1.6.0] - 2026-07-02

新增

• bl knowledge search — 基于新版 workspace RAG API 的知识库语义检索。支持 --query、--agent-id、--workspace-id、--image（多模态检索，可重复）和 --query-history（多轮对话上下文 JSON，用于查询重写）。
• bl knowledge chat — 知识库 SSE 流式问答。支持 --message（可重复，支持 角色:内容 前缀传入多轮历史）、--agent-id、--workspace-id 和 --image（多模态）。交互模式下实时展示检索、规划、生成等步骤进度。
• bailian-cli-core 新增 workspace 级知识 API 类型与端点：KnowledgeSearchRequest / KnowledgeSearchResponse、KnowledgeChatRequest / KnowledgeChatStreamChunk / KnowledgeChatMessage / KnowledgeChatContentPart，以及 knowledgeSearchEndpoint / knowledgeChatEndpoint。
• kscli 现已包含 search 和 chat 命令。

变更

• bl knowledge retrieve 描述中已标记为废弃，请改用 bl knowledge search。
• kscli README（中英文）更新，以 search 和 chat 为主推命令，retrieve 标记为废弃。

[1.5.0] - 2026-07-01

新增

• 模型精调 —— bl finetune:创建、列出、查询、观察、取消训练任务;拉取训练日志;列出 checkpoint;将 checkpoint 导出为可部署模型;查询训练能力(按模型或按训练类型)。支持 sft、sft-lora、dpo、dpo-lora、cpt 训练类型。
• 模型部署 —— bl deploy:创建、列出、查询、更新(限流)、扩缩容、删除部署;列出可部署模型与套餐。
• 数据集管理 —— bl dataset:上传、列出、查询、删除数据集文件,并新增 bl dataset validate 在上传前本地校验 .jsonl(ChatML / DPO / CPT 格式)。
• Token Plan 管理 —— bl token-plan:列出订阅座位、添加成员、批量分配座位、为座位创建 API Key。
• 自动更新检查:命令执行完成后,CLI 会(节流地)检查 npm 上是否有新版本并提示 Update available;若与稳定版存在大版本差距则自动升级。--quiet 或执行 bl update 时跳过。
• 可组合包:bailian-cli-runtime(CLI 框架)与 bailian-cli-commands(命令库)现在与 bailian-cli-core 一起发布,并在其之上新增了同家族 CLI knowledge-studio-cli(kscli)。bl 行为保持不变。

已移除

• 移除 bl config export-schema 命令(原用于把 CLI 命令导出为 Anthropic/OpenAI 兼容的 JSON tool schema)。

修复

• 控制台网关类命令(bl console call 等)在网关返回非字符串 errorCode 时,现在会给出可读的错误信息,而不是 [object Object]。

[1.4.2] - 2026-06-24

新增

• bl omni --list-voices 无需 API key 即可打印内置输出音色列表(ID、名称、描述、语言)并退出。内置音色表从 6 个扩展到 17 个,新增 Dylan、Sunny、Kiki 等方言音色。

变更

• bl omni 默认 --voice 改为 Tina(原为 Cherry)。--voice 帮助文案改为指向 --list-voices,不再内联列出全部音色。
• bl speech synthesize --list-voices 输出及缺少 --voice 时的提示中,新增官方 CosyVoice 音色文档链接。
• Agent skill 配置指引新增 console 站点选择说明(--console-site domestic / international),适用于 console 登录与网关类命令。

修复

• bl speech synthesize 修正 cosyvoice-v3-flash 内置音色 ID,由 longanhuan 改为 longanhuan_v3。

[1.4.1] - 2026-06-22

变更

• 视频生成默认升级到 HappyHorse 1.1 模型,画面质量更佳。如需使用 1.0 模型,可通过 --model 指定。
• bl update 现在会把 agent skill 同步更新到所有 agent 应用(Claude Code、Cursor 等),即使 CLI 已是最新版本也会刷新 skill。

[1.4.0] - 2026-06-17

新增

• 控制台网关支持多 region 与多站点：cn-beijing 与 ap-southeast-1，各含国内站 / 国际站变体，并新增 switchAgent 委托访问。
• 新增全局标志 --console-region、--console-site、--console-switch-agent；bl console call 另外新增 --site 与 --switch-agent。
• bl auth login --base-url <url>：使用 API Key 登录时可指定 base URL。
• bl omni 新增 --voice 选项（Chelsie、Cherry、Ethan、Serena、Sunny、Tina，默认 Cherry）。

变更

• 所有面向用户的 CLI 文案统一为英文。
• bl advisor recommend 内部意图 / 排序模型由 qwen-turbo 升级为 qwen-flash。
• 优化 usage、quota、workspace 命令的 JSON 输出。
• 配置文件中的 base_url 现在优先级高于环境变量 DASHSCOPE_BASE_URL。
• bl config show 现在展示 config.json 中的全部字段（敏感值已脱敏）。

移除

• 移除遗留的 region 配置字段及其相关选项。
• 清理 model list 命令移除后遗留的无效代码。

修复

• 当控制台会话未登录或已过期时，CLI 现在会给出明确的登录提示，不再是笼统的网关错误。
• 修正 bl video 命令 --resolution / --ratio / --duration 的帮助文案。

[1.3.3] - 2026-06-16

变更

• bl knowledge retrieve --help 现在明确指出 --api-key 是推荐的鉴权方式；AK/SK 相关选项已标注废弃并引导用户使用 --api-key。

新增

• 命令定义新增 notes 字段 — 命令可以附带上下文说明（鉴权要求、废弃提示等），同时展示在 --help 输出和生成的命令手册中。

[1.3.2] - 2026-06-12

修复

• 修复 bl omni --audio 始终返回 HTTP 400 的问题（#54），音频输入现已能正常理解。

[1.3.1] - 2026-06-12

修复

• bl 现在会读取 HTTP_PROXY / HTTPS_PROXY / NO_PROXY 环境变量(#35)。Node 内置的 fetch(undici)默认忽略代理环境变量,导致 VPN 或公司代理下出现 ECONNRESET。现已在启动时根据这些变量安装全局代理 dispatcher,并在 ECONNRESET 报错提示中给出 export HTTPS_PROXY=http://127.0.0.1:<port> 的指引。

[1.3.0] - 2026-06-11

新增

• bl usage 命令组：
  • bl usage free — 查询所有模型的免费额度（可通过 --model 指定模型）。
  • bl usage freetier — 启用（--on）或禁用（--off）免费额度模型的自动停服。
  • bl usage stats — 查询模型用量统计（需指定 --workspace-id）。
• bl quota 命令组：
  • bl quota list — 查看模型 RPM/TPM 速率限制（支持 --model 过滤，--all 展示全部）。
  • bl quota check — 查看当前 RPM/TPM 用量与速率限制。
  • bl quota history — 查看配额变更记录，支持分页。
  • bl quota request — 申请模型临时配额提升。
• bl workspace list — 列出所有业务空间，包含地域和 endpoint 信息。
• bl knowledge retrieve 新增 API-Key 鉴权（DashScope 网关），与原有 AK/SK 并存，可用时自动优先使用 API-Key。
• 新增检索参数：--dense-similarity-top-k、--sparse-similarity-top-k、--rerank-model、--rerank-mode、--rerank-instruct，API-Key 与 AK/SK 两条链路均支持。
• bailian-cli-core 新增 DashScopeKnowledgeRetrieveRequest / DashScopeKnowledgeRetrieveResponse 类型及 knowledgeRetrieveEndpoint 端点。
• 知识库检索全面 E2E 测试，覆盖两种鉴权路径、dry-run、rerank 参数及错误场景。

变更

• 凭据解析优先级：显式 API-Key → 显式 AK/SK flag → 自动检测 API-Key → 回退至配置/环境变量中的 AK/SK。
• --workspace-id 仅在 AK/SK 鉴权时必填，API-Key 模式下不再强制要求。
• --top-k 标记为废弃，改用 --rerank-top-n；使用时输出警告并自动映射。
• --access-key-id / --access-key-secret 标记为废弃（推荐使用 API-Key）。
• 全部文档中的 API Key 和控制台链接更新为直达密钥管理页面。

修复

• AK/SK 链路 --rerank 现在正确设置 EnableReranking，而非之前无效的 Rerank: true 布尔值。

[1.2.1] - 2026-06-09

变更

• Skill 安装命令从 npx skills add modelstudioai/skills 更新为 npx skills add modelstudioai/cli --all -g，所有 README 和文档已同步。
• bl update 现在会在 CLI 升级后自动更新 bailian-cli agent skill。
• 全仓库 README_CN.md 统一重命名为 README.zh.md（ISO 639 命名规范）。

新增

• 官方 skill（skills/bailian-cli/）迁入本仓库，pre-commit 自动生成 reference 文档并同步 SKILL.md 版本号。
• bailian-cli skill 新增中英文双语 README。

[1.2.0] - 2026-06-05

新增

• bl mcp 命令组：bl mcp list 列出 MCP 服务器，bl mcp tools <server> 查看可用工具，bl mcp call <server>.<tool> 通过 --arg k=v 或 --json 调用工具。
• bl advisor recommend — 用自然语言描述任务需求，智能推荐最合适的模型，展示上下文窗口、定价及能力详情。

修复

• 图片/视频水印始终开启的问题，现在正确遵守 bl config set watermark false 配置。
• 成对 flag（如 --watermark / --no-watermark）现已正确互斥。
• 可选参数为空时 flag 校验不再崩溃。
• 安全：凭据不再泄漏到磁盘日志，文件权限已收紧。
• 安全：校验 base_url / console_gateway_url 为合法 HTTP(S) URL。
• 安全：script/JS code 字段强制为字符串字面量（阻止不可信代码 RCE）。
• 安全：URL 路径段已百分号编码，SSE 缓冲区设上限。
• 安全：流水线规划、指针遍历及并发安全加固。
• MCP 命令现在在参数校验和 dry-run 检查之后才处理鉴权。

变更

• 所有命令的 flag 默认值文案统一并去重。
• 非法/未知 flag 名称现在会报明确错误，而非静默忽略。

[1.1.3] - 2026-06-02

新增

• bl auth login --console 在未配置 DashScope API Key 时会自动获取并保存,一次浏览器登录即可完成 OAuth 与 API Key 配置。

变更

• API Key 校验更稳健:网络 / 401 / 5xx 等瞬时错误会自动重试,单次请求超时上限收紧为 30 秒。

[1.1.2] - 2026-05-29

变更

• 默认视觉模型由 qwen-vl 升级为 qwen3-vl-plus,视觉推理与图表/文档解析能力更强。

修复

• 修复 1.1.0 开源切换后暴露的 TypeScript / lint 问题。

[1.1.1] - 2026-05-29

仅文档更新，CLI 与 SDK 行为无变化。

新增

• 新增 INSTALL.md，提供面向 AI Agent 的安装指引。

变更

• 同步根目录与 packages/cli 的 README 互链；中文 README 与英文版对齐。
• 移除 README 中的 unpkg 链接,改用官方来源。
• tools/release.mjs 在发布前会校验根目录与 packages/cli 的 README 保持同步。

修复

• tools/release.mjs check 现在会先构建包再执行类型检查,确保 bailian-cli-core 在干净检出环境下能正确解析(此前会级联出约 80 个虚假的 TS 错误)。

[1.1.0] - 2026-05-28

GitHub 上的首次公开发布。本项目此前在内部开发,这是首个以 Apache-2.0 协议开源的版本。

新增

让您的 AI Agent 开箱就具备以下能力,并可在复杂任务中自动组合调用:

模型服务

能力	默认服务	简介
文本生成	qwen3.7-max	面向智能体时代的旗舰 Max 模型,编程、办公与长周期自主执行能力出色
语音生成	cosyvoice-v3-flash	多音色实时流式合成,自然度/情感增强,5-20s 样本即可克隆
语音识别	fun-asr	汉语七大方言 + 20+ 口音官话,覆盖 30 种语种
图像生成	qwen-image-2.0	图片生成与编辑融合,专业文字渲染、真实质感、强语义遵循
图像编辑	qwen-image-2.0	智能编辑,支持多图合成
图生视频	happyhorse-1.0-i2v	精准理解文本语义,输出流畅自然的高质量视频
文生视频	happyhorse-1.0-t2v	高度还原动态画面,细节丰富
参考生视频	happyhorse-1.0-r2v	支持最多 9 张图片参考,稳定主体与场景保持
视频编辑	happyhorse-1.0-video-edit	自然语言指令编辑视频,支持最多 5 张图片参考
视觉理解	qwen-vl	长视频分析、图表/文档解析、视觉推理、多语言 OCR

应用数据

能力	默认服务	简介
知识库	阿里云百炼知识库	多模态数据知识库增删改查检索,需 AccessKey 认证
记忆库	阿里云百炼记忆库	跨会话持久化存储,提供个性化连贯对话体验

应用构建

能力	默认服务	简介
工作流调用	工作流服务	调用已有的工作流应用服务
智能体调用	智能体服务	调用已有的智能体应用服务

工具能力

能力	默认服务	简介
联网搜索	bailian_web_search	实时互联网全栈信息检索,提升回答准确性及时效性
临时文件上传	临时文件上传服务	免费临时存储空间,上传本地文件获得 URL(有效期 48 小时)
模型额度查询	模型额度查询	根据模型 id 查询可以使用的免费额度
接口文档	阿里云百炼模型应用 API 调用参考文档	在构建应用的过程中,自动为您的应用集成阿里云百炼模型和应用能力 API