@chatbi-v/cli 3.0.0 → 3.1.1

package/README.md

@@ -12,6 +12,7 @@
 ## 安装和使用方法
 
 ### 安装 CLI
+
 ```bash
 npm install -g @chatbi-v/cli
 # 或使用 pnpm
@@ -19,11 +20,13 @@ pnpm add -g @chatbi-v/cli
 ```
 
 ### 初始化项目
+
 ```bash
 chatbi-cli init my-app --project-type app
 ```
 
 ### 启动开发环境
+
 ```bash
 chatbi-cli dev
 ```
@@ -43,12 +46,15 @@ chatbi-cli dev
 ## 核心理念
 
 ### 1. 零显式依赖 (Zero-Install)
+
 开发者在初始化项目后，无需在本地项目 `package.json` 中安装庞大的 `@chatbi-v/core` 或相关内核依赖。CLI 通过虚拟上下文技术，在运行时自动链接到全局沙箱环境，保持项目轻量化。
 
 ### 2. 全局沙箱 (Global Sandbox)
+
 内核依赖统一管理在用户根目录下的 `~/.chatbi-v-core` 中。一次安装，多项目共享。支持多版本管理与无缝升级。
 
 ### 3. CoreKit 驱动
+
 内置 CoreKit 开发套件，为 App 提供高性能预览服务器，为 Plugin 提供“托管式 Shell”调试环境，确保开发体验与生产环境高度一致。
 
 ---
@@ -56,6 +62,7 @@ chatbi-cli dev
 ## 快速开始
 
 ### 安装 CLI
+
 ```bash
 npm install -g @chatbi-v/cli
 # 或使用 pnpm
@@ -65,64 +72,80 @@ pnpm add -g @chatbi-v/cli
 ### 初始化项目
 
 #### 创建一个独立应用 (App)
+
 ```bash
 chatbi-cli init my-app --project-type app
 ```
 
 #### 创建一个插件 (Plugin)
+
 ```bash
 chatbi-cli init my-plugin --project-type plugin
 ```
 
 #### 创建一个 Monorepo 工作空间
+
 ```bash
 chatbi-cli init my-workspace --project-type monorepo
 ```
 
+默认会生成基于工作区的插件目录约定；当前模板使用 `packages/plugins/*` 作为插件包位置。
+
 ### 启动开发环境
+
 进入项目目录后执行：
+
 ```bash
 npm run dev
 # 或者直接使用 cli
 chatbi-cli dev
 ```
+
 - **App/Plugin 模式**: 直接启动当前项目。
-- **Monorepo 模式**: 自动扫描并提供交互式菜单，选择要启动的子应用或插件。
+- **Monorepo 模式**: 自动扫描工作区中声明的子应用或插件包，并提供交互式菜单。
 
 ---
 
 ## 常用命令
 
-| 命令 | 别名 | 描述 |
-| :--- | :--- | :--- |
-| `init` | `i` | 初始化新项目 (App/Plugin/Monorepo) |
-| `dev` | `d` | 启动开发服务器 (支持热更新与沙箱加载) |
-| `build` | `b` | 构建生产环境产物 |
-| `use` | - | 切换使用的内核版本 (项目级或全局 `--global`) |
-| `ls` | - | 列出本地已安装的所有沙箱版本 |
-| `update` | - | 更新或修复全局沙箱内核版本 |
-| `sync` | `s` | 同步内核依赖与虚拟环境 (支持 `-v, --core-version`) |
-| `doctor` | - | 诊断并自动修复项目环境问题 |
-| `bench` | - | 运行 CLI 性能基准测试 |
-| `add` | - | 在 Monorepo 项目中添加新插件 |
-| `gl` | - | 使用 AI 助手生成代码、文档或组件 |
-| `discover` | - | 发现并列出当前工作空间的所有包 |
+| 命令       | 别名 | 描述                                               |
+| :--------- | :--- | :------------------------------------------------- |
+| `init`     | `i`  | 初始化新项目 (App/Plugin/Monorepo)                 |
+| `dev`      | `d`  | 启动开发服务器 (支持热更新与沙箱加载)              |
+| `build`    | `b`  | 构建生产环境产物                                   |
+| `use`      | -    | 切换使用的内核版本 (项目级或全局 `--global`)       |
+| `ls`       | -    | 列出本地已安装的所有沙箱版本                       |
+| `update`   | -    | 更新或修复全局沙箱内核版本                         |
+| `sync`     | `s`  | 同步内核依赖与虚拟环境 (支持 `-v, --core-version`) |
+| `doctor`   | -    | 诊断并自动修复项目环境问题                         |
+| `bench`    | -    | 运行 CLI 性能基准测试                              |
+| `add`      | -    | 在 Monorepo 项目的插件工作区中添加新插件           |
+| `gl`       | -    | 使用 AI 助手生成代码、文档或组件                   |
+| `discover` | -    | 发现并列出当前工作空间的所有包                     |
 
 ---
 
 ## 高级特性
 
+### 工作区插件定位
+
+CLI 会优先依据当前工作区配置解析插件目录，而不是假定插件固定放在某个硬编码路径下。当前官方 Monorepo 模板默认使用 `packages/plugins/*`。
+
 ### 版本锁定 (`.chatbi-version`)
+
 在项目根目录创建一个 `.chatbi-version` 文件，内容为指定的版本号（如 `1.0.11`）。CLI 会优先使用该文件定义的版本，确保团队开发环境的高度一致。
 
 ### 极速预览
+
 得益于 **CoreKit 托管容器**，插件项目的冷启动时间通常在 3 秒以内，且支持秒级 HMR 热更新。
 
 ---
 
 ## 性能基准 (Benchmark)
+
 你可以通过运行 `chatbi-cli bench` 来验证当前环境下的性能表现。
 典型指标：
+
 - 项目初始化: ≤ 2s
 - 增量编译 (HMR): ≤ 0.5s
 - 核心依赖占用: ≤ 150MB (多项目共享)
@@ -149,4 +172,5 @@ A: 运行 `dev` 后，访问控制台输出的 Preview URL，即可在模拟的
 ---
 
 ## 许可证
+
 MIT License @ 2025 ChatBI-V Team

package/bin/chatbi-cli.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-import('../dist/index.js')
+import('../dist/index.js');