weaver-work-cli 0.1.24 → 0.1.25

package/dist/shortcuts/caizhilian/operations/handlers/setting-attach.js

@@ -14,6 +14,7 @@
 import { CaizhilianCliError, caizhilianValidationError } from '../../errors.js';
 import { issueWriteLease } from '../confirm.js';
 import { caizhilianSuccess } from '../types.js';
+import { hasNextPage, parsePage, requireNonEmpty } from '../shared.js';
 const ACTION = 'caizhilian.setting-attach';
 // ── 接口路径 ──────────────────────────────────────────────
 const GET_PATH = '/api/file/tenant/setting';
@@ -282,10 +283,207 @@ async function listWorkflowsByFolders(args, env) {
         total: workflows.length,
     });
 }
+// ── 获取流程上传目录设置 ──────────────────────────────────────────
+/** 源 workflow_plugins._MODULE_MAP：模块类型 → 路径/参数映射。 */
+const MODULE_MAP = {
+    workflow: { module: 'workflow', apiModule: 'workflow/core', basePath: '/api/workflow/core/form/setting/attachment' },
+    ebuilder: { module: 'ebuildercard', apiModule: 'ebuilder/flow', basePath: '/api/ebuilder/flow/form/setting/attachment' },
+};
+function resolveModuleInfo(module) {
+    return MODULE_MAP[module] ?? { module, apiModule: 'workflow/core', basePath: '/api/workflow/core/form/setting/attachment' };
+}
+function nestedValue(root, path) {
+    let current = root;
+    for (const segment of path.split('.')) {
+        if (current === null || current === undefined || typeof current !== 'object')
+            return undefined;
+        current = current[segment];
+    }
+    return current;
+}
+async function listUploadFolders(args, env) {
+    const action = 'caizhilian.setting-attach.list-upload-folders';
+    const workflowId = requireNonEmpty(args.workflow_id, 'workflow_id 不能为空');
+    // ── Step 1: 查询表单信息并解析模块映射 ──
+    const formResponse = await env.host.request({
+        method: 'GET',
+        path: '/api/bs/workflow/pathdef/baseSet/getEditForm',
+        query: { isCreate: '0', belongType: '1', workflowId },
+        operation: action,
+    });
+    const formData = asRecord(formResponse);
+    const formList = nestedValue(formData, 'data.data.formId');
+    if (!Array.isArray(formList) || formList.length === 0) {
+        throw caizhilianValidationError('workflow_not_found', '未找到该流程对应的表单信息', { workflow_id: workflowId });
+    }
+    const firstForm = asRecord(formList[0]);
+    const formId = String(firstForm.id ?? '').trim();
+    if (!formId) {
+        throw caizhilianValidationError('form_id_not_found', '未找到表单 ID', { workflow_id: workflowId });
+    }
+    const formModule = String(firstForm.module ?? '');
+    const moduleInfo = resolveModuleInfo(formModule);
+    // ── Step 2 + Step 3: 并行查询通用设置和附件字段列表 ──
+    const [commonResponse, fieldsResponse] = await Promise.all([
+        env.host.request({
+            method: 'POST',
+            path: `${moduleInfo.basePath}/getWeaFormAndData`,
+            body: { formId, type: 'common', module: moduleInfo.module, apiModule: moduleInfo.apiModule },
+            operation: action,
+        }),
+        env.host.request({
+            method: 'POST',
+            path: `${moduleInfo.basePath}/listAttachFields`,
+            body: { formId, apiModule: moduleInfo.apiModule, module: moduleInfo.module },
+            operation: action,
+        }),
+    ]);
+    const seen = new Map();
+    // 收集通用设置中的文件夹
+    const commonItems = nestedValue(asRecord(commonResponse), 'data.folderIdBrowserValue');
+    if (Array.isArray(commonItems)) {
+        for (const item of commonItems) {
+            if (!isPlainObject(item))
+                continue;
+            const fid = String(item.id ?? '').trim();
+            if (!fid)
+                continue;
+            const existing = seen.get(fid);
+            if (existing) {
+                existing.sources.push({ type: 'common_setting' });
+            }
+            else {
+                seen.set(fid, {
+                    id: fid,
+                    name: String(item.content ?? ''),
+                    path: String(item.title ?? ''),
+                    sources: [{ type: 'common_setting' }],
+                });
+            }
+        }
+    }
+    // ── Step 4: 并行查询每个附件字段的文件夹设置（仅 folderType=1）──
+    const fieldsData = asRecord(fieldsResponse);
+    const fieldList = Array.isArray(fieldsData.data) ? fieldsData.data : [];
+    const fieldRequests = [];
+    for (const field of fieldList) {
+        if (!isPlainObject(field))
+            continue;
+        const fieldId = String(field.fieldId ?? '').trim();
+        if (!fieldId)
+            continue;
+        if (String(field.folderType ?? '') !== '1')
+            continue;
+        fieldRequests.push({
+            meta: { fieldId, fieldName: String(field.fieldName ?? '') },
+            request: env.host.request({
+                method: 'POST',
+                path: `${moduleInfo.basePath}/getWeaFormAndData`,
+                body: { formId, type: 'folder', fieldId, module: moduleInfo.module, apiModule: moduleInfo.apiModule },
+                operation: action,
+            }),
+        });
+    }
+    if (fieldRequests.length > 0) {
+        const results = await Promise.allSettled(fieldRequests.map((r) => r.request));
+        for (let i = 0; i < fieldRequests.length; i++) {
+            const result = results[i];
+            if (result.status === 'rejected')
+                continue; // 单个字段失败不影响其他
+            const fieldFolderData = asRecord(result.value);
+            const fieldFolderItems = nestedValue(fieldFolderData, 'data.folderIdBrowserValue');
+            if (!Array.isArray(fieldFolderItems))
+                continue;
+            for (const item of fieldFolderItems) {
+                if (!isPlainObject(item))
+                    continue;
+                const fid = String(item.id ?? '').trim();
+                if (!fid)
+                    continue;
+                const source = {
+                    type: 'field',
+                    field_id: fieldRequests[i].meta.fieldId,
+                    field_name: fieldRequests[i].meta.fieldName,
+                };
+                const existing = seen.get(fid);
+                if (existing) {
+                    existing.sources.push(source);
+                }
+                else {
+                    seen.set(fid, {
+                        id: fid,
+                        name: String(item.content ?? ''),
+                        path: String(item.title ?? ''),
+                        sources: [source],
+                    });
+                }
+            }
+        }
+    }
+    return caizhilianSuccess(action, {
+        workflow_id: workflowId,
+        folders: [...seen.values()],
+    });
+}
+// ── caizhilian.setting-attach.search-workflows ────────────
+const SEARCH_WORKFLOWS_ACTION = 'caizhilian.setting-attach.search-workflows';
+const SEARCH_WORKFLOWS_PATH = '/api/bs/workflow/pathdef/baseSet/getBaseInfoList';
+/** 源 SearchWorkflowsPlugin.execute（search_plugins.py）：按流程名称模糊搜索审批流程。 */
+async function searchWorkflows(args, env) {
+    const action = SEARCH_WORKFLOWS_ACTION;
+    // 源：keyword 自动去除首尾空格；不传、传空或纯空格则返回全部流程
+    const keyword = args.keyword === undefined || args.keyword === null ? '' : String(args.keyword).trim();
+    const { pageNo, pageSize } = parsePage(args, 100);
+    const body = {
+        searchParams: {
+            searchDatas: {
+                workflowNameCondition: 'in',
+                workflowTypeCondition: 'in',
+                formType: 'all',
+                formCondition: 'in',
+                status: '0',
+                type: 'and',
+            },
+            quickSearchDatas: { workflowName: keyword },
+            otherSearchDatas: { workflowType: '', workflowId: '', subCompanyId: '' },
+        },
+        isTemplate: 0,
+        belongType: 1,
+        current: pageNo,
+        pageSize,
+    };
+    const response = await env.host.request({
+        method: 'POST',
+        path: SEARCH_WORKFLOWS_PATH,
+        body,
+        operation: action,
+    });
+    const rawList = nestedValue(asRecord(response), 'data.data');
+    const items = Array.isArray(rawList) ? rawList : [];
+    const workflows = [];
+    for (const item of items) {
+        if (!isPlainObject(item))
+            continue;
+        workflows.push({
+            id: String(item.id ?? ''),
+            workflowName: item.workflowName ?? '',
+            typeName: item.typeName ?? '',
+        });
+    }
+    return caizhilianSuccess(action, {
+        page_no: pageNo,
+        page_size: pageSize,
+        // 服务端 hasMore 不随请求 pageSize 变化（按固定 100 计算），与源一致以本页返回数量判断
+        has_next: hasNextPage(items, pageSize),
+        workflows,
+    });
+}
 // ── 处理器汇总 ────────────────────────────────────────────
 export const caizhilianSettingAttachHandlers = {
     'caizhilian.setting-attach.get': { execute: getSettingAttach },
     'caizhilian.setting-attach.list-workflows-by-folders': { execute: listWorkflowsByFolders },
+    'caizhilian.setting-attach.list-upload-folders': { execute: listUploadFolders },
+    'caizhilian.setting-attach.search-workflows': { execute: searchWorkflows },
     'caizhilian.setting-attach.set': {
         prepare: setSettingAttachPrepare,
         apply: setSettingAttachApply,

package/dist/shortcuts/caizhilian/operations/shared.js

@@ -191,6 +191,38 @@ export function timestampToDateStr(tsMs, fallback = '') {
         return fallback;
     return formatDateTimeMs(parsed + CN_TZ_OFFSET_MS, true);
 }
+/**
+ * 附件历史版本 updateTime 兼容转换（源为毫秒时间戳，但需兼容秒级时间戳与已格式化字符串）：
+ * - 数值/数字串 >= 1e12 → 视为毫秒时间戳；
+ * - 1e9 <= 数值 < 1e12 → 视为秒时间戳，×1000 后转换；
+ * - 已是 'YYYY-MM-DD…' 形态的字符串 → 原样透传；
+ * - 其它无法识别的值 → 原样转为字符串透传（不丢信息）。
+ */
+export function formatVersionTimestamp(value) {
+    if (value === undefined || value === null || value === '')
+        return '';
+    if (typeof value === 'number') {
+        if (value >= 1e12)
+            return timestampToDateStr(value, String(value));
+        if (value >= 1e9)
+            return timestampToDateStr(value * 1000, String(value));
+        return String(value);
+    }
+    const text = String(value).trim();
+    if (text === '')
+        return '';
+    if (/^\d{4}-\d{2}-\d{2}/u.test(text))
+        return text;
+    if (/^-?\d+$/u.test(text)) {
+        const parsed = Number(text);
+        if (parsed >= 1e12)
+            return timestampToDateStr(parsed, text);
+        if (parsed >= 1e9)
+            return timestampToDateStr(parsed * 1000, text);
+        return text;
+    }
+    return text;
+}
 function formatDateTimeMs(shiftedMs, withSeconds) {
     const t = new Date(shiftedMs);
     const date = `${t.getUTCFullYear()}-${pad(t.getUTCMonth() + 1)}-${pad(t.getUTCDate())}`;

package/dist/shortcuts/caizhilian/operations/specs.js

@@ -365,6 +365,16 @@ export const caizhilianOperationSpecs = [
     }, ['folder_ids'], {
         method: 'http_template',
     }),
+    spec('setting-attach', 'list-upload-folders', 'fetch_workflow_upload_folder', 'read', '获取指定审批流程的附件上传目录设置（源 fetch_workflow_upload_folder）', {
+        workflow_id: ID('审批流程 ID'),
+    }, ['workflow_id']),
+    spec('setting-attach', 'search-workflows', 'search_workflows', 'read', '按名称模糊搜索审批流程（源 search_workflows）', {
+        keyword: S('流程名称搜索词，模糊匹配；不传或空白返回全部流程'),
+        name: S('旧字段别名，等价 keyword（已废弃，与 keyword 同时出现且取值不一致会报 alias_conflict）'),
+        ...pageProps(100),
+    }, [], {
+        deprecatedInputAliases: { keyword: ['name'] },
+    }),
     spec('setting-attach', 'set', 'set_setting_attach', 'high-risk-write', '保存附件设置（只改指定字段，未指定字段透传原值）', {
         items: {
             type: 'object',
@@ -711,6 +721,11 @@ export const caizhilianOperationSpecs = [
         doc_id: ID('文档 ID'),
         save_path: FILE('保存路径（完整文件路径或目录）'),
     }, ['attachment_id', 'doc_id']),
+    spec('attachment', 'list-versions', 'find_version_list', 'read', '按附件 ID 查询附件历史版本（源 filePreview 历史版本抽屉接口）', {
+        attachment_id: ID('附件 ID'),
+        doc_id: ID('文档 ID（可选，不传时发空串）'),
+        ...pageProps(10),
+    }, ['attachment_id'], { method: 'http_template' }),
     // ── cover ───────────────────────────────────────────────
     spec('cover', 'upload', 'upload_cover_image', 'read-with-upload', '上传封面图片，仅返回 file_id（不改文档）', {
         file_path: FILE('本地图片路径（.png/.jpg/.jpeg/.gif/.webp/.bmp）'),

package/dist/shortcuts/workflow/index.js

@@ -5,6 +5,7 @@ import { createWorkflowHost } from './host.js';
 import { workflowManifest } from './manifest.js';
 import { executeWorkflowOperation } from './operations.js';
 import { workflowValidationError } from './errors.js';
+import { compactStdoutPaths } from './stdout-compact.js';
 function asOptions(value) {
     return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
 }
@@ -73,6 +74,59 @@ function failureEnvelope(error) {
         error: toErrorEnvelope(error),
     };
 }
+/**
+ * 紧凑路径的**声明**在 `stdout-compact.ts`：`operations/form.ts` 判线时要用同一份路径
+ * （它量的必须是最终打出去的那份文本），常量留在本文件会让 `form.ts` 反向 import，
+ * 与 `index → operations → form` 形成循环依赖。本文件只把查询函数转发出去。
+ */
+export { compactStdoutPaths };
+/**
+ * 「stdout 整体直出」的判定 —— 目前**只有小e 环境的 `BROWSER_FILL` 一档**适用。
+ *
+ * 用户 2026-10-15 裁定：「xiaoe 下应该直接输出 `<browsertool>` 标签」。即该档的 stdout **就是**
+ * 那段标签块本身，**不再套** `{schemaVersion, ok, operation, data, warnings}` 信封 —— 于是
+ * `workflow-create.md` 里「返回内容以 `<browsertool>` 开头 ⇒ 原样输出」这句是**字面成立**的。
+ * 代价（用户已知悉并接受）：这一档模型拿不到 `status` / `contextId`（本档不写服务端、句柄也未消费，
+ * 需要重发时由用户重新发起即可）。
+ *
+ * 两个条件必须同时成立，缺一就退回信封 —— 宁可不直出，也不让调用方拿到半截或空输出：
+ * - `data.status === 'BROWSER_FILL'`：小e 专用档，其它状态（含 `NEEDS_INPUT`）一律维持信封；
+ * - `data.finalMarkdown` 以 `<browsertool>` 开头：与文档口径同字面，渲染档万一变了也不会直出一个
+ *   看起来像标签、实际不是的东西。
+ *
+ * 必须走 `ctx.output.raw()` 而不是 `write(value, { text })`：后者在**全局 `--json`** 下仍会退化成
+ * JSON（`core/output.ts`：`useJson = globalOptions.json || options.json || !options.text`），
+ * 而本 skill 的文档一律带 `--json`。
+ */
+export function rawStdoutOf(result) {
+    const data = result.data;
+    if (!data || typeof data !== 'object')
+        return undefined;
+    if (data.status !== 'BROWSER_FILL')
+        return undefined;
+    const markdown = data.finalMarkdown;
+    if (typeof markdown !== 'string' || !markdown.startsWith('<browsertool>'))
+        return undefined;
+    return markdown;
+}
+/**
+ * 把一次 operation 的结果打到 stdout —— **形态二选一**（判定见 `rawStdoutOf`）。
+ *
+ * 独立成函数并**导出**，是为了让用例直接锁住这条接线（与 `compactStdoutPaths` 同一理由：
+ * 回归要在这里红，而不是等到真机上模型拿到一份"既不是 JSON、也不是标签块"的东西才发现）。
+ */
+export function printWorkflowResult(ctx, operation, result) {
+    const raw = rawStdoutOf(result);
+    if (raw !== undefined) {
+        // 小e：stdout 就是标签块本身 —— 不套信封、不进 `prepare()` 的超线落盘（这段本来就不长）。
+        ctx.output.raw(raw);
+        return;
+    }
+    ctx.output.write(successEnvelope(operation, result), {
+        json: true,
+        compactPaths: compactStdoutPaths(operation),
+    });
+}
 async function executeAndPrint(ctx, operation, input) {
     try {
         const result = await executeWorkflowOperation(operation, input, {
@@ -80,7 +134,7 @@ async function executeAndPrint(ctx, operation, input) {
             host: createWorkflowHost(ctx),
             continuation: createWorkflowContinuationSigner(ctx),
         });
-        ctx.output.write(successEnvelope(operation, result), { json: true });
+        printWorkflowResult(ctx, operation, result);
     }
     catch (error) {
         console.error(JSON.stringify(failureEnvelope(error), null, 2));