chore(release): 1.1.1

Documentation-only patch release.

- Add INSTALL.md for AI-Agent-driven installation
- Sync root and packages/cli READMEs (EN + CN)
- Drop unpkg links in favor of canonical sources
- release.mjs: assert README sync before publishing

Author: XXPermanentXX

CHANGELOG.md

@@ -6,6 +6,20 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 
 [中文版](CHANGELOG_CN.md) · [README](README.md) · [Contributing](CONTRIBUTING.md)
 
+## [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.
+
 ## [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.

CHANGELOG_CN.md

@@ -6,6 +6,20 @@
 
 [English](CHANGELOG.md) · [README](README_CN.md) · [参与贡献](CONTRIBUTING_CN.md)
 
+## [1.1.1] - 2026-05-29
+
+仅文档更新，CLI 与 SDK 行为无变化。
+
+### 新增
+
+- 新增 `INSTALL.md`，提供面向 AI Agent 的安装指引。
+
+### 变更
+
+- 同步根目录与 `packages/cli` 的 README 互链；中文 README 与英文版对齐。
+- 移除 README 中的 unpkg 链接,改用官方来源。
+- `tools/release.mjs` 在发布前会校验根目录与 `packages/cli` 的 README 保持同步。
+
 ## [1.1.0] - 2026-05-28
 
 GitHub 上的首次公开发布。本项目此前在内部开发,这是首个以 Apache-2.0 协议开源的版本。

README.md

@@ -10,7 +10,7 @@
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6)](https://www.typescriptlang.org)
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE)
 
-[Aliyun Model Studio CLI Site](https://bailian.console.aliyun.com/cli?source_channel=cli_github&) · [中文文档](README_CN.md) · [API Documentation](https://help.aliyun.com/zh/model-studio/) · [Get API Key](https://bailian.console.aliyun.com/cli?source_channel=key_github&)
+[Aliyun Model Studio CLI Site](https://bailian.console.aliyun.com/cli?source_channel=cli_github&) · [中文文档](https://github.com/modelstudioai/cli/blob/main/README_CN.md) · [API Documentation](https://help.aliyun.com/zh/model-studio/) · [Get API Key](https://bailian.console.aliyun.com/cli?source_channel=key_github&)
 
 ---
 
@@ -173,8 +173,8 @@ Config file location: `~/.bailian/config.json`
 
 ## Changelog
 
-Release notes for every version live in [CHANGELOG.md](CHANGELOG.md).
+Release notes for every version live in [CHANGELOG.md](https://github.com/modelstudioai/cli/blob/main/CHANGELOG.md).
 
 ## Contributing
 
-Bug reports, feature requests, and PRs are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for developer setup, repo layout, and the workflow for adding or changing commands.
+Bug reports, feature requests, and PRs are welcome. See [CONTRIBUTING.md](https://github.com/modelstudioai/cli/blob/main/CONTRIBUTING.md) for developer setup, repo layout, and the workflow for adding or changing commands.

README_CN.md

@@ -10,7 +10,7 @@
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6)](https://www.typescriptlang.org)
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE)
 
-[阿里云百炼 CLI 官方主页](https://bailian.console.aliyun.com/cli) · [English](README.md) · [API 文档](https://help.aliyun.com/zh/model-studio/) · [获取 API Key](https://bailian.console.aliyun.com/cn-beijing/?tab=app#/api-key)
+[阿里云百炼 CLI 官方主页](https://bailian.console.aliyun.com/cli) · [English](https://github.com/modelstudioai/cli/blob/main/README.md) · [API 文档](https://help.aliyun.com/zh/model-studio/) · [获取 API Key](https://bailian.console.aliyun.com/cn-beijing/?tab=app#/api-key)
 
 ---
 
@@ -171,8 +171,8 @@ bl update
 
 ## 更新日志
 
-每个版本的变更详情记录在 [CHANGELOG_CN.md](CHANGELOG_CN.md)。
+每个版本的变更详情记录在 [CHANGELOG_CN.md](https://github.com/modelstudioai/cli/blob/main/CHANGELOG_CN.md)。
 
 ## 参与贡献
 
-欢迎提 Issue、Feature Request 和 PR。开发环境搭建、仓库结构、新增/修改命令的工作流请见 [CONTRIBUTING_CN.md](CONTRIBUTING_CN.md)。
+欢迎提 Issue、Feature Request 和 PR。开发环境搭建、仓库结构、新增/修改命令的工作流请见 [CONTRIBUTING_CN.md](https://github.com/modelstudioai/cli/blob/main/CONTRIBUTING_CN.md)。

packages/cli/README.md

@@ -1,8 +1,7 @@
 <div align="center">
 
-<img src="https://img.alicdn.com/imgextra/i1/O1CN01RSQFUD1jN5IBzHORt_!!6000000004535-2-tps-2440-521.png" alt="Aliyun Model Studio CLI" width="420" />
+<img src="https://img.alicdn.com/imgextra/i1/O1CN01kGgO3z1N30OINgUoG_!!6000000001513-2-tps-1915-821.png" alt="Aliyun Model Studio CLI" />
 
-# >\_ Aliyun Model Studio CLI
 
 **The official command-line interface for Aliyun Model Studio (DashScope) AI Platform**
 
@@ -11,7 +10,7 @@
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6)](https://www.typescriptlang.org)
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE)
 
-[Aliyun Model Studio CLI Site](https://bailian.console.aliyun.com/cli) · [中文文档](https://github.com/modelstudioai/cli/blob/main/README_CN.md) · [API Documentation](https://help.aliyun.com/zh/model-studio/) · [Get API Key](https://bailian.console.aliyun.com/cn-beijing/?tab=app#/api-key)
+[Aliyun Model Studio CLI Site](https://bailian.console.aliyun.com/cli?source_channel=cli_github&) · [中文文档](https://github.com/modelstudioai/cli/blob/main/README_CN.md) · [API Documentation](https://help.aliyun.com/zh/model-studio/) · [Get API Key](https://bailian.console.aliyun.com/cli?source_channel=key_github&)
 
 ---
 
@@ -38,10 +37,38 @@ Equip your AI Agent out-of-the-box with these capabilities, composable across co
 - **Console capabilities** — Browse Bailian apps (`app list`) and check free-tier quota (`usage free`)
 - **Local file auto-upload** — Every URL parameter accepts a local path; uploaded to free temp storage with 48-hour validity
 
+## Showcase: One-Sentence Cinematic Video
+
 <p align="center">
-  <img src="https://img.alicdn.com/imgextra/i1/O1CN01Df2LiL1IcCkXJROYz_!!6000000000913-2-tps-759-426.png" alt="bl --help" width="720" />
+  <a href="https://cloud.video.taobao.com/vod/dS2F4huqbw5Nfe5L3wwb3grz2q2DNYD3retq8dU-iHo.mp4">
+    <img src="https://img.alicdn.com/imgextra/i1/O1CN01Q5052k232Hd36NodG_!!6000000007197-0-tps-2940-1656.jpg" alt="Click to play the demo video" width="720" />
+  </a>
 </p>
 
+<p align="center"><i>👆 Click the cover to play the full 2-minute demo</i></p>
+
+A complete **2-minute, 16:9 cinematic short film** — produced end-to-end from a single natural-language sentence, with **zero manual editing**. This showcase demonstrates how an AI Agent can compose a multi-step creative pipeline by orchestrating three primitives:
+
+- **[Qwen Code](https://github.com/QwenLM/qwen-code)** — the agentic coding model that interprets the user's intent and drives the workflow
+- **[Aliyun Model Studio CLI](https://bailian.console.aliyun.com/cli?source_channel=cli_github&)** — invokes **HappyHorse 1.0**, Aliyun Model Studio's text-/image-/reference-to-video generation model
+- **[spark-video Skill](https://github.com/JohnKeating1997/spark-video)** — handles scene decomposition, storyboarding, shot continuity, and final stitching
+
+### The single prompt
+
+> *"Generate a roughly 2-minute video in Japanese cinematic style — a sweet, innocent first-love story about a high-school girl. The plot should be heart-fluttering enough to make viewers want to fall in love. Aspect ratio: 16:9."*
+>
+> *(Original: "帮我生成一段日系影视风格，高中女生的青涩初恋故事，剧情高甜，让人看了想谈恋爱，2分钟左右的视频，尺寸是16:9")*
+
+### How it works
+
+1. **Qwen Code** parses the request, plans the narrative beats, and decides which tools to call.
+2. The **spark-video Skill** breaks the story into shots, writes per-shot prompts, and enforces visual continuity (characters, lighting, palette, lens language).
+3. **`bl video generate`** dispatches each shot to **HappyHorse 1.0** in parallel.
+4. The skill stitches all clips back together into a single 16:9 / ~2-min deliverable.
+
+No timeline scrubbing. No frame-by-frame editing. Just one sentence → one video.
+
+
 ## Installation
 
 ```bash
@@ -77,13 +104,13 @@ bl app list
 bl usage free --model qwen3-max
 ```
 
-> More examples and scenarios: [Aliyun Model Studio CLI Site](https://bailian.console.aliyun.com/cli)
+> More examples and scenarios: [Aliyun Model Studio CLI Site](https://bailian.console.aliyun.com/cli?source_channel=cli_github&)
 
 ## Authentication
 
 ### DashScope API Key
 
-Required for most commands. Get your key from the [DashScope Console](https://bailian.console.aliyun.com/cn-beijing/?tab=app#/api-key).
+Required for most commands. Get your key from the [DashScope Console](https://bailian.console.aliyun.com/cli?source_channel=key_github&).
 
 ```bash
 # Option 1: Environment variable
@@ -137,11 +164,11 @@ Config file location: `~/.bailian/config.json`
 
 | Resource                     | URL                                                             |
 | :--------------------------- | :-------------------------------------------------------------- |
-| Aliyun Model Studio CLI Site | https://bailian.console.aliyun.com/cli                          |
+| Aliyun Model Studio CLI Site | https://bailian.console.aliyun.com/cli?source_channel=cli_github&                          |
 | DashScope API Docs           | https://help.aliyun.com/zh/model-studio/                        |
 | Qwen Model List              | https://help.aliyun.com/zh/model-studio/getting-started/models  |
 | Aliyun Model Studio Console  | https://bailian.console.aliyun.com/                             |
-| Get API Key                  | https://bailian.console.aliyun.com/cn-beijing/?tab=app#/api-key |
+| Get API Key                  | https://bailian.console.aliyun.com/cli?source_channel=key_github& |
 | Get AccessKey                | https://ram.console.aliyun.com/manage/ak                        |
 
 ## Changelog

packages/cli/README_CN.md

@@ -1,8 +1,7 @@
 <div align="center">
 
-<img src="https://img.alicdn.com/imgextra/i1/O1CN01RSQFUD1jN5IBzHORt_!!6000000004535-2-tps-2440-521.png" alt="Aliyun Model Studio CLI" width="420" />
+<img src="https://img.alicdn.com/imgextra/i1/O1CN01kGgO3z1N30OINgUoG_!!6000000001513-2-tps-1915-821.png" alt="Aliyun Model Studio CLI" />
 
-# >\_ Aliyun Model Studio CLI
 
 **阿里云百炼 (DashScope) AI 平台命令行工具**
 
@@ -38,10 +37,36 @@ _专为 AI Agent 打造，每个命令均可作为结构化工具调用。_
 - **控制台能力** — 浏览百炼应用（`app list`），查询模型免费额度（`usage free`）
 - **本地文件自动上传** — 所有 URL 参数同时支持本地路径，免费临时存储 48 小时
 
+## 示例:一句话生成一部电影短片
+
 <p align="center">
-  <img src="https://img.alicdn.com/imgextra/i1/O1CN01Df2LiL1IcCkXJROYz_!!6000000000913-2-tps-759-426.png" alt="bl --help" width="720" />
+  <a href="https://cloud.video.taobao.com/vod/dS2F4huqbw5Nfe5L3wwb3grz2q2DNYD3retq8dU-iHo.mp4">
+    <img src="https://img.alicdn.com/imgextra/i1/O1CN01Q5052k232Hd36NodG_!!6000000007197-0-tps-2940-1656.jpg" alt="点击播放演示视频" width="720" />
+  </a>
 </p>
 
+<p align="center"><i>👆 点击封面播放完整 2 分钟演示</i></p>
+
+一部完整的 **2 分钟、16:9 电影感短片** —— 由一句自然语言端到端生成,**全程零手动剪辑**。这个示例展示了 AI Agent 如何把三个基础能力编排成一条多步创作流水线:
+
+- **[Qwen Code](https://github.com/QwenLM/qwen-code)** —— Agentic coding 模型,解析用户意图、驱动整个工作流
+- **[阿里云百炼 CLI](https://github.com/modelstudioai/cli/)** —— 调用 **HappyHorse 1.0**,百炼的文生/图生/参考生视频模型
+- **[spark-video Skill](https://github.com/JohnKeating1997/spark-video)** —— 负责场景拆分、分镜设计、镜头连贯性和最终拼接
+
+### 唯一的提示词
+
+> *"帮我生成一段日系影视风格,高中女生的青涩初恋故事,剧情高甜,让人看了想谈恋爱,2 分钟左右的视频,尺寸是 16:9"*
+
+### 工作流程
+
+1. **Qwen Code** 解析需求、规划叙事节奏,决定要调用哪些工具。
+2. **spark-video Skill** 把故事拆成镜头、为每个镜头写提示词,并保证视觉连贯性(角色、光线、色调、镜头语言)。
+3. **`bl video generate`** 把每个镜头并行下发给 **HappyHorse 1.0**。
+4. Skill 把所有片段拼成最终的 16:9 / 约 2 分钟成片。
+
+没有时间线拖拽,没有逐帧剪辑。一句话 → 一部短片。
+
+
 ## 安装
 
 ```bash

packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bailian-cli",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "CLI for Aliyun Model Studio (DashScope) AI Platform.",
   "keywords": [
     "agent",

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bailian-cli-core",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Core SDK for bailian-cli. See https://www.npmjs.com/package/bailian-cli for usage.",
   "homepage": "https://bailian.console.aliyun.com/cli",
   "bugs": {

tools/release.mjs

@@ -186,9 +186,28 @@ function assertCorePackage(coreExtractDir) {
   }
 }
 
+function assertReadmeSync() {
+  step("Checking README sync between root and packages/cli");
+  for (const file of ["README.md", "README_CN.md"]) {
+    const rootPath = join(ROOT, file);
+    const cliPath = join(ROOT, "packages/cli", file);
+    const rootBuf = readFileSync(rootPath);
+    const cliBuf = readFileSync(cliPath);
+    if (!rootBuf.equals(cliBuf)) {
+      fail(
+        `${file} differs between root and packages/cli. ` +
+          `Sync them manually (e.g. \`cp ${file} packages/cli/${file}\`).`,
+      );
+    }
+    log(`${file}: in sync`);
+  }
+}
+
 function validatePackages() {
   const jsonByKey = new Map();
 
+  assertReadmeSync();
+
   step("Checking package metadata");
   for (const pkg of PACKAGES) {
     const json = packageJson(pkg);