@fastgpt-plugin/cli 0.1.0-beta.5 → 0.1.0-beta.7

package/dist/index.js

@@ -56,7 +56,11 @@ const PluginUniqueIdSchema = z.object({
 	etag: z.string()
 });
 const PluginSourceSchema = z.literal("system").or(z.string());
-const PluginTagListSchema = z.array(z.record(z.string(), I18nStringStrictSchema));
+const PluginTagListItemSchema = z.object({
+	id: z.string(),
+	name: I18nStringStrictSchema
+});
+const PluginTagListSchema = z.array(PluginTagListItemSchema);
 const PluginRuntimeModeSchema = z.enum(["localPool", "serverless"]);
 const PluginRuntimeModeEnum = PluginRuntimeModeSchema.enum;
 const UserPluginIdSchema = z.object({
@@ -192,22 +196,26 @@ async function buildToolPackage(options) {
 		const tempIndexPath = path.join(tempDir, "index.ts");
 		const tBuildStart = Date.now();
 		await build({
+			deps: { alwaysBundle: [
+				"*",
+				"*/*",
+				"@*/*"
+			] },
 			entry: { index: tempIndexPath },
 			outDir: outputDir,
 			format: [options.format],
 			clean: true,
 			minify: options.minify,
-			inlineOnly: ["*"],
 			nodeProtocol: true,
 			platform: "node",
 			target: "node22",
 			dts: false,
 			treeshake: true,
-			noExternal: ["*"],
 			outExtensions: () => ({
 				dts: ".d.ts",
 				js: ".js"
-			})
+			}),
+			outputOptions: { codeSplitting: false }
 		});
 		tBuild = Date.now() - tBuildStart;
 		const tAssembleStart = Date.now();
@@ -531,7 +539,7 @@ var CheckCommand = class extends BaseCommand {
 //#endregion
 //#region package.json
 var name = "@fastgpt-plugin/cli";
-var version = "0.1.0-beta.5";
+var version = "0.1.0-beta.7";
 
 //#endregion
 //#region src/constants.ts
@@ -640,7 +648,7 @@ var CreateCommand = class extends BaseCommand {
 		const targetDir = path.resolve(options.cwd, options.name);
 		const templateDir = path.join(TOOL_TEMPLATES_DIR, "tool");
 		const files = await this.collectTemplateFiles(templateDir);
-		const description = options.description ?? DEFAULT_PLUGIN_DESCRIPTION;
+		const description = options.description ?? "This is a FastGPT plugin";
 		await this.ensureDir(targetDir);
 		for (const rel of files) {
 			const templatePath = path.join(templateDir, rel);
@@ -858,9 +866,13 @@ const FileMetaSchema = z.object({
 	createTime: z.date()
 });
 const FileCreateSchema = z.object({
+	/** 如果未提供 fileKey，则生成一个随机值 */
 	fileKey: z.string().optional(),
+	/** 路径，将会拼接在 fileName 之前 */
 	path: z.string().optional(),
+	/** 如果未提供fileName，则默认设置为 fileKey 的值 */
 	fileName: z.string().optional(),
+	/** 如果未提供 contentType，则尝试进行探测，探测失败则设置为 application/octet-stream */
 	contentType: MIMESchema.optional(),
 	overwrite: z.boolean().optional(),
 	file: z.union([z.instanceof(Readable, { error: "Stream cannot be empty" }), z.union([z.instanceof(Buffer, { error: "Buffer is required" }), z.instanceof(Uint8Array, { error: "Uint8Array is required" })]).transform((data) => {
@@ -876,11 +888,18 @@ const InvokeUploadFileInputSchema = z.object({ ...FileCreateSchema.omit({
 	overwrite: true,
 	path: true
 }).shape });
-const InvokeUploadFileOutputSchema = z.object({
-	...FileMetaSchema.omit({ fileKey: true }).shape,
-	accessURL: z.string()
+const InvokeUploadFileOutputSchema = z.object({ accessURL: z.string() });
+const InvokeUserInfoOutputSchema = z.object({
+	username: z.string(),
+	contact: z.string().nullish(),
+	memberName: z.string().nullish(),
+	orgs: z.array(z.object({
+		pathId: z.string(),
+		name: z.string()
+	})),
+	groups: z.array(z.object({ name: z.string() }))
 });
-const InvokeMethodEnumSchema = z.enum(["uploadFile"]);
+const InvokeMethodEnumSchema = z.enum(["uploadFile", "userInfo"]);
 const InvokeMethodEnum = InvokeMethodEnumSchema.enum;
 
 //#endregion
@@ -946,24 +965,15 @@ var StreamData = class StreamData {
 //#endregion
 //#region ../../packages/domain/src/value-objects/system-var.vo.ts
 const SystemVarSchema = z.object({
-	user: z.object({
-		id: z.string(),
-		username: z.string(),
-		contact: z.string(),
-		membername: z.string(),
-		teamName: z.string(),
-		teamId: z.string(),
-		name: z.string()
-	}),
 	app: z.object({
 		id: z.string(),
 		name: z.string()
 	}),
-	tool: z.object({
-		id: z.string(),
-		version: z.string(),
-		prefix: z.string().optional()
-	}).passthrough(),
+	chat: z.object({
+		chatId: z.string(),
+		uid: z.string().optional()
+	}),
+	invokeToken: z.string(),
 	time: z.string()
 });
 
@@ -996,7 +1006,6 @@ const ToolStreamMessageSchema = z.discriminatedUnion("type", [
 		data: z.string()
 	})
 ]);
-const ToolRunContextSchema = z.object({ systemVar: z.record(z.string(), z.unknown()) });
 const ToolRunInputSchema = z.object({
 	pluginId: z.string(),
 	version: z.preprocess((value) => {
@@ -1223,42 +1232,27 @@ async function runDebugTool({ runtime, snapshot, toolId, input, secrets, systemV
 }
 function createDebugSystemVar(snapshot, toolId, overrides) {
 	const base = {
-		user: {
-			id: "debug-user",
-			username: "debug-user",
-			contact: "debug@example.com",
-			membername: "debug-member",
-			teamName: "debug-team",
-			teamId: "debug-team-id",
-			name: "Local Debug User"
-		},
 		app: {
 			id: "debug-app",
 			name: "FastGPT Local Debug"
 		},
-		tool: {
-			id: snapshot.pluginId,
-			version: snapshot.version,
-			prefix: snapshot.isToolSet ? toolId : snapshot.pluginId,
-			token: "debug-token",
-			accessToken: "debug-access-token"
+		chat: {
+			chatId: "debug-chat",
+			uid: "debugger"
 		},
+		invokeToken: "debug-invoke-token",
 		time: (/* @__PURE__ */ new Date()).toISOString()
 	};
 	return SystemVarSchema.parse({
 		...base,
 		...overrides,
-		user: {
-			...base.user,
-			...overrides?.user ?? {}
-		},
 		app: {
 			...base.app,
 			...overrides?.app ?? {}
 		},
-		tool: {
-			...base.tool,
-			...overrides?.tool ?? {}
+		chat: {
+			...base.chat,
+			...overrides?.chat ?? {}
 		}
 	});
 }
@@ -1316,7 +1310,7 @@ function pickTargetTool(snapshot, toolId) {
 }
 function createVirtualHostHandler(uploadDir) {
 	return async ({ method, args, input }) => {
-		if (method !== HOST_INVOKE_METHOD) throw new Error(`本地虚拟环境暂不支持反向调用: ${method}`);
+		if (method !== "__host_invoke__") throw new Error(`本地虚拟环境暂不支持反向调用: ${method}`);
 		const payload = ensurePlainObject(args);
 		const invokeMethod = payload.method;
 		const invokeArgs = ensurePlainObject(payload.args);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fastgpt-plugin/cli",
-  "version": "0.1.0-beta.5",
+  "version": "0.1.0-beta.7",
   "type": "module",
   "private": false,
   "publishConfig": {
@@ -16,13 +16,6 @@
     "templates",
     "skills"
   ],
-  "scripts": {
-    "build": "tsdown",
-    "build:verbose": "tsdown",
-    "test": "vitest run",
-    "dev": "tsx src/index.ts",
-    "prepublishOnly": "pnpm run build"
-  },
   "dependencies": {
     "@oxc-parser/binding-wasm32-wasi": "^0.112.0",
     "@inquirer/prompts": "^8.2.0",
@@ -30,7 +23,7 @@
     "consola": "^3.4.2",
     "es-toolkit": "^1.44.0",
     "oxc-parser": "^0.112.0",
-    "tsdown": "^0.20.1",
+    "tsdown": "^0.21.10",
     "yazl": "^3.3.1",
     "yaml": "^2.6.1",
     "zod": "^4"
@@ -43,5 +36,11 @@
   },
   "engines": {
     "node": ">=22.12.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "build:verbose": "tsdown",
+    "test": "vitest run",
+    "dev": "tsx src/index.ts"
   }
-}
+}

package/skills/cli-usage/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: cli-usage
-description: 使用 FastGPT plugin CLI 时启用，适用于创建插件项目、构建 dist 产物、校验构建输出、打包 .pkg 文件，以及指导用户选择 create/build/check/pack 命令和参数。该技能使用通用说明风格，可被 Claude、Codex 等代理直接阅读。
+description: 使用 FastGPT plugin CLI 时启用，适用于创建插件项目、构建 dist 产物、校验构建输出、打包 .pkg 文件，以及指导用户选择 create/build/check/pack 命令和参数。
 ---
 
 # FastGPT CLI 使用技能
 
-在需要“使用 `apps/cli` 这个命令行工具”时使用这个技能，不用于修改 CLI 源码。
+在需要使用 FastGPT plugin CLI 完成插件创建、构建、检查或打包时使用这个技能。
 
 ## 适用场景
 
@@ -15,20 +15,6 @@ description: 使用 FastGPT plugin CLI 时启用，适用于创建插件项目
 - 想把构建产物打成 `.pkg`
 - 不确定该用 `create`、`build`、`check` 还是 `pack`
 
-## CLI 范围
-
-CLI 入口在 `apps/cli/src/cmd.ts`，当前主要命令有：
-
-- `create`
-- `build`
-- `check`
-- `pack`
-
-包名与可执行名见 `apps/cli/package.json`：
-
-- `@fastgpt-plugin/cli`
-- `fastgpt-plugin`
-
 ## 常用命令
 
 推荐两种调用方式：
@@ -64,7 +50,6 @@ npx @fastgpt-plugin/cli create my-suite --type tool-suite
 
 - `tool` 会生成单工具模板
 - `tool-suite` 会生成工具集模板
-- 模板目录在 `apps/cli/templates/tool`
 
 ### 2. 构建插件
 
@@ -128,20 +113,19 @@ npx @fastgpt-plugin/cli pack --entry ./path/to/plugin --dist ./dist --output ./o
 
 ## 排查建议
 
-- 模板生成不符合预期：检查 `apps/cli/templates/tool`
-- 命令参数不生效：检查 `apps/cli/src/commands/*.ts` 的 Commander 定义
-- 测试命令找不到用例：优先在 `apps/cli` 目录下运行 `pnpm test`
+- 命令无法执行：确认已安装 Node.js 和 pnpm，或直接使用 `npx @fastgpt-plugin/cli`
+- 参数不确定：先运行 `npx @fastgpt-plugin/cli <command> --help`
+- 构建失败：检查插件入口目录是否包含完整源码和 `manifest.json`
+- 打包失败：先运行 `build` 和 `check`，确认 `dist` 产物符合约定
 
 ## 验证
 
-在 `apps/cli` 目录下：
-
 ```bash
-pnpm fastgpt-plugin --help
+npx @fastgpt-plugin/cli --help
 ```
 
-如果已经安装依赖并希望用 pnpm 执行：
+如果项目中已经配置了 `pnpm fastgpt-plugin`：
 
 ```bash
-pnpm fastgpt-plugin create my-tool --type tool
+pnpm fastgpt-plugin --help
 ```