weaver-work-cli 0.1.20 → 0.1.22

package/dist/shortcuts/caizhilian/operations/handlers/file-collection.js

@@ -1,16 +1,19 @@
 /**
  * caizhilian.file-collection — 文件采集（FTP/SFTP）
  *
- * 覆盖文件采集的生命周期：
- * - 任务列表/详情/删除
- * - 扫描/运行/取消
- * - 进度查询/结果查询
+ * 覆盖文件采集的完整生命周期：
+ * - 任务列表/详情/保存/删除/另存为/开关切换
+ * - 全宗 ID 更新（归档分支）
+ * - 连接器查询/创建、FTP 资源创建
+ * - 动作流搜索/检测/创建/启用/绑定
+ * - 扫描/运行/取消、等待完成、结果归一化
  *
  * 接口：
  * - 列任务：GET /api/file/coll/taskTable
  * - 读表单：GET /api/file/coll/taskForm
  * - 保存任务：POST /api/file/coll/save
  * - 另存为：POST /api/file/coll/saveAs
+ * - 切换开关：POST /api/file/coll/switch
  * - 检查存储：GET /api/file/coll/checkStorageConnect
  * - 扫描：POST /api/file/coll/scan
  * - 扫描进度：GET /api/file/coll/scan/progress
@@ -19,10 +22,23 @@
  * - 详情：GET /api/file/coll/detailTable
  * - 取消：POST /api/file/coll/cancel
  * - 删除：POST /api/file/coll/delete
+ * - 连接器列表：GET /api/bs/esb/setting/connector/getConnectorListPage
+ * - 资源列表：GET /api/bs/esb/setting/resource/getResourceListPage
+ * - 创建连接器：POST /api/bs/esb/setting/systemPool/save
+ * - 创建 FTP 资源：POST /api/bs/esb/setting/resource/ftp/save
+ * - 动作流列表：POST /api/bs/esb/setting/application/getApplicationListPage
+ * - 动作流详情：GET /api/bs/esb/setting/application/getAppById/{id}
+ * - 动作流版本：GET /api/bs/esb/setting/application/version/versionList/{id}
+ * - 动作流设计：GET /api/bs/esb/setting/flow/design/getDesignBySceneId/{id}
+ * - 创建动作流：POST /api/bs/esb/setting/application/save
+ * - 注册变量：POST /api/bs/esb/setting/application/variable/addVariable
+ * - 校验设计：POST /api/bs/esb/setting/flow/design/check
+ * - 保存设计：POST /api/bs/esb/setting/flow/design/saveDesign
+ * - 启用动作流：GET /api/bs/esb/setting/application/startUseApp/{id}
  */
 import { CaizhilianCliError } from '../../errors.js';
 import { caizhilianSuccess } from '../types.js';
-import { requireId } from '../shared.js';
+import { requireId, requireNonEmpty } from '../shared.js';
 const ACTION = 'caizhilian.file-collection';
 // ── 接口路径 ──────────────────────────────────────────────
 const LIST_TASKS_PATH = '/api/file/coll/taskTable';
@@ -37,6 +53,21 @@ const RUN_PROGRESS_PATH = '/api/file/coll/run/progress';
 const DETAIL_TABLE_PATH = '/api/file/coll/detailTable';
 const CANCEL_PATH = '/api/file/coll/cancel';
 const DELETE_PATH = '/api/file/coll/delete';
+const SWITCH_PATH = '/api/file/coll/switch';
+const SAVE_AS_PATH = '/api/file/coll/saveAs';
+const CONNECTOR_LIST_PATH = '/api/bs/esb/setting/connector/getConnectorListPage';
+const RESOURCE_LIST_PATH = '/api/bs/esb/setting/resource/getResourceListPage';
+const SYSTEM_POOL_SAVE_PATH = '/api/bs/esb/setting/systemPool/save';
+const FTP_RESOURCE_SAVE_PATH = '/api/bs/esb/setting/resource/ftp/save';
+const APP_LIST_PATH = '/api/bs/esb/setting/application/getApplicationListPage';
+const APP_DETAIL_PATH = '/api/bs/esb/setting/application/getAppById';
+const APP_VERSION_PATH = '/api/bs/esb/setting/application/version/versionList';
+const DESIGN_BY_SCENE_PATH = '/api/bs/esb/setting/flow/design/getDesignBySceneId';
+const APP_SAVE_PATH = '/api/bs/esb/setting/application/save';
+const APP_VARIABLE_PATH = '/api/bs/esb/setting/application/variable/addVariable';
+const DESIGN_CHECK_PATH = '/api/bs/esb/setting/flow/design/check';
+const DESIGN_SAVE_PATH = '/api/bs/esb/setting/flow/design/saveDesign';
+const APP_ENABLE_PATH = '/api/bs/esb/setting/application/startUseApp';
 // ── 辅助函数 ──────────────────────────────────────────────
 function asRecord(value) {
     return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
@@ -113,11 +144,11 @@ async function checkStorage(args, env) {
 async function scanPrepare(args, env) {
     const taskId = requireId(args.task_id, 'task_id');
     const fullColl = args.full_coll ?? false;
-    // 签发 continuation
+    // 签发 continuation（键名与 targetKeys 保持一致，均为 snake_case）
     const continuation = await env.continuation.issue({
         operation: 'caizhilian.file-collection.scan.apply',
-        taskId,
-        fullColl,
+        task_id: taskId,
+        full_coll: fullColl,
     });
     return caizhilianSuccess('caizhilian.file-collection.scan.prepare', {
         task_id: taskId,
@@ -126,8 +157,8 @@ async function scanPrepare(args, env) {
     });
 }
 async function scanApply(args, env, lease) {
-    const taskId = lease.payload?.taskId;
-    const fullColl = lease.payload?.fullColl;
+    const taskId = lease.task_id;
+    const fullColl = lease.full_coll;
     const response = await env.host.request({
         method: 'POST',
         path: SCAN_PATH,
@@ -172,10 +203,10 @@ async function scanProgress(args, env) {
 async function runPrepare(args, env) {
     const taskId = requireId(args.task_id, 'task_id');
     const action = args.action || 'run';
-    // 签发 continuation
+    // 签发 continuation（键名与 targetKeys 保持一致，均为 snake_case）
     const continuation = await env.continuation.issue({
         operation: 'caizhilian.file-collection.run.apply',
-        taskId,
+        task_id: taskId,
         action,
     });
     return caizhilianSuccess('caizhilian.file-collection.run.prepare', {
@@ -185,8 +216,8 @@ async function runPrepare(args, env) {
     });
 }
 async function runApply(args, env, lease) {
-    const taskId = lease.payload?.taskId;
-    const action = lease.payload?.action;
+    const taskId = lease.task_id;
+    const action = lease.action;
     const response = await env.host.request({
         method: 'POST',
         path: RUN_PATH,
@@ -250,10 +281,10 @@ async function detailTable(args, env) {
 // ── 取消采集（prepare/apply）──────────────────────────────────────
 async function cancelPrepare(args, env) {
     const taskId = requireId(args.task_id, 'task_id');
-    // 签发 continuation
+    // 签发 continuation（键名与 targetKeys 保持一致，均为 snake_case）
     const continuation = await env.continuation.issue({
         operation: 'caizhilian.file-collection.cancel.apply',
-        taskId,
+        task_id: taskId,
     });
     return caizhilianSuccess('caizhilian.file-collection.cancel.prepare', {
         task_id: taskId,
@@ -261,7 +292,7 @@ async function cancelPrepare(args, env) {
     });
 }
 async function cancelApply(args, env, lease) {
-    const taskId = lease.payload?.taskId;
+    const taskId = lease.task_id;
     const response = await env.host.request({
         method: 'POST',
         path: CANCEL_PATH,
@@ -284,10 +315,10 @@ async function cancelApply(args, env, lease) {
 // ── 删除采集任务（prepare/apply）──────────────────────────────────────
 async function deleteTaskPrepare(args, env) {
     const taskId = requireId(args.task_id, 'task_id');
-    // 签发 continuation
+    // 签发 continuation（键名与 targetKeys 保持一致，均为 snake_case）
     const continuation = await env.continuation.issue({
         operation: 'caizhilian.file-collection.delete.apply',
-        taskId,
+        task_id: taskId,
     });
     return caizhilianSuccess('caizhilian.file-collection.delete.prepare', {
         task_id: taskId,
@@ -295,7 +326,7 @@ async function deleteTaskPrepare(args, env) {
     });
 }
 async function deleteTaskApply(args, env, lease) {
-    const taskId = lease.payload?.taskId;
+    const taskId = lease.task_id;
     const response = await env.host.request({
         method: 'POST',
         path: DELETE_PATH,
@@ -315,10 +346,813 @@ async function deleteTaskApply(args, env, lease) {
         task_id: taskId,
     });
 }
+// ── 保存采集任务（prepare/apply）──────────────────────────────────────
+async function saveTaskPrepare(args, env) {
+    const sourceId = requireNonEmpty(args.source_id, 'source_id');
+    const workflowId = requireNonEmpty(args.workflow_id, 'workflow_id');
+    const taskName = args.task_name || '';
+    const retainDirStruct = args.retain_dir_struct ?? true;
+    const taskFilePath = args.task_file_path || '/';
+    // 签发 continuation（键名与 targetKeys 保持一致，均为 snake_case）
+    const continuation = await env.continuation.issue({
+        operation: 'caizhilian.file-collection.task.save.apply',
+        source_id: sourceId,
+        workflow_id: workflowId,
+        task_name: taskName,
+        retain_dir_struct: retainDirStruct,
+        task_file_path: taskFilePath,
+    });
+    return caizhilianSuccess('caizhilian.file-collection.task.save.prepare', {
+        source_id: sourceId,
+        workflow_id: workflowId,
+        task_name: taskName,
+        retain_dir_struct: retainDirStruct,
+        task_file_path: taskFilePath,
+        continuation,
+    });
+}
+async function saveTaskApply(args, env, lease) {
+    const sourceId = lease.source_id;
+    const workflowId = lease.workflow_id;
+    const taskName = lease.task_name;
+    const retainDirStruct = lease.retain_dir_struct;
+    const taskFilePath = lease.task_file_path;
+    const payload = {
+        taskStatus: '0',
+        taskName: taskName || `文件采集（${new Date().toLocaleString('zh-CN', { timeZone: 'Asia/Shanghai' }).replace(/[/:]/g, '').replace(' ', ' ').substring(0, 15)}）`,
+        taskSourceId: sourceId,
+        taskSourceType: 'ftp',
+        taskWorkflowId: workflowId,
+        taskFilePath: taskFilePath || '/',
+        retainDirStruct: retainDirStruct,
+        taskMethod: '1',
+        deleteType: '0',
+        taskSource: sourceId,
+    };
+    const response = await env.host.request({
+        method: 'POST',
+        path: SAVE_TASK_PATH,
+        body: payload,
+        operation: 'caizhilian.file-collection.task.save.apply',
+    });
+    const data = asRecord(response);
+    if (!data.status && !data.success) {
+        throw new CaizhilianCliError('api', 'business_error', String(data.msg || data.message || '保存采集任务失败'), {
+            code: data.code ?? data.status,
+            details: { action: 'caizhilian.file-collection.task.save.apply', message: String(data.msg || data.message || '保存采集任务失败') },
+            exitCode: 1,
+        });
+    }
+    const result = asRecord(data.data);
+    return caizhilianSuccess('caizhilian.file-collection.task.save.apply', {
+        task_id: result.id || '',
+        task_name: taskName,
+        source_id: sourceId,
+        workflow_id: workflowId,
+    });
+}
+// ── 切换任务启用/禁用（prepare/apply）────────────────────────
+async function switchTaskPrepare(args, env) {
+    const taskId = requireId(args.task_id, 'task_id');
+    const taskStatus = args.task_status;
+    const taskSwitch = args.task_switch;
+    const continuation = await env.continuation.issue({
+        operation: 'caizhilian.file-collection.task.switch.apply',
+        task_id: taskId, task_status: taskStatus, task_switch: taskSwitch,
+    });
+    return caizhilianSuccess('caizhilian.file-collection.task.switch.prepare', {
+        task_id: taskId, task_status: taskStatus, task_switch: taskSwitch, continuation,
+    });
+}
+async function switchTaskApply(args, env, lease) {
+    const taskId = lease.task_id;
+    const taskStatus = lease.task_status;
+    const taskSwitch = lease.task_switch;
+    const response = await env.host.request({
+        method: 'POST',
+        path: SWITCH_PATH,
+        body: { id: taskId, taskStatus, taskSwitch },
+        operation: 'caizhilian.file-collection.task.switch.apply',
+    });
+    const data = asRecord(response);
+    if (!data.status && !data.success) {
+        throw new CaizhilianCliError('api', 'business_error', String(data.msg || data.message || '切换任务状态失败'), {
+            code: data.code ?? data.status,
+            details: { action: 'caizhilian.file-collection.task.switch.apply', message: String(data.msg || data.message || '切换任务状态失败') },
+            exitCode: 1,
+        });
+    }
+    return caizhilianSuccess('caizhilian.file-collection.task.switch.apply', {
+        task_id: taskId, task_status: taskStatus, task_switch: taskSwitch,
+    });
+}
+// ── 另存为采集任务（prepare/apply）────────────────────────
+async function saveAsTaskPrepare(args, env) {
+    const taskId = requireId(args.task_id, 'task_id');
+    const continuation = await env.continuation.issue({
+        operation: 'caizhilian.file-collection.task.save-as.apply',
+        task_id: taskId,
+    });
+    return caizhilianSuccess('caizhilian.file-collection.task.save-as.prepare', {
+        task_id: taskId, continuation,
+    });
+}
+async function saveAsTaskApply(args, env, lease) {
+    const taskId = lease.task_id;
+    const response = await env.host.request({
+        method: 'POST',
+        path: SAVE_AS_PATH,
+        body: { id: taskId },
+        operation: 'caizhilian.file-collection.task.save-as.apply',
+    });
+    const data = asRecord(response);
+    if (!data.status && !data.success) {
+        throw new CaizhilianCliError('api', 'business_error', String(data.msg || data.message || '另存为失败'), {
+            code: data.code ?? data.status,
+            details: { action: 'caizhilian.file-collection.task.save-as.apply', message: String(data.msg || data.message || '另存为失败') },
+            exitCode: 1,
+        });
+    }
+    const result = asRecord(data.data);
+    return caizhilianSuccess('caizhilian.file-collection.task.save-as.apply', {
+        new_task_id: result.id || '',
+        source_task_id: taskId,
+    });
+}
+// ── 更新任务全宗 ID（prepare/apply）────────────────────────
+async function updateFondsPrepare(args, env) {
+    const taskId = requireId(args.task_id, 'task_id');
+    const fondsId = requireId(args.fonds_id, 'fonds_id');
+    const continuation = await env.continuation.issue({
+        operation: 'caizhilian.file-collection.task.update-fonds.apply',
+        task_id: taskId, fonds_id: fondsId,
+    });
+    return caizhilianSuccess('caizhilian.file-collection.task.update-fonds.prepare', {
+        task_id: taskId, fonds_id: fondsId, continuation,
+    });
+}
+async function updateFondsApply(args, env, lease) {
+    const taskId = lease.task_id;
+    const fondsId = lease.fonds_id;
+    // 先读取当前表单
+    const formResponse = await env.host.request({
+        method: 'GET',
+        path: `${GET_TASK_FORM_PATH}?id=${taskId}`,
+        operation: 'caizhilian.file-collection.task.update-fonds.apply',
+    });
+    const formData = asRecord(formResponse);
+    const form = asRecord(formData.data);
+    // 组装更新 payload：保留表单字段，覆盖 fondsId
+    const payload = { ...form };
+    payload.fondsId = fondsId;
+    delete payload.fontId;
+    payload.taskType = 3;
+    // 处理 extParam 中的 fondsId
+    if (payload.extParam) {
+        try {
+            const extParam = JSON.parse(payload.extParam);
+            extParam.fondsId = fondsId;
+            payload.extParam = JSON.stringify(extParam);
+        }
+        catch { /* extParam 非 JSON 时忽略 */ }
+    }
+    const response = await env.host.request({
+        method: 'POST',
+        path: SAVE_TASK_PATH,
+        body: payload,
+        operation: 'caizhilian.file-collection.task.update-fonds.apply',
+    });
+    const data = asRecord(response);
+    if (!data.status && !data.success) {
+        throw new CaizhilianCliError('api', 'business_error', String(data.msg || data.message || '更新全宗失败'), {
+            code: data.code ?? data.status,
+            details: { action: 'caizhilian.file-collection.task.update-fonds.apply', message: String(data.msg || data.message || '更新全宗失败') },
+            exitCode: 1,
+        });
+    }
+    return caizhilianSuccess('caizhilian.file-collection.task.update-fonds.apply', {
+        task_id: taskId, fonds_id: fondsId,
+    });
+}
+// ── 查询连接器和资源 ─────────────────────────────────────
+async function queryConnectors(args, env) {
+    const nameFilter = args.name || '';
+    const protocolType = args.protocol_type || 'nas,ftp,sftp';
+    const pageSize = args.page_size ?? 20;
+    const pageNo = args.page_no ?? 1;
+    const maxPages = args.max_pages ?? 5;
+    const allConnectors = [];
+    for (let page = 1; page <= maxPages; page++) {
+        const response = await env.host.request({
+            method: 'GET',
+            path: `${CONNECTOR_LIST_PATH}?pageSize=${pageSize}&current=${page}&protocolType=${protocolType}${nameFilter ? `&name=${encodeURIComponent(nameFilter)}` : ''}`,
+            operation: ACTION,
+        });
+        const data = asRecord(response);
+        const result = asRecord(data.data);
+        const records = asList(result.data || result.records || result);
+        if (records.length === 0)
+            break;
+        allConnectors.push(...records);
+        if (records.length < pageSize)
+            break;
+    }
+    // 只保留 FTP 类型的连接器
+    const ftpConnectors = allConnectors.filter((c) => c.product === 'FTP');
+    // 查询每个连接器的资源
+    const enriched = [];
+    for (const connector of ftpConnectors) {
+        const resourceResponse = await env.host.request({
+            method: 'GET',
+            path: `${RESOURCE_LIST_PATH}?systemPk=${connector.id}&showDefalt=true&connectorType=ftp&current=1&pageSize=100`,
+            operation: ACTION,
+        });
+        const resourceData = asRecord(resourceResponse);
+        const resourceResult = asRecord(resourceData.data);
+        const resources = asList(resourceResult.data || resourceResult.records || resourceResult);
+        enriched.push({
+            id: connector.id,
+            name: connector.name || '',
+            product: connector.product || '',
+            resources: resources.map((r) => ({
+                id: r.id,
+                name: r.name || '',
+                type: r.type || '',
+                status: r.status ?? '',
+                link_address: r.linkAddressSpan || r.linkAddress || '',
+            })),
+        });
+    }
+    return caizhilianSuccess(ACTION, {
+        ftp_connector_total: enriched.length,
+        ftp_connectors: enriched,
+    });
+}
+// ── 创建连接器（prepare/apply）────────────────────────
+async function createConnectorPrepare(args, env) {
+    const name = args.name || `文件采集FTP连接器（${new Date().toLocaleString('zh-CN', { timeZone: 'Asia/Shanghai' }).replace(/[/:]/g, '').replace(' ', ' ').substring(0, 15)}）`;
+    const company = args.company || '文件采集';
+    const continuation = await env.continuation.issue({
+        operation: 'caizhilian.file-collection.connector.create.apply',
+        name, company,
+    });
+    return caizhilianSuccess('caizhilian.file-collection.connector.create.prepare', {
+        name, company, continuation,
+    });
+}
+async function createConnectorApply(args, env, lease) {
+    const name = lease.name;
+    const company = lease.company;
+    const response = await env.host.request({
+        method: 'POST',
+        path: SYSTEM_POOL_SAVE_PATH,
+        body: {
+            name, company,
+            website: '', product: 'FTP', productWebsite: '', edition: '',
+            description: '', icon: '', id: '', connectorType: 'ftp',
+        },
+        operation: 'caizhilian.file-collection.connector.create.apply',
+    });
+    const data = asRecord(response);
+    if (!data.status && !data.success) {
+        throw new CaizhilianCliError('api', 'business_error', String(data.msg || data.message || '创建连接器失败'), {
+            code: data.code ?? data.status,
+            details: { action: 'caizhilian.file-collection.connector.create.apply', message: String(data.msg || data.message || '创建连接器失败') },
+            exitCode: 1,
+        });
+    }
+    const result = asRecord(data.data);
+    return caizhilianSuccess('caizhilian.file-collection.connector.create.apply', {
+        id: result.id || result.systemPk || '',
+        name,
+    });
+}
+// ── 创建 FTP/SFTP 资源（prepare/apply）────────────────────────
+async function createResourcePrepare(args, env) {
+    const remoteHost = requireNonEmpty(args.remote_host, 'remote_host');
+    const remotePort = requireNonEmpty(args.remote_port, 'remote_port');
+    const remoteUsername = requireNonEmpty(args.remote_username, 'remote_username');
+    const remotePassword = requireNonEmpty(args.remote_password, 'remote_password');
+    const transferProtocol = requireNonEmpty(args.transfer_protocol, 'transfer_protocol');
+    const systemPk = args.system_pk || '';
+    const name = args.name || '文件采集FTP连接';
+    const continuation = await env.continuation.issue({
+        operation: 'caizhilian.file-collection.resource.create.apply',
+        system_pk: systemPk, name, remote_host: remoteHost, remote_port: remotePort,
+        remote_username: remoteUsername, remote_password: remotePassword, transfer_protocol: transferProtocol,
+    });
+    return caizhilianSuccess('caizhilian.file-collection.resource.create.prepare', {
+        system_pk: systemPk, name, remote_host: remoteHost, remote_port: remotePort,
+        remote_username: remoteUsername, transfer_protocol: transferProtocol, continuation,
+    });
+}
+async function createResourceApply(args, env, lease) {
+    let systemPk = lease.system_pk;
+    const name = lease.name;
+    const remoteHost = lease.remote_host;
+    const remotePort = lease.remote_port;
+    const remoteUsername = lease.remote_username;
+    const remotePassword = lease.remote_password;
+    const transferProtocol = lease.transfer_protocol;
+    let systemPoolCreated = false;
+    // 如果没有连接器 ID，先自动创建
+    if (!systemPk) {
+        const connResponse = await env.host.request({
+            method: 'POST',
+            path: SYSTEM_POOL_SAVE_PATH,
+            body: {
+                name: `文件采集FTP连接器（${new Date().toLocaleString('zh-CN', { timeZone: 'Asia/Shanghai' }).replace(/[/:]/g, '').replace(' ', ' ').substring(0, 15)}）`,
+                company: '文件采集',
+                website: '', product: 'FTP', productWebsite: '', edition: '',
+                description: '', icon: '', id: '', connectorType: 'ftp',
+            },
+            operation: 'caizhilian.file-collection.resource.create.apply',
+        });
+        const connData = asRecord(connResponse);
+        const connResult = asRecord(connData.data);
+        systemPk = connResult.id || connResult.systemPk || '';
+        systemPoolCreated = true;
+    }
+    const response = await env.host.request({
+        method: 'POST',
+        path: FTP_RESOURCE_SAVE_PATH,
+        body: {
+            encoding: 'UTF-8',
+            connectionMode: 2,
+            name,
+            remoteHost,
+            remotePort: String(remotePort),
+            remoteUsername,
+            remotePassword,
+            requestTimeout: '60',
+            responseTimeout: 60,
+            retryTime: '0',
+            systemPk,
+            transferMode: 2,
+            transferProtocol,
+            type: 'ftp',
+        },
+        operation: 'caizhilian.file-collection.resource.create.apply',
+    });
+    const data = asRecord(response);
+    if (!data.status && !data.success) {
+        throw new CaizhilianCliError('api', 'business_error', String(data.msg || data.message || '创建资源失败'), {
+            code: data.code ?? data.status,
+            details: { action: 'caizhilian.file-collection.resource.create.apply', message: String(data.msg || data.message || '创建资源失败') },
+            exitCode: 1,
+        });
+    }
+    const result = asRecord(data.data);
+    return caizhilianSuccess('caizhilian.file-collection.resource.create.apply', {
+        id: result.id || '',
+        name,
+        system_pk: systemPk,
+        system_pool_created: systemPoolCreated,
+    });
+}
+// ── 搜索动作流 ─────────────────────────────────────
+async function searchWorkflows(args, env) {
+    const nameFilter = args.name_contains || '';
+    const pageSize = args.page_size ?? 50;
+    const pageNo = args.page_no ?? 1;
+    const response = await env.host.request({
+        method: 'POST',
+        path: APP_LIST_PATH,
+        body: {
+            current: pageNo, pageSize,
+            action: '', componentType: '', orgId: '',
+            createDates: [], creator: [], event: [],
+            type: [], updateDates: [], appIds: [],
+            skipId: '', thirdParty: '', appLevel: '', templateId: '',
+            name: '', status: '', moudle: 'esb',
+            isDelete: 0, orderType: '', orderStatus: '',
+        },
+        operation: ACTION,
+    });
+    const data = asRecord(response);
+    const result = asRecord(data.data);
+    let candidates = asList(result.data || result.records || result);
+    // 客户端过滤
+    if (nameFilter) {
+        const lower = nameFilter.toLowerCase();
+        candidates = candidates.filter((c) => (c.name || '').toLowerCase().includes(lower));
+    }
+    return caizhilianSuccess(ACTION, {
+        version: 'file_collection_action_flow_candidates.v1',
+        candidates: candidates.map((c, i) => ({
+            ordinal: i + 1,
+            id: c.id,
+            name: c.name || '',
+            status: c.status ?? '',
+            update_time: c.updateTime || '',
+        })),
+        candidate_count: candidates.length,
+    });
+}
+// ── 检测动作流兼容性 ─────────────────────────────────────
+async function inspectWorkflow(args, env) {
+    const applicationId = requireId(args.application_id, 'application_id');
+    const archiveRequired = args.archive_required ?? false;
+    const retainDirStruct = args.retain_dir_struct ?? false;
+    // 1. 获取应用信息
+    const appResponse = await env.host.request({
+        method: 'GET',
+        path: `${APP_DETAIL_PATH}/${applicationId}`,
+        operation: ACTION,
+    });
+    const appData = asRecord(appResponse);
+    const app = asRecord(appData.data);
+    // 2. 获取版本列表
+    const versionResponse = await env.host.request({
+        method: 'GET',
+        path: `${APP_VERSION_PATH}/${applicationId}`,
+        operation: ACTION,
+    });
+    const versionData = asRecord(versionResponse);
+    const versions = asList(versionData.data);
+    // 找到活动版本
+    const activeVersion = versions.find((v) => String(v.activeVersion) === '1' || v.activeVersion === true) || versions[0];
+    if (!activeVersion) {
+        return caizhilianSuccess(ACTION, {
+            validation: { compatible: false, issues: ['未找到活动版本'] },
+        });
+    }
+    const sceneId = activeVersion.sceneId || '';
+    const secretKey = activeVersion.secretKey || '';
+    // 3. 获取设计物
+    let design = {};
+    if (sceneId) {
+        const designResponse = await env.host.request({
+            method: 'GET',
+            path: `${DESIGN_BY_SCENE_PATH}/${sceneId}`,
+            operation: ACTION,
+        });
+        const designData = asRecord(designResponse);
+        design = asRecord(designData.data);
+    }
+    // 4. 合规检测
+    const issues = [];
+    const triggers = asList(design.triggers || design.event);
+    const actions = asList(design.actions);
+    // 检测触发器
+    const customTrigger = triggers.find((t) => t.type === 'CustomTrigger' || t.componentType === 'CustomTrigger');
+    if (!customTrigger) {
+        issues.push('缺少 CustomTrigger 触发器');
+    }
+    else {
+        const inputs = asList(customTrigger.inputs || customTrigger.input);
+        const inputNames = inputs.map((i) => i.name || i.key || '');
+        if (!inputNames.includes('fileId'))
+            issues.push('触发器缺少 fileId 输入');
+        if (!inputNames.includes('filename'))
+            issues.push('触发器缺少 filename 输入');
+        if (!inputNames.includes('employeeId'))
+            issues.push('触发器缺少 employeeId 输入');
+        if (archiveRequired && !inputNames.includes('fondsId'))
+            issues.push('归档模式下触发器缺少 fondsId 输入');
+        if (retainDirStruct && !inputNames.includes('folderId'))
+            issues.push('维持目录结构时触发器缺少 folderId 输入');
+    }
+    // 检测动作节点
+    const docSave = actions.find((a) => a.type === 'DocumentSave' || a.componentType === 'DocumentSave');
+    if (!docSave) {
+        issues.push('缺少 DocumentSave 动作节点');
+    }
+    const outputNode = actions.find((a) => a.type === 'Output' || a.componentType === 'Output');
+    if (!outputNode) {
+        issues.push('缺少 Output 动作节点');
+    }
+    const compatible = issues.length === 0;
+    return caizhilianSuccess(ACTION, {
+        validation: {
+            compatible,
+            issues,
+            workflow: { id: app.id, name: app.name, status: app.status },
+        },
+        selection: compatible ? {
+            application_id: app.id,
+            scene_id: sceneId,
+            secret_key: secretKey,
+            version: 'file_collection_workflow_selection.v1',
+        } : undefined,
+    });
+}
+// ── 创建动作流（prepare/apply）────────────────────────
+/** 标准文件采集动作流设计模板（CustomTrigger → DocumentSave → Output） */
+function buildActionFlowDesign(opts) {
+    const { appId, sceneId, secretKey, retainDirStruct } = opts;
+    // 确定性 ID 生成（基于 SHA-256 前 19 位数字）
+    const hash = (s) => {
+        let h = 0;
+        for (let i = 0; i < s.length; i++)
+            h = ((h << 5) - h + s.charCodeAt(i)) | 0;
+        return Math.abs(h);
+    };
+    const triggerId = 1000000000000000000 + (hash(`${appId}-trigger`) % 900000000000000000);
+    const docSaveId = 1000000000000000000 + (hash(`${appId}-docsave`) % 900000000000000000);
+    const outputId = 1000000000000000000 + (hash(`${appId}-output`) % 900000000000000000);
+    const fileFolder = retainDirStruct
+        ? { formula: '${SelectParams.mainTable.folderId}', type: 'field' }
+        : { formula: '200', type: 'fixed' };
+    return {
+        saveAndStart: true,
+        appId, sceneId, secretKey,
+        appName: 'weaver-file-collection',
+        event: {
+            componentType: 'CustomTrigger',
+            id: String(triggerId),
+            inputs: [
+                { name: 'fileId', type: 'string' },
+                { name: 'filename', type: 'string' },
+                { name: 'employeeId', type: 'string' },
+                ...(retainDirStruct ? [{ name: 'folderId', type: 'string' }] : []),
+            ],
+        },
+        actions: [
+            {
+                componentType: 'DocumentSave',
+                id: String(docSaveId),
+                fileFolder,
+                nextActionId: String(outputId),
+            },
+            {
+                componentType: 'Output',
+                id: String(outputId),
+                customParamSetting: [
+                    { name: 'docId', type: 'string', value: '${DocumentSave.Response.entry.docId}' },
+                ],
+            },
+        ],
+        addIds: [String(triggerId), String(docSaveId), String(outputId)],
+    };
+}
+async function createWorkflowPrepare(args, env) {
+    const name = args.name || `文件采集动作流（${new Date().toLocaleString('zh-CN', { timeZone: 'Asia/Shanghai' }).replace(/[/:]/g, '').replace(' ', ' ').substring(0, 15)}）`;
+    const archiveRequired = args.archive_required ?? false;
+    const retainDirStruct = args.retain_dir_struct ?? false;
+    const continuation = await env.continuation.issue({
+        operation: 'caizhilian.file-collection.workflow.create.apply',
+        name, archive_required: archiveRequired, retain_dir_struct: retainDirStruct,
+    });
+    return caizhilianSuccess('caizhilian.file-collection.workflow.create.prepare', {
+        name, archive_required: archiveRequired, retain_dir_struct: retainDirStruct, continuation,
+    });
+}
+async function createWorkflowApply(args, env, lease) {
+    const name = lease.name;
+    const archiveRequired = lease.archive_required;
+    const retainDirStruct = lease.retain_dir_struct;
+    const applyOp = 'caizhilian.file-collection.workflow.create.apply';
+    // 1. 创建应用
+    const saveResponse = await env.host.request({
+        method: 'POST',
+        path: APP_SAVE_PATH,
+        body: { name, type: 0, moudle: 'esb', description: 'weaver-file-collection dynamically generated action flow' },
+        operation: applyOp,
+    });
+    const saveData = asRecord(saveResponse);
+    const saveResult = asRecord(saveData.data);
+    const appId = String(saveResult.id || '');
+    if (!appId)
+        throw new CaizhilianCliError('api', 'business_error', '创建动作流应用失败：未返回应用 ID', { exitCode: 1 });
+    // 2. 获取版本列表
+    const versionResponse = await env.host.request({
+        method: 'GET',
+        path: `${APP_VERSION_PATH}/${appId}`,
+        operation: applyOp,
+    });
+    const versionData = asRecord(versionResponse);
+    const versions = asList(versionData.data);
+    const activeVersion = versions[0] || {};
+    const sceneId = activeVersion.sceneId || '';
+    const secretKey = activeVersion.secretKey || '';
+    // 3. 注册变量
+    const variables = ['fileId', 'filename', 'employeeId'];
+    if (archiveRequired)
+        variables.push('fondsId');
+    if (retainDirStruct)
+        variables.push('folderId');
+    for (const varName of variables) {
+        await env.host.request({
+            method: 'POST',
+            path: APP_VARIABLE_PATH,
+            body: { appId, sceneId, variableName: varName, variableType: 'string', variableValue: '' },
+            operation: applyOp,
+        });
+    }
+    // 4. 生成并保存设计
+    const design = buildActionFlowDesign({ appId, sceneId, secretKey, retainDirStruct });
+    // 5. 校验设计
+    await env.host.request({
+        method: 'POST',
+        path: DESIGN_CHECK_PATH,
+        body: design,
+        operation: applyOp,
+    });
+    // 6. 保存设计
+    await env.host.request({
+        method: 'POST',
+        path: DESIGN_SAVE_PATH,
+        body: design,
+        operation: applyOp,
+    });
+    // 7. 启用
+    await env.host.request({
+        method: 'GET',
+        path: `${APP_ENABLE_PATH}/${appId}`,
+        operation: applyOp,
+    });
+    return caizhilianSuccess(applyOp, {
+        id: appId,
+        scene_id: sceneId,
+        name,
+        registered_variables: variables,
+    });
+}
+// ── 启用动作流（prepare/apply）────────────────────────
+async function enableWorkflowPrepare(args, env) {
+    const applicationId = requireId(args.application_id, 'application_id');
+    const continuation = await env.continuation.issue({
+        operation: 'caizhilian.file-collection.workflow.enable.apply',
+        application_id: applicationId,
+    });
+    return caizhilianSuccess('caizhilian.file-collection.workflow.enable.prepare', {
+        application_id: applicationId, continuation,
+    });
+}
+async function enableWorkflowApply(args, env, lease) {
+    const applicationId = lease.application_id;
+    const response = await env.host.request({
+        method: 'GET',
+        path: `${APP_ENABLE_PATH}/${applicationId}`,
+        operation: 'caizhilian.file-collection.workflow.enable.apply',
+    });
+    const data = asRecord(response);
+    if (!data.status && !data.success) {
+        throw new CaizhilianCliError('api', 'business_error', String(data.msg || data.message || '启用动作流失败'), {
+            code: data.code ?? data.status,
+            details: { action: 'caizhilian.file-collection.workflow.enable.apply', message: String(data.msg || data.message || '启用动作流失败') },
+            exitCode: 1,
+        });
+    }
+    return caizhilianSuccess('caizhilian.file-collection.workflow.enable.apply', {
+        application_id: applicationId, enabled: true,
+    });
+}
+// ── 更新任务关联的动作流（prepare/apply）────────────────────────
+async function updateTaskWorkflowPrepare(args, env) {
+    const taskId = requireId(args.task_id, 'task_id');
+    const workflowId = requireId(args.workflow_id, 'workflow_id');
+    const continuation = await env.continuation.issue({
+        operation: 'caizhilian.file-collection.workflow.update-task.apply',
+        task_id: taskId, workflow_id: workflowId,
+    });
+    return caizhilianSuccess('caizhilian.file-collection.workflow.update-task.prepare', {
+        task_id: taskId, workflow_id: workflowId, continuation,
+    });
+}
+async function updateTaskWorkflowApply(args, env, lease) {
+    const taskId = lease.task_id;
+    const workflowId = lease.workflow_id;
+    const applyOp = 'caizhilian.file-collection.workflow.update-task.apply';
+    // 读取当前表单
+    const formResponse = await env.host.request({
+        method: 'GET',
+        path: `${GET_TASK_FORM_PATH}?id=${taskId}`,
+        operation: applyOp,
+    });
+    const formData = asRecord(formResponse);
+    const form = asRecord(formData.data);
+    // 更新 workflowId
+    const payload = { ...form, taskWorkflowId: workflowId };
+    const response = await env.host.request({
+        method: 'POST',
+        path: SAVE_TASK_PATH,
+        body: payload,
+        operation: applyOp,
+    });
+    const data = asRecord(response);
+    if (!data.status && !data.success) {
+        throw new CaizhilianCliError('api', 'business_error', String(data.msg || data.message || '更新任务动作流失败'), {
+            code: data.code ?? data.status,
+            details: { action: applyOp, message: String(data.msg || data.message || '更新任务动作流失败') },
+            exitCode: 1,
+        });
+    }
+    return caizhilianSuccess(applyOp, {
+        task_id: taskId, workflow_id: workflowId,
+    });
+}
+// ── 等待扫描完成 ─────────────────────────────────────
+async function waitScanCompletion(args, env) {
+    const runtimeId = requireNonEmpty(args.runtime_id, 'runtime_id');
+    const timeoutSeconds = args.timeout_seconds ?? 300;
+    const intervalSeconds = args.interval_seconds ?? 3;
+    const deadline = Date.now() + timeoutSeconds * 1000;
+    while (Date.now() < deadline) {
+        const response = await env.host.request({
+            method: 'GET',
+            path: `${SCAN_PROGRESS_PATH}?runtimeId=${runtimeId}`,
+            operation: ACTION,
+        });
+        const data = asRecord(response);
+        const result = asRecord(data.data);
+        if (result.finish === true || result.finish === 'true') {
+            return caizhilianSuccess(ACTION, {
+                runtime_id: runtimeId,
+                finished: true,
+                progress: result,
+            });
+        }
+        await new Promise(resolve => setTimeout(resolve, intervalSeconds * 1000));
+    }
+    throw new CaizhilianCliError('api', 'timeout', `扫描等待超时（${timeoutSeconds}秒）`, {
+        details: { runtime_id: runtimeId, timeout_seconds: timeoutSeconds },
+        exitCode: 1,
+    });
+}
+// ── 查询运行结果并归一化 ─────────────────────────────────────
+async function getRunResult(args, env) {
+    const taskId = requireId(args.task_id, 'task_id');
+    // 1. 查询运行进度
+    const progressResponse = await env.host.request({
+        method: 'GET',
+        path: `${RUN_PROGRESS_PATH}?id=${taskId}`,
+        operation: ACTION,
+    });
+    const progressData = asRecord(progressResponse);
+    const progress = asRecord(progressData.data);
+    if (!progress.finish && progress.finish !== 'true') {
+        return caizhilianSuccess(ACTION, {
+            version: 'file_collection_result.v1',
+            status: 'collection_running',
+            task_id: taskId,
+            file_collection_ok: false,
+            message: '采集任务仍在运行中',
+        });
+    }
+    // 2. 查询成功和失败明细
+    let successfulCount = 0;
+    let failedCount = 0;
+    try {
+        const successResponse = await env.host.request({
+            method: 'GET',
+            path: `${DETAIL_TABLE_PATH}?fileCollTaskId=${taskId}&detailType=true`,
+            operation: ACTION,
+        });
+        const successData = asRecord(successResponse);
+        const successResult = asRecord(successData.data);
+        successfulCount = asList(successResult.data || successResult).length;
+    }
+    catch { /* 查询失败时计数为 0 */ }
+    try {
+        const failedResponse = await env.host.request({
+            method: 'GET',
+            path: `${DETAIL_TABLE_PATH}?fileCollTaskId=${taskId}&detailType=false`,
+            operation: ACTION,
+        });
+        const failedData = asRecord(failedResponse);
+        const failedResult = asRecord(failedData.data);
+        failedCount = asList(failedResult.data || failedResult).length;
+    }
+    catch { /* 查询失败时计数为 0 */ }
+    // 3. 归一化结果
+    let status;
+    let fileCollectionOk;
+    let message;
+    if (failedCount > 0) {
+        status = 'collection_completed_with_failures';
+        fileCollectionOk = false;
+        message = `采集完成，但有 ${failedCount} 个文件失败`;
+    }
+    else if (successfulCount > 0) {
+        status = 'collection_succeeded';
+        fileCollectionOk = true;
+        message = `采集成功，共 ${successfulCount} 个文件`;
+    }
+    else {
+        status = 'collection_completed_without_files';
+        fileCollectionOk = false;
+        message = '采集完成，但无文件记录';
+    }
+    return caizhilianSuccess(ACTION, {
+        version: 'file_collection_result.v1',
+        status,
+        task_id: taskId,
+        file_counts: { successful: successfulCount, failed: failedCount, total: successfulCount + failedCount },
+        file_collection_ok: fileCollectionOk,
+        message,
+    });
+}
 // ── 处理器汇总 ────────────────────────────────────────────
 export const caizhilianFileCollectionHandlers = {
     'caizhilian.file-collection.task.list': { execute: listTasks },
     'caizhilian.file-collection.task.form': { execute: getTaskForm },
+    'caizhilian.file-collection.task.save': {
+        prepare: saveTaskPrepare,
+        apply: saveTaskApply,
+        targetKeys: ['source_id', 'workflow_id'],
+    },
     'caizhilian.file-collection.storage.check': { execute: checkStorage },
     'caizhilian.file-collection.scan': {
         prepare: scanPrepare,
@@ -343,4 +1177,51 @@ export const caizhilianFileCollectionHandlers = {
         apply: deleteTaskApply,
         targetKeys: ['task_id'],
     },
+    // ── 任务管理补充 ──
+    'caizhilian.file-collection.task.switch': {
+        prepare: switchTaskPrepare,
+        apply: switchTaskApply,
+        targetKeys: ['task_id'],
+    },
+    'caizhilian.file-collection.task.save-as': {
+        prepare: saveAsTaskPrepare,
+        apply: saveAsTaskApply,
+        targetKeys: ['task_id'],
+    },
+    'caizhilian.file-collection.task.update-fonds': {
+        prepare: updateFondsPrepare,
+        apply: updateFondsApply,
+        targetKeys: ['task_id'],
+    },
+    // ── 连接器/资源管理 ──
+    'caizhilian.file-collection.connector.query': { execute: queryConnectors },
+    'caizhilian.file-collection.connector.create': {
+        prepare: createConnectorPrepare,
+        apply: createConnectorApply,
+    },
+    'caizhilian.file-collection.resource.create': {
+        prepare: createResourcePrepare,
+        apply: createResourceApply,
+        targetKeys: ['remote_host'],
+    },
+    // ── 动作流管理 ──
+    'caizhilian.file-collection.workflow.search': { execute: searchWorkflows },
+    'caizhilian.file-collection.workflow.inspect': { execute: inspectWorkflow },
+    'caizhilian.file-collection.workflow.create': {
+        prepare: createWorkflowPrepare,
+        apply: createWorkflowApply,
+    },
+    'caizhilian.file-collection.workflow.enable': {
+        prepare: enableWorkflowPrepare,
+        apply: enableWorkflowApply,
+        targetKeys: ['application_id'],
+    },
+    'caizhilian.file-collection.workflow.update-task': {
+        prepare: updateTaskWorkflowPrepare,
+        apply: updateTaskWorkflowApply,
+        targetKeys: ['task_id'],
+    },
+    // ── 等待与结果验证 ──
+    'caizhilian.file-collection.scan.wait': { execute: waitScanCompletion },
+    'caizhilian.file-collection.run.result': { execute: getRunResult },
 };