@lark-apaas/fullstack-cli 1.1.9 → 1.1.10

package/README.md

@@ -1,12 +1,14 @@
 # @lark-apaas/fullstack-cli
 
-> Fullstack 开发工具集 - 文件派生、数据库 Schema 生成、OpenAPI 生成
+> Fullstack 开发工具集 - 文件派生、数据库 Schema 生成、OpenAPI 生成、能力管理
 
 ## 功能
 
 1. **自动派生** - 自动管理项目脚本和配置文件
 2. **数据库 Schema 生成** - 从现有数据库生成 Drizzle ORM schema
 3. **OpenAPI 生成** - 自动生成 API 文档和客户端 SDK
+4. **Action 插件管理** - 安装、更新、删除 action 插件
+5. **能力配置管理** - 查看、充血、迁移能力配置
 
 ## 安装
 
@@ -72,7 +74,134 @@ CLIENT_BASE_PATH=/                   # 客户端基础路径
 2. 挂载 DevToolsModule
 3. 生成 OpenAPI 文档和客户端 SDK
 
-### 4. CLI 命令
+### 4. Action 插件管理
+
+管理 Action 插件的安装、更新、删除和查看：
+
+```bash
+# 安装插件（默认最新版）
+fullstack-cli action-plugin install @office/feishu-create-group
+
+# 安装指定版本
+fullstack-cli action-plugin install @office/feishu-create-group@1.0.0
+
+# 更新插件到最新版
+fullstack-cli action-plugin update @office/feishu-create-group
+
+# 删除插件
+fullstack-cli action-plugin remove @office/feishu-create-group
+
+# 查看已安装的插件列表
+fullstack-cli action-plugin list
+```
+
+**命令别名：**
+| 完整命令 | 别名 |
+|----------|------|
+| `action-plugin install` | `action-plugin i` |
+| `action-plugin update` | `action-plugin up` |
+| `action-plugin remove` | `action-plugin rm` |
+| `action-plugin list` | `action-plugin ls` |
+
+**插件存储：**
+- 插件文件：`node_modules/<plugin-name>/`（标准 npm 包位置）
+- 配置文件：`.capabilityrc.json`（记录已安装的 action 插件元信息）
+
+### 5. 能力配置管理
+
+查看和管理项目中的能力配置：
+
+```bash
+# 列出所有能力（充血后，带 actions 信息）
+fullstack-cli capability list
+
+# 列出所有能力（原始配置，不充血）
+fullstack-cli capability list --summary
+
+# 获取指定能力配置
+fullstack-cli capability list --id create_feishu_group_for_task
+
+# 获取指定能力原始配置
+fullstack-cli capability list --id create_feishu_group_for_task --summary
+```
+
+**能力充血：**
+- 默认返回充血后的能力配置，包含从插件 manifest 读取的 actions 信息
+- 支持动态 Schema：manifest 中标记 `{ dynamic: true }` 的 schema 会运行时生成
+- Schema 优先级：`capability.paramsSchema > 动态 schema > 静态 schema`
+- 充血失败时返回原始配置 + `_hydrateError` 字段（不抛异常）
+- `--summary` 返回原始配置（存储在 `server/capabilities/*.json` 中的内容）
+
+### 6. 能力迁移
+
+将老版本 capability 配置（`capabilities.json`）迁移到新版本（独立 JSON 文件）：
+
+```bash
+# 执行迁移
+fullstack-cli capability migration
+
+# 预览模式（不修改文件）
+fullstack-cli capability migration --dry-run
+
+# 跳过插件安装
+fullstack-cli capability migration --skip-install
+
+# 跳过代码迁移
+fullstack-cli capability migration --skip-code
+```
+
+**迁移步骤：**
+
+1. **JSON 文件迁移**
+   - 读取 `server/capabilities.json`（老格式：数组）
+   - 转换为独立文件 `server/capabilities/<id>.json`（新格式）
+   - 自动备份原文件为 `capabilities.json.backup`
+
+2. **插件安装**
+   - 根据 `sourceActionID → pluginID` 映射表查找对应插件
+   - 自动调用 `fullstack-cli action-plugin install` 安装缺失的插件
+
+3. **代码迁移**
+   - 扫描 `server/` 目录下的 TypeScript 文件
+   - 移除 capability 直接导入 `import xxx from '@/capabilities/xxx'`
+   - 添加 `CapabilityService` 依赖注入
+   - 替换调用点为 `capabilityService.load('xxx').call('run', params)`
+
+**老格式 vs 新格式：**
+
+```typescript
+// 老格式 (capabilities.json)
+{
+  "id": "create_group",
+  "sourceActionID": "feishu_group_create",  // 老字段
+  "name": "创建群组",
+  "desc": "创建飞书群组",                    // 老字段
+  "actionInput": { ... },                    // 老字段
+  "inputSchema": { ... }
+}
+
+// 新格式 (server/capabilities/create_group.json)
+{
+  "id": "create_group",
+  "pluginID": "@official/feishu-group",      // 新字段
+  "pluginVersion": "1.0.0",                  // 新字段
+  "name": "创建群组",
+  "description": "创建飞书群组",             // 重命名
+  "formValue": { ... },                      // 重命名
+  "paramsSchema": { ... }
+}
+```
+
+**映射文件格式：**
+
+```json
+{
+  "feishu_group_create": "@official/feishu-group",
+  "feishu_send_message": "@official/feishu-message"
+}
+```
+
+### 7. CLI 命令
 
 ```bash
 # 查看帮助
@@ -84,6 +213,16 @@ fullstack-cli gen-db-schema
 # 生成 OpenAPI
 fullstack-cli gen-openapi
 
+# Action 插件管理
+fullstack-cli action-plugin --help
+fullstack-cli action-plugin install <plugin>
+fullstack-cli action-plugin list
+
+# 能力配置管理
+fullstack-cli capability --help
+fullstack-cli capability list
+fullstack-cli capability migration --dry-run
+
 # 查看版本
 fullstack-cli --version
 ```
@@ -179,6 +318,23 @@ fullstack-cli
 }
 ```
 
+### Capability 迁移
+
+如果项目使用老版本的 capability 系统（`capabilities.json` 文件），可以使用迁移命令自动升级：
+
+```bash
+# 1. 先预览迁移效果
+fullstack-cli capability migration --dry-run
+
+# 2. 确认无误后执行迁移
+fullstack-cli capability migration
+```
+
+迁移会自动完成：
+- JSON 配置文件格式转换
+- 插件安装
+- 代码调用方式更新（从直接导入改为 CapabilityService 注入）
+
 ## License
 
 MIT

package/dist/config/drizzle.config.d.ts

@@ -1,3 +1,5 @@
 import { Config } from 'drizzle-kit';
+
 declare const _default: Config;
-export default _default;
+
+export { _default as default };

package/dist/config/drizzle.config.js

@@ -1,17 +1,21 @@
-import { defineConfig } from 'drizzle-kit';
-const outputDir = process.env.__DRIZZLE_OUT_DIR__ || './server/database/.introspect';
-const schemaPath = process.env.__DRIZZLE_SCHEMA_PATH__ || './server/database/schema.ts';
-const parsedUrl = new URL(process.env.SUDA_DATABASE_URL || '');
-const schemaFilter = parsedUrl.searchParams.get('schema')?.split(',') ?? [];
-parsedUrl.searchParams.delete('schema'); // 移除schema参数，避免 drizzle-kit 解析错误
-const config = {
-    schema: schemaPath,
-    out: outputDir,
-    tablesFilter: ['*'],
-    schemaFilter,
-    dialect: 'postgresql',
-    dbCredentials: {
-        url: parsedUrl.toString(),
-    },
+// src/config/drizzle.config.ts
+import { defineConfig } from "drizzle-kit";
+var outputDir = process.env.__DRIZZLE_OUT_DIR__ || "./server/database/.introspect";
+var schemaPath = process.env.__DRIZZLE_SCHEMA_PATH__ || "./server/database/schema.ts";
+var parsedUrl = new URL(process.env.SUDA_DATABASE_URL || "");
+var schemaFilter = parsedUrl.searchParams.get("schema")?.split(",") ?? [];
+parsedUrl.searchParams.delete("schema");
+var config = {
+  schema: schemaPath,
+  out: outputDir,
+  tablesFilter: ["*"],
+  schemaFilter,
+  dialect: "postgresql",
+  dbCredentials: {
+    url: parsedUrl.toString()
+  }
+};
+var drizzle_config_default = defineConfig(config);
+export {
+  drizzle_config_default as default
 };
-export default defineConfig(config);

package/dist/index.d.ts

@@ -1 +1,2 @@
-export {};
+
+export {  }