sino-bc-cli 1.0.5 → 1.0.6

package/README.md

@@ -4,10 +4,98 @@ BeyondClick 命令行工具集合 - 提供快捷访问 BeyondClick 平台的命
 
 ## Install
 
+> ⚠️ 本包是**全局 CLI 工具**。npm 官网右侧 Install 框里的 `npm i sino-bc-cli` 是网站写死的固定文案，不是本包的推荐用法，请以下面的命令为准（注意 `-g`）。
+>
+> 运行环境要求 Node.js >= 24.0.0。
+
+### ① 安装最新版本（推荐）
+
 ```bash
-npm i sino-bc-cli -g
+# npm
+npm i sino-bc-cli@latest -g
+
+# pnpm
+pnpm add -g sino-bc-cli@latest
+
+# yarn
+yarn global add sino-bc-cli@latest
+```
+
+已经装过旧版本时，执行同样的命令即可升级覆盖。想先确认远端最新版本号：
+
+```bash
+npm view sino-bc-cli version        # 查看 latest 版本号
+npm outdated -g sino-bc-cli         # 对比本地全局版本是否过期
+```
+
+### ② 安装指定版本
+
+把 `@latest` 换成目标版本号即可，适用于需要回退或锁定版本的场景：
+
+```bash
+# npm
+npm i sino-bc-cli@1.0.5 -g
+
+# pnpm
+pnpm add -g sino-bc-cli@1.0.5
+
+# yarn
+yarn global add sino-bc-cli@1.0.5
+```
+
+查看全部可安装版本：
+
+```bash
+npm view sino-bc-cli versions --json
+```
+
+### ③ 卸载
+
+```bash
+# npm
+npm uninstall -g sino-bc-cli
+
+# pnpm
+pnpm remove -g sino-bc-cli
+
+# yarn
+yarn global remove sino-bc-cli
+```
+
+> 如果当初是在源码目录用 `npm link` 做的开发链接，请改用 `npm unlink -g sino-bc-cli` 解除。
+
+### ④ 验证安装
+
+```bash
+sino-bc-cli --version    # 输出版本号，说明命令已可用
+sino-bc-cli --help       # 输出帮助信息和全部可用命令
+npm ls -g --depth=0 sino-bc-cli   # 确认全局安装的版本
 ```
 
+若提示「command not found / 无法将 sino-bc-cli 项识别为命令」，说明 npm 全局 bin 目录不在 `PATH` 中。用 `npm prefix -g` 查看全局安装根目录（Windows 下该目录即 bin 目录，macOS / Linux 下为其 `bin` 子目录），把它加入环境变量后重开终端。
+
+### ⑤ 初始化（必须执行一次）
+
+**装完之后必须完成 `/init` 初始化，CLI 的 Agent 技能才会生效。**
+
+全局安装时 `postinstall` 会自动执行一次 `/init`。但在以下情况会被跳过，需要手动补执行：使用 `--ignore-scripts` 安装、安装目录权限不足、或通过 `npx` 临时运行。
+
+```bash
+sino-bc-cli /init
+```
+
+`/init` 会把 `SKILL.md` 写入用户主目录的 Agent 技能目录（`~/.agents/skills/sino-bc-cli` 等），Cursor / Claude / Codex / 飞书豆包工作 才能识别到本技能。飞书豆包工作侧还需：技能·连接器 → 管理 → **本地** → 刷新。
+
+> 每次升级版本后建议重新执行一次 `sino-bc-cli /init`，以刷新本地技能文件。
+
+### ⑥ 免安装临时执行
+
+```bash
+npx sino-bc-cli /homepage
+```
+
+注意 `npx` 方式不会持久注册 Agent 技能，需要技能能力时仍请走全局安装 + `/init`。
+
 ---
 
 ## 📚 技术栈说明

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sino-bc-cli",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "BeyondClick CLI - 命令行工具集合，提供快捷访问 BeyondClick 平台的命令行接口",
   "preferGlobal": true,
   "bin": {