From fb0c4b81be047bebcffd82a3291c3e7c5e12a6f7 Mon Sep 17 00:00:00 2001 From: rendianmeng Date: Tue, 28 Jul 2026 14:08:32 +0800 Subject: [PATCH] docs: install shell md --- AGENTS.md | 3 +-- INSTALL.md | 10 +++++++++- docs/agents/publish.md | 2 -- 3 files changed, 10 insertions(+), 5 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 7612e4d..213f4eb 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -68,8 +68,7 @@ Skill / 命令手册随 `skills/bailian-cli/` 经 `npx skills add modelstudioai/ | 鉴权扩展 | 加 OAuth / SSO / 换 token 来源 | [docs/agents/auth-change.md](docs/agents/auth-change.md) | | 配置项扩展 | 新 env var 或 `~/.bailian/config.json` 字段 | [docs/agents/config-add.md](docs/agents/config-add.md) | | Profile / 激活 | 改命名 Profile、预设或 `active_config` | [docs/agents/config-profile-change.md](docs/agents/config-profile-change.md) | -| 发布 | channel / stable 发布到 npm（CI 驱动） | [docs/agents/publish.md](docs/agents/publish.md) | -| 二进制分发 | Bun compile / install.sh / GitHub Releases / update 分流 | [docs/agents/binary-distribution.md](docs/agents/binary-distribution.md) | +| 发布 | channel / stable 发 npm + 二进制（Bun / GitHub Release / OSS）；安装脚本仓外维护 | [docs/agents/publish.md](docs/agents/publish.md) | | Change Log | 发版说明 / 历史版本说明 | [docs/agents/changelog-write.md](docs/agents/changelog-write.md) | | 工具链调整 | lint 规则 / 构建配置 / 依赖升级 | [docs/agents/lint-toolchain.md](docs/agents/lint-toolchain.md) | | Command Pack | 扩展包 / 白名单 / plugin 管理命令 | [docs/agents/command-pack.md](docs/agents/command-pack.md) | diff --git a/INSTALL.md b/INSTALL.md index 608c4b8..475dc3b 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -8,7 +8,13 @@ curl -fsSL https://bailian.aliyun.com/install.sh | bash ``` -可选：默认读 `manifest.json`（正式版）；`bash install.sh --channel sync-release` 读 channel 清单做验证；`--version` 钉版本；`--cdn` / `BAILIAN_CLI_CDN` 覆盖资源 CDN 根。 +可选：正式安装读 CDN 上的 `manifest.json`。预发 / channel 验证示例： + +```bash +curl -fsSL https://bailian.aliyun.com/install.sh | bash -s -- --channel sync-release +``` + +也可用 `--version` / `--cdn`（或环境变量 `BAILIAN_CLI_CDN`）覆盖资源根。安装脚本本身不在本仓库维护。 Windows PowerShell： @@ -16,6 +22,8 @@ Windows PowerShell： irm https://bailian.aliyun.com/install.ps1 | iex ``` +带参时先落盘再执行（`irm | iex` 不便传参），或使用仓外静态资源文档中的预发入口。 + 校验： ```bash diff --git a/docs/agents/publish.md b/docs/agents/publish.md index 95c77de..2cdc71d 100644 --- a/docs/agents/publish.md +++ b/docs/agents/publish.md @@ -47,7 +47,6 @@ publish-stable.mjs / publish-channel.mjs ← 唯一发版入口 4. CI 自动：自检 → **npm 发到 latest** → **推送 git tag `v`** → **Bun 编二进制并创建/更新 GitHub Release** → 完成 5. 如果所选发布集合的当前版本已全部存在于 npm，stable 发布会失败并提示先升级版本号；如果只有部分包已发布，CI 会继续补发缺失包 6. 对应脚本：`tools/release/publish-stable.mjs` -7. 二进制上传使用 `GITHUB_TOKEN`（`gh release`），**不需要** OSS AccessKey ## 自检（`tools/release/check.mjs`） @@ -108,7 +107,6 @@ node tools/release/publish-channel.mjs --channel test --knowledge --dry-run - [ ] 验证 npm 上能装：`npm view bailian-cli@ version`;如发布 `knowledge-studio-cli`，同时 `npm view knowledge-studio-cli@ version` - [ ] 试装一次：`npm i -g bailian-cli@ && bl --version`;如发布 `knowledge-studio-cli`，同时 `npm i -g knowledge-studio-cli@ && kscli --version` -- [ ] （若本次含二进制）GitHub Release 可见 `bl-*.zip` + `SHA256SUMS`；OSS 侧 `latest.json` / `.json`、`v/*` 与 `install.sh`/`install.ps1` 已由 CI 直传 ## 常见漏点（基于历史踩坑）