qing-client 0.0.42 → 0.0.44

package/lib/service/EzAbilityService.d.ts

@@ -1,11 +1,13 @@
 import { BaseClient } from "../client/BaseClient";
 import { ClientConfig } from "../types";
-import { EnumerateRequirementsRequest, EnumerateRequirementsResponse, TaskQueryResponse, GetTasksQuery, TaskListResponse } from "../types/ez-ability";
+import { EnumerateRequirementsRequest, EnumerateRequirementsResponse, GeneratePRDRequest, GeneratePRDResponse, GenerateMVPRDRequest, GenerateMVPRDResponse, TaskQueryResponse, GetTasksQuery, GetPRDTasksQuery, GetMVPRDTasksQuery, TaskListResponse } from "../types/ez-ability";
 /**
  * EzAbility 服务 - AI 能力服务客户端
  *
  * 功能：
  * - 需求枚举（异步任务）
+ * - PRD生成（异步任务）
+ * - MVP PRD生成（异步任务）
  * - 任务列表查询（支持分页和过滤）
  * - 任务状态查询
  * - 任务取消
@@ -24,6 +26,91 @@ export declare class EzAbilityService extends BaseClient {
      * @returns 任务信息
      */
     enumerateRequirements(request: EnumerateRequirementsRequest): Promise<EnumerateRequirementsResponse>;
+    /**
+     * 创建PRD生成任务
+     *
+     * 支持两种模式：
+     * 1. 模式1（推荐）：只提供 userRequest，系统会自动枚举需求池
+     * 2. 模式2：直接提供 requirementsPool，跳过枚举步骤，直接生成PRD
+     *
+     * 异步任务，立即返回 taskId
+     * 进度通过 WebSocket 推送
+     *
+     * @param request PRD生成请求
+     * @returns 任务信息
+     */
+    generatePRD(request: GeneratePRDRequest): Promise<GeneratePRDResponse>;
+    /**
+     * 获取PRD任务列表
+     *
+     * 支持分页和过滤（按状态）
+     * 默认过滤PRD生成任务
+     *
+     * @param query 查询参数
+     * @returns 任务列表响应
+     */
+    getPRDTasks(query?: GetPRDTasksQuery): Promise<TaskListResponse>;
+    /**
+     * 查询PRD任务状态
+     *
+     * 用于轮询或重连后恢复任务状态
+     *
+     * @param taskId 任务ID
+     * @returns 任务详情
+     */
+    getPRDTask(taskId: string): Promise<TaskQueryResponse>;
+    /**
+     * 取消PRD任务
+     *
+     * @param taskId 任务ID
+     * @returns 取消结果
+     */
+    cancelPRDTask(taskId: string): Promise<{
+        message: string;
+    }>;
+    /**
+     * 创建MVP PRD生成任务
+     *
+     * 支持三种模式：
+     * 1. 模式1（推荐）：只提供 userRequest，系统会自动枚举需求池（3轮）
+     * 2. 模式2：直接提供 requirementsPool，跳过枚举步骤，直接生成PRD
+     * 3. 模式3：设置 skipEnumeration=true，跳过枚举阶段，直接生成PRD
+     *
+     * 异步任务，立即返回 taskId
+     * 进度通过 WebSocket 推送
+     *
+     * @param request MVP PRD生成请求
+     * @returns 任务信息
+     */
+    generateMVPRD(request: GenerateMVPRDRequest): Promise<GenerateMVPRDResponse>;
+    /**
+     * 获取MVP PRD任务列表
+     *
+     * 支持分页和过滤（按状态）
+     * 默认过滤MVP PRD生成任务
+     *
+     * @param query 查询参数
+     * @returns 任务列表响应
+     */
+    getMVPRDTasks(query?: GetMVPRDTasksQuery): Promise<TaskListResponse>;
+    /**
+     * 查询MVP PRD任务状态
+     *
+     * 用于轮询或重连后恢复任务状态
+     *
+     * @param taskId 任务ID
+     * @returns 任务详情
+     */
+    getMVPRDTask(taskId: string): Promise<TaskQueryResponse>;
+    /**
+     * 取消MVP PRD任务
+     *
+     * @param taskId 任务ID
+     * @returns 取消结果
+     */
+    cancelMVPRDTask(taskId: string): Promise<{
+        message: string;
+    }>;
     /**
      * 获取任务列表
      *

package/lib/service/EzAbilityService.js

@@ -8,6 +8,8 @@ const BaseClient_1 = require("../client/BaseClient");
  *
  * 功能：
  * - 需求枚举（异步任务）
+ * - PRD生成（异步任务）
+ * - MVP PRD生成（异步任务）
  * - 任务列表查询（支持分页和过滤）
  * - 任务状态查询
  * - 任务取消
@@ -34,6 +36,123 @@ class EzAbilityService extends BaseClient_1.BaseClient {
             body: request,
         });
     }
+    // ==================== PRD生成 ====================
+    /**
+     * 创建PRD生成任务
+     *
+     * 支持两种模式：
+     * 1. 模式1（推荐）：只提供 userRequest，系统会自动枚举需求池
+     * 2. 模式2：直接提供 requirementsPool，跳过枚举步骤，直接生成PRD
+     *
+     * 异步任务，立即返回 taskId
+     * 进度通过 WebSocket 推送
+     *
+     * @param request PRD生成请求
+     * @returns 任务信息
+     */
+    async generatePRD(request) {
+        return this.request("/prd/generate", {
+            method: "POST",
+            body: request,
+        });
+    }
+    /**
+     * 获取PRD任务列表
+     *
+     * 支持分页和过滤（按状态）
+     * 默认过滤PRD生成任务
+     *
+     * @param query 查询参数
+     * @returns 任务列表响应
+     */
+    async getPRDTasks(query) {
+        return this.request("/prd/tasks", {
+            method: "GET",
+            params: {
+                ...query,
+                type: query?.type || 'prd-generate', // 默认过滤PRD任务
+            },
+        });
+    }
+    /**
+     * 查询PRD任务状态
+     *
+     * 用于轮询或重连后恢复任务状态
+     *
+     * @param taskId 任务ID
+     * @returns 任务详情
+     */
+    async getPRDTask(taskId) {
+        return this.request(`/prd/tasks/${taskId}`, { method: "GET" });
+    }
+    /**
+     * 取消PRD任务
+     *
+     * @param taskId 任务ID
+     * @returns 取消结果
+     */
+    async cancelPRDTask(taskId) {
+        return this.request(`/prd/tasks/${taskId}`, { method: "DELETE" });
+    }
+    // ==================== MVP PRD生成 ====================
+    /**
+     * 创建MVP PRD生成任务
+     *
+     * 支持三种模式：
+     * 1. 模式1（推荐）：只提供 userRequest，系统会自动枚举需求池（3轮）
+     * 2. 模式2：直接提供 requirementsPool，跳过枚举步骤，直接生成PRD
+     * 3. 模式3：设置 skipEnumeration=true，跳过枚举阶段，直接生成PRD
+     *
+     * 异步任务，立即返回 taskId
+     * 进度通过 WebSocket 推送
+     *
+     * @param request MVP PRD生成请求
+     * @returns 任务信息
+     */
+    async generateMVPRD(request) {
+        return this.request("/prd-mvp/generate", {
+            method: "POST",
+            body: request,
+        });
+    }
+    /**
+     * 获取MVP PRD任务列表
+     *
+     * 支持分页和过滤（按状态）
+     * 默认过滤MVP PRD生成任务
+     *
+     * @param query 查询参数
+     * @returns 任务列表响应
+     */
+    async getMVPRDTasks(query) {
+        return this.request("/prd-mvp/tasks", {
+            method: "GET",
+            params: {
+                ...query,
+                type: query?.type || 'prd-mvp-generate', // 默认过滤MVP PRD任务
+            },
+        });
+    }
+    /**
+     * 查询MVP PRD任务状态
+     *
+     * 用于轮询或重连后恢复任务状态
+     *
+     * @param taskId 任务ID
+     * @returns 任务详情
+     */
+    async getMVPRDTask(taskId) {
+        return this.request(`/prd-mvp/tasks/${taskId}`, { method: "GET" });
+    }
+    /**
+     * 取消MVP PRD任务
+     *
+     * @param taskId 任务ID
+     * @returns 取消结果
+     */
+    async cancelMVPRDTask(taskId) {
+        return this.request(`/prd-mvp/tasks/${taskId}`, { method: "DELETE" });
+    }
     // ==================== 任务管理 ====================
     /**
      * 获取任务列表

package/lib/types/ez-ability.d.ts

@@ -28,9 +28,66 @@ export interface EnumerateRequirementsResult {
     totalRounds: number;
     totalCount: number;
 }
+export interface GeneratePRDRequest {
+    /** 需求描述（用户的原始需求文本） */
+    userRequest: string;
+    /** 可选：直接提供需求池，跳过枚举步骤 */
+    requirementsPool?: string[];
+    /** 枚举轮数（3-10），如果提供了需求池，此参数会被忽略，默认 5 */
+    maxEnumerationRounds?: number;
+    /** 指定使用的模型（不传则使用服务默认模型） */
+    model?: string;
+}
+export interface GeneratePRDResponse {
+    taskId: string;
+    status: TaskStatus;
+    message: string;
+    /** 使用的模式：'enumerate' = 自动枚举需求池，'direct' = 直接使用提供的需求池 */
+    mode?: 'enumerate' | 'direct';
+}
+export interface GeneratePRDResult {
+    taskId: string;
+    prdFilePath?: string;
+    prdContent?: string;
+    totalRequirements: number;
+    totalSections: number;
+    processingTime: number;
+}
+export interface GenerateMVPRDRequest {
+    /** 需求描述（用户的原始需求文本） */
+    userRequest: string;
+    /** 可选：直接提供需求池，跳过枚举步骤 */
+    requirementsPool?: string[];
+    /** 枚举轮数（2-5），如果提供了需求池或skipEnumeration=true，此参数会被忽略，默认 3 */
+    maxEnumerationRounds?: number;
+    /** 可选：跳过枚举阶段，直接生成PRD */
+    skipEnumeration?: boolean;
+    /** 指定使用的模型（不传则使用服务默认模型） */
+    model?: string;
+}
+export interface GenerateMVPRDResponse {
+    taskId: string;
+    status: TaskStatus;
+    message: string;
+    /** 使用的模式：'enumerate' = 自动枚举需求池，'direct' = 直接使用提供的需求池，'skip-enumeration' = 跳过枚举 */
+    mode?: 'enumerate' | 'direct' | 'skip-enumeration';
+}
+export interface GenerateMVPRDResult {
+    taskId: string;
+    prdFilePath?: string;
+    prdContent?: string;
+    totalRequirements: number;
+    totalSections: number;
+    processingTime: number;
+}
+export interface GetMVPRDTasksQuery extends GetTasksQuery {
+    /** 默认过滤MVP PRD生成任务 */
+    type?: 'prd-mvp-generate';
+}
 export declare const TASK_TYPES: {
     readonly ENUMERATE_REQUIREMENTS: "enumerate-requirements";
     readonly PRD_GENERATE: "prd-generate";
+    readonly PRD_MVP_GENERATE: "prd-mvp-generate";
     readonly DATA_ANALYSIS: "data-analysis";
     readonly GATEWAY_TASK: "gateway-task";
 };
@@ -57,6 +114,10 @@ export interface GetTasksQuery {
     /** 偏移量，默认 0 */
     offset?: number;
 }
+export interface GetPRDTasksQuery extends GetTasksQuery {
+    /** 默认过滤PRD生成任务 */
+    type?: 'prd-generate';
+}
 export interface TaskListItem {
     taskId: string;
     type: string;

package/lib/types/ez-ability.js

@@ -7,6 +7,7 @@ exports.TASK_TYPES = void 0;
 exports.TASK_TYPES = {
     ENUMERATE_REQUIREMENTS: 'enumerate-requirements',
     PRD_GENERATE: 'prd-generate',
+    PRD_MVP_GENERATE: 'prd-mvp-generate',
     DATA_ANALYSIS: 'data-analysis',
     GATEWAY_TASK: 'gateway-task',
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qing-client",
-  "version": "0.0.42",
+  "version": "0.0.44",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "scripts": {