weaver-work-cli 0.1.23 → 0.1.25

package/dist/shortcuts/caizhilian/operations/handlers/folder.js

@@ -669,11 +669,13 @@ async function planPermissionAdd(args, env, action) {
     }
     await checkSetFolderPermission(env, folderId, action);
     await checkDocPermissionAuth(env, folderId, permissionType, action);
+    const body = buildFolderPermissionAddBody(folderId, permissionType, objType, args);
+    body.seclevel = parseSeclevelArgs(args);
     return {
         folderId,
         permissionType,
         objType,
-        body: buildFolderPermissionAddBody(folderId, permissionType, objType, args),
+        body,
     };
 }
 const permissionAddHandler = {
@@ -859,11 +861,13 @@ async function permissionDetail(args, env) {
 }
 // ── caizhilian.folder.permission.sync-setting ─────────────
 const SYNC_FOLDER_SETTING_PATH = '/api/doc/folderSetting/syncFolderSetting';
+const SYNC_TIMEOUT_MS = 120_000;
 function planSyncSetting(args) {
     const folderId = requireId(args.id, '文件夹 ID');
-    const keepOldSettingForAllFolders = typeof args.keepOldSettingForAllFolders === 'boolean'
-        ? args.keepOldSettingForAllFolders
-        : false;
+    if (typeof args.keepOldSettingForAllFolders !== 'boolean') {
+        throw caizhilianValidationError('field_required', 'keepOldSettingForAllFolders 必填：true 表示保留原有管理员设置，false 表示不保留');
+    }
+    const keepOldSettingForAllFolders = args.keepOldSettingForAllFolders;
     return {
         folderId,
         keepOldSettingForAllFolders,
@@ -904,6 +908,356 @@ const permissionSyncSettingHandler = {
             path: SYNC_FOLDER_SETTING_PATH,
             body: plan.body,
             operation: action,
+            timeoutMs: SYNC_TIMEOUT_MS,
+        });
+        const data = asRecord(response);
+        assertToleratedBusinessSuccess(data, action);
+        const existChildFolder = asRecord(data.data).existChildFolder ?? false;
+        return caizhilianSuccess(action, { existChildFolder });
+    },
+};
+function planSyncMaintain(args) {
+    const folderId = requireId(args.id, '文件夹 ID');
+    if (typeof args.keepOldSettingForAllFolders !== 'boolean') {
+        throw caizhilianValidationError('field_required', 'keepOldSettingForAllFolders 必填：true 表示保留原有文件夹维护设置，false 表示不保留');
+    }
+    const keepOldSettingForAllFolders = args.keepOldSettingForAllFolders;
+    return {
+        folderId,
+        keepOldSettingForAllFolders,
+        body: {
+            type: 'newCreateFolderPremisstion',
+            id: folderId,
+            keepOldShare: true,
+            keepOldSettingForAllFolders,
+        },
+    };
+}
+const PERMISSION_SYNC_MAINTAIN_APPLY = 'caizhilian.folder.permission.sync-maintain.apply';
+const permissionSyncMaintainHandler = {
+    targetKeys: ['id'],
+    async prepare(args, env) {
+        const action = 'caizhilian.folder.permission.sync-maintain';
+        const plan = planSyncMaintain(args);
+        const lease = await issueWriteLease(env, PERMISSION_SYNC_MAINTAIN_APPLY, args, {
+            id: plan.folderId,
+            keepOldSettingForAllFolders: plan.keepOldSettingForAllFolders,
+            body_fingerprint: fingerprint(plan.body),
+        });
+        return caizhilianPrepared(action, {
+            id: plan.folderId,
+            keepOldSettingForAllFolders: plan.keepOldSettingForAllFolders,
+            request: { method: 'POST', path: SYNC_FOLDER_SETTING_PATH, body: plan.body },
+        }, lease);
+    },
+    async apply(args, env, lease) {
+        const action = PERMISSION_SYNC_MAINTAIN_APPLY;
+        const plan = planSyncMaintain(args);
+        const expected = typeof lease.body_fingerprint === 'string' ? lease.body_fingerprint : '';
+        if (expected && expected !== fingerprint(plan.body)) {
+            throw caizhilianValidationError('plan_changed', `${action} 的请求体与 prepare 时不一致，请重新执行 prepare`);
+        }
+        const response = await env.host.request({
+            method: 'POST',
+            path: SYNC_FOLDER_SETTING_PATH,
+            body: plan.body,
+            operation: action,
+            timeoutMs: SYNC_TIMEOUT_MS,
+        });
+        const data = asRecord(response);
+        assertToleratedBusinessSuccess(data, action);
+        const existChildFolder = asRecord(data.data).existChildFolder ?? false;
+        return caizhilianSuccess(action, { existChildFolder });
+    },
+};
+// ── caizhilian.folder.permission.sync-download ────────────
+const PERMISSION_SYNC_DOWNLOAD_APPLY = 'caizhilian.folder.permission.sync-download.apply';
+const DOWNLOAD_AUTH_LABELS = {
+    true: '允许所有人下载',
+    user: '允许以下人员下载',
+    false: '不允许下载',
+};
+const permissionSyncDownloadHandler = {
+    targetKeys: ['id'],
+    async prepare(args, env) {
+        const action = 'caizhilian.folder.permission.sync-download';
+        const folderId = requireId(args.id, '文件夹 ID');
+        // 先查询当前下载权限设置
+        const downloadAuth = await fetchFolderPermissionAuth(env, folderId, 'downloadPremisstion', action);
+        if (downloadAuth === null) {
+            throw caizhilianValidationError('permission_not_found', '无法获取当前文件夹的下载权限设置');
+        }
+        const downloadAuthLabel = DOWNLOAD_AUTH_LABELS[downloadAuth] ?? downloadAuth;
+        // 根据 downloadAuth 决定 keepOldSettingForAllFolders
+        let keepOldSettingForAllFolders;
+        if (downloadAuth === 'user') {
+            // 允许以下人员下载时，需要确认是否保留原有设置
+            if (typeof args.keepOldSettingForAllFolders !== 'boolean') {
+                throw caizhilianValidationError('field_required', '当前下载权限为"允许以下人员下载"，keepOldSettingForAllFolders 必填：true 表示保留原有下载权限设置，false 表示不保留');
+            }
+            keepOldSettingForAllFolders = args.keepOldSettingForAllFolders;
+        }
+        else {
+            // 允许所有人下载 或 不允许下载时，不需要确认，传空字符串
+            keepOldSettingForAllFolders = '';
+        }
+        const body = {
+            type: 'folderDocIsDown',
+            id: folderId,
+            keepOldShare: true,
+            keepOldSettingForAllFolders,
+        };
+        const lease = await issueWriteLease(env, PERMISSION_SYNC_DOWNLOAD_APPLY, args, {
+            id: folderId,
+            download_auth: downloadAuth,
+            keepOldSettingForAllFolders,
+            body_fingerprint: fingerprint(body),
+        });
+        return caizhilianPrepared(action, {
+            id: folderId,
+            download_auth: downloadAuth,
+            download_auth_label: downloadAuthLabel,
+            keepOldSettingForAllFolders,
+            request: { method: 'POST', path: SYNC_FOLDER_SETTING_PATH, body },
+        }, lease);
+    },
+    async apply(args, env, lease) {
+        const action = PERMISSION_SYNC_DOWNLOAD_APPLY;
+        const folderId = requireId(args.id, '文件夹 ID');
+        // 重新查询下载权限以确认
+        const downloadAuth = await fetchFolderPermissionAuth(env, folderId, 'downloadPremisstion', action);
+        if (downloadAuth === null) {
+            throw caizhilianValidationError('permission_not_found', '无法获取当前文件夹的下载权限设置');
+        }
+        // 根据 downloadAuth 决定 keepOldSettingForAllFolders
+        let keepOldSettingForAllFolders;
+        if (downloadAuth === 'user') {
+            if (typeof args.keepOldSettingForAllFolders !== 'boolean') {
+                throw caizhilianValidationError('field_required', '当前下载权限为"允许以下人员下载"，keepOldSettingForAllFolders 必填：true 表示保留原有下载权限设置，false 表示不保留');
+            }
+            keepOldSettingForAllFolders = args.keepOldSettingForAllFolders;
+        }
+        else {
+            keepOldSettingForAllFolders = '';
+        }
+        const body = {
+            type: 'folderDocIsDown',
+            id: folderId,
+            keepOldShare: true,
+            keepOldSettingForAllFolders,
+        };
+        // 校验请求体是否与 prepare 时一致
+        const expected = typeof lease.body_fingerprint === 'string' ? lease.body_fingerprint : '';
+        if (expected && expected !== fingerprint(body)) {
+            throw caizhilianValidationError('plan_changed', `${action} 的请求体与 prepare 时不一致，请重新执行 prepare`);
+        }
+        const response = await env.host.request({
+            method: 'POST',
+            path: SYNC_FOLDER_SETTING_PATH,
+            body,
+            operation: action,
+            timeoutMs: SYNC_TIMEOUT_MS,
+        });
+        const data = asRecord(response);
+        assertToleratedBusinessSuccess(data, action);
+        const existChildFolder = asRecord(data.data).existChildFolder ?? false;
+        return caizhilianSuccess(action, { existChildFolder });
+    },
+};
+// ── caizhilian.folder.permission.sync-delete ─────────────
+const PERMISSION_SYNC_DELETE_APPLY = 'caizhilian.folder.permission.sync-delete.apply';
+const DELETE_AUTH_LABELS = {
+    true: '允许完全控制权限人员删除文档',
+    user: '允许以下人员删除文档',
+};
+const permissionSyncDeleteHandler = {
+    targetKeys: ['id'],
+    async prepare(args, env) {
+        const action = 'caizhilian.folder.permission.sync-delete';
+        const folderId = requireId(args.id, '文件夹 ID');
+        // 先查询当前删除权限设置
+        const deleteAuth = await fetchFolderPermissionAuth(env, folderId, 'deletePremisstion', action);
+        if (deleteAuth === null) {
+            throw caizhilianValidationError('permission_not_found', '无法获取当前文件夹的删除权限设置');
+        }
+        const deleteAuthLabel = DELETE_AUTH_LABELS[deleteAuth] ?? deleteAuth;
+        // 根据 deleteAuth 决定 keepOldSettingForAllFolders
+        let keepOldSettingForAllFolders;
+        if (deleteAuth === 'user') {
+            // 允许以下人员删除文档时，需要确认是否保留原有设置
+            if (typeof args.keepOldSettingForAllFolders !== 'boolean') {
+                throw caizhilianValidationError('field_required', '当前删除权限为"允许以下人员删除文档"，keepOldSettingForAllFolders 必填：true 表示保留原有删除权限设置，false 表示不保留');
+            }
+            keepOldSettingForAllFolders = args.keepOldSettingForAllFolders;
+        }
+        else {
+            // 允许完全控制权限人员删除文档时，不需要确认，传空字符串
+            keepOldSettingForAllFolders = '';
+        }
+        const body = {
+            type: 'folderDocIsDelete',
+            id: folderId,
+            keepOldShare: true,
+            keepOldSettingForAllFolders,
+        };
+        const lease = await issueWriteLease(env, PERMISSION_SYNC_DELETE_APPLY, args, {
+            id: folderId,
+            delete_auth: deleteAuth,
+            keepOldSettingForAllFolders,
+            body_fingerprint: fingerprint(body),
+        });
+        return caizhilianPrepared(action, {
+            id: folderId,
+            delete_auth: deleteAuth,
+            delete_auth_label: deleteAuthLabel,
+            keepOldSettingForAllFolders,
+            request: { method: 'POST', path: SYNC_FOLDER_SETTING_PATH, body },
+        }, lease);
+    },
+    async apply(args, env, lease) {
+        const action = PERMISSION_SYNC_DELETE_APPLY;
+        const folderId = requireId(args.id, '文件夹 ID');
+        // 重新查询删除权限以确认
+        const deleteAuth = await fetchFolderPermissionAuth(env, folderId, 'deletePremisstion', action);
+        if (deleteAuth === null) {
+            throw caizhilianValidationError('permission_not_found', '无法获取当前文件夹的删除权限设置');
+        }
+        // 根据 deleteAuth 决定 keepOldSettingForAllFolders
+        let keepOldSettingForAllFolders;
+        if (deleteAuth === 'user') {
+            if (typeof args.keepOldSettingForAllFolders !== 'boolean') {
+                throw caizhilianValidationError('field_required', '当前删除权限为"允许以下人员删除文档"，keepOldSettingForAllFolders 必填：true 表示保留原有删除权限设置，false 表示不保留');
+            }
+            keepOldSettingForAllFolders = args.keepOldSettingForAllFolders;
+        }
+        else {
+            keepOldSettingForAllFolders = '';
+        }
+        const body = {
+            type: 'folderDocIsDelete',
+            id: folderId,
+            keepOldShare: true,
+            keepOldSettingForAllFolders,
+        };
+        // 校验请求体是否与 prepare 时一致
+        const expected = typeof lease.body_fingerprint === 'string' ? lease.body_fingerprint : '';
+        if (expected && expected !== fingerprint(body)) {
+            throw caizhilianValidationError('plan_changed', `${action} 的请求体与 prepare 时不一致，请重新执行 prepare`);
+        }
+        const response = await env.host.request({
+            method: 'POST',
+            path: SYNC_FOLDER_SETTING_PATH,
+            body,
+            operation: action,
+            timeoutMs: SYNC_TIMEOUT_MS,
+        });
+        const data = asRecord(response);
+        assertToleratedBusinessSuccess(data, action);
+        const existChildFolder = asRecord(data.data).existChildFolder ?? false;
+        return caizhilianSuccess(action, { existChildFolder });
+    },
+};
+// ── caizhilian.folder.permission.sync-copy ───────────────
+const PERMISSION_SYNC_COPY_APPLY = 'caizhilian.folder.permission.sync-copy.apply';
+function planSyncCopy(args) {
+    const folderId = requireId(args.id, '文件夹 ID');
+    if (typeof args.keepOldSettingForAllFolders !== 'boolean') {
+        throw caizhilianValidationError('field_required', 'keepOldSettingForAllFolders 必填：true 表示保留原有复制权限设置，false 表示不保留');
+    }
+    return {
+        folderId,
+        keepOldSettingForAllFolders: args.keepOldSettingForAllFolders,
+        body: {
+            type: 'copyPermission',
+            id: folderId,
+            keepOldShare: true,
+            keepOldSettingForAllFolders: args.keepOldSettingForAllFolders,
+        },
+    };
+}
+const permissionSyncCopyHandler = {
+    targetKeys: ['id', 'keepOldSettingForAllFolders'],
+    async prepare(args, env) {
+        const action = 'caizhilian.folder.permission.sync-copy';
+        const plan = planSyncCopy(args);
+        const lease = await issueWriteLease(env, PERMISSION_SYNC_COPY_APPLY, args, {
+            id: plan.folderId,
+            keepOldSettingForAllFolders: plan.keepOldSettingForAllFolders,
+            body_fingerprint: fingerprint(plan.body),
+        });
+        return caizhilianPrepared(action, {
+            id: plan.folderId,
+            keepOldSettingForAllFolders: plan.keepOldSettingForAllFolders,
+            request: { method: 'POST', path: SYNC_FOLDER_SETTING_PATH, body: plan.body },
+        }, lease);
+    },
+    async apply(args, env, lease) {
+        const action = PERMISSION_SYNC_COPY_APPLY;
+        const plan = planSyncCopy(args);
+        const expected = typeof lease.body_fingerprint === 'string' ? lease.body_fingerprint : '';
+        if (expected && expected !== fingerprint(plan.body)) {
+            throw caizhilianValidationError('plan_changed', `${action} 的请求体与 prepare 时不一致，请重新执行 prepare`);
+        }
+        const response = await env.host.request({
+            method: 'POST',
+            path: SYNC_FOLDER_SETTING_PATH,
+            body: plan.body,
+            operation: action,
+            timeoutMs: SYNC_TIMEOUT_MS,
+        });
+        const data = asRecord(response);
+        assertToleratedBusinessSuccess(data, action);
+        const existChildFolder = asRecord(data.data).existChildFolder ?? false;
+        return caizhilianSuccess(action, { existChildFolder });
+    },
+};
+// ── caizhilian.folder.permission.sync-create ─────────────
+const PERMISSION_SYNC_CREATE_APPLY = 'caizhilian.folder.permission.sync-create.apply';
+function planSyncCreate(args) {
+    const folderId = requireId(args.id, '文件夹 ID');
+    if (typeof args.keepOldSettingForAllFolders !== 'boolean') {
+        throw caizhilianValidationError('field_required', 'keepOldSettingForAllFolders 必填：true 表示保留原有新建文档权限设置，false 表示不保留');
+    }
+    return {
+        folderId,
+        keepOldSettingForAllFolders: args.keepOldSettingForAllFolders,
+        body: {
+            type: 'newCreateDocPremisstion',
+            id: folderId,
+            keepOldShare: true,
+            keepOldSettingForAllFolders: args.keepOldSettingForAllFolders,
+        },
+    };
+}
+const permissionSyncCreateHandler = {
+    targetKeys: ['id', 'keepOldSettingForAllFolders'],
+    async prepare(args, env) {
+        const action = 'caizhilian.folder.permission.sync-create';
+        const plan = planSyncCreate(args);
+        const lease = await issueWriteLease(env, PERMISSION_SYNC_CREATE_APPLY, args, {
+            id: plan.folderId,
+            keepOldSettingForAllFolders: plan.keepOldSettingForAllFolders,
+            body_fingerprint: fingerprint(plan.body),
+        });
+        return caizhilianPrepared(action, {
+            id: plan.folderId,
+            keepOldSettingForAllFolders: plan.keepOldSettingForAllFolders,
+            request: { method: 'POST', path: SYNC_FOLDER_SETTING_PATH, body: plan.body },
+        }, lease);
+    },
+    async apply(args, env, lease) {
+        const action = PERMISSION_SYNC_CREATE_APPLY;
+        const plan = planSyncCreate(args);
+        const expected = typeof lease.body_fingerprint === 'string' ? lease.body_fingerprint : '';
+        if (expected && expected !== fingerprint(plan.body)) {
+            throw caizhilianValidationError('plan_changed', `${action} 的请求体与 prepare 时不一致，请重新执行 prepare`);
+        }
+        const response = await env.host.request({
+            method: 'POST',
+            path: SYNC_FOLDER_SETTING_PATH,
+            body: plan.body,
+            operation: action,
+            timeoutMs: SYNC_TIMEOUT_MS,
         });
         const data = asRecord(response);
         assertToleratedBusinessSuccess(data, action);
@@ -911,6 +1265,341 @@ const permissionSyncSettingHandler = {
         return caizhilianSuccess(action, { existChildFolder });
     },
 };
+// ── caizhilian.folder.permission.sync-move ───────────────
+const PERMISSION_SYNC_MOVE_APPLY = 'caizhilian.folder.permission.sync-move.apply';
+function planSyncMove(args) {
+    const folderId = requireId(args.id, '文件夹 ID');
+    if (typeof args.keepOldSettingForAllFolders !== 'boolean') {
+        throw caizhilianValidationError('field_required', 'keepOldSettingForAllFolders 必填：true 表示保留原有移动权限设置，false 表示不保留');
+    }
+    return {
+        folderId,
+        keepOldSettingForAllFolders: args.keepOldSettingForAllFolders,
+        body: {
+            type: 'movePermission',
+            id: folderId,
+            keepOldShare: true,
+            keepOldSettingForAllFolders: args.keepOldSettingForAllFolders,
+        },
+    };
+}
+const permissionSyncMoveHandler = {
+    targetKeys: ['id', 'keepOldSettingForAllFolders'],
+    async prepare(args, env) {
+        const action = 'caizhilian.folder.permission.sync-move';
+        const plan = planSyncMove(args);
+        const lease = await issueWriteLease(env, PERMISSION_SYNC_MOVE_APPLY, args, {
+            id: plan.folderId,
+            keepOldSettingForAllFolders: plan.keepOldSettingForAllFolders,
+            body_fingerprint: fingerprint(plan.body),
+        });
+        return caizhilianPrepared(action, {
+            id: plan.folderId,
+            keepOldSettingForAllFolders: plan.keepOldSettingForAllFolders,
+            request: { method: 'POST', path: SYNC_FOLDER_SETTING_PATH, body: plan.body },
+        }, lease);
+    },
+    async apply(args, env, lease) {
+        const action = PERMISSION_SYNC_MOVE_APPLY;
+        const plan = planSyncMove(args);
+        const expected = typeof lease.body_fingerprint === 'string' ? lease.body_fingerprint : '';
+        if (expected && expected !== fingerprint(plan.body)) {
+            throw caizhilianValidationError('plan_changed', `${action} 的请求体与 prepare 时不一致，请重新执行 prepare`);
+        }
+        const response = await env.host.request({
+            method: 'POST',
+            path: SYNC_FOLDER_SETTING_PATH,
+            body: plan.body,
+            operation: action,
+            timeoutMs: SYNC_TIMEOUT_MS,
+        });
+        const data = asRecord(response);
+        assertToleratedBusinessSuccess(data, action);
+        const existChildFolder = asRecord(data.data).existChildFolder ?? false;
+        return caizhilianSuccess(action, { existChildFolder });
+    },
+};
+// ── caizhilian.folder.permission.sync-participant ─────────
+const PERMISSION_SYNC_PARTICIPANT_APPLY = 'caizhilian.folder.permission.sync-participant.apply';
+const PROGRESS_POLL_PATH = '/api/doc/docCommon/getProgressByCache';
+const PROGRESS_POLL_INTERVAL_MS = 2_000;
+const PROGRESS_POLL_TIMEOUT_MS = 300_000;
+function planSyncParticipant(args) {
+    const folderId = requireId(args.id, '文件夹 ID');
+    const syncToFolderDocs = args.sync_to_folder_docs === true;
+    const syncToAllFolders = args.sync_to_all_folders === true;
+    const syncToAllSubFolderDocs = args.sync_to_all_sub_folder_docs === true;
+    // 至少选择一个同步选项
+    if (!syncToFolderDocs && !syncToAllFolders && !syncToAllSubFolderDocs) {
+        throw caizhilianValidationError('field_required', '至少选择一个同步选项：sync_to_folder_docs（同步到当前文件夹历史文档）、sync_to_all_folders（同步到下级文件夹）、sync_to_all_sub_folder_docs（同步到下级文件夹历史文档）');
+    }
+    // 选中的选项对应的 keepOld 参数必填（默认 true）
+    const keepOldSettingForFolderDocs = syncToFolderDocs
+        ? (typeof args.keep_old_for_folder_docs === 'boolean' ? args.keep_old_for_folder_docs : true)
+        : true;
+    const keepOldSettingForAllFolders = syncToAllFolders
+        ? (typeof args.keep_old_for_all_folders === 'boolean' ? args.keep_old_for_all_folders : true)
+        : true;
+    const keepOldSettingForAllSubFolderDocs = syncToAllSubFolderDocs
+        ? (typeof args.keep_old_for_all_sub_folder_docs === 'boolean' ? args.keep_old_for_all_sub_folder_docs : true)
+        : true;
+    return {
+        folderId,
+        syncToFolderDocs,
+        syncToAllFolders,
+        syncToAllSubFolderDocs,
+        keepOldSettingForFolderDocs,
+        keepOldSettingForAllFolders,
+        keepOldSettingForAllSubFolderDocs,
+        body: {
+            type: 'folderDefaultParticipants',
+            id: folderId,
+            syncToFolderDocs,
+            syncToAllFolders,
+            syncToAllSubFolderDocs,
+            keepOldSettingForFolderDocs,
+            keepOldSettingForAllFolders,
+            keepOldSettingForAllSubFolderDocs,
+        },
+    };
+}
+function buildSyncScopeLabels(plan) {
+    const labels = [];
+    if (plan.syncToFolderDocs)
+        labels.push('同步到当前文件夹内的历史文档');
+    if (plan.syncToAllFolders)
+        labels.push('同步到所有下级文件夹');
+    if (plan.syncToAllSubFolderDocs)
+        labels.push('同步到所有下级文件夹内的历史文档');
+    return labels;
+}
+function buildSyncKeepOldLabels(plan) {
+    const labels = {};
+    if (plan.syncToFolderDocs) {
+        labels['历史文档'] = plan.keepOldSettingForFolderDocs ? '保留' : '不保留';
+    }
+    if (plan.syncToAllFolders) {
+        labels['下级文件夹'] = plan.keepOldSettingForAllFolders ? '保留' : '不保留';
+    }
+    if (plan.syncToAllSubFolderDocs) {
+        labels['下级文件夹历史文档'] = plan.keepOldSettingForAllSubFolderDocs ? '保留' : '不保留';
+    }
+    return labels;
+}
+const permissionSyncParticipantHandler = {
+    targetKeys: ['id'],
+    async prepare(args, env) {
+        const action = 'caizhilian.folder.permission.sync-participant';
+        const plan = planSyncParticipant(args);
+        const lease = await issueWriteLease(env, PERMISSION_SYNC_PARTICIPANT_APPLY, args, {
+            id: plan.folderId,
+            body_fingerprint: fingerprint(plan.body),
+        });
+        return caizhilianPrepared(action, {
+            id: plan.folderId,
+            sync_scope: buildSyncScopeLabels(plan),
+            keep_old_settings: buildSyncKeepOldLabels(plan),
+            request: { method: 'POST', path: SYNC_FOLDER_SETTING_PATH, body: plan.body },
+        }, lease);
+    },
+    async apply(args, env, lease) {
+        const action = PERMISSION_SYNC_PARTICIPANT_APPLY;
+        const plan = planSyncParticipant(args);
+        const expected = typeof lease.body_fingerprint === 'string' ? lease.body_fingerprint : '';
+        if (expected && expected !== fingerprint(plan.body)) {
+            throw caizhilianValidationError('plan_changed', `${action} 的请求体与 prepare 时不一致，请重新执行 prepare`);
+        }
+        const response = await env.host.request({
+            method: 'POST',
+            path: SYNC_FOLDER_SETTING_PATH,
+            body: plan.body,
+            operation: action,
+            timeoutMs: SYNC_TIMEOUT_MS,
+        });
+        const data = asRecord(response);
+        assertToleratedBusinessSuccess(data, action);
+        const responseData = asRecord(data.data);
+        const existChildFolder = responseData.existChildFolder ?? false;
+        const existChildDocument = responseData.existChildDocument ?? false;
+        const asyncKey = typeof responseData.asynchronousExecutionKey === 'string'
+            ? responseData.asynchronousExecutionKey
+            : '';
+        // 如果是异步执行，轮询进度
+        if (asyncKey) {
+            const deadline = Date.now() + PROGRESS_POLL_TIMEOUT_MS;
+            let progress = 0;
+            while (Date.now() < deadline) {
+                await new Promise((resolve) => setTimeout(resolve, PROGRESS_POLL_INTERVAL_MS));
+                try {
+                    const progressResponse = await env.host.request({
+                        method: 'GET',
+                        path: PROGRESS_POLL_PATH,
+                        query: { uuid: asyncKey, moduleKey: 'synchronizeFolderSettings' },
+                        operation: action,
+                    });
+                    const progressData = asRecord(progressResponse);
+                    if (typeof progressData.data === 'number') {
+                        progress = progressData.data;
+                    }
+                    if (progress >= 100)
+                        break;
+                }
+                catch {
+                    // 忽略轮询错误，继续重试
+                }
+            }
+            if (progress < 100) {
+                throw caizhilianValidationError('timeout', `同步进度超时（${PROGRESS_POLL_TIMEOUT_MS / 1000}秒），当前进度 ${progress}%，请稍后重试`);
+            }
+        }
+        return caizhilianSuccess(action, { existChildFolder, existChildDocument, asyncKey });
+    },
+};
+// ── caizhilian.folder.permission.sync-default-share ───────
+const PERMISSION_SYNC_DEFAULT_SHARE_APPLY = 'caizhilian.folder.permission.sync-default-share.apply';
+function planSyncDefaultShare(args) {
+    const folderId = requireId(args.id, '文件夹 ID');
+    const syncToFolderDocs = args.sync_to_folder_docs === true;
+    const syncToAllFolders = args.sync_to_all_folders === true;
+    const syncToAllSubFolderDocs = args.sync_to_all_sub_folder_docs === true;
+    // 至少选择一个同步选项
+    if (!syncToFolderDocs && !syncToAllFolders && !syncToAllSubFolderDocs) {
+        throw caizhilianValidationError('field_required', '至少选择一个同步选项：sync_to_folder_docs（同步到当前文件夹历史文档）、sync_to_all_folders（同步到下级文件夹）、sync_to_all_sub_folder_docs（同步到下级文件夹历史文档）');
+    }
+    // 选中的选项对应的 keepOld 参数必填（默认 true）
+    const keepOldSettingForFolderDocs = syncToFolderDocs
+        ? (typeof args.keep_old_default_share_for_folder_docs === 'boolean' ? args.keep_old_default_share_for_folder_docs : true)
+        : true;
+    const keepOldNotDefShareForFolderDocs = syncToFolderDocs
+        ? (typeof args.keep_old_non_default_share_for_folder_docs === 'boolean' ? args.keep_old_non_default_share_for_folder_docs : true)
+        : true;
+    const keepOldSettingForAllFolders = syncToAllFolders
+        ? (typeof args.keep_old_default_share_for_all_folders === 'boolean' ? args.keep_old_default_share_for_all_folders : true)
+        : true;
+    const keepOldSettingForAllSubFolderDocs = syncToAllSubFolderDocs
+        ? (typeof args.keep_old_default_share_for_sub_folder_docs === 'boolean' ? args.keep_old_default_share_for_sub_folder_docs : true)
+        : true;
+    const keepOldNotDefShareForAllSubFolderDocs = syncToAllSubFolderDocs
+        ? (typeof args.keep_old_non_default_share_for_sub_folder_docs === 'boolean' ? args.keep_old_non_default_share_for_sub_folder_docs : true)
+        : true;
+    return {
+        folderId,
+        syncToFolderDocs,
+        syncToAllFolders,
+        syncToAllSubFolderDocs,
+        keepOldSettingForFolderDocs,
+        keepOldNotDefShareForFolderDocs,
+        keepOldSettingForAllFolders,
+        keepOldSettingForAllSubFolderDocs,
+        keepOldNotDefShareForAllSubFolderDocs,
+        body: {
+            type: 'folderDefaultShare',
+            id: folderId,
+            syncToFolderDocs,
+            syncToAllFolders,
+            syncToAllSubFolderDocs,
+            keepOldSettingForFolderDocs,
+            keepOldNotDefShareForFolderDocs,
+            keepOldSettingForAllFolders,
+            keepOldSettingForAllSubFolderDocs,
+            keepOldNotDefShareForAllSubFolderDocs,
+        },
+    };
+}
+function buildDefaultShareSyncScopeLabels(plan) {
+    const labels = [];
+    if (plan.syncToFolderDocs)
+        labels.push('同步到当前文件夹内的历史文档');
+    if (plan.syncToAllFolders)
+        labels.push('同步到所有下级文件夹');
+    if (plan.syncToAllSubFolderDocs)
+        labels.push('同步到所有下级文件夹内的历史文档');
+    return labels;
+}
+function buildDefaultShareSyncKeepOldLabels(plan) {
+    const labels = {};
+    if (plan.syncToFolderDocs) {
+        labels['历史文档-默认共享人'] = plan.keepOldSettingForFolderDocs ? '保留' : '不保留';
+        labels['历史文档-非默认共享人'] = plan.keepOldNotDefShareForFolderDocs ? '保留' : '不保留';
+    }
+    if (plan.syncToAllFolders) {
+        labels['下级文件夹-默认共享人'] = plan.keepOldSettingForAllFolders ? '保留' : '不保留';
+    }
+    if (plan.syncToAllSubFolderDocs) {
+        labels['下级文件夹历史文档-默认共享人'] = plan.keepOldSettingForAllSubFolderDocs ? '保留' : '不保留';
+        labels['下级文件夹历史文档-非默认共享人'] = plan.keepOldNotDefShareForAllSubFolderDocs ? '保留' : '不保留';
+    }
+    return labels;
+}
+const permissionSyncDefaultShareHandler = {
+    targetKeys: ['id'],
+    async prepare(args, env) {
+        const action = 'caizhilian.folder.permission.sync-default-share';
+        const plan = planSyncDefaultShare(args);
+        const lease = await issueWriteLease(env, PERMISSION_SYNC_DEFAULT_SHARE_APPLY, args, {
+            id: plan.folderId,
+            body_fingerprint: fingerprint(plan.body),
+        });
+        return caizhilianPrepared(action, {
+            id: plan.folderId,
+            sync_scope: buildDefaultShareSyncScopeLabels(plan),
+            keep_old_settings: buildDefaultShareSyncKeepOldLabels(plan),
+            request: { method: 'POST', path: SYNC_FOLDER_SETTING_PATH, body: plan.body },
+        }, lease);
+    },
+    async apply(args, env, lease) {
+        const action = PERMISSION_SYNC_DEFAULT_SHARE_APPLY;
+        const plan = planSyncDefaultShare(args);
+        const expected = typeof lease.body_fingerprint === 'string' ? lease.body_fingerprint : '';
+        if (expected && expected !== fingerprint(plan.body)) {
+            throw caizhilianValidationError('plan_changed', `${action} 的请求体与 prepare 时不一致，请重新执行 prepare`);
+        }
+        const response = await env.host.request({
+            method: 'POST',
+            path: SYNC_FOLDER_SETTING_PATH,
+            body: plan.body,
+            operation: action,
+            timeoutMs: SYNC_TIMEOUT_MS,
+        });
+        const data = asRecord(response);
+        assertToleratedBusinessSuccess(data, action);
+        const responseData = asRecord(data.data);
+        const existChildFolder = responseData.existChildFolder ?? false;
+        const existChildDocument = responseData.existChildDocument ?? false;
+        const asyncKey = typeof responseData.asynchronousExecutionKey === 'string'
+            ? responseData.asynchronousExecutionKey
+            : '';
+        // 如果是异步执行，轮询进度
+        if (asyncKey) {
+            const deadline = Date.now() + PROGRESS_POLL_TIMEOUT_MS;
+            let progress = 0;
+            while (Date.now() < deadline) {
+                await new Promise((resolve) => setTimeout(resolve, PROGRESS_POLL_INTERVAL_MS));
+                try {
+                    const progressResponse = await env.host.request({
+                        method: 'GET',
+                        path: PROGRESS_POLL_PATH,
+                        query: { uuid: asyncKey, moduleKey: 'synchronizeFolderSettings' },
+                        operation: action,
+                    });
+                    const progressData = asRecord(progressResponse);
+                    if (typeof progressData.data === 'number') {
+                        progress = progressData.data;
+                    }
+                    if (progress >= 100)
+                        break;
+                }
+                catch {
+                    // 忽略轮询错误，继续重试
+                }
+            }
+            if (progress < 100) {
+                throw caizhilianValidationError('timeout', `同步进度超时（${PROGRESS_POLL_TIMEOUT_MS / 1000}秒），当前进度 ${progress}%，请稍后重试`);
+            }
+        }
+        return caizhilianSuccess(action, { existChildFolder, existChildDocument, asyncKey });
+    },
+};
 // ── caizhilian.folder.permission.query ────────────────────
 async function permissionQuery(args, env) {
     const action = 'caizhilian.folder.permission.query';
@@ -1019,6 +1708,14 @@ export const caizhilianFolderHandlers = {
     'caizhilian.folder.permission.set-auth': permissionSetAuthHandler,
     'caizhilian.folder.permission.detail': { execute: permissionDetail },
     'caizhilian.folder.permission.sync-setting': permissionSyncSettingHandler,
+    'caizhilian.folder.permission.sync-maintain': permissionSyncMaintainHandler,
+    'caizhilian.folder.permission.sync-download': permissionSyncDownloadHandler,
+    'caizhilian.folder.permission.sync-delete': permissionSyncDeleteHandler,
+    'caizhilian.folder.permission.sync-copy': permissionSyncCopyHandler,
+    'caizhilian.folder.permission.sync-create': permissionSyncCreateHandler,
+    'caizhilian.folder.permission.sync-move': permissionSyncMoveHandler,
+    'caizhilian.folder.permission.sync-participant': permissionSyncParticipantHandler,
+    'caizhilian.folder.permission.sync-default-share': permissionSyncDefaultShareHandler,
     'caizhilian.folder.permission.query': { execute: permissionQuery },
     'caizhilian.folder.query-by-permission': { execute: queryFoldersByPermission },
 };