weaver-work-cli 0.1.7 → 0.1.20

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

@@ -0,0 +1,346 @@
+/**
+ * caizhilian.file-collection — 文件采集（FTP/SFTP）
+ *
+ * 覆盖文件采集的生命周期：
+ * - 任务列表/详情/删除
+ * - 扫描/运行/取消
+ * - 进度查询/结果查询
+ *
+ * 接口：
+ * - 列任务：GET /api/file/coll/taskTable
+ * - 读表单：GET /api/file/coll/taskForm
+ * - 保存任务：POST /api/file/coll/save
+ * - 另存为：POST /api/file/coll/saveAs
+ * - 检查存储：GET /api/file/coll/checkStorageConnect
+ * - 扫描：POST /api/file/coll/scan
+ * - 扫描进度：GET /api/file/coll/scan/progress
+ * - 运行/暂停：POST /api/file/coll/run
+ * - 运行进度：GET /api/file/coll/run/progress
+ * - 详情：GET /api/file/coll/detailTable
+ * - 取消：POST /api/file/coll/cancel
+ * - 删除：POST /api/file/coll/delete
+ */
+import { CaizhilianCliError } from '../../errors.js';
+import { caizhilianSuccess } from '../types.js';
+import { requireId } from '../shared.js';
+const ACTION = 'caizhilian.file-collection';
+// ── 接口路径 ──────────────────────────────────────────────
+const LIST_TASKS_PATH = '/api/file/coll/taskTable';
+const GET_TASK_FORM_PATH = '/api/file/coll/taskForm';
+const SAVE_TASK_PATH = '/api/file/coll/save';
+const SAVE_AS_TASK_PATH = '/api/file/coll/saveAs';
+const CHECK_STORAGE_PATH = '/api/file/coll/checkStorageConnect';
+const SCAN_PATH = '/api/file/coll/scan';
+const SCAN_PROGRESS_PATH = '/api/file/coll/scan/progress';
+const RUN_PATH = '/api/file/coll/run';
+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';
+// ── 辅助函数 ──────────────────────────────────────────────
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+}
+function asList(value) {
+    return Array.isArray(value) ? value : [];
+}
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+// ── 列出采集任务 ──────────────────────────────────────────
+async function listTasks(args, env) {
+    const response = await env.host.request({
+        method: 'GET',
+        path: LIST_TASKS_PATH,
+        operation: ACTION,
+    });
+    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: ACTION, message: String(data.msg || data.message || '查询采集任务失败') },
+            exitCode: 1,
+        });
+    }
+    const result = asRecord(data.data);
+    const tasks = asList(result.data || result).map((item) => ({
+        id: item.id,
+        name: item.taskName || '',
+        status: item.status || '',
+        source_type: item.sourceType || '',
+        create_time: item.createTime || '',
+    }));
+    return caizhilianSuccess(ACTION, {
+        tasks,
+    });
+}
+// ── 获取采集任务详情 ──────────────────────────────────────
+async function getTaskForm(args, env) {
+    const taskId = args.id ? requireId(args.id, 'id') : '';
+    const url = taskId ? `${GET_TASK_FORM_PATH}?id=${taskId}` : GET_TASK_FORM_PATH;
+    const response = await env.host.request({
+        method: 'GET',
+        path: url,
+        operation: ACTION,
+    });
+    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: ACTION, message: String(data.msg || data.message || '查询采集任务失败') },
+            exitCode: 1,
+        });
+    }
+    const result = asRecord(data.data);
+    return caizhilianSuccess(ACTION, {
+        form: result,
+    });
+}
+// ── 检查存储连接 ──────────────────────────────────────────
+async function checkStorage(args, env) {
+    const response = await env.host.request({
+        method: 'GET',
+        path: CHECK_STORAGE_PATH,
+        operation: ACTION,
+    });
+    const data = asRecord(response);
+    const connected = data.data ?? data.status ?? data.success;
+    return caizhilianSuccess(ACTION, {
+        connected: !!connected,
+    });
+}
+// ── 扫描（prepare/apply）──────────────────────────────────────
+async function scanPrepare(args, env) {
+    const taskId = requireId(args.task_id, 'task_id');
+    const fullColl = args.full_coll ?? false;
+    // 签发 continuation
+    const continuation = await env.continuation.issue({
+        operation: 'caizhilian.file-collection.scan.apply',
+        taskId,
+        fullColl,
+    });
+    return caizhilianSuccess('caizhilian.file-collection.scan.prepare', {
+        task_id: taskId,
+        full_coll: fullColl,
+        continuation,
+    });
+}
+async function scanApply(args, env, lease) {
+    const taskId = lease.payload?.taskId;
+    const fullColl = lease.payload?.fullColl;
+    const response = await env.host.request({
+        method: 'POST',
+        path: SCAN_PATH,
+        body: { taskId, fullColl },
+        operation: 'caizhilian.file-collection.scan.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.scan.apply', message: String(data.msg || data.message || '扫描失败') },
+            exitCode: 1,
+        });
+    }
+    const result = asRecord(data.data);
+    return caizhilianSuccess('caizhilian.file-collection.scan.apply', {
+        runtime_id: result.runtimeId || result.id || '',
+        status: result.status || '',
+    });
+}
+// ── 扫描进度 ──────────────────────────────────────────────
+async function scanProgress(args, env) {
+    const response = await env.host.request({
+        method: 'GET',
+        path: SCAN_PROGRESS_PATH,
+        operation: ACTION,
+    });
+    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: ACTION, message: String(data.msg || data.message || '查询扫描进度失败') },
+            exitCode: 1,
+        });
+    }
+    const result = asRecord(data.data);
+    return caizhilianSuccess(ACTION, {
+        progress: result,
+    });
+}
+// ── 运行/暂停（prepare/apply）──────────────────────────────────────
+async function runPrepare(args, env) {
+    const taskId = requireId(args.task_id, 'task_id');
+    const action = args.action || 'run';
+    // 签发 continuation
+    const continuation = await env.continuation.issue({
+        operation: 'caizhilian.file-collection.run.apply',
+        taskId,
+        action,
+    });
+    return caizhilianSuccess('caizhilian.file-collection.run.prepare', {
+        task_id: taskId,
+        action,
+        continuation,
+    });
+}
+async function runApply(args, env, lease) {
+    const taskId = lease.payload?.taskId;
+    const action = lease.payload?.action;
+    const response = await env.host.request({
+        method: 'POST',
+        path: RUN_PATH,
+        body: { taskId, action },
+        operation: 'caizhilian.file-collection.run.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.run.apply', message: String(data.msg || data.message || '运行失败') },
+            exitCode: 1,
+        });
+    }
+    const result = asRecord(data.data);
+    return caizhilianSuccess('caizhilian.file-collection.run.apply', {
+        status: result.status || '',
+        action,
+    });
+}
+// ── 运行进度 ──────────────────────────────────────────────
+async function runProgress(args, env) {
+    const response = await env.host.request({
+        method: 'GET',
+        path: RUN_PROGRESS_PATH,
+        operation: ACTION,
+    });
+    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: ACTION, message: String(data.msg || data.message || '查询运行进度失败') },
+            exitCode: 1,
+        });
+    }
+    const result = asRecord(data.data);
+    return caizhilianSuccess(ACTION, {
+        progress: result,
+    });
+}
+// ── 采集详情 ──────────────────────────────────────────────
+async function detailTable(args, env) {
+    const response = await env.host.request({
+        method: 'GET',
+        path: DETAIL_TABLE_PATH,
+        operation: ACTION,
+    });
+    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: ACTION, message: String(data.msg || data.message || '查询采集详情失败') },
+            exitCode: 1,
+        });
+    }
+    const result = asRecord(data.data);
+    return caizhilianSuccess(ACTION, {
+        details: result,
+    });
+}
+// ── 取消采集（prepare/apply）──────────────────────────────────────
+async function cancelPrepare(args, env) {
+    const taskId = requireId(args.task_id, 'task_id');
+    // 签发 continuation
+    const continuation = await env.continuation.issue({
+        operation: 'caizhilian.file-collection.cancel.apply',
+        taskId,
+    });
+    return caizhilianSuccess('caizhilian.file-collection.cancel.prepare', {
+        task_id: taskId,
+        continuation,
+    });
+}
+async function cancelApply(args, env, lease) {
+    const taskId = lease.payload?.taskId;
+    const response = await env.host.request({
+        method: 'POST',
+        path: CANCEL_PATH,
+        body: { taskId },
+        operation: 'caizhilian.file-collection.cancel.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.cancel.apply', message: String(data.msg || data.message || '取消失败') },
+            exitCode: 1,
+        });
+    }
+    return caizhilianSuccess('caizhilian.file-collection.cancel.apply', {
+        cancelled: true,
+        task_id: taskId,
+    });
+}
+// ── 删除采集任务（prepare/apply）──────────────────────────────────────
+async function deleteTaskPrepare(args, env) {
+    const taskId = requireId(args.task_id, 'task_id');
+    // 签发 continuation
+    const continuation = await env.continuation.issue({
+        operation: 'caizhilian.file-collection.delete.apply',
+        taskId,
+    });
+    return caizhilianSuccess('caizhilian.file-collection.delete.prepare', {
+        task_id: taskId,
+        continuation,
+    });
+}
+async function deleteTaskApply(args, env, lease) {
+    const taskId = lease.payload?.taskId;
+    const response = await env.host.request({
+        method: 'POST',
+        path: DELETE_PATH,
+        body: { taskId },
+        operation: 'caizhilian.file-collection.delete.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.delete.apply', message: String(data.msg || data.message || '删除失败') },
+            exitCode: 1,
+        });
+    }
+    return caizhilianSuccess('caizhilian.file-collection.delete.apply', {
+        deleted: true,
+        task_id: taskId,
+    });
+}
+// ── 处理器汇总 ────────────────────────────────────────────
+export const caizhilianFileCollectionHandlers = {
+    'caizhilian.file-collection.task.list': { execute: listTasks },
+    'caizhilian.file-collection.task.form': { execute: getTaskForm },
+    'caizhilian.file-collection.storage.check': { execute: checkStorage },
+    'caizhilian.file-collection.scan': {
+        prepare: scanPrepare,
+        apply: scanApply,
+        targetKeys: ['task_id'],
+    },
+    'caizhilian.file-collection.scan.progress': { execute: scanProgress },
+    'caizhilian.file-collection.run': {
+        prepare: runPrepare,
+        apply: runApply,
+        targetKeys: ['task_id'],
+    },
+    'caizhilian.file-collection.run.progress': { execute: runProgress },
+    'caizhilian.file-collection.detail': { execute: detailTable },
+    'caizhilian.file-collection.cancel': {
+        prepare: cancelPrepare,
+        apply: cancelApply,
+        targetKeys: ['task_id'],
+    },
+    'caizhilian.file-collection.delete': {
+        prepare: deleteTaskPrepare,
+        apply: deleteTaskApply,
+        targetKeys: ['task_id'],
+    },
+};

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

@@ -0,0 +1,192 @@
+/**
+ * caizhilian.file-upload — 文件上传（本地文件上传到文件服务）
+ *
+ * 覆盖本地文件上传到 E10 文件服务的完整流程：
+ * - contract: 获取上传接口合约
+ * - prepare: 本地文件校验与元数据准备
+ * - upload: 上传文件并获取 fileId
+ *
+ * 接口：
+ * - 预检查：POST /api/file/preUploadCheck?sf_request_type=ajax
+ * - 上传：POST /api/file/module/upload?sf_request_type=ajax
+ */
+import { CaizhilianCliError, caizhilianValidationError } from '../../errors.js';
+import { caizhilianSuccess } from '../types.js';
+import { requireNonEmpty } from '../shared.js';
+import { createHash } from 'node:crypto';
+import { readFileSync, statSync } from 'node:fs';
+import { basename, extname } from 'node:path';
+const ACTION = 'caizhilian.file-upload';
+// ── 接口路径 ──────────────────────────────────────────────
+const PRE_UPLOAD_CHECK_PATH = '/api/file/preUploadCheck?sf_request_type=ajax';
+const UPLOAD_PATH = '/api/file/module/upload?sf_request_type=ajax';
+// ── 辅助函数 ──────────────────────────────────────────────
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+}
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function md5File(filePath) {
+    const content = readFileSync(filePath);
+    return createHash('md5').update(content).digest('hex');
+}
+function sha256File(filePath) {
+    const content = readFileSync(filePath);
+    return createHash('sha256').update(content).digest('hex');
+}
+// ── 获取上传合约 ──────────────────────────────────────────
+async function getContract(args, env) {
+    return caizhilianSuccess(ACTION, {
+        contract: {
+            version: 'agent_callable_interface_contract.v1',
+            actions: ['contract', 'prepare', 'upload'],
+            required: {
+                prepare: ['file_path', 'module'],
+                upload: ['file_path', 'module', 'user_confirmed'],
+            },
+            optional: {
+                prepare: ['context_file'],
+                upload: ['context_file', 'login_mode'],
+            },
+        },
+    });
+}
+// ── 准备上传（prepare/apply）──────────────────────────────────────
+async function prepareUpload(args, env) {
+    const filePath = requireNonEmpty(args.file_path, 'file_path');
+    const module = requireNonEmpty(args.module, 'module');
+    // 校验文件存在
+    let stat;
+    try {
+        stat = statSync(filePath);
+    }
+    catch (error) {
+        throw caizhilianValidationError('file_not_found', `文件不存在: ${filePath}`);
+    }
+    if (!stat.isFile()) {
+        throw caizhilianValidationError('file_not_regular', `不是普通文件: ${filePath}`);
+    }
+    // 计算元数据
+    const fileName = basename(filePath);
+    const ext = extname(filePath).slice(1).toLowerCase();
+    const size = stat.size;
+    const md5 = md5File(filePath);
+    const sha256 = sha256File(filePath);
+    // 签发 continuation
+    const continuation = await env.continuation.issue({
+        operation: 'caizhilian.file-upload.upload.apply',
+        filePath,
+        module,
+        fileName,
+        ext,
+        size,
+        md5,
+        sha256,
+    });
+    return caizhilianSuccess('caizhilian.file-upload.prepare', {
+        file_path: filePath,
+        file_name: fileName,
+        ext,
+        size,
+        md5,
+        sha256,
+        module,
+        continuation,
+    });
+}
+async function uploadApply(args, env, lease) {
+    const filePath = lease.payload?.filePath;
+    const module = lease.payload?.module;
+    const fileName = lease.payload?.fileName;
+    const ext = lease.payload?.ext;
+    const size = lease.payload?.size;
+    const md5 = lease.payload?.md5;
+    const sha256 = lease.payload?.sha256;
+    // 预检查
+    const preCheckResponse = await env.host.request({
+        method: 'POST',
+        path: PRE_UPLOAD_CHECK_PATH,
+        body: {
+            fileName,
+            fileSize: size,
+            module,
+            md5,
+        },
+        operation: 'caizhilian.file-upload.upload.apply',
+    });
+    const preCheckData = asRecord(preCheckResponse);
+    if (!preCheckData.status && !preCheckData.success) {
+        throw new CaizhilianCliError('api', 'business_error', String(preCheckData.msg || preCheckData.message || '预检查失败'), {
+            code: preCheckData.code ?? preCheckData.status,
+            details: { action: 'caizhilian.file-upload.upload.apply', message: String(preCheckData.msg || preCheckData.message || '预检查失败') },
+            exitCode: 1,
+        });
+    }
+    const preCheckResult = asRecord(preCheckData.data);
+    // 判断上传策略
+    const uploadType = preCheckResult.uploadType || 'common';
+    const preUploadId = preCheckResult.preUploadId;
+    // 如果是 second 策略，直接返回已有 file ID
+    if (uploadType === 'second') {
+        const fileId = preCheckResult.fileId || preCheckResult.fileid || preCheckResult.uploadModuleDto?.fileObj?.fileId;
+        if (!fileId) {
+            throw new CaizhilianCliError('api', 'business_error', 'second 策略未返回 file ID', {
+                details: { action: 'caizhilian.file-upload.upload.apply' },
+                exitCode: 1,
+            });
+        }
+        return caizhilianSuccess('caizhilian.file-upload.upload.apply', {
+            file_id: String(fileId),
+            file_name: fileName,
+            size,
+            ext,
+            upload_type: uploadType,
+        });
+    }
+    // common/chunk 策略：上传文件
+    const fileContent = readFileSync(filePath);
+    const formData = new FormData();
+    formData.append('file', new Blob([fileContent]), fileName);
+    formData.append('preUploadId', preUploadId || '');
+    formData.append('module', module);
+    const uploadResponse = await env.host.request({
+        method: 'POST',
+        path: UPLOAD_PATH,
+        body: formData,
+        operation: 'caizhilian.file-upload.upload.apply',
+    });
+    const uploadData = asRecord(uploadResponse);
+    if (!uploadData.status && !uploadData.success) {
+        throw new CaizhilianCliError('api', 'business_error', String(uploadData.msg || uploadData.message || '上传失败'), {
+            code: uploadData.code ?? uploadData.status,
+            details: { action: 'caizhilian.file-upload.upload.apply', message: String(uploadData.msg || uploadData.message || '上传失败') },
+            exitCode: 1,
+        });
+    }
+    const uploadResult = asRecord(uploadData.data);
+    const fileId = uploadResult.fileId || uploadResult.fileid || '';
+    if (!fileId) {
+        throw new CaizhilianCliError('api', 'business_error', '上传未返回 file ID', {
+            details: { action: 'caizhilian.file-upload.upload.apply' },
+            exitCode: 1,
+        });
+    }
+    return caizhilianSuccess('caizhilian.file-upload.upload.apply', {
+        file_id: String(fileId),
+        file_name: fileName,
+        size,
+        ext,
+        upload_type: uploadType,
+    });
+}
+// ── 处理器汇总 ────────────────────────────────────────────
+export const caizhilianFileUploadHandlers = {
+    'caizhilian.file-upload.contract': { execute: getContract },
+    'caizhilian.file-upload.prepare': { execute: prepareUpload },
+    'caizhilian.file-upload.upload': {
+        prepare: prepareUpload,
+        apply: uploadApply,
+        targetKeys: ['file_path', 'module'],
+    },
+};