mirror of
https://github.com/modelstudioai/cli.git
synced 2026-09-14 19:49:23 +08:00
若麒
183 lines
10 KiB
Markdown
183 lines
10 KiB
Markdown
# Changelog
|
||
|
||
All notable changes to `bailian-cli` and `bailian-cli-core` are documented here.
|
||
|
||
The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). The two packages share a single version number — they are always released together.
|
||
|
||
[中文版](CHANGELOG.zh.md) · [README](README.md) · [Contributing](CONTRIBUTING.md)
|
||
|
||
## [1.3.3] - 2026-06-16
|
||
|
||
### Changed
|
||
|
||
- `bl knowledge retrieve --help` now clearly indicates that `--api-key` is the recommended authentication method; AK/SK flags are explicitly marked as deprecated with guidance to use `--api-key` instead.
|
||
|
||
### Added
|
||
|
||
- `notes` field for command definitions — commands can now include contextual notes (auth requirements, deprecation notices, etc.) that are displayed in both `--help` output and the generated reference docs.
|
||
|
||
## [1.3.2] - 2026-06-12
|
||
|
||
### Fixed
|
||
|
||
- Fixed `bl omni --audio` always returning HTTP 400 (#54); audio inputs are now understood correctly.
|
||
|
||
## [1.3.1] - 2026-06-12
|
||
|
||
### Fixed
|
||
|
||
- `bl` now honors `HTTP_PROXY` / `HTTPS_PROXY` / `NO_PROXY` environment variables (#35). Node's built-in `fetch` (undici) ignores proxy env vars by default, causing `ECONNRESET` for users behind a VPN or corporate proxy. A global proxy dispatcher is now installed at startup when these variables are set, and the `ECONNRESET` error hint points to `export HTTPS_PROXY=http://127.0.0.1:<port>`.
|
||
|
||
## [1.3.0] - 2026-06-10
|
||
|
||
### Added
|
||
|
||
- `bl knowledge retrieve` now supports API-Key authentication (DashScope gateway), in addition to AK/SK. API-Key is auto-detected and preferred when available.
|
||
- New retrieval options: `--dense-similarity-top-k`, `--sparse-similarity-top-k`, `--rerank-model`, `--rerank-mode`, `--rerank-instruct` — supported on both API-Key and AK/SK paths.
|
||
- `DashScopeKnowledgeRetrieveRequest` / `DashScopeKnowledgeRetrieveResponse` types and `knowledgeRetrieveEndpoint` added to `bailian-cli-core`.
|
||
- Comprehensive E2E tests for knowledge retrieve covering both auth paths, dry-run, rerank flags, and error cases.
|
||
|
||
- `bl usage` command group:
|
||
- `bl usage free` — query free-tier quota for all models (or a specific model with `--model`).
|
||
- `bl usage freetier` — enable (`--on`) or disable (`--off`) auto-stop for free-tier models.
|
||
- `bl usage stats` — query model usage statistics (requires `--workspace-id`).
|
||
- `bl quota` command group:
|
||
- `bl quota list` — view model RPM/TPM rate limits (filter with `--model`, show all with `--all`).
|
||
- `bl quota check` — check current RPM/TPM usage against rate limits.
|
||
- `bl quota history` — view quota change history with pagination.
|
||
- `bl quota request` — request a temporary quota increase for a model.
|
||
- `bl workspace list` — list all workspaces with region and endpoint details.
|
||
|
||
### Changed
|
||
|
||
- Credential resolution priority: explicit API-Key → explicit AK/SK flags → auto-detected API-Key → fallback AK/SK from config/env.
|
||
- `--workspace-id` is now only required for AK/SK auth, no longer mandatory for API-Key mode.
|
||
- `--top-k` deprecated in favor of `--rerank-top-n`; emits a warning and maps to `--rerank-top-n` when used.
|
||
- `--access-key-id` / `--access-key-secret` flags marked as deprecated (API-Key is recommended).
|
||
- API Key and console links updated to direct key management pages across all docs.
|
||
|
||
### Fixed
|
||
|
||
- `--rerank` flag in AK/SK path now correctly sets `EnableReranking` instead of the non-functional `Rerank: true` boolean.
|
||
|
||
## [1.2.1] - 2026-06-09
|
||
|
||
### Changed
|
||
|
||
- Skill install command updated from `npx skills add modelstudioai/skills` to `npx skills add modelstudioai/cli --all -g` across all READMEs and docs.
|
||
- `bl update` now automatically updates the `bailian-cli` agent skill after CLI upgrade.
|
||
- Renamed `README_CN.md` to `README.zh.md` (ISO 639 convention) across the entire repo.
|
||
|
||
### Added
|
||
|
||
- Official skill (`skills/bailian-cli/`) now ships in this repository with pre-commit auto-generation of reference docs and SKILL.md version sync.
|
||
- Bilingual READMEs (EN + CN) for the `bailian-cli` skill.
|
||
|
||
## [1.2.0] - 2026-06-05
|
||
|
||
### Added
|
||
|
||
- `bl mcp` command group: `bl mcp list` to list MCP servers, `bl mcp tools <server>` to inspect available tools, and `bl mcp call <server>.<tool>` to invoke a tool with `--arg k=v` or `--json`.
|
||
- `bl advisor recommend` — describe your task in natural language and get intelligent model recommendations ranked by fit, with context-window, pricing, and capability details.
|
||
|
||
### Fixed
|
||
|
||
- Image/video watermark was always on regardless of config; now respects `bl config set watermark false`.
|
||
- Paired flags (e.g. `--watermark` / `--no-watermark`) are properly mutually exclusive.
|
||
- Null-value flag validation no longer crashes on missing optional arguments.
|
||
- **Security**: credentials no longer leak to on-disk logs; file permissions tightened.
|
||
- **Security**: `base_url` / `console_gateway_url` validated as real HTTP(S) URLs.
|
||
- **Security**: script/JS `code` fields require a string literal (blocks untrusted-code RCE).
|
||
- **Security**: URL path segments are percent-encoded; SSE buffer is bounded.
|
||
- **Security**: pipeline planning, pointer traversal, and concurrency hardened.
|
||
- MCP commands now handle auth _after_ arg validation and dry-run checks.
|
||
|
||
### Changed
|
||
|
||
- Flag default-value text is now unified and de-duplicated across all commands.
|
||
- Illegal/unknown flag names surface a clear error instead of silently ignoring.
|
||
|
||
## [1.1.3] - 2026-06-02
|
||
|
||
### Added
|
||
|
||
- `bl auth login --console` now also obtains and saves a DashScope API key when none is configured, so a single browser login covers both OAuth and API-key setup.
|
||
|
||
### Changed
|
||
|
||
- API-key validation is more resilient: retries on transient network / 401 / 5xx errors and caps each attempt at 30s.
|
||
|
||
## [1.1.2] - 2026-05-29
|
||
|
||
### Changed
|
||
|
||
- Default vision model upgraded from `qwen-vl` to `qwen3-vl-plus` for stronger visual reasoning and chart/document parsing.
|
||
|
||
### Fixed
|
||
|
||
- TypeScript / lint issues surfaced after the 1.1.0 open-source cut.
|
||
|
||
## [1.1.1] - 2026-05-29
|
||
|
||
Documentation-only release. No CLI or SDK behavior changes.
|
||
|
||
### Added
|
||
|
||
- `INSTALL.md` with AI-Agent-driven installation instructions.
|
||
|
||
### Changed
|
||
|
||
- README cross-links between root and `packages/cli` are now in sync; CN README aligned with EN.
|
||
- Removed unpkg links from README in favor of canonical sources.
|
||
- `tools/release.mjs` now asserts root and `packages/cli` READMEs stay in sync before publishing.
|
||
|
||
### Fixed
|
||
|
||
- `tools/release.mjs check` now builds packages before running type checks, so `bailian-cli-core` resolves correctly from a clean checkout (previously cascaded into ~80 spurious TS errors).
|
||
|
||
## [1.1.0] - 2026-05-28
|
||
|
||
Initial public release on GitHub. The CLI was previously developed internally; this is the first version published as open source under Apache-2.0.
|
||
|
||
### Added
|
||
|
||
Out-of-the-box capabilities your AI agent can compose across complex tasks:
|
||
|
||
**Model services**
|
||
|
||
| Capability | Default | Description |
|
||
| -------------------- | --------------------------- | ----------------------------------------------------------------------------------------------- |
|
||
| Text generation | `qwen3.7-max` | Flagship Max model for the agent era — strong at coding, office work, and long-horizon autonomy |
|
||
| Speech synthesis | `cosyvoice-v3-flash` | Multi-voice real-time streaming TTS with enhanced naturalness/emotion; clone from 5–20s samples |
|
||
| Speech recognition | `fun-asr` | 7 Chinese dialects + 20+ Mandarin accents; covers 30 languages |
|
||
| Image generation | `qwen-image-2.0` | Fused generation & editing, pro text rendering, photorealism, strong semantic adherence |
|
||
| Image editing | `qwen-image-2.0` | Smart editing with multi-image composition |
|
||
| Image-to-video | `happyhorse-1.0-i2v` | Faithful text-semantic interpretation, smooth high-quality output |
|
||
| Text-to-video | `happyhorse-1.0-t2v` | Vivid motion reproduction with rich detail |
|
||
| Reference-to-video | `happyhorse-1.0-r2v` | Up to 9 reference images; stable subject & scene preservation |
|
||
| Video editing | `happyhorse-1.0-video-edit` | Natural-language video editing, up to 5 reference images |
|
||
| Vision understanding | `qwen-vl` | Long-form video analysis, chart/document parsing, visual reasoning, multilingual OCR |
|
||
|
||
**Application data**
|
||
|
||
| Capability | Default | Description |
|
||
| -------------- | ----------------------------- | ------------------------------------------------------------ |
|
||
| Knowledge base | Aliyun Model Studio Knowledge | Multimodal RAG CRUD and retrieval; requires AccessKey |
|
||
| Memory | Aliyun Model Studio Memory | Cross-session persistence for personalized coherent dialogue |
|
||
|
||
**Application building**
|
||
|
||
| Capability | Default | Description |
|
||
| -------------- | ---------------- | ------------------------------ |
|
||
| Workflow calls | Workflow service | Invoke published workflow apps |
|
||
| Agent calls | Agent service | Invoke published agent apps |
|
||
|
||
**Tools**
|
||
|
||
| Capability | Default | Description |
|
||
| ---------------- | -------------------------------------- | ----------------------------------------------------------------------------- |
|
||
| Web search | `bailian_web_search` | Real-time internet retrieval for accuracy and freshness |
|
||
| Temp file upload | Temp upload service | Free temp storage; upload local files for URLs (48-hour validity) |
|
||
| Free-quota query | Quota query | Check available free-tier quota by model id |
|
||
| API reference | Aliyun Model Studio API reference docs | Auto-integrate Aliyun Model Studio model and app capability APIs during build |
|